gloomberb 0.20.7 → 0.20.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -1,5 +1,6 @@
1
1
  import type { PluginModule } from "../plugin-module";
2
- import { moneyMarketsCache } from "./client";
2
+ import { hongKongMoneyMarketsCache, moneyMarketsCache } from "./client";
3
+ import { MONEY_MARKET_TABS } from "./model";
3
4
  import { moneyMarketsHeadless } from "./headless";
4
5
  import { MONEY_MARKET_SERIES } from "./series";
5
6
 
@@ -9,11 +10,11 @@ export const moneyMarketsModule: PluginModule = {
9
10
  defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 88, height: 28 },
10
11
  tableExport: true, headless: moneyMarketsHeadless,
11
12
  settings: { title: "Money Markets", fields: [{ key: "tab", label: "View", type: "select",
12
- options: [{ value: "rates", label: "Rates" }, { value: "bills", label: "Bills" }, { value: "liquidity", label: "Liquidity" }] }] } }],
13
+ options: MONEY_MARKET_TABS.map(({ value, label }) => ({ value, label })) }] } }],
13
14
  paneTemplates: [{ id: "money-markets-pane", paneId: "money-markets", label: "Money Markets",
14
- description: "Funding rates, Treasury bills and Federal Reserve liquidity with historical context.",
15
- keywords: ["btmm", "money", "rates", "bills", "sofr", "liquidity"], shortcut: { prefix: "BTMM" },
15
+ description: "Funding rates, Treasury bills and Federal Reserve liquidity, and Hong Kong's Exchange Fund Bill yields, with historical context.",
16
+ keywords: ["btmm", "money", "rates", "bills", "sofr", "liquidity", "hibor", "hong kong", "hkd", "exchange fund bills", "efb", "hkma"], shortcut: { prefix: "BTMM" },
16
17
  headless: moneyMarketsHeadless }],
17
- setup(ctx) { moneyMarketsCache.attach(ctx.persistence); },
18
- dispose() { moneyMarketsCache.reset(); },
18
+ setup(ctx) { moneyMarketsCache.attach(ctx.persistence); hongKongMoneyMarketsCache.attach(ctx.persistence); },
19
+ dispose() { moneyMarketsCache.reset(); hongKongMoneyMarketsCache.reset(); },
19
20
  };
@@ -3,13 +3,18 @@ import { formatPercentAxis, spanAxisFormatter } from "../../../components/chart-
3
3
  import type { CompositeAxisDomain } from "../../../components/chart/composite/types";
4
4
  import type { CurvePalette, CurveSeries } from "../../../components/chart/curve/model";
5
5
 
6
+ /** A balance in billions to the million under $10B, to the hundred million above. */
7
+ const billionsDigits = (value: number) => Math.abs(value) < 10 ? 3 : 1;
6
8
  export const moneyMarketValue = (value: number | null, unit: MoneyMarketRow["unit"]) => value == null
7
- ? "--" : unit === "percent" ? `${value.toFixed(2)}%` : `$${value.toLocaleString("en-US", { minimumFractionDigits: Math.abs(value) < 10 ? 3 : 1, maximumFractionDigits: Math.abs(value) < 10 ? 3 : 1 })}B`;
9
+ ? "--" : unit === "percent" ? `${value.toFixed(2)}%` : `$${value.toLocaleString("en-US", { minimumFractionDigits: billionsDigits(value), maximumFractionDigits: billionsDigits(value) })}B`;
8
10
  export const moneyMarketChange = (value: number | null, unit: MoneyMarketRow["changeUnit"]) => value == null
9
11
  ? "--" : `${value > 0 ? "+" : ""}${value.toFixed(unit === "usd-billions" && Math.abs(value) < 1 ? 3 : 1)}${unit === "basis-points" ? "bp" : "B"}`;
10
- const formatBillionsAxis = spanAxisFormatter((value, digits) => `$${value.toLocaleString("en-US", { minimumFractionDigits: digits, maximumFractionDigits: digits })}B`);
12
+ const formatBillionsAxis = spanAxisFormatter(
13
+ (value, digits) => `$${value.toLocaleString("en-US", { minimumFractionDigits: digits, maximumFractionDigits: digits })}B`,
14
+ billionsDigits,
15
+ );
11
16
 
12
- /** Axis labels in the board's units, with the decimals the plotted range needs. */
17
+ /** Axis labels in the board's units, with the decimals the plotted range needs; tags at the board's own. */
13
18
  export function moneyMarketAxis(unit: MoneyMarketRow["unit"]): (value: number, domain: CompositeAxisDomain) => string {
14
19
  return unit === "percent" ? formatPercentAxis : formatBillionsAxis;
15
20
  }
@@ -17,10 +22,20 @@ export function moneyMarketAxis(unit: MoneyMarketRow["unit"]): (value: number, d
17
22
  /** A move in a bill's discount yield, in basis points like the board's change column. */
18
23
  export const moneyMarketRateChange = (value: number) => moneyMarketChange(value * 100, "basis-points");
19
24
 
20
- export function moneyMarketNotices(data: MoneyMarketsPayload): string[] {
21
- const notices = [...data.rows, data.netLiquidity].flatMap((row) => row.status === "unavailable"
25
+ /** The board's tabs: the US funding rates, bills and Fed liquidity, and Hong Kong's Exchange Fund Bill yields. */
26
+ export const MONEY_MARKET_TABS = [{ value: "rates", label: "Rates" }, { value: "bills", label: "Bills" }, { value: "liquidity", label: "Liquidity" },
27
+ { value: "hk", label: "Hong Kong" }] as const;
28
+ export const isHongKongTab = (tab: unknown) => tab === "hk";
29
+
30
+ /** Why a row has no figure, or an old one. */
31
+ export function moneyMarketRowNotices(rows: readonly MoneyMarketRow[]): string[] {
32
+ return rows.flatMap((row) => row.status === "unavailable"
22
33
  ? [`${row.label}: ${(row.unavailableReason ?? "unavailable").replaceAll("-", " ")}.`]
23
34
  : row.status === "stale" ? [`${row.label}: stale, last observation ${row.asOf ?? "unknown"}.`] : []);
35
+ }
36
+
37
+ export function moneyMarketNotices(data: MoneyMarketsPayload): string[] {
38
+ const notices = moneyMarketRowNotices([...data.rows, data.netLiquidity]);
24
39
  if (data.billsCurve.status === "unavailable") notices.push("Bills curve: no common observation date across all four tenors.");
25
40
  else if (data.billsCurve.status === "stale") notices.push(`Bills curve: stale, last common observation ${data.billsCurve.asOf}.`);
26
41
  for (const ghost of data.billsCurve.comparisons) if (!ghost.points.length) notices.push(`Bills ${ghost.period}: no common observation within seven days before ${ghost.targetDate ?? "the comparison date"}.`);
@@ -14,10 +14,10 @@ import type { PaneProps } from "../../../types/plugin";
14
14
  import { formatPercentileRank } from "../../../utils/format";
15
15
  import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
16
16
  import { useResearchCloudSession } from "../shared/research-cloud-session";
17
- import { getCachedMoneyMarkets, loadMoneyMarkets } from "./client";
18
- import { moneyMarketAxis, moneyMarketChange, moneyMarketCurves, moneyMarketNotices, moneyMarketObservations, moneyMarketRateChange, moneyMarketRows, moneyMarketValue } from "./model";
17
+ import { getCachedHongKongMoneyMarkets, getCachedMoneyMarkets, loadHongKongMoneyMarkets, loadMoneyMarkets } from "./client";
18
+ import { isHongKongTab, MONEY_MARKET_TABS, moneyMarketAxis, moneyMarketChange, moneyMarketCurves, moneyMarketNotices, moneyMarketObservations, moneyMarketRateChange, moneyMarketRowNotices, moneyMarketRows, moneyMarketValue } from "./model";
19
19
 
20
- const TABS = [{ value: "rates", label: "Rates" }, { value: "bills", label: "Bills" }, { value: "liquidity", label: "Liquidity" }];
20
+ const TABS = MONEY_MARKET_TABS.map(({ value, label }) => ({ value, label }));
21
21
  const PANELS = [{ id: "main" }];
22
22
  const BILLS_CAPTION = "Discount yield % by bill tenor";
23
23
  const formatRate = (value: number) => moneyMarketValue(value, "percent");
@@ -52,7 +52,9 @@ function ObservationDetail({ row, width, height, focused = false }: { row: Money
52
52
  detail: `${formatPercentileRank(p.value, "1Y")} · ${row.asOf ?? "--"}` },
53
53
  { id: "change", label: "Change", value: moneyMarketChange(row.change, row.changeUnit), detail: `since ${row.previousAsOf ?? "--"}` },
54
54
  { id: "range", label: "1Y range", value: `${moneyMarketValue(p.min, row.unit)} to ${moneyMarketValue(p.max, row.unit)}` },
55
- { id: "series", label: "FRED", value: row.sourceSeriesIds.join(", "), detail: row.frequency },
55
+ // A bill yield is HKMA's; the US rows name their FRED series.
56
+ row.group === "efb" ? { id: "series", label: "Source", value: "HKMA", detail: "closing yield, 16:00 HKT" }
57
+ : { id: "series", label: "FRED", value: row.sourceSeriesIds.join(", "), detail: row.frequency },
56
58
  ];
57
59
  return <StatChartDetail items={items} width={width} height={height} empty={row.history.every((point) => point.value == null)}
58
60
  emptySubject="history" emptyTitle="No history available."
@@ -62,13 +64,21 @@ function ObservationDetail({ row, width, height, focused = false }: { row: Money
62
64
  export function MoneyMarketsPane({ width, height, focused }: PaneProps) {
63
65
  const colors = useThemeColors();
64
66
  const session = useResearchCloudSession();
65
- const loader = useCallback((force: boolean) => loadMoneyMarkets(force), [session.requestKey]);
66
- const resource = useAsyncResource(loader, { initialData: getCachedMoneyMarkets, clearOnError: isAccessDenied });
67
67
  const [tab, setTab] = usePaneSettingValue("tab", "rates");
68
+ // Hong Kong's bill yields are their own payload: each payload is read only on its own tabs.
69
+ const hongKong = isHongKongTab(tab);
70
+ const loader = useCallback((force: boolean) => loadMoneyMarkets(force), [session.requestKey]);
71
+ const resource = useAsyncResource(hongKong ? null : loader, { initialData: getCachedMoneyMarkets, clearOnError: isAccessDenied });
72
+ const hongKongLoader = useCallback((force: boolean) => loadHongKongMoneyMarkets(force), [session.requestKey]);
73
+ const hongKongResource = useAsyncResource(hongKong ? hongKongLoader : null, { initialData: getCachedHongKongMoneyMarkets, clearOnError: isAccessDenied });
74
+ const active = hongKong ? hongKongResource : resource;
68
75
  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
69
76
  const [openId, setOpenId] = usePluginPaneState<string | null>("open", null);
70
77
  const data = resource.data?.payload;
71
- const rows = useMemo(() => data ? moneyMarketRows(data, tab).map(boardRow) : [], [data, tab]);
78
+ const hongKongData = hongKongResource.data?.payload;
79
+ const shown = hongKong ? hongKongData : data;
80
+ const rows = useMemo(() => hongKong ? hongKongData?.rows.map(boardRow) ?? []
81
+ : data ? moneyMarketRows(data, tab).map(boardRow) : [], [data, hongKong, hongKongData, tab]);
72
82
  const curves = useMemo(() => data ? moneyMarketCurves(data, { current: colors.positive, ghosts: curveGhostColors(colors) }) : [], [data, colors]);
73
83
  const openRow = rows.find((row) => row.id === openId);
74
84
  const selectedRow = rows.find((row) => row.id === selectedId) ?? rows[0];
@@ -117,23 +127,24 @@ export function MoneyMarketsPane({ width, height, focused }: PaneProps) {
117
127
  empty: `No history for ${selectedRow.label}`,
118
128
  } : null;
119
129
  const figures = billsTab ? billsItems : [];
120
- const updatedAgo = useUpdatedAgo(resource.updatedAt);
130
+ const updatedAgo = useUpdatedAgo(active.updatedAt);
121
131
  const { strip: tabStrip, rows: tabRows } = usePaneTabs({ tabs: TABS, activeValue: tab, onSelect: setTab, focused, dense: true });
122
132
  const bodyHeight = Math.max(3, height - tabRows);
123
- useAutoRefresh(resource.updatedAt, resource.load);
124
- usePaneRefreshKey(() => void resource.reload(), { focused });
133
+ useAutoRefresh(active.updatedAt, active.load);
134
+ usePaneRefreshKey(() => active.reload(), { focused });
125
135
  usePaneNoticeFooter({ registrationId: "money-markets:notices", focused,
126
- notices: [...(data ? moneyMarketNotices(data) : []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
127
- usePaneStatusLinkFooter({ registrationId: "money-markets", focused, loading: resource.loading, error: resource.error,
136
+ notices: [...(hongKong ? hongKongData ? moneyMarketRowNotices(hongKongData.rows) : [] : data ? moneyMarketNotices(data) : []),
137
+ ...(active.data?.refreshError ? [active.data.refreshError] : [])] });
138
+ usePaneStatusLinkFooter({ registrationId: "money-markets", focused, loading: active.loading, error: active.error,
128
139
  url: selected?.observation.sourceUrl ?? null, showOpenHint: true,
129
- info: data && updatedAgo ? [ageFooterSegment(updatedAgo)] : [],
130
- stale: !!data && resource.data?.stale,
140
+ info: shown && updatedAgo ? [ageFooterSegment(updatedAgo)] : [],
141
+ stale: !!shown && active.data?.stale,
131
142
  });
132
143
  return <Box width={width} height={height} flexDirection="column">
133
144
  {tabStrip}
134
- <PaneStatusBody loading={resource.loading && !data} error={!data ? resource.error : null}
135
- empty={!resource.loading && !resource.error && !data} subject="money markets">
136
- {data ? <MarketBoardStack rows={rows} width={width} height={bodyHeight} focused={focused}
145
+ <PaneStatusBody loading={active.loading && !shown} error={!shown ? active.error : null}
146
+ empty={!active.loading && !active.error && !shown} subject={hongKong ? "Hong Kong money markets" : "money markets"}>
147
+ {shown ? <MarketBoardStack rows={rows} width={width} height={bodyHeight} focused={focused}
137
148
  selectedId={selectedRow?.id ?? null} onSelectedIdChange={setSelectedId} openId={openId} onOpenIdChange={setOpenId}
138
149
  changeLabel="Δ OBS" renderDetail={(row) => <ObservationDetail row={row.observation} width={width} height={Math.max(5, bodyHeight - 2)} focused={focused} />}
139
150
  rootBefore={({ columns }) => <ChartTableHeader width={width} height={bodyHeight} figures={figures} chart={chart}
@@ -14,6 +14,13 @@ interface NewsFooterArticle {
14
14
  title?: string | null;
15
15
  source?: string | null;
16
16
  url?: string | null;
17
+ publishedAt?: Date | null;
18
+ }
19
+
20
+ /** Whether a story was out before the free tier's delay: every plan reads it the same, so no delay sits beside it. */
21
+ function publishedBeforeNewsDelay(article: NewsFooterArticle | null | undefined, now = Date.now()): boolean {
22
+ const published = article?.publishedAt?.getTime();
23
+ return published != null && Number.isFinite(published) && now - published >= CLOUD_NEWS_DELAY_HOURS * 3_600_000;
17
24
  }
18
25
 
19
26
  interface UseNewsArticleFooterOptions {
@@ -60,6 +67,7 @@ export function useNewsArticleFooter({
60
67
  shortcutScope: `${registrationId}:news-upgrade`,
61
68
  });
62
69
  const realtime = newsFeedRealtime(feedAccess, access.hasProAccess);
70
+ const storyPastDelay = publishedBeforeNewsDelay(article);
63
71
 
64
72
  // A report or capture of the pane says how far its stories are held back, as the footer does, and dates the
65
73
  // list by its newest story, named so it is not read as the time now.
@@ -78,12 +86,14 @@ export function useNewsArticleFooter({
78
86
  if (realtime === true && !access.isTrialActive) {
79
87
  return [{ id: "news-access", parts: [{ text: t("real-time news"), tone: "positive" }] }];
80
88
  }
89
+ // A story open from before the delay was never held back; the list's delay comes back with the list.
90
+ if (storyPastDelay && !access.isTrialActive) return [];
81
91
  // Held back although the account has Pro (a read that went out before its session): say so, without a pitch.
82
92
  if (feedAccess === "delayed" && access.hasProAccess) {
83
93
  return [delayedFooterSegment({ id: "news-access", detail: tf("{delay} delayed", { delay: delayLabel }), delay: delayLabel })];
84
94
  }
85
95
  return segment ? [segment] : [];
86
- }, [access.hasProAccess, access.isTrialActive, delayLabel, feedAccess, language, realtime, segment]);
96
+ }, [access.hasProAccess, access.isTrialActive, delayLabel, feedAccess, language, realtime, segment, storyPastDelay]);
87
97
  const footerInfo = useMemo(() => [...accessInfo, ...(info ?? [])], [accessInfo, info]);
88
98
 
89
99
  // The story's header names its source, so the footer keeps to the link.
@@ -16,6 +16,7 @@ import { collectNewsDisplayTickers } from "../../../../../news/ticker-symbols";
16
16
  import { useLoadNewsStory } from "../../../../../news/hooks";
17
17
  import { logFailure } from "../../../../../utils/log-failure";
18
18
  import { nextHeaderSort } from "../../../../../utils/sort-values";
19
+ import { localTimeZoneShortName } from "../../../../../utils/datetime-format";
19
20
  import { formatNewsCategoryForColumn } from "../categories";
20
21
  import { useOpenTickerChoice } from "../../../shared/ticker-choice";
21
22
  import { usePinnedMoment } from "../../../../../components/use-pinned-moment";
@@ -123,9 +124,8 @@ const FIXED_COLUMN_WIDTHS: Record<Exclude<NewsColumnId, "title">, number> = {
123
124
  importance: 7,
124
125
  };
125
126
 
126
- const COLUMN_LABELS: Record<NewsColumnId, string> = {
127
+ const COLUMN_LABELS: Record<Exclude<NewsColumnId, "time">, string> = {
127
128
  rank: "#",
128
- time: "TIME",
129
129
  source: "SOURCE",
130
130
  title: "HEADLINE",
131
131
  tickers: "TICKERS",
@@ -138,6 +138,15 @@ const COLUMN_LABELS: Record<NewsColumnId, string> = {
138
138
  const COLUMN_TITLES: Partial<Record<NewsColumnId, string>> = {
139
139
  sentiment: "Sentiment",
140
140
  };
141
+ /**
142
+ * A column's header. The times are the host's, so TIME names its zone
143
+ * ("TIME GMT+8"), as the story's own header names it after its time: a Hong
144
+ * Kong reader's "Wed 11:26" said nothing of which 11:26 (9 Nov 2026).
145
+ */
146
+ function columnLabel(id: NewsColumnId, timeZone?: string): string {
147
+ return id === "time" ? `TIME ${localTimeZoneShortName(Date.now(), timeZone)}` : COLUMN_LABELS[id];
148
+ }
149
+
141
150
  const SPELLED_SENTIMENT = "SENTIMENT";
142
151
  /** A headline at least this wide still reads with SENTIMENT spelled out beside it. */
143
152
  const SPELLED_SENTIMENT_MIN_HEADLINE_WIDTH = 60;
@@ -160,7 +169,8 @@ const NARROW_STEPS: { id: Exclude<NewsColumnId, "title">; width?: number }[] = [
160
169
  { id: "importance" },
161
170
  ];
162
171
 
163
- export function buildColumns(width: number, requestedIds: NewsColumnId[]): NewsTableColumn[] {
172
+ /** `timeZone` is the host's unless named, as the times are. */
173
+ export function buildColumns(width: number, requestedIds: NewsColumnId[], timeZone?: string): NewsTableColumn[] {
164
174
  const widths = { ...FIXED_COLUMN_WIDTHS };
165
175
  let columnIds = requestedIds;
166
176
 
@@ -171,7 +181,7 @@ export function buildColumns(width: number, requestedIds: NewsColumnId[]): NewsT
171
181
  const headlineWidth = () => width + 1 - getTableWidth(columnIds.map((id) => (
172
182
  id === "title"
173
183
  ? { width: 1, align: columnAlign(id) }
174
- : { width: widths[id], label: COLUMN_LABELS[id], align: columnAlign(id) }
184
+ : { width: widths[id], label: columnLabel(id, timeZone), align: columnAlign(id) }
175
185
  )));
176
186
 
177
187
  if (columnIds.includes("title")) {
@@ -200,7 +210,7 @@ export function buildColumns(width: number, requestedIds: NewsColumnId[]): NewsT
200
210
 
201
211
  return columnIds.map((id) => ({
202
212
  id,
203
- label: id === "sentiment" && sentimentSpelled ? SPELLED_SENTIMENT : COLUMN_LABELS[id],
213
+ label: id === "sentiment" && sentimentSpelled ? SPELLED_SENTIMENT : columnLabel(id, timeZone),
204
214
  ...(COLUMN_TITLES[id] && !(id === "sentiment" && sentimentSpelled) ? { title: COLUMN_TITLES[id] } : {}),
205
215
  width: id === "title" ? titleWidth : widths[id],
206
216
  align: columnAlign(id),
@@ -0,0 +1,94 @@
1
+ /**
2
+ * `gloom fn NOTE`: the quick notes the Notes pane opens, read where the pane
3
+ * reads them (Gloom Cloud when signed in, the files on this device otherwise),
4
+ * with no page drawn and no market data waited on.
5
+ */
6
+ import { apiClient } from "../../../api-client";
7
+ import type { HeadlessPaneContext, HeadlessPaneDefinition, HeadlessPaneFreshness, HeadlessPaneRow } from "../../../types/headless";
8
+ import type { PluginPersistence } from "../../../types/plugin";
9
+ import { mapWithConcurrency } from "../../../utils/concurrency";
10
+ import { errorMessage } from "../../../utils/errors";
11
+ import { formatUtcTime } from "../../../utils/utc-time";
12
+ import { NotesFiles } from "./files";
13
+ import { CLOUD_NOTES_CACHE_SCHEMA_VERSION, CloudNotesStore, cloudNotesCacheKey, type NotesStore } from "./store";
14
+
15
+ export const NOTES_FRESHNESS: HeadlessPaneFreshness = { source: "Your notes", status: "not-a-feed", basis: "your notes", local: true };
16
+
17
+ const NOTES_PLUGIN_ID = "notes";
18
+ /** Note bodies read from Gloom Cloud at once: one request each, for a note this device has no current copy of. */
19
+ const CLOUD_NOTE_READS = 4;
20
+
21
+ /** A note's first line with text, which the text report shows; exports keep the whole note. */
22
+ function firstLine(text: string): string {
23
+ return text.split("\n").map((line) => line.trim()).find(Boolean) ?? "";
24
+ }
25
+
26
+ /**
27
+ * The notes plugin's saved state as the app left it, read only: the Cloud
28
+ * store's copy of the notes it read, which answers a note that has not changed
29
+ * since without a request, and every note offline. The report writes nothing.
30
+ */
31
+ function savedNotesState(context: Pick<HeadlessPaneContext, "readSavedState">): Pick<PluginPersistence, "getState" | "setState"> {
32
+ return {
33
+ // A copy: the store edits what it reads before saving it back, which must not reach the app's state.
34
+ getState: <T,>(key: string, options?: { schemaVersion?: number }) => {
35
+ const saved = context.readSavedState?.<T>(NOTES_PLUGIN_ID, key, options?.schemaVersion)?.value;
36
+ return saved == null ? null : structuredClone(saved);
37
+ },
38
+ setState: () => {},
39
+ };
40
+ }
41
+
42
+ /**
43
+ * The store the pane opens, and what the report says of it. A session that
44
+ * checks reads Gloom Cloud; one Gloom Cloud cannot check (offline, the service
45
+ * down) reads the copy this device saved, saying so and when it was saved, as
46
+ * the pane shows it offline; without a session, the files on disk.
47
+ */
48
+ async function personalStore(context: Pick<HeadlessPaneContext, "config" | "readSavedState">): Promise<{ store: NotesStore; offline?: { savedAt: number; reason: string } }> {
49
+ if (!apiClient.getSessionToken()) return { store: new NotesFiles(context.config.dataDir) };
50
+ const saved = savedNotesState(context);
51
+ let user: Awaited<ReturnType<typeof apiClient.ensureVerifiedSession>>;
52
+ try {
53
+ user = await apiClient.ensureVerifiedSession();
54
+ } catch (error) {
55
+ const copy = context.readSavedState?.(NOTES_PLUGIN_ID, cloudNotesCacheKey({ kind: "user" }), CLOUD_NOTES_CACHE_SCHEMA_VERSION);
56
+ if (!copy) throw new Error(`Gloom Cloud could not be reached (${errorMessage(error)}), and this device has no copy of your notes.`);
57
+ return { store: new CloudNotesStore({ kind: "user" }, saved), offline: { savedAt: copy.savedAt, reason: errorMessage(error) } };
58
+ }
59
+ return user ? { store: new CloudNotesStore({ kind: "user" }, saved) } : { store: new NotesFiles(context.config.dataDir) };
60
+ }
61
+
62
+ export const notesHeadless = {
63
+ shape: "rows",
64
+ description: "Your quick notes: each note's title, when it last changed and its text.",
65
+ // A user's notes reach Ask Gloom only when they paste them.
66
+ askGloom: false,
67
+ argument: { kind: "none" },
68
+ options: [],
69
+ columns: [
70
+ { key: "title", header: "Note" },
71
+ { key: "updated", header: "Updated", textFormat: (value) => (typeof value === "string" ? formatUtcTime(value) : "-") },
72
+ { key: "text", header: "Text", textHeader: "First line", shrink: true, textFormat: (value) => firstLine(typeof value === "string" ? value : "") },
73
+ ],
74
+ discovery: { screenshotReadiness: "ready" },
75
+ async load(_args, context) {
76
+ const { store, offline } = await personalStore(context);
77
+ const index = [...await store.loadQuickNotesIndex()].sort((a, b) => (b.updatedAt ?? 0) - (a.updatedAt ?? 0));
78
+ const rows: HeadlessPaneRow[] = await mapWithConcurrency(index, CLOUD_NOTE_READS, async (entry) => ({
79
+ id: entry.id,
80
+ title: entry.title,
81
+ updated: entry.updatedAt ? new Date(entry.updatedAt).toISOString() : null,
82
+ text: (await store.load(store.quickNoteKey(entry.id))).trim(),
83
+ }));
84
+ const savedAt = offline && new Date(offline.savedAt).toISOString();
85
+ return {
86
+ rows,
87
+ empty: "No quick notes yet. Open NOTE in the app to write one.",
88
+ freshness: savedAt ? { ...NOTES_FRESHNESS, asOf: savedAt } : NOTES_FRESHNESS,
89
+ ...(offline ? {
90
+ warnings: [`Gloom Cloud could not be reached (${offline.reason}): these are your notes as this device saved them at ${formatUtcTime(savedAt!)}.`],
91
+ } : {}),
92
+ };
93
+ },
94
+ } satisfies HeadlessPaneDefinition<"rows">;
@@ -3,6 +3,7 @@ import { apiClient } from "../../../api-client";
3
3
  import type { GloomPlugin } from "../../../types/plugin";
4
4
  import { teamStore } from "../../../team/store";
5
5
  import { notesCliCommand } from "./cli";
6
+ import { NOTES_FRESHNESS, notesHeadless } from "./headless";
6
7
  import { exportNotesToDirectory, exportNotice, exportSourceLabel } from "./export";
7
8
  import { NotesFiles } from "./files";
8
9
  import { migrateLocalNotes, notesMigratedAt } from "./migration";
@@ -76,7 +77,7 @@ export const notesPlugin: GloomPlugin = {
76
77
 
77
78
  ctx.registerPane({
78
79
  id: "quick-notes",
79
- reportFreshness: { source: "Your notes", status: "not-a-feed", basis: "your notes", local: true },
80
+ reportFreshness: NOTES_FRESHNESS,
80
81
  name: "Notes",
81
82
  personalData: "messages",
82
83
  icon: "N",
@@ -93,6 +94,7 @@ export const notesPlugin: GloomPlugin = {
93
94
  description: "Open a general-purpose notes scratchpad",
94
95
  keywords: ["notes", "quick", "scratchpad", "memo"],
95
96
  shortcut: { prefix: "NOTE" },
97
+ headless: notesHeadless,
96
98
  createInstance: () => ({ placement: "floating" }),
97
99
  });
98
100
 
@@ -12,7 +12,9 @@ import type { NoteFileEntry, NotesListOptions, QuickNoteEntry } from "./files";
12
12
  export { NoteConflictError };
13
13
 
14
14
  const QUICK_KEY = /^__note-(.+)__$/;
15
- const CACHE_SCHEMA_VERSION = 1;
15
+ /** The schema of a Cloud store's saved copy of its notes (`cloudNotesCacheKey`). */
16
+ export const CLOUD_NOTES_CACHE_SCHEMA_VERSION = 1;
17
+ const CACHE_SCHEMA_VERSION = CLOUD_NOTES_CACHE_SCHEMA_VERSION;
16
18
 
17
19
  /**
18
20
  * What the notes tabs need from wherever notes live. `NotesFiles` is the disk
@@ -51,6 +53,11 @@ export function noteOwnerKey(owner: NoteOwner): string {
51
53
  return owner.kind === "user" ? "user" : `team:${owner.teamId}`;
52
54
  }
53
55
 
56
+ /** The plugin state key under which a Cloud store keeps its copy of an owner's notes, which it reads offline. */
57
+ export function cloudNotesCacheKey(owner: NoteOwner): string {
58
+ return `notes:cache:${noteOwnerKey(owner)}`;
59
+ }
60
+
54
61
  function noteOwnerScope(owner: NoteOwner): CloudNoteScope {
55
62
  return owner.kind === "user" ? { scope: "user" } : { scope: "team", teamId: owner.teamId };
56
63
  }
@@ -88,7 +95,7 @@ export class CloudNotesStore implements NotesStore {
88
95
 
89
96
  constructor(
90
97
  readonly owner: NoteOwner,
91
- private readonly persistence: PluginPersistence | null,
98
+ private readonly persistence: Pick<PluginPersistence, "getState" | "setState"> | null,
92
99
  private readonly client: Pick<typeof apiClient, "isVerified" | "listCloudNotes" | "getCloudNote" | "putCloudNote" | "deleteCloudNote"> = apiClient,
93
100
  ) {}
94
101
 
@@ -97,7 +104,7 @@ export class CloudNotesStore implements NotesStore {
97
104
  }
98
105
 
99
106
  private get cacheKey(): string {
100
- return `notes:cache:${noteOwnerKey(this.owner)}`;
107
+ return cloudNotesCacheKey(this.owner);
101
108
  }
102
109
 
103
110
  private readCache(): Cache {
@@ -1,6 +1,6 @@
1
1
  import { useMemo } from "react";
2
2
  import type { PaneFooterSegment, PaneHint } from "../../../components";
3
- import { delayedFooterSegment } from "../../../components/layout/pane/footer/model";
3
+ import { delayedFooterSegment, savedCopyFooterSegment } from "../../../components/layout/pane/footer/model";
4
4
  import { t, tf } from "../../../i18n";
5
5
  import type { OptionsChain } from "../../../types/financials";
6
6
  import { formatRelativeTime } from "../../../utils/datetime-format";
@@ -91,6 +91,7 @@ export function useOptionsAccessFooter({
91
91
  loading,
92
92
  quoteCoverage,
93
93
  reference,
94
+ savedAt,
94
95
  spreadColumnVisible,
95
96
  }: {
96
97
  /** The chain is a broker profile's, quoted by that broker: it has no Gloom Cloud delay to report or upgrade from. */
@@ -103,6 +104,8 @@ export function useOptionsAccessFooter({
103
104
  quoteCoverage: Pick<OptionQuoteCoverage, "status">;
104
105
  /** The contract under the cursor, reported as status rather than as a header. */
105
106
  reference?: OptionMarketReference | undefined;
107
+ /** When the chain shown was saved, if a refresh that could not get through left it standing. */
108
+ savedAt?: number | null;
106
109
  /** Set while the chain prints a SPRD column, so the status bar stops repeating it. */
107
110
  spreadColumnVisible?: boolean;
108
111
  }): void {
@@ -130,7 +133,10 @@ export function useOptionsAccessFooter({
130
133
  // stream; the registration compares by value, so only a changed label
131
134
  // reaches the footer. Access leads: for a free account it is the pressable
132
135
  // upgrade segment, and the info row truncates from the right.
133
- const info = [...accessInfo, ...optionContractFooterSegments(reference, spreadColumnVisible)];
136
+ const info = [
137
+ ...(savedAt != null ? [savedCopyFooterSegment("options-saved-copy", savedAt)] : []),
138
+ ...accessInfo, ...optionContractFooterSegments(reference, spreadColumnVisible),
139
+ ];
134
140
 
135
141
  usePaneStatusFooter({
136
142
  registrationId: "options",
@@ -2,6 +2,7 @@ import type { OptionsChain } from "../../../types/financials";
2
2
  import { formatCalendarDay } from "./model-spot";
3
3
  import { loadOpenInterest, type OpenInterestPayload, type OptionsPositioningApi } from "../options-positioning/client";
4
4
  import { logFailure } from "../../../utils/log-failure";
5
+ import { abortable, withDeadline } from "../../../utils/async-deadline";
5
6
 
6
7
  /**
7
8
  * The session a chain's open interest is counted at
@@ -55,14 +56,22 @@ export function chainOpenInterestAsOf(
55
56
  /** How long a chain waits for OPX's listing before it leaves the open-interest date unstated. */
56
57
  const LISTED_TIMEOUT_MS = 8_000;
57
58
 
58
- /** OPX's listed open interest for one expiry; null when it cannot be read in time or names another expiry. */
59
+ /**
60
+ * OPX's listed open interest for one expiry; null when it cannot be read in
61
+ * time or names another expiry. The request is the one OPX shares for the
62
+ * symbol and expiry, so the deadline and `signal` stop this wait only: the
63
+ * request runs on for OPX, which an abort of it would fail.
64
+ */
59
65
  export async function loadListedOpenInterest(
60
66
  symbol: string,
61
67
  expiry: string,
62
- options: { signal?: AbortSignal; api?: OptionsPositioningApi } = {},
68
+ options: { signal?: AbortSignal; api?: OptionsPositioningApi; timeoutMs?: number } = {},
63
69
  ): Promise<OpenInterestPayload | null> {
64
70
  try {
65
- const listed = await loadOpenInterest(symbol, expiry, { signal: options.signal ?? AbortSignal.timeout(LISTED_TIMEOUT_MS) }, options.api);
71
+ // A saved copy is dated by its own session: the counts it is matched against still say whether it is the chain's.
72
+ const { payload: listed } = await withDeadline(
73
+ abortable(loadOpenInterest(symbol, expiry, {}, options.api), options.signal, "Listed open interest no longer needed"),
74
+ options.timeoutMs ?? LISTED_TIMEOUT_MS, "Listed open interest did not arrive in time");
66
75
  return listed.expiry === expiry ? listed : null;
67
76
  } catch (error) {
68
77
  logFailure("options.open-interest-as-of", "Load listed open interest failed")(error);
@@ -16,6 +16,7 @@ import {
16
16
  COIN_OPTIONS_HINT, isCoinWithoutOptions, isOptionsUnavailableError, listedOptionsAlternative, optionsUnavailableTitle,
17
17
  } from "../../../market-data/options-alternatives";
18
18
  import { useChartQueries, useOptionsQuery, useResolvedEntryValue, useTickerFinancials } from "../../../market-data/hooks";
19
+ import { savedCopyEntryAt } from "../../../market-data/coordinator";
19
20
  import {
20
21
  Button,
21
22
  DataTableView,
@@ -380,8 +381,15 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
380
381
  // The body names the dates nearest the one asked for; the footer only flags it.
381
382
  const unavailableExpiry = expirationUnavailable && selectedExpiration != null
382
383
  ? sentenceCase(missingExpiryText(selectedExpiration, availableExpirations)) : null;
384
+ // A chain kept because the refresh could not get through (offline, a timeout) is a saved copy the footer dates,
385
+ // not an error; any other failure stays the error beside the old chain.
386
+ const initialSavedAt = savedCopyEntryAt(initialChainEntry);
387
+ const expirationSavedAt = savedCopyEntryAt(expirationChainEntry);
388
+ const chainSavedAt = initialSavedAt == null ? expirationSavedAt
389
+ : expirationSavedAt == null ? initialSavedAt : Math.min(initialSavedAt, expirationSavedAt);
383
390
  const error = (expirationUnavailable ? `Expiry ${expiryIsoDate(selectedExpiration!)} unavailable` : null)
384
- ?? initialChainEntry?.error?.message ?? expirationChainEntry?.error?.message
391
+ ?? (initialSavedAt == null ? initialChainEntry?.error?.message : null)
392
+ ?? (expirationSavedAt == null ? expirationChainEntry?.error?.message : null)
385
393
  ?? (initialChainEntry?.phase === "error" || expirationChainEntry?.phase === "error"
386
394
  ? "Failed to load options" : null);
387
395
 
@@ -861,6 +869,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
861
869
  loading,
862
870
  quoteCoverage: optionQuoteCoverage,
863
871
  reference: selectedReference,
872
+ savedAt: chainSavedAt,
864
873
  spreadColumnVisible: optionFieldIds.includes("spread"),
865
874
  });
866
875
 
@@ -272,7 +272,7 @@ export function OptionsCalculatorPane({ focused, width, height }: PaneProps) {
272
272
  scope: "options-calculator:fields",
273
273
  });
274
274
 
275
- usePaneRefreshKey(() => { void surfaceResource.reload(); }, { focused: focused && !commandBarOpen && surfaceSource && activeFieldId === null });
275
+ usePaneRefreshKey(() => { surfaceResource.reload(); }, { focused: focused && !commandBarOpen && surfaceSource && activeFieldId === null });
276
276
  usePaneFooter(OPTIONS_CALCULATOR_PANE_ID, () => ({
277
277
  info: [
278
278
  ...(problem ? [{ id: "input", parts: [{ text: problem, tone: "warning" as const }] }] : []),
@@ -1,5 +1,7 @@
1
1
  import { apiClient } from "../../../api-client";
2
+ import { createPluginCache } from "../../../data/plugin-cache";
2
3
  import { usListingSymbol } from "../../../utils/sec";
4
+ import { loadCloudResource, type CloudResource } from "../shared/cloud-resource";
3
5
 
4
6
  export interface ExpiryOpenInterest {
5
7
  date: string;
@@ -128,22 +130,47 @@ export const positioningSymbol = (symbol: string) => usListingSymbol(symbol, "Op
128
130
  const query = (symbol: string, expiry: string | null) =>
129
131
  new URLSearchParams({ symbol: positioningSymbol(symbol), ...(expiry ? { expiry } : {}) }).toString();
130
132
 
131
- /** Every expiry's open interest, and one expiry's strikes (the server's pick when none is asked for). */
133
+ /**
134
+ * The last answer for each symbol and expiry, kept so OPX still shows it,
135
+ * saying when it was saved, when the service cannot be reached. Every load
136
+ * asks the service first: open interest and gamma move through the session.
137
+ */
138
+ const cacheOptions = { source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 0, expireMs: 2 * 86_400_000 } };
139
+ export const openInterestCache = createPluginCache<OpenInterestPayload>({ ...cacheOptions, kind: "options-positioning-open-interest" });
140
+ export const gammaCache = createPluginCache<GammaPayload>({ ...cacheOptions, kind: "options-positioning-gamma" });
141
+
142
+ interface PositioningLoadOptions {
143
+ signal?: AbortSignal;
144
+ /** Ask the service even when another load of the same answer is under way. */
145
+ force?: boolean;
146
+ }
147
+
148
+ /**
149
+ * Every expiry's open interest, and one expiry's strikes (the server's pick
150
+ * when none is asked for); the saved copy, with `savedAt`, when the service
151
+ * cannot be reached.
152
+ */
132
153
  export function loadOpenInterest(
133
154
  symbol: string,
134
155
  expiry: string | null,
135
- options: { signal?: AbortSignal } = {},
156
+ options: PositioningLoadOptions = {},
136
157
  api: OptionsPositioningApi = apiClient,
137
- ) {
138
- return api.optionsPositioning<OpenInterestPayload>(`open-interest?${query(symbol, expiry)}`, { signal: options.signal });
158
+ ): Promise<CloudResource<OpenInterestPayload>> {
159
+ const key = query(symbol, expiry);
160
+ return loadCloudResource(openInterestCache, key,
161
+ () => api.optionsPositioning<OpenInterestPayload>(`open-interest?${key}`, { signal: options.signal }),
162
+ { force: options.force, signal: options.signal });
139
163
  }
140
164
 
141
- /** Dealer gamma by strike across every expiry, or one. */
165
+ /** Dealer gamma by strike across every expiry, or one; the saved copy, with `savedAt`, when the service cannot be reached. */
142
166
  export function loadGamma(
143
167
  symbol: string,
144
168
  expiry: string | null,
145
- options: { signal?: AbortSignal } = {},
169
+ options: PositioningLoadOptions = {},
146
170
  api: OptionsPositioningApi = apiClient,
147
- ) {
148
- return api.optionsPositioning<GammaPayload>(`gamma?${query(symbol, expiry)}`, { signal: options.signal });
171
+ ): Promise<CloudResource<GammaPayload>> {
172
+ const key = query(symbol, expiry);
173
+ return loadCloudResource(gammaCache, key,
174
+ () => api.optionsPositioning<GammaPayload>(`gamma?${key}`, { signal: options.signal }),
175
+ { force: options.force, signal: options.signal });
149
176
  }