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
@@ -100,6 +100,8 @@ export interface DividendRow {
100
100
  currency: string;
101
101
  /** The amount as the company declared it, in another currency (DividendPayment.declared). */
102
102
  declared?: { amount: number; currency: string };
103
+ /** Who published it when not the listing's history: the fund's sponsor (DividendPayment.source). */
104
+ source?: string;
103
105
  }
104
106
 
105
107
  export function toDividendRows(payments: DividendPayment[]): DividendRow[] {
@@ -109,5 +111,6 @@ export function toDividendRows(payments: DividendPayment[]): DividendRow[] {
109
111
  amount: payment.amount,
110
112
  currency: payment.currency,
111
113
  ...(payment.declared ? { declared: payment.declared } : {}),
114
+ ...(payment.source ? { source: payment.source.publisher } : {}),
112
115
  }));
113
116
  }
@@ -3,7 +3,7 @@ import type { DataTableColumn } from "../../../components";
3
3
  import { colors } from "../../../theme/colors";
4
4
  import { displayWidth, MISSING_VALUE } from "../../../utils/format";
5
5
  import { fetchEconCalendar } from "./calendar-source";
6
- import { parseEconFigure } from "./figures";
6
+ import { figureWithCurrency, parseEconFigure } from "./figures";
7
7
  import { resolveFredMapping } from "./fred-series-map";
8
8
  import { STATS } from "../econ-statistics/stats";
9
9
  import { isAllDayEvent, type EconEvent, type EconImpact } from "./types";
@@ -289,12 +289,30 @@ function statNamesOf(seriesId: string): readonly string[] {
289
289
  return statNames.get(seriesId) ?? [];
290
290
  }
291
291
 
292
+ /** The FRED series ECST names by each of its labels and aliases, compacted: `nonfarmpayrolls` is PAYEMS. */
293
+ let statSeries: ReadonlyMap<string, string> | null = null;
294
+
295
+ /**
296
+ * The FRED series a calendar row is a release of, when one is known: its
297
+ * name as the series map reads it (Non-Farm Employment Change is PAYEMS),
298
+ * else a US row named as ECST names a series (Non Farm Payrolls, one feed's
299
+ * name for the same release). One release listed under two names is one
300
+ * series. Null for any other row.
301
+ */
302
+ export function eventSeriesId(event: Pick<EconEvent, "country" | "event">): string | null {
303
+ const mapped = resolveFredMapping(event.event, event.country)?.seriesId;
304
+ if (mapped) return mapped;
305
+ if (eventCountry(event) !== "US") return null;
306
+ statSeries ??= new Map(STATS.flatMap((stat) => [stat.label, ...stat.aliases ?? []].map((name) => [compactName(name), stat.seriesId] as const)));
307
+ return statSeries.get(compactName(event.event)) ?? null;
308
+ }
309
+
292
310
  /**
293
311
  * The names a row is searched by, compacted: the feed's own and the one the
294
312
  * calendar shows, then what ECST calls the series the release is of
295
313
  * (Non-Farm Employment Change is also nonfarm payrolls, nfp and the jobs report).
296
314
  */
297
- function eventSearchNames(event: Pick<EconEvent, "country" | "event" | "actual" | "forecast" | "prior">): string[] {
315
+ export function eventSearchNames(event: Pick<EconEvent, "country" | "event" | "actual" | "forecast" | "prior">): string[] {
298
316
  const series = resolveFredMapping(event.event, event.country)?.seriesId;
299
317
  return [...[event.event, econEventName(event)].map(compactName), ...series ? statNamesOf(series) : []];
300
318
  }
@@ -489,7 +507,7 @@ const MAX_VALUE_WIDTH = 12;
489
507
  */
490
508
  export function valueColumnWidth(events: readonly EconEvent[], key: "actual" | "forecast" | "prior", base: number): number {
491
509
  let width = base;
492
- for (const event of events) width = Math.max(width, Math.min(MAX_VALUE_WIDTH, displayWidth(event[key] ?? "")));
510
+ for (const event of events) width = Math.max(width, Math.min(MAX_VALUE_WIDTH, displayWidth(figureWithCurrency(event[key], event.currency) ?? "")));
493
511
  return width;
494
512
  }
495
513
 
@@ -34,6 +34,7 @@ import { displayWidth, truncateToDisplayWidth } from "../../../utils/format";
34
34
  import { useOpenTickerChoice } from "../shared/ticker-choice";
35
35
  import { resolveFredMapping, projectFredHistory, fredHistoryUnits } from "./fred-series-map";
36
36
  import { actualColor, CALENDAR_TIME_ZONE_LABEL, econEventName, timeLabel } from "./calendar-model";
37
+ import { figureWithCurrency } from "./figures";
37
38
  import { hasNoStatedTime, isAllDayEvent, type EconEvent } from "./types";
38
39
 
39
40
  interface EconDetailViewProps {
@@ -228,9 +229,10 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
228
229
  // The stack bar names the event; the detail opens on the release figures,
229
230
  // the outcome first so a short detail keeps it.
230
231
  const releaseItems: StatItem[] = [
231
- ...(event.actual ? [{ id: "actual", label: "Actual", value: event.actual, color: actualColor(event.actual, event.forecast) }] : []),
232
- ...(event.forecast ? [{ id: "forecast", label: "Forecast", value: event.forecast }] : []),
233
- ...(event.prior ? [{ id: "prior", label: "Prior", value: event.prior }] : []),
232
+ // An amount with its currency beside it (-556.5B JPY), where the server says it.
233
+ ...(event.actual ? [{ id: "actual", label: "Actual", value: figureWithCurrency(event.actual, event.currency)!, color: actualColor(event.actual, event.forecast) }] : []),
234
+ ...(event.forecast ? [{ id: "forecast", label: "Forecast", value: figureWithCurrency(event.forecast, event.currency)! }] : []),
235
+ ...(event.prior ? [{ id: "prior", label: "Prior", value: figureWithCurrency(event.prior, event.currency)! }] : []),
234
236
  // The date the prior rate was observed, labelled as Central Bank Rates labels it.
235
237
  ...(event.prior && event.priorAsOf ? [{ id: "priorAsOf", label: "As of", value: event.priorAsOf }] : []),
236
238
  // A bank that states no time has none here, and says so; a publisher's own clock sits under the time.
@@ -40,6 +40,19 @@ export function parseEconFigure(text: string | null | undefined): EconFigure | n
40
40
  return { value: Object.is(value, -0) ? 0 : value, unit: percent ? "%" : word ?? "", scale: 10 ** digits };
41
41
  }
42
42
 
43
+ /**
44
+ * A figure with the currency its amount is in beside it, as the calendar
45
+ * states it: Japan's current account `-556.5B JPY` and its reserves
46
+ * `1178.4B USD`, which both read "B" alone. A percent or a figure in a unit
47
+ * of its own (`3%`, `-4.1M bbl`), a text that is no figure, and a row with no
48
+ * currency (an older server) read as printed.
49
+ */
50
+ export function figureWithCurrency(text: string | null | undefined, currency: string | null | undefined): string | null {
51
+ if (text == null) return null;
52
+ if (!currency || parseEconFigure(text)?.unit !== "") return text;
53
+ return `${text.trim()} ${currency}`;
54
+ }
55
+
43
56
  /** What a row's Actual, Forecast and Prior say in numbers, with the unit they share and the scale the first is drawn in. */
44
57
  export interface EconRowFigures {
45
58
  actual: number | null;
@@ -8,9 +8,9 @@ type FredRow = readonly [seriesId: string, name: string, unit: string, frequency
8
8
  * maturities (UST:2Y and so on, from the yield curve) and the credit spreads
9
9
  * and yields (from the credit plugin). Ids follow the server's allowlist: a
10
10
  * series added there is listed here to reach the catalog.
11
- * Türkiye's CPI, Brazil's IPCA and NAHB's housing market index are served
12
- * the same way but are not on FRED; their rows name TurkStat, IBGE and NAHB
13
- * (`seriesNotOnFred`).
11
+ * Türkiye's CPI, Brazil's IPCA, MAS's SORA and NAHB's housing market index
12
+ * are served the same way but are not on FRED; their rows name TurkStat,
13
+ * IBGE, MAS and NAHB (`seriesNotOnFred`).
14
14
  */
15
15
  const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
16
16
  {
@@ -29,6 +29,7 @@ const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
29
29
  ["T10Y2Y", "10Y minus 2Y Treasury spread", "%", "daily", ["treasury", "curve", "2s10s"]],
30
30
  ["T10Y3M", "10Y minus 3M Treasury spread", "%", "daily", ["treasury", "curve"]],
31
31
  ["SOFR", "SOFR", "%", "daily", ["secured overnight financing rate", "money markets"]],
32
+ ["SORA", "SORA (Singapore overnight rate average)", "%", "daily", ["SGD", "Singapore", "MAS", "overnight", "money markets"]],
32
33
  ["OBFR", "Overnight bank funding rate", "%", "daily", ["OBFR", "money markets"]],
33
34
  ["DTB4WK", "4-week Treasury bill rate", "%", "daily", ["bill", "money markets"]],
34
35
  ["DTB3", "3-month Treasury bill rate", "%", "daily", ["bill", "money markets"]],
@@ -213,6 +214,8 @@ export const FRED_CATALOG_SERIES: readonly SeriesDefinition[] = GROUPS.flatMap((
213
214
  group,
214
215
  ...(tags?.length ? { tags } : {}),
215
216
  publisher: seriesNotOnFred(seriesId)?.publisher ?? "FRED",
217
+ // The licence a publisher's data comes under, which the catalog lists beside the series (SORA's).
218
+ ...(seriesNotOnFred(seriesId)?.attribution ? { limitation: seriesNotOnFred(seriesId)!.attribution } : {}),
216
219
  url: fredSeriesUrl(seriesId),
217
220
  expression: `FRED:${seriesId}`,
218
221
  }))
@@ -66,6 +66,7 @@ import {
66
66
  type EconCalendarLoadResult,
67
67
  type ImpactFilter,
68
68
  } from "./calendar-model";
69
+ import { figureWithCurrency } from "./figures";
69
70
  import { usePaneStatusFooter } from "../../../components/layout/pane/status-footer";
70
71
  import { handleRefreshKey } from "../../../components/data-table/table-pane";
71
72
  import { tableColumnWidth } from "../../../components/ui/table-layout";
@@ -444,15 +445,16 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
444
445
  }
445
446
  case "event":
446
447
  return { text: econEventName(ev), color: colors.text };
448
+ // An amount reads with its currency beside it (-556.5B JPY), where the server says it.
447
449
  case "actual":
448
450
  return {
449
- text: ev.actual ?? "—",
451
+ text: figureWithCurrency(ev.actual, ev.currency) ?? "—",
450
452
  color: actualColor(ev.actual, ev.forecast),
451
453
  };
452
454
  case "forecast":
453
- return { text: ev.forecast ?? "—", color: colors.textDim };
455
+ return { text: figureWithCurrency(ev.forecast, ev.currency) ?? "—", color: colors.textDim };
454
456
  case "prior":
455
- return { text: ev.prior ?? "—", color: colors.textDim };
457
+ return { text: figureWithCurrency(ev.prior, ev.currency) ?? "—", color: colors.textDim };
456
458
  }
457
459
  }, [flagged, readerZone]);
458
460
 
@@ -25,6 +25,11 @@ export interface EconEvent {
25
25
  priorAsOf?: string | null;
26
26
  /** The period a release covers, as its publisher names it. */
27
27
  referencePeriod?: string | null;
28
+ /**
29
+ * The currency the row's amounts are in (`JPY` for Japan's current account, `USD` for its reserves), shown beside
30
+ * them (`figureWithCurrency`); the figures never name it. Absent from an older server, which shows them bare.
31
+ */
32
+ currency?: string | null;
28
33
  /** Who publishes it (Freddie Mac for the 30-year mortgage rate), and its page when one is named. */
29
34
  source?: { name: string; url?: string };
30
35
  /** The indicator this release is of, the same from one release to the next; `id` is this row's alone. */
@@ -0,0 +1,45 @@
1
+ import type { ScreenPayload } from "../../../api-client/equity-screener";
2
+ import type { PaneFooterSegment } from "../../../components";
3
+
4
+ /** `778 matches`, `1 match`: how many listings the screen found, whole, not the page loaded. */
5
+ function screenMatchesText(matched: number): string {
6
+ return `${matched.toLocaleString("en-US")} ${matched === 1 ? "match" : "matches"}`;
7
+ }
8
+
9
+ /**
10
+ * What the footer says of a screen's result: the matches, and the currency
11
+ * that narrowed them (a screen of every currency says none). The covered
12
+ * universe and the snapshot's time are not here: the first is the same for
13
+ * every screen (see the screener's section of docs/usage.md), the second is
14
+ * never more than two hours old and the rows carry live quotes over it.
15
+ */
16
+ export function screenResultInfo(
17
+ data: Pick<ScreenPayload, "definition" | "snapshot" | "universe"> | null,
18
+ ): PaneFooterSegment[] {
19
+ if (!data?.snapshot) return [];
20
+ return [
21
+ { id: "matches", parts: [{ text: screenMatchesText(data.universe.matched) }] },
22
+ ...(data.definition.currency
23
+ ? [{ id: "currency", parts: [{ text: data.definition.currency, tone: "muted" as const }] }]
24
+ : []),
25
+ ];
26
+ }
27
+
28
+ /**
29
+ * Server warnings that describe how far the screener reaches for every screen
30
+ * and every snapshot, not what this screen found. The server bounds the
31
+ * universe it screens (a few thousand listings with recent financials) and
32
+ * says so on each snapshot it assembles; the scope is in the docs and
33
+ * `universe.covered` is its size. A ⚠ that is there on every screen reads as
34
+ * an error and tells nothing.
35
+ */
36
+ const STANDING_NOTICES: readonly RegExp[] = [/^Projection is bounded to /];
37
+
38
+ /**
39
+ * The warnings a screen's ⚠ opens: the server's, less the standing ones.
40
+ * Whatever else the server says (a name lookup that failed for this snapshot)
41
+ * stays, as does any wording this list has not heard of.
42
+ */
43
+ export function screenNotices(warnings: readonly string[] | undefined): string[] {
44
+ return (warnings ?? []).filter((warning) => !STANDING_NOTICES.some((pattern) => pattern.test(warning.trim())));
45
+ }
@@ -62,6 +62,7 @@ import { useQuoteDelayFooter } from "../shared/cloud-upgrade";
62
62
  import { SignInWall } from "../cloud/auth-actions";
63
63
  import { CriterionEditor } from "./criterion-editor";
64
64
  import { ideaMetricSetting, SCREEN_IDEAS, screenIdea } from "./ideas";
65
+ import { screenNotices, screenResultInfo } from "./footer";
65
66
  import { ScreenTickerCheck } from "./ticker-check";
66
67
  import {
67
68
  fetchSavedScreens,
@@ -675,22 +676,7 @@ function EquityScreenView({
675
676
  },
676
677
  ]
677
678
  : []),
678
- ...(data?.snapshot
679
- ? [
680
- {
681
- id: "asof",
682
- parts: [
683
- {
684
- text: `${data.universe.matched.toLocaleString("en-US")} of ${data.universe.covered.toLocaleString("en-US")} covered`,
685
- },
686
- {
687
- text: `· ${data.definition.currency ?? "native currencies"} · snapshot ${data.snapshot.assembledAt.slice(0, 16).replace("T", " ")} UTC`,
688
- tone: "muted" as const,
689
- },
690
- ],
691
- },
692
- ]
693
- : []),
679
+ ...screenResultInfo(data),
694
680
  ...(saving || exporting
695
681
  ? [
696
682
  {
@@ -724,8 +710,8 @@ function EquityScreenView({
724
710
  focused,
725
711
  enabled: !check,
726
712
  notices: [
727
- ...(data?.warnings ?? []),
728
- ...(opened?.warnings ?? []),
713
+ ...screenNotices(data?.warnings),
714
+ ...screenNotices(opened?.warnings),
729
715
  ...[
730
716
  results.error,
731
717
  fields.error,
@@ -18,6 +18,7 @@ import { isAccessDenied } from "../../../api-client/errors";
18
18
  import type { ScreenDefinition } from "../../../api-client/equity-screener";
19
19
  import { useThemeColors } from "../../../theme/theme-context";
20
20
  import { fetchScreenCheck } from "./client";
21
+ import { screenNotices } from "./footer";
21
22
  import { checkRows, screenCheckSummary } from "./screen-check";
22
23
 
23
24
  interface ScreenTickerCheckProps {
@@ -80,7 +81,7 @@ export function ScreenTickerCheck({
80
81
  usePaneNoticeFooter({
81
82
  registrationId: "equity-screener:check-notices",
82
83
  focused,
83
- notices: [...(data?.warnings ?? []), ...(error ? [error] : [])],
84
+ notices: [...screenNotices(data?.warnings), ...(error ? [error] : [])],
84
85
  });
85
86
  const rows = data ? checkRows(data) : [];
86
87
  const columns: DataTableColumn[] = [
@@ -3,6 +3,7 @@ export const FIXED_INCOME_HOSTS = [
3
3
  "services-dynarep.ddwa.finra.org",
4
4
  "api.fiscaldata.treasury.gov",
5
5
  "markets.newyorkfed.org",
6
+ "www.treasurydirect.gov",
6
7
  ] as const;
7
8
 
8
9
  export type FixedIncomeSection = "credit" | "issuer-debt" | "bonds" | "treasury";
@@ -304,7 +304,7 @@ export function renderFuturesCell(
304
304
  case "status":
305
305
  // A contract that trades Globex's whole day reads open from the reopen, not from the first print its feed shows.
306
306
  return renderQuoteBoardCell("status", state?.quote ? { ...state, quote: futuresSessionQuote(contract, state.quote, options?.now) ?? null } : state,
307
- { sessionText: options?.sessionText, formatPrice: (quoted) => formatContractPrice(quoted, contract),
307
+ { sessionText: options?.sessionText, now: options?.now, formatPrice: (quoted) => formatContractPrice(quoted, contract),
308
308
  formatChange: (quoted) => formatContractChange(quoted, contract) });
309
309
  default:
310
310
  return renderQuoteBoardCell(column.id, state, {
@@ -3,7 +3,7 @@ import type { CurvePalette, CurveSeries } from "../../../components/chart/curve/
3
3
  import { spanDigits } from "../../../components/chart-table";
4
4
  import { compositeAxisTicks } from "../../../components/chart/composite/format";
5
5
  import type { CompositeAxisDomain } from "../../../components/chart/composite/types";
6
- import { FUTURES_CONTRACTS, futuresBoardContractForTicker, futuresContractByCode, tickDecimals } from "../../../market-data/futures-board";
6
+ import { CME_CRYPTO_FUTURES, FUTURES_CONTRACTS, futuresBoardContractForTicker, futuresContractByCode, tickDecimals } from "../../../market-data/futures-board";
7
7
  import { futuresContractCode } from "../../../market-data/futures-contract";
8
8
  import { contractMonthLabel } from "../../../utils/contract-month";
9
9
  import { formatPercentileRank } from "../../../utils/format";
@@ -14,15 +14,8 @@ import { zonedDateKey, zonedWallClockToUtcMs } from "../../../utils/zoned-date-t
14
14
  import { dateOptionError, dateOptionFormatsOr, readCalendarDate } from "../../../utils/calendar-date";
15
15
  import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
16
16
 
17
- /**
18
- * CME crypto futures have a curve but no FUT board row, so their name and tick
19
- * live here rather than in the catalogue the board lists. Outright ticks:
20
- * BTC $5, ETH $0.50, SOL $0.05, XRP $0.0005 (each $25 a contract).
21
- */
22
- const CRYPTO_CURVE_ROOTS: readonly { code: string; name: string; tick: number }[] = [
23
- { code: "BTC", name: "Bitcoin", tick: 5 }, { code: "ETH", name: "Ether", tick: 0.5 },
24
- { code: "SOL", name: "Solana", tick: 0.05 }, { code: "XRP", name: "XRP", tick: 0.0005 },
25
- ];
17
+ /** CME crypto futures have a curve but no FUT board row: their name and tick live with the board's. */
18
+ const CRYPTO_CURVE_ROOTS = CME_CRYPTO_FUTURES;
26
19
  const rootLabel = (code: string, name: string) => name === code ? code : `${code} ${name}`;
27
20
 
28
21
  export const CURVE_ROOTS = [
@@ -14,6 +14,7 @@
14
14
  import { useEffect, useRef, type ReactNode } from "react";
15
15
  import { usePlanAccess } from "../../../api-client/plan-access";
16
16
  import { functionDocsUrl, type FunctionFreshness, type FunctionHelpKey } from "../../../cli/pane-functions/function-help";
17
+ import { keyHintWords } from "../../../components/ui/key-hint-words";
17
18
  import { requestFeedbackDialog } from "../../../components/feedback-dialog";
18
19
  import { Button } from "../../../components/ui/button";
19
20
  import { ExternalLink } from "../../../components/ui/external-link";
@@ -78,7 +79,7 @@ function CardRow({ label, children }: { label: string; children: ReactNode }) {
78
79
  function KeysRow({ keys }: { keys: readonly FunctionHelpKey[] }) {
79
80
  return (
80
81
  <Box flexDirection="row" flexWrap="wrap" gap={2}>
81
- {keys.map((hint) => <ShortcutHint key={`${hint.key}${hint.label}`} hotkey={hint.key} label={hint.label} />)}
82
+ {keys.map((hint) => <ShortcutHint key={`${hint.key}${hint.label}`} hotkey={hint.key} label={hint.label} words={keyHintWords(hint)} />)}
82
83
  </Box>
83
84
  );
84
85
  }
@@ -74,6 +74,7 @@ export function buildHelpFunctionIndex(sources: HelpFunctionSources): HelpFuncti
74
74
  aliases,
75
75
  paneId: COMMAND_PANES[command.id],
76
76
  argPlaceholder: command.hasArg ? command.argPlaceholder : undefined,
77
+ ...(command.listed === false ? { unlisted: true as const } : {}),
77
78
  }));
78
79
  }
79
80
  for (const command of sources.pluginCommands) {
@@ -25,10 +25,18 @@ function throwIfAborted(signal: AbortSignal | undefined): void {
25
25
  }
26
26
 
27
27
  /**
28
- * Reads the company's Form 4 filings newest first, one at a time, until
29
- * `limit` of them are its own. A form it filed as an owner of another
30
- * company's shares is read and left out, so a list of only those is read to
31
- * the end before it can say there are none.
28
+ * Form 4 documents read at once: a list is read in a few round trips, not one
29
+ * per filing, and never more than the service reads from the SEC at once.
30
+ */
31
+ const CONTENT_READS_AT_ONCE = 4;
32
+
33
+ /**
34
+ * Reads the company's Form 4 filings newest first until `limit` of them are
35
+ * its own, up to four documents at a time ahead of the one being looked at
36
+ * and never more than are still wanted (one at a time, `insider OXY` took
37
+ * 6-8 s for its 20). A form it filed as an
38
+ * owner of another company's shares is read and left out, so a list of only
39
+ * those is read to the end before it can say there are none.
32
40
  */
33
41
  export async function loadParsedInsiderFilings(
34
42
  provider: DataProvider,
@@ -37,25 +45,34 @@ export async function loadParsedInsiderFilings(
37
45
  ): Promise<InsiderFilingsLoad> {
38
46
  if (!provider.getSecFilings) throw new Error("Insider filing data unavailable");
39
47
  if (!provider.getSecFilingContent) throw new Error("Insider filing content unavailable");
48
+ const readContent = provider.getSecFilingContent.bind(provider);
40
49
  const filings = await provider.getSecFilings(symbol, SEC_FILING_SCAN_LIMIT, options.exchange ?? "");
50
+ const forms = filings.filter((filing) => isInsiderForm(filing.form));
51
+ const reads: Array<Promise<{ content: string | null } | null>> = [];
52
+ const read = (index: number) => reads[index] ??= readContent(forms[index]!).then(
53
+ (content) => ({ content }),
54
+ () => {
55
+ // Intentional ignore: an unread filing may be the company's own, so it stays as a row that says it was not read.
56
+ return null;
57
+ },
58
+ );
41
59
 
42
60
  const parsed: ParsedInsiderFiling[] = [];
43
61
  let own = 0;
44
- for (const filing of filings) {
45
- if (own >= options.limit) break;
46
- if (!isInsiderForm(filing.form)) continue;
62
+ for (let index = 0; index < forms.length && own < options.limit; index += 1) {
63
+ throwIfAborted(options.signal);
64
+ // Never more in flight than filings still wanted: each read is at most one of them.
65
+ const window = Math.min(CONTENT_READS_AT_ONCE, options.limit - own);
66
+ for (let ahead = index; ahead < Math.min(forms.length, index + window); ahead += 1) read(ahead);
67
+ const filing = forms[index]!;
68
+ const result = await read(index);
47
69
  throwIfAborted(options.signal);
48
- let content: string | null;
49
- try {
50
- content = await provider.getSecFilingContent(filing);
51
- } catch {
52
- throwIfAborted(options.signal);
53
- // An unread filing may be the company's own; it stays as a row that says so.
70
+ if (!result) {
54
71
  parsed.push({ filing, transaction: null, isLoading: false });
55
72
  own += 1;
56
73
  continue;
57
74
  }
58
- const entries = parseInsiderFiling(filing, content);
75
+ const entries = parseInsiderFiling(filing, result.content);
59
76
  if (entries.length === 0) continue;
60
77
  parsed.push(...entries);
61
78
  own += 1;
@@ -13,6 +13,7 @@ import { formatShortDate } from "../../../utils/datetime-format";
13
13
  import { displayWidth, formatCompact } from "../../../utils/format";
14
14
  import type { SortComparableValue } from "../../../utils/sort-values";
15
15
  import { formatInsiderName } from "./display";
16
+ import { MARKET_CAP_BAND_OPTIONS } from "../shared/market-cap-bands";
16
17
  import { DEFAULT_INSIDER_SIGNAL_WINDOW, DEFAULT_INSIDER_SIGNALS_QUERY, INSIDER_SIGNAL_WINDOWS, type InsiderSignalsQuery } from "./signals-client";
17
18
 
18
19
  export type InsiderSignalColumnId =
@@ -56,13 +57,7 @@ export const INSIDER_SIGNAL_MIN_OPTIONS: SelectButtonOption[] = [
56
57
  { value: "10000000", label: "$10M+" },
57
58
  ];
58
59
 
59
- export const INSIDER_SIGNAL_CAP_OPTIONS: SelectButtonOption<InsiderSignalCap | "all">[] = [
60
- { value: "all", label: "All" },
61
- { value: "micro", label: "Micro", description: "Under $300M" },
62
- { value: "small", label: "Small", description: "$300M to $2B" },
63
- { value: "mid", label: "Mid", description: "$2B to $10B" },
64
- { value: "large", label: "Large", description: "Over $10B" },
65
- ];
60
+ export const INSIDER_SIGNAL_CAP_OPTIONS: SelectButtonOption<InsiderSignalCap | "all">[] = MARKET_CAP_BAND_OPTIONS;
66
61
 
67
62
  /** The words a side changes: the column headers, the position filter, the empty and coverage lines. */
68
63
  export interface InsiderSideWords {
@@ -202,9 +202,8 @@ export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
202
202
  ...(dates.reading ? [] : [{ key: "date", header: "As of", format: (value: unknown, row?: unknown) =>
203
203
  typeof value === "string" ? readingLabel(value, (row as RichCheapRow).method, false,
204
204
  { basis: (row as RichCheapRow).basis, stale: (row as RichCheapRow).stale }) : "--" }]),
205
- // The underlying price each reading was taken at, on the date the title or the As of column gives.
205
+ // The underlying's price on the row's own date, the title's or the As of column's; blank when no capture of it is that day's.
206
206
  { key: "spot", header: "Spot", format: (value: unknown) => typeof value === "number" ? formatSpot(value) : "--" },
207
- ...(dates.rankApart ? [{ key: "rankDate", header: "Rank as of", format: (value: unknown) => typeof value === "string" ? `${value} close` : "--" }] : []),
208
207
  { key: "rank", header: "IVR", format: (value: unknown) => formatRank(value as number | null) },
209
208
  { key: "percentile", header: "IVP", format: (value: unknown) => formatRank(value as number | null) },
210
209
  { key: "verdict", header: "Rich/Cheap", format: (value: unknown) => verdictLabel(value as never) },
@@ -46,8 +46,8 @@ function newestSession(...dates: ReadonlyArray<string | null | undefined>): stri
46
46
  return dates.filter((date): date is string => !!date).map((date) => date.slice(0, 10)).sort().at(-1) ?? null;
47
47
  }
48
48
 
49
- /** How many sessions a reading is behind the newest, and whether that makes it stale. */
50
- function staleness(date: string | null | undefined, newest: string | null): { sessionsBehind: number | null; stale: boolean } {
49
+ /** How many sessions a reading is behind the newest, and whether that makes it stale (over `STALE_AFTER_SESSIONS`). */
50
+ export function staleness(date: string | null | undefined, newest: string | null): { sessionsBehind: number | null; stale: boolean } {
51
51
  const behind = date && newest ? sessionsBehind(date.slice(0, 10), newest) : null;
52
52
  return { sessionsBehind: behind, stale: behind != null && behind > STALE_AFTER_SESSIONS };
53
53
  }
@@ -356,14 +356,14 @@ export interface RichCheapRow {
356
356
  stale: boolean;
357
357
  /** Sessions between the reading and the symbol's newest session. */
358
358
  sessionsBehind: number | null;
359
- /** The underlying price the reading was taken at: the session's close, or the spot at the quote capture. */
359
+ /** The underlying's price at the newest reading: the session's close, or the spot at the quote capture. */
360
360
  spot: number | null;
361
361
  rank: number | null;
362
362
  percentile: number | null;
363
- /** Trade close the rank is measured on: the newest trade-close session, which a newer quote reading can be ahead of. */
363
+ /** Trade close the rank is measured on: the session of the IV30 shown, which IVR, IVP and the verdict are read from with it. */
364
364
  rankDate: string | null;
365
365
  termSlope: number | null;
366
- /** The latest reading's one-year IV, dated with IV30. */
366
+ /** The one-year IV of the IV30's own session. */
367
367
  iv1y: number | null;
368
368
  /**
369
369
  * IV1Y percentile on the close IVR and IVP are ranked on. Empty when the 1Y
@@ -388,16 +388,15 @@ export interface RichCheapRow {
388
388
 
389
389
  /**
390
390
  * The dates the screened rows agree on, so each is said once instead of per
391
- * row. The reading (IV30, term slope, IV/HV) and the rank (IVR, IVP) are dated
392
- * apart: a quote reading can be a session ahead of the trade close its rank
393
- * is measured on. A group the rows disagree on gets its own column.
391
+ * row. The reading (IV30, term slope, IV/HV) and the rank (IVR, IVP) are one
392
+ * ranked close where a symbol has one, so a rank is dated as its row is; an
393
+ * unranked reading is dated alone. A group the rows disagree on gets its own
394
+ * column.
394
395
  */
395
396
  export interface RichCheapDates {
396
397
  reading: { date: string; method: IvMethod; basis: IvCloseBasis | null } | null;
397
398
  /** The trade close every ranked row is ranked on. */
398
399
  rank: string | null;
399
- /** Ranked rows are ranked on different closes. */
400
- rankApart: boolean;
401
400
  /** Some risk reversal comes from a different session than its row's reading. */
402
401
  skewApart: boolean;
403
402
  /** Some HV is dated on a different session than the IV it sits beside. */
@@ -413,7 +412,6 @@ export function richCheapDates(rows: readonly RichCheapRow[]): RichCheapDates {
413
412
  reading: first && read.every((row) => row.date === first.date && readingSource(row.method, row.basis) === readingSource(first.method, first.basis) && !row.stale)
414
413
  ? { date: first.date!, method: first.method!, basis: first.basis } : null,
415
414
  rank: firstRanked && ranked.every((row) => row.rankDate === firstRanked.rankDate) ? firstRanked.rankDate : null,
416
- rankApart: !!firstRanked && ranked.some((row) => row.rankDate !== firstRanked.rankDate),
417
415
  skewApart: rows.some((row) => row.riskReversal != null && row.skewDate !== row.date),
418
416
  hvApart: rows.some((row) => row.hv != null && row.hvDate != null && row.hvDate !== row.date),
419
417
  };
@@ -428,28 +426,40 @@ export function verdictFor(percentile: number | null): RichCheap {
428
426
  export function projectRichCheap(rows: readonly IvScreenRow[], hv: ReadonlyMap<string, ScreenHv | null> = new Map()): RichCheapRow[] {
429
427
  return rows.map((row) => {
430
428
  const latest = row.latest;
431
- const iv30 = latest?.iv30 ?? null;
432
429
  const series = hv.get(row.symbol) ?? null;
430
+ // One dated row: IV30, its rank and the verdict all come from the ranked close when there is one,
431
+ // never a newer reading's IV30 beside an older close's rank, nor a rank beside a reading with no IV30.
432
+ const ranked = row.iv30 && Number.isFinite(row.iv30.value) && row.iv30.date ? row.iv30 : null;
433
+ const reading = ranked ? { iv30: ranked.value, date: ranked.date, method: ranked.method, basis: ranked.basis ?? null }
434
+ : latest ? { iv30: latest.iv30, date: latest.date, method: latest.method, basis: latest.basis ?? null } : null;
435
+ const iv30 = reading?.iv30 ?? null;
436
+ const date = reading?.date ?? null;
437
+ // A figure of the reading itself: the series ranked on its session, else the newest reading's when it is that reading.
438
+ const sameSession = (fromLatest: number | null | undefined, stats: IvStats | null | undefined) =>
439
+ date == null ? null : stats?.date === date && Number.isFinite(stats.value) ? stats.value
440
+ : latest?.date === date && latest.method === reading?.method ? fromLatest ?? null : null;
433
441
  // The newest session the symbol reaches: its prices, its backfill and every reading it has.
434
442
  const newest = newestSession(row.coverage?.backfilledThrough, latest?.date, row.iv30?.date, row.iv90?.date, row.iv365?.date,
435
443
  row.skew?.date, series?.date);
436
- const { stale, sessionsBehind: behind } = staleness(latest?.date, newest);
437
- // A rank on a close that old ranks an old figure; so does a skew.
438
- const rankStale = stale || staleness(row.iv30?.date, newest).stale;
444
+ const { stale, sessionsBehind: behind } = staleness(date, newest);
439
445
  const skewStale = row.skew ? staleness(row.skew.date, newest).stale : false;
440
- const percentile = rankStale ? null : row.iv30?.percentile ?? null;
446
+ const rankedNow = !stale && ranked != null && iv30 != null;
447
+ const percentile = rankedNow ? ranked.percentile ?? null : null;
441
448
  // HV on the reading's own date: today's HV beside an old IV says nothing about it.
442
- const atReading = series && !stale && latest?.date ? hvOn(series, latest.date) : null;
449
+ const atReading = series && !stale && date ? hvOn(series, date) : null;
443
450
  const shown = atReading ?? (series?.value != null && series.date ? { date: series.date, value: series.value } : null);
451
+ const iv90 = sameSession(latest?.iv90, row.iv90);
452
+ const iv1y = sameSession(latest?.iv365, row.iv365);
444
453
  return {
445
454
  symbol: row.symbol, status: row.coverageStatus ?? row.status, queuedAt: row.coverage?.addedAt ?? null,
446
455
  backfilledThrough: row.coverage?.backfilledThrough ?? null, warning: row.warnings?.[0] ?? null,
447
- iv30, date: latest?.date ?? null, method: latest?.method ?? null, basis: latest?.basis ?? null,
448
- stale, sessionsBehind: behind, spot: latest?.spot ?? null,
449
- rank: rankStale ? null : row.iv30?.rank ?? null, percentile, rankDate: rankStale ? null : row.iv30?.date ?? null,
450
- termSlope: iv30 != null && latest?.iv90 != null ? iv30 - latest.iv90 : null,
451
- iv1y: latest?.iv365 ?? null,
452
- iv1yPercentile: !rankStale && latest?.iv365 != null && row.iv365 && row.iv365.date === row.iv30?.date ? row.iv365.percentile : null,
456
+ iv30, date, method: reading?.method ?? null, basis: reading?.basis ?? null,
457
+ // The underlying's price on the row's own date: the newest capture's when it is of that session, else none.
458
+ stale, sessionsBehind: behind, spot: latest && date != null && latest.date === date ? latest.spot ?? null : null,
459
+ rank: rankedNow ? ranked.rank ?? null : null, percentile, rankDate: rankedNow ? ranked.date : null,
460
+ termSlope: iv30 != null && iv90 != null ? iv30 - iv90 : null,
461
+ iv1y,
462
+ iv1yPercentile: rankedNow && iv1y != null && row.iv365?.date === date ? row.iv365.percentile : null,
453
463
  riskReversal: skewStale || !row.skew ? null : row.skew.call25 - row.skew.put25, skewDate: skewStale ? null : row.skew?.date ?? null,
454
464
  hv: shown?.value ?? null, hvDate: shown?.date ?? null,
455
465
  ivHv: iv30 != null && atReading != null && atReading.value > 0 ? iv30 / atReading.value : null,
@@ -24,7 +24,6 @@ const COLUMNS: DataTableColumn[] = [
24
24
  { id: "iv30", label: "IV30", width: 7, align: "right" },
25
25
  { id: "date", label: "As of", width: 11, align: "right" },
26
26
  { id: "spot", label: "Spot", width: 9, align: "right" },
27
- { id: "rankDate", label: "Rank as of", width: 11, align: "right" },
28
27
  { id: "rank", label: "IVR", width: 5, align: "right" },
29
28
  { id: "percentile", label: "IVP", width: 5, align: "right" },
30
29
  { id: "verdict", label: "Rich/Cheap", width: 11, align: "left" },
@@ -90,7 +89,6 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
90
89
  const columns = useMemo(() => COLUMNS.filter((column) => {
91
90
  switch (column.id) {
92
91
  case "date": return !dates.reading;
93
- case "rankDate": return dates.rankApart;
94
92
  case "iv1y": return rows.some((row) => row.iv1y != null);
95
93
  case "iv1yPercentile": return rows.some((row) => row.iv1yPercentile != null);
96
94
  case "riskReversal": return hasSkew;
@@ -126,7 +124,6 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
126
124
  case "spot": return { text: formatSpot(row.spot), color: colors.textDim };
127
125
  case "date": return { text: row.date ? readingLabel(row.date, row.method, true, { basis: row.basis, stale: row.stale })
128
126
  : row.status === "queued" || row.status === "backfilling" ? row.status : "--", color: row.stale ? colors.warning : colors.textDim };
129
- case "rankDate": return { text: row.rankDate ? `${shortDate(row.rankDate)} close` : "--", color: colors.textDim };
130
127
  case "rank": return { text: formatRank(row.rank) };
131
128
  case "percentile": return { text: formatRank(row.percentile) };
132
129
  case "verdict": return { text: verdictLabel(row.verdict), color: row.verdict === "rich" ? colors.negative : row.verdict === "cheap" ? colors.positive : colors.textDim };