gloomberb 0.20.2 → 0.20.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -0,0 +1,276 @@
1
+ import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
2
+ import type { SocialOutlierCap, SocialOutlierRow, SocialOutliersPayload, SocialOutlierWindow } from "../../../api-client/social-mentions";
3
+ import {
4
+ DataTableStackView,
5
+ PaneStatusBody,
6
+ QueryBar,
7
+ usePaneNoticeFooter,
8
+ usePaneStatusFooter,
9
+ type DataTableCell,
10
+ type QueryBarFilter,
11
+ } from "../../../components";
12
+ import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
13
+ import { ageFooterSegment } from "../../../components/layout/pane/footer";
14
+ import { useAsyncResource, useAutoRefresh, useMarketData, usePluginPaneState, useUpdatedAgo } from "../../../public/react";
15
+ import { useThemeColors } from "../../../theme/theme-context";
16
+ import { Box } from "../../../ui";
17
+ import { compareSortValues, nextHeaderSort } from "../../../utils/sort-values";
18
+ import { SignInWall } from "../cloud/auth-actions";
19
+ import type { CloudResource } from "../shared/cloud-resource";
20
+ import { listingCell, missingCell, signedColor } from "../shared/research-cells";
21
+ import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
22
+ import { socialCount, socialRatio, socialStance, stanceWord } from "./model";
23
+ import { cachedSocialOutliers, DEFAULT_SOCIAL_OUTLIERS_QUERY, loadSocialOutliers, type SocialOutliersQuery } from "./outliers-client";
24
+ import {
25
+ buildSocialOutlierColumns,
26
+ outlierCountedAt,
27
+ outlierDay,
28
+ outlierPrice,
29
+ SOCIAL_OUTLIER_CAP_OPTIONS,
30
+ socialOutlierMinOptions,
31
+ SOCIAL_OUTLIER_WINDOW_OPTIONS,
32
+ socialOutlierDetailTitle,
33
+ socialOutlierFirstDirection,
34
+ socialOutliersEmptyTitle,
35
+ socialOutliersFiltered,
36
+ socialOutliersQueryFrom,
37
+ socialOutlierSortValue,
38
+ type SocialOutlierColumn,
39
+ type SocialOutlierColumnId,
40
+ } from "./outliers-model";
41
+
42
+ /** A ticker opened from the ranking: BUZZ on its cashtag, in the ranking's stack. */
43
+ export interface SocialOpenedTicker {
44
+ symbol: string;
45
+ width: number;
46
+ height: number;
47
+ focused: boolean;
48
+ /** A day opened in the ticker: Esc closes it before the ticker. */
49
+ onDetailChange: (open: boolean) => void;
50
+ }
51
+
52
+ /** A ranking with the query it answers, so rows another query left on screen are told from this one's. */
53
+ interface SocialOutliersAnswer {
54
+ query: SocialOutliersQuery;
55
+ resource: CloudResource<SocialOutliersPayload>;
56
+ }
57
+
58
+ /** A multiple this high reads in the warning tone, as it does in the ticker's own days. */
59
+ const LOUD_RATIO = 2.5;
60
+
61
+ /**
62
+ * BUZZ without a ticker: the tickers whose posts on X jump the most against
63
+ * their own 30-day median, on each one's latest closed day or today so far,
64
+ * with the stance of the day's top posts and the price move. Filters narrow
65
+ * by posts and market value. Enter or a double click opens the ticker here as
66
+ * BUZZ on its cashtag; Back or Esc returns to the same row.
67
+ */
68
+ export function SocialOutliersView({ width, height, focused, renderTicker }: {
69
+ width: number;
70
+ height: number;
71
+ focused: boolean;
72
+ /** The ticker's BUZZ; the pane draws it, as it draws BUZZ on a ticker. */
73
+ renderTicker: (ticker: SocialOpenedTicker) => ReactNode;
74
+ }) {
75
+ const colors = useThemeColors();
76
+ const session = useResearchCloudSession();
77
+ // Each part of the query is its own pane state, so `gloom shot BUZZ --window today` sets them one by one.
78
+ const [storedWindow, setWindow] = usePluginPaneState<SocialOutlierWindow>("social-mentions:outliers:window", DEFAULT_SOCIAL_OUTLIERS_QUERY.window);
79
+ const [storedMin, setMin] = usePluginPaneState<number>("social-mentions:outliers:minPosts", DEFAULT_SOCIAL_OUTLIERS_QUERY.minPosts);
80
+ const [storedCap, setCap] = usePluginPaneState<SocialOutlierCap | "all">("social-mentions:outliers:cap", "all");
81
+ const query = useMemo(() => socialOutliersQueryFrom({ window: storedWindow, minPosts: storedMin, cap: storedCap }),
82
+ [storedCap, storedMin, storedWindow]);
83
+ const [selectedSymbol, setSelectedSymbol] = usePluginPaneState<string | null>("social-mentions:outliers:selected", null);
84
+ // The opened ticker, with its company as it was opened, so the title keeps it when a refreshed ranking no longer lists it.
85
+ const [openSymbol, setOpenSymbol] = usePluginPaneState<string | null>("social-mentions:outliers:open", null);
86
+ const [openName, setOpenName] = usePluginPaneState<string | null>("social-mentions:outliers:openName", null);
87
+ // The ticker's own day and cursor, which BUZZ on a ticker keeps: an opened ticker starts on its newest day.
88
+ const [, setTickerDay] = usePluginPaneState<string | null>("social-mentions:open", null);
89
+ const [, setTickerSelected] = usePluginPaneState<string | null>("social-mentions:selected", null);
90
+ const [dayOpen, setDayOpen] = useState(false);
91
+ const [sort, setSort] = useState<{ columnId: SocialOutlierColumnId; direction: "asc" | "desc" }>({ columnId: "ratio", direction: "desc" });
92
+
93
+ // Each ticker is named as search names it, in one batched request with the ranking.
94
+ const marketData = useMarketData();
95
+ const loader = useCallback(
96
+ async (force: boolean): Promise<SocialOutliersAnswer> => ({ query, resource: await loadSocialOutliers(query, { force, names: marketData }) }),
97
+ [marketData, query],
98
+ );
99
+ const resource = useAsyncResource(loader, {
100
+ initialData: () => {
101
+ const cached = cachedSocialOutliers(query);
102
+ return cached ? { query, resource: cached } : null;
103
+ },
104
+ clearOnError: (error) => error instanceof Error && isCloudSessionRequired(error.message),
105
+ // Another window or filter keeps the rows on screen, loading, until its own arrive.
106
+ keepPreviousData: true,
107
+ });
108
+ // Rows another query left stay only while this one loads the first time: once it has failed, the body says so.
109
+ const [failedQuery, setFailedQuery] = useState<SocialOutliersQuery | null>(null);
110
+ const answered = resource.data?.query === query ? resource.data.resource : null;
111
+ useEffect(() => {
112
+ if (!answered && resource.error) setFailedQuery(query);
113
+ }, [answered, query, resource.error]);
114
+ const shown = answered ?? (resource.loading && failedQuery !== query ? resource.data?.resource ?? null : null);
115
+ useAutoRefresh(resource.updatedAt, resource.load);
116
+ const detailOpen = !!openSymbol;
117
+ // An opened ticker refreshes itself.
118
+ usePaneRefreshKey(() => void resource.reload(), { focused, enabled: !detailOpen });
119
+ // Signing in or out reads the ranking again for the new session.
120
+ const sessionKeyRef = useRef(session.requestKey);
121
+ const reload = resource.reload;
122
+ useEffect(() => {
123
+ if (sessionKeyRef.current === session.requestKey) return;
124
+ sessionKeyRef.current = session.requestKey;
125
+ void reload();
126
+ }, [reload, session.requestKey]);
127
+
128
+ const data = shown?.payload ?? null;
129
+ // Rows of the other window, kept on screen while this one loads, keep their own columns.
130
+ const dataWindow: SocialOutlierWindow = data?.window ?? query.window;
131
+ const rows = data?.rows ?? [];
132
+ const sortedRows = useMemo(() => {
133
+ const order = new Map(rows.map((row, index) => [row.symbol, index]));
134
+ return [...rows].sort((a, b) => (
135
+ compareSortValues(socialOutlierSortValue(a, sort.columnId), socialOutlierSortValue(b, sort.columnId), sort.direction)
136
+ || order.get(a.symbol)! - order.get(b.symbol)!
137
+ ));
138
+ }, [rows, sort]);
139
+ const columns = useMemo(() => buildSocialOutlierColumns(width, rows, dataWindow), [dataWindow, rows, width]);
140
+ // The ticker stays open while the ranking refreshes, ranked or not: it reads its own history.
141
+ const openRow = openSymbol ? rows.find((row) => row.symbol === openSymbol) ?? null : null;
142
+ const openTitle = openSymbol ? socialOutlierDetailTitle(openRow ?? { symbol: openSymbol, name: openName }) : "";
143
+ const openTicker = useCallback((row: SocialOutlierRow) => {
144
+ setSelectedSymbol(row.symbol);
145
+ setTickerDay(null);
146
+ setTickerSelected(null);
147
+ setOpenName(row.name);
148
+ setOpenSymbol(row.symbol);
149
+ }, [setOpenName, setOpenSymbol, setSelectedSymbol, setTickerDay, setTickerSelected]);
150
+ const closeTicker = useCallback(() => {
151
+ setDayOpen(false);
152
+ setOpenSymbol(null);
153
+ setOpenName(null);
154
+ }, [setOpenName, setOpenSymbol]);
155
+
156
+ const updatedAgo = useUpdatedAgo(resource.updatedAt);
157
+ usePaneStatusFooter({
158
+ registrationId: "social-mentions:outliers",
159
+ enabled: !detailOpen,
160
+ loading: resource.loading,
161
+ error: data ? resource.error : null,
162
+ stale: !!data && !!shown?.stale,
163
+ info: data && updatedAgo ? [ageFooterSegment(updatedAgo)] : [],
164
+ });
165
+ usePaneNoticeFooter({
166
+ registrationId: "social-mentions:outliers:notices",
167
+ focused,
168
+ enabled: !detailOpen,
169
+ notices: shown?.refreshError ? [shown.refreshError] : [],
170
+ });
171
+
172
+ const renderCell = useCallback((row: SocialOutlierRow, column: SocialOutlierColumn, _index: number, state: { selected: boolean }): DataTableCell => {
173
+ switch (column.id) {
174
+ case "ticker": return listingCell(row.symbol, colors, state.selected);
175
+ case "company": return row.name ? { text: row.name, color: colors.textMuted } : missingCell(colors);
176
+ case "day": return { text: outlierDay(row), value: row.day, color: colors.textDim };
177
+ case "countedAt": return { text: outlierCountedAt(row), value: row.countedAt, color: colors.textDim };
178
+ case "mentions": return { text: socialCount(row.mentions), value: row.mentions, color: colors.text };
179
+ case "baseline": return { text: socialCount(row.baseline), value: row.baseline, color: colors.textMuted };
180
+ case "ratio": return { text: socialRatio(row.ratio), value: row.ratio, color: row.ratio >= LOUD_RATIO ? colors.warning : colors.text };
181
+ case "stance": {
182
+ if (row.stance == null) return missingCell(colors);
183
+ const word = stanceWord(row.stance);
184
+ return { text: socialStance(row.stance), value: row.stance, color: word === "bullish" ? colors.positive : word === "bearish" ? colors.negative : colors.text };
185
+ }
186
+ case "price": return row.price ? { text: outlierPrice(row), value: row.price.changePct, color: signedColor(row.price.changePct, colors) } : missingCell(colors);
187
+ }
188
+ }, [colors]);
189
+
190
+ if (!data && isCloudSessionRequired(resource.error)) {
191
+ return <SignInWall placement="social-outliers-signin" width={width} height={height} action="view social outliers" needsVerification={session.needsVerification} />;
192
+ }
193
+
194
+ const filters: QueryBarFilter[] = [
195
+ {
196
+ id: "window",
197
+ label: "Window",
198
+ title: "The day each ticker is counted on",
199
+ value: query.window,
200
+ options: SOCIAL_OUTLIER_WINDOW_OPTIONS,
201
+ inline: true,
202
+ onChange: (value: SocialOutlierWindow) => setWindow(value),
203
+ },
204
+ {
205
+ id: "posts",
206
+ label: "Posts",
207
+ title: "Least posts on the day",
208
+ value: String(query.minPosts),
209
+ defaultValue: String(DEFAULT_SOCIAL_OUTLIERS_QUERY.minPosts),
210
+ options: socialOutlierMinOptions(query.minPosts),
211
+ onChange: (value: string) => setMin(Number(value)),
212
+ },
213
+ {
214
+ id: "cap",
215
+ label: "Cap",
216
+ title: "Market value",
217
+ value: query.cap ?? "all",
218
+ defaultValue: "all",
219
+ options: SOCIAL_OUTLIER_CAP_OPTIONS,
220
+ onChange: (value: SocialOutlierCap | "all") => setCap(value),
221
+ },
222
+ ];
223
+ const queryBar = <QueryBar width={width} filters={filters} />;
224
+ const ticker = openSymbol
225
+ ? renderTicker({ symbol: openSymbol, width, height: Math.max(3, height - 1), focused, onDetailChange: setDayOpen })
226
+ : null;
227
+ if (!data && !detailOpen) {
228
+ // Loading, or a failure: the query bar stays above, so another window or filter is one click away.
229
+ return (
230
+ <Box flexDirection="column" width={width} height={height}>
231
+ {queryBar}
232
+ <PaneStatusBody
233
+ loading={resource.loading}
234
+ error={resource.error}
235
+ retry={{ onRetry: () => void resource.reload(), pending: resource.loading }}
236
+ subject="social outliers"
237
+ />
238
+ </Box>
239
+ );
240
+ }
241
+
242
+ return (
243
+ <DataTableStackView<SocialOutlierRow, SocialOutlierColumn>
244
+ // Its keys pass to an open day first, so Esc closes that before the ticker.
245
+ focused={focused && !dayOpen}
246
+ detailOpen={detailOpen}
247
+ onBack={closeTicker}
248
+ detailTitle={openTitle || undefined}
249
+ detailContent={ticker}
250
+ rootWidth={width}
251
+ rootHeight={height}
252
+ rootBefore={queryBar}
253
+ columns={columns}
254
+ items={sortedRows}
255
+ getItemKey={(row) => row.symbol}
256
+ selection={{
257
+ kind: "id",
258
+ selectedId: selectedSymbol,
259
+ getId: (row) => row.symbol,
260
+ onChange: (symbol) => setSelectedSymbol(symbol),
261
+ }}
262
+ onActivate={openTicker}
263
+ sortColumnId={sort.columnId}
264
+ sortDirection={sort.direction}
265
+ onHeaderClick={(columnId) => setSort((current) => nextHeaderSort(current, columnId as SocialOutlierColumnId, {
266
+ firstDirection: socialOutlierFirstDirection,
267
+ }))}
268
+ renderCell={renderCell}
269
+ selectedTextOverridesCellColor
270
+ showHorizontalScrollbar={false}
271
+ emptyStateTitle={data
272
+ ? socialOutliersEmptyTitle(data.window, data.freshFrom, socialOutliersFiltered(query))
273
+ : resource.loading ? "Loading social outliers..." : "Social outliers unavailable."}
274
+ />
275
+ );
276
+ }
@@ -12,6 +12,8 @@ import { isPlainKey } from "../../../utils/keyboard";
12
12
  import { SignInWall } from "../cloud/auth-actions";
13
13
  import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
14
14
  import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
15
+ import { usePaneInstance } from "../../../state/app/context";
16
+ import { SocialOutliersView, type SocialOpenedTicker } from "./outliers";
15
17
  import { asSessionRequired, cachedSocialMentions, loadSocialMentionPosts, loadSocialMentions } from "./client";
16
18
  import { SOCIAL_COLUMNS, socialChartPoints, socialCount, socialDayRows, socialRatio, socialStance, socialSummary, sortedSocialRows, stanceWord, topPostCell, type SocialColumn, type SocialDayRow, type SocialSort } from "./model";
17
19
 
@@ -70,11 +72,18 @@ function DayDetail({ symbol, row, recent, width, height }: {
70
72
  </Box>;
71
73
  }
72
74
 
73
- export function SocialMentionsPane({ width, height, focused }: Pick<PaneProps, "width" | "height" | "focused">) {
74
- const { ticker } = usePaneTickerIdentity();
75
+ /**
76
+ * BUZZ on a listing: its daily posts on X against their median, the chart and
77
+ * the days. `listingKey` is the pane's ticker, or one opened from the ranking.
78
+ */
79
+ function SocialMentionsTickerView({ width, height, focused, listingKey, onDetailChange }: Pick<PaneProps, "width" | "height" | "focused"> & {
80
+ listingKey: string | undefined;
81
+ /** Opened from the ranking: whether a day is open, so Esc closes it first. */
82
+ onDetailChange?: (open: boolean) => void;
83
+ }) {
75
84
  const [rangeValue] = usePaneSettingValue("socialRange", "1y");
76
85
  const range: SocialMentionsRange = RANGES.includes(rangeValue as SocialMentionsRange) ? rangeValue as SocialMentionsRange : "1y";
77
- const listing = listingIdentity(ticker?.metadata.ticker);
86
+ const listing = listingIdentity(listingKey);
78
87
  const symbol = listing?.symbol && /^[A-Z][A-Z0-9]{0,5}$/.test(listing.symbol) ? listing.symbol : null;
79
88
  const session = useResearchCloudSession();
80
89
  const loader = useCallback((force: boolean) => loadSocialMentions(symbol!, range, force).catch((error: unknown) => { throw asSessionRequired(error); }),
@@ -110,6 +119,9 @@ export function SocialMentionsPane({ width, height, focused }: Pick<PaneProps, "
110
119
  return () => clearTimeout(timer);
111
120
  }, [pending, resource.updatedAt, resource.reload]);
112
121
  useAutoRefresh(resource.updatedAt, resource.load);
122
+ const dayOpen = !!openRow;
123
+ useEffect(() => onDetailChange?.(dayOpen), [dayOpen, onDetailChange]);
124
+ useEffect(() => () => onDetailChange?.(false), [onDetailChange]);
113
125
  useShortcut((event) => { if (focused && isPlainKey(event, "r")) { event.preventDefault(); void resource.reload(); } });
114
126
  usePaneNoticeFooter({ registrationId: "social-mentions:notices", focused,
115
127
  notices: [...(data?.warnings ?? []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
@@ -157,3 +169,20 @@ export function SocialMentionsPane({ width, height, focused }: Pick<PaneProps, "
157
169
  </PaneStatusBody>
158
170
  </Box>;
159
171
  }
172
+
173
+ const renderOpenedTicker = ({ symbol, ...props }: SocialOpenedTicker) => <SocialMentionsTickerView {...props} listingKey={symbol} />;
174
+
175
+ /**
176
+ * BUZZ on a ticker is that ticker's posts on X; without one it is the ranking
177
+ * of the market's social outliers. A ranked ticker opens here as BUZZ on its
178
+ * cashtag, and Back returns to the ranking.
179
+ */
180
+ export function SocialMentionsPane({ width, height, focused }: Pick<PaneProps, "width" | "height" | "focused">) {
181
+ const { symbol, ticker } = usePaneTickerIdentity();
182
+ const instance = usePaneInstance();
183
+ // No ticker at all is the ranking; a pane linked to a list keeps its own empty state while the list has nothing selected.
184
+ if (!symbol && instance?.binding?.kind !== "follow") {
185
+ return <SocialOutliersView width={width} height={height} focused={focused} renderTicker={renderOpenedTicker} />;
186
+ }
187
+ return <SocialMentionsTickerView width={width} height={height} focused={focused} listingKey={ticker?.metadata.ticker} />;
188
+ }
@@ -151,13 +151,13 @@ export function SupplyGraphPane({ symbol, tab, width, height, focused }: { symbo
151
151
  ...(!openPath ? [{ id: "inputs", key: "i", label: "nputs", onPress: () => setInputsOpen(true) }] : []),
152
152
  ...(selectedPath && !openPath ? [{ id: "evidence", key: "e", label: "vidence", onPress: details }] : []),
153
153
  ...(tab === "graph" && !openPath && selected && selected.id !== data?.entity?.id ? [{ id: "target", key: "p", label: "aths to target", onPress: () => applyTarget(entityKey(selected)) },
154
- { id: "collapse", key: "c", label: collapsed.includes(selected.id) ? "expand" : "ollapse", onPress: () => setCollapsed(old => old.includes(selected.id) ? old.filter(id => id !== selected.id) : [...old, selected.id]) }] : []),
154
+ { id: "collapse", key: "c", label: collapsed.includes(selected.id) ? "expand" : "ollapse", title: collapsed.includes(selected.id) ? "Expand" : "Collapse", onPress: () => setCollapsed(old => old.includes(selected.id) ? old.filter(id => id !== selected.id) : [...old, selected.id]) }] : []),
155
155
  ...(!openPath && selected?.ticker ? [
156
156
  { id: "description", key: "d", label: "es", onPress: () => openDescription(entityKey(selected)) },
157
157
  { id: "financials", key: "f", label: "a", onPress: () => createPaneFromTemplate("financial-analysis-pane", { symbol: entityKey(selected) }) },
158
158
  { id: "chart", key: "g", label: "raph", onPress: () => createPaneFromTemplate("chart-composer-pane", { arg: entityKey(selected) }) },
159
159
  ] : []),
160
- ...(!openPath && (focus !== symbol || target) ? [{ id: "home", key: "z", label: "reset focus", onPress: () => { setFocus(symbol); applyTarget(""); setCollapsed([]); setSelected(null); } }] : []),
160
+ ...(!openPath && (focus !== symbol || target) ? [{ id: "home", key: "z", label: "reset focus", title: "Reset Focus", onPress: () => { setFocus(symbol); applyTarget(""); setCollapsed([]); setSelected(null); } }] : []),
161
161
  ...(data?.access === "preview" ? [{ id: "upgrade", key: CLOUD_PLAN_KEY, label: "upgrade", onPress: openUpgrade }] : []),
162
162
  ];
163
163
  useAutoRefresh(resource.updatedAt, resource.load);
@@ -114,6 +114,33 @@ function cacheKey(path: string, params: URLSearchParams): string {
114
114
  return query ? `${path}?${query}` : path;
115
115
  }
116
116
 
117
+ const isRateLimited = (error: unknown): error is ApiRequestError => error instanceof ApiRequestError && error.status === 429;
118
+
119
+ /** How long to wait before asking again, in whole seconds, from a rate limit's `Retry-After`. */
120
+ export function retryAfterSeconds(error: unknown): number | null {
121
+ return isRateLimited(error) && error.retryAfterMs != null && error.retryAfterMs > 0
122
+ ? Math.ceil(error.retryAfterMs / 1000)
123
+ : null;
124
+ }
125
+
126
+ /** A refusal that carries no words of the service's own: an empty body, or the status alone. */
127
+ const GENERIC_LIMIT_TEXT = /^\s*(?:(?:HTTP\s*)?429\b.*|too many requests\.?)?\s*$/i;
128
+
129
+ /**
130
+ * A 13F read the service refused for its signed-out limit: the service's own
131
+ * message when it sent one (it says how long to wait and that signing in lifts
132
+ * the limit), else the same in the app's words. The limit itself is the
133
+ * service's.
134
+ */
135
+ export function thirteenFReadError(error: unknown): unknown {
136
+ if (!isRateLimited(error) || !GENERIC_LIMIT_TEXT.test(error.message)) return error;
137
+ const seconds = retryAfterSeconds(error);
138
+ return new ApiRequestError(
139
+ `Too many 13F reads without signing in: try again in ${seconds != null ? `${seconds} s` : "a minute"}, or sign in to lift the limit.`,
140
+ 429, error.retryAfterMs, error.code, error.details,
141
+ );
142
+ }
143
+
117
144
  async function fetchForms13F<T>(
118
145
  path: string,
119
146
  params: Record<string, string | number | undefined>,
@@ -154,15 +181,22 @@ async function fetchForms13F<T>(
154
181
  let value: T;
155
182
  try {
156
183
  value = await apiClient.getCloudSec13F(path, params, { signal: options.signal }) as T;
157
- } catch (error) {
184
+ } catch (cloudError) {
158
185
  options.signal?.throwIfAborted();
186
+ const error = thirteenFReadError(cloudError);
159
187
  if (options.cloudOnly) throw error;
160
188
  const url = `${FORMS_13F_BASE_URL}${path}?${searchParams.toString()}`;
189
+ // The service's own limit says when to ask again; a direct read that fails as well says less.
161
190
  const response = await httpFetch(url, {
162
191
  headers: { Accept: "application/json" },
163
192
  signal: options.signal,
193
+ }).catch((fallbackError: unknown) => {
194
+ throw isRateLimited(error) ? error : fallbackError;
164
195
  });
165
- if (!response.ok) throw new ApiRequestError(`Forms13F ${response.status} for ${path}`, response.status);
196
+ if (!response.ok) {
197
+ if (isRateLimited(error)) throw error;
198
+ throw new ApiRequestError(`Forms13F ${response.status} for ${path}`, response.status);
199
+ }
166
200
  value = await response.json() as T;
167
201
  }
168
202
  options.signal?.throwIfAborted();
@@ -9,6 +9,7 @@ import {
9
9
  lookupThirteenFHoldersByCusip,
10
10
  lookupThirteenFTickers,
11
11
  normalizeCik,
12
+ retryAfterSeconds,
12
13
  searchThirteenFFunds,
13
14
  } from "./api";
14
15
  import { isoDateDaysAgo, isoDateToday, isoDateYearsAgo } from "../../../utils/calendar-date";
@@ -604,7 +605,7 @@ export async function loadFundDetail(
604
605
  const latestForm = latestReport?.filings.at(-1) ?? null;
605
606
  const previousForm = previousReport?.filings.at(-1) ?? null;
606
607
  const checkGap = options.filingGap !== false;
607
- const parts: Pick<FundDetailData, "latestHoldings" | "previousHoldings" | "filingGap"> & { loading: ThirteenFDetailLoading } = {
608
+ const parts: Pick<FundDetailData, "latestHoldings" | "previousHoldings" | "filingGap" | "comparisonFailed"> & { loading: ThirteenFDetailLoading } = {
608
609
  latestHoldings: [],
609
610
  previousHoldings: [],
610
611
  filingGap: null,
@@ -624,6 +625,7 @@ export async function loadFundDetail(
624
625
  previousReport,
625
626
  warnings: [...warnings],
626
627
  filingGap: parts.filingGap,
628
+ ...(parts.comparisonFailed ? { comparisonFailed: parts.comparisonFailed } : {}),
627
629
  ...(saved.savedAt != null ? { savedAt: saved.savedAt } : {}),
628
630
  ...(Object.keys(loading).length ? { loading } : {}),
629
631
  };
@@ -667,6 +669,7 @@ export async function loadFundDetail(
667
669
  loadReport(previousReport).catch((error) => {
668
670
  if (signal?.aborted) throw error;
669
671
  if (previousReport) previousReport.complete = false;
672
+ parts.comparisonFailed = { retryAfterSeconds: retryAfterSeconds(error) };
670
673
  warnings.push(`${previousReport?.periodOfReport ?? "Prior quarter"}: holdings unavailable; comparison unavailable.`);
671
674
  return [];
672
675
  }).then((rows) => {
@@ -28,6 +28,7 @@ import {
28
28
  isOptionType,
29
29
  isStaleFiling,
30
30
  markedPositionType,
31
+ nextFilingText,
31
32
  OPTION_ROWS_NOTE,
32
33
  restatedValuesText,
33
34
  splitAdjustedText,
@@ -59,10 +60,12 @@ import {
59
60
  buildTimelineRows,
60
61
  filingGapFor,
61
62
  inferBrowserTabFromQuery,
63
+ comparedWithText,
62
64
  hasComparable13FQuarter,
63
65
  isCikQuery,
64
66
  isTickerShapedQuery,
65
67
  newestDueQuarter,
68
+ nextThirteenFDue,
66
69
  oneFundPerCik,
67
70
  positionType,
68
71
  quartersBehindLatest,
@@ -168,11 +171,8 @@ const HOLDING_COLUMNS: HeadlessPaneColumn[] = [
168
171
 
169
172
  const FILING_COLUMNS: HeadlessPaneColumn[] = [
170
173
  { key: "periodOfReport", header: "Period" },
171
- {
172
- key: "filedAsOfDate",
173
- header: "Filed",
174
- format: (value) => formatShortDate(typeof value === "string" ? value : null, FILING_DAY_FORMAT),
175
- },
174
+ // The whole day, as the period beside it: the list spans years.
175
+ { key: "filedAsOfDate", header: "Filed", format: (value) => (typeof value === "string" && value) || "--" },
176
176
  {
177
177
  key: "tableValueTotal",
178
178
  header: "Value (USD)",
@@ -761,6 +761,8 @@ export function createThirteenFHeadless(
761
761
  );
762
762
  const previousPeriod = detail.previousForm?.periodOfReport ?? null;
763
763
  const comparable = hasComparable13FQuarter(detail);
764
+ const nextDue = nextThirteenFDue(latestPeriod);
765
+ const nextFiling = nextDue ? nextFilingText(nextDue) : null;
764
766
  const filed = detail.latestForm?.filedAsOfDate || null;
765
767
  const cut = cutText(all.length, limit, "positions, exits included");
766
768
  // Values, weights and Est P&L read both compared quarters' filings.
@@ -802,7 +804,13 @@ export function createThirteenFHeadless(
802
804
  truncated: all.length > limit,
803
805
  notices: [
804
806
  ...flagNotices,
805
- [`CIK ${detail.cik}`, filedPeriodText(latestPeriod, filed, comparable ? previousPeriod : null)].filter(Boolean).join(" | "),
807
+ [
808
+ `CIK ${detail.cik}`,
809
+ filedPeriodText(latestPeriod, filed, comparable ? previousPeriod : null),
810
+ // The prior quarter on file that did not load is said, never left out as if there were none.
811
+ ...(detail.comparisonFailed ? [`QoQ: ${comparedWithText(detail)}`] : []),
812
+ ...(nextFiling ? [`Next 13F ${nextFiling.quarter}, ${nextFiling.due}`] : []),
813
+ ].filter(Boolean).join(" | "),
806
814
  AS_FILED_VALUE,
807
815
  ...(restated ? [restated] : []),
808
816
  ...holdingSplitNotes(rows),
@@ -136,6 +136,28 @@ export function newestDueQuarter(now = new Date()): { period: string; due: strin
136
136
  }
137
137
  }
138
138
 
139
+ /**
140
+ * The fund's next 13F: the first quarter after its latest report whose
141
+ * deadline (thirteenFDueDate: 45 days, past a weekend or Presidents' Day) is
142
+ * today or later in New York. Q3 2026's falls on Saturday 14 Nov, so it is
143
+ * due Monday 16 Nov. A quarter it is already late for is the filing gap's.
144
+ */
145
+ export function nextThirteenFDue(
146
+ latestPeriod: string | null | undefined,
147
+ now = new Date(),
148
+ ): { period: string; due: string } | null {
149
+ if (!latestPeriod || !/^\d{4}-\d{2}-\d{2}$/.test(latestPeriod)) return null;
150
+ const today = zonedDateKey(now.getTime(), "America/New_York");
151
+ const year = Number(latestPeriod.slice(0, 4));
152
+ const month = Number(latestPeriod.slice(5, 7));
153
+ for (let ahead = 1; ahead <= 8; ahead += 1) {
154
+ const period = new Date(Date.UTC(year, month + ahead * 3, 0)).toISOString().slice(0, 10);
155
+ const due = thirteenFDueDate(period);
156
+ if (due >= today) return { period, due };
157
+ }
158
+ return null;
159
+ }
160
+
139
161
  /**
140
162
  * What a fund whose latest report is `latestPeriod` filed for the newest
141
163
  * quarter past its deadline, or null when that report is not behind it.
@@ -554,6 +576,39 @@ export function hasComparable13FQuarter(data: FundDetailData): boolean {
554
576
  return adjacentQuarterPeriods(current, previous);
555
577
  }
556
578
 
579
+ /**
580
+ * What the fund's holdings are compared with, as its header says it: the
581
+ * prior quarter, dim while it loads; that it did not load, and when to try
582
+ * again, when it is on file but failed ("No prior quarter" read as if the
583
+ * fund had none); or that there is none.
584
+ */
585
+ export function comparedWith(data: FundDetailData | null | undefined): {
586
+ value: string;
587
+ detail?: string;
588
+ tone?: "muted" | "warning";
589
+ } {
590
+ if (data && hasComparable13FQuarter(data)) return { value: data.previousForm!.periodOfReport };
591
+ if (data?.comparisonFailed) {
592
+ const seconds = data.comparisonFailed.retryAfterSeconds;
593
+ return {
594
+ value: "Previous quarter did not load",
595
+ detail: seconds != null ? `try again in ${seconds} s` : "try again",
596
+ tone: "warning",
597
+ };
598
+ }
599
+ // The quarter the changes will compare with, dim until both are in.
600
+ if (data?.loading && hasComparable13FQuarter({ ...data, loading: undefined })) {
601
+ return { value: data.previousForm!.periodOfReport, tone: "muted" };
602
+ }
603
+ return { value: "No prior quarter", tone: "muted" };
604
+ }
605
+
606
+ /** comparedWith in one line: "previous quarter did not load, try again in 40 s". */
607
+ export function comparedWithText(data: FundDetailData | null | undefined): string {
608
+ const compared = comparedWith(data);
609
+ return [compared.value, compared.detail].filter(Boolean).join(", ").replace(/^./, (first) => first.toLowerCase());
610
+ }
611
+
557
612
  function adjacentQuarterPeriods(current: string | undefined, previous: string | undefined): boolean {
558
613
  if (!current || !previous) return false;
559
614
  const date = new Date(`${current}T00:00:00Z`);
@@ -897,7 +952,7 @@ export function buildHoldingColumns(): FundHoldingColumn[] {
897
952
 
898
953
  export function buildTimelineColumns(width: number): FundTimelineColumn[] {
899
954
  const periodWidth = 10;
900
- const filedWidth = 9;
955
+ const filedWidth = 10;
901
956
  const valueWidth = 12;
902
957
  const rowsWidth = 6;
903
958
  const changeWidth = 9;
@@ -38,7 +38,7 @@ import {
38
38
  FUND_DETAIL_TABS,
39
39
  THIRTEENF_PANE_ID,
40
40
  amendmentKind,
41
- hasComparable13FQuarter,
41
+ comparedWith,
42
42
  browserSortFor,
43
43
  buildBrowserColumns,
44
44
  buildFilingPositionColumns,
@@ -48,6 +48,7 @@ import {
48
48
  buildTimelineColumns,
49
49
  buildTimelineRows,
50
50
  inferBrowserTabFromQuery,
51
+ nextThirteenFDue,
51
52
  quartersBehindLatest,
52
53
  selectedIndexById,
53
54
  sortBrowserRows,
@@ -55,7 +56,7 @@ import {
55
56
  sortHoldingRows,
56
57
  sortTimelineRows,
57
58
  } from "./model";
58
- import { filingGapText, holdingUnreadNotes, isOptionType, isStaleFiling, quartersOldText } from "./report-notes";
59
+ import { filingGapText, holdingUnreadNotes, isOptionType, isStaleFiling, nextFilingText, quartersOldText } from "./report-notes";
59
60
  import {
60
61
  renderBrowserCell,
61
62
  renderFilingPositionCell,
@@ -522,17 +523,16 @@ export function FundDetailView({
522
523
  });
523
524
 
524
525
  const quartersBehind = quartersBehindLatest(data?.latestForm?.periodOfReport);
526
+ const nextDue = nextThirteenFDue(data?.latestForm?.periodOfReport);
527
+ const nextFiling = nextDue ? nextFilingText(nextDue) : null;
525
528
  const staleFiling = isStaleFiling(quartersBehind);
526
529
  const holdingStats: StatItem[] = [
527
530
  { id: "reported", label: "Reported", value: data?.latestForm?.periodOfReport ?? "--",
528
531
  detail: `filed ${data?.latestForm?.filedAsOfDate || "--"}${data?.latestForm && amendmentKind(data.latestForm) === "restatement" ? ", restated" : ""}${staleFiling ? `, ${quartersOldText(quartersBehind)}` : ""}`,
529
532
  ...(staleFiling ? { tone: "warning" as const } : {}) },
530
- data && hasComparable13FQuarter(data)
531
- ? { id: "compared", label: "Compared with", value: data.previousForm!.periodOfReport }
532
- // The quarter the changes will compare with, dim until both are in.
533
- : data?.loading && hasComparable13FQuarter({ ...data, loading: undefined })
534
- ? { id: "compared", label: "Compared with", value: data.previousForm!.periodOfReport, tone: "muted" }
535
- : { id: "compared", label: "Compared with", value: "No prior quarter", tone: "muted" },
533
+ { id: "compared", label: "Compared with", ...comparedWith(data) },
534
+ // When the next quarter's holdings come out: 45 days after it ends, moved past a weekend or holiday.
535
+ ...(nextFiling ? [{ id: "next", label: "Next 13F", value: nextFiling.quarter, detail: nextFiling.due }] : []),
536
536
  ...(data?.latestReport && data.latestReport.filings.length > 1
537
537
  ? [{ id: "combined", label: "Combined", value: `${data.latestReport.filings.length} filings` }]
538
538
  : []),
@@ -163,6 +163,17 @@ function quarterText(period: string): string {
163
163
  return day ? `Q${Math.floor(day.getUTCMonth() / 3) + 1} ${day.getUTCFullYear()}` : period;
164
164
  }
165
165
 
166
+ const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
167
+
168
+ /** "Q3 2026" and "due Mon 16 Nov 2026": when the fund's next 13F is due, the weekday shown since the deadline moves off a weekend. */
169
+ export function nextFilingText(next: { period: string; due: string }): { quarter: string; due: string } {
170
+ const day = calendarDay(next.due);
171
+ return {
172
+ quarter: quarterText(next.period),
173
+ due: `due ${day ? `${WEEKDAYS[day.getUTCDay()]} ` : ""}${filingDayText(next.due)}`,
174
+ };
175
+ }
176
+
166
177
  /** The fund to open for a manager: its CIK, else its quoted name. */
167
178
  function openCommand(manager: ThirteenFOtherManager): string {
168
179
  return manager.cik ? `fn 13F ${manager.cik}` : `fn 13F "${manager.name}"`;
@@ -163,7 +163,8 @@ export function renderTimelineCell(
163
163
  attributes: TextAttributes.BOLD,
164
164
  };
165
165
  case "filed":
166
- return { text: formatShortDate(row.filedAsOfDate, FILING_DAY_FORMAT), color: colors.textDim };
166
+ // The whole day, as the period beside it: the list spans years.
167
+ return { text: row.filedAsOfDate || "--", color: colors.textDim };
167
168
  case "value":
168
169
  return { text: formatMoneyCompact(row.tableValueTotal), color: colors.text };
169
170
  case "rows":