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
@@ -291,6 +291,8 @@ function eventOfRow(event: EarningsEvent, row: EarningsAction, report: CalendarR
291
291
  ...base,
292
292
  earningsDate,
293
293
  earningsCallDate: ownDate ? event.earningsCallDate ?? null : null,
294
+ // The company's time is for its own date, never another the record places the report on.
295
+ releaseAt: ownDate ? event.releaseAt ?? null : null,
294
296
  isDateEstimate: statusFlag(dateStatus) ?? (dateStatus === "reported" ? base.isDateEstimate ?? null : null),
295
297
  epsEstimate: recordFigures ? row.epsEstimate ?? null : base.epsEstimate ?? row.epsEstimate ?? null,
296
298
  epsAnalysts: recordFigures ? row.epsAnalysts ?? null : base.epsAnalysts ?? row.epsAnalysts ?? null,
@@ -0,0 +1,12 @@
1
+ import type { SelectButtonOption } from "../../../components/ui/select-button";
2
+
3
+ /** Market value bands in US dollars, as the rankings that filter by size draw them (INS, BUZZ). */
4
+ export type MarketCapBand = "micro" | "small" | "mid" | "large";
5
+
6
+ export const MARKET_CAP_BAND_OPTIONS: SelectButtonOption<MarketCapBand | "all">[] = [
7
+ { value: "all", label: "All" },
8
+ { value: "micro", label: "Micro", description: "Under $300M" },
9
+ { value: "small", label: "Small", description: "$300M to $2B" },
10
+ { value: "mid", label: "Mid", description: "$2B to $10B" },
11
+ { value: "large", label: "Large", description: "Over $10B" },
12
+ ];
@@ -4,6 +4,7 @@ import type { Quote, QuoteIndexSession } from "../../../types/financials";
4
4
  import { isQuoteBeforeLatestSession, isQuoteStaleForCurrentSession } from "../../../market-data/quotes/freshness";
5
5
  import { delayedFeedLagMs, readIndexSession } from "../../../market-data/market/freshness";
6
6
  import { quoteHeadlineTime } from "../../../market-data/market/status";
7
+ import { indexLevelMarketState } from "../../../market-data/market/index-level";
7
8
  import { barSizeFromGap, medianBarGap } from "../../../time-series/bar-spacing";
8
9
  import { apiClient } from "../../../api-client";
9
10
  import { isPerpetualExchange } from "../../../tickers/perpetual-listing";
@@ -113,7 +114,8 @@ export function quoteFreshnessFields(
113
114
  stale: isQuoteStaleForCurrentSession(quote, now),
114
115
  ...(delayed ? { delayMinutes: delayedFeedLagMs(exchange) / 60_000 } : {}),
115
116
  ...(exchange && session ? { sessionExchange: exchange } : {}),
116
- ...(quote.marketState && session ? { marketState: quote.marketState } : {}),
117
+ // An index's final close reads as a close, not after hours.
118
+ ...(quote.marketState && session ? { marketState: indexLevelMarketState(quote) } : {}),
117
119
  ...(sessionCalendar && session ? { sessionCalendar } : {}),
118
120
  };
119
121
  }
@@ -673,6 +673,8 @@ export type QuoteBoardCellKind = "status" | "price" | "change" | "changePercent"
673
673
  export interface QuoteBoardCellFormat {
674
674
  /** Spell out the session instead of a colored dot. */
675
675
  sessionText?: boolean;
676
+ /** The moment the status cell reads the venue's session at, in ms; the current time when omitted. */
677
+ now?: number;
676
678
  /** Called with the quote at its headline: a finite price. */
677
679
  formatPrice: (quote: Quote) => string;
678
680
  /** Called with the quote at its headline: a finite change; the text carries its sign. */
@@ -722,11 +724,11 @@ export function renderQuoteBoardCell(
722
724
  switch (kind) {
723
725
  case "status": {
724
726
  if (format.sessionText) {
725
- return { text: quoteSessionLabel(quote) ?? "—", color: quoteSessionColor(quote) };
727
+ return { text: quoteSessionLabel(quote, format.now) ?? "—", color: quoteSessionColor(quote, colors, format.now) };
726
728
  }
727
- const dot = marketStatusDot(quoteDotMarketState(quote));
729
+ const dot = marketStatusDot(quoteDotMarketState(quote, format.now));
728
730
  // The dot is a picture; the export says which session it means.
729
- return { text: dot.char, value: quoteSessionLabel(quote), color: dot.color };
731
+ return { text: dot.char, value: quoteSessionLabel(quote, format.now), color: dot.color };
730
732
  }
731
733
  case "price":
732
734
  if (!quote || !Number.isFinite(quote.price)) return { text: "—", color: colors.textDim };
@@ -1,3 +1,4 @@
1
+ import { parseOptionTicker } from "../../../../utils/options";
1
2
  import { valueOption, type OptionSide } from "./pricing";
2
3
 
3
4
  export interface VolatilityInputs {
@@ -65,11 +66,71 @@ export function strikeFromLogMoneyness(logMoneyness: number, forward: number): n
65
66
  export interface ParityQuote { strike: number; bid: number; ask: number; contractSymbol?: string }
66
67
 
67
68
  /** Crossed, empty and one-sided markets cannot supply a midpoint. */
68
- export function optionMid(quote: Pick<ParityQuote, "bid" | "ask">): number | null {
69
- return positive(quote.bid) && positive(quote.ask) && quote.ask >= quote.bid
69
+ export function optionMid(quote: Pick<ParityQuote, "bid" | "ask"> & { quoteStale?: boolean }): number | null {
70
+ // A quote from before the chain's session, or under intrinsic, is no market to read a midpoint from.
71
+ return quote.quoteStale !== true && positive(quote.bid) && positive(quote.ask) && quote.ask >= quote.bid
70
72
  ? quote.bid + (quote.ask - quote.bid) / 2 : null;
71
73
  }
72
74
 
75
+ /**
76
+ * How far under intrinsic an ask has to be to be no market: 2% of the
77
+ * underlying, so a deep in-the-money quote minutes behind a moving price (a
78
+ * chain refreshed every few minutes beside a live price) is not read as one.
79
+ * The server marks the same quotes (and those quoted before the session)
80
+ * `quoteStale`.
81
+ */
82
+ const UNDER_INTRINSIC_MARGIN = 0.02;
83
+
84
+ /**
85
+ * Cash-settled index roots, exercised only at expiry (European style), as the
86
+ * server lists them. Such an option can be worth less than intrinsic: a deep
87
+ * in-the-money SPX put a year out is worth about the strike discounted to
88
+ * expiry less the index.
89
+ */
90
+ const EUROPEAN_INDEX_ROOTS: ReadonlySet<string> = new Set([
91
+ "SPX", "SPXW", "SPXPM", "XSP", "NDX", "NDXP", "XND", "RUT", "RUTW", "MRUT", "VIX", "VIXW", "DJX", "XEO", "MXEA", "MXEF",
92
+ ]);
93
+
94
+ /**
95
+ * Whether a contract can be exercised before expiry, so no quote of it is worth less than intrinsic: a listed US
96
+ * stock or fund option. A venue-marked coin option (Deribit's) and a cash-settled index root are European; a
97
+ * contract named outside OCC's form is not judged. One without a symbol is taken as a stock's.
98
+ */
99
+ function americanExercise(contract: { contractSymbol?: string; mark?: unknown }): boolean {
100
+ if (contract.mark != null) return false;
101
+ if (!contract.contractSymbol) return true;
102
+ const root = parseOptionTicker(contract.contractSymbol)?.underlying.toUpperCase();
103
+ return root != null && !EUROPEAN_INDEX_ROOTS.has(root);
104
+ }
105
+
106
+ /**
107
+ * Whether an ask sits under the option's intrinsic value at `spot`: a quote no one could trade. Only an American
108
+ * option is held to it (`americanExercise`).
109
+ */
110
+ export function quoteUnderIntrinsic(
111
+ quote: Pick<ParityQuote, "strike" | "ask" | "contractSymbol"> & { mark?: unknown }, side: "call" | "put", spot: number | undefined,
112
+ ): boolean {
113
+ if (spot == null || !positive(spot) || !positive(quote.ask) || !positive(quote.strike)) return false;
114
+ if (!americanExercise(quote)) return false;
115
+ const intrinsic = side === "call" ? spot - quote.strike : quote.strike - spot;
116
+ return quote.ask < intrinsic - UNDER_INTRINSIC_MARGIN * spot;
117
+ }
118
+
119
+ /** The chain with every quote under intrinsic at `spot` marked `quoteStale`, as the server marks it; the same chain when none is. */
120
+ export function withQuotesUnderIntrinsicMarked<T extends { calls: C[]; puts: C[] }, C extends ParityQuote & { quoteStale?: boolean; mark?: unknown }>(
121
+ chain: T, spot: number | undefined,
122
+ ): T {
123
+ let marked = 0;
124
+ const mark = (side: "call" | "put") => (contract: C): C => {
125
+ if (contract.quoteStale || !quoteUnderIntrinsic(contract, side, spot)) return contract;
126
+ marked += 1;
127
+ return { ...contract, quoteStale: true };
128
+ };
129
+ const calls = chain.calls.map(mark("call"));
130
+ const puts = chain.puts.map(mark("put"));
131
+ return marked ? { ...chain, calls, puts } : chain;
132
+ }
133
+
73
134
  interface ParityPair {
74
135
  strike: number;
75
136
  forward: number;
@@ -1,20 +1,89 @@
1
- import type { SocialMentionsRange } from "../../../api-client/social-mentions";
1
+ import type { SocialMentionsRange, SocialOutlierRow } from "../../../api-client/social-mentions";
2
2
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
3
3
  import { explainRefusal } from "../shared/cloud-denied";
4
+ import { REPORT_ROWS } from "../shared/headless-options";
4
5
  import { fetchSocialMentions } from "./client";
5
6
  import { socialMentionsLockNote } from "./lock-note";
6
7
  import { socialCount, socialDayRows, socialRatio, socialStance, topPostCell } from "./model";
8
+ import { DEFAULT_SOCIAL_OUTLIERS_QUERY, loadSocialOutliers, SOCIAL_OUTLIER_PANE_ROWS } from "./outliers-client";
9
+ import {
10
+ outlierCountedAt,
11
+ outlierPrice,
12
+ SOCIAL_OUTLIER_CAP_OPTIONS,
13
+ SOCIAL_OUTLIERS_TITLE,
14
+ socialOutliersEmptyTitle,
15
+ socialOutliersFiltered,
16
+ socialOutliersQueryFrom,
17
+ } from "./outliers-model";
18
+
19
+ /** The ranking's options set the pane's own state, so `gloom shot BUZZ --window today` draws what `fn` lists. */
20
+ const OUTLIER_OPTION_STATE = (key: string) => ({ pluginId: "ticker-research", key: `social-mentions:outliers:${key}` });
21
+
22
+ const outlierRow = (row: SocialOutlierRow) => ({
23
+ symbol: row.symbol,
24
+ company: row.name,
25
+ day: row.day,
26
+ countedAt: row.countedAt,
27
+ posts: row.mentions,
28
+ median: row.baseline,
29
+ ratio: row.ratio,
30
+ stance: row.stance,
31
+ stancePosts: row.stancePosts,
32
+ pricePct: row.price?.changePct ?? null,
33
+ priceAsOf: row.price?.asOf ?? null,
34
+ marketCap: row.marketCap,
35
+ });
7
36
 
8
37
  export const socialMentionsHeadless: HeadlessPaneDefinition<"bundle"> = {
9
- shape: "bundle", argument: { kind: "ticker", description: "Ticker with a searchable cashtag (up to six letters and digits).", placeholder: "ticker" },
38
+ shape: "bundle", argument: { kind: "ticker", optional: true, placeholder: "ticker",
39
+ description: "Ticker with a searchable cashtag (up to six letters and digits); omit for the tickers whose posts jump above their own 30-day median." },
10
40
  freshness: { source: "X posts", status: "not-a-feed", basis: "daily post counts" },
11
41
  discovery: { aliases: ["BUZZ"], dataRequirements: ["Free Gloom sign-in", "Gloom Cloud X mention history"],
12
42
  limitations: ["Daily $cashtag posts on X in UTC days, spam included.", "Top posts and stance cover days that were looked up.", "Views exist from 2022-12-22."] },
13
43
  options: [
14
44
  { key: "range", type: "enum", description: "History window.", values: [{ value: "1y" }, { value: "5y" }, { value: "max" }], defaultValue: "1y", settingKey: "socialRange" },
45
+ { key: "window", type: "enum", description: "Without a ticker: each ticker's latest closed UTC day (day), or today's posts so far (today).",
46
+ values: [{ value: "day", aliases: ["latest", "closed"] }, { value: "today" }], defaultValue: "day",
47
+ example: "--window today", exampleWithoutArgument: true, pluginState: OUTLIER_OPTION_STATE("window") },
48
+ { key: "minPosts", aliases: ["min-posts", "min"], type: "integer", minimum: 0, maximum: 1_000_000, defaultValue: DEFAULT_SOCIAL_OUTLIERS_QUERY.minPosts,
49
+ description: "Without a ticker: least posts on the day counted.", pluginState: OUTLIER_OPTION_STATE("minPosts") },
50
+ { key: "cap", type: "enum", description: "Without a ticker: market value, micro (under $300M), small ($300M to $2B), mid ($2B to $10B) or large.",
51
+ values: SOCIAL_OUTLIER_CAP_OPTIONS.map((option) => ({ value: option.value })), example: "--cap small --min-posts 100", exampleWithoutArgument: true,
52
+ pluginState: OUTLIER_OPTION_STATE("cap") },
53
+ { key: "limit", shot: REPORT_ROWS, aliases: ["count", "rows"], type: "integer", minimum: 1, maximum: 200, defaultValue: SOCIAL_OUTLIER_PANE_ROWS,
54
+ description: "Without a ticker: tickers to rank." },
15
55
  ],
16
- describe: (args) => `Social mentions | ${args.symbols[0]}`,
56
+ describe: (args) => args.symbols[0]
57
+ ? `Social mentions | ${args.symbols[0]}`
58
+ : `${SOCIAL_OUTLIERS_TITLE} | ${args.options.window === "today" ? "Today" : "Latest day"}`,
17
59
  async load(args, ctx) {
60
+ if (!args.symbols[0]) {
61
+ // The ranking's query as the pane reads it from the same state.
62
+ const query = socialOutliersQueryFrom(args.options);
63
+ const data = (await loadSocialOutliers(query, { limit: Number(args.options.limit) || SOCIAL_OUTLIER_PANE_ROWS,
64
+ force: ctx.refresh === true, client: ctx.apiClient, names: ctx.marketData, signal: ctx.signal })
65
+ .catch(async (error: unknown) => { throw await explainRefusal(error, socialMentionsLockNote, { symbol: null, context: ctx }); })).payload;
66
+ const today = data.window === "today";
67
+ return { complete: true,
68
+ sections: [{ title: today ? "Today's posts on X against their 30-day median" : "Latest day's posts on X against their 30-day median", columns: [
69
+ { key: "symbol", header: "Ticker" },
70
+ { key: "company", header: "Company", format: (value) => typeof value === "string" ? value : "--" },
71
+ today
72
+ ? { key: "countedAt", header: "As of", format: (value) => outlierCountedAt({ countedAt: String(value) }) }
73
+ : { key: "day", header: "Date" },
74
+ { key: "posts", header: "Posts", align: "right", format: (value) => socialCount(value as number) },
75
+ { key: "median", header: "30D median", align: "right", format: (value) => socialCount(value as number) },
76
+ { key: "ratio", header: "Vs median", align: "right", format: (value) => socialRatio(value as number) },
77
+ { key: "stance", header: "Stance", align: "right", format: (value) => socialStance(value as number | null) },
78
+ { key: "pricePct", header: "Price %", align: "right",
79
+ format: (value) => outlierPrice({ price: typeof value === "number" ? { changePct: value, asOf: "" } : null }) },
80
+ ], rows: data.rows.map(outlierRow), rowSymbolKey: "symbol", rowAsOfKey: today ? "countedAt" : "day",
81
+ ...(data.rows.length ? {} : { empty: socialOutliersEmptyTitle(data.window, data.freshFrom, socialOutliersFiltered(query)) }) }],
82
+ metadata: { window: data.window, freshFrom: data.freshFrom, filters: data.filters, coverage: data.coverage, asOf: data.asOf,
83
+ limitations: ["Each ticker is ranked on its own latest closed UTC day, or today so far; tickers last counted before freshFrom are left out.",
84
+ "The median is floored at one post a day."] },
85
+ };
86
+ }
18
87
  const range = (["1y", "5y", "max"].includes(String(args.options.range)) ? args.options.range : "1y") as SocialMentionsRange;
19
88
  const symbol = String(args.symbols[0]).toUpperCase();
20
89
  const data = await fetchSocialMentions(symbol, range, ctx.apiClient)
@@ -4,6 +4,8 @@ import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
4
4
  import { socialMentionPostsCache, socialMentionsCache } from "./client";
5
5
  import { socialMentionsHeadless } from "./headless";
6
6
  import { socialMentionsLockNote } from "./lock-note";
7
+ import { socialOutliersCache } from "./outliers-client";
8
+ import { SOCIAL_OUTLIERS_TITLE } from "./outliers-model";
7
9
 
8
10
  const socialMentionsSettings = [
9
11
  { key: "socialRange", label: "History", type: "select" as const,
@@ -15,9 +17,11 @@ export const socialMentionsModule: PluginModule = {
15
17
  defaultPosition: "right", tickerFollower: true, defaultMode: "floating", defaultFloatingSize: { width: 96, height: 30 },
16
18
  tableExport: true, headless: socialMentionsHeadless, settings: { title: "Social Mentions", fields: socialMentionsSettings } }],
17
19
  paneTemplates: [{ ...createTickerSurfacePaneTemplate({ id: "social-mentions-pane", paneId: "social-mentions", label: "Social Mentions",
18
- description: "Daily posts on X naming the ticker's cashtag, the day's top posts and their stance.",
19
- shortcut: "BUZZ", keywords: ["social", "mentions", "x", "twitter", "buzz", "sentiment", "stance", "cashtag"], publicShare: true,
20
+ description: "Daily posts on X naming the ticker's cashtag, the day's top posts and their stance; alone, the tickers whose posts jump above their own median.",
21
+ shortcut: "BUZZ", keywords: ["social", "mentions", "x", "twitter", "buzz", "sentiment", "stance", "cashtag", "outliers"], publicShare: true,
22
+ // Typed alone with no active ticker it ranks the market's social outliers.
23
+ withoutTickerTitle: SOCIAL_OUTLIERS_TITLE,
20
24
  }), headless: socialMentionsHeadless }],
21
- setup(ctx) { socialMentionsCache.attach(ctx.persistence); socialMentionPostsCache.attach(ctx.persistence); },
22
- dispose() { socialMentionsCache.reset(); socialMentionPostsCache.reset(); },
25
+ setup(ctx) { socialMentionsCache.attach(ctx.persistence); socialMentionPostsCache.attach(ctx.persistence); socialOutliersCache.attach(ctx.persistence); },
26
+ dispose() { socialMentionsCache.reset(); socialMentionPostsCache.reset(); socialOutliersCache.reset(); },
23
27
  };
@@ -3,13 +3,17 @@ import { proLockNote } from "../shared/pro-lock-note";
3
3
 
4
4
  /**
5
5
  * BUZZ needs a signed-in account, not a plan. No command reads the posts it
6
- * counts without one, so the note names no free route.
6
+ * counts without one, so the note names no free route. Without a ticker it
7
+ * ranks the market's outliers, and the command it names is bare.
7
8
  */
8
9
  export function socialMentionsLockNote(lock: PaneLock): Promise<string> {
9
10
  return proLockNote(lock, {
10
11
  token: "BUZZ",
11
12
  needs: "sign-in",
12
- does: "it counts the daily posts on X that name a company's cashtag, with the top posts and their stance",
13
+ argument: "optional",
14
+ does: lock.symbol
15
+ ? "it counts the daily posts on X that name a company's cashtag, with the top posts and their stance"
16
+ : "it ranks the tickers whose posts on X jump above their own 30-day median, with stance and price move",
13
17
  shows: "it",
14
18
  });
15
19
  }
@@ -0,0 +1,101 @@
1
+ import { apiClient } from "../../../api-client";
2
+ import { isAccessDenied } from "../../../api-client/errors";
3
+ import type {
4
+ CloudSocialOutliersParams,
5
+ SocialOutlierCap,
6
+ SocialOutliersPayload,
7
+ SocialOutlierWindow,
8
+ } from "../../../api-client/social-mentions";
9
+ import { createPluginCache } from "../../../data/plugin-cache";
10
+ import type { HeadlessPaneApiClient } from "../../../types/plugin";
11
+ import { cachedCloudResource, loadCloudResource, unavailableOnServer, type CloudResource } from "../shared/cloud-resource";
12
+ import { CLOUD_SESSION_REQUIRED } from "../shared/research-cloud-session";
13
+ import { withListingNames, type OutlierNameSource } from "./outliers-names";
14
+
15
+ /** What the ranking reads: a window and the filters. */
16
+ export interface SocialOutliersQuery {
17
+ window: SocialOutlierWindow;
18
+ /** Least posts on the day counted; 0 for any. */
19
+ minPosts: number;
20
+ cap: SocialOutlierCap | null;
21
+ }
22
+
23
+ /** A few posts against a median of one reads as a jump of several times; the ranking starts past them. */
24
+ const DEFAULT_SOCIAL_OUTLIER_MIN_POSTS = 25;
25
+ export const DEFAULT_SOCIAL_OUTLIERS_QUERY: SocialOutliersQuery = { window: "day", minPosts: DEFAULT_SOCIAL_OUTLIER_MIN_POSTS, cap: null };
26
+ /** Tickers the pane ranks: read from the top, as INS's ranking is. */
27
+ export const SOCIAL_OUTLIER_PANE_ROWS = 100;
28
+ const SOCIAL_OUTLIERS_NOT_AVAILABLE = "Social outliers are not available yet.";
29
+
30
+ export const socialOutliersCache = createPluginCache<SocialOutliersPayload>({
31
+ kind: "social-outliers",
32
+ source: "gloom-cloud",
33
+ // 2: rows are named as search names them; version 1 kept the screener's names.
34
+ schemaVersion: 2,
35
+ // Closed days are counted after midnight UTC and today's counts through the day.
36
+ policy: { staleMs: 15 * 60_000, expireMs: 2 * 86_400_000 },
37
+ });
38
+
39
+ const day = (value: unknown): value is string => typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value);
40
+ const finite = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value);
41
+ const time = (value: unknown) => typeof value === "string" && Number.isFinite(Date.parse(value));
42
+
43
+ /** A ranking the pane can draw; anything else is an error, never a table with holes. */
44
+ function validateSocialOutliers(payload: SocialOutliersPayload): SocialOutliersPayload {
45
+ const valid = !!payload && (payload.window === "day" || payload.window === "today") && time(payload.asOf) && day(payload.freshFrom)
46
+ && !!payload.coverage && finite(payload.coverage.tracked) && finite(payload.coverage.counted)
47
+ && Array.isArray(payload.rows) && payload.rows.every((row) => !!row
48
+ && typeof row.symbol === "string" && /^[A-Z][A-Z0-9]{0,5}$/.test(row.symbol)
49
+ && (row.name === null || typeof row.name === "string") && day(row.day)
50
+ && Number.isInteger(row.mentions) && row.mentions >= 0 && typeof row.closed === "boolean" && time(row.countedAt)
51
+ && finite(row.baseline) && row.baseline >= 0 && finite(row.ratio) && row.ratio >= 0
52
+ && (row.stance === null || finite(row.stance) && row.stance >= -1 && row.stance <= 1) && Number.isInteger(row.stancePosts)
53
+ && (row.marketCap === null || finite(row.marketCap))
54
+ && (row.price === null || !!row.price && finite(row.price.changePct) && typeof row.price.asOf === "string"));
55
+ if (!valid) throw new Error("Social outliers could not be read.");
56
+ return payload;
57
+ }
58
+
59
+ function outliersParams(query: SocialOutliersQuery, limit: number): CloudSocialOutliersParams {
60
+ return {
61
+ window: query.window,
62
+ ...(query.minPosts > 0 ? { minPosts: query.minPosts } : {}),
63
+ ...(query.cap ? { cap: query.cap } : {}),
64
+ limit,
65
+ };
66
+ }
67
+
68
+ const cacheKey = (query: SocialOutliersQuery, limit: number) => [query.window, query.minPosts, query.cap ?? "-", limit].join(":");
69
+
70
+ export function cachedSocialOutliers(query: SocialOutliersQuery, limit = SOCIAL_OUTLIER_PANE_ROWS): CloudResource<SocialOutliersPayload> | null {
71
+ return cachedCloudResource(socialOutliersCache, cacheKey(query, limit), validateSocialOutliers);
72
+ }
73
+
74
+ export async function loadSocialOutliers(
75
+ query: SocialOutliersQuery,
76
+ {
77
+ limit = SOCIAL_OUTLIER_PANE_ROWS,
78
+ force = false,
79
+ client = apiClient,
80
+ names,
81
+ signal,
82
+ }: {
83
+ limit?: number;
84
+ force?: boolean;
85
+ client?: Pick<HeadlessPaneApiClient, "getCloudSocialOutliers">;
86
+ /** Names each ticker as search does, in one batched request; without it the screener's stored names stand. */
87
+ names?: OutlierNameSource;
88
+ signal?: AbortSignal;
89
+ } = {},
90
+ ): Promise<CloudResource<SocialOutliersPayload>> {
91
+ return loadCloudResource(
92
+ socialOutliersCache,
93
+ cacheKey(query, limit),
94
+ async () => withListingNames(await client.getCloudSocialOutliers(outliersParams(query, limit), { signal }).catch((error: unknown) => {
95
+ // A refused session is the pane's sign-in wall, keyed on the shared gate.
96
+ if (isAccessDenied(error)) throw new Error(CLOUD_SESSION_REQUIRED, { cause: error });
97
+ throw unavailableOnServer(error, SOCIAL_OUTLIERS_NOT_AVAILABLE);
98
+ }), names, signal),
99
+ { force, validate: validateSocialOutliers, signal },
100
+ );
101
+ }
@@ -0,0 +1,162 @@
1
+ import type { DataTableColumn } from "../../../components";
2
+ import type { SelectButtonOption } from "../../../components/ui/select-button";
3
+ import type { SocialOutlierRow, SocialOutlierWindow } from "../../../api-client/social-mentions";
4
+ import { formatShortDate } from "../../../utils/datetime-format";
5
+ import { displayWidth, formatPercentRaw } from "../../../utils/format";
6
+ import type { SortComparableValue } from "../../../utils/sort-values";
7
+ import { MARKET_CAP_BAND_OPTIONS } from "../shared/market-cap-bands";
8
+ import { NO_VALUE } from "../shared/research-cells";
9
+ import { DEFAULT_SOCIAL_OUTLIERS_QUERY, type SocialOutliersQuery } from "./outliers-client";
10
+ import { socialCount, socialRatio, socialStance } from "./model";
11
+
12
+ /** BUZZ alone: its title, and the one it goes back to from a ticker. */
13
+ export const SOCIAL_OUTLIERS_TITLE = "Social Outliers";
14
+
15
+ export const SOCIAL_OUTLIER_WINDOW_OPTIONS: SelectButtonOption<SocialOutlierWindow>[] = [
16
+ { value: "day", label: "Latest day", description: "Each ticker's latest closed UTC day" },
17
+ { value: "today", label: "Today", description: "Today's posts so far, UTC" },
18
+ ];
19
+
20
+ const SOCIAL_OUTLIER_MIN_OPTIONS: SelectButtonOption[] = [
21
+ { value: "0", label: "Any" },
22
+ { value: "25", label: "25+" },
23
+ { value: "100", label: "100+" },
24
+ { value: "500", label: "500+" },
25
+ { value: "1000", label: "1,000+" },
26
+ ];
27
+
28
+ export const SOCIAL_OUTLIER_CAP_OPTIONS = MARKET_CAP_BAND_OPTIONS;
29
+
30
+ const optionValue = <T extends string>(options: readonly SelectButtonOption<T>[], value: unknown, fallback: T): T =>
31
+ options.some((option) => option.value === value) ? value as T : fallback;
32
+
33
+ /** A query from what the pane stored, each part checked and defaulted on its own. */
34
+ export function socialOutliersQueryFrom(stored: { window?: unknown; minPosts?: unknown; cap?: unknown }): SocialOutliersQuery {
35
+ const cap = optionValue(SOCIAL_OUTLIER_CAP_OPTIONS, stored.cap, "all");
36
+ return {
37
+ window: optionValue(SOCIAL_OUTLIER_WINDOW_OPTIONS, stored.window, DEFAULT_SOCIAL_OUTLIERS_QUERY.window),
38
+ minPosts: minPostsFrom(stored.minPosts),
39
+ cap: cap === "all" ? null : cap,
40
+ };
41
+ }
42
+
43
+ /** The server's ceiling on a minimum. */
44
+ const MAX_MIN_POSTS = 1_000_000;
45
+
46
+ /** Any whole count the CLI can set (`--min-posts 50`), not only the menu's. */
47
+ function minPostsFrom(stored: unknown): number {
48
+ const value = typeof stored === "string" && stored.trim() ? Number(stored) : stored;
49
+ return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= MAX_MIN_POSTS
50
+ ? value
51
+ : DEFAULT_SOCIAL_OUTLIERS_QUERY.minPosts;
52
+ }
53
+
54
+ /** The menu's minimums, with one the CLI set in its place among them. */
55
+ export function socialOutlierMinOptions(minPosts: number): SelectButtonOption[] {
56
+ if (SOCIAL_OUTLIER_MIN_OPTIONS.some((option) => option.value === String(minPosts))) return SOCIAL_OUTLIER_MIN_OPTIONS;
57
+ return [...SOCIAL_OUTLIER_MIN_OPTIONS, { value: String(minPosts), label: `${socialCount(minPosts)}+` }]
58
+ .sort((a, b) => Number(a.value) - Number(b.value));
59
+ }
60
+
61
+ export type SocialOutlierColumnId = "ticker" | "company" | "day" | "countedAt" | "mentions" | "baseline" | "ratio" | "stance" | "price";
62
+ export interface SocialOutlierColumn extends DataTableColumn {
63
+ id: SocialOutlierColumnId;
64
+ }
65
+
66
+ /** The ranked day as the ticker's own table dates it. */
67
+ export const outlierDay = (row: Pick<SocialOutlierRow, "day">) => row.day;
68
+ /** When today's count was read: the column header says UTC. */
69
+ export const outlierCountedAt = (row: Pick<SocialOutlierRow, "countedAt">) => {
70
+ const time = new Date(row.countedAt);
71
+ return Number.isNaN(time.getTime()) ? NO_VALUE : `${time.toISOString().slice(11, 16)} UTC`;
72
+ };
73
+ export const outlierPrice = (row: Pick<SocialOutlierRow, "price">) => row.price ? formatPercentRaw(row.price.changePct) : NO_VALUE;
74
+
75
+ /** Cells left and right of the columns, and between two of them. */
76
+ const TABLE_PADDING = 2;
77
+ const COLUMN_GAP = 1;
78
+ /** The kit widens a column to fit its header plus the sort arrow. */
79
+ const HEADER_EXTRA = 2;
80
+ /** Below this the company names read as stubs: the column goes instead. */
81
+ const COMPANY_MIN = 12;
82
+
83
+ function fitWidth(texts: readonly string[], label: string, max: number): number {
84
+ const widest = texts.reduce((width, value) => Math.max(width, displayWidth(value)), 0);
85
+ return Math.max(displayWidth(label) + HEADER_EXTRA, Math.min(max, widest));
86
+ }
87
+
88
+ /** What a narrow pane gives up, first to last: the median the multiple already measures against, then the company. */
89
+ const NARROW_DROPS = ["baseline", "company", "stance"] as const;
90
+
91
+ /**
92
+ * The columns that fit `width` cells: the ticker and company, the day
93
+ * counted (today: when it was read), the posts, the 30-day median, the
94
+ * multiple, the stance and the price move. The company takes the room left.
95
+ */
96
+ export function buildSocialOutlierColumns(width: number, rows: readonly SocialOutlierRow[], window: SocialOutlierWindow): SocialOutlierColumn[] {
97
+ const widths = {
98
+ ticker: fitWidth(rows.map((row) => row.symbol), "Ticker", 8),
99
+ when: window === "today" ? fitWidth(rows.map(outlierCountedAt), "As of", 9) : fitWidth(rows.map(outlierDay), "Date", 10),
100
+ mentions: fitWidth(rows.map((row) => socialCount(row.mentions)), "Posts", 9),
101
+ baseline: fitWidth(rows.map((row) => socialCount(row.baseline)), "30D median", 9),
102
+ ratio: fitWidth(rows.map((row) => socialRatio(row.ratio)), "Vs median", 7),
103
+ stance: fitWidth(rows.map((row) => socialStance(row.stance)), "Stance", 6),
104
+ price: fitWidth(rows.map(outlierPrice), "Price %", 9),
105
+ };
106
+ const show = { baseline: true, company: true, stance: true };
107
+ const available = Math.max(0, Math.floor(width) - TABLE_PADDING);
108
+ const fixed = () => [widths.ticker, widths.when, widths.mentions, show.baseline ? widths.baseline : 0, widths.ratio,
109
+ show.stance ? widths.stance : 0, widths.price].reduce((sum, columnWidth) => sum + (columnWidth > 0 ? columnWidth + COLUMN_GAP : 0), 0) - COLUMN_GAP;
110
+ const room = () => available - fixed() - (show.company ? COLUMN_GAP : 0);
111
+ for (const drop of NARROW_DROPS) {
112
+ if (room() >= (show.company ? COMPANY_MIN : 0)) break;
113
+ show[drop] = false;
114
+ }
115
+ return [
116
+ { id: "ticker", label: "Ticker", width: widths.ticker, align: "left" },
117
+ ...(show.company ? [{ id: "company" as const, label: "Company", width: Math.max(COMPANY_MIN, room()), align: "left" as const, flexGrow: 1 }] : []),
118
+ window === "today"
119
+ ? { id: "countedAt", label: "As of", width: widths.when, align: "right" }
120
+ : { id: "day", label: "Date", width: widths.when, align: "left" },
121
+ { id: "mentions", label: "Posts", width: widths.mentions, align: "right" },
122
+ ...(show.baseline ? [{ id: "baseline" as const, label: "30D median", width: widths.baseline, align: "right" as const }] : []),
123
+ { id: "ratio", label: "Vs median", width: widths.ratio, align: "right", ...(show.company ? {} : { flexGrow: 1 }) },
124
+ ...(show.stance ? [{ id: "stance" as const, label: "Stance", width: widths.stance, align: "right" as const }] : []),
125
+ { id: "price", label: "Price %", width: widths.price, align: "right" },
126
+ ];
127
+ }
128
+
129
+ /** What a column sorts a row by: a missing value sorts last either way, the ranking's order breaks ties. */
130
+ export function socialOutlierSortValue(row: SocialOutlierRow, columnId: SocialOutlierColumnId): SortComparableValue {
131
+ switch (columnId) {
132
+ case "ticker": return row.symbol;
133
+ case "company": return row.name?.toLocaleLowerCase("en-US") ?? null;
134
+ case "day": return row.day;
135
+ case "countedAt": return row.countedAt;
136
+ case "mentions": return row.mentions;
137
+ case "baseline": return row.baseline;
138
+ case "ratio": return row.ratio;
139
+ case "stance": return row.stance;
140
+ case "price": return row.price?.changePct ?? null;
141
+ }
142
+ }
143
+
144
+ /** Names sort A to Z first, figures and dates largest first. */
145
+ export function socialOutlierFirstDirection(columnId: SocialOutlierColumnId): "asc" | "desc" {
146
+ return columnId === "ticker" || columnId === "company" ? "asc" : "desc";
147
+ }
148
+
149
+ /** Whether a query narrows the window it reads. */
150
+ export function socialOutliersFiltered(query: SocialOutliersQuery): boolean {
151
+ return query.minPosts > 0 || query.cap !== null;
152
+ }
153
+
154
+ export function socialOutliersEmptyTitle(window: SocialOutlierWindow, freshFrom: string, filtered: boolean): string {
155
+ const since = window === "today" ? "today" : `since ${formatShortDate(freshFrom, { utc: true })}`;
156
+ return filtered ? `No ticker counted ${since} matches these filters.` : `No ticker has been counted ${since}.`;
157
+ }
158
+
159
+ /** The opened ticker's title: its symbol and company, said once. */
160
+ export function socialOutlierDetailTitle(row: Pick<SocialOutlierRow, "symbol" | "name">): string {
161
+ return row.name ? `${row.symbol} \u00b7 ${row.name}` : row.symbol;
162
+ }
@@ -0,0 +1,51 @@
1
+ import type { SocialOutliersPayload } from "../../../api-client/social-mentions";
2
+ import { LISTING_SEARCH_LIMIT, listingExchange } from "../../../tickers/search";
3
+ import type { DataProvider } from "../../../types/data-provider";
4
+ import type { InstrumentSearchResult } from "../../../types/instrument";
5
+ import { isUsListingExchange } from "../../../utils/exchanges";
6
+ import { logFailure } from "../../../utils/log-failure";
7
+
8
+ /** What a name lookup reads through: the data provider's batched search, or nothing. */
9
+ export type OutlierNameSource = Partial<Pick<DataProvider, "searchBatch">> | null | undefined;
10
+
11
+ /**
12
+ * The name ticker search lists a bare symbol under. A cashtag is a US ticker,
13
+ * so the symbol's US listing leads, as it does when the app resolves a bare
14
+ * symbol; the listing the service marks as the company's home comes first
15
+ * among them, then search's own order. A row that carries only the symbol
16
+ * for a name (QCOM on TSX) names nothing, as the overview's title reads it.
17
+ */
18
+ export function outlierListingName(rows: readonly InstrumentSearchResult[], symbol: string): string | null {
19
+ const exact = rows.filter((row) => row.symbol.trim().toUpperCase() === symbol);
20
+ const us = exact.filter((row) => isUsListingExchange(listingExchange(row)));
21
+ const pool = us.length ? us : exact;
22
+ for (const row of [...pool.filter((candidate) => candidate.homeListing === true), ...pool.filter((candidate) => candidate.homeListing !== true)]) {
23
+ const name = row.name?.trim();
24
+ if (name && name.toUpperCase() !== symbol) return name;
25
+ }
26
+ return null;
27
+ }
28
+
29
+ /**
30
+ * The ranking with each row's company named as ticker search names it. The
31
+ * stored screener names are kept as they came (some in capitals, ETFs and
32
+ * foreign listings without one), so the ranking read them wrong beside the
33
+ * name DES and search show for the same ticker. One batched search asks for
34
+ * every symbol (the provider sends up to 100 to the service in one request),
35
+ * never one request a row. A row search has no name for, a provider that
36
+ * cannot batch, and a search that fails keep the stored name: names are
37
+ * never worth losing the ranking for.
38
+ */
39
+ export async function withListingNames(
40
+ payload: SocialOutliersPayload,
41
+ source: OutlierNameSource,
42
+ signal?: AbortSignal,
43
+ ): Promise<SocialOutliersPayload> {
44
+ const symbols = [...new Set(payload.rows.map((row) => row.symbol.trim().toUpperCase()))];
45
+ if (!symbols.length || !source?.searchBatch) return payload;
46
+ const answers = await source.searchBatch(symbols, { limit: LISTING_SEARCH_LIMIT, ...signal ? { signal } : {} })
47
+ .catch(logFailure("social-mentions.outliers", "Naming the outliers through search failed", null));
48
+ if (!answers) return payload;
49
+ const names = new Map(symbols.map((symbol) => [symbol, outlierListingName(answers.get(symbol) ?? [], symbol)] as const));
50
+ return { ...payload, rows: payload.rows.map((row) => ({ ...row, name: names.get(row.symbol.trim().toUpperCase()) ?? row.name })) };
51
+ }