gloomberb 0.20.7 → 0.20.8

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 (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -1,7 +1,7 @@
1
1
  import { getPublishedUsEquityCalendarDay } from "../../../market-data/published-us-sessions";
2
2
  import type { PricePoint } from "../../../types/financials";
3
3
  import { rollingRealizedVolatility } from "../shared/volatility";
4
- import type { IvCloseBasis, IvCoverageStatus, IvHistoryPayload, IvMethod, IvPoint, IvScreenRow, IvStats, ScreenHv } from "./client";
4
+ import type { IvCloseBasis, IvCoverageStatus, IvHistoryPayload, IvMethod, IvPoint, IvRiskReversalStats, IvScreenRow, IvStats, ScreenHv } from "./client";
5
5
 
6
6
  /**
7
7
  * A history's warnings in words for the reader. A symbol demand coverage could
@@ -166,15 +166,18 @@ export interface IvHistoryModel {
166
166
  hv: DatedValue[];
167
167
  spread: DatedValue[];
168
168
  /**
169
- * Each session's 30-day 25-delta put IV minus call IV from its quote
170
- * capture (put-call: positive means puts are richer). The risk reversal,
171
- * call minus put, is its negative.
169
+ * Each session's 30-day 25-delta put IV minus call IV (put-call: positive
170
+ * means puts are richer), from its close where the close carries the wings,
171
+ * else from its quote capture. The risk reversal, call minus put, is its
172
+ * negative.
172
173
  */
173
174
  skew: DatedValue[];
174
175
  /** First session with a stored skew; skew is blank before it. */
175
176
  skewSince: string | null;
176
177
  /** "skew from 2026-09-23", or why there is no skew at all. */
177
178
  skewNote: string | null;
179
+ /** How many sessions the risk reversal's percentile rests on, until they reach back a year. */
180
+ riskReversalNote: string | null;
178
181
  stats: IvStatRow[];
179
182
  /** Which measures are stale and what that leaves out, when any is. */
180
183
  staleNote: string | null;
@@ -228,13 +231,20 @@ function byMethod(series: readonly IvPoint[], method: IvMethod, field: "iv30" |
228
231
  }
229
232
 
230
233
  /**
231
- * 25-delta skew per session, put minus call, from the quote captures: the
232
- * only readings that store the wings. A server that sends no wing fields at
233
- * all predates them, which is not the same as a symbol with no capture yet.
234
+ * 25-delta skew per session, put minus call: the close's wings where the close
235
+ * carries them, as the session's IV30 is the close's, else the quote
236
+ * capture's, so a session the capture missed still has its skew. A server
237
+ * that sends no wing fields at all predates them, which is not the same as a
238
+ * symbol with no capture yet.
234
239
  */
235
240
  function skewSeries(series: readonly IvPoint[]): { points: DatedValue[]; note: string | null } {
236
- const points = series.filter((point) => point.method === "quote-mid" && point.put25_30 != null && point.call25_30 != null)
237
- .map((point) => ({ date: utc(point.sessionDate), value: point.put25_30! - point.call25_30! }))
241
+ const bySession = new Map<string, IvPoint>();
242
+ for (const point of series) {
243
+ if (point.put25_30 == null || point.call25_30 == null) continue;
244
+ const held = bySession.get(point.sessionDate);
245
+ if (!held || (held.method === "quote-mid" && point.method === "trade-close")) bySession.set(point.sessionDate, point);
246
+ }
247
+ const points = [...bySession.values()].map((point) => ({ date: utc(point.sessionDate), value: point.put25_30! - point.call25_30! }))
238
248
  .sort((a, b) => a.date.getTime() - b.date.getTime());
239
249
  if (points[0]) return { points, note: `skew from ${day(points[0].date)}` };
240
250
  if (!series.length) return { points, note: null };
@@ -291,6 +301,7 @@ export function projectIvHistory(
291
301
  ? { id: "iv365", label: "IV 1Y ATM", unit: "vol", value: latest.iv365, date: latest.date, method: latest.method, basis: latest.basis ?? null,
292
302
  low: null, high: null, rank: null, percentile: null, samples: 0, stale: false, sessionsBehind: null }
293
303
  : fromServer("iv365", "IV 1Y ATM", oneYear),
304
+ ...(payload.stats.rr25 ? [riskReversalRow(payload.stats.rr25)] : []),
294
305
  seriesStat("hv", `HV ${window}`, "vol", rolling, "prices"),
295
306
  seriesStat("spread", `IV 30d - HV ${window}`, "points", spreadAll, "trade-close"),
296
307
  seriesStat("term", "IV 30d / 90d", "ratio", termAll, "trade-close"));
@@ -322,8 +333,10 @@ export function projectIvHistory(
322
333
  : oneYear?.percentile == null ? `IV1Y from ${oneYearSince}, ${tradeIv365.length} session${tradeIv365.length === 1 ? "" : "s"}`
323
334
  : since && oneYearSince > since ? `IV1Y from ${oneYearSince}` : null;
324
335
 
336
+ const riskReversal = measured.find((row) => row.id === "rr25");
325
337
  return {
326
338
  symbol: payload.symbol, status: payload.status,
339
+ riskReversalNote: riskReversal && !riskReversal.stale ? riskReversalSessionsNote(payload.stats.rr25) : null,
327
340
  iv30: visible(tradeIv30), iv90: visible(byMethod(payload.series, "trade-close", "iv90")), iv365: visible(tradeIv365),
328
341
  quoteIv30: visible(byMethod(payload.series, "quote-mid", "iv30")),
329
342
  hv, spread: visible(spreadAll), skew: visible(skew.points),
@@ -332,6 +345,26 @@ export function projectIvHistory(
332
345
  };
333
346
  }
334
347
 
348
+ /** HIVG's statistics row for the 30-day 25-delta risk reversal, ranked by the server against its own year. */
349
+ function riskReversalRow(stats: IvRiskReversalStats): IvStatRow {
350
+ return { id: "rr25", label: "25D RR call-put", unit: "points", value: stats.value, date: stats.date, method: stats.method,
351
+ basis: stats.basis ?? null, low: stats.low, high: stats.high, rank: stats.rank, percentile: stats.percentile,
352
+ samples: stats.samples, stale: false, sessionsBehind: null };
353
+ }
354
+
355
+ /**
356
+ * "25D RR percentile rests on 33 sessions from 2026-09-23; a year is about 250."
357
+ * Said while the risk reversal's history is short of a year, so its percentile
358
+ * is read for what it is; "25D RR percentile needs 20 sessions; 12 so far" below
359
+ * the minimum. Null once a year is in, or with no risk reversal.
360
+ */
361
+ export function riskReversalSessionsNote(stats: IvRiskReversalStats | null | undefined): string | null {
362
+ if (!stats || stats.fullYear) return null;
363
+ if (stats.percentile == null) return `25D RR percentile needs ${stats.minSamples} prior sessions; ${stats.samples} so far.`;
364
+ return `25D RR percentile rests on ${stats.samples} session${stats.samples === 1 ? "" : "s"}${
365
+ stats.windowStart ? ` from ${stats.windowStart}` : ""}; a year is about 250.`;
366
+ }
367
+
335
368
  export type RichCheap = "rich" | "cheap" | "fair" | null;
336
369
  export interface RichCheapRow {
337
370
  symbol: string;
@@ -372,8 +405,16 @@ export interface RichCheapRow {
372
405
  iv1yPercentile: number | null;
373
406
  /** The 25-delta risk reversal at 30 days: call IV minus put IV, so positive means calls are richer, as OVDV signs it. */
374
407
  riskReversal: number | null;
375
- /** Session of the quote capture the risk reversal comes from. */
408
+ /** Session of the reading the risk reversal comes from. */
376
409
  skewDate: string | null;
410
+ /** How the risk reversal was read: the session's close, or the quote capture an older server gives alone. */
411
+ skewMethod: IvMethod | null;
412
+ /** Where the risk reversal sits in its own prior 52 weeks, 0 to 100, from the server. */
413
+ riskReversalPercentile: number | null;
414
+ /** Prior sessions that percentile rests on, and whether they reach back a year. */
415
+ riskReversalSamples: number;
416
+ riskReversalFullYear: boolean;
417
+ riskReversalSince: string | null;
377
418
  /**
378
419
  * Realized volatility on the reading's own date, so the row reads as IV30 over HV;
379
420
  * the newest HV for a stale reading or one with no HV on its date.
@@ -440,9 +481,13 @@ export function projectRichCheap(rows: readonly IvScreenRow[], hv: ReadonlyMap<s
440
481
  : latest?.date === date && latest.method === reading?.method ? fromLatest ?? null : null;
441
482
  // The newest session the symbol reaches: its prices, its backfill and every reading it has.
442
483
  const newest = newestSession(row.coverage?.backfilledThrough, latest?.date, row.iv30?.date, row.iv90?.date, row.iv365?.date,
443
- row.skew?.date, series?.date);
484
+ row.skew?.date, row.rr25?.date, series?.date);
444
485
  const { stale, sessionsBehind: behind } = staleness(date, newest);
445
- const skewStale = row.skew ? staleness(row.skew.date, newest).stale : false;
486
+ // The risk reversal of the ranked close, with its percentile, where the server gives it; else the quote capture's alone.
487
+ const rr = row.rr25 ?? null;
488
+ const skew = rr ? { date: rr.date, value: rr.value, method: rr.method }
489
+ : row.skew ? { date: row.skew.date, value: row.skew.call25 - row.skew.put25, method: "quote-mid" as const } : null;
490
+ const skewStale = skew ? staleness(skew.date, newest).stale : false;
446
491
  const rankedNow = !stale && ranked != null && iv30 != null;
447
492
  const percentile = rankedNow ? ranked.percentile ?? null : null;
448
493
  // HV on the reading's own date: today's HV beside an old IV says nothing about it.
@@ -454,13 +499,21 @@ export function projectRichCheap(rows: readonly IvScreenRow[], hv: ReadonlyMap<s
454
499
  symbol: row.symbol, status: row.coverageStatus ?? row.status, queuedAt: row.coverage?.addedAt ?? null,
455
500
  backfilledThrough: row.coverage?.backfilledThrough ?? null, warning: row.warnings?.[0] ?? null,
456
501
  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,
502
+ // The underlying's price at the reading the row shows: a close's session close, as the server gives it with
503
+ // the rank or, from an older server, the session's daily close; else the newest reading's when it is that
504
+ // very reading. Never a 15:40 capture's beside a close.
505
+ stale, sessionsBehind: behind,
506
+ spot: ranked?.spot ?? (reading?.method === "trade-close" && date ? series?.closes?.get(date) : undefined)
507
+ ?? (latest && date != null && latest.date === date && latest.method === reading?.method ? latest.spot ?? null : null),
459
508
  rank: rankedNow ? ranked.rank ?? null : null, percentile, rankDate: rankedNow ? ranked.date : null,
460
509
  termSlope: iv30 != null && iv90 != null ? iv30 - iv90 : null,
461
510
  iv1y,
462
511
  iv1yPercentile: rankedNow && iv1y != null && row.iv365?.date === date ? row.iv365.percentile : null,
463
- riskReversal: skewStale || !row.skew ? null : row.skew.call25 - row.skew.put25, skewDate: skewStale ? null : row.skew?.date ?? null,
512
+ riskReversal: skewStale || !skew ? null : skew.value, skewDate: skewStale ? null : skew?.date ?? null,
513
+ skewMethod: skewStale ? null : skew?.method ?? null,
514
+ riskReversalPercentile: skewStale || !rr ? null : rr.percentile,
515
+ riskReversalSamples: skewStale || !rr ? 0 : rr.samples, riskReversalFullYear: !skewStale && !!rr?.fullYear,
516
+ riskReversalSince: skewStale ? null : rr?.windowStart ?? null,
464
517
  hv: shown?.value ?? null, hvDate: shown?.date ?? null,
465
518
  ivHv: iv30 != null && atReading != null && atReading.value > 0 ? iv30 / atReading.value : null,
466
519
  verdict: verdictFor(percentile),
@@ -520,6 +573,22 @@ export function screenStaleNote(rows: readonly RichCheapRow[]): string | null {
520
573
  return staleReadingsNote("IV/HV, rank and Rich/Cheap", rows.flatMap((row) => row.stale && row.date ? [{ label: row.symbol, date: row.date }] : []));
521
574
  }
522
575
 
576
+ /**
577
+ * How many sessions the screen's risk reversal percentiles rest on while they
578
+ * are short of a year, said once when the rows agree: "25D RR pctl rests on 33
579
+ * sessions from 2026-09-23; a year is about 250." Rows that differ are listed
580
+ * ("SPY 33, TSLA 12"). Null once every percentile rests on a year.
581
+ */
582
+ export function screenRiskReversalNote(rows: readonly RichCheapRow[]): string | null {
583
+ const short = rows.filter((row) => row.riskReversalPercentile != null && !row.riskReversalFullYear);
584
+ if (!short.length) return null;
585
+ const first = short[0]!;
586
+ const same = short.every((row) => row.riskReversalSamples === first.riskReversalSamples && row.riskReversalSince === first.riskReversalSince);
587
+ const counted = same ? `${first.riskReversalSamples} sessions${first.riskReversalSince ? ` from ${first.riskReversalSince}` : ""}`
588
+ : `fewer sessions than a year (${short.map((row) => `${row.symbol} ${row.riskReversalSamples}`).join(", ")})`;
589
+ return `25D RR pctl rests on ${counted}; a year is about 250.`;
590
+ }
591
+
523
592
  /**
524
593
  * The VCA pane's notices: the report's wording without a time to come back
525
594
  * at, since the pane checks again by itself, and a count of ready symbols with
@@ -529,7 +598,7 @@ export function screenPaneNotices(rows: readonly RichCheapRow[], now = Date.now(
529
598
  const empty = rows.filter((row) => row.status === "ready" && row.iv30 == null).length;
530
599
  return [...screenCoverage(rows, { now, retry: false }).notes,
531
600
  ...(empty ? [`${empty} symbol${empty === 1 ? " has" : "s have"} no stored implied volatility yet.`] : []),
532
- ...[screenStaleNote(rows)].filter((note): note is string => !!note)];
601
+ ...[screenStaleNote(rows), screenRiskReversalNote(rows)].filter((note): note is string => !!note)];
533
602
  }
534
603
 
535
604
  export const VCA_PRESETS = {
@@ -66,7 +66,7 @@ export function IvHistoryPane({ width, height, focused }: PaneProps) {
66
66
  // A queued symbol backfills within minutes; check back while it does.
67
67
  useEffect(() => {
68
68
  if (!model || model.status === "ready" || model.status === "unavailable") return;
69
- const timer = setTimeout(() => { void resource.reload(); }, 60_000);
69
+ const timer = setTimeout(() => { resource.reload(); }, 60_000);
70
70
  return () => clearTimeout(timer);
71
71
  }, [model?.status, resource.updatedAt]);
72
72
  const notices = [identityError, resource.error, resource.data?.prices.error, ...(model?.warnings ?? []), model?.staleNote]
@@ -77,7 +77,7 @@ export function IvHistoryPane({ width, height, focused }: PaneProps) {
77
77
  const openSurface = () => { if (symbol) createPaneFromTemplate("vol-surface-pane", { symbol, ticker, instrument: instrument?.instrument }); };
78
78
  // These answer in every state, including while the history backfills and
79
79
  // no table is on screen; the footer hints bind their own keys.
80
- usePaneRefreshKey(() => void resource.reload(), { focused });
80
+ usePaneRefreshKey(() => resource.reload(), { focused });
81
81
  useShortcut((event) => {
82
82
  if (event.defaultPrevented) return;
83
83
  if (isPlainKey(event, "y")) cycleLookback();
@@ -15,7 +15,7 @@ import { vcaUniverse } from "./universe";
15
15
  import { MovedTickerState } from "../../../components/layout/pane/ticker-fate-gate";
16
16
  import type { MovedTickerChange } from "../../../tickers/ticker-changes";
17
17
 
18
- type SortId = Exclude<keyof RichCheapRow, "stale">;
18
+ type SortId = Exclude<keyof RichCheapRow, "stale" | "riskReversalFullYear">;
19
19
  const HV_WINDOW = 20;
20
20
  /** Pane borders and the footer's own padding. */
21
21
  const FOOTER_MARGIN = 6;
@@ -31,6 +31,7 @@ const COLUMNS: DataTableColumn[] = [
31
31
  { id: "iv1yPercentile", label: "IVP1Y", width: 6, align: "right" },
32
32
  { id: "termSlope", label: "30-90", width: 7, align: "right" },
33
33
  { id: "riskReversal", label: "25D RR", width: 9, align: "right" },
34
+ { id: "riskReversalPercentile", label: "RR pctl", width: 8, align: "right" },
34
35
  { id: "skewDate", label: "RR as of", width: 11, align: "right" },
35
36
  { id: "hv", label: `HV${HV_WINDOW}`, width: 7, align: "right" },
36
37
  { id: "hvDate", label: "HV as of", width: 9, align: "right" },
@@ -92,6 +93,7 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
92
93
  case "iv1y": return rows.some((row) => row.iv1y != null);
93
94
  case "iv1yPercentile": return rows.some((row) => row.iv1yPercentile != null);
94
95
  case "riskReversal": return hasSkew;
96
+ case "riskReversalPercentile": return rows.some((row) => row.riskReversalPercentile != null);
95
97
  case "skewDate": return dates.skewApart;
96
98
  case "hvDate": return dates.hvApart;
97
99
  default: return true;
@@ -114,7 +116,7 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
114
116
  ] }), [resource.loading, datesText]);
115
117
  const handleKey = (event: DataTableKeyEvent): boolean => {
116
118
  if (event.ctrl || event.alt || event.meta || event.name !== "r") return false;
117
- void resource.reload();
119
+ resource.reload();
118
120
  event.preventDefault?.(); event.stopPropagation?.(); return true;
119
121
  };
120
122
  const cell = (row: RichCheapRow, id: string): { text: string; color?: string } => {
@@ -131,7 +133,8 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
131
133
  case "iv1yPercentile": return { text: formatRank(row.iv1yPercentile) };
132
134
  case "termSlope": return { text: formatPoints(row.termSlope), color: row.termSlope != null && row.termSlope > 0 ? colors.negative : colors.text };
133
135
  case "riskReversal": return { text: formatPoints(row.riskReversal) };
134
- case "skewDate": return { text: row.skewDate ? readingLabel(row.skewDate, "quote-mid", true) : "--", color: colors.textDim };
136
+ case "riskReversalPercentile": return { text: formatRank(row.riskReversalPercentile) };
137
+ case "skewDate": return { text: row.skewDate ? readingLabel(row.skewDate, row.skewMethod, true) : "--", color: colors.textDim };
135
138
  case "hv": return { text: hv.has(row.symbol) ? formatVol(row.hv) : "...", color: colors.positive };
136
139
  case "hvDate": return { text: row.hvDate ? shortDate(row.hvDate) : "--", color: colors.textDim };
137
140
  case "ivHv": return { text: row.ivHv == null ? "--" : row.ivHv.toFixed(2) };
@@ -536,7 +536,7 @@ function CompanyPanel({
536
536
  [symbol, companyName],
537
537
  );
538
538
  const resource = useAsyncResource<JobsCompanyState>(request);
539
- const { data, status, error, loading, reload } = resource;
539
+ const { data, status, error, loading, reload, reloadAndWait } = resource;
540
540
 
541
541
  // `r` asks again in every state, including a failed or uncovered company.
542
542
  usePaneRefreshKey(reload, { focused });
@@ -558,7 +558,7 @@ function CompanyPanel({
558
558
  // A failed look at an uncovered company says so: the old answer left up
559
559
  // would read as the new one.
560
560
  if (status === "error" && (!data || data.kind === "uncovered")) {
561
- return <PaneStatusBody error={error ?? "Could not load hiring data."} errorTitle="Could not load hiring data." retry={{ onRetry: reload }} />;
561
+ return <PaneStatusBody error={error ?? "Could not load hiring data."} errorTitle="Could not load hiring data." retry={{ onRetry: reloadAndWait }} />;
562
562
  }
563
563
  if (!data) return null;
564
564
  if (data.kind === "pending") {
@@ -577,7 +577,7 @@ function CompanyPanel({
577
577
  empty
578
578
  emptyTitle={`No careers system found for ${symbol}.`}
579
579
  emptyMessage="Gloom reads companies' own careers systems. This one either has none we can read or lists roles only on third-party job boards."
580
- retry={{ onRetry: reload, pending: loading, label: "Look again", pendingLabel: "Looking again...", unchanged: "Still no careers system." }}
580
+ retry={{ onRetry: reloadAndWait, pending: loading, label: "Look again", pendingLabel: "Looking again...", unchanged: "Still no careers system." }}
581
581
  />
582
582
  );
583
583
  }
@@ -606,7 +606,7 @@ function HomeView({ width, height, focused, registrationId }: { width: number; h
606
606
  const { navigateTicker } = usePluginTickerActions();
607
607
  const request = useCallback(() => fetchJobsMovers(undefined, MOVERS_PAGE), []);
608
608
  const resource = useAsyncResource(request);
609
- const { data, status, error, reload } = resource;
609
+ const { data, status, error, reload, reloadAndWait } = resource;
610
610
  const [sort, setSort] = usePluginPaneState<MoverSort>("jobs:movers-sort", DEFAULT_MOVER_SORT);
611
611
  // Keyed by company, not by position, so a reload or a shared layout keeps the row.
612
612
  const [selectedKey, setSelectedKey] = usePluginPaneState<string | null>("moversSelectedKey", null);
@@ -689,7 +689,7 @@ function HomeView({ width, height, focused, registrationId }: { width: number; h
689
689
  }, [nativePaneChrome]);
690
690
 
691
691
  if (status === "loading" && !data) return <PaneStatusBody loading align="center" loadingLabel="Loading hiring data..." />;
692
- if (status === "error" && !data) return <PaneStatusBody error={error ?? "Could not load hiring data."} errorTitle="Could not load hiring data." retry={{ onRetry: reload }} />;
692
+ if (status === "error" && !data) return <PaneStatusBody error={error ?? "Could not load hiring data."} errorTitle="Could not load hiring data." retry={{ onRetry: reloadAndWait }} />;
693
693
 
694
694
  const tableHeight = Math.max(3, height - (nativePaneChrome ? 1 : 0));
695
695
  return (
@@ -116,7 +116,7 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
116
116
  const history = useAsyncResource(instrument ? loader : null);
117
117
  useEffect(() => () => controller.current?.abort(), [loader]);
118
118
  useAutoRefresh(history.updatedAt, history.load);
119
- usePaneRefreshKey(() => { void history.reload(); }, { focused });
119
+ usePaneRefreshKey(() => { history.reload(); }, { focused });
120
120
 
121
121
  const model = useMemo(() => history.data ? projectMacroDays(history.data.history, { symbol: symbol ?? "", lookbackYears: Number(lookback) || 5,
122
122
  releases: history.data.releases.releases, coveredThrough: history.data.releases.coveredThrough, earnings: history.data.earnings.reports }) : null,
@@ -5,9 +5,9 @@ export const MACRO_RELEASE_TABLE: {
5
5
  coveredThrough: string;
6
6
  days: Record<"cpi" | "jobs" | "fomc", Record<number, readonly string[]>>;
7
7
  } = {
8
- checkedAt: "2026-10-28",
8
+ checkedAt: "2026-11-11",
9
9
  /** The last day the lists are complete for: later sessions are left out, release day or not. */
10
- coveredThrough: "2026-10-27",
10
+ coveredThrough: "2026-11-11",
11
11
  days: {
12
12
  // BLS Consumer Price Index, 8:30 ET.
13
13
  cpi: {
@@ -16,7 +16,7 @@ export const MACRO_RELEASE_TABLE: {
16
16
  2023: ["01-12", "02-14", "03-14", "04-12", "05-10", "06-13", "07-12", "08-10", "09-13", "10-12", "11-14", "12-12"],
17
17
  2024: ["01-11", "02-13", "03-12", "04-10", "05-15", "06-12", "07-11", "08-14", "09-11", "10-10", "11-13", "12-11"],
18
18
  2025: ["01-15", "02-12", "03-12", "04-10", "05-13", "06-11", "07-15", "08-12", "09-11", "10-24", "12-18"],
19
- 2026: ["01-13", "02-13", "03-11", "04-10", "05-12", "06-10", "07-14", "08-12", "09-11", "10-14"],
19
+ 2026: ["01-13", "02-13", "03-11", "04-10", "05-12", "06-10", "07-14", "08-12", "09-11", "10-14", "11-10"],
20
20
  },
21
21
  // BLS Employment Situation (nonfarm payrolls), 8:30 ET.
22
22
  jobs: {
@@ -25,7 +25,7 @@ export const MACRO_RELEASE_TABLE: {
25
25
  2023: ["01-06", "02-03", "03-10", "04-07", "05-05", "06-02", "07-07", "08-04", "09-01", "10-06", "11-03", "12-08"],
26
26
  2024: ["01-05", "02-02", "03-08", "04-05", "05-03", "06-07", "07-05", "08-02", "09-06", "10-04", "11-01", "12-06"],
27
27
  2025: ["01-10", "02-07", "03-07", "04-04", "05-02", "06-06", "07-03", "08-01", "09-05", "11-20", "12-16"],
28
- 2026: ["01-09", "02-11", "03-06", "04-03", "05-08", "06-05", "07-02", "08-07", "09-04", "10-02"],
28
+ 2026: ["01-09", "02-11", "03-06", "04-03", "05-08", "06-05", "07-02", "08-07", "09-04", "10-02", "11-06"],
29
29
  },
30
30
  // FOMC statement days (the meeting's last day), 14:00 ET. The August 2025 notation vote is not a meeting.
31
31
  fomc: {
@@ -34,7 +34,7 @@ export const MACRO_RELEASE_TABLE: {
34
34
  2023: ["02-01", "03-22", "05-03", "06-14", "07-26", "09-20", "11-01", "12-13"],
35
35
  2024: ["01-31", "03-20", "05-01", "06-12", "07-31", "09-18", "11-07", "12-18"],
36
36
  2025: ["01-29", "03-19", "05-07", "06-18", "07-30", "09-17", "10-29", "12-10"],
37
- 2026: ["01-28", "03-18", "04-29", "06-17", "07-29", "09-16"],
37
+ 2026: ["01-28", "03-18", "04-29", "06-17", "07-29", "09-16", "10-28"],
38
38
  },
39
39
  },
40
40
  };
@@ -88,29 +88,31 @@ function servedFigures(value: unknown): MacroReleaseFigures | undefined {
88
88
  /**
89
89
  * The served list extends the floor past its end; the floor keeps its own
90
90
  * days up to there. IPCA, which the floor does not carry, is the served list's
91
- * through its end, and left out when the server lists none. Every day takes
92
- * the figures the server has for it, or the reason it gives for having none;
93
- * US days before its economic calendar (`figuresFrom`) have none. A served
94
- * list that breaks the contract, or ends no later than the floor, adds
95
- * nothing.
91
+ * through its end, and left out when the server lists none. Every day, the
92
+ * floor's included, takes the figures the server has for it, or the reason it
93
+ * gives for having none, whether or not the served list reaches past the
94
+ * floor's end; US days before its economic calendar (`figuresFrom`) have none.
95
+ * A served list that breaks the contract adds nothing.
96
96
  */
97
97
  export function mergeMacroReleases(floor: MacroReleaseList, served: unknown): MacroReleaseList {
98
98
  const payload = served as { coveredThrough?: unknown; releases?: Partial<Record<MacroEventKind, unknown>>;
99
99
  figures?: Partial<Record<MacroEventKind, Record<string, unknown>>>; figuresFrom?: unknown;
100
100
  figureGaps?: Partial<Record<MacroEventKind, Record<string, unknown>>> } | null;
101
- const coveredThrough = payload?.coveredThrough;
102
- if (!isDate(coveredThrough) || coveredThrough <= floor.coveredThrough) return floor;
101
+ const servedThrough = payload?.coveredThrough;
102
+ if (!isDate(servedThrough)) return floor;
103
+ // The list is complete through the later of the two ends; a served list that stops short of the floor's adds figures only.
104
+ const coveredThrough = servedThrough > floor.coveredThrough ? servedThrough : floor.coveredThrough;
103
105
  const later: MacroRelease[] = [];
104
106
  for (const kind of US_MACRO_EVENT_KINDS) {
105
107
  const dates = payload?.releases?.[kind];
106
108
  if (!Array.isArray(dates) || !dates.every(isDate)) return floor;
107
109
  for (const date of new Set(dates)) {
108
- if (date > floor.coveredThrough && date <= coveredThrough) later.push({ kind, date });
110
+ if (date > floor.coveredThrough && date <= servedThrough) later.push({ kind, date });
109
111
  }
110
112
  }
111
113
  const ipca = payload?.releases?.ipca;
112
114
  if (Array.isArray(ipca) && ipca.every(isDate)) {
113
- for (const date of new Set(ipca)) if (date <= coveredThrough) later.push({ kind: "ipca", date });
115
+ for (const date of new Set(ipca)) if (date <= servedThrough) later.push({ kind: "ipca", date });
114
116
  }
115
117
  const figuresFrom = isDate(payload?.figuresFrom) ? payload.figuresFrom : null;
116
118
  const figuresOf = (release: MacroRelease): MacroRelease => {
@@ -200,8 +200,12 @@ export function createMarketMoversHeadless(
200
200
  ...(notes.length > 0 ? { notes } : {}),
201
201
  // A list served from a saved copy ends with when it was saved.
202
202
  metadata: { ...savedCopyMark(result), list: tab, source: result.source, stale: result.stale, rankedBy, minFloat: floatFiltered ? minFloat : null },
203
- // A Pro account's Gainers, Losers and Most Active are the real-time lists.
204
- ...(result.source === "cloud" ? { freshness: { status: "live" as const } } : {}),
203
+ // A Pro account's Gainers, Losers and Most Active are the real-time lists. The footer is the list's own time,
204
+ // which a Most Active row read from the day's stored snapshot (dated midnight) would otherwise set.
205
+ ...(result.source === "cloud" || result.asOf != null ? { freshness: {
206
+ ...(result.source === "cloud" ? { status: "live" as const } : {}),
207
+ ...(result.asOf != null ? { asOf: result.asOf } : {}),
208
+ } } : {}),
205
209
  };
206
210
  },
207
211
  };
@@ -70,7 +70,7 @@ function shouldUseCache(api: MarketScreenerApi, options?: FetchCacheOptions): bo
70
70
  return options?.cache === true || (options?.cache !== false && api === screenerApi);
71
71
  }
72
72
 
73
- function readCache<T>(key: string, options?: { allowExpired?: boolean }): { data: T; stale: boolean; fetchedAt: number } | null {
73
+ function readCache<T>(key: string, options?: { allowExpired?: boolean }): { data: T; stale: boolean; fetchedAt: number; asOf?: number } | null {
74
74
  const record = marketMoversPersistence?.getResource<CachedResult<T>>(CACHE_KIND, key, {
75
75
  sourceKey: CACHE_SOURCE,
76
76
  schemaVersion: CACHE_SCHEMA_VERSION,
@@ -82,6 +82,7 @@ function readCache<T>(key: string, options?: { allowExpired?: boolean }): { data
82
82
  data: record.value.data,
83
83
  stale: record.value.stale || !!record.stale || failedFetches.has(key),
84
84
  fetchedAt: record.fetchedAt,
85
+ ...(Number.isFinite(record.value.asOf) ? { asOf: record.value.asOf } : {}),
85
86
  };
86
87
  }
87
88
 
@@ -99,6 +100,8 @@ export interface CachedResult<T> {
99
100
  stale: boolean;
100
101
  /** Its refresh failed and the copy saved at this time (ms) answered instead. */
101
102
  savedAt?: number;
103
+ /** When the list itself is current at (ms), as the service dates it: a delayed list's time, not its rows'. */
104
+ asOf?: number;
102
105
  }
103
106
 
104
107
  async function loadCached<T>(
@@ -109,7 +112,7 @@ async function loadCached<T>(
109
112
  if (options?.cache === false) return fetcher();
110
113
 
111
114
  const cached = readCache<T>(key);
112
- if (!options?.forceRefresh && cached && !cached.stale) return { data: cached.data, stale: false };
115
+ if (!options?.forceRefresh && cached && !cached.stale) return { data: cached.data, stale: false, ...(cached.asOf != null ? { asOf: cached.asOf } : {}) };
113
116
 
114
117
  const activeFetch = activeFetches.get(key) as Promise<CachedResult<T>> | undefined;
115
118
  if (activeFetch) return activeFetch;
@@ -128,7 +131,7 @@ async function loadCached<T>(
128
131
  // expired is not. A command that shows it ends with when the copy was saved. A refusal or a
129
132
  // reply that fails validation is the error, saved copy or not.
130
133
  if (fallback && isTransientFailure(error)) {
131
- return servedFromSavedCopy({ data: fallback.data, stale: true, savedAt: fallback.fetchedAt }, fallback.fetchedAt);
134
+ return servedFromSavedCopy({ data: fallback.data, stale: true, savedAt: fallback.fetchedAt, ...(fallback.asOf != null ? { asOf: fallback.asOf } : {}) }, fallback.fetchedAt);
132
135
  }
133
136
  throw error;
134
137
  })
@@ -153,6 +156,12 @@ export interface MarketMoversResult {
153
156
  stale: boolean;
154
157
  /** Its refresh failed and the list saved at this time (ms) answered instead. */
155
158
  savedAt?: number;
159
+ /**
160
+ * When the list is current at (ms), as the service dates it: what a
161
+ * footer shows, never a row's own time (a Most Active row read from the
162
+ * day's stored snapshot can be dated midnight).
163
+ */
164
+ asOf?: number;
156
165
  }
157
166
 
158
167
  export interface PreferredMarketMoverSources {
@@ -278,7 +287,9 @@ export async function fetchScreenerResult(
278
287
  // The service's own source did not answer this time: a saved list answers, as it does a 5xx.
279
288
  if (!response.data && response.status === "retryable_error") throw sourceDidNotAnswer("Market movers temporarily unavailable");
280
289
  if (!response.data) throw new Error("Invalid market movers response");
281
- return { data: parseScreenerResponse(response.data), stale: response.stale === true || response.data.stale === true };
290
+ const asOf = Date.parse(response.data.asOf);
291
+ return { data: parseScreenerResponse(response.data), stale: response.stale === true || response.data.stale === true,
292
+ ...(Number.isFinite(asOf) ? { asOf } : {}) };
282
293
  };
283
294
  if (!shouldUseCache(api, options)) return load();
284
295
  return loadCached(`screener:${category}:count=${count}${session ? `:session=${session}` : ""}`, load, options);
@@ -407,6 +418,7 @@ export async function fetchPreferredMarketMovers(
407
418
  source: "gloom",
408
419
  stale: result.stale,
409
420
  ...(result.savedAt != null ? { savedAt: result.savedAt } : {}),
421
+ ...(result.asOf != null ? { asOf: result.asOf } : {}),
410
422
  };
411
423
  }
412
424
 
@@ -435,6 +447,7 @@ export async function fetchPreferredMarketMovers(
435
447
  ))),
436
448
  source: "cloud",
437
449
  stale: response.stale === true || response.data.stale === true,
450
+ ...(Number.isFinite(Date.parse(response.data.asOf)) ? { asOf: Date.parse(response.data.asOf) } : {}),
438
451
  };
439
452
  }
440
453
  } catch (error) {
@@ -448,6 +461,7 @@ export async function fetchPreferredMarketMovers(
448
461
  source: "gloom",
449
462
  stale: fallback.stale,
450
463
  ...(fallback.savedAt != null ? { savedAt: fallback.savedAt } : {}),
464
+ ...(fallback.asOf != null ? { asOf: fallback.asOf } : {}),
451
465
  };
452
466
  }
453
467
 
@@ -41,9 +41,9 @@ export function Breadth({ fund, width, height, focused, active }: Pick<PaneProps
41
41
  })], [history, metric, colors.warning]);
42
42
  const link = useChartTableSelection({ rows, getId: keyOf, getDate: dateOf, selectedId: selected ?? latest?.date ?? null, onSelect: setSelected, focused });
43
43
  // The resource keeps a failed load as its error (stale, and a warning below), so this refresh never rejects.
44
- const sessionOpen = useLiveSessionRefresh(() => resource.load(true), data?.access === "realtime" ? 15_000 : 60_000, active && visible, resource.updatedAt).live;
45
- useAutoRefresh(resource.updatedAt, () => { if (active && visible && !sessionOpen) void resource.load(data?.basis === "intraday"); });
46
- usePaneRefreshKey(() => void resource.reload(), { focused, enabled: active });
44
+ const sessionOpen = useLiveSessionRefresh(() => resource.reloadAndWait(), data?.access === "realtime" ? 15_000 : 60_000, active && visible, resource.updatedAt).live;
45
+ useAutoRefresh(resource.updatedAt, () => { if (active && visible && !sessionOpen) resource.load(data?.basis === "intraday"); });
46
+ usePaneRefreshKey(() => resource.reload(), { focused, enabled: active });
47
47
  usePaneStatusFooter({ registrationId: "members:breadth", loading: !!data && resource.loading,
48
48
  stale: !!data && (data.stale || resource.data!.stale || !!resource.error), info: latest ? [
49
49
  { id: "as-of", asOf: true, parts: [{ text: `${data?.basis === "intraday" ? data.access === "realtime" ? "live" : "15m delayed" : "close"} ${latest.date}`, tone: "muted" }] },
@@ -1,6 +1,6 @@
1
1
  import { apiClient } from "../../../api-client";
2
2
  import { ApiRequestError } from "../../../api-client/errors";
3
- import type { FundMembersPayload, FundChangesPayload, MemberFundsPayload, FundBreadthPayload } from "../../../api-client/members";
3
+ import type { FundMembersPayload, FundChangesPayload, MemberFundsPayload, FundBreadthPayload, StockFundsPayload } from "../../../api-client/members";
4
4
  import { createPluginCache } from "../../../data/plugin-cache";
5
5
  import { companyNameCase } from "../../../tickers/company-name";
6
6
  import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -10,7 +10,16 @@ export const fundListCache = createPluginCache<MemberFundsPayload>({ kind: "memb
10
10
  export const fundMembersCache = createPluginCache<FundMembersPayload>({ kind: "fund-members", source: "gloom-cloud", schemaVersion: 1, policy });
11
11
  export const fundChangesCache = createPluginCache<FundChangesPayload>({ kind: "fund-changes", source: "gloom-cloud", schemaVersion: 1, policy });
12
12
  export const fundBreadthCache = createPluginCache<FundBreadthPayload>({ kind: "fund-breadth", source: "gloom-cloud", schemaVersion: 1, policy });
13
+ export const stockFundsCache = createPluginCache<StockFundsPayload>({ kind: "stock-funds", source: "gloom-cloud", schemaVersion: 1, policy });
13
14
  type Client = Pick<typeof apiClient, "getMemberFunds" | "getFundMembers" | "getFundChanges">;
15
+ /** A symbol the covered list does not hold: a stock to look through the funds for, or a fund MEMB does not cover. */
16
+ export class FundNotCoveredError extends Error {
17
+ constructor(readonly symbol: string) {
18
+ const text = notCoveredMessage(symbol);
19
+ super(`${text.title} ${text.message}`);
20
+ this.name = "FundNotCoveredError";
21
+ }
22
+ }
14
23
  const number = (value: unknown) => value === null || typeof value === "number" && Number.isFinite(value);
15
24
  function validateMembers(data: FundMembersPayload) {
16
25
  if (!data?.fund?.ticker || !Number.isFinite(Date.parse(data.asOf)) || !Array.isArray(data.members)
@@ -40,12 +49,25 @@ async function fetchFundPayload<T>(fund: string, fetcher: () => Promise<T>, vali
40
49
  try { return validate(await fetcher()); } catch (error) {
41
50
  if (error instanceof ApiRequestError && error.status === 404) {
42
51
  const funds = await fetchFunds(client).then((payload) => payload.funds, () => { /* Intentional ignore: an unreadable covered list leaves the server's own message. */ return []; });
43
- if (funds.length && !coveredFund(funds, fund)) { const text = notCoveredMessage(fund); throw new Error(`${text.title} ${text.message}`); }
52
+ if (funds.length && !coveredFund(funds, fund)) throw new FundNotCoveredError(fund);
44
53
  }
45
54
  throw unavailableOnServer(error, unavailable);
46
55
  }
47
56
  }
57
+ function validateStockFunds(data: StockFundsPayload) {
58
+ if (!data || typeof data.symbol !== "string" || !Array.isArray(data.funds) || !data.funds.every((row) => typeof row.ticker === "string"
59
+ && typeof row.name === "string" && (row.basis === "daily" || row.basis === "nport") && number(row.weight) && typeof row.asOf === "string")) throw new Error("Unreadable fund holders response");
60
+ return data;
61
+ }
48
62
  export const fetchFunds = (client: Client = apiClient) => fetchPayload(() => client.getMemberFunds(), validateFunds);
63
+ /** The ETFs holding a stock; a server without the lookup says so instead of a bare 404. */
64
+ export async function fetchStockFunds(symbol: string, client: Pick<typeof apiClient, "getStockFunds"> = apiClient) {
65
+ try { return validateStockFunds(await client.getStockFunds(symbol)); } catch (error) {
66
+ throw unavailableOnServer(error, "Funds holding a stock are not available on this server yet.");
67
+ }
68
+ }
69
+ export const cachedStockFunds = (symbol: string) => cachedCloudResource(stockFundsCache, symbol, validateStockFunds);
70
+ export const loadStockFunds = (symbol: string, force = false) => loadCloudResource(stockFundsCache, symbol, () => fetchStockFunds(symbol), { force, validate: validateStockFunds });
49
71
  export const fetchMembers = (fund: string, client: Client = apiClient) => fetchFundPayload(fund, () => client.getFundMembers(fund), validateMembers, client);
50
72
  export const fetchChanges = (fund: string, client: Client = apiClient) => fetchFundPayload(fund, () => client.getFundChanges(fund), validateChanges, client);
51
73
  export const cachedFunds = () => cachedCloudResource(fundListCache, "list", validateFunds);