gloomberb 0.20.2 → 0.20.3

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 (362) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -219,6 +219,11 @@ export interface HeadlessPaneColumn {
219
219
  unitKey?: string;
220
220
  /** With `unitKey`: always a `<header> unit` column, so the header is the same whichever rows loaded. */
221
221
  unitColumn?: boolean;
222
+ /**
223
+ * CSV and NDJSON write the figure to the digits `format` draws (-315.12 for -315.12046875), as it is read on
224
+ * screen; JSON keeps the row's figure whole.
225
+ */
226
+ exportAsShown?: boolean;
222
227
  /**
223
228
  * The text report prints the value on its own lines under the row instead
224
229
  * of in a column, for a footnote that belongs to that row; an empty value
@@ -240,6 +245,13 @@ export interface HeadlessPaneEntry {
240
245
  * rather than read back the number `formatted` draws.
241
246
  */
242
247
  unit?: string;
248
+ /**
249
+ * The unit an export names in `currency_or_unit` for a figure written as
250
+ * `formatted` draws it, where `value` is not in that unit and `unit` would
251
+ * rescale what JSON keeps: a ratio drawn as a percent (`pct`). Named only
252
+ * beside a number; a figure missing with its reason has no unit.
253
+ */
254
+ exportUnit?: string;
243
255
  /**
244
256
  * In a report with `exportDated`, where this line is not of the section's own period and release (a previous
245
257
  * reading, a year ago): the period it covers, when it was released and what it is as of. A null `released`
package/src/ui/host.tsx CHANGED
@@ -462,6 +462,8 @@ interface HostTabItem {
462
462
  value: string;
463
463
  /** Artwork before the label, such as a logo; decoration only. */
464
464
  leading?: ReactNode;
465
+ /** The key the label starts with (`⌘1 `), hidden on a touch screen. */
466
+ keyPrefix?: string;
465
467
  disabled?: boolean;
466
468
  reorderable?: boolean;
467
469
  onClose?: (value: string) => void;
@@ -695,6 +697,10 @@ export interface UiHost {
695
697
  DialogFrame?: ComponentType<any>;
696
698
  /** Props are `DialogActionsProps` from components/ui/dialog-actions. */
697
699
  DialogActions?: ComponentType<any>;
700
+ /** Props are `KeyHintProps` from components/ui/key-hints. */
701
+ KeyHint?: ComponentType<any>;
702
+ /** Props are `KeyHintsProps` from components/ui/key-hints. */
703
+ KeyHints?: ComponentType<any>;
698
704
  PageStackView?: ComponentType<any>;
699
705
  Tabs?: ComponentType<HostTabsProps>;
700
706
  Checkbox?: ComponentType<HostCheckboxProps>;
@@ -722,6 +728,8 @@ export interface SaveTextFileRequest {
722
728
 
723
729
  export interface RendererHost {
724
730
  requestExit(): void;
731
+ /** False where the app cannot quit itself (a browser tab): Quit is not offered. */
732
+ canExit?: boolean;
725
733
  /**
726
734
  * From a press on a title bar. `press.detail` counts the clicks: where the
727
735
  * system's title bars maximize on a double-click, the second press does that
@@ -168,7 +168,12 @@ export function formatFeedTime(value: DisplayDateValue, now = Date.now(), fallba
168
168
  return formatShortDate(date, { year: sameYear ? false : "2-digit", utc });
169
169
  }
170
170
 
171
- export function formatDetailDate(value: DisplayDateValue, fallback = "-"): string {
171
+ /**
172
+ * A date and time in the host's zone, with the zone named: "Oct 7, 2026 at
173
+ * 11:38 PM GMT+2", "... 5:38 PM EDT", "... 9:38 PM UTC". Without the zone a
174
+ * time read beside a list in UTC looks two hours off.
175
+ */
176
+ export function formatDetailDate(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
172
177
  const date = parseDisplayDate(value);
173
178
  if (!date) return fallback;
174
179
 
@@ -176,10 +181,19 @@ export function formatDetailDate(value: DisplayDateValue, fallback = "-"): strin
176
181
  month: "short",
177
182
  day: "numeric",
178
183
  year: "numeric",
184
+ timeZone,
179
185
  });
180
- const timePart = date.toLocaleTimeString("en-US", {
186
+ return `${datePart} at ${formatDetailTime(date, fallback, timeZone)}`;
187
+ }
188
+
189
+ /** The time of `formatDetailDate` alone, its zone named: "11:38 PM GMT+2", for a day stated beside it. */
190
+ export function formatDetailTime(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
191
+ const date = parseDisplayDate(value);
192
+ if (!date) return fallback;
193
+ return date.toLocaleTimeString("en-US", {
181
194
  hour: "numeric",
182
195
  minute: "2-digit",
196
+ timeZoneName: "short",
197
+ timeZone,
183
198
  });
184
- return `${datePart} at ${timePart}`;
185
199
  }
@@ -61,3 +61,18 @@ export function labelWithUnit(label: string, unit: string): string {
61
61
  : label.includes(unit);
62
62
  return named ? label : `${label} (${unit})`;
63
63
  }
64
+
65
+ /**
66
+ * A figure to the digits its cell draws: -315.12 for the -315.12046875 drawn
67
+ * "-HK$315.12", -1.27 for a percent drawn "-1.27%". The figure as it is where
68
+ * the cell draws no number, or draws it in another scale (a yield's 0.022 as
69
+ * "+2.2bp"), so a figure is never cut to what another reading shows.
70
+ */
71
+ export function figureAsDrawn(value: number, drawn: string): number {
72
+ if (!Number.isFinite(value)) return value;
73
+ const read = parseDisplayNumber(drawn);
74
+ if (!read || read === BLANK_DISPLAY) return value;
75
+ const shown = Number(read.number);
76
+ return Math.abs(Math.abs(shown) - Math.abs(value)) <= (read.step / 2) * (1 + 1e-9) + Number.EPSILON
77
+ ? Math.sign(value) * Math.abs(shown) : value;
78
+ }
@@ -1,19 +1,44 @@
1
- import { ONE_SHOT_COOLDOWN_MS } from "./one-shot";
2
-
3
1
  const DOUBLE_ESCAPE_CLOSE_MS = 650;
4
2
 
3
+ /**
4
+ * Where a host cannot say which Esc presses are a held key's auto-repeat (a
5
+ * terminal that does not report key event types), an Esc this soon after the
6
+ * Esc before it is read as the held key, while a stream is live: after an Esc
7
+ * that closed a pane, or one that looked like its repeat. It arms nothing and
8
+ * closes nothing, so a held key cannot go on to close the next pane.
9
+ *
10
+ * Just above the slowest stock repeat interval: macOS repeats every 90 ms by
11
+ * default, Windows, GNOME, KDE and X11 every 25 to 40 ms, and keyboards set
12
+ * faster go lower, so a held key stays under it with room for a late frame.
13
+ * Separate presses are rarely this close: even a quick double tap of one key
14
+ * is further apart. A keyboard set to repeat slower than this reads as
15
+ * separate presses, and a host that flags repeats never reaches this check.
16
+ */
17
+ const HELD_ESCAPE_GAP_MS = 110;
18
+
19
+ /**
20
+ * How long a stream stays live with no press. A stall (the redraw after the
21
+ * close, a busy frame) holds the next repeat back, and the ones queued behind
22
+ * it arrive close together: that press arms, but the one after it is still
23
+ * the held key.
24
+ */
25
+ const HELD_ESCAPE_STALL_MS = 500;
26
+
5
27
  export interface DoubleEscapeCloseState {
6
28
  lastAt: number;
7
29
  targetId: string | null;
8
- /** The last Esc that closed a pane, or came while that close was still cooling down. */
9
- closedAt: number;
30
+ /** The last Esc that closed a pane, or the latest one since that looked like its repeat. */
31
+ streamAt: number;
32
+ /** The last Esc that armed, closed or looked like a repeat. */
33
+ pressAt: number;
10
34
  }
11
35
 
12
36
  export function createDoubleEscapeCloseState(): DoubleEscapeCloseState {
13
37
  return {
14
38
  lastAt: 0,
15
39
  targetId: null,
16
- closedAt: Number.NEGATIVE_INFINITY,
40
+ streamAt: Number.NEGATIVE_INFINITY,
41
+ pressAt: Number.NEGATIVE_INFINITY,
17
42
  };
18
43
  }
19
44
 
@@ -28,19 +53,32 @@ export function resetDoubleEscapeClose(state: DoubleEscapeCloseState) {
28
53
  * Esc arms, whatever the pane does with it (back out of a detail, clear a
29
54
  * selection, leave a chart), except an Esc that leaves a draft or closes a
30
55
  * menu: see `countEscapeTowardClose` and `keepEscapeFromClosing`.
56
+ *
57
+ * `repeat` is the host's word on whether the key is held down (DOM `repeat`,
58
+ * the kitty protocol's repeat event): true is an auto-repeat, which is no
59
+ * press at all, and false is a press of its own however soon it follows the
60
+ * last. Undefined where the host cannot tell; both then go by the gap
61
+ * between presses, see `HELD_ESCAPE_GAP_MS`.
31
62
  */
32
63
  export function takeDoubleEscapeClose(
33
64
  state: DoubleEscapeCloseState,
34
65
  targetId: string | null | undefined,
35
66
  now: number,
36
- thresholdMs = DOUBLE_ESCAPE_CLOSE_MS,
67
+ repeat?: boolean,
37
68
  ): boolean {
38
- const matched = !!targetId && state.targetId === targetId && now - state.lastAt <= thresholdMs;
39
- if (matched) {
40
- resetDoubleEscapeClose(state);
41
- state.closedAt = now;
42
- }
43
- return matched;
69
+ if (repeat === true) return false;
70
+ const matched = !!targetId && state.targetId === targetId && now - state.lastAt <= DOUBLE_ESCAPE_CLOSE_MS;
71
+ if (!matched || isHeldEscape(state, now, repeat)) return false;
72
+ resetDoubleEscapeClose(state);
73
+ state.streamAt = now;
74
+ state.pressAt = now;
75
+ return true;
76
+ }
77
+
78
+ function isHeldEscape(state: DoubleEscapeCloseState, now: number, repeat: boolean | undefined): boolean {
79
+ return repeat === undefined
80
+ && now - state.pressAt < HELD_ESCAPE_GAP_MS
81
+ && now - state.streamAt < HELD_ESCAPE_STALL_MS;
44
82
  }
45
83
 
46
84
  interface EscapeOffer {
@@ -88,17 +126,24 @@ export function armDoubleEscapeClose(
88
126
  state: DoubleEscapeCloseState,
89
127
  targetId: string | null | undefined,
90
128
  now: number,
129
+ repeat?: boolean,
91
130
  ) {
92
131
  if (!targetId) {
93
132
  resetDoubleEscapeClose(state);
94
133
  return;
95
134
  }
96
- // A held Esc is a stream of presses: after the close it arms nothing, so it
97
- // cannot close the next pane too. Each Esc of the stream extends the pause.
98
- if (now - state.closedAt < ONE_SHOT_COOLDOWN_MS) {
99
- state.closedAt = now;
135
+ if (repeat === true) return;
136
+ // Where the host cannot flag repeats, a held Esc is a stream of presses:
137
+ // after the close it arms nothing, so it cannot close the next pane too, and
138
+ // each Esc of the stream keeps it going. A separate press, further from the
139
+ // last than a held key's repeat, arms the next pane at once.
140
+ if (isHeldEscape(state, now, repeat)) {
141
+ resetDoubleEscapeClose(state);
142
+ state.streamAt = now;
143
+ state.pressAt = now;
100
144
  return;
101
145
  }
102
146
  state.targetId = targetId;
103
147
  state.lastAt = now;
148
+ state.pressAt = now;
104
149
  }
@@ -0,0 +1,24 @@
1
+ /** The decimals a number is written with: 2 for 6012.25, 13 for 340.3299865722656. */
2
+ export function decimalPlaces(value: number): number {
3
+ const [mantissa = "", exponent = "0"] = Math.abs(value).toString().split("e");
4
+ return Math.max(0, (mantissa.split(".")[1]?.length ?? 0) - Number(exponent));
5
+ }
6
+
7
+ /**
8
+ * Providers serve prices as float32: The feed sends the exact float
9
+ * (340.33 arrives as 340.3299865722656) and the cloud a float already rounded
10
+ * to a few decimals (254.42999). Return the shortest decimal that is the same
11
+ * float32. Values with fewer than five decimals are left alone, and a precise
12
+ * double only moves within float32 precision (about seven significant digits).
13
+ */
14
+ export function cleanFloat32Price(value: number): number {
15
+ if (!Number.isFinite(value) || value === 0 || decimalPlaces(value) < 5) return value;
16
+ const target = Math.fround(value);
17
+ for (let digits = 1; digits <= 9; digits++) {
18
+ const candidate = Number(value.toPrecision(digits));
19
+ if (Math.fround(candidate) !== target) continue;
20
+ return candidate.toString().length < value.toString().length ? candidate : value;
21
+ }
22
+ return value;
23
+ }
24
+
@@ -84,8 +84,16 @@ const MAX_GRACE_DAYS = 90;
84
84
  * lapsed forward yield too.
85
85
  */
86
86
  const UNKNOWN_CADENCE_WINDOW_DAYS = 455;
87
- /** The shortest a dividend can take to lapse: a monthly payer's interval and grace. */
88
- const SHORTEST_WINDOW_DAYS = CADENCE_DAYS[0] + MIN_GRACE_DAYS;
87
+ /** Past this many days a monthly payer's next distribution would have gone ex: a history without it ends early. */
88
+ const MONTHLY_HISTORY_END_DAYS = 40;
89
+ /**
90
+ * Past this many days a monthly payer has stopped paying (FXF, last paid
91
+ * 2024-04-01) rather than its history ended early: Gloom Cloud no longer asks
92
+ * for the distributions after it.
93
+ */
94
+ const MONTHLY_STOPPED_DAYS = 183;
95
+ /** The shortest a forward yield can take to be withheld: a monthly payer's history that ends (monthlyHistoryEnd). */
96
+ const SHORTEST_WINDOW_DAYS = MONTHLY_HISTORY_END_DAYS;
89
97
 
90
98
  function dayNumber(day: string): number {
91
99
  return Date.parse(`${day}T00:00:00Z`) / DAY_MS;
@@ -116,10 +124,19 @@ function distributionIntervalDays(exDates: readonly (string | Date)[]): number |
116
124
  return recent.length < 3 ? Math.max(nearest, CADENCE_DAYS[1]) : nearest;
117
125
  }
118
126
 
119
- /** A dividend that has stopped: no forward yield, only the day the last distribution went ex. */
127
+ /**
128
+ * A dividend that has stopped, or a monthly payer's history that ends: no
129
+ * forward yield, only the day the last distribution went ex.
130
+ */
120
131
  export interface DividendLapse {
121
132
  /** YYYY-MM-DD; null when no date is known. */
122
133
  lastPaid: string | null;
134
+ /**
135
+ * A monthly payer's history that stops at `lastPaid` (monthlyHistoryEnd):
136
+ * the distributions after it are missing from the history, which says
137
+ * nothing of whether the fund stopped paying.
138
+ */
139
+ historyEnds?: true;
123
140
  }
124
141
 
125
142
  /** What a forward yield is checked against: the issuer's own distributions. */
@@ -143,14 +160,17 @@ export function distributionHistory(actions: CorporateActionsData | null | undef
143
160
 
144
161
  /**
145
162
  * Whether the dividend behind a forward rate dated `asOf` (the ex-date of the
146
- * distribution it annualizes) has stopped. It is current while its latest
147
- * distribution went ex within its usual interval plus grace: half an interval,
148
- * at least a month and at most three, so a monthly payer lapses about two
149
- * months after its last ex-date, a quarterly one after four and a half months,
150
- * a semiannual one after nine and an annual one after fifteen (the window
151
- * Gloom Cloud uses). The interval comes from the issuer's own history, at
152
- * least quarterly when it has only two distributions; without one (fewer than
153
- * two distributions, or no history) the annual window applies.
163
+ * distribution it annualizes) has stopped, or its history ended. A monthly
164
+ * payer's history with no ex-date in the last 40 days ends there
165
+ * (monthlyHistoryEnd, `historyEnds`), until it has been silent more than 183
166
+ * days, when its dividend has stopped. Otherwise it is current while its
167
+ * latest distribution went ex within its usual interval plus grace: half an
168
+ * interval, at least a month and at most three, so a quarterly payer lapses
169
+ * after four and a half months, a semiannual one after nine and an annual one
170
+ * after fifteen (the window Gloom Cloud uses). The interval comes from the
171
+ * issuer's own history, at least quarterly when it has only two
172
+ * distributions; without one (fewer than two distributions, or no history) the
173
+ * annual window applies.
154
174
  * A distribution declared and not yet ex, the rate's own or one in the
155
175
  * history, keeps it current. Null while current or when nothing is known.
156
176
  */
@@ -165,19 +185,22 @@ export function lapsedDividend(
165
185
  return day ? [day] : [];
166
186
  });
167
187
  if (days.some((day) => day > today) || (history?.declared?.length ?? 0) > 0) return null;
188
+ const historyEnd = monthlyHistoryEnd(history, now);
189
+ if (historyEnd) return { lastPaid: historyEnd, historyEnds: true };
168
190
  const paid = [...new Set(days)];
169
191
  if (paid.length === 0) return null;
170
192
  const lastPaid = paid.reduce((latest, day) => (day > latest ? day : latest));
171
193
  const interval = history?.exDates ? distributionIntervalDays(paid) : null;
172
194
  const window = interval == null ? UNKNOWN_CADENCE_WINDOW_DAYS
173
195
  : interval + Math.min(MAX_GRACE_DAYS, Math.max(MIN_GRACE_DAYS, interval / 2));
174
- return dayNumber(today) - dayNumber(lastPaid) > window ? { lastPaid } : null;
196
+ return dayNumber(today) - dayNumber(lastPaid) <= window ? null : { lastPaid };
175
197
  }
176
198
 
177
199
  /**
178
200
  * Whether a forward rate dated `asOf` could have lapsed by `now`, so the
179
201
  * history is worth reading: never while its ex-date is ahead or more recent
180
- * than the shortest window, a monthly payer's.
202
+ * than the shortest window, the 40 days after which a monthly payer's history
203
+ * ends.
181
204
  */
182
205
  export function forwardDividendMayHaveLapsed(asOf: string | Date | null | undefined, now = new Date()): boolean {
183
206
  const rateDay = isoDay(asOf);
@@ -195,15 +218,57 @@ export function forwardYieldMayHaveLapsed(
195
218
  return fundamentals?.dividendYieldBasis === "forward" && forwardDividendMayHaveLapsed(fundamentals.exDividendDate, now);
196
219
  }
197
220
 
221
+ /**
222
+ * The last ex-date of a monthly payer's history that stops more than 40 days
223
+ * and at most 183 days before `now`, read from its paid ex-dates alone: MUB's
224
+ * history ending at 2026-09-01 while the fund paid on 1 October and 2
225
+ * November. A forward rate, trailing yield and last ex-date read from that
226
+ * history then all stop there too, and say so, rather than read the missing
227
+ * months as a dividend that stopped. Silent longer, the fund stopped paying
228
+ * (FXF, last paid 2024-04-01), which lapsedDividend says. Null for any other
229
+ * cadence, a history that is current, and one with a distribution declared or
230
+ * still ahead.
231
+ */
232
+ export function monthlyHistoryEnd(history: DistributionHistory | null | undefined, now = new Date()): string | null {
233
+ if (!history?.exDates || (history.declared?.length ?? 0) > 0) return null;
234
+ const today = isoDay(now)!;
235
+ const days = [...new Set(history.exDates.flatMap((value) => {
236
+ const day = isoDay(value);
237
+ return day ? [day] : [];
238
+ }))].sort();
239
+ const last = days.at(-1);
240
+ const silent = last ? dayNumber(today) - dayNumber(last) : 0;
241
+ if (!last || last > today || silent <= MONTHLY_HISTORY_END_DAYS || silent > MONTHLY_STOPPED_DAYS) return null;
242
+ return distributionIntervalDays(days) === CADENCE_DAYS[0] ? last : null;
243
+ }
244
+
245
+ /** `distribution history ends 2026-09-01`: what a monthly payer's ended history says in place of a yield it cannot give. */
246
+ export function historyEndsText(day: string): string {
247
+ return `distribution history ends ${day}`;
248
+ }
249
+
198
250
  export const NO_CURRENT_DIVIDEND = "no current dividend";
251
+ /** What a short cell reads for a monthly payer's history that ends (DividendLapse.historyEnds), beside `last ex 2026-09-01`. */
252
+ const HISTORY_ENDS = "history ends";
199
253
 
200
- /** `last paid 2026-02-27`, the note beside "no current dividend"; null when the date is unknown. */
254
+ /** What a short cell reads in place of a lapsed forward yield: `history ends` for a history that ends, else `no current dividend`. */
255
+ export function lapseValue(lapse: DividendLapse): string {
256
+ return lapse.historyEnds && lapse.lastPaid ? HISTORY_ENDS : NO_CURRENT_DIVIDEND;
257
+ }
258
+
259
+ /** `last paid 2026-02-27` beside "no current dividend", `last ex 2026-09-01` beside "history ends"; null when the date is unknown. */
201
260
  export function lastPaidNote(lapse: DividendLapse): string | null {
202
- return lapse.lastPaid ? `last paid ${lapse.lastPaid}` : null;
261
+ if (!lapse.lastPaid) return null;
262
+ return lapse.historyEnds ? `last ex ${lapse.lastPaid}` : `last paid ${lapse.lastPaid}`;
203
263
  }
204
264
 
205
- /** `no current dividend (last paid 2026-02-27)`, what a lapsed forward yield reads instead of a percentage. */
265
+ /**
266
+ * `no current dividend (last paid 2026-02-27)`, what a lapsed forward yield
267
+ * reads instead of a percentage; for a monthly payer's history that ends
268
+ * early, `distribution history ends 2026-09-01`.
269
+ */
206
270
  export function noCurrentDividend(lapse: DividendLapse): string {
271
+ if (lapse.historyEnds && lapse.lastPaid) return historyEndsText(lapse.lastPaid);
207
272
  const note = lastPaidNote(lapse);
208
273
  return note ? `${NO_CURRENT_DIVIDEND} (${note})` : NO_CURRENT_DIVIDEND;
209
274
  }
@@ -85,6 +85,17 @@ export function latestFxWeekOpen(time: number): number | null {
85
85
  return latestNewYorkFivePm(time, 0);
86
86
  }
87
87
 
88
+ /**
89
+ * When the FX week opens again, Sunday 17:00 New York, for a moment it is
90
+ * shut; null while it trades. A closure lasts two days, so the open is the
91
+ * latest one three days on.
92
+ */
93
+ export function nextFxWeekOpen(time: number): number | null {
94
+ if (!Number.isFinite(time) || isFxMarketOpen(time)) return null;
95
+ const open = latestFxWeekOpen(time + 3 * DAY_MS);
96
+ return open != null && open > time ? open : null;
97
+ }
98
+
88
99
  /**
89
100
  * How close to the FX week's close a print is its close: Gloom Cloud dates the
90
101
  * week's close by its last minute (20:59Z, or 21:59Z in winter).
@@ -14,6 +14,7 @@
14
14
  "markets.newyorkfed.org",
15
15
  "nasdaqtrader.com",
16
16
  "production.dataviz.cnn.io",
17
- "services-dynarep.ddwa.finra.org"
17
+ "services-dynarep.ddwa.finra.org",
18
+ "www.treasurydirect.gov"
18
19
  ]
19
20
  }
@@ -8,6 +8,7 @@ import { regularHistorySessionStaleness } from "../market-data/history-session";
8
8
  import type { HistorySession } from "../types/price-history";
9
9
  import { BAR_INTERVAL_UNIT_MS, parseBarInterval } from "../time-series/resolution";
10
10
  import { parseOptionTicker } from "./options";
11
+ import { indexSessionVenue } from "../market-data/market/index-session-venues";
11
12
 
12
13
  // A venue without session hours here (OTC Markets, Cboe Canada) has no
13
14
  // session to hold: its copy is current while the latest bar is this recent.
@@ -239,7 +240,7 @@ export function isPriceHistoryStaleForCurrentWindow(
239
240
  // labelled by its start, so an hourly bar ending at the break is judged by
240
241
  // when it ends.
241
242
  const latestBarEnd = intervalMs != null ? Math.min(latestTime + intervalMs, now) : latestTime;
242
- if (isMiddayBreakPrint(latestBarEnd, options.exchange, now, 0)) return false;
243
+ if (isMiddayBreakPrint(latestBarEnd, options.exchange || indexSessionVenue(options.symbol) || undefined, now, 0)) return false;
243
244
  const sessions = listingSessionsAt(now, options);
244
245
  if (!sessions) return age > UNSCHEDULED_HISTORY_MAX_AGE_MS;
245
246
  const fetchedAt = options.fetchedAt ?? Number.NEGATIVE_INFINITY;
@@ -247,7 +248,7 @@ export function isPriceHistoryStaleForCurrentWindow(
247
248
  // A venue whose chart source files another week (DFM's Sunday to Thursday)
248
249
  // may end on the last session that week has: current under either week.
249
250
  // Bars of a day that week lacks (a DFM Friday) answer to the venue's own.
250
- const exchange = listingSessionExchange(options.exchange);
251
+ const exchange = listingSessionExchange(options.exchange, options.symbol);
251
252
  const sourceWeekendDays = historySourceWeekendDays(exchange);
252
253
  const timeZone = sessionCalendarTimeZone(exchange);
253
254
  const latestWeekday = timeZone ? zonedWeekday(latestTime, timeZone) : null;
@@ -256,9 +257,9 @@ export function isPriceHistoryStaleForCurrentWindow(
256
257
  return !sourceSessions || !holdsLatestSession(latestTime, now, sourceSessions, allowedLag, fetchedAt);
257
258
  }
258
259
 
259
- /** Bare symbols resolve to their US listing at the sources. */
260
- function listingSessionExchange(exchange: string | undefined): string {
261
- return canonicalExchange(exchange) || "NYSE";
260
+ /** Bare symbols resolve to their US listing at the sources; a bare index symbol to the venue whose sessions it follows. */
261
+ function listingSessionExchange(exchange: string | undefined, symbol?: string): string {
262
+ return canonicalExchange(exchange) || indexSessionVenue(symbol) || "NYSE";
262
263
  }
263
264
 
264
265
  interface ListingSessions {
@@ -285,7 +286,7 @@ function listingSessionsAt(
285
286
  return { liveOpen: isFxMarketOpen(time) ? latestFxWeekOpen(time) : null,
286
287
  last: close !== null && open !== null ? { open, close } : null };
287
288
  }
288
- const exchange = listingSessionExchange(options.exchange);
289
+ const exchange = listingSessionExchange(options.exchange, options.symbol);
289
290
  const open = latestRegularSessionOpen(exchange, time, weekendDays);
290
291
  if (open === null) return null;
291
292
  const latest = latestRegularSessionClose(exchange, time, weekendDays);
@@ -0,0 +1,62 @@
1
+ import type { EarningsTiming } from "../api-client/earnings";
2
+ import { timeZoneLabel, zonedDateTimeParts, zonedWallClockToUtcMs } from "./zoned-date-time";
3
+
4
+ const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
5
+ const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
6
+
7
+ /** When a report is out on the New York clock, as `[hour, minute]`: before the 9:30 open, or shortly after the 16:00 close. */
8
+ const NEW_YORK_TIMES: Record<EarningsTiming, { words: string; at: readonly [number, number]; until?: readonly [number, number] }> = {
9
+ bmo: { words: "before open", at: [9, 30] },
10
+ dmh: { words: "during market hours", at: [9, 30], until: [16, 0] },
11
+ amc: { words: "after close", at: [16, 5] },
12
+ };
13
+
14
+ const clockText = (time: number, zone: string) => {
15
+ const local = zonedDateTimeParts(time, zone);
16
+ return `${String(local.hour).padStart(2, "0")}:${String(local.minute).padStart(2, "0")}`;
17
+ };
18
+
19
+ const dayText = (time: number, zone: string) => {
20
+ const local = zonedDateTimeParts(time, zone);
21
+ const weekday = WEEKDAYS[new Date(Date.UTC(local.year, local.month - 1, local.day)).getUTCDay()]!;
22
+ return `${weekday} ${local.day} ${MONTHS[local.month - 1]}`;
23
+ };
24
+
25
+ /**
26
+ * When a report comes out, on the reader's clock.
27
+ *
28
+ * A time the company announced (`releaseAt`, Berkshire's Saturday 13:00Z) is
29
+ * that time: "at 21:00 SGT Sat 7 Nov" in Singapore, and in UTC for a reader
30
+ * with no zone set. Otherwise, for a reader who set a timezone, the session
31
+ * timing on their clock: in Singapore an after-close report on Monday 9 Nov
32
+ * is out "after close, about 05:05 SGT Tue 10 Nov", which "AMC" alone does
33
+ * not say. A weekend date has no session to place it by, so without an
34
+ * announced time it says nothing more than its label.
35
+ *
36
+ * Null without either, or for a zone that keeps New York's clock.
37
+ */
38
+ export function localReportTiming(
39
+ date: string,
40
+ timing: EarningsTiming | null | undefined,
41
+ zone: string | null | undefined,
42
+ releaseAt?: string | null,
43
+ ): string | null {
44
+ const announced = releaseAt ? Date.parse(releaseAt) : NaN;
45
+ if (Number.isFinite(announced)) {
46
+ const shown = zone ?? "UTC";
47
+ return `at ${clockText(announced, shown)} ${timeZoneLabel(shown)} ${dayText(announced, shown)}`;
48
+ }
49
+ if (!timing || !zone || !/^\d{4}-\d{2}-\d{2}$/.test(date)) return null;
50
+ const [year, month, day] = date.split("-").map(Number) as [number, number, number];
51
+ const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
52
+ if (weekday === 0 || weekday === 6) return null;
53
+ const times = NEW_YORK_TIMES[timing];
54
+ const at = zonedWallClockToUtcMs("America/New_York", year, month, day, times.at[0], times.at[1], 0);
55
+ if (dayText(at, zone) === dayText(at, "America/New_York") && clockText(at, zone) === clockText(at, "America/New_York")) return null;
56
+ const label = timeZoneLabel(zone);
57
+ if (times.until) {
58
+ const until = zonedWallClockToUtcMs("America/New_York", year, month, day, times.until[0], times.until[1], 0);
59
+ return `${times.words}, ${clockText(at, zone)} to ${clockText(until, zone)} ${label} ${dayText(at, zone)}`;
60
+ }
61
+ return `${times.words}, ${timing === "bmo" ? "by" : "about"} ${clockText(at, zone)} ${label} ${dayText(at, zone)}`;
62
+ }
@@ -1,4 +1,5 @@
1
1
  import type { SecFilingItem } from "../types/data-provider";
2
+ import { formatCompact } from "./format";
2
3
  import { secFilingItemCodes } from "./sec";
3
4
 
4
5
  /**
@@ -266,3 +267,34 @@ export async function loadLatestFilings(
266
267
  count = Math.min(SEC_FILING_FETCH_LIMIT, count * READ_GROWTH);
267
268
  }
268
269
  }
270
+
271
+ const FORM4_VERBS: Record<string, string> = {
272
+ P: "Bought", S: "Sold", A: "Awarded", G: "Gift of", F: "Withheld for tax", M: "Exercised", X: "Exercised", C: "Converted",
273
+ };
274
+
275
+ /** Whether a Form 4 reports another company's shares: one the listing's company filed as their owner. */
276
+ export function isOtherIssuerForm4(filing: Pick<SecFilingItem, "cik" | "form4">): boolean {
277
+ const issuer = filing.form4?.issuerCik?.replace(/^0+/, "");
278
+ return !!issuer && issuer !== filing.cik.replace(/^0+/, "");
279
+ }
280
+
281
+ /**
282
+ * A Form 4's row, from what Gloom Cloud read of it: "Sold 2.13M SIRI shares
283
+ * at $21.48 (SIRIUS XM HOLDINGS INC.)" for one the company filed as an owner
284
+ * of another company's shares, whose issuer only the form names, and "COOK
285
+ * TIMOTHY D: Sold 120k shares at $231.50" for an insider of its own. Null
286
+ * without the service's summary.
287
+ */
288
+ export function form4TradeText(filing: Pick<SecFilingItem, "cik" | "form4">): string | null {
289
+ const trade = filing.form4;
290
+ if (!trade) return null;
291
+ const verb = FORM4_VERBS[trade.code] ?? (trade.side === "disposed" || trade.side === "sell" ? "Disposed of" : "Acquired");
292
+ const price = trade.price == null ? "" : ` at $${trade.price >= 1 ? trade.price.toFixed(2) : trade.price.toPrecision(3)}`;
293
+ // A form of options alone counts options, not shares.
294
+ const unit = trade.derivative ? "options" : "shares";
295
+ if (isOtherIssuerForm4(filing)) {
296
+ const subject = trade.issuerTicker ? `${trade.issuerTicker} ${unit}` : unit;
297
+ return `${verb} ${formatCompact(trade.shares)} ${subject}${price} (${trade.issuerName})`;
298
+ }
299
+ return `${trade.ownerName ? `${trade.ownerName}: ` : ""}${verb} ${formatCompact(trade.shares)} ${unit}${price}`;
300
+ }
@@ -80,6 +80,11 @@ export function setDisplayTimeZone(zone: string | null | undefined): void {
80
80
  displayZone = readerTimeZone(zone);
81
81
  }
82
82
 
83
+ /** The zone CLI text shows local times in (setDisplayTimeZone), or null when none is set. */
84
+ export function displayTimeZone(): string | null {
85
+ return displayZone;
86
+ }
87
+
83
88
  /** The zone a configured name shows a second clock in: null when unset, unknown or UTC all year. */
84
89
  export function readerTimeZone(zone: string | null | undefined): string | null {
85
90
  const canonical = zone ? canonicalTimeZone(zone) : null;