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,6 +1,9 @@
1
1
  import type { HeadlessPaneColumn, HeadlessPaneDefinition } from "../../../types/plugin";
2
- import { fetchBreadth, fetchChanges, fetchFunds, fetchMembers } from "./client";
3
- import { canonicalFund, changeReason, coverageText, decimal, DEFAULT_SORT, holdingsCaveats, holdingsSourceText, memberRows, membersFeed, percent } from "./model";
2
+ import type { HeadlessRowsResult } from "../../../types/headless";
3
+ import { fetchBreadth, fetchChanges, fetchFunds, fetchMembers, fetchStockFunds, FundNotCoveredError } from "./client";
4
+ import type { FundMembersPayload } from "../../../api-client/members";
5
+ import { canonicalFund, changeReason, coverageText, decimal, DEFAULT_SORT, fundName, fundSource, holdingsCaveats, holdingsSourceText, memberRows, membersFeed,
6
+ noStockFundsMessage, percent, stockFundAsOf, stockFundsNotices, usListingInput } from "./model";
4
7
  const columns: HeadlessPaneColumn[] = [
5
8
  { key: "symbol", header: "Ticker" }, { key: "name", header: "Name" },
6
9
  { key: "weight", header: "Weight %", align: "right", format: (value) => value == null ? "--" : decimal(Number(value) * 100) },
@@ -8,15 +11,60 @@ const columns: HeadlessPaneColumn[] = [
8
11
  { key: "price", header: "Price $", align: "right", format: (value) => decimal(value as number | null) },
9
12
  ...["changePercent", "return1WPercent", "return1MPercent", "returnYtdPercent"].map((key, i) => ({ key, header: ["1D", "1W", "1M", "YTD"][i]!, align: "right" as const, format: (value: unknown) => percent(value as number | null) })),
10
13
  ];
14
+ /** A column CSV and JSON carry on every row and the text table leaves to its notices: what the holdings are as of. */
15
+ const exported = (key: string, header: string): HeadlessPaneColumn => ({ key, header, minTableWidth: Number.MAX_SAFE_INTEGER });
16
+ /**
17
+ * What a fund's holdings are as of on each of its rows, so an exported row read alone says it: the date, and an
18
+ * N-PORT report's filing day and link.
19
+ */
20
+ function holdingsBasis(data: Pick<FundMembersPayload, "asOf" | "basis" | "filedOn" | "sourceUrl">) {
21
+ const nport = data.basis === "nport";
22
+ return {
23
+ fields: { holdingsAsOf: data.asOf.slice(0, 10), ...nport ? { filedOn: data.filedOn ?? null, sourceUrl: data.sourceUrl ?? null } : {} },
24
+ columns: [exported("holdingsAsOf", "Holdings as of"), ...nport ? [exported("filedOn", "Filed"), exported("sourceUrl", "Source link")] : []],
25
+ };
26
+ }
27
+ /**
28
+ * `fn MEMB NVDA`: the ETFs whose latest holdings hold a stock, the covered funds on daily files first, then
29
+ * every other US ETF whose latest N-PORT report holds it, each with its weight and what its holdings are as
30
+ * of ("as of 30 Jun 2026 (N-PORT, filed 26 Aug)"). CSV and JSON rows carry the dates and link apart too.
31
+ */
32
+ async function stockFunds(input: string, client: Parameters<typeof fetchStockFunds>[1]): Promise<HeadlessRowsResult> {
33
+ const symbol = usListingInput(input);
34
+ if (!symbol) {
35
+ return { freshness: { status: "not-a-feed", basis: "fund holdings" }, rows: [], columns: [],
36
+ empty: "Funds are looked through by US ticker: name the US listing (an ADR such as INFY or TSM)." };
37
+ }
38
+ const data = await fetchStockFunds(symbol, client);
39
+ const none = noStockFundsMessage(symbol);
40
+ return { freshness: { status: "not-a-feed", basis: "fund holdings" },
41
+ rows: data.funds.map((row) => ({ ...row, weight: row.weight === null ? null : row.weight * 100, holdings: stockFundAsOf(row),
42
+ filedOn: row.filedOn ?? null, sourceUrl: row.sourceUrl ?? null })),
43
+ columns: [{ key: "ticker", header: "Fund" }, { key: "name", header: "Name" },
44
+ { key: "weight", header: "Weight %", align: "right", format: (value) => decimal(value as number | null) },
45
+ { key: "holdings", header: "Holdings" }, exported("asOf", "Holdings as of"), exported("filedOn", "Filed"), exported("sourceUrl", "Source link")],
46
+ empty: `${none.title} ${none.message}`,
47
+ metadata: { symbol: data.symbol, coverage: data.coverage, notices: stockFundsNotices(data) } };
48
+ }
49
+
11
50
  export const membersHeadless: HeadlessPaneDefinition<"rows"> = {
12
- shape: "rows", argument: { kind: "free-text", optional: true, placeholder: "fund", description: "Covered fund or index alias; omit for the fund list." },
51
+ shape: "rows", argument: { kind: "free-text", optional: true, placeholder: "fund or stock", description: "Covered fund or index alias for its holdings, a US stock for the funds holding it; omit for the fund list." },
13
52
  options: [{ key: "tab", type: "enum", values: [{ value: "members" }, { value: "movers" }, { value: "changes" }, { value: "breadth" }], defaultValue: "members", description: "Members, movers, changes or daily breadth." }],
14
- discovery: { aliases: ["MEMB", "MRR", "IMOV"], limitations: ["ETF holdings, with file dates.", "Member prices are real-time with Pro and fifteen minutes delayed otherwise; partial 1D coverage.", "Nasdaq-100 is not covered.", "Breadth history uses current members (survivorship bias)."] },
53
+ discovery: { aliases: ["MEMB", "MRR", "IMOV"], limitations: ["ETF holdings, with file dates.", "Thematic funds from SEC N-PORT reports, two to four months old.", "A stock's ETFs: the covered funds, then every other US ETF from its latest SEC N-PORT report, up to nine months old.", "Member prices are real-time with Pro and fifteen minutes delayed otherwise; partial 1D coverage.", "Nasdaq-100 is not covered.", "Breadth history uses current members (survivorship bias)."] },
15
54
  describe: (args) => args.rawArgument ? `MEMB ${args.rawArgument}` : "Index and ETF members",
16
55
  async load(args, context) {
17
56
  const input = args.symbols[0] ?? args.rawArgument ?? "";
18
- if (!input) return { freshness: { status: "not-a-feed", basis: "fund holdings files" }, rows: (await fetchFunds(context.apiClient)).funds.map((fund) => ({ ...fund })), columns: [{ key: "ticker", header: "Fund" }, { key: "name", header: "Index" }, { key: "asOf", header: "Holdings as of" }] };
57
+ if (!input) return { freshness: { status: "not-a-feed", basis: "fund holdings files" },
58
+ rows: (await fetchFunds(context.apiClient)).funds.map((fund) => ({ ...fund, name: fundName(fund), source: fundSource(fund), filedOn: fund.filedOn ?? null })),
59
+ columns: [{ key: "ticker", header: "Fund" }, { key: "name", header: "Index or theme" }, { key: "asOf", header: "Holdings as of" }, { key: "source", header: "Source" },
60
+ exported("filedOn", "Filed")] };
19
61
  const fund = canonicalFund(input);
62
+ // A symbol the covered list does not hold is a stock to look the funds through for, whatever the tab.
63
+ const covered = await fetchFunds(context.apiClient).then((payload) => payload.funds, () => {
64
+ // Intentional ignore: the fund read below reports the same failure, so the input stays a fund.
65
+ return null;
66
+ });
67
+ if (covered && !covered.some((row) => row.ticker === fund || row.aliases.some((alias) => alias.toUpperCase() === fund))) return stockFunds(input, context.apiClient);
20
68
  if (args.options.tab === "breadth") {
21
69
  const data = await fetchBreadth(fund, context.apiClient);
22
70
  return { freshness: { status: data.stale ? "stale" : data.basis === "intraday" ? data.access === "realtime" ? "live" : "delayed" : "not-a-feed", basis: data.basis === "intraday" ? "regular session" : "daily closes", delayMinutes: 15 },
@@ -32,9 +80,14 @@ export const membersHeadless: HeadlessPaneDefinition<"rows"> = {
32
80
  empty: data.available ? "No stored index changes." : `Index changes are not covered for ${data.fund.ticker}.`,
33
81
  complete: data.available && !data.stale, metadata: { ...data, changes: undefined } };
34
82
  }
35
- const data = await fetchMembers(fund, context.apiClient);
83
+ const data = await fetchMembers(fund, context.apiClient).catch((error: unknown) => {
84
+ if (error instanceof FundNotCoveredError) return null;
85
+ throw error;
86
+ });
87
+ if (!data) return stockFunds(input, context.apiClient);
36
88
  const movers = args.options.tab === "movers";
37
- const rows = memberRows(data.members, movers ? "movers" : "members", "", DEFAULT_SORT).flatMap((row) => row.kind === "item" ? [{ ...row.item }] : []);
89
+ const basis = holdingsBasis(data);
90
+ const rows = memberRows(data.members, movers ? "movers" : "members", "", DEFAULT_SORT).flatMap((row) => row.kind === "item" ? [{ ...row.item, ...basis.fields }] : []);
38
91
  // Member prices are the pane's quotes: real-time for a Pro account, 15 minutes delayed otherwise. As in the
39
92
  // pane, the fund's snapshot says whether it is stale; the members' own flags are not what the pane reads.
40
93
  const live = data.access === "realtime";
@@ -42,8 +95,12 @@ export const membersHeadless: HeadlessPaneDefinition<"rows"> = {
42
95
  // is as of that close and says no feed, as the pane's footer names the close instead of "live".
43
96
  const feed = membersFeed(data.access, Date.now());
44
97
  const closed = feed.kind === "close";
45
- const status = data.stale ? { status: "stale" as const, delayMinutes: 15 } : closed ? {} : { status: live ? "live" as const : "delayed" as const, delayMinutes: 15 };
46
- return { freshness: { ...status, ignoreStaleFlags: true }, rows, columns: movers ? [...columns.slice(0, 3), { key: "contribution", header: "Contrib. pp", align: "right", format: (value) => percent(value as number | null, "", 3) }] : columns,
98
+ // With no member quotes the report is the holdings alone: dated by them, and no feed (an N-PORT fund's would read months old and delayed).
99
+ const status = data.stale ? { status: "stale" as const, delayMinutes: 15 } : data.quotesUnavailable ? { status: "not-a-feed" as const, basis: "fund holdings" }
100
+ : closed ? {} : { status: live ? "live" as const : "delayed" as const, delayMinutes: 15 };
101
+ return { freshness: { ...status, ignoreStaleFlags: true }, rows,
102
+ columns: [...movers ? [...columns.slice(0, 3), { key: "contribution", header: "Contrib. pp", align: "right" as const, format: (value: unknown) => percent(value as number | null, "", 3) }] : columns,
103
+ ...basis.columns],
47
104
  complete: !data.stale && data.aggregate.fresh1D === data.aggregate.total,
48
105
  unavailableSymbols: data.members.flatMap((row) => row.symbol && row.changePercent === null ? [row.symbol] : []),
49
106
  metadata: { fund: data.fund, asOf: data.asOf, ...(closed ? { sessionExchange: "NYSE", observedAt: new Date(feed.closedAt).toISOString() } : {}), snapshotAsOf: data.snapshotAsOf, aggregate: data.aggregate, stale: data.stale, notices: [
@@ -1,17 +1,18 @@
1
1
  import type { GloomPlugin } from "../../../types/plugin";
2
- import { fundBreadthCache, fundChangesCache, fundListCache, fundMembersCache } from "./client";
2
+ import { fundBreadthCache, fundChangesCache, fundListCache, fundMembersCache, stockFundsCache } from "./client";
3
3
  import { membersHeadless } from "./headless";
4
4
  import { membersTitle, TABS } from "./model";
5
5
  export const membersPlugin: GloomPlugin = {
6
6
  id: "members", name: "Index and ETF members", version: "1.0.0", description: "ETF holdings, member returns, contributions, breadth and index changes", toggleable: true,
7
- setup(ctx) { fundBreadthCache.attach(ctx.persistence); fundListCache.attach(ctx.persistence); fundMembersCache.attach(ctx.persistence); fundChangesCache.attach(ctx.persistence); },
8
- dispose() { fundBreadthCache.reset(); fundListCache.reset(); fundMembersCache.reset(); fundChangesCache.reset(); },
7
+ setup(ctx) { fundBreadthCache.attach(ctx.persistence); fundListCache.attach(ctx.persistence); fundMembersCache.attach(ctx.persistence); fundChangesCache.attach(ctx.persistence); stockFundsCache.attach(ctx.persistence); },
8
+ dispose() { fundBreadthCache.reset(); fundListCache.reset(); fundMembersCache.reset(); fundChangesCache.reset(); stockFundsCache.reset(); },
9
9
  panes: [{ id: "members", name: "Index and ETF members", icon: "M", get component(): typeof import("./pane").MembersPane { const { MembersPane } = require("./pane"); return MembersPane; }, shareItem: { ticker: true }, tickerFollower: true,
10
10
  defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 132, height: 32 }, tableExport: true,
11
11
  settings: { fields: [{ key: "tab", label: "View", type: "select", options: TABS }] } }],
12
- paneTemplates: [{ id: "members-pane", paneId: "members", label: "Index and ETF members", description: "ETF holdings, member returns, daily contributions, breadth and index changes.",
13
- keywords: ["members", "index", "ETF", "holdings", "weights", "rebalance", "breadth", "advancers", "decliners", "MRR", "IMOV"],
14
- shortcut: { prefix: "MEMB", argKind: "text", argPlaceholder: "fund", argOptional: true, openWithoutArg: true }, headless: membersHeadless,
12
+ paneTemplates: [{ id: "members-pane", paneId: "members", label: "Index and ETF members", description: "ETF holdings, member returns, daily contributions, breadth and index changes, and the ETFs holding a stock.",
13
+ keywords: ["members", "index", "ETF", "holdings", "weights", "rebalance", "breadth", "advancers", "decliners", "MRR", "IMOV",
14
+ "look-through", "look through", "which ETFs hold", "ETFs holding", "ETF exposure", "thematic ETF", "N-PORT"],
15
+ shortcut: { prefix: "MEMB", argKind: "text", argPlaceholder: "fund or stock", argOptional: true, openWithoutArg: true }, headless: membersHeadless,
15
16
  createInstance: (_context, options) => { const symbol = (options?.arg ?? options?.symbol)?.trim().toUpperCase();
16
17
  return { placement: "floating", title: membersTitle(symbol ?? ""),
17
18
  ...(symbol ? { binding: { kind: "fixed", symbol } } : {}), settings: { tab: options?.values?.tab ?? "members" } }; },
@@ -1,8 +1,9 @@
1
- import type { FundChange, FundMember, FundMembersPayload, MemberFundsPayload } from "../../../api-client/members";
1
+ import type { FundChange, FundMember, FundMembersPayload, MemberFundsPayload, StockFund, StockFundsPayload } from "../../../api-client/members";
2
2
  import type { DataTableColumn } from "../../../components";
3
3
  import { buildSectionedRows, type SectionedRow } from "../../../components/data-table/sections";
4
4
  import { getTableWidth } from "../../../components/ui/table-layout";
5
5
  import { isRegularSessionTime, latestRegularSessionClose } from "../../../market-data/market/freshness";
6
+ import { isUsListingExchange } from "../../../utils/exchanges";
6
7
  import { compareSortValues, type SortPreference } from "../../../utils/sort-values";
7
8
  import { closeLabel } from "../themes/model";
8
9
  export type MembersTab = "members" | "movers" | "changes" | "breadth";
@@ -45,10 +46,73 @@ export function membersFeed(access: FundMembersPayload["access"], readAt: number
45
46
  const close = isRegularSessionTime("NYSE", readAt) === false ? latestRegularSessionClose("NYSE", readAt) : null;
46
47
  return close ? { kind: "close", date: close.date, closedAt: close.close, label: closeLabel(close.date) } : { kind: "live" };
47
48
  }
49
+ const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
50
+ /** "31 Jul 2026", or "22 Sep": spelled out here, as a renderer's locale data writes September "Sept". */
51
+ const dayMonth = (date: string, year: boolean) => {
52
+ const [y, m, d] = date.slice(0, 10).split("-");
53
+ return `${Number(d)} ${MONTHS[Number(m) - 1]}${year ? ` ${y}` : ""}`;
54
+ };
55
+ /**
56
+ * What a fund's holdings are as of: an issuer file's date ("holdings 2026-10-08"), or for an N-PORT report its
57
+ * period end and filing day ("holdings as of 31 Jul 2026 (N-PORT, filed 22 Sep)"), so a quarter-old report never
58
+ * reads as today's holdings. The filing day names its year when it is not the report's.
59
+ */
60
+ export function holdingsBasisText(data: { asOf: string; basis?: "daily" | "nport"; filedOn?: string | null }, short = false) {
61
+ if (data.basis !== "nport") return `holdings ${data.asOf.slice(0, 10)}`;
62
+ const filed = data.filedOn ? `, filed ${dayMonth(data.filedOn, data.filedOn.slice(0, 4) !== data.asOf.slice(0, 4))}` : "";
63
+ // A narrow footer: "N-PORT 31 Jul 2026, filed 22 Sep".
64
+ return short ? `N-PORT ${dayMonth(data.asOf, true)}${filed}` : `holdings as of ${dayMonth(data.asOf, true)} (N-PORT${filed})`;
65
+ }
48
66
  /** "S&P 500, IVV holdings as of 2026-10-08 (for SPY)": the holdings file the members come from. */
49
- export function holdingsSourceText(input: string, data: Pick<FundMembersPayload, "fund" | "asOf">) {
67
+ export function holdingsSourceText(input: string, data: Pick<FundMembersPayload, "fund" | "asOf" | "basis" | "filedOn">) {
50
68
  const requested = requestedSymbol(input);
51
- return `${data.fund.name}, ${data.fund.ticker} holdings as of ${data.asOf.slice(0, 10)}${requested && requested !== data.fund.ticker ? ` (for ${requested})` : ""}`;
69
+ const forRequested = requested && requested !== data.fund.ticker ? ` (for ${requested})` : "";
70
+ if (data.basis === "nport") return `${fundName(data.fund)}, ${data.fund.ticker} ${holdingsBasisText(data)}${forRequested}`;
71
+ return `${fundName(data.fund)}, ${data.fund.ticker} holdings as of ${data.asOf.slice(0, 10)}${forRequested}`;
72
+ }
73
+ /**
74
+ * What a fund holding a stock holds it as of, on its row: an N-PORT report's period end and filing day ("as of
75
+ * 30 Jun 2026 (N-PORT, filed 26 Aug)"), or a daily file's date ("as of 5 Nov 2026 (daily file)"). A narrow
76
+ * table drops the words its section header says ("30 Jun 2026, filed 26 Aug").
77
+ */
78
+ export function stockFundAsOf(row: Pick<StockFund, "asOf" | "basis" | "filedOn">, short = false) {
79
+ const asOf = dayMonth(row.asOf, true);
80
+ const filed = row.basis === "nport" && row.filedOn ? `filed ${dayMonth(row.filedOn, row.filedOn.slice(0, 4) !== row.asOf.slice(0, 4))}` : "";
81
+ if (short) return filed ? `${asOf}, ${filed}` : asOf;
82
+ return row.basis === "nport" ? `as of ${asOf} (N-PORT${filed ? `, ${filed}` : ""})` : `as of ${asOf} (daily file)`;
83
+ }
84
+ const count = (value: number, noun = "") => `${value.toLocaleString("en-US")}${noun ? ` ${noun}${value === 1 ? "" : "s"}` : ""}`;
85
+ /**
86
+ * What the funds holding a stock are: how many ETFs were looked through (the covered funds on their daily files,
87
+ * every other US ETF from its latest N-PORT report), and that a report's holdings are a quarter's, filed up to
88
+ * 60 days after the date they are as of.
89
+ */
90
+ export function stockFundsNotices(data: StockFundsPayload) {
91
+ const total = data.coverage.daily + data.coverage.nport;
92
+ return [
93
+ `${count(data.funds.length)} of ${count(total)} ETFs looked through hold ${data.symbol}: ${count(data.coverage.daily, "covered fund")} from daily holdings files, ${count(data.coverage.nport)} from their latest SEC N-PORT reports.`,
94
+ ...(data.funds.some((row) => row.basis === "nport") ? ["N-PORT holdings are a quarter's report, filed up to 60 days after the date they are as of."] : []),
95
+ ];
96
+ }
97
+ /** Where a covered fund's holdings come from, for the fund list: its issuer's daily file, or its N-PORT report and the day it was filed. */
98
+ export function fundSource(fund: { basis?: "daily" | "nport"; filedOn?: string | null; asOf: string | null }) {
99
+ if (fund.basis !== "nport") return "Daily file";
100
+ return fund.filedOn ? `N-PORT, filed ${dayMonth(fund.filedOn, true)}` : "N-PORT";
101
+ }
102
+ /**
103
+ * The US ticker a look-through asks for (NVDA, BRK.B), from a bare symbol or a US listing; null for a listing abroad
104
+ * (INFY:NSE), whose code is not the ticker the funds' holdings carry.
105
+ */
106
+ export function usListingInput(input: string): string | null {
107
+ const [symbol, exchange] = input.trim().toUpperCase().split(":");
108
+ return symbol && (!exchange || isUsListingExchange(exchange)) ? symbol : null;
109
+ }
110
+ /** No ETF looked through holds the symbol: it may be a fund MEMB does not cover, so the fund facts are named too. */
111
+ export function noStockFundsMessage(input: string, surface: "report" | "pane" = "report") {
112
+ const symbol = requestedSymbol(input);
113
+ return { title: `No ETF looked through holds ${symbol}.`,
114
+ message: surface === "pane" ? `If ${symbol} is a fund, MEMB does not cover it: its fund facts are in ETF ${symbol}. MEMB with no fund lists the funds it covers.`
115
+ : `If ${symbol} is a fund, MEMB does not cover it: gloom fn ETF ${symbol}. The covered funds: gloom fn MEMB.` };
52
116
  }
53
117
  /** Caveats about a fund's holdings and returns, shared by the pane's notices and the text report. */
54
118
  export function holdingsCaveats(data: FundMembersPayload, movers: boolean) {
@@ -57,14 +121,19 @@ export function holdingsCaveats(data: FundMembersPayload, movers: boolean) {
57
121
  ...(movers && data.aggregate.fundReturn === null ? ["Fund 1D is unavailable; the difference cannot be calculated."] : []),
58
122
  ...(movers && data.aggregate.withinTolerance === false ? [`The covered contribution sum differs from the fund by ${percent(data.aggregate.residual, " pp")}.`] : []),
59
123
  ...(data.excludedDerivatives ? [`${data.excludedDerivatives} derivative positions are excluded from these share holdings.`] : []),
124
+ ...(data.excludedShorts ? [`${data.excludedShorts} short positions are excluded from these share holdings.`] : []),
60
125
  ];
61
126
  }
62
- export function membersTitle(input: string) {
127
+ /** A fund's own name: an N-PORT fund's served `name` says "(N-PORT)" for apps that cannot show its basis. */
128
+ export function fundName(fund: { name: string; plainName?: string }) {
129
+ return fund.plainName ?? fund.name;
130
+ }
131
+ export function membersTitle(input: string, stock = false) {
63
132
  const requested = input.split(":")[0]!.trim().toUpperCase();
64
133
  const fund = canonicalFund(requested);
65
134
  const definition = COVERED.find((item) => item.ticker === fund);
66
135
  return definition ? `${definition.name}, ${fund} holdings${requested !== fund ? ` (${requested})` : ""}`
67
- : requested ? `MEMB ${requested}` : "Index and ETF members";
136
+ : stock ? `Funds holding ${requested}` : requested ? `MEMB ${requested}` : "Index and ETF members";
68
137
  }
69
138
  export const DEFAULT_SORT: SortPreference<string> = { columnId: "weight", direction: "desc" };
70
139
  /** A signed figure; one that rounds to zero is unsigned (0.00, never +0.00 or -0.00). */
@@ -105,6 +174,21 @@ export function memberColumns(width: number, movers = false): DataTableColumn[]
105
174
  column("changePercent", "1D", compact ? 8 : 9), ...(!movers ? [column("return1WPercent", "1W", 9), column("return1MPercent", "1M", 9), column("returnYtdPercent", "YTD", 9), column("sector", "Sector", 22, "left")] : [])], width,
106
175
  ["sector", "shares", "returnYtdPercent", "return1MPercent", "return1WPercent", "price", "name"]);
107
176
  }
177
+ /** The ETFs holding a stock, in two sections: the covered funds on daily holdings files, then those read from N-PORT reports, each by weight as the server orders them. */
178
+ export function stockFundRows(rows: readonly StockFund[]): SectionedRow<StockFund>[] {
179
+ return buildSectionedRows([
180
+ { label: "Daily holdings files", items: rows.filter((row) => row.basis === "daily") },
181
+ { label: "SEC N-PORT reports", items: rows.filter((row) => row.basis === "nport") },
182
+ ], (row) => row.ticker);
183
+ }
184
+ /** Whether a stock's fund table has room for each row's whole "as of 30 Jun 2026 (N-PORT, filed 26 Aug)". */
185
+ export const stockFundAsOfFits = (width: number) => width >= 96;
186
+ export function stockFundColumns(width: number) {
187
+ const compact = width < 50;
188
+ const whole = stockFundAsOfFits(width);
189
+ return fit([column("ticker", "Fund", 8, "left"), column("name", "Name", whole ? 24 : 14, "left"), column("weight", compact ? "Wt. %" : "Weight %", compact ? 7 : 10),
190
+ column("asOf", whole ? "Holdings" : "As of", whole ? 46 : compact ? 26 : 30, "left")], width, ["name"]);
191
+ }
108
192
  export function changeColumns(width: number) {
109
193
  const compact = width < 50;
110
194
  return fit([column("effectiveDate", compact ? "Date" : "Effective", compact ? 10 : 12, "left"), column("daysToGo", compact ? "In" : "In days", compact ? 4 : 9), column("added", "Added", compact ? 7 : 8, "left"), column("removed", "Removed", 9, "left"), column("estimate", "Est. ADV days", 15), column("reason", "Reason", 28, "left")], width, ["estimate", "reason"]);
@@ -1,6 +1,6 @@
1
1
  import { Breadth } from "./breadth-pane";
2
2
  import { useCallback, useMemo, useRef, useState } from "react";
3
- import type { FundChange, FundMember } from "../../../api-client/members";
3
+ import type { FundChange, FundMember, MemberFundsPayload, StockFund } from "../../../api-client/members";
4
4
  import { delayedFooterSegment, DataTableStackView, DataTableView, DetailScrollBody, EmptyState, KeyValueRow, PaneFooterScope, PaneStatusBody, Prose, QueryBar, StatGrid,
5
5
  isSectionedItemRow, renderSectionedRowHeader, useExternalLinkFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, useQueryBarSearch,
6
6
  type DataTableCell, type DataTableColumn, type PaneFooterSegment, type SectionedRow } from "../../../components";
@@ -13,8 +13,10 @@ import { Box, type ScrollBoxRenderable } from "../../../ui";
13
13
  import { nextHeaderSort, type SortPreference } from "../../../utils/sort-values";
14
14
  import { isPlainArrowUp, stopSearchFocusNavigation } from "../../../utils/search-focus-navigation";
15
15
  import { useMembersMenu, type MemberList } from "../shared/members-menu";
16
- import { cachedChanges, cachedFunds, cachedMembers, loadChanges, loadFunds, loadMembers } from "./client";
17
- import { canonicalFund, changeColumns, changeLabel, changeReason, coverageText, coveredFund, decimal, DEFAULT_SORT, holdingsCaveats, isTab, memberColumns, memberRows, membersFeed, membersTitle, notCoveredMessage, percent, TABS, type MembersTab } from "./model";
16
+ import { cachedChanges, cachedFunds, cachedMembers, cachedStockFunds, loadChanges, loadFunds, loadMembers, loadStockFunds } from "./client";
17
+ import { canonicalFund, changeColumns, changeLabel, changeReason, coverageText, coveredFund, decimal, DEFAULT_SORT, holdingsBasisText, holdingsCaveats, isTab, memberColumns, memberRows,
18
+ membersFeed, membersTitle, noStockFundsMessage, percent, stockFundAsOf, stockFundAsOfFits, stockFundColumns, stockFundRows, TABS, usListingInput,
19
+ type MembersTab } from "./model";
18
20
 
19
21
  type ViewProps = Pick<PaneProps, "width" | "height" | "focused"> & { fund: string; active: boolean };
20
22
  const rowKey = (row: SectionedRow<FundMember>) => row.key;
@@ -44,8 +46,8 @@ function Holdings({ fund, tab, width, height, focused, active }: ViewProps & { t
44
46
  useMembersMenu("members:members-menu", memberList);
45
47
  // A Pro account's members are priced from the server's live read, renewed every 15 seconds.
46
48
  const live = data?.access === "realtime";
47
- useAutoRefresh(resource.updatedAt, () => { if (active) void resource.load(live); }, { intervalMs: live ? LIVE_MEMBERS_REFRESH_MS : null });
48
- usePaneRefreshKey(() => void resource.reload(), { focused, enabled: active && !search.active });
49
+ useAutoRefresh(resource.updatedAt, () => { if (active) resource.load(live); }, { intervalMs: live ? LIVE_MEMBERS_REFRESH_MS : null });
50
+ usePaneRefreshKey(() => resource.reload(), { focused, enabled: active && !search.active });
49
51
  const info = useMemo<PaneFooterSegment[]>(() => {
50
52
  if (!data) return [];
51
53
  // Outside the regular session a Pro account's members are the session's close, so the footer names it, not "live".
@@ -56,19 +58,25 @@ function Holdings({ fund, tab, width, height, focused, active }: ViewProps & { t
56
58
  // The close names its own date, so a quote date that is the same day is not said twice.
57
59
  const dateSaid = feed.kind === "close" && dates.length === 1 && dates[0] === feed.date;
58
60
  const partial = data.aggregate.fresh1D < data.aggregate.total;
61
+ // An N-PORT fund's holdings are a quarter's report: always said, with its date and filing day, never as today's.
62
+ const holdingsText = holdingsBasisText(data);
63
+ const nport = data.basis === "nport";
59
64
  return [
60
65
  { id: "coverage", parts: [{ text: coverageText(data.aggregate, width < 60), tone: partial ? "warning" : "muted" }] },
61
66
  // A capture's status line says the quotes' date and delay too; it does not say returns are unavailable.
62
67
  ...(data.quotesUnavailable
63
- ? [{ id: "quote-date", title: `${date ?? "Quote date unavailable"} · ${feedText} · holdings ${data.asOf}`, parts: [{ text: "returns unavailable", tone: "muted" as const }] }]
68
+ ? [{ id: "quote-date", title: `${date ?? "Quote date unavailable"} · ${feedText} · ${holdingsText}`, parts: [{ text: "returns unavailable", tone: "muted" as const }] }]
64
69
  : [
65
70
  feed.kind === "live" ? { id: "quote-live", quoteStatus: true, parts: [{ text: "live", tone: "positive" as const }] }
66
- : feed.kind === "close" ? { id: "quote-close", title: `${feed.label} · holdings ${data.asOf}`, quoteStatus: true, parts: [{ text: feed.label, tone: "muted" as const }] }
71
+ : feed.kind === "close" ? { id: "quote-close", title: `${feed.label} · ${holdingsText}`, quoteStatus: true, parts: [{ text: feed.label, tone: "muted" as const }] }
67
72
  : delayedFooterSegment({ id: "quote-delay", detail: "15m delayed", delay: "15m", quoteStatus: true }),
68
- ...(date && !dateSaid ? [{ id: "quote-date", title: `${date} · ${feedText} · holdings ${data.asOf}`, quoteStatus: true,
73
+ ...(date && !dateSaid ? [{ id: "quote-date", title: `${date} · ${feedText} · ${holdingsText}`, quoteStatus: true,
69
74
  parts: [{ text: width < 60 && dates.length === 1 ? date.slice(5) : date, tone: "muted" as const }] }] : []),
70
75
  ]),
71
- ...(width >= 60 ? [{ id: "holdings-date", asOf: true, parts: [{ text: `holdings ${data.asOf}`, tone: "muted" as const }] }] : []),
76
+ // A shot keeps an N-PORT fund's (capture): a picture of its rows cannot say they are a quarter's report.
77
+ ...(nport ? [{ id: "holdings-date", capture: true, title: holdingsText,
78
+ parts: [{ text: holdingsBasisText(data, width < 100), tone: "warning" as const }] }]
79
+ : width >= 60 ? [{ id: "holdings-date", asOf: true, parts: [{ text: holdingsText, tone: "muted" as const }] }] : []),
72
80
  ];
73
81
  }, [data, resource.updatedAt, width]);
74
82
  usePaneStatusFooter({ registrationId: "members:status", loading: !!data && resource.loading,
@@ -118,8 +126,8 @@ function Changes({ fund, width, height, focused, active }: ViewProps) {
118
126
  const detail = data?.changes.find((row) => row.id === opened);
119
127
  const selectedRow = detail ?? data?.changes.find((row) => row.id === selected) ?? data?.changes[0];
120
128
  const scrollRef = useRef<ScrollBoxRenderable | null>(null);
121
- useAutoRefresh(resource.updatedAt, () => { if (active) void resource.load(); });
122
- usePaneRefreshKey(() => void resource.reload(), { focused, enabled: active });
129
+ useAutoRefresh(resource.updatedAt, () => { if (active) resource.load(); });
130
+ usePaneRefreshKey(() => resource.reload(), { focused, enabled: active });
123
131
  useExternalLinkFooter({ registrationId: "members:source", focused, url: selectedRow?.url });
124
132
  usePaneStatusFooter({ registrationId: "members:changes", loading: !!data && resource.loading, stale: !!data && (data.stale || resource.data!.stale || !!resource.error),
125
133
  info: data?.asOf ? [{ id: "updated", parts: [{ text: `as of ${data.asOf.slice(0, 10)}`, tone: "muted" }] }] : [] });
@@ -177,7 +185,7 @@ function FundView({ fund, ...props }: Pick<PaneProps, "width" | "height" | "focu
177
185
  function FundPicker({ width, height, focused, choose }: Pick<PaneProps, "width" | "height" | "focused"> & { choose: (fund: string) => void }) {
178
186
  const resource = useAsyncResource(loadFunds, { initialData: cachedFunds });
179
187
  const [selected, setSelected] = useState<string | null>(null);
180
- usePaneRefreshKey(() => void resource.reload(), { focused });
188
+ usePaneRefreshKey(() => resource.reload(), { focused });
181
189
  usePaneStatusFooter({ registrationId: "members:picker", loading: resource.loading && !!resource.data, stale: resource.data?.stale });
182
190
  return <PaneStatusBody subject="covered funds" loading={!resource.data && resource.loading} error={!resource.data ? resource.error : null}>
183
191
  {resource.data && <DataTableView items={resource.data.payload.funds} emptyStateTitle="No covered funds." rootWidth={width} rootHeight={height} focused={focused}
@@ -186,14 +194,53 @@ function FundPicker({ width, height, focused, choose }: Pick<PaneProps, "width"
186
194
  onActivate={(row) => choose(row.ticker)} sortColumnId={null} sortDirection="asc" renderCell={(row, col) => ({ text: String(row[col.id as "ticker"] ?? "--") })} />}
187
195
  </PaneStatusBody>;
188
196
  }
189
- type FundPaneProps = Pick<PaneProps, "width" | "height" | "focused"> & { fund: string; requested: string };
190
- /** The covered list is the server's, so a fund it adds opens without an app update. A list that cannot be read leaves the fund's own load to report the failure. */
191
- function CoveredFund({ fund, requested, ...props }: FundPaneProps) {
192
- const resource = useAsyncResource(loadFunds, { initialData: cachedFunds });
193
- const funds = resource.data?.payload.funds;
197
+ type ListProps = Pick<PaneProps, "width" | "height" | "focused">;
198
+ const stockFundKey = (row: SectionedRow<StockFund>) => row.key;
199
+ /**
200
+ * The ETFs holding a stock: the covered funds on daily holdings files first, then every other US ETF whose
201
+ * latest SEC N-PORT report holds it, each with its weight and what its holdings are as of (and a report's
202
+ * filing day).
203
+ */
204
+ function StockFunds({ symbol, width, height, focused }: ListProps & { symbol: string }) {
205
+ const colors = useThemeColors();
206
+ const { pinTicker } = usePluginTickerActions();
207
+ const resource = useAsyncResource(useCallback((force: boolean) => loadStockFunds(symbol, force), [symbol]), { initialData: useCallback(() => cachedStockFunds(symbol), [symbol]) });
208
+ const data = resource.data?.payload;
209
+ const [selected, setSelected] = usePluginPaneState<string | null>(`holding:${symbol}`, null);
210
+ const rows = useMemo(() => stockFundRows(data?.funds ?? []), [data]);
211
+ usePaneRefreshKey(() => resource.reload(), { focused });
212
+ usePaneStatusFooter({ registrationId: "members:stock-funds", loading: !!data && resource.loading, stale: !!data && (resource.data!.stale || !!resource.error) });
213
+ usePaneNoticeFooter({ registrationId: "members:stock-funds-notices", focused, notices: resource.error && data ? [resource.error] : [] });
214
+ const renderCell = useCallback((item: SectionedRow<StockFund>, column: DataTableColumn): DataTableCell => {
215
+ if (!isSectionedItemRow(item)) return { text: "" };
216
+ const row = item.item;
217
+ if (column.id === "ticker") return { text: row.ticker, color: colors.textBright };
218
+ if (column.id === "name") return { text: row.name, color: colors.text };
219
+ if (column.id === "weight") return { text: row.weight == null ? "--" : decimal(row.weight * 100), value: row.weight == null ? null : row.weight * 100 };
220
+ return { text: stockFundAsOf(row, !stockFundAsOfFits(width)), color: colors.textMuted };
221
+ }, [colors, width]);
222
+ const none = noStockFundsMessage(symbol, "pane");
223
+ return <PaneStatusBody subject="funds holding the stock" loading={!data && resource.loading} error={!data ? resource.error : null}
224
+ empty={!!data && !data.funds.length} emptyTitle={none.title} emptyMessage={none.message}>
225
+ {data && !!data.funds.length && <DataTableView<SectionedRow<StockFund>> items={rows} columns={stockFundColumns(width)} rootWidth={width} rootHeight={height} focused={focused}
226
+ selection={{ kind: "id", selectedId: selected, getId: stockFundKey, onChange: (id) => setSelected(String(id)) }} getItemKey={stockFundKey}
227
+ isNavigable={isSectionedItemRow} renderSectionHeader={renderSectionedRowHeader} sortColumnId={null} sortDirection="desc"
228
+ onActivate={(row) => { if (isSectionedItemRow(row)) pinTicker(row.item.ticker, { floating: true, instrument: null }); }}
229
+ renderCell={renderCell} selectedTextOverridesCellColor emptyStateTitle={none.title} />}
230
+ </PaneStatusBody>;
231
+ }
232
+ type FundPaneProps = ListProps & { fund: string; requested: string; funds: MemberFundsPayload["funds"] | undefined };
233
+ /**
234
+ * The covered list is the server's, so a fund it adds opens without an app update. A symbol it does not hold is a
235
+ * stock, and the pane lists the covered funds holding it. A list that cannot be read leaves the fund's own load to
236
+ * report the failure.
237
+ */
238
+ function CoveredFund({ fund, requested, funds, ...props }: FundPaneProps) {
194
239
  if (funds?.length && !coveredFund(funds, fund)) {
195
- const text = notCoveredMessage(requested, "pane");
196
- return <PaneStatusBody empty emptyTitle={text.title} emptyMessage={text.message} />;
240
+ const symbol = usListingInput(requested);
241
+ if (!symbol) return <PaneStatusBody empty emptyTitle={`${requested.toUpperCase()} is not a US listing.`}
242
+ emptyMessage="Funds are looked through by US ticker: name the US listing, such as an ADR (INFY, TSM)." />;
243
+ return <StockFunds key={symbol} symbol={symbol} {...props} />;
197
244
  }
198
245
  return <FundView key={fund} fund={fund} {...props} />;
199
246
  }
@@ -202,7 +249,9 @@ export function MembersPane(props: PaneProps) {
202
249
  const [chosen, choose] = usePluginPaneState("fund", "");
203
250
  const requested = symbol ?? chosen;
204
251
  const fund = canonicalFund(requested);
205
- usePaneTitle(membersTitle(requested));
252
+ const resource = useAsyncResource(loadFunds, { initialData: cachedFunds });
253
+ const funds = resource.data?.payload.funds;
254
+ usePaneTitle(membersTitle(requested, !!fund && !!funds?.length && !coveredFund(funds, fund)));
206
255
  if (!fund) return <FundPicker {...props} choose={choose} />;
207
- return <CoveredFund fund={fund} requested={requested} {...props} />;
256
+ return <CoveredFund fund={fund} requested={requested} funds={funds} {...props} />;
208
257
  }
@@ -560,7 +560,8 @@ function DistressTable<Row>({
560
560
  const renderCell = useCallback((row: Row, column: DataTableColumn, _index: number, state: { selected: boolean }): DataTableCell => {
561
561
  const muted = state.selected ? colors.selectedText : colors.textMuted;
562
562
  const base = state.selected ? colors.selectedText : colors.text;
563
- const tone = (value: StateTone) => (state.selected ? colors.selectedText : toneColor(value, colors));
563
+ // The shared table keeps a gain or loss tone on the selected row and inks any other in the selection's text.
564
+ const tone = (value: StateTone) => toneColor(value, colors);
564
565
  return spec.cell(row, column.id, muted, base, tone);
565
566
  }, [colors, spec]);
566
567
 
@@ -249,7 +249,7 @@ function MnaDealsView({ focused, width, height, symbol }: {
249
249
  const onScroll = useTableLoadMore(scrollRef, !!data?.hasMore && !loadingMore && !openId, loadMore);
250
250
 
251
251
  useAutoRefresh(resource.updatedAt, resource.load);
252
- usePaneRefreshKey(() => void resource.reload(), { focused, enabled: !openId });
252
+ usePaneRefreshKey(() => resource.reload(), { focused, enabled: !openId });
253
253
 
254
254
  const deals = data?.deals ?? NO_DEALS;
255
255
  const quoteSymbols = useMemo(() => {
@@ -1,5 +1,5 @@
1
1
  import { apiClient } from "../../../api-client";
2
- import type { MoneyMarketsPayload } from "../../../api-client/money-markets";
2
+ import type { HongKongMoneyMarketsPayload, MoneyMarketRow, MoneyMarketsPayload } from "../../../api-client/money-markets";
3
3
  import { createPluginCache } from "../../../data/plugin-cache";
4
4
  import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
5
5
 
@@ -7,21 +7,22 @@ export const moneyMarketsCache = createPluginCache<MoneyMarketsPayload>({
7
7
  kind: "money-markets", source: "gloom-cloud", schemaVersion: 1,
8
8
  policy: { staleMs: 60 * 60_000, expireMs: 7 * 24 * 60 * 60_000 },
9
9
  });
10
+ export const hongKongMoneyMarketsCache = createPluginCache<HongKongMoneyMarketsPayload>({
11
+ kind: "money-markets-hk", source: "gloom-cloud", schemaVersion: 1,
12
+ policy: { staleMs: 60 * 60_000, expireMs: 7 * 24 * 60 * 60_000 },
13
+ });
10
14
 
11
15
  const finiteOrNull = (value: unknown) => value === null || typeof value === "number" && Number.isFinite(value);
12
16
  const dateOrNull = (value: unknown) => value === null || typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)
13
17
  && Number.isFinite(Date.parse(value)) && new Date(value).toISOString().slice(0, 10) === value;
14
18
 
15
- /** Reject incompatible contracts rather than supplying zeros to a board or curve. */
16
- export function validateMoneyMarkets(payload: MoneyMarketsPayload): MoneyMarketsPayload {
17
- const invalid = () => { throw new Error("The server returned invalid money-market observations"); };
18
- if (!payload || !Number.isFinite(Date.parse(payload.generatedAt)) || !["available", "partial", "unavailable"].includes(payload.status)
19
- || !Array.isArray(payload.rows) || !payload.netLiquidity || !payload.billsCurve || !Array.isArray(payload.billsCurve.comparisons)
20
- || payload.billsCurve.basis !== "discount" || !["available", "stale", "unavailable"].includes(payload.billsCurve.status)) return invalid();
21
- const rows = [...payload.rows, payload.netLiquidity];
19
+ const invalid = (): never => { throw new Error("The server returned invalid money-market observations"); };
20
+
21
+ /** Rows of the board's groups with dated, finite values and a year's rank, or the payload is refused. */
22
+ function validateRows(rows: readonly MoneyMarketRow[], groups: readonly MoneyMarketRow["group"][]): void {
22
23
  if (new Set(rows.map((row) => row.id)).size !== rows.length) return invalid();
23
24
  for (const row of rows) {
24
- if (typeof row.id !== "string" || typeof row.label !== "string" || !["rates", "bills", "liquidity"].includes(row.group)
25
+ if (typeof row.id !== "string" || typeof row.label !== "string" || !groups.includes(row.group)
25
26
  || !["percent", "usd-billions"].includes(row.unit) || !["daily", "weekly"].includes(row.frequency)
26
27
  || !["available", "stale", "unavailable"].includes(row.status)
27
28
  || row.changeUnit !== (row.unit === "percent" ? "basis-points" : "usd-billions")
@@ -30,12 +31,23 @@ export function validateMoneyMarkets(payload: MoneyMarketsPayload): MoneyMarkets
30
31
  || !Array.isArray(row.history) || row.history.some((point) => point.date == null || !dateOrNull(point.date) || !finiteOrNull(point.value))
31
32
  || !Array.isArray(row.sourceSeriesIds) || row.sourceSeriesIds.some((id) => typeof id !== "string") || !Array.isArray(row.notes)) return invalid();
32
33
  }
33
- for (const stats of [...rows.map((row) => row.percentile), payload.billsCurve.slope?.percentile]) {
34
- if (!stats || !finiteOrNull(stats.value) || stats.value != null && (stats.value < 0 || stats.value > 100)
35
- || !Number.isInteger(stats.sampleCount) || stats.sampleCount < 0
36
- || !finiteOrNull(stats.min) || !finiteOrNull(stats.max) || !finiteOrNull(stats.mean)
37
- || !dateOrNull(stats.windowStart) || !dateOrNull(stats.windowEnd)) return invalid();
38
- }
34
+ for (const stats of rows.map((row) => row.percentile)) validatePercentile(stats);
35
+ }
36
+
37
+ function validatePercentile(stats: MoneyMarketRow["percentile"] | undefined): void {
38
+ if (!stats || !finiteOrNull(stats.value) || stats.value != null && (stats.value < 0 || stats.value > 100)
39
+ || !Number.isInteger(stats.sampleCount) || stats.sampleCount < 0
40
+ || !finiteOrNull(stats.min) || !finiteOrNull(stats.max) || !finiteOrNull(stats.mean)
41
+ || !dateOrNull(stats.windowStart) || !dateOrNull(stats.windowEnd)) invalid();
42
+ }
43
+
44
+ /** Reject incompatible contracts rather than supplying zeros to a board or curve. */
45
+ export function validateMoneyMarkets(payload: MoneyMarketsPayload): MoneyMarketsPayload {
46
+ if (!payload || !Number.isFinite(Date.parse(payload.generatedAt)) || !["available", "partial", "unavailable"].includes(payload.status)
47
+ || !Array.isArray(payload.rows) || !payload.netLiquidity || !payload.billsCurve || !Array.isArray(payload.billsCurve.comparisons)
48
+ || payload.billsCurve.basis !== "discount" || !["available", "stale", "unavailable"].includes(payload.billsCurve.status)) return invalid();
49
+ validateRows([...payload.rows, payload.netLiquidity], ["rates", "bills", "liquidity"]);
50
+ validatePercentile(payload.billsCurve.slope?.percentile);
39
51
  for (const snapshot of [payload.billsCurve, ...payload.billsCurve.comparisons]) {
40
52
  if (!dateOrNull(snapshot.asOf) || !Array.isArray(snapshot.points) || snapshot.points.some((point) =>
41
53
  !Number.isFinite(point.value) || !Number.isFinite(point.maturityYears) || point.maturityYears <= 0
@@ -52,3 +64,19 @@ export async function fetchMoneyMarkets(client: Pick<typeof apiClient, "getCloud
52
64
 
53
65
  export const getCachedMoneyMarkets = () => cachedCloudResource(moneyMarketsCache, "usd");
54
66
  export const loadMoneyMarkets = (force = false) => loadCloudResource(moneyMarketsCache, "usd", () => fetchMoneyMarkets(), { force });
67
+
68
+ /** Hong Kong's bill-yield board, refused whole when a row is not a dated Exchange Fund Bill yield. */
69
+ export function validateHongKongMoneyMarkets(payload: HongKongMoneyMarketsPayload): HongKongMoneyMarketsPayload {
70
+ if (!payload || !Number.isFinite(Date.parse(payload.generatedAt)) || !["available", "partial", "unavailable"].includes(payload.status)
71
+ || !Array.isArray(payload.rows) || typeof payload.source?.name !== "string") return invalid();
72
+ validateRows(payload.rows, ["efb"]);
73
+ return payload;
74
+ }
75
+
76
+ export async function fetchHongKongMoneyMarkets(client: Pick<typeof apiClient, "getCloudHongKongMoneyMarkets"> = apiClient): Promise<HongKongMoneyMarketsPayload> {
77
+ try { return validateHongKongMoneyMarkets(await client.getCloudHongKongMoneyMarkets()); }
78
+ catch (error) { throw unavailableOnServer(error, "Hong Kong money markets are not available yet."); }
79
+ }
80
+
81
+ export const getCachedHongKongMoneyMarkets = () => cachedCloudResource(hongKongMoneyMarketsCache, "hkd");
82
+ export const loadHongKongMoneyMarkets = (force = false) => loadCloudResource(hongKongMoneyMarketsCache, "hkd", () => fetchHongKongMoneyMarkets(), { force });
@@ -1,20 +1,27 @@
1
1
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
2
- import { fetchMoneyMarkets } from "./client";
3
- import { moneyMarketChange, moneyMarketNotices, moneyMarketRows, moneyMarketValue } from "./model";
2
+ import type { MoneyMarketRow } from "../../../api-client/money-markets";
3
+ import { fetchHongKongMoneyMarkets, fetchMoneyMarkets } from "./client";
4
+ import { isHongKongTab, MONEY_MARKET_TABS, moneyMarketChange, moneyMarketNotices, moneyMarketRowNotices, moneyMarketRows, moneyMarketValue } from "./model";
5
+
6
+ const FRED_FRESHNESS = { source: "FRED", status: "not-a-feed", basis: "published daily and weekly data" } as const;
4
7
 
5
8
  export const moneyMarketsHeadless: HeadlessPaneDefinition<"bundle"> = {
6
9
  discovery: { aliases: ["BTMM"], dataRequirements: ["Gloom Cloud money-markets endpoint"],
7
- limitations: ["Published daily and weekly observations.", "Treasury bill discount yields.", "Net liquidity is a same-date proxy."] },
10
+ limitations: ["Published daily and weekly observations.", "Treasury bill discount yields.", "Net liquidity is a same-date proxy.",
11
+ "Hong Kong: HKMA's Exchange Fund Bill closing yields, a week or two after the day; each row is dated by its own day. HIBOR is not licensed for redistribution."] },
8
12
  shape: "bundle", argument: { kind: "none" },
9
- freshness: { source: "FRED", status: "not-a-feed", basis: "published daily and weekly data" },
10
- options: [{ key: "tab", type: "enum", description: "Money-market view.", values: [{ value: "rates" }, { value: "bills" }, { value: "liquidity" }], defaultValue: "rates" }],
11
- describe: "US money markets",
13
+ freshness: FRED_FRESHNESS,
14
+ options: [{ key: "tab", type: "enum", description: "Money-market view: US rates, bills or liquidity, or Hong Kong's Exchange Fund Bill yields.",
15
+ values: MONEY_MARKET_TABS.map(({ value }) => ({ value })), defaultValue: "rates" }],
16
+ describe: (args) => isHongKongTab(args.options.tab) ? "Hong Kong money markets" : "US money markets",
12
17
  async load(args, ctx) {
13
- const data = await fetchMoneyMarkets(ctx.apiClient);
14
- const rows = moneyMarketRows(data, String(args.options.tab));
15
- const errors = moneyMarketNotices(data);
18
+ const hongKong = isHongKongTab(args.options.tab);
19
+ const data = hongKong ? await fetchHongKongMoneyMarkets(ctx.apiClient) : await fetchMoneyMarkets(ctx.apiClient);
20
+ const rows: MoneyMarketRow[] = "billsCurve" in data ? moneyMarketRows(data, String(args.options.tab)) : data.rows;
21
+ const errors = "billsCurve" in data ? moneyMarketNotices(data) : moneyMarketRowNotices(data.rows);
16
22
  const complete = data.status === "available" && errors.length === 0;
17
- return { complete, sections: [{ title: "Observations", columns: [
23
+ return { complete, ...hongKong ? { freshness: { ...FRED_FRESHNESS, source: "HKMA", basis: "published Exchange Fund Bill closing yields" } } : {},
24
+ sections: [{ title: hongKong ? "Exchange Fund Bill yields" : "Observations", columns: [
18
25
  { key: "label", header: "Instrument" },
19
26
  { key: "value", header: "Level", align: "right", format: (value, row) => moneyMarketValue(value as number | null, row.unit as "percent" | "usd-billions") },
20
27
  { key: "change", header: "Change", align: "right", format: (value, row) => moneyMarketChange(value as number | null, row.changeUnit as "basis-points" | "usd-billions") },
@@ -23,7 +30,7 @@ export const moneyMarketsHeadless: HeadlessPaneDefinition<"bundle"> = {
23
30
  { key: "percentileValue", header: "Pctl 1Y", align: "right", stackPriority: 2, format: (value) => value == null ? "--" : Number(value).toFixed(0) },
24
31
  { key: "asOf", header: "As of", shrink: false }, { key: "status", header: "Status", stackPriority: 3 },
25
32
  ], rows: rows.map(({ history: _history, ...row }) => ({ ...row, percentileValue: row.percentile.value })) }],
26
- errors, unavailableSymbols: rows.filter((row) => row.status === "unavailable").flatMap((row) => row.sourceSeriesIds),
33
+ errors, unavailableSymbols: rows.filter((row) => row.status === "unavailable").flatMap((row) => row.sourceSeriesIds.length ? row.sourceSeriesIds : [row.label]),
27
34
  metadata: { ...data, complete, selectedTab: args.options.tab } };
28
35
  },
29
36
  };