gloomberb 0.19.2 → 0.19.4

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 (547) hide show
  1. package/README.md +7 -1
  2. package/package.json +2 -2
  3. package/patches/electrobun@1.18.1.patch +108 -1
  4. package/src/account/upgrade-dialog.tsx +4 -23
  5. package/src/api-client/coalesce.ts +118 -0
  6. package/src/api-client/credit-boards.ts +13 -0
  7. package/src/api-client/crypto-etf-flows.ts +6 -0
  8. package/src/api-client/crypto-markets.ts +40 -0
  9. package/src/api-client/data.ts +201 -14
  10. package/src/api-client/equity-screener.ts +10 -0
  11. package/src/api-client/errors.ts +28 -0
  12. package/src/api-client/gpu.ts +29 -0
  13. package/src/api-client/index.ts +23 -2
  14. package/src/api-client/plan-access.ts +10 -1
  15. package/src/api-client/plan-rules.ts +35 -0
  16. package/src/api-client/request.ts +295 -42
  17. package/src/api-client/research-activity.ts +1 -32
  18. package/src/api-client/socket.ts +95 -0
  19. package/src/api-client/types.ts +21 -1
  20. package/src/app/attention-notice.tsx +94 -0
  21. package/src/app/keybindings/actions.ts +1 -1
  22. package/src/app/pane-runtime/index.tsx +1 -1
  23. package/src/app/pane-runtime/ticker-inspector-runtime.ts +1 -1
  24. package/src/app/pane-runtime/ticker-open-runtime.ts +1 -1
  25. package/src/app/pane-runtime/ticker-open-target.ts +12 -2
  26. package/src/app.tsx +23 -1
  27. package/src/architecture/core-builtin-allowlist.json +2 -1
  28. package/src/capabilities/factories.ts +1 -0
  29. package/src/cli/ascii-output.ts +42 -0
  30. package/src/cli/base-converter.ts +10 -2
  31. package/src/cli/command-options.ts +16 -1
  32. package/src/cli/commands/crypto-hints.ts +23 -4
  33. package/src/cli/commands/market.ts +92 -23
  34. package/src/cli/commands/news-search.ts +24 -5
  35. package/src/cli/commands/overview.ts +9 -4
  36. package/src/cli/commands/search.ts +71 -12
  37. package/src/cli/commands/system.ts +22 -30
  38. package/src/cli/commands/ticker.ts +49 -9
  39. package/src/cli/commands/version.ts +33 -0
  40. package/src/cli/context.ts +5 -9
  41. package/src/cli/data-dir.ts +7 -0
  42. package/src/cli/desktop-pane-shot-api-policy.ts +93 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +320 -0
  44. package/src/cli/desktop-pane-shot-routes.ts +26 -1
  45. package/src/cli/desktop-pane-shot.ts +197 -256
  46. package/src/cli/early-command.ts +42 -0
  47. package/src/cli/earnings-calendar.ts +9 -0
  48. package/src/cli/entry.ts +19 -13
  49. package/src/cli/errors.ts +12 -2
  50. package/src/cli/help.ts +1 -1
  51. package/src/cli/history-export.ts +22 -2
  52. package/src/cli/history-rows.ts +154 -4
  53. package/src/cli/index.ts +18 -1
  54. package/src/cli/known-gaps.ts +40 -5
  55. package/src/cli/listing-arg.ts +46 -9
  56. package/src/cli/options.ts +1 -1
  57. package/src/cli/output-file.ts +60 -13
  58. package/src/cli/pane-functions/catalog.ts +14 -3
  59. package/src/cli/pane-functions/data.ts +1 -1
  60. package/src/cli/pane-functions/dom.ts +45 -0
  61. package/src/cli/pane-functions/freshness.ts +46 -9
  62. package/src/cli/pane-functions/function-help.ts +17 -9
  63. package/src/cli/pane-functions/headless.ts +22 -14
  64. package/src/cli/pane-functions/index.ts +6 -2
  65. package/src/cli/pane-functions/options.ts +6 -2
  66. package/src/cli/pane-functions/resolver.ts +27 -5
  67. package/src/cli/pane-functions/screenshot-assessment.ts +33 -0
  68. package/src/cli/pane-functions/screenshot-bridge.ts +94 -13
  69. package/src/cli/pane-functions/screenshot-http.ts +70 -0
  70. package/src/cli/pane-functions/screenshot-render.ts +19 -5
  71. package/src/cli/quote-answer.ts +20 -0
  72. package/src/cli/registry.ts +41 -13
  73. package/src/cli/result.ts +12 -6
  74. package/src/cli/ticker-resolution.ts +2 -1
  75. package/src/cli/types.ts +2 -0
  76. package/src/components/chart/composite/format.ts +3 -0
  77. package/src/components/chart-table/header.tsx +1 -1
  78. package/src/components/chart-table/layout.ts +28 -11
  79. package/src/components/command-bar/action-runtime.ts +6 -0
  80. package/src/components/command-bar/commands/direct/index.ts +18 -33
  81. package/src/components/command-bar/commands/direct/runtime.ts +8 -3
  82. package/src/components/command-bar/commands/registry.ts +10 -1
  83. package/src/components/command-bar/helpers.ts +2 -0
  84. package/src/components/command-bar/list/model.ts +9 -0
  85. package/src/components/command-bar/pane-actions.ts +46 -35
  86. package/src/components/command-bar/pane-templates/workflow.ts +6 -0
  87. package/src/components/command-bar/panel/index.tsx +30 -3
  88. package/src/components/command-bar/panel/types.ts +7 -0
  89. package/src/components/command-bar/routes/root/command-items.ts +9 -4
  90. package/src/components/command-bar/routes/root/results.ts +4 -4
  91. package/src/components/command-bar/routes/root/runtime.ts +24 -1
  92. package/src/components/command-bar/routes/root/selection.ts +3 -2
  93. package/src/components/command-bar/routes/ticker-search/actions.ts +21 -16
  94. package/src/components/command-bar/routing/launch-request.ts +3 -2
  95. package/src/components/command-bar/routing/list-state.ts +4 -1
  96. package/src/components/command-bar/surface/index.tsx +24 -4
  97. package/src/components/company-logo.tsx +2 -1
  98. package/src/components/layout/floating-pane.tsx +10 -0
  99. package/src/components/layout/header.tsx +8 -3
  100. package/src/components/layout/market-summary.ts +25 -7
  101. package/src/components/layout/pane/footer/index.tsx +7 -2
  102. package/src/components/layout/pane/footer/model.ts +40 -5
  103. package/src/components/layout/pane/frame.tsx +6 -0
  104. package/src/components/layout/pane/header.tsx +244 -42
  105. package/src/components/layout/pane/index.tsx +20 -2
  106. package/src/components/layout/shell/active-drag.ts +128 -27
  107. package/src/components/layout/shell/drag/index.ts +99 -96
  108. package/src/components/layout/shell/drag/live.ts +3 -17
  109. package/src/components/layout/shell/drag/magnets.ts +198 -0
  110. package/src/components/layout/shell/drag/overlays.tsx +77 -75
  111. package/src/components/layout/shell/drag/runtime.ts +12 -7
  112. package/src/components/layout/shell/index.tsx +66 -32
  113. package/src/components/layout/shell/native/pointer-runtime.ts +7 -2
  114. package/src/components/layout/shell/native/surfaces.ts +1 -9
  115. package/src/components/layout/shell/native/window-state.ts +21 -25
  116. package/src/components/layout/shell/pane/layers.tsx +153 -24
  117. package/src/components/layout/shell/shortcuts.ts +4 -1
  118. package/src/components/layout/shell/terminal-pointer-runtime.ts +24 -1
  119. package/src/components/layout/shell/window-mode/overlays.tsx +14 -6
  120. package/src/components/layout/status-bar.tsx +75 -6
  121. package/src/components/market-board/index.tsx +3 -2
  122. package/src/components/onboarding/desks-step.tsx +12 -4
  123. package/src/components/onboarding/first-run-workspace.ts +81 -4
  124. package/src/components/onboarding/onboarding-frame.tsx +2 -1
  125. package/src/components/onboarding/onboarding-keyboard.ts +8 -5
  126. package/src/components/onboarding/onboarding-wizard.tsx +54 -23
  127. package/src/components/onboarding/portfolio-step/positions-panel.tsx +7 -2
  128. package/src/components/onboarding/run-setup-again.ts +24 -0
  129. package/src/components/onboarding/use-onboarding-progress.ts +33 -15
  130. package/src/components/onboarding/use-onboarding-upgrade.ts +2 -6
  131. package/src/components/onboarding/wizard-model.ts +57 -3
  132. package/src/components/onboarding/wizard-positions.ts +1 -1
  133. package/src/components/ui/delayed-mark.tsx +56 -0
  134. package/src/components/ui/external-link.tsx +3 -6
  135. package/src/components/ui/icon.tsx +8 -1
  136. package/src/components/ui/logo-mark.tsx +8 -5
  137. package/src/components/ui/stat-grid.tsx +263 -19
  138. package/src/core/app-runtime.ts +4 -1
  139. package/src/core/connection-health.ts +76 -1
  140. package/src/core/state/app/command-bar-launch.ts +12 -0
  141. package/src/core/state/app/layout.ts +4 -3
  142. package/src/core/state/app/types.ts +4 -1
  143. package/src/data/config/layout.ts +2 -2
  144. package/src/data/config/store/fold-panes.ts +6 -1
  145. package/src/data/config/store/node.ts +11 -5
  146. package/src/data/config/store/normalize.ts +16 -3
  147. package/src/data/profile-permissions.ts +47 -0
  148. package/src/data/resource-store.ts +34 -31
  149. package/src/data/sqlite/access.ts +19 -8
  150. package/src/data/sqlite/checkpointer.ts +95 -8
  151. package/src/data/sqlite/database.ts +40 -7
  152. package/src/docs/snapshot.json +191 -78
  153. package/src/i18n/es.ts +26 -3
  154. package/src/i18n/ja.ts +26 -3
  155. package/src/i18n/ko.ts +26 -3
  156. package/src/i18n/zh-cn.ts +26 -3
  157. package/src/i18n/zh-tw.ts +26 -3
  158. package/src/layout/desk-keys.ts +4 -1
  159. package/src/layout/desks.ts +38 -5
  160. package/src/layout/pane-follow.ts +3 -2
  161. package/src/layout/pane-layout-move.ts +2 -1
  162. package/src/layout/pane-manager/dock-stack.ts +38 -0
  163. package/src/layout/pane-manager/dock-tree.ts +76 -15
  164. package/src/layout/pane-manager/docking.ts +48 -6
  165. package/src/layout/pane-manager/floating-actions.ts +12 -3
  166. package/src/layout/pane-manager/floating-placement.ts +189 -0
  167. package/src/layout/pane-manager/floating.ts +23 -4
  168. package/src/layout/pane-manager/gridlock.ts +16 -4
  169. package/src/layout/pane-manager/hidden-panes.ts +30 -1
  170. package/src/layout/pane-manager/index.ts +2 -0
  171. package/src/layout/pane-manager/layout-state.ts +17 -0
  172. package/src/layout/pane-manager/types.ts +4 -1
  173. package/src/layout/ticker-retarget.ts +88 -0
  174. package/src/layout-marketplace/cloud.ts +9 -1
  175. package/src/layout-marketplace/gallery-desktop.tsx +45 -16
  176. package/src/market-data/batched-reads.ts +16 -0
  177. package/src/market-data/connection-follow.ts +68 -0
  178. package/src/market-data/coordinator/auxiliary.ts +4 -2
  179. package/src/market-data/coordinator/entries.ts +15 -3
  180. package/src/market-data/coordinator/financials.ts +20 -7
  181. package/src/market-data/coordinator/index.ts +228 -6
  182. package/src/market-data/coordinator/quotes.ts +10 -0
  183. package/src/market-data/futures-board.ts +1 -1
  184. package/src/market-data/futures-contract.ts +3 -1
  185. package/src/market-data/hooks.tsx +31 -0
  186. package/src/market-data/market/index-level.ts +6 -4
  187. package/src/market-data/published-apac-sessions.ts +6 -0
  188. package/src/news/aggregator.ts +19 -5
  189. package/src/news/news-model.ts +11 -0
  190. package/src/news/story-id.ts +22 -0
  191. package/src/news/ticker-symbols.ts +17 -1
  192. package/src/notifications/app-notifier.ts +35 -14
  193. package/src/plugins/builtin/account-management/form-components.tsx +1 -1
  194. package/src/plugins/builtin/account-management/index.tsx +2 -3
  195. package/src/plugins/builtin/account-management/model.ts +1 -1
  196. package/src/plugins/builtin/alerts/cli-forms.ts +15 -1
  197. package/src/plugins/builtin/alerts/events-pane.tsx +7 -5
  198. package/src/plugins/builtin/alerts/events.ts +10 -2
  199. package/src/plugins/builtin/alerts/index.tsx +5 -5
  200. package/src/plugins/builtin/alerts/research-builder.ts +5 -1
  201. package/src/plugins/builtin/alerts/research-rules.ts +18 -0
  202. package/src/plugins/builtin/alerts/targets.ts +4 -1
  203. package/src/plugins/builtin/attention/headless.ts +1 -1
  204. package/src/plugins/builtin/attention/index.tsx +2 -4
  205. package/src/plugins/builtin/attention/listing.ts +1 -1
  206. package/src/plugins/builtin/attention/series.ts +1 -1
  207. package/src/plugins/builtin/awards/index.tsx +1 -2
  208. package/src/plugins/builtin/backtest/client.ts +1 -0
  209. package/src/plugins/builtin/backtest/index.tsx +1 -2
  210. package/src/plugins/builtin/backtest/rules.ts +3 -1
  211. package/src/plugins/builtin/backtest/window.ts +8 -7
  212. package/src/plugins/builtin/broker-manager/detail.tsx +16 -3
  213. package/src/plugins/builtin/broker-manager/index.tsx +1 -1
  214. package/src/plugins/builtin/buildout/cells.tsx +5 -0
  215. package/src/plugins/builtin/buildout/company/flow.tsx +367 -0
  216. package/src/plugins/builtin/buildout/company/id.ts +2 -0
  217. package/src/plugins/builtin/buildout/company/model.ts +247 -0
  218. package/src/plugins/builtin/buildout/company/pane.tsx +318 -0
  219. package/src/plugins/builtin/buildout/data-runtime.ts +31 -10
  220. package/src/plugins/builtin/buildout/facilities.ts +309 -0
  221. package/src/plugins/builtin/buildout/format.ts +9 -0
  222. package/src/plugins/builtin/buildout/index.tsx +51 -5
  223. package/src/plugins/builtin/buildout/model/index.ts +68 -10
  224. package/src/plugins/builtin/buildout/model/normalizers.ts +5 -0
  225. package/src/plugins/builtin/buildout/model/types.ts +11 -2
  226. package/src/plugins/builtin/buildout/pane/index.tsx +93 -21
  227. package/src/plugins/builtin/buildout/pane/status.tsx +1 -1
  228. package/src/plugins/builtin/buildout/pane/themes.tsx +110 -0
  229. package/src/plugins/builtin/buildout/table-model.ts +26 -2
  230. package/src/plugins/builtin/builtin-plugin-meta.ts +16 -0
  231. package/src/plugins/builtin/cds/headless.ts +10 -2
  232. package/src/plugins/builtin/cds/model.ts +7 -3
  233. package/src/plugins/builtin/central-bank-rates/index.tsx +1 -2
  234. package/src/plugins/builtin/central-bank-rates/pane.tsx +2 -1
  235. package/src/plugins/builtin/changelog/index.tsx +3 -2
  236. package/src/plugins/builtin/chart-composer/headless-schema.ts +7 -2
  237. package/src/plugins/builtin/chart-composer/headless.ts +88 -21
  238. package/src/plugins/builtin/chart-composer/index.tsx +15 -3
  239. package/src/plugins/builtin/chart-composer/pane.tsx +26 -2
  240. package/src/plugins/builtin/chart-composer/series-expression.ts +3 -2
  241. package/src/plugins/builtin/chart-composer/studies.ts +1 -1
  242. package/src/plugins/builtin/chat/controller/index.ts +11 -4
  243. package/src/plugins/builtin/chat/controller/messages.ts +15 -4
  244. package/src/plugins/builtin/chat/controller/session-runtime.ts +9 -2
  245. package/src/plugins/builtin/chat/ghost-user.ts +8 -0
  246. package/src/plugins/builtin/chat/index.tsx +5 -5
  247. package/src/plugins/builtin/chat/status-widget.tsx +3 -1
  248. package/src/plugins/builtin/clinical-trials/index.tsx +1 -2
  249. package/src/plugins/builtin/cloud/company-picker.tsx +1 -1
  250. package/src/plugins/builtin/cloud/index.tsx +1 -2
  251. package/src/plugins/builtin/cloud/plugin.tsx +6 -4
  252. package/src/plugins/builtin/cloud/team/module.tsx +1 -1
  253. package/src/plugins/builtin/cloud/thesis/module.tsx +1 -1
  254. package/src/plugins/builtin/cloud/trial-offer-status-widget.tsx +24 -1
  255. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +39 -15
  256. package/src/plugins/builtin/comment-letters/index.tsx +1 -2
  257. package/src/plugins/builtin/commodity-balances/index.tsx +3 -3
  258. package/src/plugins/builtin/commodity-balances/pane.tsx +2 -2
  259. package/src/plugins/builtin/congress-trades/aggregates.ts +13 -2
  260. package/src/plugins/builtin/congress-trades/detail.tsx +20 -4
  261. package/src/plugins/builtin/congress-trades/headless.ts +2 -0
  262. package/src/plugins/builtin/congress-trades/model.ts +92 -64
  263. package/src/plugins/builtin/congress-trades/table.tsx +14 -2
  264. package/src/plugins/builtin/connections/index.ts +2 -3
  265. package/src/plugins/builtin/cot/index.tsx +1 -2
  266. package/src/plugins/builtin/cpi/index.tsx +1 -2
  267. package/src/plugins/builtin/credit-boards/cdx-pane.tsx +2 -1
  268. package/src/plugins/builtin/credit-boards/client.ts +7 -2
  269. package/src/plugins/builtin/credit-boards/headless.ts +25 -12
  270. package/src/plugins/builtin/credit-boards/model.ts +29 -0
  271. package/src/plugins/builtin/credit-boards/sovr-pane.tsx +9 -4
  272. package/src/plugins/builtin/crypto-board/bitcoin-network.ts +143 -0
  273. package/src/plugins/builtin/crypto-board/headless.ts +4 -3
  274. package/src/plugins/builtin/crypto-board/index.tsx +4 -2
  275. package/src/plugins/builtin/crypto-board/series.ts +2 -0
  276. package/src/plugins/builtin/crypto-etf-flows/client.ts +9 -2
  277. package/src/plugins/builtin/crypto-etf-flows/headless.ts +61 -6
  278. package/src/plugins/builtin/crypto-etf-flows/index.tsx +1 -2
  279. package/src/plugins/builtin/crypto-etf-flows/model.ts +14 -1
  280. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +8 -5
  281. package/src/plugins/builtin/debt-maturities/headless.ts +4 -3
  282. package/src/plugins/builtin/debt-maturities/model.ts +17 -1
  283. package/src/plugins/builtin/debt-maturities/pane.tsx +18 -4
  284. package/src/plugins/builtin/debug/index.tsx +1 -1
  285. package/src/plugins/builtin/dividend-yield/client.ts +32 -2
  286. package/src/plugins/builtin/dividend-yield/headless.ts +58 -33
  287. package/src/plugins/builtin/dividend-yield/index.tsx +37 -2
  288. package/src/plugins/builtin/dividend-yield/pane.tsx +32 -13
  289. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +73 -0
  290. package/src/plugins/builtin/dividend-yield/ranking-view.tsx +163 -0
  291. package/src/plugins/builtin/dividend-yield/ranking.ts +1 -1
  292. package/src/plugins/builtin/dividend-yield/view.ts +21 -0
  293. package/src/plugins/builtin/docs/index.tsx +2 -3
  294. package/src/plugins/builtin/doe/headless.ts +16 -3
  295. package/src/plugins/builtin/doe/index.tsx +5 -4
  296. package/src/plugins/builtin/earnings/board.tsx +2 -1
  297. package/src/plugins/builtin/earnings/history.tsx +2 -1
  298. package/src/plugins/builtin/earnings-ripple/client.ts +32 -7
  299. package/src/plugins/builtin/earnings-ripple/index.tsx +1 -2
  300. package/src/plugins/builtin/econ/calendar-model.ts +29 -6
  301. package/src/plugins/builtin/econ-statistics/index.tsx +1 -2
  302. package/src/plugins/builtin/equity-screener/client.ts +1 -1
  303. package/src/plugins/builtin/equity-screener/headless.ts +1 -0
  304. package/src/plugins/builtin/equity-screener/ideas.ts +30 -1
  305. package/src/plugins/builtin/equity-screener/index.tsx +1 -2
  306. package/src/plugins/builtin/equity-screener/model.ts +28 -4
  307. package/src/plugins/builtin/equity-screener/pane.tsx +5 -0
  308. package/src/plugins/builtin/equity-screener/screen-check.ts +23 -1
  309. package/src/plugins/builtin/estimate-revisions/index.tsx +1 -2
  310. package/src/plugins/builtin/exposure/holdings.ts +35 -13
  311. package/src/plugins/builtin/exposure/index.tsx +1 -2
  312. package/src/plugins/builtin/fear-greed/cli.ts +44 -0
  313. package/src/plugins/builtin/fear-greed/index.tsx +5 -53
  314. package/src/plugins/builtin/fear-greed/pane.tsx +2 -1
  315. package/src/plugins/builtin/fixed-income/index.tsx +1 -2
  316. package/src/plugins/builtin/futures/board-reads.ts +25 -0
  317. package/src/plugins/builtin/futures/coalesced-bump.ts +44 -0
  318. package/src/plugins/builtin/futures/index.tsx +15 -0
  319. package/src/plugins/builtin/futures/model.ts +14 -0
  320. package/src/plugins/builtin/futures/use-board-terms.ts +22 -15
  321. package/src/plugins/builtin/futures/use-front-returns.ts +20 -14
  322. package/src/plugins/builtin/futures-curve/headless.ts +6 -1
  323. package/src/plugins/builtin/futures-curve/index.tsx +1 -2
  324. package/src/plugins/builtin/fx-matrix/index.tsx +2 -2
  325. package/src/plugins/builtin/gpu/board.tsx +51 -12
  326. package/src/plugins/builtin/gpu/client.ts +15 -2
  327. package/src/plugins/builtin/gpu/equities.tsx +5 -2
  328. package/src/plugins/builtin/gpu/headless.ts +14 -2
  329. package/src/plugins/builtin/gpu/index.tsx +1 -2
  330. package/src/plugins/builtin/gpu/model.ts +20 -2
  331. package/src/plugins/builtin/gpu/pane.tsx +1 -1
  332. package/src/plugins/builtin/help/index.tsx +2 -2
  333. package/src/plugins/builtin/holders/index-holders.ts +24 -12
  334. package/src/plugins/builtin/holders/index.tsx +2 -3
  335. package/src/plugins/builtin/ipo-calendar/index.tsx +1 -2
  336. package/src/plugins/builtin/iv-history/index.tsx +1 -2
  337. package/src/plugins/builtin/jodi/index.tsx +1 -2
  338. package/src/plugins/builtin/kelly-sizer/index.tsx +1 -2
  339. package/src/plugins/builtin/layout-manager/index.tsx +9 -8
  340. package/src/plugins/builtin/macro-day/pane.tsx +4 -2
  341. package/src/plugins/builtin/market-halts/index.tsx +1 -2
  342. package/src/plugins/builtin/market-heatmap/index.tsx +11 -2
  343. package/src/plugins/builtin/market-movers/index.tsx +7 -1
  344. package/src/plugins/builtin/market-movers/session-body.tsx +4 -1
  345. package/src/plugins/builtin/market-valuation/index.tsx +1 -2
  346. package/src/plugins/builtin/members/index.tsx +1 -2
  347. package/src/plugins/builtin/money-markets/index.tsx +1 -2
  348. package/src/plugins/builtin/money-markets/pane.tsx +2 -1
  349. package/src/plugins/builtin/news/headless.ts +7 -0
  350. package/src/plugins/builtin/news/wire/index.tsx +1 -1
  351. package/src/plugins/builtin/news/wire/news/pop-out.tsx +9 -3
  352. package/src/plugins/builtin/notes/index.tsx +3 -6
  353. package/src/plugins/builtin/openfda/index.tsx +1 -2
  354. package/src/plugins/builtin/options/view.tsx +6 -5
  355. package/src/plugins/builtin/options-calculator/index.tsx +1 -2
  356. package/src/plugins/builtin/options-positioning/index.tsx +1 -2
  357. package/src/plugins/builtin/options-scenario/index.tsx +2 -4
  358. package/src/plugins/builtin/perps/index.tsx +1 -2
  359. package/src/plugins/builtin/plugin-marketplace/index.tsx +2 -3
  360. package/src/plugins/builtin/plugin-marketplace/pane.tsx +2 -1
  361. package/src/plugins/builtin/plugin-module.ts +16 -2
  362. package/src/plugins/builtin/portfolio-list/cli/render.ts +53 -3
  363. package/src/plugins/builtin/portfolio-list/index.tsx +1 -2
  364. package/src/plugins/builtin/portfolio-list/pane/index.tsx +11 -0
  365. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +2 -2
  366. package/src/plugins/builtin/power/index.tsx +1 -2
  367. package/src/plugins/builtin/rate-path/index.tsx +1 -2
  368. package/src/plugins/builtin/realized-vol/headless.ts +2 -0
  369. package/src/plugins/builtin/realized-vol/index.tsx +1 -2
  370. package/src/plugins/builtin/realized-vol/model.ts +16 -2
  371. package/src/plugins/builtin/realized-vol/pane.tsx +3 -3
  372. package/src/plugins/builtin/relative-rotation/index.tsx +1 -2
  373. package/src/plugins/builtin/research/analyst-headless.ts +33 -6
  374. package/src/plugins/builtin/research/analyst-model.ts +37 -2
  375. package/src/plugins/builtin/research/analyst-pane.tsx +25 -5
  376. package/src/plugins/builtin/research/index.tsx +5 -8
  377. package/src/plugins/builtin/research-search/index.tsx +1 -2
  378. package/src/plugins/builtin/revenue-breakdown/headless.ts +22 -8
  379. package/src/plugins/builtin/revenue-breakdown/model.ts +23 -0
  380. package/src/plugins/builtin/reverse-dcf/pane.tsx +4 -2
  381. package/src/plugins/builtin/roadmap/index.tsx +2 -3
  382. package/src/plugins/builtin/roadmap/pane.tsx +49 -2
  383. package/src/plugins/builtin/scanner/hilo-model.ts +18 -1
  384. package/src/plugins/builtin/scanner/hilo-pane.tsx +12 -2
  385. package/src/plugins/builtin/scanner/live-pane.tsx +7 -4
  386. package/src/plugins/builtin/sec/filing-content.ts +38 -6
  387. package/src/plugins/builtin/sec/headless.ts +5 -1
  388. package/src/plugins/builtin/sec/index.tsx +4 -2
  389. package/src/plugins/builtin/sec/model.ts +2 -0
  390. package/src/plugins/builtin/sectors/client.ts +18 -8
  391. package/src/plugins/builtin/sectors/index.tsx +30 -10
  392. package/src/plugins/builtin/series-inventory.ts +2 -0
  393. package/src/plugins/builtin/shared/cloud-resource.ts +60 -0
  394. package/src/plugins/builtin/shared/cloud-upgrade.ts +24 -1
  395. package/src/plugins/builtin/shared/forming-bars.ts +29 -0
  396. package/src/plugins/builtin/shared/fx-rate-freshness.ts +17 -0
  397. package/src/plugins/builtin/shared/series-detail-chart.tsx +4 -2
  398. package/src/plugins/builtin/shared/use-quote-board.ts +5 -0
  399. package/src/plugins/builtin/short-interest/publications-pane.tsx +2 -1
  400. package/src/plugins/builtin/short-volume/pane.tsx +2 -1
  401. package/src/plugins/builtin/social-mentions/index.tsx +1 -2
  402. package/src/plugins/builtin/social-mentions/pane.tsx +2 -1
  403. package/src/plugins/builtin/supply-chain/client.ts +22 -1
  404. package/src/plugins/builtin/supply-chain/graph-client.ts +22 -1
  405. package/src/plugins/builtin/supply-chain/index.tsx +1 -2
  406. package/src/plugins/builtin/thirteenf/api.ts +116 -13
  407. package/src/plugins/builtin/thirteenf/data.ts +132 -30
  408. package/src/plugins/builtin/thirteenf/index.tsx +2 -4
  409. package/src/plugins/builtin/thirteenf/model.ts +2 -0
  410. package/src/plugins/builtin/thirteenf/pane.tsx +20 -11
  411. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  412. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +17 -4
  413. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +81 -11
  414. package/src/plugins/builtin/ticker-detail/headless.ts +11 -3
  415. package/src/plugins/builtin/ticker-detail/index.tsx +5 -10
  416. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +4 -1
  417. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -8
  418. package/src/plugins/builtin/time-sales/index.tsx +1 -2
  419. package/src/plugins/builtin/time-sales/pane.tsx +3 -1
  420. package/src/plugins/builtin/trace-bonds/headless.ts +11 -2
  421. package/src/plugins/builtin/trace-bonds/model.ts +44 -10
  422. package/src/plugins/builtin/trace-bonds/pane.tsx +12 -7
  423. package/src/plugins/builtin/treasury-auctions/pane.tsx +2 -2
  424. package/src/plugins/builtin/vol-surface/client.ts +18 -3
  425. package/src/plugins/builtin/vol-surface/index.tsx +1 -2
  426. package/src/plugins/builtin/volatility/index.tsx +1 -2
  427. package/src/plugins/builtin/world-indices/footer.ts +6 -1
  428. package/src/plugins/builtin/world-venue-map/client.ts +10 -1
  429. package/src/plugins/builtin/world-venue-map/index.ts +6 -2
  430. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +48 -7
  431. package/src/plugins/builtin/world-venue-map/layers.ts +17 -0
  432. package/src/plugins/builtin/world-venue-map/local-layers.ts +141 -0
  433. package/src/plugins/builtin/world-venue-map/map-symbols.ts +18 -0
  434. package/src/plugins/builtin/world-venue-map/map.tsx +4 -2
  435. package/src/plugins/builtin/world-venue-map/scope.ts +63 -0
  436. package/src/plugins/builtin/yield-curve/curves.ts +16 -2
  437. package/src/plugins/builtin/yield-curve/headless.ts +3 -3
  438. package/src/plugins/bundle.ts +52 -2
  439. package/src/plugins/catalog-browser.ts +2 -2
  440. package/src/plugins/catalog-cli.ts +20 -0
  441. package/src/plugins/host-link.ts +13 -1
  442. package/src/plugins/installer.ts +15 -4
  443. package/src/plugins/loader.ts +43 -11
  444. package/src/plugins/peer-imports.ts +201 -0
  445. package/src/plugins/peer-retry.ts +26 -29
  446. package/src/plugins/plugin-process.ts +128 -0
  447. package/src/plugins/redirection-guard.ts +45 -0
  448. package/src/react/async-resource.ts +12 -0
  449. package/src/remote/controller.ts +3 -1
  450. package/src/remote/endpoint.ts +16 -3
  451. package/src/renderers/browser/app-services.ts +8 -1
  452. package/src/renderers/browser/cloud-transport.ts +6 -1
  453. package/src/renderers/browser/main.tsx +3 -2
  454. package/src/renderers/cloudflare/http-proxy.ts +7 -123
  455. package/src/renderers/cloudflare/worker.ts +24 -2
  456. package/src/renderers/dom/desktop/icons.tsx +2 -0
  457. package/src/renderers/dom/host/image-surface.tsx +46 -21
  458. package/src/renderers/dom/styles.css +39 -0
  459. package/src/renderers/dom/toast-host.tsx +2 -0
  460. package/src/renderers/electrobun/bun/desktop/backend.ts +7 -1
  461. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -2
  462. package/src/renderers/electrobun/bun/desktop/rpc-timing.ts +88 -0
  463. package/src/renderers/electrobun/bun/desktop/update.ts +20 -4
  464. package/src/renderers/electrobun/bun/desktop/view-ids.ts +8 -4
  465. package/src/renderers/electrobun/bun/external-plugins.ts +4 -0
  466. package/src/renderers/electrobun/bun/window/create.ts +4 -2
  467. package/src/renderers/electrobun/bun/window/native-timing.ts +48 -0
  468. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +82 -4
  469. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +13 -5
  470. package/src/renderers/electrobun/view/desktop/window/snapshot.ts +3 -0
  471. package/src/renderers/electrobun/view/main.tsx +7 -2
  472. package/src/renderers/electrobun/view/remote/asset-data-client.ts +1 -0
  473. package/src/renderers/opentui/browser-open.ts +10 -4
  474. package/src/renderers/opentui/image/surface.tsx +1 -1
  475. package/src/renderers/opentui/start.tsx +12 -6
  476. package/src/renderers/opentui/toast-host.tsx +2 -1
  477. package/src/series/registry.ts +18 -0
  478. package/src/series/standalone.ts +10 -1
  479. package/src/series/types.ts +7 -0
  480. package/src/series/validate.ts +11 -2
  481. package/src/shares/portable-layout.ts +99 -2
  482. package/src/sources/gloomberb-cloud/index.ts +28 -5
  483. package/src/sources/gloomberb-cloud/news.ts +24 -3
  484. package/src/sources/gloomberb-cloud/normalizers.ts +17 -2
  485. package/src/sources/provider-errors.ts +26 -3
  486. package/src/sources/provider-router/history.ts +5 -0
  487. package/src/sources/provider-router/index.ts +15 -2
  488. package/src/sources/provider-router/sources.ts +26 -1
  489. package/src/sync/core-contributors.ts +50 -4
  490. package/src/telemetry/attention-counts.ts +64 -6
  491. package/src/telemetry/attention-setting.ts +33 -0
  492. package/src/telemetry/crash-reports-node.ts +3 -1
  493. package/src/telemetry/stall-clocks.ts +93 -0
  494. package/src/telemetry/stall-reports-node.ts +12 -7
  495. package/src/telemetry/stall-reports.ts +34 -5
  496. package/src/test-support/preload.ts +9 -0
  497. package/src/tickers/company-name.ts +19 -0
  498. package/src/tickers/listing-fate.ts +14 -3
  499. package/src/tickers/saved-instrument.ts +17 -0
  500. package/src/tickers/search/home-listing.ts +13 -2
  501. package/src/tickers/search/index.ts +4 -1
  502. package/src/tickers/search/types.ts +6 -1
  503. package/src/time-series/bar-aggregation.ts +7 -1
  504. package/src/time-series/base-series.ts +3 -3
  505. package/src/time-series/chart-bounds.ts +1 -1
  506. package/src/time-series/chart-data.ts +5 -2
  507. package/src/time-series/chart-seed.ts +1 -1
  508. package/src/time-series/coin-session-close.ts +211 -0
  509. package/src/time-series/live-bars.ts +13 -2
  510. package/src/time-series/live-quotes.ts +1 -1
  511. package/src/time-series/official-close.ts +159 -0
  512. package/src/time-series/price-comparison.ts +55 -6
  513. package/src/time-series/resolve.ts +24 -3
  514. package/src/time-series/series-presentation.ts +1 -1
  515. package/src/time-series/studies/formula.ts +205 -0
  516. package/src/time-series/studies/indicators.ts +299 -0
  517. package/src/time-series/studies/leverage.ts +75 -0
  518. package/src/time-series/studies/pair.ts +138 -0
  519. package/src/time-series/studies/resolve.ts +333 -0
  520. package/src/time-series/studies/shared.ts +141 -0
  521. package/src/time-series/studies/units.ts +243 -0
  522. package/src/time-series/studies/vwap.ts +274 -0
  523. package/src/types/config.ts +35 -3
  524. package/src/types/data-provider.ts +23 -0
  525. package/src/types/financials.ts +22 -0
  526. package/src/types/headless.ts +42 -3
  527. package/src/types/plugin.ts +38 -3
  528. package/src/ui/host.tsx +11 -0
  529. package/src/ui/toast.tsx +26 -1
  530. package/src/utils/ascii-text.ts +140 -0
  531. package/src/utils/cli-output.ts +91 -18
  532. package/src/utils/concurrency.ts +24 -0
  533. package/src/utils/exchanges.ts +6 -0
  534. package/src/utils/external-url.ts +20 -7
  535. package/src/utils/futures-generic.ts +4 -4
  536. package/src/utils/http-proxy-upstream.ts +124 -0
  537. package/src/utils/main-thread-stall.ts +75 -3
  538. package/src/utils/perf-marks.ts +36 -2
  539. package/src/utils/private-files.ts +141 -0
  540. package/src/utils/public-address.ts +99 -0
  541. package/src/account/upgrade-personalization.ts +0 -57
  542. package/src/account/upgrade-tickers.ts +0 -124
  543. package/src/api-client/upgrade-experiment.ts +0 -91
  544. package/src/plugins/builtin/cloud/browser.tsx +0 -3
  545. package/src/renderers/electrobun/launcher/preload.ts +0 -13
  546. package/src/renderers/electrobun/launcher/windows-emulation.ts +0 -50
  547. package/src/time-series/studies.ts +0 -1628
@@ -1,4 +1,5 @@
1
1
  import { logFailure } from "../../utils/log-failure";
2
+ import { createConcurrencyLimiter } from "../../utils/concurrency";
2
3
  import type { CachedAssetArgs, CachedAssetMethod, CachedAssetValue, DataProvider, SecFilingDocument, SecFilingItem } from "../../types/data-provider";
3
4
  import type { CorporateActionsData, OptionsChain, PricePoint, Quote, TickerFinancials } from "../../types/financials";
4
5
  import { fetchHistoryResult, type HistoryResultRequest } from "../../sources/history-result";
@@ -55,6 +56,7 @@ import {
55
56
  classifyError,
56
57
  createAttempt,
57
58
  errorEntry,
59
+ hasFailedLoad,
58
60
  hasFreshEntryData,
59
61
  hasFreshReadyEntry,
60
62
  readyChartEntry,
@@ -83,6 +85,7 @@ import {
83
85
  type QuoteSubscriptionRequest,
84
86
  } from "./quotes";
85
87
  import { withSavedCopyMarkOf } from "../../data/saved-copies";
88
+ import { readsInBatches } from "../batched-reads";
86
89
 
87
90
  /** How long a streamed tick may reuse the quote fields read from the cache. */
88
91
  const STREAM_QUOTE_BASELINE_TTL_MS = 60_000;
@@ -111,6 +114,33 @@ const STREAM_QUOTE_BASELINE_LIMIT = 256;
111
114
  * cap if this ceiling turns out to be too generous for it.
112
115
  */
113
116
  const RETAINED_ENTRIES_PER_STORE = 64;
117
+ /**
118
+ * Past this many remembered reloads, those for keys no pane watches are
119
+ * dropped. A session browses hundreds of symbols; only what is on screen is
120
+ * asked again after an outage.
121
+ */
122
+ const REMEMBERED_RELOADS_PRUNE_AT = 512;
123
+ const outageReloadFailed = logFailure("market-data.coordinator.index", "Loading again after an outage failed");
124
+ /**
125
+ * The least time between two sweeps of what an outage failed
126
+ * (`reloadAfterOutage`): a link that keeps dropping and coming back is asked
127
+ * again once in this window, at its end, not at every flip.
128
+ */
129
+ const OUTAGE_RELOAD_MIN_INTERVAL_MS = 10_000;
130
+ /**
131
+ * How many loads a sweep after an outage runs at once, beside the one batch
132
+ * for quotes and the one for snapshots: a layout of charts and tables must
133
+ * not send its whole backlog in the same instant.
134
+ */
135
+ const OUTAGE_RELOAD_CONCURRENCY = 4;
136
+
137
+ /** How a key a load wrote is asked again after an outage (`reloadAfterOutage`). */
138
+ interface RememberedReload {
139
+ entry: () => QueryEntry<unknown>;
140
+ reload: () => Promise<unknown>;
141
+ /** A quote or snapshot, asked again with the others of its kind in one batch request. */
142
+ batch?: { kind: "quote" | "snapshot"; instrument: InstrumentRef };
143
+ }
114
144
 
115
145
  // A store hands out a fresh idle entry for every key it has never seen, so
116
146
  // two idle reads of the same key must count as the same entry.
@@ -132,6 +162,30 @@ export class MarketDataCoordinator {
132
162
  private destroyed = false;
133
163
  private readonly cachedQueries = new Map<string, { query: CachedQueryHandle<unknown>; dispose: () => void }>();
134
164
  private readonly streamQuoteBaselines = new Map<string, { baseline: TickerFinancials | null; readAt: number }>();
165
+ /**
166
+ * How to ask again for each key a load wrote, so what an outage failed is
167
+ * asked again for the panes still showing it once the data service answers
168
+ * (`reloadAfterOutage`).
169
+ */
170
+ private readonly reloads = new Map<string, RememberedReload>();
171
+ private reloadsPruneAt = REMEMBERED_RELOADS_PRUNE_AT;
172
+ /** When the last sweep after an outage ran, and the one waiting out OUTAGE_RELOAD_MIN_INTERVAL_MS. */
173
+ private lastOutageSweepAt = Number.NEGATIVE_INFINITY;
174
+ private outageSweepTimer: ReturnType<typeof setTimeout> | null = null;
175
+ /** Loads in flight at a sweep that then failed, asked again together. */
176
+ private outageRetries: RememberedReload[] = [];
177
+ private outageRetryTimer: ReturnType<typeof setTimeout> | null = null;
178
+ private readonly outageReloadGate = createConcurrencyLimiter(OUTAGE_RELOAD_CONCURRENCY);
179
+ /** When the data service last answered again after an outage: a failure before it no longer holds a load back. */
180
+ private failuresBefore = 0;
181
+ /**
182
+ * Since when the quote stream has been down, while it is down
183
+ * (`setQuoteStreamDown`): a streamed quote nothing refreshed since reads as
184
+ * stale. Null while the stream runs.
185
+ */
186
+ private quoteStreamDownSince: number | null = null;
187
+ /** Quote entries as read while the stream is down, so each keeps one identity for its readers. */
188
+ private interruptedQuoteEntries = new WeakMap<QueryEntry<Quote>, QueryEntry<Quote>>();
135
189
 
136
190
  private readonly retained: QueryStoreRetention = {
137
191
  maxRetainedEntries: RETAINED_ENTRIES_PER_STORE,
@@ -231,7 +285,39 @@ export class MarketDataCoordinator {
231
285
  }
232
286
 
233
287
  getQuoteEntry(instrument: InstrumentRef): QueryEntry<Quote> {
234
- return this.quoteStore.get(buildQuoteKey(instrument));
288
+ const key = buildQuoteKey(instrument);
289
+ const entry = this.quoteStore.get(key);
290
+ if (!this.isInterruptedQuote(key, entry, [entry])) return entry;
291
+ let interrupted = this.interruptedQuoteEntries.get(entry);
292
+ if (!interrupted) {
293
+ const quote = resolveEntryData(entry)!;
294
+ const stale = { ...quote, stale: true as const };
295
+ interrupted = { ...entry, data: stale, lastGoodData: entry.lastGoodData === quote ? stale : entry.lastGoodData };
296
+ this.interruptedQuoteEntries.set(entry, interrupted);
297
+ }
298
+ return interrupted;
299
+ }
300
+
301
+ /**
302
+ * The quote stream went down at `since`, or runs again (null). While it is
303
+ * down, a quote a pane streams that nothing refreshed since reads as stale,
304
+ * so a price that stopped moving says so instead of passing for live. The
305
+ * held quote itself is kept: the next tick, or a refresh, replaces it.
306
+ */
307
+ setQuoteStreamDown(since: number | null): void {
308
+ if (this.destroyed || this.quoteStreamDownSince === since) return;
309
+ this.quoteStreamDownSince = since;
310
+ this.interruptedQuoteEntries = new WeakMap();
311
+ for (const key of this.quoteSubscriptionManager.streamingKeys()) this.events.bump(key);
312
+ }
313
+
314
+ /** A streamed quote shown from entries none of which was written since the stream went down. */
315
+ private isInterruptedQuote(key: string, quoteEntry: QueryEntry<Quote>, entries: ReadonlyArray<QueryEntry<unknown>>): boolean {
316
+ const since = this.quoteStreamDownSince;
317
+ if (since == null) return false;
318
+ const quote = resolveEntryData(quoteEntry);
319
+ return !!quote && quote.stale !== true && this.quoteSubscriptionManager.isStreaming(key)
320
+ && entries.every((entry) => (entry.fetchedAt ?? 0) <= since);
235
321
  }
236
322
 
237
323
  getSnapshotEntry(instrument: InstrumentRef): QueryEntry<TickerFinancials> {
@@ -276,25 +362,34 @@ export class MarketDataCoordinator {
276
362
  snapshotEntry: QueryEntry<TickerFinancials>;
277
363
  quoteEntry: QueryEntry<Quote>;
278
364
  chartEntry: QueryEntry<PricePoint[]>;
365
+ streamDownSince: number | null;
279
366
  financials: TickerFinancials | null;
280
367
  }>();
281
368
 
282
369
  getTickerFinancialsSync(instrument: InstrumentRef): TickerFinancials | null {
283
370
  const key = buildSnapshotKey(instrument);
371
+ const quoteKey = buildQuoteKey(instrument);
284
372
  const snapshotEntry = this.getSnapshotEntry(instrument);
285
- const quoteEntry = this.getQuoteEntry(instrument);
373
+ // The quote as stored: it is resolved against the snapshot's first, and marked stale after.
374
+ const quoteEntry = this.quoteStore.get(quoteKey);
286
375
  const chartEntry = this.getChartEntry(createBaselineChartRequest(instrument));
376
+ const streamDownSince = this.quoteStreamDownSince;
287
377
  const cached = this.financialsSnapshotCache.get(key);
288
378
  if (
289
379
  cached
290
380
  && sameQueryEntry(cached.snapshotEntry, snapshotEntry)
291
381
  && sameQueryEntry(cached.quoteEntry, quoteEntry)
292
382
  && sameQueryEntry(cached.chartEntry, chartEntry)
383
+ && cached.streamDownSince === streamDownSince
293
384
  ) {
294
385
  return cached.financials;
295
386
  }
296
- const financials = buildTickerFinancialsSnapshot(snapshotEntry, quoteEntry, chartEntry);
297
- this.financialsSnapshotCache.set(key, { snapshotEntry, quoteEntry, chartEntry, financials });
387
+ let financials = buildTickerFinancialsSnapshot(snapshotEntry, quoteEntry, chartEntry);
388
+ // Marked after the quote is resolved: a stale streamed quote must not hand the price back to an older snapshot's.
389
+ if (financials?.quote && financials.quote.stale !== true && this.isInterruptedQuote(quoteKey, quoteEntry, [quoteEntry, snapshotEntry])) {
390
+ financials = { ...financials, quote: { ...financials.quote, stale: true } };
391
+ }
392
+ this.financialsSnapshotCache.set(key, { snapshotEntry, quoteEntry, chartEntry, streamDownSince, financials });
298
393
  return financials;
299
394
  }
300
395
 
@@ -358,6 +453,102 @@ export class MarketDataCoordinator {
358
453
  }
359
454
  }
360
455
 
456
+ /** Remembers how to ask again for `key` (`reloadAfterOutage`). */
457
+ private rememberReload<T>(key: string, store: QueryStore<T>, reload: () => Promise<unknown>, batch?: RememberedReload["batch"]): void {
458
+ this.reloads.set(key, { entry: () => store.get(key), reload, batch });
459
+ if (this.reloads.size <= this.reloadsPruneAt) return;
460
+ for (const remembered of this.reloads.keys()) {
461
+ if (!this.events.hasKeyListeners(remembered)) this.reloads.delete(remembered);
462
+ }
463
+ this.reloadsPruneAt = Math.max(REMEMBERED_RELOADS_PRUNE_AT, this.reloads.size * 2);
464
+ }
465
+
466
+ /**
467
+ * The data service answers again after an outage. A failure from before now
468
+ * no longer holds a load back, and what a pane still shows that failed is
469
+ * asked again (`sweepAfterOutage`), at most once per
470
+ * OUTAGE_RELOAD_MIN_INTERVAL_MS: a recovery inside that window is swept at
471
+ * its end.
472
+ */
473
+ reloadAfterOutage(): void {
474
+ if (this.destroyed) return;
475
+ this.failuresBefore = Date.now();
476
+ if (this.outageSweepTimer) return;
477
+ const waitMs = this.lastOutageSweepAt + OUTAGE_RELOAD_MIN_INTERVAL_MS - Date.now();
478
+ if (waitMs <= 0) {
479
+ this.sweepAfterOutage();
480
+ return;
481
+ }
482
+ const timer = setTimeout(() => {
483
+ this.outageSweepTimer = null;
484
+ this.sweepAfterOutage();
485
+ }, waitMs);
486
+ (timer as { unref?: () => void }).unref?.();
487
+ this.outageSweepTimer = timer;
488
+ }
489
+
490
+ /**
491
+ * Asks again for what a pane still shows that failed, and for what waits on
492
+ * a request sent into the outage, should that request fail. Keys no pane
493
+ * watches are left until something asks.
494
+ */
495
+ private sweepAfterOutage(): void {
496
+ if (this.destroyed) return;
497
+ this.lastOutageSweepAt = Date.now();
498
+ const failed: RememberedReload[] = [];
499
+ for (const [key, remembered] of [...this.reloads]) {
500
+ if (!this.events.hasKeyListeners(key)) {
501
+ this.reloads.delete(key);
502
+ continue;
503
+ }
504
+ const current = remembered.entry();
505
+ if (current.phase === "loading" || current.phase === "refreshing") {
506
+ // Joins the request in flight; a failure it ends in was the outage's.
507
+ void remembered.reload().then(() => {
508
+ if (hasFailedLoad(remembered.entry())) this.retryAfterOutage(remembered);
509
+ }).catch(outageReloadFailed);
510
+ } else if (hasFailedLoad(current)) {
511
+ failed.push(remembered);
512
+ }
513
+ }
514
+ void this.reloadTogether(failed);
515
+ }
516
+
517
+ /** A load in flight at a sweep failed: asked again with the others that fail with it (one deadline, one dropped connection). */
518
+ private retryAfterOutage(remembered: RememberedReload): void {
519
+ if (this.destroyed) return;
520
+ this.outageRetries.push(remembered);
521
+ if (this.outageRetryTimer) return;
522
+ this.outageRetryTimer = setTimeout(() => {
523
+ this.outageRetryTimer = null;
524
+ const retries = this.outageRetries;
525
+ this.outageRetries = [];
526
+ void this.reloadTogether(retries);
527
+ }, 0);
528
+ }
529
+
530
+ /**
531
+ * Asks again for keys an outage failed: the quotes in one batch request,
532
+ * the snapshots in another, and the rest OUTAGE_RELOAD_CONCURRENCY at a
533
+ * time, rather than one request per symbol all at once.
534
+ */
535
+ private async reloadTogether(remembered: readonly RememberedReload[]): Promise<void> {
536
+ const quotes: InstrumentRef[] = [];
537
+ const snapshots: InstrumentRef[] = [];
538
+ const rest: Array<() => Promise<unknown>> = [];
539
+ for (const { batch, reload } of remembered) {
540
+ if (batch?.kind === "quote") quotes.push(batch.instrument);
541
+ else if (batch?.kind === "snapshot") snapshots.push(batch.instrument);
542
+ else rest.push(reload);
543
+ }
544
+ const runs: Array<() => Promise<unknown>> = [...rest];
545
+ if (quotes.length > 0) runs.unshift(() => this.loadQuotesBatch(quotes));
546
+ if (snapshots.length > 0) runs.unshift(() => this.loadSnapshotsBatch(snapshots));
547
+ await Promise.all(runs.map((run) => this.outageReloadGate(async () => {
548
+ if (!this.destroyed) await run();
549
+ }).catch(outageReloadFailed)));
550
+ }
551
+
361
552
  private runSingleFlight<T>(key: string, task: () => Promise<T>): Promise<T> {
362
553
  const existing = this.inFlight.get(key);
363
554
  if (existing) {
@@ -374,12 +565,14 @@ export class MarketDataCoordinator {
374
565
  instrument: InstrumentRef,
375
566
  options: { forceRefresh?: boolean } = {},
376
567
  ): Promise<QueryEntry<TickerFinancials>> {
568
+ this.rememberReload(buildSnapshotKey(instrument), this.snapshotStore, () => this.loadSnapshot(instrument), { kind: "snapshot", instrument });
377
569
  return loadFinancialsSnapshotEntry({
378
570
  dataProvider: this.dataProvider,
379
571
  instrument,
380
572
  options,
381
573
  runSingleFlight: (key, task) => this.runSingleFlight(key, task),
382
574
  stores: this.financialCacheStores,
575
+ failuresBefore: this.failuresBefore,
383
576
  });
384
577
  }
385
578
 
@@ -387,12 +580,16 @@ export class MarketDataCoordinator {
387
580
  instruments: InstrumentRef[],
388
581
  options: { forceRefresh?: boolean } = {},
389
582
  ): Promise<QueryEntry<TickerFinancials>[]> {
583
+ for (const instrument of instruments) {
584
+ this.rememberReload(buildSnapshotKey(instrument), this.snapshotStore, () => this.loadSnapshot(instrument), { kind: "snapshot", instrument });
585
+ }
390
586
  return loadFinancialsSnapshotBatch({
391
587
  dataProvider: this.dataProvider,
392
588
  instruments,
393
589
  options,
394
590
  runSingleFlight: (key, task) => this.runSingleFlight(key, task),
395
591
  stores: this.financialCacheStores,
592
+ failuresBefore: this.failuresBefore,
396
593
  });
397
594
  }
398
595
 
@@ -400,6 +597,7 @@ export class MarketDataCoordinator {
400
597
  instrument: InstrumentRef,
401
598
  options: { forceRefresh?: boolean } = {},
402
599
  ): Promise<QueryEntry<Quote>> {
600
+ this.rememberReload(buildQuoteKey(instrument), this.quoteStore, () => this.loadQuote(instrument), { kind: "quote", instrument });
403
601
  return loadQuoteEntry({
404
602
  dataProvider: this.dataProvider,
405
603
  instrument,
@@ -414,6 +612,9 @@ export class MarketDataCoordinator {
414
612
  instruments: InstrumentRef[],
415
613
  options: { forceRefresh?: boolean } = {},
416
614
  ): Promise<QueryEntry<Quote>[]> {
615
+ for (const instrument of instruments) {
616
+ this.rememberReload(buildQuoteKey(instrument), this.quoteStore, () => this.loadQuote(instrument), { kind: "quote", instrument });
617
+ }
417
618
  return loadQuoteBatchEntries({
418
619
  dataProvider: this.dataProvider,
419
620
  instruments,
@@ -430,6 +631,7 @@ export class MarketDataCoordinator {
430
631
  ): Promise<QueryEntry<PricePoint[]>> {
431
632
  const key = buildChartKey(request);
432
633
  this.chartRequests.set(key, request);
634
+ this.rememberReload(key, this.chartStore, () => this.loadChart(request));
433
635
  const current = this.chartStore.get(key);
434
636
  const currentData = normalizeFreshChartData(resolveEntryData(current), request, current.history, current.fetchedAt);
435
637
  if (!options.forceRefresh && currentData.length > 0 && hasFreshEntryData(current, CHART_CACHE_TTL_MS)) {
@@ -479,11 +681,18 @@ export class MarketDataCoordinator {
479
681
  });
480
682
  }
481
683
 
684
+ /** Whether expiries asked together reach the source in batch requests (`DataProvider.batchesReads`). */
685
+ batchesOptions(): Promise<boolean> {
686
+ return readsInBatches(this.dataProvider, "getOptionsChain");
687
+ }
688
+
689
+ /** `batch`: one of many expiries asked at once, from a source that batches them (`batchesOptions`). */
482
690
  async loadOptions(
483
691
  request: OptionsRequest,
484
- options: { forceRefresh?: boolean } = {},
692
+ options: { forceRefresh?: boolean; batch?: boolean } = {},
485
693
  ): Promise<QueryEntry<OptionsChain>> {
486
694
  const key = buildOptionsKey(request);
695
+ this.rememberReload(key, this.optionsStore, () => this.loadOptions(request, { batch: options.batch }));
487
696
  const loadingKey = options.forceRefresh ? `${key}|refresh` : key;
488
697
  const existing = this.optionsLoads.get(loadingKey);
489
698
  if (existing) return existing;
@@ -511,9 +720,11 @@ export class MarketDataCoordinator {
511
720
  }
512
721
  }
513
722
  }
514
- return this.loadCachedQuery("getOptionsChain", [request.instrument.symbol, request.instrument.exchange, request.expirationDate, toMarketDataContext(request.instrument)], key, this.optionsStore, options.forceRefresh, (value) => value.expirationDates.length === 0) ?? loadOptionsEntry({
723
+ const context = { ...toMarketDataContext(request.instrument), ...(options.batch ? { batch: true } : {}) };
724
+ return this.loadCachedQuery("getOptionsChain", [request.instrument.symbol, request.instrument.exchange, request.expirationDate, context], key, this.optionsStore, options.forceRefresh, (value) => value.expirationDates.length === 0) ?? loadOptionsEntry({
515
725
  dataProvider: this.dataProvider,
516
726
  forceRefresh: options.forceRefresh,
727
+ batch: options.batch,
517
728
  request,
518
729
  store: this.optionsStore,
519
730
  runSingleFlight: (flightKey, task) => this.runSingleFlight(flightKey, task),
@@ -526,6 +737,7 @@ export class MarketDataCoordinator {
526
737
  }
527
738
 
528
739
  async loadSecFilings(request: SecFilingsRequest, options: { forceRefresh?: boolean } = {}): Promise<QueryEntry<SecFilingItem[]>> {
740
+ this.rememberReload(buildSecFilingsKey(request), this.secFilingsStore, () => this.loadSecFilings(request));
529
741
  return this.loadCachedQuery("getSecFilings", [request.instrument.symbol, request.count ?? 50, request.instrument.exchange, toMarketDataContext(request.instrument)], buildSecFilingsKey(request), this.secFilingsStore, options.forceRefresh, (value) => value.length === 0) ?? loadSecFilingsEntry({
530
742
  forceRefresh: options.forceRefresh,
531
743
  dataProvider: this.dataProvider,
@@ -536,6 +748,7 @@ export class MarketDataCoordinator {
536
748
  }
537
749
 
538
750
  async loadSecFilingContent(filing: SecFilingItem, options: { forceRefresh?: boolean } = {}): Promise<QueryEntry<string | null>> {
751
+ this.rememberReload(buildSecContentKey(filing.accessionNumber), this.secContentStore, () => this.loadSecFilingContent(filing));
539
752
  return this.loadCachedQuery("getSecFilingContent", [filing], buildSecContentKey(filing.accessionNumber), this.secContentStore, options.forceRefresh) ?? loadSecFilingContentEntry({
540
753
  forceRefresh: options.forceRefresh,
541
754
  dataProvider: this.dataProvider,
@@ -546,6 +759,7 @@ export class MarketDataCoordinator {
546
759
  }
547
760
 
548
761
  async loadSecFilingDocuments(filing: SecFilingItem, options: { forceRefresh?: boolean } = {}): Promise<QueryEntry<SecFilingDocument[]>> {
762
+ this.rememberReload(buildSecDocumentsKey(filing.accessionNumber), this.secDocumentsStore, () => this.loadSecFilingDocuments(filing));
549
763
  return this.loadCachedQuery("getSecFilingDocuments", [filing], buildSecDocumentsKey(filing.accessionNumber), this.secDocumentsStore, options.forceRefresh, (value) => value.length === 0) ?? loadSecFilingDocumentsEntry({
550
764
  forceRefresh: options.forceRefresh,
551
765
  dataProvider: this.dataProvider,
@@ -556,6 +770,7 @@ export class MarketDataCoordinator {
556
770
  }
557
771
 
558
772
  async loadArticleSummary(url: string): Promise<QueryEntry<string | null>> {
773
+ this.rememberReload(buildArticleSummaryKey(url), this.articleSummaryStore, () => this.loadArticleSummary(url));
559
774
  return this.loadCachedQuery("getArticleSummary", [url], buildArticleSummaryKey(url), this.articleSummaryStore) ?? loadArticleSummaryEntry({
560
775
  dataProvider: this.dataProvider,
561
776
  url,
@@ -565,6 +780,7 @@ export class MarketDataCoordinator {
565
780
  }
566
781
 
567
782
  async loadFxRate(currency: string, options: { forceRefresh?: boolean } = {}): Promise<QueryEntry<number>> {
783
+ this.rememberReload(buildFxKey(currency), this.fxStore, () => this.loadFxRate(currency));
568
784
  return this.loadCachedQuery("getExchangeRate", [currency], buildFxKey(currency), this.fxStore, options.forceRefresh) ?? loadFxRateEntry({
569
785
  dataProvider: this.dataProvider,
570
786
  currency,
@@ -638,6 +854,12 @@ export class MarketDataCoordinator {
638
854
  for (const { dispose } of this.cachedQueries.values()) dispose();
639
855
  this.cachedQueries.clear();
640
856
  this.streamQuoteBaselines.clear();
857
+ this.reloads.clear();
858
+ if (this.outageSweepTimer) clearTimeout(this.outageSweepTimer);
859
+ if (this.outageRetryTimer) clearTimeout(this.outageRetryTimer);
860
+ this.outageSweepTimer = null;
861
+ this.outageRetryTimer = null;
862
+ this.outageRetries = [];
641
863
  for (const timer of this.fxLegTimers.values()) clearTimeout(timer);
642
864
  this.fxLegTimers.clear();
643
865
  }
@@ -247,6 +247,16 @@ export class QuoteSubscriptionManager {
247
247
  return dispose;
248
248
  }
249
249
 
250
+ /** Whether a pane streams this quote key now. */
251
+ isStreaming(key: string): boolean {
252
+ return (this.quoteSubscriptions.get(key)?.targets.size ?? 0) > 0;
253
+ }
254
+
255
+ /** The quote keys panes stream now. */
256
+ streamingKeys(): string[] {
257
+ return [...this.quoteSubscriptions].filter(([, entry]) => entry.targets.size > 0).map(([key]) => key);
258
+ }
259
+
250
260
  private createNoopSubscription(): QuoteSubscriptionHandle {
251
261
  const dispose = (() => {}) as QuoteSubscriptionHandle;
252
262
  dispose.update = () => {};
@@ -104,7 +104,7 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
104
104
 
105
105
  { symbol: "CL=F", code: "CL", name: "WTI Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01, aliases: ["oil"] },
106
106
  { symbol: "BZ=F", code: "BZ", name: "Brent Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
107
- { symbol: "NG=F", code: "NG", name: "Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001 },
107
+ { symbol: "NG=F", code: "NG", name: "Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001, aliases: ["natgas", "nat gas"] },
108
108
  // Quoted in euros per MWh.
109
109
  { symbol: "TTF=F", code: "TTF", name: "Dutch TTF Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001, unit: "EUR / MWh", bareCode: true },
110
110
  { symbol: "RB=F", code: "RB", name: "RBOB Gasoline", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.0001 },
@@ -391,9 +391,11 @@ export function validateFuturesContractTerms(data: FuturesContractTermsPayload):
391
391
  export async function loadFuturesContractTerms(
392
392
  symbol: string,
393
393
  client: Pick<typeof apiClient, "getCloudFuturesContract"> = apiClient,
394
+ /** `batch`: one of many asked at once (a futures board's rows), to go out in a batch request with them. */
395
+ options: { batch?: boolean } = {},
394
396
  ): Promise<FuturesContractTermsPayload> {
395
397
  // The terms are the contract's wherever it is listed: GC=F:CMX asks for GC=F.
396
- return validateFuturesContractTerms(await client.getCloudFuturesContract(parsePublicTickerKey(symbol).symbol));
398
+ return validateFuturesContractTerms(await client.getCloudFuturesContract(parsePublicTickerKey(symbol).symbol, options));
397
399
  }
398
400
 
399
401
  /**
@@ -121,6 +121,37 @@ export function useTickerFinancials(symbol: string | null | undefined, ticker: T
121
121
  return financials;
122
122
  }
123
123
 
124
+ /** Where a ticker's snapshot load stands, for a pane with nothing of it to show yet. */
125
+ export interface TickerSnapshotState {
126
+ /** Asked for, or about to be, with no answer yet. */
127
+ loading: boolean;
128
+ /** Why the last load came back with nothing, or null. */
129
+ error: string | null;
130
+ /** Asks again now, past a recent failure. */
131
+ retry: () => Promise<void>;
132
+ }
133
+
134
+ /** The snapshot load behind `useTickerFinancials`, as its entry stands. */
135
+ export function useTickerSnapshotState(symbol: string | null | undefined, ticker: TickerRecord | null | undefined): TickerSnapshotState {
136
+ const instrument = useTickerInstrument(symbol, ticker);
137
+ const instrumentKey = instrument ? instrumentIdentityKey(instrument) : null;
138
+ const keys = useMemo(() => (instrument ? [buildSnapshotKey(instrument)] : []), [instrumentKey]);
139
+ useCoordinatorKeysVersion(keys);
140
+ const coordinator = getSharedMarketDataCoordinator();
141
+ const entry = coordinator && instrument ? coordinator.getSnapshotEntry(instrument) : null;
142
+ const retry = useCallback(async () => {
143
+ const coordinator = getSharedMarketDataCoordinator();
144
+ if (coordinator && instrument) await coordinator.loadSnapshot(instrument, { forceRefresh: true });
145
+ }, [instrumentKey]);
146
+ const failed = !!entry && (entry.phase === "error" || entry.phase === "ready") && entry.error != null;
147
+ return {
148
+ // Idle is a load the hook is about to start.
149
+ loading: !!entry && (entry.phase === "idle" || entry.phase === "loading" || entry.phase === "refreshing"),
150
+ error: failed ? entry.error!.message : null,
151
+ retry,
152
+ };
153
+ }
154
+
124
155
  function buildTickerFinancialsKeys(tickers: TickerRecord[], options: TickerInstrumentOptions = {}): string[] {
125
156
  const keys: string[] = [];
126
157
  for (const ticker of tickers) {
@@ -1,4 +1,5 @@
1
1
  import { classifyInstrumentType, isCryptoVenuePerpetual } from "../../tickers/instrument-kind";
2
+ import type { PriceBasis } from "../../types/instrument";
2
3
 
3
4
  /**
4
5
  * The unit an index level is in, as a chart's axis and series name it. A
@@ -28,11 +29,12 @@ export function quotePriceCurrency(quote: { currency?: string | null; instrument
28
29
  }
29
30
 
30
31
  /**
31
- * What a price chart of the instrument reads in: points for an index level,
32
- * otherwise its currency, so an axis never puts a dollar sign on ^VIX.
32
+ * What a price chart reads in: the quote's price basis, points for an index
33
+ * level, otherwise its currency.
33
34
  */
34
- export function priceSeriesUnit(currency: string, instrumentType: string | null | undefined): string {
35
- return isIndexLevel(instrumentType) ? INDEX_POINTS_UNIT : currency;
35
+ export function priceSeriesUnit(currency: string, instrumentType: string | null | undefined, priceBasis?: PriceBasis): string {
36
+ if (priceBasis === "thirty-seconds") return "32nds";
37
+ return priceBasis === "points" || isIndexLevel(instrumentType) ? INDEX_POINTS_UNIT : currency;
36
38
  }
37
39
 
38
40
  /**
@@ -21,6 +21,9 @@
21
21
  // EGX closes on Egypt's public holidays, often moved to the Thursday of their
22
22
  // week (Armed Forces Day, Tuesday 6 Oct 2026, to Thursday 8 Oct, by the
23
23
  // exchange's statement of 5 Oct). Its week is Sunday to Thursday.
24
+ // JSE closes on South Africa's public holidays, a Sunday one moving to the Monday (Women's Day, 9 Aug 2026):
25
+ // JSE Market Notice 380/25, JSE Markets Calendar 2026 (clientportal.jse.co.za), and the
26
+ // local government election day, Wed 4 Nov 2026, declared a public holiday on 15 Sep 2026 (gov.za).
24
27
  const KRX_CLOSURES: Record<number, readonly string[]> = {
25
28
  2026: [
26
29
  "01-01", "02-16", "02-17", "02-18", "03-02", "05-01", "05-05", "05-25", "06-03",
@@ -79,6 +82,9 @@ export const PUBLISHED_APAC_CLOSURES: Readonly<Record<string, Record<number, rea
79
82
  2026: ["01-01", "01-26", "04-03", "04-06", "06-08", "12-25", "12-28"],
80
83
  2027: ["01-01", "01-26", "03-26", "03-29", "06-14", "12-27", "12-28"],
81
84
  },
85
+ JSE: {
86
+ 2026: ["01-01", "04-03", "04-06", "04-27", "05-01", "06-16", "08-10", "09-24", "11-04", "12-16", "12-25"],
87
+ },
82
88
  EGX: {
83
89
  2026: [
84
90
  "01-01", "01-07", "01-29", "03-19", "03-22", "03-23", "04-12", "04-13", "05-07",
@@ -1,7 +1,7 @@
1
1
  import type { CompanyFrom } from "../types/company-from";
2
2
  import { logFailure } from "../utils/log-failure";
3
3
  import type { NewsCapability } from "../capabilities";
4
- import type { ConnectionHealthRegistry } from "../core/connection-health";
4
+ import { GLOOM_CLOUD_HTTP_CONNECTION_ID, type ConnectionHealthRegistry } from "../core/connection-health";
5
5
  import type { NewsAccess, NewsArticle, NewsQuery, NewsQueryState } from "./types";
6
6
  import { isAppVisible, subscribeAppVisibility } from "../state/app/activity";
7
7
  import {
@@ -17,6 +17,7 @@ import {
17
17
  normalizeNewsFeed,
18
18
  normalizeNewsQuery,
19
19
  } from "./news-model";
20
+ import { storyIdMatches } from "./story-id";
20
21
 
21
22
  export { buildNewsQueryKey } from "./news-model";
22
23
 
@@ -112,6 +113,7 @@ export class NewsService {
112
113
  private readonly visibility: NonNullable<NewsServiceOptions["visibility"]>;
113
114
  private lastPollAt = 0;
114
115
  private unsubscribeVisibility: (() => void) | null = null;
116
+ private unsubscribeRecovery: (() => void) | null = null;
115
117
  private readonly session?: NewsSessionSignal;
116
118
  private sessionKey: string | null = null;
117
119
  /** Bumped when the session changes; a read from an older generation is dropped. */
@@ -163,6 +165,14 @@ export class NewsService {
163
165
  this.sessionKey = this.session.key();
164
166
  this.unsubscribeSession = this.session.subscribe(() => this.handleSessionChange());
165
167
  }
168
+ // A list that failed while the data service was unreachable is read again once it answers, not at the next poll.
169
+ this.unsubscribeRecovery = this.connectionHealth?.subscribeRecovery((sourceId) => {
170
+ if (sourceId !== GLOOM_CLOUD_HTTP_CONNECTION_ID || !this.polling) return;
171
+ for (const entry of this.queries.values()) {
172
+ // A list missing some of its sources is read again too, keeping what it shows meanwhile.
173
+ if (entry.refs > 0 && entry.state.error != null) void this.refreshQuery(entry.query, entry.state.phase === "error");
174
+ }
175
+ }) ?? null;
166
176
  this.scheduleNextPoll();
167
177
  }
168
178
 
@@ -172,6 +182,8 @@ export class NewsService {
172
182
  this.unsubscribeVisibility = null;
173
183
  this.unsubscribeSession?.();
174
184
  this.unsubscribeSession = null;
185
+ this.unsubscribeRecovery?.();
186
+ this.unsubscribeRecovery = null;
175
187
  this.clearPollTimer();
176
188
  }
177
189
 
@@ -343,16 +355,17 @@ export class NewsService {
343
355
  const sources = this.enabledSources({ feed: "latest" })
344
356
  .filter((source) => !!source.provider.fetchNewsStory);
345
357
 
358
+ // A short id (`6067684e`, as `news` prints it) names the story whose id starts with it.
346
359
  const requestedRevisions = new Map<NewsQueryEntry, string>();
347
360
  for (const entry of this.queries.values()) {
348
- const article = entry.state.articles.find((article) => article.id === storyId);
361
+ const article = entry.state.articles.find((article) => storyIdMatches(article.id, storyId));
349
362
  if (article) requestedRevisions.set(entry, newsArticleRevision(article));
350
363
  }
351
364
  let failed = false;
352
365
  let olderDetail: NewsArticle | null = null;
353
366
  const commitDetail = (article: NewsArticle) => {
354
367
  this.mergeStoryDetail(article, requestedRevisions);
355
- return this.articles.find((current) => current.id === storyId) ?? article;
368
+ return this.articles.find((current) => current.id === article.id) ?? article;
356
369
  };
357
370
  for (const source of sources) {
358
371
  try {
@@ -362,8 +375,9 @@ export class NewsService {
362
375
  () => source.provider.fetchNewsStory?.(storyId) ?? Promise.resolve(null),
363
376
  );
364
377
  if (!article) continue;
365
- if (article.id !== storyId) throw new Error("Story detail identity mismatch.");
366
- const current = this.articles.find((current) => current.id === storyId);
378
+ // The source answers a short id with the full id of the story it starts.
379
+ if (!storyIdMatches(article.id, storyId)) throw new Error("Story detail identity mismatch.");
380
+ const current = this.articles.find((current) => current.id === article.id);
367
381
  if (current && article.publishedAt < current.publishedAt) {
368
382
  if (!olderDetail || article.publishedAt > olderDetail.publishedAt) olderDetail = article;
369
383
  continue;
@@ -245,3 +245,14 @@ export function filterNewsArticlesForQuery(items: NewsArticle[], query: NewsQuer
245
245
  // Page size is a fetch hint. Accumulated load-more results keep MAX_ARTICLES.
246
246
  return filtered.slice(0, MAX_ARTICLES);
247
247
  }
248
+
249
+ /**
250
+ * A story's summary as one line under its row in a text list (`news`,
251
+ * `fn CN`): its whitespace and line breaks run together, null when it has
252
+ * none or only repeats the headline.
253
+ */
254
+ export function newsSummaryLine(article: Pick<NewsArticle, "title" | "summary">): string | null {
255
+ const summary = article.summary?.replace(/\s+/g, " ").trim();
256
+ if (!summary || summary.toLowerCase() === article.title.trim().toLowerCase()) return null;
257
+ return summary;
258
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * A Gloom Cloud story's short id: the first eight characters of its id
3
+ * (`6067684e` for `6067684e-2e13-41c5-a7cf-5052b3cefc07`), which `news`
4
+ * prints on each row and the story pane opens (`fn news-story-pane 6067684e`).
5
+ * Gloom Cloud opens the one story whose id starts with it.
6
+ */
7
+ const SHORT_STORY_ID_LENGTH = 8;
8
+
9
+ const STORY_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
10
+ const SHORT_ID = /^[0-9a-f]{8}$/i;
11
+
12
+ /** The id a row prints: a Gloom Cloud story's short id, any other source's id as it is. */
13
+ export function shortStoryId(id: string): string {
14
+ return STORY_UUID.test(id) ? id.slice(0, SHORT_STORY_ID_LENGTH).toLowerCase() : id;
15
+ }
16
+
17
+ /** Whether `id` is the story `wanted` names, by its full id or its short one, in any case. */
18
+ export function storyIdMatches(id: string, wanted: string): boolean {
19
+ const typed = wanted.trim().toLowerCase();
20
+ const own = id.toLowerCase();
21
+ return own === typed || (SHORT_ID.test(typed) && STORY_UUID.test(own) && own.startsWith(typed));
22
+ }