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 { PricePoint, Quote } from "../types/financials";
20
20
  import type { PriceHistoryResult } from "../types/price-history";
21
21
  import type { InstrumentRef } from "../market-data/request-types";
22
22
  import { getSharedMarketDataCoordinator } from "../market-data/coordinator";
23
+ import { connectionHealth, recoversDataRequests } from "../core/connection-health";
23
24
  import { resolveEntryData } from "../market-data/selectors";
24
25
  import { usePaneVisible } from "../state/app/activity";
25
26
  import { DEFAULT_QUOTE_POLL_INTERVAL_MS, useQuoteUpdates } from "../state/hooks/quote-streaming";
@@ -28,6 +29,7 @@ import { CHART_RESOLUTION_STEP_MS, getNextBufferRange, isIntradayResolution, typ
28
29
  import { normalizeHistoryResult } from "../sources/history-result";
29
30
  import { publicListingTarget } from "../sources/listing-target";
30
31
  import { isPriceHistoryStaleForCurrentWindow, normalizePriceHistory } from "../utils/price-history";
32
+ import { withFormulaNextMonths } from "./formula-months";
31
33
  import {
32
34
  parsedPriceHistoryKey,
33
35
  readParsedHistoryResult,
@@ -219,7 +221,9 @@ export function useChartResolution(
219
221
  const specKey = JSON.stringify(spec);
220
222
  const seedResult = () => {
221
223
  const now = sources.now ?? new Date();
222
- return seedChartResolutionResult(spec, collectSeedHistory(spec, now, options), now, options);
224
+ // The first paint prices a formula's legs in one month as the settled chart does, from the next months it read.
225
+ const seedSpec = withFormulaNextMonths(spec);
226
+ return seedChartResolutionResult(seedSpec, collectSeedHistory(seedSpec, now, options), now, options);
223
227
  };
224
228
  const [state, setState] = useState(() => ({
225
229
  key: specKey,
@@ -302,6 +306,19 @@ export function useChartResolution(
302
306
  latestRequestRef.current = { spec, sources, options: resolveOptions };
303
307
  const reload = useCallback(() => setRevision((current) => current + 1), []);
304
308
 
309
+ // A chart that failed is loaded again once the data service, or the desktop
310
+ // bridge to it, answers after an outage, so the pane recovers by itself
311
+ // instead of keeping the failure.
312
+ const live = !snapshot;
313
+ const failedRef = useRef(false);
314
+ failedRef.current = live && displayed.errors.length > 0 && !displayed.loading;
315
+ useEffect(() => {
316
+ if (!live) return;
317
+ return connectionHealth.subscribeRecovery((sourceId) => {
318
+ if (recoversDataRequests(sourceId) && failedRef.current) reload();
319
+ });
320
+ }, [live, reload]);
321
+
305
322
  // A covered chart keeps its quotes arriving at the off-screen cadence but
306
323
  // builds no live bars; coming back into view catches up from the store.
307
324
  const paneVisible = usePaneVisible();
@@ -203,6 +203,13 @@ export interface MarketDataRequestContext {
203
203
  * no venue calendar dates. The long-lived app dates every quote anyway.
204
204
  */
205
205
  datesChangeBasis?: boolean;
206
+ /**
207
+ * The newest bars one read returns will do (a backtest of its last ten
208
+ * years): a history the service cut at its bar cap, or one beginning with
209
+ * the window asked, is answered as it came, without reads of its older bars.
210
+ * Without it `ALL` is every bar kept.
211
+ */
212
+ newestBars?: boolean;
206
213
  }
207
214
 
208
215
  export interface CachedFinancialsTarget {
@@ -50,6 +50,18 @@ export interface ListingDelisting {
50
50
  historyStart: string;
51
51
  }
52
52
 
53
+ /**
54
+ * A listing its exchange withdrew, as its company announced it: Hang Seng
55
+ * Bank's 0011 left HKEX on 2026-01-27, privatised by HSBC. No source prices
56
+ * it any more, so only this is known.
57
+ */
58
+ export interface ListingWithdrawal {
59
+ /** The day the listing went (YYYY-MM-DD); null when the notice does not say. */
60
+ on: string | null;
61
+ /** Why, in words: "Privatised by The Hongkong and Shanghai Banking Corporation Limited". */
62
+ reason: string | null;
63
+ }
64
+
53
65
  /** Static listing facts from a quote observation, without an investable price. */
54
66
  export interface QuoteMetadataSource {
55
67
  providerId?: string;
@@ -173,6 +185,15 @@ export interface Quote extends DepositaryReceiptFacts {
173
185
  * previousClose is from (PreviousCloseDates): its move names no day.
174
186
  */
175
187
  previousCloseUndated?: boolean;
188
+ /**
189
+ * A listing that did not trade in the session its price is from: the price
190
+ * and previous close are the venue's nominal prices (an HKEX counter's
191
+ * USD line, untraded for days), dated by its daily bars
192
+ * (PreviousCloseDates). `session` is the venue date whose nominal price it
193
+ * is; `lastTraded` the latest day its bars show a trade, null when they
194
+ * reach back to none. `lastUpdated` stays the last print.
195
+ */
196
+ nominalPrice?: { session: string; lastTraded: string | null };
176
197
  /** Official close of a completed regular session, in this quote's currency. */
177
198
  regularClose?: number;
178
199
  /** Exchange-local date of regularClose; separate from the daily previous-close reference. */
@@ -189,6 +210,15 @@ export interface Quote extends DepositaryReceiptFacts {
189
210
  name?: string;
190
211
  lastUpdated: number; // timestamp ms
191
212
  receivedAt?: number; // local receipt timestamp ms for streamed/display freshness
213
+ /**
214
+ * When Gloom fetched this quote from its source (epoch ms): Gloom Cloud's
215
+ * own fetch time for a copy it kept, a stale one included, else when this
216
+ * app read it. A quote served from a saved copy keeps the time that copy
217
+ * was fetched, so a cached quote can be told from a feed that stopped:
218
+ * `lastTradeTime` behind with `retrievedAt` recent is the feed,
219
+ * `retrievedAt` old is the copy.
220
+ */
221
+ retrievedAt?: number;
192
222
  delivery?: QuoteDelivery;
193
223
  stale?: boolean;
194
224
  /**
@@ -316,6 +346,12 @@ export interface EnterpriseValueCheck {
316
346
  balanceSheetDate?: string;
317
347
  /** marketCap + totalDebt + leases - cash. */
318
348
  computed?: number;
349
+ /**
350
+ * Minority interest and preferred equity on the same balance sheet (total equity including minority interest less
351
+ * common equity), where both lines are there and the difference is positive. `computed` plus this is the EV the
352
+ * provider's is checked against and that stands in for it (bridgeEnterpriseValue).
353
+ */
354
+ minorityAndPreferred?: number;
319
355
  /** `cash` is cash and equivalents alone: an insurer's or a holding company's investments stay in its EV. */
320
356
  investmentsKept?: true;
321
357
  /** Why the EV is not meaningful (`not-meaningful`), or why a withdrawn EV no balance sheet checked is withdrawn. */
@@ -741,7 +777,7 @@ export type StatementGapField = IncomeStatementField | "totalRevenue" | "operati
741
777
  export type StatementFillField = "totalRevenue" | "netIncome" | "totalAssets" | "totalLiabilities";
742
778
 
743
779
  /** Where a row's filled lines came from: the exchange's figures, its page, and when they were read. */
744
- export interface StatementFill {
780
+ export interface ExchangeStatisticsFill {
745
781
  source: "asx";
746
782
  page: string;
747
783
  retrievedAt: string;
@@ -749,6 +785,57 @@ export interface StatementFill {
749
785
  fields: StatementFillField[];
750
786
  }
751
787
 
788
+ /** Lines Gloom Cloud fills from a company's own results announcements and reports. */
789
+ export type ResultsFillField =
790
+ | "totalRevenue" | "grossProfit" | "operatingIncome" | "netIncome" | "basicEps" | "eps"
791
+ | "operatingCashFlow" | "capitalExpenditure" | "freeCashFlow"
792
+ | "cashAndCashEquivalents" | "totalDebt" | "totalEquity" | "commonStockEquity" | "totalEquityGrossMinorityInterest"
793
+ | "totalAssets" | "totalLiabilities";
794
+
795
+ export type StatementFilingKind = "annual_results" | "interim_results" | "quarterly_results" | "annual_report" | "interim_report";
796
+
797
+ /** A results announcement or report on HKEXnews or SGXNet, with when it was published and read. */
798
+ export interface StatementFilingDocument {
799
+ source: "hkex" | "sgx";
800
+ kind: StatementFilingKind;
801
+ title: string;
802
+ url: string;
803
+ publishedAt: string;
804
+ fetchedAt: string;
805
+ }
806
+
807
+ /** A row's lines read from the company's results announcement or report, for a period the statements source lags on. */
808
+ export interface ResultsStatementFill {
809
+ source: "results";
810
+ /** The lines taken from the documents; the row's other figures are the statements source's. */
811
+ fields: ResultsFillField[];
812
+ /** The documents, the one each line was read from first: the row is dated by the earliest publication. */
813
+ documents: StatementFilingDocument[];
814
+ /** Per line, its document (an index into `documents`) and page. */
815
+ lines: Partial<Record<ResultsFillField, { document: number; page: number | null }>>;
816
+ /** The months the row's flows cover where the list's usual is another: 6 for a half in the quarterly list. */
817
+ periodMonths?: number;
818
+ /** A quarter derived as the difference of two year-to-date periods ("6 months to 2026-06-30 − 3 months to 2026-03-31"). */
819
+ derived?: string;
820
+ /**
821
+ * Filled lines whose change over a year can be read against the statements source's row a year
822
+ * earlier: the document restates that period's figure as the source has it.
823
+ */
824
+ comparable?: ResultsFillField[];
825
+ }
826
+
827
+ export type StatementFill = ExchangeStatisticsFill | ResultsStatementFill;
828
+
829
+ /** How Gloom Cloud built a trailing twelve months the quarters do not give: the year plus the year to date since it, less a year earlier's. */
830
+ export interface StatementTrailing {
831
+ method: "annual-plus-interim";
832
+ annual: string;
833
+ interim: { end: string; months: number };
834
+ priorInterim: { end: string; months: number };
835
+ /** "FY to 2025-12-31 + 6 months to 2026-06-30 − 6 months to 2025-06-30" */
836
+ basis: string;
837
+ }
838
+
752
839
  /** Per-share earnings lines that can be declared unavailable. */
753
840
  export type EarningsField = "basicEps" | "eps";
754
841
 
@@ -1063,6 +1150,11 @@ export interface PricePoint {
1063
1150
  filled?: boolean;
1064
1151
  /** A future's session that has closed but whose settlement is not confirmed yet: its close is the last trade. */
1065
1152
  unsettled?: boolean;
1153
+ /**
1154
+ * The source served the bar in the wrong unit (a tenth or a hundredth of its price, ten or a hundred times its
1155
+ * volume): the factor its prices were multiplied by to match the bars around it; its volume was divided by it.
1156
+ */
1157
+ rescaled?: number;
1066
1158
  /** A continuous future's bar (NG=F): the contract it closes on (NGZ26). A change from the bar before is a roll. */
1067
1159
  contract?: string;
1068
1160
  }
@@ -1137,6 +1229,8 @@ export interface TickerFinancials {
1137
1229
  nextEarnings?: NextEarnings;
1138
1230
  annualStatements: FinancialStatement[];
1139
1231
  quarterlyStatements: FinancialStatement[];
1232
+ /** Twelve months to the latest half or quarter where the quarters do not give them (a half-yearly reporter). */
1233
+ trailingStatement?: FinancialStatement & { trailing: StatementTrailing };
1140
1234
  priceHistory: PricePoint[];
1141
1235
  /** Acquired history cadence. Null explicitly marks an opaque provider default; absent on legacy snapshots. */
1142
1236
  priceHistoryResolution?: import("../time-series/resolution").ManualChartResolution | null;
@@ -1146,6 +1240,23 @@ export interface TickerFinancials {
1146
1240
  priceHistorySourceKey?: string;
1147
1241
  /** Present on extended statement history from the cloud. */
1148
1242
  epsEstimates?: EpsEstimateHistory;
1243
+ /** The close a balance sheet in another currency than the market cap converts at, where the EV is bridged here (withBalanceSheetRate). */
1244
+ balanceSheetRate?: BalanceSheetRate;
1245
+ }
1246
+
1247
+ /**
1248
+ * Units of `to` per unit of `from` at our daily FX closes on the balance sheet's `date`, or the last trading day
1249
+ * before it (`closeDate`): what the enterprise value bridge converts a balance sheet's debt and cash at, as Gloom
1250
+ * Cloud's bridge does (CNY/HKD 1.0921 for Pop Mart's June 2026 sheet).
1251
+ */
1252
+ export interface BalanceSheetRate {
1253
+ from: string;
1254
+ to: string;
1255
+ /** YYYY-MM-DD of the balance sheet. */
1256
+ date: string;
1257
+ rate: number;
1258
+ /** YYYY-MM-DD of the close read: `date`, or the trading day before it. */
1259
+ closeDate: string;
1149
1260
  }
1150
1261
 
1151
1262
  export interface OptionContract {
@@ -155,12 +155,28 @@ export interface HeadlessPaneContext {
155
155
  */
156
156
  resolveListing?: (symbol: string, argumentWith: (key: string) => string) => Promise<{ symbol: string; exchange?: string; name?: string; coinNote?: string;
157
157
  /** What became of the company that had the symbol, as `quote` says it ("GOGL was Golden Ocean Group until 2025, now Cmb.Tech: CMBT"). */
158
- successorNote?: string } | null>;
158
+ successorNote?: string;
159
+ /** What the symbol was read as, as `quote` says it ("Read "NDX" as ^NDX:NIM (NASDAQ-100)."). */
160
+ readAs?: string;
161
+ /** The index or future a code a security owns is typed for, as `quote` names it ("also ^MOVE ICE BofA MOVE Index ..."). */
162
+ ownedNotes?: string[];
163
+ /**
164
+ * The symbol is no ticker, as `quote` reads it: the error its quote failed with ("Not a ticker: UNISWAP."), which
165
+ * its series fail with, without asking for their data. The rest of the result is the symbol as typed.
166
+ */
167
+ notATicker?: Error } | null>;
159
168
  /**
160
169
  * What a plugin keeps on this device only (its `ctx.resume` state, never
161
170
  * synced), such as ALRT's log of the alerts the app fired; null when none.
162
171
  */
163
172
  readDeviceState?: <T = unknown>(pluginId: string, key: string) => T | null;
173
+ /**
174
+ * A plugin's saved state as the app left it on this device (its
175
+ * `ctx.persistence.getState`), read only, with when it was saved: NOTE's
176
+ * copy of the Gloom Cloud notes it read last, for a report offline. Null
177
+ * when none, or when this build cannot read it.
178
+ */
179
+ readSavedState?: <T = unknown>(pluginId: string, key: string, schemaVersion?: number) => { value: T; savedAt: number } | null;
164
180
  }
165
181
 
166
182
  export type HeadlessPaneRow = Record<string, unknown>;
@@ -679,6 +695,14 @@ export interface HeadlessSeriesPoint extends HeadlessPaneRow {
679
695
  low?: number | null;
680
696
  close?: number | null;
681
697
  volume?: number | null;
698
+ /** A continuous future's bar (CL=F): the contract it is of (CLZ26). */
699
+ contract?: string | null;
700
+ /** The contract differs from the point before's, the one before the window included: the series rolled on this point. */
701
+ roll?: boolean;
702
+ /** The point is a session still forming, not a close. */
703
+ partial?: boolean;
704
+ /** A formula of futures: each leg's contract and price on this point, in `formulaLegs` order. */
705
+ legs?: ReadonlyArray<{ contract: string | null; price: number }>;
682
706
  }
683
707
 
684
708
  export interface HeadlessSeries {
@@ -700,9 +724,32 @@ export interface HeadlessSeries {
700
724
  valueIsClose?: boolean;
701
725
  /** The series' current value is not meaningful: the report prints N/M dated by the period, and why. */
702
726
  notMeaningful?: { reason: string; asOf: string };
727
+ /**
728
+ * The day the latest value is from, `YYYY-MM-DD`, when its point's own date
729
+ * does not say: a month still forming is dated by its 1st, its value by the
730
+ * quote it ends on (^NDX's November bar by Mon 9 Nov's close).
731
+ */
732
+ latestDate?: string;
733
+ /** A formula of futures: its legs as charted (`RB=F`), which name the exported contract columns of its points' `legs`. */
734
+ formulaLegs?: readonly string[];
735
+ /**
736
+ * A daily count's trailing averages to its latest day, which the text report
737
+ * prints beside the latest value: a single day of transits says little.
738
+ */
739
+ trailing?: HeadlessSeriesTrailing;
703
740
  points: HeadlessSeriesPoint[];
704
741
  }
705
742
 
743
+ /** Daily means over the 7 and 28 days to a series' latest day, and the same 28 days a year before. */
744
+ export interface HeadlessSeriesTrailing {
745
+ avg7: number | null;
746
+ avg28: number | null;
747
+ /** The mean over the 28 days that ended one year before the latest day. */
748
+ yearAgoAvg28: number | null;
749
+ /** `avg28` against `yearAgoAvg28`, in percent. */
750
+ changeVsYearAgoPct: number | null;
751
+ }
752
+
706
753
  export interface HeadlessSeriesResult extends HeadlessPaneResultBase {
707
754
  series: HeadlessSeries[];
708
755
  stats?: Record<string, unknown> | HeadlessPaneEntry[];
@@ -739,9 +786,10 @@ export interface HeadlessPaneDefinition<Shape extends HeadlessPaneShape = Headle
739
786
  * Words that name one case of the function, each with the argument it
740
787
  * takes for it: CTM opens the VIX futures curve for `VX` and `vix
741
788
  * futures`. `fn VX` runs `CTM VIX` and says so, and `catalog vx` lists
742
- * the function first.
789
+ * the function first. A case can also preset options (`fn PDUFA` is
790
+ * `fn CATL --type pdufa`); an option typed after the word wins over it.
743
791
  */
744
- opens?: ReadonlyArray<{ words: readonly string[]; argument: string }>;
792
+ opens?: ReadonlyArray<{ words: readonly string[]; argument: string; options?: Readonly<Record<string, string>> }>;
745
793
  intents?: string[];
746
794
  dataRequirements?: string[];
747
795
  limitations?: string[];
@@ -755,6 +803,12 @@ export interface HeadlessPaneDefinition<Shape extends HeadlessPaneShape = Headle
755
803
  * says what opening the pane does and is used when this is absent.
756
804
  */
757
805
  description?: string;
806
+ /**
807
+ * False keeps the report out of Ask Gloom's tools: it reads text the user
808
+ * wrote for themselves (NOTE's quick notes), which reaches the assistant
809
+ * only when they paste it. `fn` and the exports still run it.
810
+ */
811
+ askGloom?: false;
758
812
  argument: HeadlessPaneArgumentDef;
759
813
  /**
760
814
  * The data covers US listings only, named as a sentence starts ("Time and
@@ -775,6 +829,13 @@ export interface HeadlessPaneDefinition<Shape extends HeadlessPaneShape = Headle
775
829
  * listing: MDAY reads a spread's moves on release days.
776
830
  */
777
831
  fredSeriesArgument?: boolean;
832
+ /**
833
+ * The ticker argument takes a currency pair as its listing (EURUSD=X): a
834
+ * currency typed after a word the catalog matches to this function
835
+ * (`hp eur`) is suggested as its pair. Functions without it keep the word
836
+ * as typed.
837
+ */
838
+ currencyPairs?: boolean;
778
839
  /**
779
840
  * A typed symbol the function reads as another before it is resolved, with
780
841
  * the note that says so: OPX and OVDV read a bare BTC or ETH as the coin
@@ -84,6 +84,12 @@ export interface InstrumentSearchResult {
84
84
  formerName?: string;
85
85
  /** A US listing that no longer trades, found by its exact symbol (TWTR). Untrusted until parsed. */
86
86
  delisting?: ListingDelisting;
87
+ /**
88
+ * A listing its exchange withdrew and gave to no one since (0011 on HKEX,
89
+ * Hang Seng Bank), sent by newer cloud servers on the row a search for its
90
+ * code added: `{ on, reason }`. Untrusted until parsed (parseListingWithdrawal).
91
+ */
92
+ withdrawal?: unknown;
87
93
  /** The company's home line, its common stock on its home exchange (7203 on JPX for Toyota), sent by newer
88
94
  * cloud servers. Search lists it before the company's depositary receipts and other lines. Only `true` counts. */
89
95
  homeListing?: boolean;
@@ -97,6 +97,15 @@ export interface GloomPluginContext {
97
97
  readonly configState: PluginConfigState;
98
98
  readonly paneSettings: PluginPaneSettingsState;
99
99
  readonly teamState: PluginTeamState;
100
+ /**
101
+ * Where the plugin runs: `app` in the terminal or desktop app, `command`
102
+ * while one CLI command (`gloom doctor`, `gloom fn`) loads the plugins and
103
+ * exits. A command keeps nothing running and shows no notification, so a
104
+ * plugin starts no pollers, streams or timers there: an alert one fired
105
+ * would reach no one, and the command could not save that it went off.
106
+ * Absent means `app`.
107
+ */
108
+ readonly runtime?: "app" | "command";
100
109
 
101
110
  createBrokerInstance(brokerType: string, label: string, values: Record<string, unknown>, options?: BrokerInstanceCreateOptions): Promise<BrokerInstanceConfig>;
102
111
  updateBrokerInstance(instanceId: string, values: Record<string, unknown>, options?: BrokerInstanceUpdateOptions): Promise<void>;
@@ -81,6 +81,12 @@ export interface PaneTemplateCreateOptions {
81
81
  listing?: TickerListingRef;
82
82
  /** Template-owned, validated data restored from a public pane share. */
83
83
  shareData?: unknown;
84
+ /**
85
+ * The options a word that names one view of a function presets (`PDUFA`
86
+ * opens CATL with `--type pdufa`, `runway` FA with `--statement liquidity`),
87
+ * applied as `fn` applies them: as settings and as the view state they name.
88
+ */
89
+ preset?: Readonly<Record<string, string>>;
84
90
  }
85
91
 
86
92
  export interface PaneTemplateInstanceConfig {
@@ -88,6 +88,13 @@ export interface PaneDef {
88
88
  * title here, so two of its windows are told apart before either is opened.
89
89
  */
90
90
  instanceTitle?(pane: PaneInstanceConfig): string | null;
91
+ /**
92
+ * The function a saved window stands for as it is now, for its `?` and F1:
93
+ * a workspace whose tabs are functions of their own (Commodities & Energy:
94
+ * FUT, CTM, COT) names its active tab's. Null or absent: the function its
95
+ * title starts with, else the pane's first.
96
+ */
97
+ helpFunction?(pane: PaneInstanceConfig): string | null;
91
98
  /** Renderer-neutral data model used by CLI functions, automation, and hosted tools. */
92
99
  headless?: HeadlessPaneDefinition;
93
100
  /**
@@ -30,6 +30,12 @@ export interface PriceHistoryResult {
30
30
  coverageStart?: string;
31
31
  /** Why nothing before `coverageStart` is served, when the source says: "old-shekel quotes before 1992 are not served". */
32
32
  coverageNote?: string;
33
+ /**
34
+ * The bars stop short of the window asked for: a read of the dates before
35
+ * this day (YYYY-MM-DD) failed, so earlier bars are missing, not absent.
36
+ * The bars from this day on are whole.
37
+ */
38
+ truncatedBefore?: string;
33
39
  /** The source served the pre-market and after-hours bars the request asked for. */
34
40
  extendedHours?: boolean;
35
41
  /**
package/src/ui/host.tsx CHANGED
@@ -576,8 +576,10 @@ export interface HostQueryBarProps {
576
576
  start?: boolean;
577
577
  };
578
578
  onClearAll?: () => void;
579
- /** Muted context at the right edge, e.g. the selected row's date. */
579
+ /** Muted context at the right edge, e.g. the selected row's date. Gives way first. */
580
580
  meta?: string;
581
+ /** The date the data is as of: its own segment before `meta` that never gives way; inline filters collapse to menus first. */
582
+ asOf?: string;
581
583
  /** Drawn before the search and filters, e.g. the ticker the list is about. */
582
584
  leading?: ReactNode;
583
585
  /** Opens one item's menu, e.g. from a pane shortcut. The token changes per request. */
package/src/ui/index.tsx CHANGED
@@ -185,13 +185,18 @@ export const ScrollBox = forwardRef<any, ComponentProps<UiHost["ScrollBox"]>>((p
185
185
  });
186
186
  ScrollBox.displayName = "ScrollBox";
187
187
 
188
- export const Input = forwardRef<any, ComponentProps<UiHost["Input"]>>((props, ref) => {
188
+ export const Input = forwardRef<any, ComponentProps<UiHost["Input"]>>(({
189
+ "data-gloom-remote-hidden": remoteHidden,
190
+ ...props
191
+ }: ComponentProps<UiHost["Input"]> & { "data-gloom-remote-hidden"?: boolean }, ref) => {
189
192
  const { Input: HostInput } = useUiHost();
190
193
  const rawProps = props as Record<string, unknown>;
191
194
  const onInput = rawProps.onInput as ((value: string) => unknown) | undefined;
192
195
  const onChange = rawProps.onChange as ((value: string) => unknown) | undefined;
193
196
  const onSubmit = rawProps.onSubmit as ((value?: string) => unknown) | undefined;
194
- const remoteNodeId = useRemoteUiNode({
197
+ // An owner that registers the field itself (a text field) hides this node,
198
+ // so what was typed is listed once, under the field's own name and type.
199
+ const remoteNodeId = useRemoteUiNode(remoteHidden ? null : {
195
200
  role: remotePropRole(rawProps, "input"),
196
201
  label: remotePropLabel(rawProps),
197
202
  disabled: rawProps.disabled === true,
@@ -1,4 +1,5 @@
1
1
  import { asciiText, localeReadsUtf8 } from "./ascii-text";
2
+ import { withoutControlCharacters } from "./untrusted-text";
2
3
  type CliAlign = "left" | "right" | "center";
3
4
 
4
5
  export interface CliTableColumn {
@@ -235,6 +236,20 @@ function stripAnsi(text: string): string {
235
236
  return text.replace(ANSI_PATTERN, "");
236
237
  }
237
238
 
239
+ /**
240
+ * A value as the CLI prints it in a table or a stats block: the colour codes
241
+ * `cliStyles` put on it stay, and every other control character but the line
242
+ * break and the tab goes (withoutControlCharacters), so a name, a headline or
243
+ * a note from a data source prints as the text it is.
244
+ */
245
+ function cliText(text: string): string {
246
+ if (!text.includes("\x1b")) return withoutControlCharacters(text);
247
+ return text
248
+ .split(ANSI_SPLIT)
249
+ .map((part) => (ANSI_PREFIX.test(part) ? part : withoutControlCharacters(part)))
250
+ .join("");
251
+ }
252
+
238
253
  export function visibleLength(text: string): number {
239
254
  // Bun counts wide glyphs as two cells and skips escape codes; other hosts only need the ASCII case.
240
255
  return typeof Bun !== "undefined" ? Bun.stringWidth(text) : stripAnsi(text).length;
@@ -380,7 +395,8 @@ export function renderSection(title: string): string {
380
395
 
381
396
  /** One aligned label/value line. Prefer renderStats for a block so every value lines up. */
382
397
  export function renderStat(label: string, value: string, labelWidth = 16): string {
383
- return `${cliStyles.muted(padDisplay(label, Math.max(labelWidth, visibleLength(label) + 1)))} ${value}`.trimEnd();
398
+ label = cliText(label);
399
+ return `${cliStyles.muted(padDisplay(label, Math.max(labelWidth, visibleLength(label) + 1)))} ${cliText(value)}`.trimEnd();
384
400
  }
385
401
 
386
402
  export interface CliStatsOptions {
@@ -419,6 +435,7 @@ export function statValueWidth(entries: readonly CliStatEntry[], options: CliSta
419
435
  * on its own line, its value indented under it.
420
436
  */
421
437
  export function renderStats(entries: readonly CliStatEntry[], options: CliStatsOptions = {}): string {
438
+ entries = entries.map(([label, value]) => [cliText(label), cliText(value)] as const);
422
439
  const indent = " ".repeat(options.indent ?? 0);
423
440
  const width = options.width === undefined ? cliTerminalWidth() : options.width;
424
441
  const labelWidth = statLabelWidth(entries, width, indent.length);
@@ -760,6 +777,9 @@ function renderTableLayout(
760
777
  * for arrows and "—" in every empty cell.
761
778
  */
762
779
  export function renderTable(columns: CliTableColumn[], rows: string[][], options: CliTableOptions = {}): string {
780
+ columns = columns.map((column) => ({ ...column, header: cliText(column.header) }));
781
+ rows = rows.map((row) => row.map((cell) => (typeof cell === "string" ? cliText(cell) : cell)));
782
+ if (options.below) options = { ...options, below: options.below.map((lines) => lines?.map(cliText)) };
763
783
  if (cliPlainEnabled()) {
764
784
  const ascii = cliAsciiEnabled();
765
785
  columns = columns.map((column) => ({ ...column, header: plainHeader(column.header, ascii) }));
@@ -72,6 +72,20 @@ export function minorUnitSign(code: string | null | undefined): string | null {
72
72
  return MINOR_UNIT_SIGNS[raw.toUpperCase()] ?? null;
73
73
  }
74
74
 
75
+ /**
76
+ * Whether a terminal can draw a currency sign: one with a character from the
77
+ * last few Unicode versions is left to its code, as monospace fonts lack it.
78
+ * The Saudi riyal's sign (U+20C1, Unicode 17) and the Kyrgyz som's (U+20C0)
79
+ * print as an empty box, beside the left-to-right mark Intl puts before
80
+ * them, so a Tadawul price read "\u200e\u20c1 25.88".
81
+ */
82
+ export function isDrawableCurrencySign(sign: string): boolean {
83
+ return !/[\u20c0-\u20cf]/u.test(sign);
84
+ }
85
+
86
+ /** Bidirectional marks Intl puts around a currency sign (U+200E, U+200F, U+061C and the isolates), which a terminal prints as width. */
87
+ export const BIDI_MARKS = /[\u200e\u200f\u061c\u202a-\u202e\u2066-\u2069]/gu;
88
+
75
89
  /**
76
90
  * A quote currency's code as a column of codes shows it: US cents, a code no
77
91
  * standard has, as US¢; every other code as it is (USD, GBp).
@@ -195,6 +195,17 @@ export function formatDetailDate(value: DisplayDateValue, fallback = "-", timeZo
195
195
  return `${datePart} at ${formatDetailTime(date, fallback, timeZone)}`;
196
196
  }
197
197
 
198
+ /**
199
+ * The host's zone as a time beside it names it ("GMT+8", "EDT", "UTC"), for a
200
+ * column header over times in that zone ("TIME GMT+8"), as `formatDetailTime`
201
+ * names it after one time.
202
+ */
203
+ export function localTimeZoneShortName(now: DisplayDateValue = Date.now(), timeZone?: string): string {
204
+ const date = parseDisplayDate(now) ?? new Date();
205
+ return new Intl.DateTimeFormat("en-US", { timeZoneName: "short", timeZone }).formatToParts(date)
206
+ .find((part) => part.type === "timeZoneName")?.value ?? "UTC";
207
+ }
208
+
198
209
  /** The time of `formatDetailDate` alone, its zone named: "11:38 PM GMT+2", for a day stated beside it. */
199
210
  export function formatDetailTime(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
200
211
  const date = parseDisplayDate(value);
@@ -10,6 +10,35 @@ export interface LogEntry {
10
10
  data?: unknown;
11
11
  }
12
12
 
13
+ /** How many items of a long list a log entry keeps; the rest is only counted. */
14
+ const LOG_LIST_PREVIEW_LENGTH = 5;
15
+
16
+ export interface ListPreview<T> {
17
+ count: number;
18
+ first: T[];
19
+ }
20
+
21
+ /**
22
+ * A long list as its length and first few items. The log keeps each entry's
23
+ * data for its 5,000 entries, so one that names every row of a 300-row list
24
+ * holds those names for as long as the entry lives.
25
+ */
26
+ export function previewList<T, R = T>(
27
+ items: readonly T[],
28
+ map: (item: T) => R = (item) => item as unknown as R,
29
+ ): ListPreview<R> {
30
+ return { count: items.length, first: items.slice(0, LOG_LIST_PREVIEW_LENGTH).map(map) };
31
+ }
32
+
33
+ /** `data` with each list longer than the preview replaced by its length and first items. */
34
+ export function previewLongLists(data: Record<string, unknown>): Record<string, unknown> {
35
+ const preview: Record<string, unknown> = {};
36
+ for (const [key, value] of Object.entries(data)) {
37
+ preview[key] = Array.isArray(value) && value.length > LOG_LIST_PREVIEW_LENGTH ? previewList(value) : value;
38
+ }
39
+ return preview;
40
+ }
41
+
13
42
  type LogListener = (entry: LogEntry) => void;
14
43
  type ConsoleMethod = (...args: unknown[]) => void;
15
44
 
@@ -39,6 +39,8 @@ const PAGES: Readonly<Record<string, (code: string) => ExchangeAnnouncementsPage
39
39
  BSE: () => ({ name: "BSE corporate announcements", url: "https://www.bseindia.com/corporates/ann.html" }),
40
40
  SGX: () => ({ name: "SGX company announcements", url: "https://www.sgx.com/securities/company-announcements" }),
41
41
  SET: () => ({ name: "SET company news", url: "https://www.set.or.th/en/market/news-and-alert/news" }),
42
+ // The Public Disclosure Platform, where every Borsa Istanbul company files its disclosures.
43
+ BIST: () => ({ name: "KAP disclosures", url: "https://www.kap.org.tr/en/bildirim-sorgu" }),
42
44
  };
43
45
 
44
46
  /**
@@ -52,10 +54,31 @@ export function exchangeAnnouncementsPage(symbol: string, exchange: string | nul
52
54
  return page && code ? page(code) : null;
53
55
  }
54
56
 
55
- /** Whether Gloom Cloud lists the company's announcements on this venue (ASX). */
56
- export function listsExchangeAnnouncements(exchange: string | null | undefined): boolean {
57
+ /**
58
+ * Who publishes the announcements Gloom Cloud lists for a listing on this
59
+ * venue, as a source line names them: "ASX" (and Cboe Australia's, which
60
+ * trade under ASX codes), "HKEXnews". Null for a venue it lists none for.
61
+ */
62
+ export function exchangeAnnouncementsPublisher(exchange: string | null | undefined): string | null {
57
63
  const venue = canonicalExchange(exchange ?? "");
58
- return venue === "ASX" || venue === "CXA";
64
+ return venue === "ASX" || venue === "CXA" ? "ASX" : venue === "HKEX" ? "HKEXnews" : null;
65
+ }
66
+
67
+ /** Whether Gloom Cloud lists the company's announcements on this venue (ASX, HKEX). */
68
+ export function listsExchangeAnnouncements(exchange: string | null | undefined): boolean {
69
+ return exchangeAnnouncementsPublisher(exchange) != null;
70
+ }
71
+
72
+ /**
73
+ * HKEXnews' routine returns: a buyback's or a share issue's next day
74
+ * disclosure, and the monthly return of movements in securities. A company
75
+ * buying back shares files one each trading day, so they bury its results
76
+ * and business updates; `filings` leaves them out unless --all.
77
+ */
78
+ const ROUTINE_RETURNS = new Set(["Next Day Disclosure Returns", "Monthly Returns"]);
79
+
80
+ export function isRoutineReturn(item: { category?: string | null }): boolean {
81
+ return item.category != null && ROUTINE_RETURNS.has(item.category);
59
82
  }
60
83
 
61
84
  /**
@@ -1,7 +1,6 @@
1
- // Generated from gloomberb-platform server/src/lib/exchange-notation/table.ts,
2
- // the one table of how venues are written. Do not edit: change the table and
3
- // run server/scripts/exchange-notation.ts write there. A parity test fails
4
- // when this copy is edited by hand.
1
+ // Generated from Gloom Cloud's exchange-notation table, the one table of how
2
+ // venues are written. Do not edit: change the table and regenerate this copy.
3
+ // A parity test fails when it is edited by hand.
5
4
 
6
5
  export interface ExchangeNotation {
7
6
  /** Every spelling read as a venue, by the venue's code. */