gloomberb 0.20.6 → 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 (639) 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 +41 -7
  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 +11 -4
  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/architecture/shortcut-labels-allowlist.json +1 -0
  34. package/src/capabilities/asset-data-inputs.ts +183 -0
  35. package/src/capabilities/factories.ts +8 -2
  36. package/src/cli/base-converter.ts +36 -2
  37. package/src/cli/commands/api.ts +2 -2
  38. package/src/cli/commands/command-utils.ts +18 -0
  39. package/src/cli/commands/hong-kong-movers.ts +50 -0
  40. package/src/cli/commands/market.ts +568 -143
  41. package/src/cli/commands/options-chain.ts +7 -1
  42. package/src/cli/commands/overview.ts +74 -14
  43. package/src/cli/commands/plugins.ts +7 -6
  44. package/src/cli/commands/search.ts +71 -12
  45. package/src/cli/commands/system.ts +15 -10
  46. package/src/cli/commands/ticker.ts +97 -44
  47. package/src/cli/content-figures.ts +45 -0
  48. package/src/cli/context.ts +5 -0
  49. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  50. package/src/cli/desktop-pane-shot.ts +147 -12
  51. package/src/cli/earnings-calendar.ts +36 -5
  52. package/src/cli/export-source.ts +17 -3
  53. package/src/cli/fx-pair.ts +111 -11
  54. package/src/cli/glossary.ts +36 -2
  55. package/src/cli/help.ts +1 -1
  56. package/src/cli/history-export.ts +29 -11
  57. package/src/cli/history-rows.ts +130 -21
  58. package/src/cli/index.ts +8 -5
  59. package/src/cli/known-gaps.ts +45 -1
  60. package/src/cli/listing-arg.ts +366 -19
  61. package/src/cli/pane-functions/capabilities.ts +2 -2
  62. package/src/cli/pane-functions/catalog.ts +105 -9
  63. package/src/cli/pane-functions/discovery.ts +2 -0
  64. package/src/cli/pane-functions/dom.ts +50 -13
  65. package/src/cli/pane-functions/freshness.ts +45 -8
  66. package/src/cli/pane-functions/function-help.ts +9 -6
  67. package/src/cli/pane-functions/headless.ts +77 -6
  68. package/src/cli/pane-functions/index.ts +141 -23
  69. package/src/cli/pane-functions/options.ts +1 -3
  70. package/src/cli/pane-functions/plugin-code.ts +169 -0
  71. package/src/cli/pane-functions/report.ts +10 -0
  72. package/src/cli/pane-functions/resolver.ts +69 -21
  73. package/src/cli/pane-functions/screenshot-assessment.ts +98 -7
  74. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  75. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  76. package/src/cli/quote-answer.ts +106 -3
  77. package/src/cli/registry.ts +42 -4
  78. package/src/cli/report-tables.ts +26 -6
  79. package/src/cli/result.ts +30 -2
  80. package/src/cli/series-search.ts +17 -7
  81. package/src/cli/statement-filings.ts +22 -8
  82. package/src/cli/symbol-args.ts +9 -0
  83. package/src/cli/ticker-resolution.ts +3 -2
  84. package/src/cli/unknown-command.ts +111 -14
  85. package/src/components/chart/composite/format.ts +15 -1
  86. package/src/components/chart/composite/legend.tsx +101 -47
  87. package/src/components/chart/composite/panel-labels.ts +4 -4
  88. package/src/components/chart/composite/panel-surface.tsx +4 -6
  89. package/src/components/chart/composite/scene/build.ts +180 -0
  90. package/src/components/chart/composite/scene/cursor.ts +226 -0
  91. package/src/components/chart/composite/scene/domain.ts +170 -0
  92. package/src/components/chart/composite/scene/markers.ts +115 -0
  93. package/src/components/chart/composite/scene/panels.ts +85 -0
  94. package/src/components/chart/composite/scene/points.ts +169 -0
  95. package/src/components/chart/composite/scene/projection.ts +105 -0
  96. package/src/components/chart/composite/scene/timeline.ts +71 -0
  97. package/src/components/chart/composite/scene.ts +12 -1066
  98. package/src/components/chart/composite/types.ts +4 -2
  99. package/src/components/chart/curve/model.ts +2 -2
  100. package/src/components/chart-table/axis.ts +18 -6
  101. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  102. package/src/components/command-bar/list/model.ts +9 -0
  103. package/src/components/command-bar/pane-templates/items.ts +61 -15
  104. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  105. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  106. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  107. package/src/components/command-bar/routes/root/results.ts +6 -1
  108. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  109. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  110. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  111. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  112. package/src/components/command-bar/view-model.ts +12 -0
  113. package/src/components/command-bar/workflow/ops.ts +21 -4
  114. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  115. package/src/components/command-bar/workflow/tickers.ts +6 -2
  116. package/src/components/data-table/view.tsx +46 -1
  117. package/src/components/form-modal/confirm.tsx +3 -2
  118. package/src/components/form-modal/content.tsx +3 -2
  119. package/src/components/form-modal/field-row.tsx +2 -0
  120. package/src/components/form-modal/host.tsx +18 -3
  121. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  122. package/src/components/index.ts +1 -1
  123. package/src/components/layout/pane/title.ts +21 -5
  124. package/src/components/layout/shell/pane/layers.tsx +20 -14
  125. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  126. package/src/components/onboarding/desks-step.tsx +7 -1
  127. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  128. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  129. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  130. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  131. package/src/components/onboarding/wizard-positions.ts +2 -0
  132. package/src/components/paged-rows.ts +11 -5
  133. package/src/components/ticker/list-table-view.tsx +24 -5
  134. package/src/components/toggle-list.tsx +44 -1
  135. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  136. package/src/components/ui/data-table/opentui/model.ts +7 -3
  137. package/src/components/ui/data-table/types.ts +13 -2
  138. package/src/components/ui/fields.tsx +16 -4
  139. package/src/components/ui/query-bar.tsx +43 -9
  140. package/src/components/ui/table-layout.ts +56 -2
  141. package/src/core/app-services.ts +7 -2
  142. package/src/core/connection-health.ts +26 -0
  143. package/src/core/state/app/layout.ts +12 -4
  144. package/src/data/config/layout.ts +3 -1
  145. package/src/data/config/store/node.ts +4 -2
  146. package/src/docs/snapshot.json +794 -215
  147. package/src/i18n/es.ts +6 -1
  148. package/src/i18n/ja.ts +6 -1
  149. package/src/i18n/ko.ts +6 -1
  150. package/src/i18n/zh-cn.ts +6 -1
  151. package/src/i18n/zh-tw.ts +6 -1
  152. package/src/layout/pane-follow.ts +1 -1
  153. package/src/layout/pane-manager/gridlock.ts +18 -5
  154. package/src/layout/pane-manager/index.ts +1 -0
  155. package/src/layout/pane-manager/transient.ts +56 -0
  156. package/src/layout-marketplace/gallery.tsx +2 -1
  157. package/src/layout-marketplace/model.ts +4 -10
  158. package/src/market-data/commodity-names.ts +24 -0
  159. package/src/market-data/connection-follow.ts +9 -7
  160. package/src/market-data/coordinator/auxiliary.ts +4 -3
  161. package/src/market-data/coordinator/entries.ts +22 -1
  162. package/src/market-data/coordinator/financials.ts +2 -3
  163. package/src/market-data/coordinator/index.ts +67 -12
  164. package/src/market-data/coordinator/quotes.ts +2 -3
  165. package/src/market-data/fund-facts.ts +7 -1
  166. package/src/market-data/futures-board.ts +38 -4
  167. package/src/market-data/futures-contract.ts +5 -2
  168. package/src/market-data/fx-closes.ts +4 -1
  169. package/src/market-data/market/bar-period.ts +15 -0
  170. package/src/market-data/market/change-basis.ts +49 -8
  171. package/src/market-data/market/dated-previous-close.ts +133 -10
  172. package/src/market-data/market/format.ts +4 -2
  173. package/src/market-data/market/freshness.ts +22 -6
  174. package/src/market-data/market/status.ts +32 -4
  175. package/src/market-data/options-alternatives.ts +21 -9
  176. package/src/market-data/published-futures-sessions.ts +9 -0
  177. package/src/market-data/published-nse-sessions.ts +16 -1
  178. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  179. package/src/market-data/quotes/delisting.ts +26 -2
  180. package/src/market-data/quotes/freshness.ts +77 -0
  181. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  182. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  183. package/src/market-data/realized-volatility.ts +3 -1
  184. package/src/market-data/request-types.ts +2 -0
  185. package/src/market-data/selectors.ts +1 -0
  186. package/src/news/aggregator.ts +3 -3
  187. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  188. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  189. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  190. package/src/plugins/builtin/alerts/alert-engine.ts +15 -0
  191. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  192. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  193. package/src/plugins/builtin/alerts/cli.ts +94 -13
  194. package/src/plugins/builtin/alerts/format.ts +8 -2
  195. package/src/plugins/builtin/alerts/headless.ts +1 -1
  196. package/src/plugins/builtin/alerts/index.tsx +13 -6
  197. package/src/plugins/builtin/alerts/metric-command.ts +1 -1
  198. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  199. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  200. package/src/plugins/builtin/analytics/index.tsx +3 -3
  201. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  202. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  203. package/src/plugins/builtin/attention/pane.tsx +1 -1
  204. package/src/plugins/builtin/attention/trending.tsx +1 -1
  205. package/src/plugins/builtin/awards/detail.tsx +4 -1
  206. package/src/plugins/builtin/awards/headless.ts +7 -3
  207. package/src/plugins/builtin/awards/model.ts +11 -0
  208. package/src/plugins/builtin/awards/pane.tsx +12 -5
  209. package/src/plugins/builtin/backtest/client.ts +7 -2
  210. package/src/plugins/builtin/backtest/headless.ts +2 -1
  211. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  212. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  215. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  216. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  217. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  218. package/src/plugins/builtin/catalysts/model.ts +72 -10
  219. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  220. package/src/plugins/builtin/cds/pane.tsx +5 -3
  221. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  222. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  223. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  224. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  225. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  226. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  227. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  228. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  229. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  230. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  231. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  232. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  233. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  234. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  235. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  236. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  237. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  238. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  239. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  240. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  241. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  242. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  243. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  244. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  245. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  246. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  247. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  248. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  249. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  250. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  251. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  252. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  253. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  254. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  255. package/src/plugins/builtin/company-attention/model.ts +2 -1
  256. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  257. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  258. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  259. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  260. package/src/plugins/builtin/correlation/headless.ts +7 -5
  261. package/src/plugins/builtin/correlation/history.ts +17 -6
  262. package/src/plugins/builtin/correlation/index.tsx +1 -1
  263. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  264. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  265. package/src/plugins/builtin/cot/headless.ts +10 -3
  266. package/src/plugins/builtin/cot/pane.tsx +2 -2
  267. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  268. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  269. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  270. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  271. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  272. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  273. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  274. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  275. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  276. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  277. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  278. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  279. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  280. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  281. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  282. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  283. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  284. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  285. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  286. package/src/plugins/builtin/doe/model.ts +1 -1
  287. package/src/plugins/builtin/doe/pane.tsx +1 -1
  288. package/src/plugins/builtin/earnings/board.tsx +2 -2
  289. package/src/plugins/builtin/earnings/history.tsx +1 -1
  290. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  291. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  292. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  293. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  294. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  295. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  296. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  297. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  298. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  299. package/src/plugins/builtin/econ/index.tsx +25 -9
  300. package/src/plugins/builtin/econ/types.ts +4 -1
  301. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  302. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  303. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  304. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  305. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  306. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  307. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  308. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  309. package/src/plugins/builtin/executives/pane.tsx +2 -2
  310. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  311. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  312. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  313. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  314. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  315. package/src/plugins/builtin/futures/index.tsx +5 -4
  316. package/src/plugins/builtin/futures/model.ts +17 -9
  317. package/src/plugins/builtin/futures/returns.ts +2 -0
  318. package/src/plugins/builtin/futures/series.ts +44 -8
  319. package/src/plugins/builtin/futures/table.tsx +3 -3
  320. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  321. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  322. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  323. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  324. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  325. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  326. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  327. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  328. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  329. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  330. package/src/plugins/builtin/help/function-card.tsx +4 -2
  331. package/src/plugins/builtin/help/function-index.ts +12 -6
  332. package/src/plugins/builtin/help/index.tsx +1 -1
  333. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  334. package/src/plugins/builtin/holders/fund-holders.ts +22 -1
  335. package/src/plugins/builtin/holders/headless.ts +5 -4
  336. package/src/plugins/builtin/holders/pane.tsx +8 -4
  337. package/src/plugins/builtin/holders/report-header.ts +23 -0
  338. package/src/plugins/builtin/insider/base-values.ts +55 -0
  339. package/src/plugins/builtin/insider/headless.ts +307 -83
  340. package/src/plugins/builtin/insider/index.tsx +65 -23
  341. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  342. package/src/plugins/builtin/insider/model.ts +2 -2
  343. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  344. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  345. package/src/plugins/builtin/insider/signals.tsx +5 -3
  346. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  347. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  348. package/src/plugins/builtin/iv-history/client.ts +35 -4
  349. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  350. package/src/plugins/builtin/iv-history/model.ts +85 -16
  351. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  352. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  353. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  354. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  355. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  356. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  357. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  358. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  359. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  360. package/src/plugins/builtin/members/client.ts +24 -2
  361. package/src/plugins/builtin/members/headless.ts +68 -9
  362. package/src/plugins/builtin/members/index.tsx +7 -6
  363. package/src/plugins/builtin/members/model.ts +99 -13
  364. package/src/plugins/builtin/members/pane.tsx +72 -20
  365. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  366. package/src/plugins/builtin/mna/pane.tsx +1 -1
  367. package/src/plugins/builtin/money-markets/client.ts +43 -15
  368. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  369. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  370. package/src/plugins/builtin/money-markets/model.ts +20 -5
  371. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  372. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  373. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  374. package/src/plugins/builtin/notes/headless.ts +94 -0
  375. package/src/plugins/builtin/notes/index.tsx +3 -1
  376. package/src/plugins/builtin/notes/store.ts +10 -3
  377. package/src/plugins/builtin/options/footer.ts +8 -2
  378. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  379. package/src/plugins/builtin/options/view.tsx +10 -1
  380. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  381. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  382. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  383. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  384. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  385. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  386. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  387. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  388. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  389. package/src/plugins/builtin/perps/client.ts +54 -15
  390. package/src/plugins/builtin/perps/headless.ts +39 -13
  391. package/src/plugins/builtin/perps/index.tsx +2 -1
  392. package/src/plugins/builtin/perps/model.ts +43 -1
  393. package/src/plugins/builtin/perps/pane.tsx +35 -18
  394. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  395. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  396. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  397. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +37 -4
  398. package/src/plugins/builtin/portfolio-list/cli/render.ts +214 -46
  399. package/src/plugins/builtin/portfolio-list/headless.ts +32 -10
  400. package/src/plugins/builtin/portfolio-list/income.ts +63 -30
  401. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  402. package/src/plugins/builtin/portfolio-list/pane/data.ts +16 -6
  403. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  404. package/src/plugins/builtin/portfolio-list/pane/index.tsx +81 -13
  405. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  406. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  407. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  408. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  409. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  410. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  411. package/src/plugins/builtin/portfolio-list/use-throttled-ticker-order.ts +40 -3
  412. package/src/plugins/builtin/power/gas.tsx +2 -2
  413. package/src/plugins/builtin/power/prices.tsx +2 -2
  414. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  415. package/src/plugins/builtin/rate-path/model.ts +9 -0
  416. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  417. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  418. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  419. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  420. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  421. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  422. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  423. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  424. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  425. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  426. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  427. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  428. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  429. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  430. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  431. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  432. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  433. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  434. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  435. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  436. package/src/plugins/builtin/scanner/headless.ts +15 -1
  437. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  438. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  439. package/src/plugins/builtin/sec/fund-facts.ts +66 -6
  440. package/src/plugins/builtin/sec/headless.ts +8 -4
  441. package/src/plugins/builtin/sec/index.tsx +41 -13
  442. package/src/plugins/builtin/shared/report-freshness.ts +15 -6
  443. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  444. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  445. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  446. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  447. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  448. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  449. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  450. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  451. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  452. package/src/plugins/builtin/supply-chain/model.ts +18 -6
  453. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  454. package/src/plugins/builtin/themes/pane.tsx +4 -4
  455. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  456. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  457. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  458. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  459. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  460. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  461. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  462. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  463. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  464. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  465. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  466. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  467. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  468. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  469. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  470. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  471. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  472. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  473. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  474. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  475. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  476. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  477. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  478. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  479. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  480. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  481. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  482. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  483. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  484. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  485. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  486. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  487. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  488. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  489. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  490. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  491. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  492. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  493. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  494. package/src/plugins/builtin/volatility/headless.ts +3 -2
  495. package/src/plugins/builtin/volatility/index.tsx +1 -1
  496. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  497. package/src/plugins/builtin/volatility/series.ts +7 -3
  498. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  499. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  500. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  501. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  502. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  503. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  504. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  505. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  506. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  507. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  508. package/src/plugins/extracted-plugins.ts +14 -10
  509. package/src/plugins/installer.ts +17 -1
  510. package/src/plugins/marketplace/feed.ts +14 -0
  511. package/src/plugins/marketplace/install-offer.ts +64 -0
  512. package/src/plugins/registry/contributions.ts +46 -8
  513. package/src/plugins/registry/index.ts +5 -0
  514. package/src/portfolio/collection-name.ts +38 -4
  515. package/src/portfolio/column-values.ts +35 -4
  516. package/src/portfolio/period-pnl.ts +4 -2
  517. package/src/portfolio/valuation-basis.ts +23 -1
  518. package/src/react/async-resource.ts +24 -8
  519. package/src/remote/endpoint.ts +38 -12
  520. package/src/remote/secrets.ts +22 -6
  521. package/src/remote/server.ts +20 -4
  522. package/src/renderers/dom/data-table/index.tsx +2 -1
  523. package/src/renderers/dom/data-table/row.tsx +49 -7
  524. package/src/renderers/dom/desktop/controls.tsx +2 -0
  525. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  526. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  527. package/src/renderers/dom/styles.css +17 -0
  528. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  529. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  530. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  531. package/src/renderers/electrobun/view/host-route.ts +119 -0
  532. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  533. package/src/renderers/opentui/toast-host.tsx +6 -3
  534. package/src/renderers/opentui/ui-host.tsx +29 -5
  535. package/src/series/registry.ts +1 -0
  536. package/src/series/standalone-catalog.ts +40 -0
  537. package/src/series/types.ts +10 -0
  538. package/src/series/validate.ts +5 -0
  539. package/src/shares/portable-layout.ts +2 -7
  540. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  541. package/src/sources/gloomberb-cloud/index.ts +46 -5
  542. package/src/sources/gloomberb-cloud/news.ts +15 -9
  543. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  544. package/src/sources/history-coverage.ts +13 -0
  545. package/src/sources/history-result.ts +1 -0
  546. package/src/sources/provider-errors.ts +9 -0
  547. package/src/sources/provider-router/batches.ts +7 -3
  548. package/src/sources/provider-router/financial-routes.ts +3 -1
  549. package/src/sources/provider-router/history.ts +6 -4
  550. package/src/sources/provider-router/index.ts +5 -1
  551. package/src/sources/provider-router/primary.ts +4 -3
  552. package/src/sources/provider-router/retrieved-at.ts +12 -0
  553. package/src/state/hooks/quote-streaming.ts +14 -6
  554. package/src/team/store.ts +17 -4
  555. package/src/telemetry/crash-reports.ts +3 -1
  556. package/src/test-support/cli-context.ts +3 -2
  557. package/src/test-support/test-env.ts +7 -0
  558. package/src/theme/themes.ts +16 -9
  559. package/src/theme/tone-contrast.ts +29 -5
  560. package/src/tickers/company-name-listing.ts +31 -3
  561. package/src/tickers/company-name.ts +9 -0
  562. package/src/tickers/index-roots.ts +56 -4
  563. package/src/tickers/instrument-kind.ts +22 -1
  564. package/src/tickers/listing-name.ts +7 -2
  565. package/src/tickers/listing-venues.ts +17 -2
  566. package/src/tickers/search/home-listing.ts +2 -0
  567. package/src/tickers/search/index.ts +69 -11
  568. package/src/tickers/search/major-listings.json +595 -592
  569. package/src/tickers/search/ranking.ts +19 -1
  570. package/src/tickers/terminal-codes.ts +20 -6
  571. package/src/time-series/bar-aggregation.ts +3 -2
  572. package/src/time-series/base-series.ts +18 -1
  573. package/src/time-series/chart-data.ts +9 -6
  574. package/src/time-series/chart-seed.ts +11 -3
  575. package/src/time-series/currency-conversion.ts +1 -0
  576. package/src/time-series/date-window.ts +8 -0
  577. package/src/time-series/formula-months.ts +57 -0
  578. package/src/time-series/fundamentals/current-valuation.ts +244 -0
  579. package/src/time-series/fundamentals/historical-valuation.ts +99 -0
  580. package/src/time-series/fundamentals/metric-ids.ts +61 -0
  581. package/src/time-series/fundamentals/period-points.ts +104 -0
  582. package/src/time-series/fundamentals/quarterly-ttm.ts +220 -0
  583. package/src/time-series/fundamentals/series.ts +164 -0
  584. package/src/time-series/fundamentals/source-statements.ts +178 -0
  585. package/src/time-series/fundamentals/statement-fields.ts +154 -0
  586. package/src/time-series/fundamentals/statement-merge.ts +124 -0
  587. package/src/time-series/fundamentals/statement.ts +114 -0
  588. package/src/time-series/fundamentals/valuation-multiples.ts +50 -0
  589. package/src/time-series/fundamentals.ts +18 -1407
  590. package/src/time-series/leverage.ts +12 -4
  591. package/src/time-series/live-bars.ts +12 -7
  592. package/src/time-series/live-quotes.ts +6 -2
  593. package/src/time-series/market.ts +10 -3
  594. package/src/time-series/price-comparison.ts +106 -0
  595. package/src/time-series/range.ts +10 -0
  596. package/src/time-series/resolve-context.ts +7 -2
  597. package/src/time-series/resolve.ts +61 -5
  598. package/src/time-series/series-name.ts +2 -2
  599. package/src/time-series/series-presentation.ts +91 -2
  600. package/src/time-series/session-bar.ts +13 -7
  601. package/src/time-series/spec.ts +21 -2
  602. package/src/time-series/studies/formula.ts +262 -36
  603. package/src/time-series/studies/leverage.ts +9 -3
  604. package/src/time-series/studies/resolve.ts +7 -2
  605. package/src/time-series/types.ts +34 -0
  606. package/src/time-series/use-chart-resolution.ts +18 -1
  607. package/src/types/data-provider.ts +7 -0
  608. package/src/types/financials.ts +112 -1
  609. package/src/types/headless.ts +64 -3
  610. package/src/types/instrument.ts +6 -0
  611. package/src/types/plugin-context.ts +9 -0
  612. package/src/types/plugin-pane-templates.ts +6 -0
  613. package/src/types/plugin-panes.ts +7 -0
  614. package/src/types/price-history.ts +6 -0
  615. package/src/ui/host.tsx +3 -1
  616. package/src/ui/index.tsx +7 -2
  617. package/src/utils/cli-output.ts +21 -1
  618. package/src/utils/currency-units.ts +14 -0
  619. package/src/utils/datetime-format.ts +11 -0
  620. package/src/utils/debug-log.ts +29 -0
  621. package/src/utils/exchange-announcements.ts +26 -3
  622. package/src/utils/exchange-notation.generated.ts +3 -4
  623. package/src/utils/exchange-results.ts +144 -0
  624. package/src/utils/exchanges.ts +10 -0
  625. package/src/utils/financial-statements.ts +212 -22
  626. package/src/utils/fire-and-forget.ts +1 -1
  627. package/src/utils/fiscal-period.ts +41 -3
  628. package/src/utils/format.ts +10 -6
  629. package/src/utils/fundamentals.ts +179 -12
  630. package/src/utils/futures-generic.ts +26 -0
  631. package/src/utils/lease-liabilities.ts +15 -5
  632. package/src/utils/lookup-token.ts +22 -0
  633. package/src/utils/max-drawdown.ts +25 -4
  634. package/src/utils/price-history-integrity.ts +56 -8
  635. package/src/utils/price-history.ts +6 -2
  636. package/src/utils/price-window.ts +38 -2
  637. package/src/utils/replace-file.ts +47 -0
  638. package/src/utils/rpc-timeout-error.ts +16 -2
  639. package/src/utils/untrusted-text.ts +14 -0
@@ -20,6 +20,7 @@ import type { DatedObservation } from "../plugins/builtin/market-valuation/serie
20
20
  import type { DesktopExternalPluginBundle } from "../renderers/electrobun/shared/protocol";
21
21
  import type { HttpProxyRequestEnvelope, HttpProxyResponseEnvelope } from "../utils/http-proxy-response";
22
22
  import type { PaneAccessGate } from "./pane-functions/access-gate";
23
+ import { countContentFigures } from "./content-figures";
23
24
  import { readVisibleKeyValues } from "./visible-key-values";
24
25
  import { scrollTruncationReasons } from "./scroll-truncation";
25
26
  import {
@@ -27,8 +28,9 @@ import {
27
28
  SHOT_API_SOCKET_PATH,
28
29
  SHOT_HTTP_BRIDGE_PATH,
29
30
  SHOT_MARKET_BRIDGE_PATH,
30
- type ShotApiSocketCall,
31
+ type ShotApiSocketRead,
31
32
  type ShotApiSocketReply,
33
+ type ShotMarketSocketCall,
32
34
  } from "./desktop-pane-shot-routes";
33
35
  import { SHOT_REQUEST_REFUSED } from "../api-client/errors";
34
36
  import { SESSION_COOKIE_NAMES } from "../api-client/session-cookie";
@@ -165,6 +167,12 @@ export interface DesktopPaneShotRenderResult {
165
167
  * capture shows. Absent when every table is read from the viewport.
166
168
  */
167
169
  reportRows?: DesktopPaneShotRenderedRow[];
170
+ /**
171
+ * The rows each visible table holds, by `tableIndex`, drawn or not (the
172
+ * table's `rowCount`); null for a table that does not say. With `rows`, what
173
+ * a capture that cuts a list says it shows: "36 of 76 rows".
174
+ */
175
+ tableRowTotals?: Array<number | null>;
168
176
  /** `truncationReasons` without the cuts of tables whose every row is in `reportRows`. */
169
177
  reportTruncationReasons?: string[];
170
178
  /** Text of the pane footers, where a pane says whether its data is live, delayed or stale. */
@@ -180,8 +188,22 @@ export interface DesktopPaneShotRenderResult {
180
188
  errorStateMarkers: string[];
181
189
  emptyStateDetected: boolean;
182
190
  emptyStateMarkers: string[];
191
+ /**
192
+ * The words of the one empty or failed state a pane body shows with
193
+ * nothing else but its chrome (query bar, tabs, a table's header): its
194
+ * title, message and hint, a line each, without its buttons. Absent when
195
+ * the body shows anything more.
196
+ */
197
+ emptyStateText?: string[];
183
198
  /** A wall that needs an account, or a Pro lock on part of the pane. */
184
199
  accessGate?: PaneAccessGate | null;
200
+ /**
201
+ * The blocks of text with a figure in them that the pane's body shows
202
+ * outside its controls, chrome, notices, charts and labels
203
+ * (`countContentFigures`): what a pane that marks no rows (DIAG's prose,
204
+ * CORR's matrix) is read by. Absent in a capture that did not count them.
205
+ */
206
+ contentFigures?: number;
185
207
  semanticUi: RemoteUiNodeSnapshot[];
186
208
  /** The status line drawn in the capture's footer, as it fit the width. */
187
209
  statusLine?: string | null;
@@ -368,7 +390,7 @@ export function serveShotPage(
368
390
  },
369
391
  websocket: {
370
392
  message(socket, message) {
371
- void answerShotApiCall(String(message), apiProxy).then((reply) => socket.send(reply));
393
+ void answerShotApiCall(String(message), apiProxy, bridge).then((reply) => replyOverShotSocket(socket, reply));
372
394
  },
373
395
  },
374
396
  });
@@ -379,19 +401,39 @@ export function serveShotPage(
379
401
  }
380
402
 
381
403
  /**
382
- * One read the page sent over its API socket (`SHOT_API_SOCKET_PATH`), made
383
- * as the proxy makes it, with the session the page never holds: the reply's
384
- * JSON, its body in base64. A call that is not an API path answers why.
404
+ * Sends a call's reply to the page. A socket that drops it (Bun's send gives
405
+ * 0: the socket closed, or its buffer is past the limit) is closed, so the
406
+ * read waiting for it, and every read after it, is made over HTTP instead of
407
+ * holding the capture until it times out.
408
+ */
409
+ export function replyOverShotSocket(socket: { send(data: string): number; close(): void }, reply: string): void {
410
+ if (socket.send(reply) === 0) socket.close();
411
+ }
412
+
413
+ /**
414
+ * One call the page sent over its API socket (`SHOT_API_SOCKET_PATH`): a read
415
+ * made as the proxy makes it, with the session the page never holds, or an
416
+ * asset-data operation answered as the market bridge answers it. The reply's
417
+ * JSON, its body in base64. A call that is neither answers why.
385
418
  */
386
- export async function answerShotApiCall(message: string, apiProxy: DesktopPaneShotApiProxy): Promise<string> {
419
+ export async function answerShotApiCall(
420
+ message: string,
421
+ apiProxy: DesktopPaneShotApiProxy,
422
+ bridge: DesktopPaneShotBridge | null = null,
423
+ ): Promise<string> {
387
424
  let id = 0;
388
425
  try {
389
- const call = JSON.parse(message) as Partial<ShotApiSocketCall>;
426
+ const call = JSON.parse(message) as Partial<ShotApiSocketRead & ShotMarketSocketCall>;
390
427
  id = typeof call.id === "number" ? call.id : 0;
391
- if (typeof call.path !== "string" || !call.path.startsWith("/") || call.path.startsWith("//")) throw new Error("Not an API path.");
392
- const url = new URL(`${SHOT_API_PROXY_PREFIX}${call.path}`, "http://127.0.0.1");
393
- const sent = new Headers(Array.isArray(call.headers) ? call.headers : []);
394
- const response = await proxyShotApiRequest(new Request(url, { headers: sent }), url, apiProxy);
428
+ let response: Response;
429
+ if (call.market && typeof call.market === "object") {
430
+ response = await answerShotMarketCall(call.market, bridge);
431
+ } else {
432
+ if (typeof call.path !== "string" || !call.path.startsWith("/") || call.path.startsWith("//")) throw new Error("Not an API path.");
433
+ const url = new URL(`${SHOT_API_PROXY_PREFIX}${call.path}`, "http://127.0.0.1");
434
+ const sent = new Headers(Array.isArray(call.headers) ? call.headers : []);
435
+ response = await proxyShotApiRequest(new Request(url, { headers: sent }), url, apiProxy);
436
+ }
395
437
  const body = Buffer.from(await response.arrayBuffer()).toString("base64");
396
438
  const headers: Array<[string, string]> = [];
397
439
  response.headers.forEach((value, name) => headers.push([name, value]));
@@ -406,10 +448,24 @@ export async function answerShotApiCall(message: string, apiProxy: DesktopPaneSh
406
448
  async function runShotMarketBridge(
407
449
  request: Request,
408
450
  bridge: DesktopPaneShotBridge | null,
451
+ ): Promise<Response> {
452
+ if (!bridge) return Response.json({ ok: false, error: "No market bridge" }, { status: 404 });
453
+ let payload: { operation?: unknown; args?: unknown };
454
+ try {
455
+ payload = await request.json() as typeof payload;
456
+ } catch (error) {
457
+ return Response.json({ ok: false, error: errorMessage(error) });
458
+ }
459
+ return answerShotMarketCall(payload, bridge);
460
+ }
461
+
462
+ /** One asset-data operation run through the bridge, posted (`SHOT_MARKET_BRIDGE_PATH`) or sent over the socket. */
463
+ async function answerShotMarketCall(
464
+ payload: { operation?: unknown; args?: unknown },
465
+ bridge: DesktopPaneShotBridge | null,
409
466
  ): Promise<Response> {
410
467
  if (!bridge) return Response.json({ ok: false, error: "No market bridge" }, { status: 404 });
411
468
  try {
412
- const payload = await request.json() as { operation?: unknown; args?: unknown };
413
469
  const operation = typeof payload.operation === "string" ? payload.operation : "";
414
470
  const args = Array.isArray(payload.args) ? payload.args : [];
415
471
  const data = await bridge.marketData(operation, args);
@@ -596,6 +652,7 @@ async function capturePageScreenshot({
596
652
  await browser.open(url);
597
653
  await waitForShotReady(session);
598
654
  if (fitRows) await growToFitRows(session, { widthPx, heightPx, deviceScaleFactor, ...fitRows });
655
+ if (captureImage) await hideCutRows(session);
599
656
  const rendered = await readRenderedPaneState(session);
600
657
  if (captureImage && statusLine) {
601
658
  const line = await statusLine(rendered);
@@ -658,6 +715,52 @@ async function growToFitRows(session: CdpPage, size: {
658
715
  await waitForShotReady(session);
659
716
  }
660
717
 
718
+ /**
719
+ * An image ends on a whole row: a row its list's scroll box cuts at the
720
+ * bottom edge is hidden, and so is one wholly outside the box, which the
721
+ * box already clips but the row count would read. A row with no whole row
722
+ * above it stays, cut, rather than leave the list blank. The live pane keeps
723
+ * its partly visible last row, as every scrolling list reads.
724
+ */
725
+ async function hideCutRows(session: CdpPage): Promise<void> {
726
+ await session.send("Runtime.evaluate", {
727
+ expression: `(() => {
728
+ const root = document.getElementById("root") || document.body;
729
+ const rows = [...root.querySelectorAll(
730
+ '[data-gloom-role="data-table-row"], [data-gloom-role="data-table-section-header"], [data-gloom-role="desktop-list-row"], [data-gloom-row="true"]',
731
+ )];
732
+ const clips = (element) => {
733
+ const style = getComputedStyle(element);
734
+ return /(auto|scroll|hidden|clip)/.test(style.overflowY) && element.clientHeight > 0;
735
+ };
736
+ const wholeAbove = new Map();
737
+ const cut = [];
738
+ for (const row of rows) {
739
+ let box = row.parentElement;
740
+ while (box && box !== root && !clips(box)) box = box.parentElement;
741
+ if (!box || box === root) continue;
742
+ const area = box.getBoundingClientRect();
743
+ // The box's visible height: a horizontal scrollbar takes its own rows.
744
+ const bottom = area.top + box.clientTop + box.clientHeight;
745
+ const rect = row.getBoundingClientRect();
746
+ if (rect.height <= 0) continue;
747
+ if (rect.bottom <= area.top + 1 || rect.top >= bottom - 1) {
748
+ cut.push(row);
749
+ } else if (rect.top >= area.top - 1 && rect.bottom <= bottom + 1) {
750
+ wholeAbove.set(box, true);
751
+ } else if (rect.bottom > bottom + 1) {
752
+ cut.push({ row, box });
753
+ }
754
+ }
755
+ for (const entry of cut) {
756
+ if (entry instanceof Element) entry.style.visibility = "hidden";
757
+ else if (wholeAbove.get(entry.box)) entry.row.style.visibility = "hidden";
758
+ }
759
+ })()`,
760
+ returnByValue: true,
761
+ });
762
+ }
763
+
661
764
  const LOADING_STATE_PATTERNS = [
662
765
  /\bLoading(?: [^.]{0,80})?\.{3}/gi,
663
766
  /\bRendering pane\.{3}/gi,
@@ -858,6 +961,25 @@ async function readRenderedPaneState(session: CdpPage): Promise<DesktopPaneShotR
858
961
  // An empty sub-section off screen, such as a ticker's news list below
859
962
  // the fold, does not make the captured view empty.
860
963
  emptyStateDetected: [...root.querySelectorAll('[data-gloom-status="empty"]')].some(isVisible),
964
+ // A body that shows one empty or failed state and only its chrome
965
+ // beside it reads as the state's words, not as its filters' labels.
966
+ emptyStateText: (() => {
967
+ const body = root.querySelector('[data-gloom-role="pane-body"]') || root;
968
+ const states = [...body.querySelectorAll('[data-gloom-ui="empty-state"]')].filter(isVisible);
969
+ if (states.length !== 1) return [];
970
+ const chrome = '[data-gloom-role="query-bar"], [data-gloom-role="data-table-header-row"], [data-gloom-role="tab-list"], [data-gloom-role="page-stack-header"], [data-gloom-role="pane-footer"], [data-gloom-ui="empty-state"]';
971
+ const walker = document.createTreeWalker(body, NodeFilter.SHOW_TEXT);
972
+ for (let node = walker.nextNode(); node; node = walker.nextNode()) {
973
+ const parent = node.parentElement;
974
+ if (!normalize(node.textContent) || !parent || parent.closest(chrome) || !isVisible(parent)) continue;
975
+ return [];
976
+ }
977
+ return [...states[0].children]
978
+ .filter((child) => isVisible(child) && !child.querySelector('button, [role="button"]'))
979
+ .map((child) => normalize(child.innerText || child.textContent))
980
+ .filter(Boolean);
981
+ })(),
982
+ contentFigures: (${countContentFigures.toString()})(root, isVisible),
861
983
  // The shared sign-in wall and the Pro lock prompt every gated pane draws.
862
984
  accessGate: [...root.querySelectorAll('[data-gloom-ui="sign-in-wall"]')].some(isVisible) ? "sign-in"
863
985
  : [...root.querySelectorAll('[data-gloom-ui="pro-lock"]')].some(isVisible) ? "pro" : "",
@@ -865,6 +987,10 @@ async function readRenderedPaneState(session: CdpPage): Promise<DesktopPaneShotR
865
987
  truncated: truncationReasons.size > 0,
866
988
  truncationReasons: [...truncationReasons],
867
989
  ...(reportedTables.size > 0 ? { reportRows, reportTruncationReasons: [...reportTruncationReasons] } : {}),
990
+ tableRowTotals: visibleTables.map((_table, tableIndex) => {
991
+ const metadata = semanticTables[tableIndex] && semanticTables[tableIndex].metadata;
992
+ return metadata && typeof metadata.rowCount === "number" ? metadata.rowCount : null;
993
+ }),
868
994
  semanticUi,
869
995
  };
870
996
  })()`,
@@ -880,12 +1006,15 @@ async function readRenderedPaneState(session: CdpPage): Promise<DesktopPaneShotR
880
1006
  loadingStateDetected?: boolean;
881
1007
  errorStateDetected?: boolean;
882
1008
  emptyStateDetected?: boolean;
1009
+ emptyStateText?: string[];
1010
+ contentFigures?: number;
883
1011
  accessGate?: string;
884
1012
  rows?: DesktopPaneShotRenderedRow[];
885
1013
  truncated?: boolean;
886
1014
  truncationReasons?: string[];
887
1015
  reportRows?: DesktopPaneShotRenderedRow[];
888
1016
  reportTruncationReasons?: string[];
1017
+ tableRowTotals?: Array<number | null>;
889
1018
  semanticUi?: RemoteUiNodeSnapshot[];
890
1019
  };
891
1020
  };
@@ -922,12 +1051,18 @@ async function readRenderedPaneState(session: CdpPage): Promise<DesktopPaneShotR
922
1051
  reportRows: value.reportRows,
923
1052
  reportTruncationReasons: (value.reportTruncationReasons ?? []).filter((reason): reason is string => typeof reason === "string"),
924
1053
  } : {}),
1054
+ ...(Array.isArray(value?.tableRowTotals) && value.tableRowTotals.length > 0 ? {
1055
+ tableRowTotals: value.tableRowTotals.map((total) => typeof total === "number" && Number.isFinite(total) ? total : null),
1056
+ } : {}),
925
1057
  loadingStateDetected: value?.loadingStateDetected === true || loadingStateMarkers.length > 0,
926
1058
  errorStateDetected: value?.errorStateDetected === true || errorStateMarkers.length > 0,
927
1059
  errorStateMarkers,
928
1060
  emptyStateDetected: value?.emptyStateDetected === true || emptyStateMarkers.length > 0,
929
1061
  emptyStateMarkers,
1062
+ ...(Array.isArray(value?.emptyStateText) && value.emptyStateText.length > 0
1063
+ ? { emptyStateText: value.emptyStateText.filter((line): line is string => typeof line === "string" && line.length > 0) } : {}),
930
1064
  accessGate,
1065
+ ...(typeof value?.contentFigures === "number" ? { contentFigures: value.contentFigures } : {}),
931
1066
  semanticUi: Array.isArray(value?.semanticUi) ? value.semanticUi : [],
932
1067
  };
933
1068
  }
@@ -1,5 +1,5 @@
1
1
  import { logFailure } from "../utils/log-failure";
2
- import type { EarningsEvent } from "../types/data-provider";
2
+ import type { DataProvider, EarningsEvent } from "../types/data-provider";
3
3
  import type { EarningsDateStatus } from "../types/financials";
4
4
  import { isUsListingExchange } from "../utils/exchanges";
5
5
  import { listingChoiceNote, loadListingQuote, usLineOfListing, type CliListing, type ListingDeps, type ListingVenue } from "./listing-arg";
@@ -43,12 +43,43 @@ export async function noListingCalendarNote(
43
43
  }
44
44
 
45
45
  /**
46
- * "BG, FPI: no earnings date found." for the listings at home a calendar came
47
- * back without, each named once; null when it dated them all.
46
+ * The day a listing last reported, `YYYY-MM-DD`, from the company's quarters
47
+ * on record: the newest announcement on or before `today` with a reported
48
+ * figure. Null when none is on record or they cannot be read.
48
49
  */
49
- export function undatedListingsNote(listings: readonly Pick<CliListing, "key">[]): string | null {
50
+ export async function lastReportedDay(
51
+ provider: Pick<DataProvider, "getCorporateActions">,
52
+ listing: Pick<CliListing, "request">,
53
+ today: string,
54
+ ): Promise<string | null> {
55
+ if (!provider.getCorporateActions) return null;
56
+ const actions = await provider.getCorporateActions(listing.request.symbol, listing.request.exchange)
57
+ .catch(logFailure("cli.earnings-calendar", "Read a listing's reported quarters failed", null));
58
+ const reported = (actions?.earnings ?? [])
59
+ .filter((row) => row.dateType !== "fiscal-period-end" && row.epsActual != null && row.date.slice(0, 10) <= today)
60
+ .map((row) => row.date.slice(0, 10))
61
+ .sort();
62
+ return reported.at(-1) ?? null;
63
+ }
64
+
65
+ /**
66
+ * The listings at home a calendar came back without, each named once, with
67
+ * when each last reported: "KO: no upcoming earnings date found; last
68
+ * reported 2026-10-27." Those with no report on record share one line ("BG,
69
+ * FPI: no earnings date found."). Null when the calendar dated them all.
70
+ */
71
+ export function undatedListingsNote(
72
+ listings: readonly Pick<CliListing, "key">[],
73
+ lastReported: ReadonlyMap<string, string | null> = new Map(),
74
+ ): string | null {
50
75
  const keys = [...new Set(listings.map((listing) => listing.key))];
51
- return keys.length > 0 ? `${keys.join(", ")}: no earnings date found.` : null;
76
+ const reported = keys.filter((key) => lastReported.get(key));
77
+ const unknown = keys.filter((key) => !lastReported.get(key));
78
+ const lines = [
79
+ ...reported.map((key) => `${key}: no upcoming earnings date found; last reported ${lastReported.get(key)}.`),
80
+ ...unknown.length > 0 ? [`${unknown.join(", ")}: no earnings date found.`] : [],
81
+ ];
82
+ return lines.length > 0 ? lines.join("\n") : null;
52
83
  }
53
84
 
54
85
  /**
@@ -2,9 +2,10 @@
2
2
  * Where exported data comes from, said the same way by every command that
3
3
  * writes CSV or JSON, so an export can go in an audit file as it is: CSV ends
4
4
  * with `#` lines and JSON carries a `source` object with the same fields.
5
- * CSV and NDJSON rows also end with five fixed columns naming what each row
6
- * is (`EXPORT_IDENTITY_COLUMNS`), less any the table already has by name; a
7
- * dated export adds `period`, `released` and `retrieved` after them.
5
+ * CSV and NDJSON rows also end with five columns naming what each row is
6
+ * (`EXPORT_IDENTITY_COLUMNS`), less any the table already has by name, then
7
+ * `retrieved_at`; a dated export adds `period`, `released` and `retrieved`
8
+ * after the five instead. Columns a report adds later follow them all.
8
9
  */
9
10
  import { formatFreshnessLine, type ReportFreshness } from "./pane-functions/freshness";
10
11
  import { parseReportTime } from "../utils/utc-time";
@@ -63,6 +64,19 @@ export const EXPORT_IDENTITY_COLUMNS = ["symbol_or_series", "currency_or_unit",
63
64
  */
64
65
  export const EXPORT_DATING_COLUMNS = ["period", "released", "retrieved"] as const;
65
66
 
67
+ /**
68
+ * The column an undated export ends with after the five: when this export
69
+ * retrieved the data, an ISO instant in UTC, so a row copied away from the
70
+ * closing lines still says when it was fetched. A dated export says it in
71
+ * `retrieved`.
72
+ */
73
+ export const EXPORT_RETRIEVAL_COLUMN = "retrieved_at";
74
+
75
+ /** The `retrieved_at` cell: the retrieval time the closing lines give. */
76
+ export function exportRetrievalCell(freshness: ReportFreshness): string {
77
+ return exportSource(freshness).retrievalTime;
78
+ }
79
+
66
80
  /** What a command knows about the rows it exports; source and as-of come from its freshness. */
67
81
  export interface ExportIdentity {
68
82
  /** The symbol or series ID asked for: `USDZAR=X`, `SAN:EPA`, `DEXSFUS`. */
@@ -16,10 +16,38 @@ export interface FxRequest {
16
16
  baseCurrency: string;
17
17
  /** Each currency typed as its name (`yen`) and the code it was read as, said beside the answer. */
18
18
  readAs?: string[];
19
+ /**
20
+ * A side typed as a minor unit (ZAc, GBp, GBX, ILA): `currency` and
21
+ * `baseCurrency` are then its major currency, whose rate is read, and the
22
+ * unit is converted at its fixed fraction of it (100 ZAc is R1.00).
23
+ */
24
+ units?: { currency?: FxSubUnit; baseCurrency?: FxSubUnit };
25
+ }
26
+
27
+ /** A minor unit typed for a side of `fx`: its code as quotes write it (ZAc, GBp, ILA), and how many make one of the major currency. */
28
+ interface FxSubUnit {
29
+ code: string;
30
+ divisor: number;
19
31
  }
20
32
 
21
33
  const CURRENCY_CODE = /^[A-Z]{3}$/;
22
34
 
35
+ /**
36
+ * The minor units quotes are priced in, by the code as typed: pence (GBp,
37
+ * GBX), South African cents (ZAc) and agorot (ILA). GBp is read in its own
38
+ * case, as GBP and gbp are pounds; the others are no ISO code, so any case is
39
+ * the unit, never upper-cased into a currency of their own.
40
+ */
41
+ export function fxSubUnit(typed: string): (FxSubUnit & { currency: string }) | null {
42
+ const text = typed.trim();
43
+ if (text === "GBp") return { code: "GBp", currency: "GBP", divisor: 100 };
44
+ const upper = text.toUpperCase();
45
+ if (upper === "GBX") return { code: "GBX", currency: "GBP", divisor: 100 };
46
+ if (upper === "ZAC") return { code: "ZAc", currency: "ZAR", divisor: 100 };
47
+ if (upper === "ILA") return { code: "ILA", currency: "ILS", divisor: 100 };
48
+ return null;
49
+ }
50
+
23
51
  let knownCurrencies: ReadonlySet<string> | undefined;
24
52
 
25
53
  /** An ISO 4217 code the runtime lists, or the offshore yuan it has none for. */
@@ -59,24 +87,44 @@ function spelledPair(text: string): FxRequest | null {
59
87
  return match ? { currency: match[1]!, baseCurrency: match[2]! } : null;
60
88
  }
61
89
 
90
+ /**
91
+ * A pair with a minor unit for a side, spelled without its slash: GBp-USD,
92
+ * GBpUSD, ZACUSD, USD-ILA. Its two sides as typed, so the unit keeps its
93
+ * own case (GBp is pence, GBP pounds); null for anything else, which
94
+ * `spelledPair` reads.
95
+ */
96
+ function unitPairSides(typed: string): [string, string] | null {
97
+ const match = /^([A-Za-z]{3})[-_ ]?([A-Za-z]{3})$/.exec(typed.trim());
98
+ return match && (fxSubUnit(match[1]!) || fxSubUnit(match[2]!)) ? [match[1]!, match[2]!] : null;
99
+ }
100
+
62
101
  /** Whether `fx` reads the argument as a pair spelled without its slash (`spelledPair`). */
63
102
  function isSpelledFxPair(raw: string): boolean {
64
- return spelledPair(raw.trim().toUpperCase()) != null;
103
+ return unitPairSides(raw) != null || spelledPair(raw.trim().toUpperCase()) != null;
65
104
  }
66
105
 
67
106
  /** The request, or the sentence saying what is wrong with the argument. */
68
107
  export function parseFxRequest(raw: string, baseCurrency: string): FxRequest | { error: string } {
69
- const typed = raw.trim().split("/").map((part) => part.trim());
70
- const text = raw.trim().toUpperCase();
108
+ // A side typed as a minor unit is read as one however the pair is spelled (GBp-USD, GBpUSD), before `spelledPair` upper-cases it.
109
+ const typed = unitPairSides(raw) ?? raw.trim().split("/").map((part) => part.trim());
110
+ const text = typed.join("/").toUpperCase();
71
111
  const parts = typed.map((part) => part.toUpperCase());
72
112
  if (parts.length > 2 || parts.some((part) => !part)) return { error: `"${raw}" is not a currency or a pair such as USD/NGN.` };
73
113
  // The pair spellings `quote` takes: EURUSD, eur-usd, EURUSD=X.
74
114
  const spelled = parts.length === 1 ? spelledPair(text) : null;
75
115
  if (spelled) return spelled;
116
+ // A minor unit (ZAc, GBp, ILA) is a fraction of its major currency, whose rate converts it.
117
+ const units: NonNullable<FxRequest["units"]> = {};
118
+ for (const [index, part] of typed.entries()) {
119
+ const unit = fxSubUnit(part);
120
+ if (!unit) continue;
121
+ units[parts.length === 2 && index === 1 ? "baseCurrency" : "currency"] = { code: unit.code, divisor: unit.divisor };
122
+ parts[index] = unit.currency;
123
+ }
76
124
  // A name (peso, yen, Swiss franc) is a currency's code. Three letters that are a code stay one: only a name that is no code reads as one.
77
125
  const readAs: string[] = [];
78
126
  for (const [index, part] of parts.entries()) {
79
- if (isKnownCurrency(part)) continue;
127
+ if (isKnownCurrency(part) || fxSubUnit(typed[index]!)) continue;
80
128
  const named = readCurrencyName(typed[index]!, (code) => parts.map((other, at) => at === index ? code : other).join("/"));
81
129
  if (!named) continue;
82
130
  if ("error" in named) return named;
@@ -85,10 +133,24 @@ export function parseFxRequest(raw: string, baseCurrency: string): FxRequest | {
85
133
  }
86
134
  const bad = parts.filter((part) => !CURRENCY_CODE.test(part));
87
135
  if (bad.length > 0) return { error: `${bad.join(" and ")} ${bad.length > 1 ? "are not currency codes" : "is not a currency code"}; use three letters such as NGN.` };
88
- const request = parts.length === 2
136
+ const request: FxRequest = parts.length === 2
89
137
  ? { currency: parts[0]!, baseCurrency: parts[1]! }
90
138
  : { currency: parts[0]!, baseCurrency: baseCurrency.trim().toUpperCase() };
91
- return readAs.length > 0 ? { ...request, readAs } : request;
139
+ return { ...request, ...readAs.length > 0 ? { readAs } : {}, ...units.currency || units.baseCurrency ? { units } : {} };
140
+ }
141
+
142
+ /** The code a side of the request is written in: its minor unit's (ZAc) where one was typed, else its currency's. */
143
+ export function fxSideCode(request: FxRequest, side: "currency" | "baseCurrency"): string {
144
+ return request.units?.[side]?.code ?? request[side];
145
+ }
146
+
147
+ /**
148
+ * The rate of one unit of the request's first side in its second, as typed:
149
+ * the major currencies' `rate` with each minor unit's fraction applied (1 ZAc
150
+ * is a hundredth of 1 ZAR's rate). The rate itself when no unit was typed.
151
+ */
152
+ export function fxUnitRate(request: FxRequest, rate: number): number {
153
+ return rate * (request.units?.baseCurrency?.divisor ?? 1) / (request.units?.currency?.divisor ?? 1);
92
154
  }
93
155
 
94
156
  /** What `gloom fx` is asked for, with the amount to convert when one comes first. */
@@ -117,11 +179,13 @@ function joinNameWords(args: readonly string[]): readonly string[] {
117
179
  * `1.234,5` and `1,234.5` are 1234.5. A lone comma or dot before exactly three
118
180
  * digits (`1,234`, `1.234`) is refused naming both readings, as `alerts add`
119
181
  * refuses `1,234`.
120
- * An amount and one currency converts to USD (`toUsdByDefault`). The error
121
- * sentence otherwise.
182
+ * An amount and one currency converts to USD (`toUsdByDefault`). An amount
183
+ * may carry a K, M or B suffix (`959.81M USD/EUR`). The error sentence
184
+ * otherwise.
122
185
  */
123
186
  export function parseFxArgs(words: readonly string[], baseCurrency: string): FxArgs | { error: string } {
124
- const args = joinNameWords(words);
187
+ const scaled = words.length > 1 ? amountScale(words[0]) : null;
188
+ const args = joinNameWords(scaled ? [scaled.number, ...words.slice(1)] : words);
125
189
  if (args.length === 1) {
126
190
  const request = parseFxRequest(args[0]!, baseCurrency);
127
191
  if (!("error" in request)) return { request };
@@ -154,9 +218,23 @@ export function parseFxArgs(words: readonly string[], baseCurrency: string): FxA
154
218
  } catch (error) {
155
219
  return { error: error instanceof Error ? error.message : String(error) };
156
220
  }
221
+ if (scaled) amount = Number((amount * scaled.factor).toPrecision(15));
157
222
  return { request, amount, ...(toUsdByDefault ? { toUsdByDefault } : {}) };
158
223
  }
159
224
 
225
+ const AMOUNT_SCALES: Record<string, number> = { k: 1e3, m: 1e6, b: 1e9 };
226
+
227
+ /**
228
+ * An amount written with a thousands, millions or billions suffix, as reports
229
+ * print them (`959.81M`, `25k`, `1.2B`): the number before it and what it
230
+ * multiplies by. Null for any other word.
231
+ */
232
+ function amountScale(word: string | undefined): { number: string; factor: number } | null {
233
+ const match = /^(.*\d)\s?([kKmMbB])$/.exec(word?.trim() ?? "");
234
+ if (!match || parseTypedNumber(match[1]).kind === "invalid") return null;
235
+ return { number: match[1]!, factor: AMOUNT_SCALES[match[2]!.toLowerCase()]! };
236
+ }
237
+
160
238
  /**
161
239
  * An amount in its currency's minor units, grouped (1,234.50 EUR; 1,235 JPY).
162
240
  * One too small for them keeps six significant figures instead of reading 0.
@@ -169,9 +247,31 @@ export function formatFxAmount(amount: number, currency: string): string {
169
247
  return `${text} ${currency}`;
170
248
  }
171
249
 
172
- /** `1,234.50 EUR = 1,383.47 USD`: the amount and what it converts to at the rate. */
250
+ /**
251
+ * `1,234.50 EUR = 1,383.47 USD`: the amount and what it converts to at the
252
+ * rate, which is of the major currencies. A side typed as a minor unit names
253
+ * the major amount it is beside it, the conversion's step: `100.00 ZAc =
254
+ * R1.00 = 0.06 USD`, `1.00 USD = £0.75 = 75.09 GBp`.
255
+ */
173
256
  export function describeFxConversion(request: FxRequest, amount: number, rate: number): string {
174
- return `${formatFxAmount(amount, request.currency)} = ${formatFxAmount(amount * rate, request.baseCurrency)}`;
257
+ const from = request.units?.currency, into = request.units?.baseCurrency;
258
+ const major = amount / (from?.divisor ?? 1);
259
+ return [
260
+ formatFxAmount(amount, fxSideCode(request, "currency")),
261
+ ...from ? [formatMajorAmount(major, request.currency)] : [],
262
+ ...into ? [formatMajorAmount(major * rate, request.baseCurrency)] : [],
263
+ formatFxAmount(fxUnitRate(request, rate) * amount, fxSideCode(request, "baseCurrency")),
264
+ ].join(" = ");
265
+ }
266
+
267
+ /** A major currency's amount written with its sign, as its minor unit's conversion step shows it: R1.00, £0.75, ₪1.00. */
268
+ function formatMajorAmount(amount: number, currency: string): string {
269
+ try {
270
+ // R1.00, never the space Intl puts after a letter sign.
271
+ return new Intl.NumberFormat("en-US", { style: "currency", currency, currencyDisplay: "narrowSymbol" }).format(amount).replace(/(\p{L})\s(?=\d)/u, "$1");
272
+ } catch {
273
+ return formatFxAmount(amount, currency);
274
+ }
175
275
  }
176
276
 
177
277
  /**
@@ -256,7 +256,7 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
256
256
  definition: "The date of the latest change: the decision it came from, or, where no decision is on record, the first date the new rate level appears in the data. The last decision under each row is the bank's latest meeting, a hold included.",
257
257
  },
258
258
  {
259
- term: "Pctl 1Y", aliases: ["percentile", "1y percentile", "1-year percentile", "pctl"], functions: ["BTMM", "WIRP", "CBR", "CDX", "SOVR", "COT"],
259
+ term: "Pctl 1Y", aliases: ["percentile", "1y percentile", "1-year percentile", "pctl"], functions: ["BTMM", "WIRP", "CBR", "CDX", "SOVR", "COT", "CTM"],
260
260
  definition: "Where today's value ranks against the past year of the same series: 100 is the highest, 0 the lowest.",
261
261
  },
262
262
  {
@@ -403,6 +403,14 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
403
403
  + "the line above the table gives its as-of date. Supply 7D and Supply 30D are its change over those days, in dollars and in percent; "
404
404
  + "supply grows as coins are issued and shrinks as they are redeemed.",
405
405
  },
406
+ // DeFi (CRYP --list defi, fn G CAP:crypto:defi-tvl).
407
+ {
408
+ term: "Total value locked", short: "TVL", aliases: ["defi tvl", "value locked", "locked value", "total defi tvl"], functions: ["CRYP"],
409
+ shown: ["TVL", "TVL USD", "Total DeFi TVL"],
410
+ definition: "The dollar value of the tokens held in DeFi protocols' contracts (lending, exchange and yield pools) at the day's prices, "
411
+ + "as DefiLlama counts it. Each deposit counts once: re-deposited receipt or LP tokens, liquid staking, bridges and borrowed amounts "
412
+ + "are left out, so it is less than the protocols listed added up. Each day is that UTC day's close.",
413
+ },
406
414
  {
407
415
  term: "Share", aliases: ["supply share", "share of supply", "tvl share"], functions: ["CRYP"],
408
416
  definition: "A stablecoin's part of all stablecoin supply, in percent, on the same previous-day series as Supply. "
@@ -498,6 +506,16 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
498
506
  definition: "How loosely a fund follows its index: how much the gap between the fund's return and the index's swings, usually over a year. "
499
507
  + "Fees, cash and holdings that differ from the index widen it.",
500
508
  },
509
+ {
510
+ term: "Leveraged and inverse ETFs", aliases: ["leveraged", "inverse", "decay", "daily reset", "3x", "2x", "-1x", "-3x",
511
+ "leveraged etf", "leveraged etfs", "inverse etf", "inverse etfs", "leveraged fund", "inverse fund", "leverage decay", "volatility decay"],
512
+ functions: ["ETF", "CMP"], shownBy: { ETF: ["Objective"], CMP: ["decay"] },
513
+ definition: "A fund that seeks a multiple of its index's return each day: 2× or 3× (TQQQ, three times the Nasdaq-100), or -1× to -3× for an inverse "
514
+ + "fund (SQQQ). It resets every day, so over weeks it compounds away from that multiple: in a market that swings it falls short (decay), in a "
515
+ + "steady trend it can beat it. ETF shows the objective. CMP draws the daily line from the index fund (3× daily QQQ beside TQQQ) and two decay "
516
+ + "rows in percentage points: the fund against that line (fees, financing), and the line against the multiple of the index's return over "
517
+ + "the period (compounding).",
518
+ },
501
519
  // A depositary receipt beside its home listing (ADR, DES), and the peso's market dollar rates `fx USD/ARS` lists.
502
520
  {
503
521
  term: "ADR ratio", aliases: ["adr", "adrs", "depositary receipt", "american depositary receipt", "depositary ratio", "ads ratio"],
@@ -813,7 +831,9 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
813
831
  + "It splits large traders into dealers, asset managers, leveraged funds and other reportables.",
814
832
  },
815
833
  {
816
- term: "Leveraged funds", aliases: ["leveraged fund", "leveraged money", "lev funds"], functions: ["COT"], shown: ["Leveraged Funds"],
834
+ // Named for its report: the leveraged ETFs are "Leveraged and inverse ETFs".
835
+ term: "Leveraged funds (COT)", aliases: ["leveraged funds", "leveraged money", "lev funds", "tff leveraged funds"], functions: ["COT"],
836
+ shown: ["Leveraged Funds"],
817
837
  definition: "The TFF report's hedge funds, CTAs and other money managers trading for clients or with borrowed money: the speculators most watched in rates, currencies and indexes.",
818
838
  },
819
839
  {
@@ -867,6 +887,13 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
867
887
  + "less 1, scaled to a year: (front / next - 1) × 365 / days between the two. It is positive in backwardation and negative in contango.",
868
888
  },
869
889
  // The VIX curve and the volatility board (VIX, VOLS): spot indices, not futures.
890
+ {
891
+ term: "Variance swap", aliases: ["variance swaps", "var swap", "variance strike", "variance swap strike", "variance-swap strike"],
892
+ functions: ["VIX", "CTM"],
893
+ definition: "A swap that pays the difference between the variance an index realizes over its term and a strike fixed at the start. VIX is the square root "
894
+ + "of the 30-day S&P 500 variance-swap strike that SPX options imply, in volatility points: a VIX of 25 is a 30-day variance strike of 25² = 625, "
895
+ + "25% a year. Variance swaps trade between dealers and their strikes are not published; CTM VX shows where VIX futures price that 30-day figure at each expiry.",
896
+ },
870
897
  {
871
898
  term: "Term structure", aliases: ["volatility term structure", "VIX term structure", "VIX curve", "tenor curve", "tenors"],
872
899
  functions: ["VIX", "VOLS"], shown: ["Tenor", "tenor curve"],
@@ -915,6 +942,13 @@ export const GLOSSARY: readonly GlossaryEntry[] = [
915
942
  definition: "The 25-delta call's implied volatility minus the 25-delta put's, in vol points, for one expiry. Negative means puts cost more than calls "
916
943
  + "as far from the forward (downside protection is bid), positive that upside calls are. OVDV, VCA and HIVG's rr25d all sign it call minus put.",
917
944
  },
945
+ {
946
+ term: "25-delta implied volatility", aliases: ["25d put iv", "25d call iv", "25-delta put iv", "25 delta put iv", "25d put", "25d call", "25 delta iv"],
947
+ functions: ["OVDV"], shown: ["25D put IV", "25D call IV"],
948
+ definition: "The implied volatility of the put whose Black-Scholes spot delta is -0.25 (the call's +0.25) for one expiry, with the carry the "
949
+ + "expiry's parity forward implies and no premium adjustment. The strike is found on the fitted smile, at the volatility the smile gives "
950
+ + "there, only between the lowest and highest quoted strikes: an expiry whose quotes stop short of it shows none rather than an extrapolation.",
951
+ },
918
952
  {
919
953
  term: "Butterfly", short: "BF", aliases: ["25d butterfly", "25-delta butterfly", "25 delta butterfly", "bf25", "smile curvature", "fly"],
920
954
  functions: ["OVDV"], shown: ["BF"],
package/src/cli/help.ts CHANGED
@@ -45,7 +45,7 @@ const START_HERE: Array<[string, string]> = [
45
45
 
46
46
  const GLOBAL_OPTIONS: Array<[string, string]> = [
47
47
  ["--json", "Print the full result as JSON"],
48
- ["--csv", "Print rows as CSV under the columns the text shows; fn reports and fundamentals put each table under # section: and end with # source lines"],
48
+ ["--csv", "Print rows as CSV under the columns the text shows; each row ends with what it is, its source, as_of and retrieved_at (when it was read), then any columns a report adds (a formula's leg contracts, a board's Group), and fn reports and fundamentals put each table under # section:. The closing source and note lines go to stderr, not into the rows or an --output file"],
49
49
  ["--ndjson", "Print one JSON object per table row"],
50
50
  ["--output <path>, --out <path>", "Write a --csv, --json or --ndjson export to this file in UTF-8, and print where it went (a redirect is UTF-16 in Windows PowerShell 5.1)"],
51
51
  ["--limit <n>", "Show at most n rows, the first n as printed"],