gloomberb 0.20.7 → 0.20.9

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 (632) 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 +19 -2
  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 +76 -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/data.ts +3 -2
  63. package/src/cli/pane-functions/discovery.ts +2 -0
  64. package/src/cli/pane-functions/dom.ts +46 -9
  65. package/src/cli/pane-functions/freshness.ts +7 -3
  66. package/src/cli/pane-functions/function-help.ts +9 -6
  67. package/src/cli/pane-functions/headless.ts +78 -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 +82 -3
  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 +49 -2
  77. package/src/cli/registry.ts +42 -4
  78. package/src/cli/report-tables.ts +26 -6
  79. package/src/cli/result.ts +13 -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/symbol-cells.ts +6 -0
  84. package/src/cli/symbol-list.ts +14 -6
  85. package/src/cli/symbol-rows.ts +12 -5
  86. package/src/cli/ticker-resolution.ts +3 -2
  87. package/src/cli/unknown-command.ts +111 -14
  88. package/src/components/chart/composite/format.ts +15 -1
  89. package/src/components/chart/composite/legend.tsx +101 -47
  90. package/src/components/chart/composite/panel-labels.ts +4 -4
  91. package/src/components/chart/composite/panel-surface.tsx +4 -6
  92. package/src/components/chart/composite/scene/build.ts +180 -0
  93. package/src/components/chart/composite/scene/cursor.ts +226 -0
  94. package/src/components/chart/composite/scene/domain.ts +170 -0
  95. package/src/components/chart/composite/scene/markers.ts +115 -0
  96. package/src/components/chart/composite/scene/panels.ts +85 -0
  97. package/src/components/chart/composite/scene/points.ts +169 -0
  98. package/src/components/chart/composite/scene/projection.ts +105 -0
  99. package/src/components/chart/composite/scene/timeline.ts +71 -0
  100. package/src/components/chart/composite/scene.ts +12 -1066
  101. package/src/components/chart/composite/types.ts +4 -2
  102. package/src/components/chart/curve/model.ts +2 -2
  103. package/src/components/chart-table/axis.ts +18 -6
  104. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  105. package/src/components/command-bar/list/model.ts +9 -0
  106. package/src/components/command-bar/pane-templates/items.ts +61 -15
  107. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  108. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  109. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  110. package/src/components/command-bar/routes/root/results.ts +6 -1
  111. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  112. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  113. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  114. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  115. package/src/components/command-bar/view-model.ts +12 -0
  116. package/src/components/command-bar/workflow/ops.ts +21 -4
  117. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  118. package/src/components/command-bar/workflow/tickers.ts +6 -2
  119. package/src/components/data-table/view.tsx +46 -1
  120. package/src/components/form-modal/confirm.tsx +3 -2
  121. package/src/components/form-modal/content.tsx +3 -2
  122. package/src/components/form-modal/field-row.tsx +2 -0
  123. package/src/components/form-modal/host.tsx +18 -3
  124. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  125. package/src/components/index.ts +1 -1
  126. package/src/components/layout/pane/title.ts +21 -5
  127. package/src/components/layout/shell/pane/layers.tsx +20 -14
  128. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  129. package/src/components/onboarding/desks-step.tsx +7 -1
  130. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  131. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  132. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  133. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  134. package/src/components/onboarding/wizard-positions.ts +2 -0
  135. package/src/components/paged-rows.ts +11 -5
  136. package/src/components/ticker/list-table-view.tsx +24 -5
  137. package/src/components/toggle-list.tsx +44 -1
  138. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  139. package/src/components/ui/data-table/opentui/model.ts +7 -3
  140. package/src/components/ui/data-table/types.ts +13 -2
  141. package/src/components/ui/fields.tsx +16 -4
  142. package/src/components/ui/page-stack-view.tsx +24 -6
  143. package/src/components/ui/query-bar.tsx +43 -9
  144. package/src/components/ui/table-layout.ts +56 -2
  145. package/src/core/app-services.ts +7 -2
  146. package/src/core/connection-health.ts +26 -0
  147. package/src/core/state/app/layout.ts +12 -4
  148. package/src/data/config/layout.ts +3 -1
  149. package/src/data/config/store/node.ts +4 -2
  150. package/src/docs/snapshot.json +756 -216
  151. package/src/i18n/es.ts +4 -1
  152. package/src/i18n/ja.ts +4 -1
  153. package/src/i18n/ko.ts +4 -1
  154. package/src/i18n/zh-cn.ts +4 -1
  155. package/src/i18n/zh-tw.ts +4 -1
  156. package/src/layout/pane-follow.ts +1 -1
  157. package/src/layout/pane-manager/gridlock.ts +18 -5
  158. package/src/layout/pane-manager/index.ts +1 -0
  159. package/src/layout/pane-manager/transient.ts +56 -0
  160. package/src/layout-marketplace/gallery.tsx +2 -1
  161. package/src/layout-marketplace/model.ts +4 -10
  162. package/src/market-data/commodity-names.ts +24 -0
  163. package/src/market-data/connection-follow.ts +9 -7
  164. package/src/market-data/coordinator/auxiliary.ts +4 -3
  165. package/src/market-data/coordinator/entries.ts +22 -1
  166. package/src/market-data/coordinator/financials.ts +2 -3
  167. package/src/market-data/coordinator/index.ts +67 -12
  168. package/src/market-data/coordinator/quotes.ts +2 -3
  169. package/src/market-data/fund-facts.ts +7 -1
  170. package/src/market-data/futures-board.ts +38 -4
  171. package/src/market-data/futures-contract.ts +5 -2
  172. package/src/market-data/futures-roll-returns.ts +226 -0
  173. package/src/market-data/fx-closes.ts +4 -1
  174. package/src/market-data/market/bar-period.ts +15 -0
  175. package/src/market-data/market/format.ts +4 -2
  176. package/src/market-data/market/freshness.ts +4 -0
  177. package/src/market-data/market/session-close-note.ts +41 -4
  178. package/src/market-data/market/status.ts +23 -3
  179. package/src/market-data/options-alternatives.ts +21 -9
  180. package/src/market-data/published-futures-sessions.ts +9 -0
  181. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  182. package/src/market-data/quotes/delisting.ts +26 -2
  183. package/src/market-data/quotes/freshness.ts +62 -0
  184. package/src/market-data/quotes/listing-enterprise-value.ts +254 -19
  185. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  186. package/src/market-data/realized-volatility.ts +3 -1
  187. package/src/market-data/request-types.ts +2 -0
  188. package/src/market-data/selectors.ts +1 -0
  189. package/src/news/aggregator.ts +3 -3
  190. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  191. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  192. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  193. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  194. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  195. package/src/plugins/builtin/alerts/cli.ts +72 -4
  196. package/src/plugins/builtin/alerts/format.ts +8 -2
  197. package/src/plugins/builtin/alerts/index.tsx +8 -5
  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 +16 -4
  210. package/src/plugins/builtin/backtest/headless.ts +2 -1
  211. package/src/plugins/builtin/backtest/pane.tsx +5 -3
  212. package/src/plugins/builtin/backtest/report.ts +22 -6
  213. package/src/plugins/builtin/backtest/window.ts +17 -9
  214. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  215. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  216. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  217. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  218. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  219. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  220. package/src/plugins/builtin/catalysts/model.ts +72 -10
  221. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  222. package/src/plugins/builtin/cds/pane.tsx +5 -3
  223. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  224. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  225. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  226. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  227. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  228. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  229. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  230. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  231. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  232. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  233. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  234. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  235. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  236. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  237. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  238. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  239. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  240. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  241. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  242. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  243. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  244. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  245. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  246. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  247. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  248. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  249. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  250. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  251. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  252. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  253. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  254. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  255. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  256. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  257. package/src/plugins/builtin/company-attention/model.ts +2 -1
  258. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  259. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  260. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  261. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  262. package/src/plugins/builtin/correlation/headless.ts +13 -7
  263. package/src/plugins/builtin/correlation/history.ts +17 -6
  264. package/src/plugins/builtin/correlation/index.tsx +8 -4
  265. package/src/plugins/builtin/correlation/matrix/model.ts +15 -1
  266. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  267. package/src/plugins/builtin/correlation/relationship/model.ts +15 -1
  268. package/src/plugins/builtin/correlation/relationship/pane.tsx +5 -3
  269. package/src/plugins/builtin/cot/headless.ts +10 -3
  270. package/src/plugins/builtin/cot/pane.tsx +2 -2
  271. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  272. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  273. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  274. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  275. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  276. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  277. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  278. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  279. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  280. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  281. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  282. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  283. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  284. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  285. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  286. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  287. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  288. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  289. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  290. package/src/plugins/builtin/doe/model.ts +1 -1
  291. package/src/plugins/builtin/doe/pane.tsx +1 -1
  292. package/src/plugins/builtin/earnings/board.tsx +2 -2
  293. package/src/plugins/builtin/earnings/history.tsx +1 -1
  294. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  295. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  296. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  297. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  298. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  299. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  300. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  301. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  302. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  303. package/src/plugins/builtin/econ/index.tsx +25 -9
  304. package/src/plugins/builtin/econ/types.ts +4 -1
  305. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  306. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  307. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  308. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  309. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  310. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  311. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  312. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  313. package/src/plugins/builtin/executives/pane.tsx +2 -2
  314. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  315. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  316. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  317. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  318. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  319. package/src/plugins/builtin/futures/index.tsx +5 -4
  320. package/src/plugins/builtin/futures/model.ts +17 -9
  321. package/src/plugins/builtin/futures/returns.ts +2 -0
  322. package/src/plugins/builtin/futures/series.ts +44 -8
  323. package/src/plugins/builtin/futures/table.tsx +3 -3
  324. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  325. package/src/plugins/builtin/futures-curve/headless.ts +17 -12
  326. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  327. package/src/plugins/builtin/futures-curve/model.ts +117 -7
  328. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  329. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  330. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  331. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  332. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  333. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  334. package/src/plugins/builtin/help/function-card.tsx +4 -2
  335. package/src/plugins/builtin/help/function-index.ts +12 -6
  336. package/src/plugins/builtin/help/index.tsx +1 -1
  337. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  338. package/src/plugins/builtin/holders/pane.tsx +1 -1
  339. package/src/plugins/builtin/insider/base-values.ts +55 -0
  340. package/src/plugins/builtin/insider/headless.ts +307 -83
  341. package/src/plugins/builtin/insider/index.tsx +65 -23
  342. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  343. package/src/plugins/builtin/insider/model.ts +2 -2
  344. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  345. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  346. package/src/plugins/builtin/insider/signals.tsx +5 -3
  347. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  348. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  349. package/src/plugins/builtin/iv-history/client.ts +35 -4
  350. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  351. package/src/plugins/builtin/iv-history/model.ts +85 -16
  352. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  353. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  354. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  355. package/src/plugins/builtin/kelly-sizer/headless.ts +2 -2
  356. package/src/plugins/builtin/kelly-sizer/history.ts +10 -3
  357. package/src/plugins/builtin/kelly-sizer/pane.tsx +2 -2
  358. package/src/plugins/builtin/kelly-sizer/sections.tsx +1 -1
  359. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  360. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  361. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  362. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  363. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  364. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  365. package/src/plugins/builtin/members/client.ts +24 -2
  366. package/src/plugins/builtin/members/headless.ts +66 -9
  367. package/src/plugins/builtin/members/index.tsx +7 -6
  368. package/src/plugins/builtin/members/model.ts +89 -5
  369. package/src/plugins/builtin/members/pane.tsx +70 -21
  370. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  371. package/src/plugins/builtin/mna/pane.tsx +1 -1
  372. package/src/plugins/builtin/money-markets/client.ts +43 -15
  373. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  374. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  375. package/src/plugins/builtin/money-markets/model.ts +20 -5
  376. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  377. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  378. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  379. package/src/plugins/builtin/notes/headless.ts +94 -0
  380. package/src/plugins/builtin/notes/index.tsx +3 -1
  381. package/src/plugins/builtin/notes/store.ts +10 -3
  382. package/src/plugins/builtin/options/footer.ts +8 -2
  383. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  384. package/src/plugins/builtin/options/view.tsx +10 -1
  385. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  386. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  387. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  388. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  389. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  390. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  391. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  392. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  393. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  394. package/src/plugins/builtin/perps/client.ts +54 -15
  395. package/src/plugins/builtin/perps/headless.ts +39 -13
  396. package/src/plugins/builtin/perps/index.tsx +2 -1
  397. package/src/plugins/builtin/perps/model.ts +43 -1
  398. package/src/plugins/builtin/perps/pane.tsx +35 -18
  399. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  400. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  401. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  402. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  403. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  404. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  405. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  406. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  407. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  408. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  409. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  410. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  411. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  412. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  413. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  414. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  415. package/src/plugins/builtin/power/gas.tsx +2 -2
  416. package/src/plugins/builtin/power/prices.tsx +2 -2
  417. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  418. package/src/plugins/builtin/rate-path/model.ts +9 -0
  419. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  420. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  421. package/src/plugins/builtin/realized-vol/headless.ts +19 -12
  422. package/src/plugins/builtin/realized-vol/model.ts +14 -6
  423. package/src/plugins/builtin/realized-vol/pane.tsx +15 -8
  424. package/src/plugins/builtin/realized-vol/settings.ts +2 -1
  425. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  426. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  427. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  428. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  429. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  430. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  431. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  432. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  433. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  434. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  435. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  436. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  437. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  438. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  439. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  440. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  441. package/src/plugins/builtin/scanner/headless.ts +15 -1
  442. package/src/plugins/builtin/seasonality/client.ts +66 -17
  443. package/src/plugins/builtin/seasonality/headless.ts +7 -2
  444. package/src/plugins/builtin/seasonality/model.ts +12 -3
  445. package/src/plugins/builtin/seasonality/pane.tsx +5 -3
  446. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  447. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  448. package/src/plugins/builtin/sec/headless.ts +8 -4
  449. package/src/plugins/builtin/sec/index.tsx +41 -13
  450. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  451. package/src/plugins/builtin/shared/use-quote-board.ts +65 -8
  452. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  453. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  454. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  455. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  456. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  457. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  458. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  459. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  460. package/src/plugins/builtin/themes/pane.tsx +4 -4
  461. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  462. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  463. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  464. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  465. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  466. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  467. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  468. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  469. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  470. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  471. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  472. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  473. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  474. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  475. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  476. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  477. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  478. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  479. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  480. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  481. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  482. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  483. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  484. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  485. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  486. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  487. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  488. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  489. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  490. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  491. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  492. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  493. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  494. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  495. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  496. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  497. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  498. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  499. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  500. package/src/plugins/builtin/volatility/headless.ts +3 -2
  501. package/src/plugins/builtin/volatility/index.tsx +1 -1
  502. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  503. package/src/plugins/builtin/volatility/series.ts +7 -3
  504. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  505. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  506. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  507. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  508. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  509. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  510. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  511. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  512. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  513. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  514. package/src/plugins/extracted-plugins.ts +14 -10
  515. package/src/plugins/installer.ts +17 -1
  516. package/src/plugins/marketplace/feed.ts +14 -0
  517. package/src/plugins/marketplace/install-offer.ts +64 -0
  518. package/src/plugins/registry/contributions.ts +46 -8
  519. package/src/plugins/registry/index.ts +5 -0
  520. package/src/portfolio/collection-name.ts +38 -4
  521. package/src/portfolio/column-values.ts +32 -4
  522. package/src/portfolio/period-pnl.ts +4 -2
  523. package/src/react/async-resource.ts +24 -8
  524. package/src/remote/endpoint.ts +38 -12
  525. package/src/remote/secrets.ts +22 -6
  526. package/src/remote/server.ts +20 -4
  527. package/src/renderers/dom/data-table/index.tsx +2 -1
  528. package/src/renderers/dom/data-table/row.tsx +49 -7
  529. package/src/renderers/dom/desktop/controls.tsx +3 -1
  530. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  531. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  532. package/src/renderers/dom/styles.css +24 -4
  533. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  534. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  535. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  536. package/src/renderers/electrobun/view/host-route.ts +119 -0
  537. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  538. package/src/renderers/opentui/box-width.ts +30 -0
  539. package/src/renderers/opentui/toast-host.tsx +6 -3
  540. package/src/renderers/opentui/ui-host.tsx +29 -5
  541. package/src/series/registry.ts +1 -0
  542. package/src/series/standalone-catalog.ts +40 -0
  543. package/src/series/types.ts +10 -0
  544. package/src/series/validate.ts +5 -0
  545. package/src/shares/portable-layout.ts +2 -7
  546. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  547. package/src/sources/gloomberb-cloud/index.ts +46 -5
  548. package/src/sources/gloomberb-cloud/news.ts +15 -9
  549. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  550. package/src/sources/history-coverage.ts +13 -0
  551. package/src/sources/history-result.ts +1 -0
  552. package/src/sources/provider-errors.ts +9 -0
  553. package/src/sources/provider-router/batches.ts +7 -3
  554. package/src/sources/provider-router/financial-routes.ts +3 -1
  555. package/src/sources/provider-router/history.ts +6 -4
  556. package/src/sources/provider-router/index.ts +5 -1
  557. package/src/sources/provider-router/primary.ts +4 -3
  558. package/src/sources/provider-router/retrieved-at.ts +12 -0
  559. package/src/team/store.ts +17 -4
  560. package/src/telemetry/crash-reports.ts +3 -1
  561. package/src/test-support/cli-context.ts +3 -2
  562. package/src/test-support/test-env.ts +7 -0
  563. package/src/theme/themes.ts +16 -9
  564. package/src/theme/tone-contrast.ts +29 -5
  565. package/src/tickers/company-name-listing.ts +31 -3
  566. package/src/tickers/company-name.ts +9 -0
  567. package/src/tickers/index-roots.ts +56 -4
  568. package/src/tickers/listing-name.ts +7 -2
  569. package/src/tickers/listing-venues.ts +17 -2
  570. package/src/tickers/search/home-listing.ts +2 -0
  571. package/src/tickers/search/index.ts +64 -11
  572. package/src/tickers/search/major-listings.json +595 -592
  573. package/src/tickers/search/ranking.ts +19 -1
  574. package/src/tickers/terminal-codes.ts +5 -3
  575. package/src/time-series/bar-aggregation.ts +3 -2
  576. package/src/time-series/base-series.ts +18 -1
  577. package/src/time-series/chart-data.ts +9 -6
  578. package/src/time-series/chart-seed.ts +11 -3
  579. package/src/time-series/currency-conversion.ts +1 -0
  580. package/src/time-series/date-window.ts +8 -0
  581. package/src/time-series/formula-months.ts +57 -0
  582. package/src/time-series/fundamentals/period-points.ts +3 -3
  583. package/src/time-series/fundamentals/source-statements.ts +5 -4
  584. package/src/time-series/leverage.ts +12 -4
  585. package/src/time-series/live-bars.ts +12 -7
  586. package/src/time-series/live-quotes.ts +6 -2
  587. package/src/time-series/market.ts +10 -3
  588. package/src/time-series/price-comparison.ts +106 -0
  589. package/src/time-series/range.ts +10 -0
  590. package/src/time-series/resolve-context.ts +7 -2
  591. package/src/time-series/resolve.ts +61 -5
  592. package/src/time-series/series-name.ts +2 -2
  593. package/src/time-series/series-presentation.ts +91 -2
  594. package/src/time-series/session-bar.ts +13 -7
  595. package/src/time-series/spec.ts +21 -2
  596. package/src/time-series/studies/formula.ts +262 -36
  597. package/src/time-series/studies/leverage.ts +9 -3
  598. package/src/time-series/studies/resolve.ts +7 -2
  599. package/src/time-series/types.ts +34 -0
  600. package/src/time-series/use-chart-resolution.ts +18 -1
  601. package/src/types/data-provider.ts +7 -0
  602. package/src/types/financials.ts +117 -2
  603. package/src/types/headless.ts +70 -3
  604. package/src/types/instrument.ts +6 -0
  605. package/src/types/plugin-context.ts +9 -0
  606. package/src/types/plugin-pane-templates.ts +6 -0
  607. package/src/types/plugin-panes.ts +7 -0
  608. package/src/types/price-history.ts +6 -0
  609. package/src/ui/host.tsx +3 -1
  610. package/src/ui/index.tsx +7 -2
  611. package/src/utils/cli-output.ts +21 -1
  612. package/src/utils/currency-units.ts +14 -0
  613. package/src/utils/datetime-format.ts +11 -0
  614. package/src/utils/exchange-announcements.ts +26 -3
  615. package/src/utils/exchange-notation.generated.ts +3 -4
  616. package/src/utils/exchange-results.ts +144 -0
  617. package/src/utils/exchanges.ts +10 -0
  618. package/src/utils/financial-statements.ts +212 -22
  619. package/src/utils/fire-and-forget.ts +1 -1
  620. package/src/utils/fiscal-period.ts +41 -3
  621. package/src/utils/format.ts +10 -6
  622. package/src/utils/fundamentals.ts +223 -15
  623. package/src/utils/futures-generic.ts +26 -0
  624. package/src/utils/lease-liabilities.ts +15 -5
  625. package/src/utils/lookup-token.ts +22 -0
  626. package/src/utils/max-drawdown.ts +25 -4
  627. package/src/utils/price-history-integrity.ts +56 -8
  628. package/src/utils/price-history.ts +6 -2
  629. package/src/utils/price-window.ts +38 -2
  630. package/src/utils/replace-file.ts +47 -0
  631. package/src/utils/rpc-timeout-error.ts +16 -2
  632. package/src/utils/untrusted-text.ts +14 -0
@@ -0,0 +1,183 @@
1
+ import { TIME_RANGES } from "../time-series/range";
2
+ import type { CapabilityOperationCliManifest, CapabilitySchema } from "./types";
3
+
4
+ /** What one field of an operation's input holds. `range` is a TimeRange name; `date` an ISO date or time, or epoch ms. */
5
+ type FieldType = "string" | "number" | "boolean" | "object" | "array" | "date" | "range";
6
+
7
+ interface InputField {
8
+ readonly name: string;
9
+ readonly type: FieldType;
10
+ readonly optional?: true;
11
+ }
12
+
13
+ interface AssetDataOperationSpec {
14
+ readonly summary: string;
15
+ readonly fields: readonly InputField[];
16
+ readonly examples?: readonly string[];
17
+ }
18
+
19
+ const required = (name: string, type: FieldType): InputField => ({ name, type });
20
+ const optional = (name: string, type: FieldType): InputField => ({ name, type, optional: true });
21
+
22
+ const LISTING = [required("ticker", "string"), optional("exchange", "string"), optional("context", "object")] as const;
23
+ const RANGE_WORDS = TIME_RANGES.join("|");
24
+
25
+ /**
26
+ * Each built-in asset-data operation's summary and input, as `gloom api get`
27
+ * lists them and `api invoke` checks a payload against: a missing or
28
+ * mistyped field is named with the fields the operation takes, never a
29
+ * TypeError from inside the source.
30
+ */
31
+ const ASSET_DATA_OPERATION_SPECS: Readonly<Record<string, AssetDataOperationSpec>> = {
32
+ canProvide: { summary: "Whether the source answers for a listing", fields: LISTING },
33
+ primaryMarketSourceName: { summary: "Name of the source that serves quotes and bars", fields: [] },
34
+ batchesReads: { summary: "Whether reads of a method go out batched", fields: [required("method", "string")] },
35
+ getCachedFinancialsForTargets: {
36
+ summary: "Saved financials for several listings, without a network read",
37
+ fields: [required("targets", "array"), optional("options", "object")],
38
+ },
39
+ getQuotesBatch: {
40
+ summary: "Quotes for several listings at once",
41
+ fields: [required("targets", "array"), optional("options", "object")],
42
+ examples: ['api invoke asset-data.asset-data-router.getQuotesBatch \'{"targets":[{"symbol":"KO"},{"symbol":"PEP"}]}\''],
43
+ },
44
+ getTickerFinancialsBatch: {
45
+ summary: "Quote, profile and statements for several listings",
46
+ fields: [required("targets", "array"), optional("options", "object")],
47
+ },
48
+ getTickerFinancials: { summary: "Quote, profile and statements for one listing", fields: LISTING },
49
+ getQuote: {
50
+ summary: "Latest quote, with lastTradeTime, retrievedAt, stale and dataSource",
51
+ fields: LISTING,
52
+ examples: ['api invoke asset-data.asset-data-router.getQuote \'{"ticker":"TTEK"}\''],
53
+ },
54
+ getQuoteMetadata: { summary: "Name, currency and exchange of a listing", fields: LISTING },
55
+ getExchangeRate: { summary: "Units of the base currency per one unit of a currency", fields: [required("fromCurrency", "string")] },
56
+ search: { summary: "Listings matching a name or symbol", fields: [required("query", "string"), optional("context", "object")] },
57
+ getSecFilings: {
58
+ summary: "Recent SEC filings",
59
+ fields: [required("ticker", "string"), optional("count", "number"), optional("exchange", "string"), optional("context", "object")],
60
+ },
61
+ getHolders: { summary: "Institutional and fund holders", fields: LISTING },
62
+ getAnalystResearch: { summary: "Analyst ratings and price targets", fields: LISTING },
63
+ getCorporateActions: { summary: "Dividends, splits and reported earnings", fields: LISTING },
64
+ getTickerChanges: { summary: "Symbol changes a listing went through", fields: [required("symbol", "string")] },
65
+ getEarningsCalendar: { summary: "Upcoming and recent earnings dates", fields: [required("symbols", "array"), optional("context", "object")] },
66
+ getSecFilingDocuments: { summary: "Documents of one SEC filing", fields: [required("filing", "object")] },
67
+ getSecFilingContent: { summary: "Text of one SEC filing", fields: [required("filing", "object")] },
68
+ getArticleSummary: { summary: "Summary of a news article", fields: [required("url", "string")] },
69
+ getPriceHistory: {
70
+ summary: "Bars over a range, in the range's bar size",
71
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("range", "range"), optional("context", "object")],
72
+ },
73
+ getPriceHistoryWithMetadata: {
74
+ summary: "Bars over a range, with the bar size served and where coverage starts",
75
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("range", "range"), optional("context", "object")],
76
+ examples: ['api invoke asset-data.asset-data-router.getPriceHistoryWithMetadata \'{"ticker":"KO","range":"ALL"}\''],
77
+ },
78
+ getPriceHistoryForResolutionWithMetadata: {
79
+ summary: "Bars of one size over a range, with metadata",
80
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("bufferRange", "range"), required("resolution", "string"), optional("context", "object")],
81
+ },
82
+ getDetailedPriceHistoryWithMetadata: {
83
+ summary: "Bars of one size between two dates, with metadata",
84
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("startDate", "date"), required("endDate", "date"), required("barSize", "string"), optional("context", "object")],
85
+ examples: ['api invoke asset-data.asset-data-router.getDetailedPriceHistoryWithMetadata \'{"ticker":"KO","startDate":"1990-01-01","endDate":"2026-11-11","barSize":"1d"}\''],
86
+ },
87
+ getPriceHistoryForResolution: {
88
+ summary: "Bars of one size over a range",
89
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("bufferRange", "range"), required("resolution", "string"), optional("context", "object")],
90
+ },
91
+ getDetailedPriceHistory: {
92
+ summary: "Bars of one size between two dates",
93
+ fields: [required("ticker", "string"), optional("exchange", "string"), required("startDate", "date"), required("endDate", "date"), required("barSize", "string"), optional("context", "object")],
94
+ },
95
+ getChartResolutionSupport: { summary: "Bar sizes the source serves for a listing", fields: LISTING },
96
+ getChartResolutionCapabilities: { summary: "Bar sizes and how far back each reaches", fields: LISTING },
97
+ getOptionsChain: {
98
+ summary: "Options chain for one expiry, the nearest when none is given",
99
+ fields: [required("ticker", "string"), optional("exchange", "string"), optional("expirationDate", "number"), optional("context", "object")],
100
+ },
101
+ subscribeQuotes: { summary: "Stream of quotes for several listings", fields: [required("targets", "array")] },
102
+ };
103
+
104
+ function typeWord(type: FieldType): string {
105
+ return type === "range" ? RANGE_WORDS : type === "date" ? "date" : type;
106
+ }
107
+
108
+ /** `{ ticker: string, exchange?: string, context?: object }` */
109
+ function inputShape(fields: readonly InputField[]): string {
110
+ if (fields.length === 0) return "{}";
111
+ return `{ ${fields.map((field) => `${field.name}${field.optional ? "?" : ""}: ${typeWord(field.type)}`).join(", ")} }`;
112
+ }
113
+
114
+ /** The value as the field takes it, or undefined when it is not one. A date may come as an ISO string or epoch ms, as JSON carries it. */
115
+ function readField(type: FieldType, value: unknown): unknown {
116
+ switch (type) {
117
+ case "string": return typeof value === "string" ? value : undefined;
118
+ case "number": return typeof value === "number" && Number.isFinite(value) ? value : undefined;
119
+ case "boolean": return typeof value === "boolean" ? value : undefined;
120
+ case "array": return Array.isArray(value) ? value : undefined;
121
+ case "object": return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
122
+ case "range": return typeof value === "string" && (TIME_RANGES as string[]).includes(value) ? value : undefined;
123
+ case "date": {
124
+ const date = value instanceof Date ? value : typeof value === "string" || typeof value === "number" ? new Date(value) : null;
125
+ return date && Number.isFinite(date.getTime()) ? date : undefined;
126
+ }
127
+ }
128
+ }
129
+
130
+ function describeValue(value: unknown): string {
131
+ if (typeof value === "string") return `"${value.length > 40 ? `${value.slice(0, 40)}…` : value}"`;
132
+ if (value === null) return "null";
133
+ if (Array.isArray(value)) return "an array";
134
+ return typeof value === "object" ? "an object" : String(value);
135
+ }
136
+
137
+ /**
138
+ * The schema of one operation's input: the payload must be an object with
139
+ * every required field, each field of its type. A date field is read into a
140
+ * Date. Fields it does not name pass through untouched.
141
+ */
142
+ function inputSchema(operationId: string, fields: readonly InputField[]): CapabilitySchema<Record<string, unknown>> {
143
+ const shape = inputShape(fields);
144
+ const refuse = (problem: string): never => {
145
+ throw new Error(`${operationId} takes ${shape}: ${problem}.`);
146
+ };
147
+ return {
148
+ parse(value) {
149
+ if (value != null && (typeof value !== "object" || Array.isArray(value))) refuse(`got ${describeValue(value)}, not an object`);
150
+ const payload = { ...(value as Record<string, unknown> | null | undefined) };
151
+ const known = new Set(fields.map((field) => field.name));
152
+ for (const field of fields) {
153
+ const raw = payload[field.name];
154
+ if (raw == null) {
155
+ if (field.optional) continue;
156
+ const others = Object.keys(payload).filter((key) => !known.has(key));
157
+ refuse(`${field.name} is missing${others.length > 0 ? ` (it got ${others.join(", ")})` : ""}`);
158
+ }
159
+ const read = readField(field.type, raw);
160
+ if (read === undefined) {
161
+ refuse(field.type === "range"
162
+ ? `${field.name} is one of ${TIME_RANGES.join(", ")}, not ${describeValue(raw)}`
163
+ : `${field.name} is a ${typeWord(field.type)}, not ${describeValue(raw)}`);
164
+ }
165
+ payload[field.name] = read;
166
+ }
167
+ return payload;
168
+ },
169
+ };
170
+ }
171
+
172
+ /** An operation's input schema and the summary and input shape `gloom api get` shows; nothing for one without a spec. */
173
+ export function assetDataOperationContract(operationId: string): {
174
+ input?: CapabilitySchema<Record<string, unknown>>;
175
+ cli?: CapabilityOperationCliManifest;
176
+ } {
177
+ const spec = ASSET_DATA_OPERATION_SPECS[operationId];
178
+ if (!spec) return {};
179
+ return {
180
+ input: inputSchema(operationId, spec.fields),
181
+ cli: { summary: spec.summary, inputShape: inputShape(spec.fields), ...(spec.examples ? { examples: [...spec.examples] } : {}) },
182
+ };
183
+ }
@@ -1,5 +1,6 @@
1
1
  import type { AssetDataProvider } from "../types/data-provider";
2
2
  import { quoteMetadataFromQuote } from "../market-data/quotes/metadata";
3
+ import { assetDataOperationContract } from "./asset-data-inputs";
3
4
  import type { NewsDataProvider } from "../types/capability-route-source";
4
5
  import {
5
6
  chartSeriesCatalogOutputSchema,
@@ -24,6 +25,11 @@ function stream(subscribe: CapabilityOperation["subscribe"]): CapabilityOperatio
24
25
  return { kind: "stream", rendererSafe: true, subscribe };
25
26
  }
26
27
 
28
+ /** Each operation with the input it checks and the summary and input shape `gloom api get` lists (asset-data-inputs.ts). */
29
+ function withAssetDataContracts(operations: Record<string, CapabilityOperation>): Record<string, CapabilityOperation> {
30
+ return Object.fromEntries(Object.entries(operations).map(([id, operation]) => [id, { ...operation, ...assetDataOperationContract(id) }]));
31
+ }
32
+
27
33
  export function assetDataProvider(provider: AssetDataProvider): AssetDataCapability {
28
34
  return {
29
35
  id: `asset-data.${provider.id}`,
@@ -33,7 +39,7 @@ export function assetDataProvider(provider: AssetDataProvider): AssetDataCapabil
33
39
  priority: provider.priority,
34
40
  cachePolicy: provider.cachePolicy,
35
41
  provider,
36
- operations: {
42
+ operations: withAssetDataContracts({
37
43
  canProvide: op((input: any) => provider.canProvide?.(input.ticker, input.exchange, input.context) ?? true, "query"),
38
44
  primaryMarketSourceName: op(() => provider.primaryMarketSourceName?.() ?? provider.name, "query"),
39
45
  batchesReads: op((input: any) => provider.batchesReads?.(input.method) ?? false, "query"),
@@ -101,7 +107,7 @@ export function assetDataProvider(provider: AssetDataProvider): AssetDataCapabil
101
107
  if (!provider.subscribeQuotes) throw new Error(`${provider.name} does not provide quote streaming.`);
102
108
  return provider.subscribeQuotes(input.targets ?? [], (target, quote) => emit({ target, quote }));
103
109
  }),
104
- },
110
+ }),
105
111
  };
106
112
  }
107
113
 
@@ -1,6 +1,7 @@
1
1
  import type { DataProvider } from "../types/data-provider";
2
2
  import { fixedUsdRate, heldCurrencyUnit } from "../utils/currency-units";
3
3
  import { logFailure } from "../utils/log-failure";
4
+ import { fxQuoteRateMove, readFxQuoteRate } from "./fx-quote-rate";
4
5
 
5
6
  /** One rate a converter used: units of `baseCurrency` per unit of `currency`, and when it was observed. */
6
7
  export interface BaseConversion {
@@ -18,6 +19,13 @@ export type BaseConverter = ((value: number, fromCurrency: string) => Promise<nu
18
19
  conversions(): BaseConversion[];
19
20
  /** A currency's US dollar rate as the converter reads it, so another conversion on the report uses the same rate; null when unusable. */
20
21
  usdRate(currency: string): Promise<UsdRate | null>;
22
+ /**
23
+ * One unit of `currency` (pence as a hundredth of a pound) in the base at the
24
+ * previous daily FX close: the rate the converter uses now, less the pair's
25
+ * move on the day as `fx` reads it. The same rate for a currency priced in
26
+ * the base; null when the pair has no quote or no close.
27
+ */
28
+ previousRate(currency: string): Promise<number | null>;
21
29
  };
22
30
 
23
31
  interface UsdRate {
@@ -28,7 +36,7 @@ interface UsdRate {
28
36
  }
29
37
 
30
38
  export function createBaseConverter(
31
- dataProvider: Pick<DataProvider, "getExchangeRate" | "getCachedQuery" | "revalidatesInBackground">,
39
+ dataProvider: Pick<DataProvider, "getExchangeRate" | "getCachedQuery" | "revalidatesInBackground" | "getQuotesBatch">,
32
40
  baseCurrency: string,
33
41
  ): BaseConverter {
34
42
  const rateCache = new Map<string, Promise<UsdRate>>();
@@ -90,5 +98,31 @@ export function createBaseConverter(
90
98
  return Number.isFinite(leg.rate) && leg.rate > 0 ? leg : null;
91
99
  };
92
100
 
93
- return Object.assign(convert, { conversions: () => [...used.values()], usdRate });
101
+ const moves = new Map<string, Promise<number | null>>();
102
+ /** The pair's move on the day as a factor (1.001 for +0.1%), as `fx` reads it from the previous daily closes. */
103
+ const dayMove = (currency: string): Promise<number | null> => {
104
+ let pending = moves.get(currency);
105
+ if (!pending) {
106
+ const getQuotesBatch = dataProvider.getQuotesBatch?.bind(dataProvider);
107
+ pending = !getQuotesBatch ? Promise.resolve(null) : readFxQuoteRate(currency, base.currency, getQuotesBatch)
108
+ .then((read) => {
109
+ const move = read && "rate" in read ? fxQuoteRateMove(read) : null;
110
+ return move ? 1 + move.percent / 100 : null;
111
+ })
112
+ .catch(logFailure("cli-base-converter", "Could not read the FX move on the day", null));
113
+ moves.set(currency, pending);
114
+ }
115
+ return pending;
116
+ };
117
+
118
+ const previousRate = async (currency: string): Promise<number | null> => {
119
+ const from = heldCurrencyUnit(currency);
120
+ const now = await convert(1, currency);
121
+ if (!Number.isFinite(now)) return null;
122
+ if (from.currency === base.currency) return now;
123
+ const factor = await dayMove(from.currency);
124
+ return factor != null && Number.isFinite(factor) && factor > 0 ? now / factor : null;
125
+ };
126
+
127
+ return Object.assign(convert, { conversions: () => [...used.values()], usdRate, previousRate });
94
128
  }
@@ -86,8 +86,8 @@ export const apiCliCommand: BuiltinCliCommandDef = {
86
86
  "",
87
87
  renderSection("Operations"),
88
88
  renderTable(
89
- [{ header: "Operation" }, { header: "Kind" }, { header: "Summary" }],
90
- data!.operations.map((operation) => [operation.id, operation.kind, operation.summary ?? ""]),
89
+ [{ header: "Operation" }, { header: "Kind" }, { header: "Summary" }, { header: "Input" }],
90
+ data!.operations.map((operation) => [operation.id, operation.kind, operation.summary ?? "", operation.inputShape ?? ""]),
91
91
  ),
92
92
  ].join("\n"),
93
93
  });
@@ -1,5 +1,6 @@
1
1
  import type { CliCommandContext } from "../../types/plugin";
2
2
  import { currencyNameStop } from "../currency-name-hint";
3
+ import { tickerShapedWord } from "../symbol-args";
3
4
 
4
5
  export function takeOption(args: string[], name: string): string | undefined {
5
6
  const equalsPrefix = `${name}=`;
@@ -75,10 +76,27 @@ export function requireOneArg(
75
76
  // A currency's name in words (`ticker swiss franc`) is its pair, not two symbols.
76
77
  const currency = noun === "symbol" && args.length > 1 ? currencyNameStop(args, usage.split(" ")[0]!) : null;
77
78
  if (currency) ctx.fail(currency.message, currency.details);
79
+ // A company's name typed in words (`valuation Bank Leumi`) is one argument, read as `quote` reads it.
80
+ const name = noun === "symbol" ? typedCompanyName(args) : null;
81
+ if (name) return name;
78
82
  rejectExtraArgs(args, 1, { usage, takes: `one ${noun}`, advice: `Run it once per ${noun}.` }, ctx);
79
83
  return value;
80
84
  }
81
85
 
86
+ /**
87
+ * A company's name typed in words where one symbol goes (`valuation Bank
88
+ * Leumi`, `ticker MTN Group`), joined as one name for the listing to read
89
+ * as `quote` reads it ("Read "Bank Leumi" as LUMI:TASE ..."): two to four
90
+ * words of letters, one at least capitalised as a name is. Symbols typed
91
+ * apart (`AAPL MSFT`, `aapl msft`) are not a name, nor is a list with a word
92
+ * shaped as a ticker (`BRK.B Meta`, `tickerShapedWord`); null for them.
93
+ */
94
+ export function typedCompanyName(args: readonly string[]): string | null {
95
+ if (args.length < 2 || args.length > 4) return null;
96
+ if (!args.every((arg) => /^\p{L}[\p{L}&'’.-]*$/u.test(arg) && !tickerShapedWord(arg))) return null;
97
+ return args.some((arg) => /^\p{Lu}\p{Ll}/u.test(arg)) ? args.join(" ") : null;
98
+ }
99
+
82
100
  export function isoDate(value: unknown): string {
83
101
  if (value instanceof Date) return value.toISOString();
84
102
  if (typeof value === "number") return new Date(value).toISOString();
@@ -0,0 +1,50 @@
1
+ import type { KeptListing } from "../../tickers/search/listing-index";
2
+
3
+ /**
4
+ * `movers hk`: Hong Kong's gainers or losers, ranked by the regular session's
5
+ * move. The upstream movers lists rank US listings only, so the universe is
6
+ * the HKEX common stocks of the large listings the app ships for search
7
+ * (`bun run listings:snapshot`), quoted through the same batched quote path
8
+ * as `quote`, and the report says exactly that.
9
+ */
10
+ export const HONG_KONG_MOVERS_MARKET = "hk";
11
+ export type HongKongMoversList = "gainers" | "losers";
12
+
13
+ /** The universe: each HKEX common stock among the shipped major listings, once, as `quote` takes it. */
14
+ export function hongKongMoverUniverse(listings: readonly KeptListing[]): Array<{ code: string; name: string }> {
15
+ const seen = new Set<string>();
16
+ return listings.flatMap(([symbol, name, exchange, type]) => {
17
+ if (exchange !== "HKEX" || type !== "Common Stock" || seen.has(symbol)) return [];
18
+ seen.add(symbol);
19
+ return [{ code: symbol, name }];
20
+ });
21
+ }
22
+
23
+ /** The smallest company the list ranks: a large cap, as the Hang Seng's members are. */
24
+ const HONG_KONG_MIN_MARKET_CAP = 10_000_000_000;
25
+
26
+ /** What the list ranks, said under its title: how many of the listed stocks, which ones, and that no other stock is. */
27
+ export function hongKongUniverseNote(count: number, listed: number): string {
28
+ return `Ranks ${count} of the ${listed} HKEX common stocks in the app's built-in list of large listings: those worth HK$10B or more`
29
+ + " with a quote from the current or last session, by the regular session's move. Other HKEX stocks are not ranked.";
30
+ }
31
+
32
+ /**
33
+ * Whether a quoted stock is in the ranked universe: a Hong Kong dollar
34
+ * market cap of HK$10B or more, and a price from the session in progress or
35
+ * the last one (a stale or suspended quote has no move to rank).
36
+ */
37
+ export function inHongKongUniverse(quote: { currency?: string; marketCap?: number | null } | null | undefined, stale: boolean): boolean {
38
+ return !!quote && !stale && quote.currency === "HKD" && (quote.marketCap ?? 0) >= HONG_KONG_MIN_MARKET_CAP;
39
+ }
40
+
41
+ /**
42
+ * The rows moving the list's way, largest move first: a gainer up, a loser
43
+ * down, and a row with no move (no quote, or none this session) left out.
44
+ */
45
+ export function rankHongKongMovers<T extends { changePercent: number | null }>(rows: readonly T[], list: HongKongMoversList, limit: number): T[] {
46
+ const sign = list === "gainers" ? 1 : -1;
47
+ return rows.filter((row) => row.changePercent != null && row.changePercent * sign > 0)
48
+ .toSorted((a, b) => sign * (b.changePercent! - a.changePercent!))
49
+ .slice(0, limit);
50
+ }