gloomberb 0.20.12 → 0.20.13

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 (512) hide show
  1. package/package.json +1 -1
  2. package/src/account/billing.ts +3 -2
  3. package/src/account/upgrade-dialog.tsx +8 -8
  4. package/src/api-client/index.ts +10 -2
  5. package/src/api-client/install-experiments.ts +146 -0
  6. package/src/api-client/telemetry.ts +47 -0
  7. package/src/api-client/types/market.ts +4 -0
  8. package/src/api-client/types/news.ts +16 -0
  9. package/src/architecture/floating-promise-allowlist.json +17 -33
  10. package/src/brokers/signed-in/adapter.ts +2 -2
  11. package/src/brokers/signed-in/catalog.ts +13 -4
  12. package/src/cli/commands/market.ts +51 -32
  13. package/src/cli/commands/overview.ts +3 -3
  14. package/src/cli/commands/search.ts +103 -9
  15. package/src/cli/commands/ticker.ts +22 -13
  16. package/src/cli/earnings-calendar.ts +33 -53
  17. package/src/cli/history-rows.ts +18 -1
  18. package/src/cli/known-gaps.ts +9 -0
  19. package/src/cli/listing-arg.ts +105 -18
  20. package/src/cli/pane-functions/catalog.ts +55 -7
  21. package/src/cli/pane-functions/dom.ts +8 -1
  22. package/src/cli/pane-functions/freshness.ts +2 -2
  23. package/src/cli/pane-functions/headless.ts +8 -8
  24. package/src/cli/pane-functions/index.ts +1 -1
  25. package/src/cli/pane-functions/report.ts +4 -1
  26. package/src/cli/perpetual-contract.ts +4 -4
  27. package/src/cli/quote-answer.ts +6 -2
  28. package/src/cli/result.ts +2 -1
  29. package/src/components/chart/composite/axis-overlays.tsx +5 -2
  30. package/src/components/chart/composite/composite-chart.tsx +1 -0
  31. package/src/components/chart/composite/format.ts +101 -15
  32. package/src/components/chart/composite/legend.tsx +60 -25
  33. package/src/components/chart/composite/time-axis.ts +51 -29
  34. package/src/components/chart/composite/toolbar.tsx +42 -6
  35. package/src/components/chart/curve/curve-surface.tsx +5 -5
  36. package/src/components/command-bar/list/badge.ts +8 -5
  37. package/src/components/command-bar/list/model.ts +0 -5
  38. package/src/components/command-bar/list/view.tsx +39 -2
  39. package/src/components/command-bar/routes/root/plugin-install.ts +4 -2
  40. package/src/components/command-bar/routes/root/provider-search.ts +23 -3
  41. package/src/components/command-bar/routes/root/results.ts +20 -9
  42. package/src/components/command-bar/routes/root/start-here.ts +1 -2
  43. package/src/components/command-bar/routes/ticker-search/actions.ts +2 -3
  44. package/src/components/command-bar/routes/ticker-search/results.ts +23 -4
  45. package/src/components/data-table/view.tsx +29 -6
  46. package/src/components/form-modal/host.tsx +1 -1
  47. package/src/components/layout/header.tsx +3 -2
  48. package/src/components/layout/market-summary.ts +3 -3
  49. package/src/components/layout/pane/error-boundary.tsx +2 -1
  50. package/src/components/markdown-text.tsx +36 -0
  51. package/src/components/market-board/index.tsx +4 -3
  52. package/src/components/onboarding/first-run-workspace.ts +46 -11
  53. package/src/components/onboarding/onboarding-keyboard.ts +57 -5
  54. package/src/components/onboarding/onboarding-wizard.tsx +91 -24
  55. package/src/components/onboarding/portfolio-step/index.tsx +1 -0
  56. package/src/components/onboarding/portfolio-step/positions-panel.tsx +36 -9
  57. package/src/components/onboarding/portfolio-step/types.ts +2 -0
  58. package/src/components/onboarding/tickers-step-model.ts +140 -0
  59. package/src/components/onboarding/tickers-step.tsx +116 -0
  60. package/src/components/onboarding/use-onboarding-broker-form.ts +1 -1
  61. package/src/components/onboarding/use-onboarding-progress.ts +100 -11
  62. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  63. package/src/components/onboarding/wizard-model.ts +3 -1
  64. package/src/components/onboarding/wizard-tickers.ts +139 -0
  65. package/src/components/price-performance.tsx +2 -2
  66. package/src/components/speedometer-gauge/model.ts +2 -1
  67. package/src/components/speedometer-gauge/terminal.tsx +13 -8
  68. package/src/components/ui/choice-dialog.tsx +101 -32
  69. package/src/components/ui/multi-select/dialog.tsx +1 -7
  70. package/src/components/ui/not-meaningful.ts +16 -0
  71. package/src/components/ui/query-bar.tsx +16 -4
  72. package/src/components/ui/stat-grid.tsx +27 -6
  73. package/src/data/config/store/normalize.ts +2 -0
  74. package/src/docs/snapshot.json +1 -1
  75. package/src/i18n/es.ts +5 -2
  76. package/src/i18n/ja.ts +5 -2
  77. package/src/i18n/ko.ts +5 -2
  78. package/src/i18n/zh-cn.ts +5 -2
  79. package/src/i18n/zh-tw.ts +5 -2
  80. package/src/layout-marketplace/model.ts +2 -1
  81. package/src/market-data/futures-contract.ts +2 -1
  82. package/src/market-data/hooks.tsx +1 -1
  83. package/src/market-data/market/change-basis.ts +27 -5
  84. package/src/market-data/market/format.ts +13 -13
  85. package/src/market-data/quotes/listing-enterprise-value.ts +3 -3
  86. package/src/market-data/quotes/time.ts +17 -10
  87. package/src/market-data/tax-equivalent.ts +3 -2
  88. package/src/news/aggregator.ts +19 -8
  89. package/src/news/hooks.ts +1 -1
  90. package/src/news/news-model.ts +49 -0
  91. package/src/news/types.ts +9 -0
  92. package/src/plugins/builtin/account-management/calendar-tab.tsx +8 -3
  93. package/src/plugins/builtin/account-management/pane.tsx +9 -8
  94. package/src/plugins/builtin/alerts/calendar-events.ts +4 -5
  95. package/src/plugins/builtin/alerts/format.ts +6 -5
  96. package/src/plugins/builtin/alerts/headless.ts +3 -2
  97. package/src/plugins/builtin/alerts/history.ts +2 -1
  98. package/src/plugins/builtin/alerts/pane.tsx +2 -1
  99. package/src/plugins/builtin/alerts/price-text.ts +2 -1
  100. package/src/plugins/builtin/alerts/scheduled.ts +6 -5
  101. package/src/plugins/builtin/analytics/account-returns.ts +6 -7
  102. package/src/plugins/builtin/analytics/display.ts +2 -1
  103. package/src/plugins/builtin/analytics/pane-model.ts +5 -9
  104. package/src/plugins/builtin/analytics/risk-model.ts +6 -6
  105. package/src/plugins/builtin/analytics/risk-pane.tsx +6 -5
  106. package/src/plugins/builtin/analytics/view.tsx +5 -5
  107. package/src/plugins/builtin/attention/model.ts +6 -5
  108. package/src/plugins/builtin/attention/pane.tsx +5 -4
  109. package/src/plugins/builtin/awards/detail.tsx +5 -4
  110. package/src/plugins/builtin/awards/headless.ts +8 -7
  111. package/src/plugins/builtin/awards/model.ts +4 -3
  112. package/src/plugins/builtin/awards/pane.tsx +4 -4
  113. package/src/plugins/builtin/backtest/format.ts +3 -2
  114. package/src/plugins/builtin/backtest/report.ts +3 -2
  115. package/src/plugins/builtin/bond-calculator/headless.ts +2 -1
  116. package/src/plugins/builtin/bond-calculator/pane.tsx +2 -1
  117. package/src/plugins/builtin/broker-manager/add-flow.tsx +1 -1
  118. package/src/plugins/builtin/broker-trading/orders-data.ts +3 -3
  119. package/src/plugins/builtin/broker-trading/orders.tsx +3 -2
  120. package/src/plugins/builtin/broker-trading/ticket.tsx +2 -2
  121. package/src/plugins/builtin/buildout/cells.tsx +2 -1
  122. package/src/plugins/builtin/buildout/company/pane.tsx +4 -3
  123. package/src/plugins/builtin/buildout/data-runtime.ts +21 -23
  124. package/src/plugins/builtin/buildout/detail/values.ts +2 -1
  125. package/src/plugins/builtin/buildout/format.ts +4 -3
  126. package/src/plugins/builtin/buildout/pane/index.tsx +3 -3
  127. package/src/plugins/builtin/catalysts/detail.tsx +2 -1
  128. package/src/plugins/builtin/catalysts/model.ts +6 -5
  129. package/src/plugins/builtin/catalysts/pane.tsx +2 -1
  130. package/src/plugins/builtin/cds/headless.ts +3 -2
  131. package/src/plugins/builtin/cds/model.ts +8 -8
  132. package/src/plugins/builtin/cds/pane.tsx +3 -2
  133. package/src/plugins/builtin/central-bank-rates/headless.ts +2 -1
  134. package/src/plugins/builtin/central-bank-rates/model.ts +3 -2
  135. package/src/plugins/builtin/central-bank-rates/pane.tsx +5 -5
  136. package/src/plugins/builtin/changelog/index.tsx +2 -2
  137. package/src/plugins/builtin/chart-composer/index.tsx +4 -2
  138. package/src/plugins/builtin/chart-composer/pane.tsx +7 -3
  139. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +3 -1
  140. package/src/plugins/builtin/chart-composer/user-series.ts +3 -1
  141. package/src/plugins/builtin/chat/attachments/desktop.tsx +2 -1
  142. package/src/plugins/builtin/chat/controller/utils.ts +2 -1
  143. package/src/plugins/builtin/clinical-trials/model.ts +4 -3
  144. package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts +4 -2
  145. package/src/plugins/builtin/cloud/askg/lock-note.ts +16 -4
  146. package/src/plugins/builtin/cloud/askg/model.ts +2 -1
  147. package/src/plugins/builtin/cloud/askg/pane.tsx +35 -1
  148. package/src/plugins/builtin/cloud/company-picker.tsx +1 -3
  149. package/src/plugins/builtin/cloud/team/pane.tsx +12 -12
  150. package/src/plugins/builtin/cloud/thesis/detail.tsx +13 -8
  151. package/src/plugins/builtin/cloud-tweets/model.ts +2 -2
  152. package/src/plugins/builtin/comment-letters/pane.tsx +2 -1
  153. package/src/plugins/builtin/commodity-balances/headless.ts +3 -2
  154. package/src/plugins/builtin/company-attention/app-rank.tsx +5 -4
  155. package/src/plugins/builtin/company-attention/building-model.ts +7 -7
  156. package/src/plugins/builtin/company-attention/headless.ts +6 -5
  157. package/src/plugins/builtin/company-attention/model.ts +4 -4
  158. package/src/plugins/builtin/company-attention/moves-model.ts +9 -9
  159. package/src/plugins/builtin/company-attention/signals-model.ts +9 -9
  160. package/src/plugins/builtin/company-kpis/headless.ts +2 -1
  161. package/src/plugins/builtin/company-kpis/model.ts +15 -10
  162. package/src/plugins/builtin/company-kpis/pane.tsx +2 -2
  163. package/src/plugins/builtin/congress-trades/detail.tsx +6 -5
  164. package/src/plugins/builtin/congress-trades/headless.ts +2 -1
  165. package/src/plugins/builtin/congress-trades/model.ts +6 -6
  166. package/src/plugins/builtin/congress-trades/table.tsx +7 -6
  167. package/src/plugins/builtin/connections/pane.tsx +5 -5
  168. package/src/plugins/builtin/correlation/headless.ts +2 -2
  169. package/src/plugins/builtin/correlation/index.tsx +4 -1
  170. package/src/plugins/builtin/correlation/matrix/selection.ts +2 -1
  171. package/src/plugins/builtin/correlation/relationship/view-model.ts +3 -3
  172. package/src/plugins/builtin/cot/headless.ts +3 -2
  173. package/src/plugins/builtin/cot/model.ts +2 -1
  174. package/src/plugins/builtin/cot/pane.tsx +4 -3
  175. package/src/plugins/builtin/cpi/headless.ts +4 -3
  176. package/src/plugins/builtin/cpi/model.ts +8 -7
  177. package/src/plugins/builtin/credit-boards/cdx-pane.tsx +5 -4
  178. package/src/plugins/builtin/credit-boards/headless.ts +2 -1
  179. package/src/plugins/builtin/credit-boards/model.ts +5 -5
  180. package/src/plugins/builtin/credit-conditions/headless.ts +2 -1
  181. package/src/plugins/builtin/credit-conditions/index.tsx +2 -2
  182. package/src/plugins/builtin/credit-documents/model.ts +2 -2
  183. package/src/plugins/builtin/crypto-board/defi-view.tsx +7 -7
  184. package/src/plugins/builtin/crypto-board/defi.ts +2 -2
  185. package/src/plugins/builtin/crypto-board/model.ts +4 -3
  186. package/src/plugins/builtin/crypto-board/pane.tsx +8 -8
  187. package/src/plugins/builtin/crypto-board/supply.ts +2 -2
  188. package/src/plugins/builtin/crypto-etf-flows/model.ts +4 -4
  189. package/src/plugins/builtin/custom-view/index.tsx +3 -1
  190. package/src/plugins/builtin/custom-view/pane.tsx +5 -1
  191. package/src/plugins/builtin/custom-view/view-spec.ts +11 -0
  192. package/src/plugins/builtin/debt-maturities/model.ts +3 -3
  193. package/src/plugins/builtin/debt-maturities/pane.tsx +2 -2
  194. package/src/plugins/builtin/dividend-yield/client.ts +7 -3
  195. package/src/plugins/builtin/dividend-yield/headless.ts +16 -11
  196. package/src/plugins/builtin/dividend-yield/pane.tsx +12 -10
  197. package/src/plugins/builtin/dividend-yield/ranking-view.tsx +4 -1
  198. package/src/plugins/builtin/dividend-yield/ranking.ts +19 -11
  199. package/src/plugins/builtin/dividend-yield/types.ts +4 -0
  200. package/src/plugins/builtin/dividend-yield/view.ts +3 -3
  201. package/src/plugins/builtin/docs/use-docs.ts +4 -2
  202. package/src/plugins/builtin/doe/headless.ts +2 -1
  203. package/src/plugins/builtin/doe/model.ts +12 -11
  204. package/src/plugins/builtin/earnings/board-model.ts +14 -8
  205. package/src/plugins/builtin/earnings/board-table.ts +13 -8
  206. package/src/plugins/builtin/earnings/calendar-model.ts +5 -5
  207. package/src/plugins/builtin/earnings/calendar.tsx +2 -1
  208. package/src/plugins/builtin/earnings/format.ts +16 -14
  209. package/src/plugins/builtin/earnings/headless.ts +57 -19
  210. package/src/plugins/builtin/earnings/history-model.ts +11 -7
  211. package/src/plugins/builtin/earnings/history-table.ts +14 -9
  212. package/src/plugins/builtin/earnings/history.tsx +4 -3
  213. package/src/plugins/builtin/earnings-calls/calendar.tsx +2 -1
  214. package/src/plugins/builtin/earnings-calls/format.ts +6 -5
  215. package/src/plugins/builtin/earnings-calls/upcoming.ts +5 -5
  216. package/src/plugins/builtin/earnings-ripple/headless.ts +2 -1
  217. package/src/plugins/builtin/earnings-ripple/model.ts +3 -2
  218. package/src/plugins/builtin/earnings-ripple/pane.tsx +6 -6
  219. package/src/plugins/builtin/econ/calendar-model.ts +2 -2
  220. package/src/plugins/builtin/econ/detail-view.tsx +2 -2
  221. package/src/plugins/builtin/econ/index.tsx +7 -6
  222. package/src/plugins/builtin/econ-statistics/detail.tsx +2 -1
  223. package/src/plugins/builtin/econ-statistics/headless.ts +4 -4
  224. package/src/plugins/builtin/econ-statistics/pane.tsx +2 -2
  225. package/src/plugins/builtin/equity-screener/headless.ts +5 -5
  226. package/src/plugins/builtin/equity-screener/model.ts +6 -4
  227. package/src/plugins/builtin/equity-screener/pane.tsx +7 -7
  228. package/src/plugins/builtin/equity-screener/screen-check.ts +2 -1
  229. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  230. package/src/plugins/builtin/estimate-revisions/model.ts +3 -2
  231. package/src/plugins/builtin/estimate-revisions/pane.tsx +8 -8
  232. package/src/plugins/builtin/executives/format.ts +4 -4
  233. package/src/plugins/builtin/exposure/headless.ts +8 -8
  234. package/src/plugins/builtin/exposure/model.ts +4 -3
  235. package/src/plugins/builtin/exposure/pane.tsx +6 -5
  236. package/src/plugins/builtin/fear-greed/format.ts +7 -7
  237. package/src/plugins/builtin/fear-greed/headless.ts +2 -1
  238. package/src/plugins/builtin/filing-events/feed.ts +2 -1
  239. package/src/plugins/builtin/futures/table.tsx +8 -8
  240. package/src/plugins/builtin/futures-curve/headless.ts +18 -18
  241. package/src/plugins/builtin/futures-curve/model.ts +5 -5
  242. package/src/plugins/builtin/futures-curve/pane.tsx +8 -8
  243. package/src/plugins/builtin/fx-matrix/index.tsx +2 -2
  244. package/src/plugins/builtin/fx-matrix/pairs.ts +2 -1
  245. package/src/plugins/builtin/gpu/board.tsx +6 -5
  246. package/src/plugins/builtin/gpu/changes.tsx +2 -1
  247. package/src/plugins/builtin/gpu/equities.tsx +2 -2
  248. package/src/plugins/builtin/gpu/headless.ts +4 -3
  249. package/src/plugins/builtin/gpu/model.ts +8 -7
  250. package/src/plugins/builtin/help/functions-table.tsx +41 -9
  251. package/src/plugins/builtin/help/index.tsx +6 -3
  252. package/src/plugins/builtin/help/keybindings-editor.tsx +35 -7
  253. package/src/plugins/builtin/help/shortcut-table.tsx +19 -7
  254. package/src/plugins/builtin/help/table-cells.tsx +51 -0
  255. package/src/plugins/builtin/holders/pane.tsx +4 -1
  256. package/src/plugins/builtin/insider/base-values.ts +2 -2
  257. package/src/plugins/builtin/insider/display.ts +2 -1
  258. package/src/plugins/builtin/insider/headless.ts +16 -16
  259. package/src/plugins/builtin/insider/insider-data.ts +2 -1
  260. package/src/plugins/builtin/insider/signals-model.ts +3 -3
  261. package/src/plugins/builtin/insider/table-model.ts +27 -13
  262. package/src/plugins/builtin/insider/table.tsx +1 -1
  263. package/src/plugins/builtin/ipo-calendar/model.ts +4 -4
  264. package/src/plugins/builtin/iv-history/format.ts +8 -7
  265. package/src/plugins/builtin/iv-history/headless.ts +9 -8
  266. package/src/plugins/builtin/iv-history/pane.tsx +3 -2
  267. package/src/plugins/builtin/iv-history/screen-pane.tsx +5 -4
  268. package/src/plugins/builtin/jobs/headless.ts +11 -11
  269. package/src/plugins/builtin/jobs/model.ts +2 -2
  270. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  271. package/src/plugins/builtin/jodi/model.ts +2 -2
  272. package/src/plugins/builtin/jodi/pane.tsx +2 -1
  273. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -4
  274. package/src/plugins/builtin/kelly-sizer/model.ts +2 -1
  275. package/src/plugins/builtin/kelly-sizer/sections.tsx +2 -2
  276. package/src/plugins/builtin/macro-day/headless.ts +6 -5
  277. package/src/plugins/builtin/macro-day/model.ts +2 -1
  278. package/src/plugins/builtin/macro-day/pane.tsx +4 -4
  279. package/src/plugins/builtin/market-halts/model.ts +11 -10
  280. package/src/plugins/builtin/market-halts/pane.tsx +2 -1
  281. package/src/plugins/builtin/market-heatmap/index.tsx +4 -4
  282. package/src/plugins/builtin/market-movers/session-table.ts +3 -3
  283. package/src/plugins/builtin/market-movers/session.ts +2 -1
  284. package/src/plugins/builtin/market-movers/table.ts +5 -5
  285. package/src/plugins/builtin/market-valuation/detail.tsx +2 -2
  286. package/src/plugins/builtin/market-valuation/headless.ts +7 -7
  287. package/src/plugins/builtin/market-valuation/pane.tsx +7 -7
  288. package/src/plugins/builtin/members/breadth-pane.tsx +5 -4
  289. package/src/plugins/builtin/members/headless.ts +2 -1
  290. package/src/plugins/builtin/members/model.ts +3 -2
  291. package/src/plugins/builtin/members/pane.tsx +10 -9
  292. package/src/plugins/builtin/mna/distress/model.ts +2 -1
  293. package/src/plugins/builtin/mna/model.ts +5 -5
  294. package/src/plugins/builtin/money-markets/headless.ts +2 -1
  295. package/src/plugins/builtin/money-markets/model.ts +3 -2
  296. package/src/plugins/builtin/money-markets/pane.tsx +4 -4
  297. package/src/plugins/builtin/news/headless.ts +5 -2
  298. package/src/plugins/builtin/news/wire/breaking/notifications.ts +21 -19
  299. package/src/plugins/builtin/news/wire/news/row.ts +3 -1
  300. package/src/plugins/builtin/news/wire/news/table.tsx +3 -2
  301. package/src/plugins/builtin/news/wire/persisted-articles.ts +28 -3
  302. package/src/plugins/builtin/notes/headless.ts +2 -1
  303. package/src/plugins/builtin/notes/model.ts +2 -1
  304. package/src/plugins/builtin/openfda/pane.tsx +4 -3
  305. package/src/plugins/builtin/options/carry.ts +3 -2
  306. package/src/plugins/builtin/options/market-reference.ts +2 -1
  307. package/src/plugins/builtin/options/table.ts +48 -9
  308. package/src/plugins/builtin/options/view.tsx +47 -17
  309. package/src/plugins/builtin/options-calculator/headless.ts +3 -2
  310. package/src/plugins/builtin/options-calculator/pane.tsx +7 -7
  311. package/src/plugins/builtin/options-positioning/headless.ts +8 -7
  312. package/src/plugins/builtin/options-positioning/model.ts +10 -10
  313. package/src/plugins/builtin/options-positioning/pane.tsx +5 -5
  314. package/src/plugins/builtin/options-scenario/collar.ts +5 -4
  315. package/src/plugins/builtin/options-scenario/csp-screen-headless.ts +11 -10
  316. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +15 -14
  317. package/src/plugins/builtin/options-scenario/csp-screen.ts +2 -1
  318. package/src/plugins/builtin/options-scenario/csp.ts +6 -5
  319. package/src/plugins/builtin/options-scenario/headless.ts +6 -5
  320. package/src/plugins/builtin/options-scenario/hedge.ts +3 -3
  321. package/src/plugins/builtin/options-scenario/pane.tsx +7 -6
  322. package/src/plugins/builtin/options-scenario/strategy-screen.ts +1 -1
  323. package/src/plugins/builtin/pe-band/headless.ts +9 -8
  324. package/src/plugins/builtin/pe-band/pane.tsx +7 -7
  325. package/src/plugins/builtin/perps/cascade.ts +3 -2
  326. package/src/plugins/builtin/perps/headless.ts +10 -9
  327. package/src/plugins/builtin/perps/model.ts +14 -14
  328. package/src/plugins/builtin/perps/pane.tsx +3 -2
  329. package/src/plugins/builtin/portfolio-list/header.tsx +2 -2
  330. package/src/plugins/builtin/portfolio-list/index.tsx +3 -2
  331. package/src/plugins/builtin/portfolio-list/pane/futures-terms.ts +4 -2
  332. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +2 -1
  333. package/src/plugins/builtin/portfolio-list/pane/purchase-date-fx.ts +4 -2
  334. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +2 -2
  335. package/src/plugins/builtin/portfolio-list/settings.ts +4 -1
  336. package/src/plugins/builtin/portfolio-list/summary/index.tsx +4 -4
  337. package/src/plugins/builtin/power/detail.tsx +6 -5
  338. package/src/plugins/builtin/power/gas-model.ts +8 -7
  339. package/src/plugins/builtin/power/gas.tsx +2 -1
  340. package/src/plugins/builtin/power/headless.ts +7 -6
  341. package/src/plugins/builtin/power/model.ts +3 -2
  342. package/src/plugins/builtin/power/prices-headless.ts +10 -9
  343. package/src/plugins/builtin/power/prices-model.ts +3 -2
  344. package/src/plugins/builtin/power/prices.tsx +2 -1
  345. package/src/plugins/builtin/primary-dealers/model.ts +3 -3
  346. package/src/plugins/builtin/primary-dealers/pane.tsx +2 -2
  347. package/src/plugins/builtin/rate-path/headless.ts +8 -7
  348. package/src/plugins/builtin/rate-path/model.ts +6 -5
  349. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  350. package/src/plugins/builtin/realized-vol/fx-proxy.ts +2 -1
  351. package/src/plugins/builtin/realized-vol/headless.ts +11 -10
  352. package/src/plugins/builtin/realized-vol/pane.tsx +5 -4
  353. package/src/plugins/builtin/relative-rotation/headless.ts +2 -1
  354. package/src/plugins/builtin/relative-rotation/pane.tsx +6 -6
  355. package/src/plugins/builtin/research/analyst-headless.ts +5 -5
  356. package/src/plugins/builtin/research/analyst-model.ts +7 -7
  357. package/src/plugins/builtin/research/analyst-pane.tsx +7 -7
  358. package/src/plugins/builtin/research/client.ts +14 -0
  359. package/src/plugins/builtin/research/corporate-actions-pane.tsx +40 -30
  360. package/src/plugins/builtin/research/event-model.ts +55 -22
  361. package/src/plugins/builtin/research/event-sources.ts +26 -8
  362. package/src/plugins/builtin/research/relative-valuation-columns.ts +20 -12
  363. package/src/plugins/builtin/research/relative-valuation-currency.ts +16 -0
  364. package/src/plugins/builtin/research/relative-valuation-headless.ts +33 -21
  365. package/src/plugins/builtin/research/relative-valuation-model.ts +31 -17
  366. package/src/plugins/builtin/research/relative-valuation-pane.tsx +29 -14
  367. package/src/plugins/builtin/research-search/model.ts +2 -1
  368. package/src/plugins/builtin/research-search/saved-view.tsx +4 -3
  369. package/src/plugins/builtin/revenue-breakdown/model.ts +4 -4
  370. package/src/plugins/builtin/reverse-dcf/headless.ts +7 -7
  371. package/src/plugins/builtin/reverse-dcf/model.ts +4 -4
  372. package/src/plugins/builtin/reverse-dcf/pane.tsx +2 -2
  373. package/src/plugins/builtin/scanner/flow-model.ts +7 -4
  374. package/src/plugins/builtin/scanner/flow-pane.tsx +1 -1
  375. package/src/plugins/builtin/scanner/headless.ts +3 -2
  376. package/src/plugins/builtin/scanner/hilo-model.ts +2 -1
  377. package/src/plugins/builtin/scanner/live-headless.ts +2 -2
  378. package/src/plugins/builtin/scanner/live-model.ts +3 -2
  379. package/src/plugins/builtin/scanner/live-pane.tsx +5 -5
  380. package/src/plugins/builtin/seasonality/headless.ts +2 -1
  381. package/src/plugins/builtin/seasonality/pane.tsx +4 -3
  382. package/src/plugins/builtin/sec/filing-display.tsx +12 -15
  383. package/src/plugins/builtin/sec/fund-facts.ts +2 -2
  384. package/src/plugins/builtin/sec/headless.ts +2 -1
  385. package/src/plugins/builtin/sec/index.tsx +6 -2
  386. package/src/plugins/builtin/sectors/headless.ts +4 -4
  387. package/src/plugins/builtin/sectors/index.tsx +7 -7
  388. package/src/plugins/builtin/shared/earnings-calendar.ts +90 -6
  389. package/src/plugins/builtin/shared/earnings-report.ts +13 -6
  390. package/src/plugins/builtin/shared/research-cells.tsx +2 -2
  391. package/src/plugins/builtin/shared/source-footer.ts +2 -1
  392. package/src/plugins/builtin/shared/trend.ts +2 -2
  393. package/src/plugins/builtin/shared/use-quote-board.ts +9 -8
  394. package/src/plugins/builtin/short-interest/headless.ts +6 -6
  395. package/src/plugins/builtin/short-interest/model.ts +9 -9
  396. package/src/plugins/builtin/short-interest/publications-model.ts +5 -5
  397. package/src/plugins/builtin/short-interest/publications-pane.tsx +3 -2
  398. package/src/plugins/builtin/short-interest/watch-headless.ts +5 -5
  399. package/src/plugins/builtin/short-interest/watch-pane.tsx +6 -6
  400. package/src/plugins/builtin/short-volume/model.ts +5 -5
  401. package/src/plugins/builtin/short-volume/pane.tsx +4 -4
  402. package/src/plugins/builtin/social-mentions/headless.ts +2 -1
  403. package/src/plugins/builtin/social-mentions/model.ts +4 -4
  404. package/src/plugins/builtin/supply-chain/graph-model.ts +2 -1
  405. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  406. package/src/plugins/builtin/supply-chain/headless.ts +3 -2
  407. package/src/plugins/builtin/supply-chain/model.ts +4 -4
  408. package/src/plugins/builtin/supply-chain/pane.tsx +2 -2
  409. package/src/plugins/builtin/supply-chain/row-evidence.tsx +2 -1
  410. package/src/plugins/builtin/themes/headless.ts +2 -1
  411. package/src/plugins/builtin/themes/model.ts +3 -2
  412. package/src/plugins/builtin/themes/pane.tsx +3 -2
  413. package/src/plugins/builtin/thirteenf/format.ts +9 -9
  414. package/src/plugins/builtin/thirteenf/headless.ts +3 -2
  415. package/src/plugins/builtin/thirteenf/model.ts +2 -1
  416. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +2 -1
  417. package/src/plugins/builtin/thirteenf/pane.tsx +5 -4
  418. package/src/plugins/builtin/thirteenf/report-notes.ts +2 -1
  419. package/src/plugins/builtin/thirteenf/signals-pane.tsx +3 -2
  420. package/src/plugins/builtin/thirteenf/table.ts +6 -5
  421. package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +4 -3
  422. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +4 -4
  423. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +3 -3
  424. package/src/plugins/builtin/ticker-detail/financials/model.ts +83 -35
  425. package/src/plugins/builtin/ticker-detail/financials/ratio-table.tsx +3 -1
  426. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +2 -2
  427. package/src/plugins/builtin/ticker-detail/financials/schema.ts +14 -18
  428. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +8 -13
  429. package/src/plugins/builtin/ticker-detail/headless.ts +7 -5
  430. package/src/plugins/builtin/ticker-detail/overview/chart-scale.ts +52 -0
  431. package/src/plugins/builtin/ticker-detail/overview/components.tsx +4 -4
  432. package/src/plugins/builtin/ticker-detail/overview/model.ts +24 -13
  433. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +6 -0
  434. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +2 -1
  435. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +33 -7
  436. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +7 -5
  437. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +4 -4
  438. package/src/plugins/builtin/ticker-detail/settings.ts +17 -0
  439. package/src/plugins/builtin/time-sales/headless.ts +3 -2
  440. package/src/plugins/builtin/time-sales/model.ts +7 -5
  441. package/src/plugins/builtin/time-sales/pane.tsx +7 -6
  442. package/src/plugins/builtin/trace-bonds/model.ts +3 -2
  443. package/src/plugins/builtin/trace-bonds/pane.tsx +3 -2
  444. package/src/plugins/builtin/treasury-auctions/client.ts +2 -1
  445. package/src/plugins/builtin/treasury-auctions/headless.ts +6 -6
  446. package/src/plugins/builtin/treasury-auctions/hk-headless.ts +3 -2
  447. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +10 -9
  448. package/src/plugins/builtin/treasury-auctions/hk.ts +5 -5
  449. package/src/plugins/builtin/treasury-auctions/model.ts +4 -4
  450. package/src/plugins/builtin/treasury-auctions/pane.tsx +18 -18
  451. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +2 -1
  452. package/src/plugins/builtin/treasury-daily/model.ts +2 -2
  453. package/src/plugins/builtin/vol-surface/events.ts +5 -4
  454. package/src/plugins/builtin/vol-surface/headless.ts +19 -18
  455. package/src/plugins/builtin/vol-surface/heat-grid.tsx +2 -1
  456. package/src/plugins/builtin/vol-surface/pane.tsx +8 -7
  457. package/src/plugins/builtin/vol-surface/stored.ts +2 -1
  458. package/src/plugins/builtin/vol-surface/tables.ts +4 -3
  459. package/src/plugins/builtin/volatility/headless.ts +5 -4
  460. package/src/plugins/builtin/volatility/pane.tsx +6 -6
  461. package/src/plugins/builtin/world-indices/headless.ts +7 -7
  462. package/src/plugins/builtin/world-indices/index.tsx +3 -1
  463. package/src/plugins/builtin/world-venue-map/headless.ts +2 -1
  464. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +2 -1
  465. package/src/plugins/builtin/world-venue-map/layers.ts +3 -2
  466. package/src/plugins/builtin/world-venue-map/use-geo.ts +4 -2
  467. package/src/plugins/builtin/yield-curve/curves.ts +3 -3
  468. package/src/plugins/builtin/yield-curve/headless.ts +7 -6
  469. package/src/plugins/builtin/yield-curve/index.tsx +5 -4
  470. package/src/plugins/builtin/yield-curve/swaps.tsx +2 -1
  471. package/src/portfolio/allocation.ts +5 -5
  472. package/src/portfolio/column-values.ts +47 -41
  473. package/src/portfolio/futures-positions.ts +2 -1
  474. package/src/renderers/electrobun/bun/desktop/backend-requests.ts +7 -1
  475. package/src/renderers/opentui/ui-host.tsx +32 -2
  476. package/src/renderers/share/layout-view.tsx +2 -1
  477. package/src/sources/gloomberb-cloud/news.ts +9 -0
  478. package/src/sources/gloomberb-cloud/normalizers.ts +2 -0
  479. package/src/sources/provider-router/search.ts +15 -10
  480. package/src/state/hooks/inline-tickers.ts +3 -2
  481. package/src/state/hooks/quote-streaming.ts +9 -10
  482. package/src/team/collections-sync.ts +8 -3
  483. package/src/telemetry/usage-counts.ts +26 -0
  484. package/src/tickers/company-name-listing.ts +2 -2
  485. package/src/tickers/company-name.ts +17 -1
  486. package/src/tickers/listing-venues.ts +26 -1
  487. package/src/tickers/renamed-listings.ts +2 -1
  488. package/src/tickers/search/index.ts +19 -0
  489. package/src/tickers/starter-symbols.ts +7 -0
  490. package/src/time-series/fundamentals/statement-fields.ts +11 -14
  491. package/src/time-series/history-acquisition.ts +1 -1
  492. package/src/time-series/log-scale.ts +9 -0
  493. package/src/time-series/reporting.ts +3 -3
  494. package/src/time-series/resolve.ts +6 -4
  495. package/src/time-series/transforms.ts +10 -5
  496. package/src/types/config.ts +9 -0
  497. package/src/types/data-provider.ts +3 -2
  498. package/src/types/financials.ts +15 -0
  499. package/src/types/instrument.ts +6 -0
  500. package/src/types/plugin-panes.ts +1 -1
  501. package/src/types/plugin-reports.ts +8 -0
  502. package/src/utils/datetime-format.ts +74 -33
  503. package/src/utils/financial-statements.ts +39 -15
  504. package/src/utils/format.ts +4 -9
  505. package/src/utils/fundamentals.ts +38 -16
  506. package/src/utils/growth.ts +67 -0
  507. package/src/utils/keyboard.ts +6 -0
  508. package/src/utils/options.ts +1 -1
  509. package/src/utils/report-timing.ts +2 -2
  510. package/src/utils/served-rates.ts +45 -0
  511. package/src/utils/text-wrap.ts +84 -3
  512. package/src/utils/zoned-date-time.ts +47 -22
@@ -33,7 +33,9 @@ const NAME_NOISE = new Set([
33
33
  // Turkish legal forms short enough to open another company's name (AO Smith, AO World): a legal form only as its last word.
34
34
  const LAST_WORD_NOISE = new Set(["ao", "tas"]);
35
35
  // Words a venue adds to the share it lists ("Microsoft Corporation Common Stock"), never part of whose it is.
36
- const SHARE_NOISE = new Set(["common", "ordinary", "stock", "shares"]);
36
+ const SHARE_NOISE = new Set(["common", "ordinary", "stock", "shares", "share"]);
37
+ // A venue's short form of a share class word, read as the word: "Volkswagen AG Pref. Share" in Zurich is its "Preferred Stock".
38
+ const SHARE_WORD_FORMS: Readonly<Record<string, string>> = { pref: "preferred", pfd: "preferred" };
37
39
 
38
40
  /** A company's name for comparing its listings: "Kotobuki Spirits Co., Ltd." is "kotobuki spirits". */
39
41
  function companyKey(name: string): string {
@@ -42,6 +44,7 @@ function companyKey(name: string): string {
42
44
  .replace(/\b(?:(?:american|global) )?depositary (?:shares?|receipts?)\b/g, " ")
43
45
  .replace(/\./g, "")
44
46
  .split(/[^\p{L}\p{N}]+/u)
47
+ .map((word) => SHARE_WORD_FORMS[word] ?? word)
45
48
  .filter((word) => word && !NAME_NOISE.has(word));
46
49
  // The last word before any share wording, never a name's only one.
47
50
  let last = words.length - 1;
@@ -77,6 +80,19 @@ export function sameCompany(left: string | null | undefined, right: string | nul
77
80
  return [...fewer].every((word) => more.has(word));
78
81
  }
79
82
 
83
+ /**
84
+ * Whether two names are one company's name however each venue writes the legal
85
+ * form and the share wording: "Deutsche Post AG" and "Deutsche Post" are, "DHL
86
+ * Express" and "DHL" are not (`sameCompany` would read them as one, since one
87
+ * name's words are all in the other's). For a name the data service gives a
88
+ * company besides its own (a former name, a trade name), which a line is told
89
+ * by only when it is exactly that name. An empty name matches none.
90
+ */
91
+ export function sameCompanyName(left: string | null | undefined, right: string | null | undefined): boolean {
92
+ const a = companyKey(left ?? "");
93
+ return a !== "" && a === companyKey(right ?? "");
94
+ }
95
+
80
96
  // Words that tell one class of a company's shares from another ("Berkshire Hathaway Inc. Class B"), never its business.
81
97
  const SHARE_CLASS_WORD = /^(?:class|series|[a-z]|\d+)$/;
82
98
 
@@ -2,7 +2,7 @@ import { logFailure } from "../utils/log-failure";
2
2
  import type { DataProvider } from "../types/data-provider";
3
3
  import { quoteTradingExchange } from "../market-data/quotes/metadata";
4
4
  import type { TickerRecord } from "../types/ticker";
5
- import { AmbiguousContractError, AmbiguousTickerError, LISTING_SEARCH_LIMIT, listingChoiceQuery, listingExchange, resolveTickerSearch } from "./search";
5
+ import { AmbiguousContractError, AmbiguousTickerError, LISTING_SEARCH_LIMIT, listingChoiceQuery, listingExchange, otherNamesOf, resolveTickerSearch } from "./search";
6
6
  import {
7
7
  canonicalExchange,
8
8
  exchangeCodeVenues,
@@ -38,6 +38,29 @@ export interface ListingVenue {
38
38
  symbol?: string;
39
39
  /** The exchange withdrew the listing (Hang Seng Bank's 0011 on HKEX): it is on record, and nothing trades there. */
40
40
  withdrawal?: ListingWithdrawal;
41
+ /**
42
+ * The company the line belongs to, as the data service identifies it: two
43
+ * venues are different companies only when their ids differ, however each
44
+ * names the company (DHL Group AG on Xetra, Deutsche Post AG in Vienna).
45
+ */
46
+ companyId?: string;
47
+ /** The data service marks the line as its company's home line: its main listing. */
48
+ home?: true;
49
+ /**
50
+ * The other names the line's company answers to, as the data service sends
51
+ * them (a former name, a trade name): DHL Group's rows carry "Deutsche Post
52
+ * AG", the name it had, which a venue that never renamed its line still shows.
53
+ */
54
+ aliases?: string[];
55
+ }
56
+
57
+ /** A search row's company id and home mark, as a venue carries them. */
58
+ function identityOf(companyId: unknown, home: boolean, aliases: readonly string[] = []): Pick<ListingVenue, "companyId" | "home" | "aliases"> {
59
+ return {
60
+ ...typeof companyId === "string" && companyId ? { companyId } : {},
61
+ ...home ? { home: true as const } : {},
62
+ ...aliases.length > 0 ? { aliases: [...aliases] } : {},
63
+ };
41
64
  }
42
65
 
43
66
  /** A search row's name, and its withdrawal with the day it went beside the name, as a choice between listings names it. */
@@ -83,6 +106,7 @@ export async function listingVenues(
83
106
  exchange: resolved.result.exchange === "SMART" ? resolved.result.primaryExchange ?? "" : resolved.result.exchange || resolved.result.primaryExchange || "",
84
107
  ...withdrawnOf(resolved.result.name, resolved.result.withdrawal),
85
108
  ...ownSymbol(parsePublicTickerKey(resolved.result.symbol).symbol, symbol),
109
+ ...identityOf(resolved.result.companyId, resolved.result.homeListing === true, otherNamesOf(resolved.result)),
86
110
  };
87
111
  venues = only?.exchange ? [{ ...only, exchange: canonicalExchange(only.exchange) }] : [];
88
112
  } catch (error) {
@@ -94,6 +118,7 @@ export async function listingVenues(
94
118
  return key.exchange ? [{
95
119
  exchange: key.exchange, name: error.listingNames[listing] ?? "", ...ownSymbol(key.symbol, symbol),
96
120
  ...(error.listingWithdrawals[listing] ? { withdrawal: error.listingWithdrawals[listing] } : {}),
121
+ ...identityOf(error.listingCompanies[listing], error.listingHomes.includes(listing), error.listingAliases[listing]),
97
122
  }] : [];
98
123
  });
99
124
  }
@@ -1,3 +1,4 @@
1
+ import { formatShortDate } from "../utils/datetime-format";
1
2
  import { normalizeSearchText } from "./search/ranking";
2
3
 
3
4
  /**
@@ -47,7 +48,7 @@ const RENAMED_LISTINGS: readonly RenamedListing[] = [
47
48
 
48
49
  /** "5 Jun 2026". */
49
50
  function conversionDay(date: string): string {
50
- return new Date(`${date}T00:00:00Z`).toLocaleDateString("en-GB", { day: "numeric", month: "short", year: "numeric", timeZone: "UTC" });
51
+ return formatShortDate(date, { utc: true });
51
52
  }
52
53
 
53
54
  /** `AXIA3.SA`: the new listing as `quote` takes it. */
@@ -90,6 +90,12 @@ export class AmbiguousTickerError extends Error {
90
90
  readonly listingNames: Readonly<Record<string, string>> = {},
91
91
  /** The listings among them their exchange withdrew, by key (`0011:HKEX`). */
92
92
  readonly listingWithdrawals: Readonly<Record<string, ListingWithdrawal>> = {},
93
+ /** Each listing's company as the data service identifies it (`companyId`), by key, where it sent one. */
94
+ readonly listingCompanies: Readonly<Record<string, string>> = {},
95
+ /** The listings the data service marks as their company's home line (`homeListing`), by key. */
96
+ readonly listingHomes: readonly string[] = [],
97
+ /** The other names each listing's company answers to (a former name, a trade name), by key, where the service sent any. */
98
+ readonly listingAliases: Readonly<Record<string, readonly string[]>> = {},
93
99
  ) {
94
100
  // Every listing is a choice: a list cut short could leave out the one meant.
95
101
  const more = listings.length - MAX_NAMED_LISTINGS;
@@ -634,6 +640,12 @@ async function resolveTickerSymbol(
634
640
  ])), Object.fromEntries(matches.flatMap((item) => {
635
641
  const withdrawal = parseListingWithdrawal(item.result!.withdrawal);
636
642
  return withdrawal ? [[publicTickerKey(item.symbol, listingExchange(item.result!)), withdrawal]] : [];
643
+ })), Object.fromEntries(matches.flatMap((item) => typeof item.result!.companyId === "string" && item.result!.companyId
644
+ ? [[publicTickerKey(item.symbol, listingExchange(item.result!)), item.result!.companyId]] : [])),
645
+ matches.filter((item) => item.result!.homeListing === true).map((item) => publicTickerKey(item.symbol, listingExchange(item.result!))),
646
+ Object.fromEntries(matches.flatMap((item) => {
647
+ const aliases = otherNamesOf(item.result!);
648
+ return aliases.length > 0 ? [[publicTickerKey(item.symbol, listingExchange(item.result!)), aliases]] : [];
637
649
  })));
638
650
  if (pickerQuery && listings.size > 1) throw ambiguity(pickerQuery);
639
651
  // A code that names several venues (TSE) the symbol trades on more than one of is a choice.
@@ -999,6 +1011,13 @@ function getProviderHintScore(result: InstrumentSearchResult, preferredExchange?
999
1011
  return getProviderHintRichness(result) + (matchesPreferredExchange ? 10_000 : 0);
1000
1012
  }
1001
1013
 
1014
+ /** The names the row's company answers to besides its own: those the service sent it for and the name it had before. */
1015
+ export function otherNamesOf(result: InstrumentSearchResult): string[] {
1016
+ const names = [...searchResultNames(result) ?? [], ...typeof result.formerName === "string" ? [result.formerName] : []]
1017
+ .map((name) => name.trim()).filter(Boolean);
1018
+ return [...new Set(names)];
1019
+ }
1020
+
1002
1021
  /** The names the service sent the row for, without the symbol spellings; older servers send none. */
1003
1022
  function searchResultNames(result: InstrumentSearchResult): string[] | undefined {
1004
1023
  const names = Array.isArray(result.searchAliases)
@@ -6,3 +6,10 @@
6
6
  export const STARTER_SYMBOLS: ReadonlySet<string> = new Set([
7
7
  "AAPL", "MSFT", "GOOGL", "AMZN", "NVDA", "TSLA", "META", "BRK.B", "JPM", "V", "BTC-USD", "ETH-USD", "SPY", "QQQ",
8
8
  ]);
9
+
10
+ /**
11
+ * The seeded lists hold 7 (the first run) or 12 (startup) starter tickers,
12
+ * so a list with fewer was trimmed or built by hand: the server, the Monday
13
+ * brief and the company picker take it as the user's own.
14
+ */
15
+ export const SEEDED_LIST_MIN_STARTERS = 7;
@@ -3,6 +3,7 @@ import type { FinancialStatement } from "../../types/financials";
3
3
  import { completeAvailability, statementFieldAvailability } from "../../utils/financial-statements";
4
4
  import { hasStatementGap } from "../../utils/statement-gaps";
5
5
  import { isFiniteNumber } from "../../utils/guards";
6
+ import { rateValue, revenueMargin } from "../../utils/growth";
6
7
  import { type InternalStatement, type NumericStatementField, statementNumber } from "./statement";
7
8
 
8
9
  export function ratio(numerator: unknown, denominator: unknown): number | null {
@@ -11,6 +12,12 @@ export function ratio(numerator: unknown, denominator: unknown): number | null {
11
12
  : null;
12
13
  }
13
14
 
15
+ /** A margin in percent: none over zero or negative revenue, where it is not meaningful. */
16
+ function revenuePercent(numerator: unknown, revenue: unknown): { value: number | null; derived: true } {
17
+ const margin = isFiniteNumber(numerator) && isFiniteNumber(revenue) ? rateValue(revenueMargin(numerator, revenue)) : null;
18
+ return { value: margin === null ? null : margin * 100, derived: true };
19
+ }
20
+
14
21
  export function freeCashFlow(statement: FinancialStatement): { value: number | null; derived: boolean } {
15
22
  if (isFiniteNumber(statement.freeCashFlow)) return { value: statement.freeCashFlow, derived: false };
16
23
  if (isFiniteNumber(statement.operatingCashFlow) && isFiniteNumber(statement.capitalExpenditure)) {
@@ -129,23 +136,13 @@ export function fundamentalValue(
129
136
  statement: InternalStatement,
130
137
  metric: string,
131
138
  ): { value: number | null; derived: boolean } {
132
- if (metric === "grossMargin") {
133
- const value = ratio(statement.grossProfit, statement.totalRevenue);
134
- return { value: value === null ? null : value * 100, derived: true };
135
- }
136
- if (metric === "operatingMargin") {
137
- const value = ratio(statement.operatingIncome, statement.totalRevenue);
138
- return { value: value === null ? null : value * 100, derived: true };
139
- }
140
- if (metric === "netMargin") {
141
- const value = ratio(statement.netIncome, statement.totalRevenue);
142
- return { value: value === null ? null : value * 100, derived: true };
143
- }
139
+ if (metric === "grossMargin") return revenuePercent(statement.grossProfit, statement.totalRevenue);
140
+ if (metric === "operatingMargin") return revenuePercent(statement.operatingIncome, statement.totalRevenue);
141
+ if (metric === "netMargin") return revenuePercent(statement.netIncome, statement.totalRevenue);
144
142
  if (metric === "freeCashFlow" || metric === "freeCashFlowMargin") {
145
143
  const fcf = freeCashFlow(statement);
146
144
  if (metric === "freeCashFlow") return fcf;
147
- const value = ratio(fcf.value, statement.totalRevenue);
148
- return { value: value === null ? null : value * 100, derived: true };
145
+ return revenuePercent(fcf.value, statement.totalRevenue);
149
146
  }
150
147
  const value = statementNumber(statement, metric as NumericStatementField);
151
148
  const derived = statement.__timeSeriesTtm === true
@@ -85,7 +85,7 @@ export function behindHistoryNotice(
85
85
  const wall = new Date(zonedWallClockMs(getPricePointTimestamp(latest), zone)).toISOString();
86
86
  const sameYear = wall.slice(0, 4) === zonedDateKey(now, zone).slice(0, 4);
87
87
  const day = formatShortDate(wall.slice(0, 10), { utc: true, year: sameYear ? false : "numeric" });
88
- return `${instrumentLabel(source)}: newer bars are unavailable; showing saved bars as of ${day} ${wall.slice(11, 16)} ${timeZoneLabel(zone)}.`;
88
+ return `${instrumentLabel(source)}: newer bars are unavailable; showing saved bars as of ${day} ${wall.slice(11, 16)} ${timeZoneLabel(zone, getPricePointTimestamp(latest))}.`;
89
89
  }
90
90
 
91
91
  function isSortedPriceHistory(points: TickerFinancials["priceHistory"]): boolean {
@@ -0,0 +1,9 @@
1
+ /** A value a log axis cannot place: zero or below. */
2
+ export function hiddenOnLogScale(value: number | null | undefined): boolean {
3
+ return typeof value === "number" && Number.isFinite(value) && value <= 0;
4
+ }
5
+
6
+ /** What a log panel says about the values it leaves out, by the name of what holds them. */
7
+ export function logScaleHiddenWarning(name: string, hiddenCount: number): string {
8
+ return `${name}: ${hiddenCount} non-positive observation${hiddenCount === 1 ? " is" : "s are"} hidden on the logarithmic scale.`;
9
+ }
@@ -1,5 +1,6 @@
1
1
  import type { TickerFinancials } from "../types/financials";
2
2
  import { formatCompact, formatNumber } from "../utils/format";
3
+ import { growthRate, rateValue } from "../utils/growth";
3
4
  import { getTimeSeriesField } from "./field-catalog";
4
5
  import { extractFundamentalSeries } from "./fundamentals";
5
6
  import type { ResolvedSeries, SecuritySeriesSource } from "./types";
@@ -79,9 +80,8 @@ export function graphRowsForFinancials(
79
80
  date,
80
81
  category: point.periodLabel ?? date,
81
82
  value: current,
82
- growth: consecutivePeriod && typeof previous === "number" && previous !== 0
83
- ? (current - previous) / Math.abs(previous)
84
- : null,
83
+ // None off a zero or negative base, where growth is not meaningful.
84
+ growth: consecutivePeriod && typeof previous === "number" ? rateValue(growthRate(current, previous)) : null,
85
85
  barWidth: Math.max(1, Math.round((Math.abs(current) / maximum) * 24)),
86
86
  };
87
87
  });
@@ -8,6 +8,7 @@ import { historyRetentionNotice, historyStartNotice } from "../sources/history-r
8
8
  import type { BrokerContractRef } from "../types/instrument";
9
9
  import { FINANCIAL_VINTAGE_NOTICE, SEC_EPS_BASIS_NOTICE } from "../utils/financial-statements";
10
10
  import { subtractTimeRange } from "./date-window";
11
+ import { hiddenOnLogScale, logScaleHiddenWarning } from "./log-scale";
11
12
  import {
12
13
  CHART_RESOLUTION_STEP_MS,
13
14
  chartBarSizeSource,
@@ -929,8 +930,9 @@ async function resolveChartSpecPass(
929
930
  const needsFinancials = !isPriceOnlyMarketFieldId(source.fieldId)
930
931
  || !source.instrument.exchange?.trim();
931
932
  const financialsPromise = needsFinancials ? loadFinancials(source) : Promise.resolve(null);
932
- // A continuous future (HO=F) is known by its symbol: its terms load beside its history.
933
- void loadPriceUnit(source, undefined);
933
+ // A continuous future (HO=F) is known by its symbol: its terms load beside its
934
+ // history and are read below. A failed read already answers null.
935
+ loadPriceUnit(source, undefined).catch(logFailure("time-series-resolve", "Starting a futures price unit read failed"));
934
936
  let resolvedSource = source;
935
937
  let financials: TickerFinancials | null;
936
938
  let history: LoadedPriceHistory | null;
@@ -1244,13 +1246,13 @@ async function resolveChartSpecPass(
1244
1246
  }
1245
1247
  for (const panel of spec.panels) {
1246
1248
  if (panel.scale !== "log") continue;
1247
- const isHidden = (point: TimeSeriesPoint) => typeof point.value === "number" && Number.isFinite(point.value) && point.value <= 0;
1249
+ const isHidden = (point: TimeSeriesPoint) => hiddenOnLogScale(point.value);
1248
1250
  const affected = resolved.filter((entry) => entry.panelId === panel.id && entry.points.some(isHidden));
1249
1251
  const hiddenCount = affected.reduce((total, entry) => total + entry.points.filter(isHidden).length, 0);
1250
1252
  if (hiddenCount > 0) {
1251
1253
  // A panel without a title is named by the series it holds, never by its id (`main`).
1252
1254
  const name = panel.label ?? [...new Set(affected.map((entry) => entry.label))].join(", ");
1253
- warnings.push(`${name}: ${hiddenCount} non-positive observation${hiddenCount === 1 ? " is" : "s are"} hidden on the logarithmic scale.`);
1255
+ warnings.push(logScaleHiddenWarning(name, hiddenCount));
1254
1256
  }
1255
1257
  }
1256
1258
 
@@ -1,6 +1,7 @@
1
1
  import type { ResolvedSeries, SeriesTransform, TimeSeriesPoint } from "./types";
2
2
  import { calendarMonthsBefore } from "../utils/calendar-date";
3
3
  import { isFiniteNumber } from "../utils/guards";
4
+ import { growthRate, rateValue } from "../utils/growth";
4
5
  import { isOhlcSeriesStyle } from "./spec";
5
6
 
6
7
  const DAY_MS = 24 * 60 * 60 * 1_000;
@@ -26,14 +27,16 @@ function primaryValue(point: TimeSeriesPoint): number | null {
26
27
  : null;
27
28
  }
28
29
 
30
+ /** A value against a positive baseline: its change in percent, or the baseline as 100. */
29
31
  function relativeValue(value: number | null | undefined, baseline: number, index100: boolean): number | null {
30
- if (!isFiniteNumber(value) || baseline === 0) return null;
31
- return index100 ? (value / baseline) * 100 : ((value - baseline) / Math.abs(baseline)) * 100;
32
+ if (!isFiniteNumber(value) || !(baseline > 0)) return null;
33
+ return index100 ? (value / baseline) * 100 : ((value - baseline) / baseline) * 100;
32
34
  }
33
35
 
36
+ /** YoY or QoQ growth in percent: none off a zero or negative base, where it is not meaningful. */
34
37
  function growthValue(value: number | null | undefined, previous: number | null | undefined): number | null {
35
- if (!isFiniteNumber(value) || !isFiniteNumber(previous) || previous === 0) return null;
36
- return ((value - previous) / Math.abs(previous)) * 100;
38
+ const growth = rateValue(growthRate(value, previous));
39
+ return growth === null ? null : growth * 100;
37
40
  }
38
41
 
39
42
  function referencePoint(
@@ -122,7 +125,9 @@ export function applySeriesTransform(
122
125
  const baseline = options.baseline !== undefined
123
126
  ? options.baseline
124
127
  : baselinePoint ? primaryValue(baselinePoint) : null;
125
- if (baseline === null || baseline === 0) {
128
+ // Off a baseline at or below zero (a loss, a negative yield) a change in percent or an index is not
129
+ // meaningful, as growth off one is (utils/growth): the series is left as gaps.
130
+ if (baseline === null || !(baseline > 0)) {
126
131
  return points.map((point) => mapNumericFields(point, () => null));
127
132
  }
128
133
  return points.map((point) => mapNumericFields(
@@ -189,6 +189,8 @@ export type OnboardingStage =
189
189
  | "portfolio"
190
190
  | "add-ticker"
191
191
  | "desks"
192
+ /** "Which tickers do you follow?", after the desks, in the `tickers` arm of first_run_tickers. */
193
+ | "tickers"
192
194
  | "research"
193
195
  | "verify"
194
196
  | "account"
@@ -212,6 +214,13 @@ export interface OnboardingProgress {
212
214
  * step can be left, and the layouts are rebuilt in place.
213
215
  */
214
216
  rerun?: boolean;
217
+ /**
218
+ * This first run left "What do you hold?" holding nothing on a build that
219
+ * asks "Which tickers do you follow?". Only such a run is put in the
220
+ * first_run_tickers experiment, so an install that began setup on an
221
+ * earlier build never sees the step.
222
+ */
223
+ asksTickers?: boolean;
215
224
  }
216
225
 
217
226
  /**
@@ -226,8 +226,9 @@ export interface SearchRequestContext {
226
226
  brokerId?: string;
227
227
  brokerInstanceId?: string;
228
228
  /**
229
- * A person is waiting on this result, so a slow source should be abandoned in
230
- * well under a second rather than given the batch budget.
229
+ * A person is waiting on this result, so a slow broker should be abandoned in
230
+ * well under a second rather than given the batch budget. The data service is
231
+ * still waited for: its answer is the search's.
231
232
  */
232
233
  interactive?: boolean;
233
234
  /**
@@ -853,6 +853,11 @@ export interface ResultsStatementFill {
853
853
  * earlier: the document restates that period's figure as the source has it.
854
854
  */
855
855
  comparable?: ResultsFillField[];
856
+ /**
857
+ * A quarter's lines left blank because the announcements count them otherwise than the statements
858
+ * source (HSBC's revenue): set beside the source's quarters around it, the change would measure that.
859
+ */
860
+ omitted?: ResultsFillField[];
856
861
  }
857
862
 
858
863
  export type StatementFill = ExchangeStatisticsFill | ResultsStatementFill;
@@ -865,6 +870,12 @@ export interface StatementTrailing {
865
870
  priorInterim: { end: string; months: number };
866
871
  /** "FY to 2025-12-31 + 6 months to 2026-06-30 − 6 months to 2025-06-30" */
867
872
  basis: string;
873
+ /**
874
+ * Why the four quarters to the same end must not stand in for this: the latest quarters come from the
875
+ * company's announcements and the earlier ones from a source that defines a line otherwise. Absent where
876
+ * the quarters may be summed.
877
+ */
878
+ overQuarters?: string;
868
879
  }
869
880
 
870
881
  /** Per-share earnings lines that can be declared unavailable. */
@@ -1186,6 +1197,10 @@ export interface PricePoint {
1186
1197
  filled?: boolean;
1187
1198
  /** A future's session that has closed but whose settlement is not confirmed yet: its close is the last trade. */
1188
1199
  unsettled?: boolean;
1200
+ /** An index session's closing print as its last intraday bar, from its daily bar: the source keeps only the latest session's. */
1201
+ sessionClose?: boolean;
1202
+ /** An index session's last intraday bar, which ends before its close: its closing print was not at hand. */
1203
+ beforeClose?: boolean;
1189
1204
  /**
1190
1205
  * The source served the bar in the wrong unit (a tenth or a hundredth of its price, ten or a hundred times its
1191
1206
  * volume): the factor its prices were multiplied by to match the bars around it; its volume was divided by it.
@@ -93,4 +93,10 @@ export interface InstrumentSearchResult {
93
93
  /** The company's home line, its common stock on its home exchange (7203 on JPX for Toyota), sent by newer
94
94
  * cloud servers. Search lists it before the company's depositary receipts and other lines. Only `true` counts. */
95
95
  homeListing?: boolean;
96
+ /**
97
+ * The company the line belongs to, as the data service identifies it, sent by newer cloud servers on a bare
98
+ * symbol's own lines: DHL's Xetra and Vienna lines carry one id however each venue names the company. Two lines
99
+ * are different companies only when their ids differ.
100
+ */
101
+ companyId?: string;
96
102
  }
@@ -129,7 +129,7 @@ export interface PaneDef {
129
129
  * catalog lists it, and `fn` refuses an argument from a function that
130
130
  * declares none here, in its shortcut or in a `headless` model.
131
131
  */
132
- reportArgument?: Pick<HeadlessPaneArgumentDef, "kind" | "placeholder" | "description" | "optional"> & {
132
+ reportArgument?: Pick<HeadlessPaneArgumentDef, "kind" | "placeholder" | "description" | "optional" | "examples"> & {
133
133
  /**
134
134
  * The argument names something the pane opens by its own id (the story
135
135
  * pane's story id), never a symbol: `fn` does not look it up as a ticker.
@@ -10,6 +10,14 @@ export interface PaneLock {
10
10
  token?: string;
11
11
  /** The session is signed in and its email is not verified yet. */
12
12
  verifyEmail?: boolean;
13
+ /** The text the report was asked with, for a pane whose argument is free text (ASKG's question). */
14
+ argument?: string;
15
+ /**
16
+ * The functions the catalog finds for a question, best first, up to
17
+ * `limit`, with the command that runs each: what a note can offer in place
18
+ * of the locked pane. Absent where no catalog is at hand.
19
+ */
20
+ functionsFor?(question: string, limit: number): Promise<Array<{ code: string; label: string; command: string }>>;
13
21
  /**
14
22
  * Reads data as the report does, so a note can check that a free route it
15
23
  * would name has data for the symbol before naming it. Absent where nothing
@@ -1,4 +1,6 @@
1
+ import { MISSING_VALUE } from "./format";
1
2
  import { toTimestampMillis } from "./timestamp";
3
+ import { timeZoneLabel } from "./zoned-date-time";
2
4
 
3
5
  export type DisplayDateValue = Date | string | number | null | undefined;
4
6
 
@@ -22,7 +24,7 @@ function elapsedUnits(ageMs: number): { count: number; unit: "m" | "h" | "d" } |
22
24
  }
23
25
 
24
26
  /** Age for a narrow column: "<1m", "5m", "3h", "2d". */
25
- export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback = "-"): string {
27
+ export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback = MISSING_VALUE): string {
26
28
  const date = parseDisplayDate(value);
27
29
  if (!date) return fallback;
28
30
 
@@ -51,9 +53,6 @@ export function formatCountdown(ms: number): string {
51
53
 
52
54
  // Reuse the locale formatter when a feed contains older items. Constructing
53
55
  // one for every row dominates opening a long transcript, even without edits.
54
- const olderRelativeDateFormatter = new Intl.DateTimeFormat("en-US", {
55
- month: "numeric", day: "numeric", year: "2-digit",
56
- });
57
56
 
58
57
  /**
59
58
  * Relative time that turns into a date ("1/5/26") after a week, for feeds read
@@ -66,15 +65,17 @@ export function formatTimeAgo(date: Date | string, { short = false }: { short?:
66
65
  const elapsed = elapsedUnits(Date.now() - ts);
67
66
  if (!elapsed) return short ? "<1m" : "just now";
68
67
  if (elapsed.unit === "d" && elapsed.count >= 7) {
69
- return olderRelativeDateFormatter.format(ts);
68
+ // As a feed writes a day past the week: "5 Nov", "5 Nov '25" in another year, never "11/5/26".
69
+ const date = new Date(ts);
70
+ return formatShortDate(date, { year: date.getFullYear() === new Date().getFullYear() ? false : "2-digit" });
70
71
  }
71
72
  return `${elapsed.count}${elapsed.unit}${short ? "" : " ago"}`;
72
73
  }
73
74
 
74
75
  export interface ShortDateOptions {
75
- /** "Jan 5, 2026" (the default), "Jan 5, 26", or no year at all ("Jan 5"). */
76
+ /** "5 Jan 2026" (the default), "5 Jan '26" as option expiries write it, or no year at all ("5 Jan"). */
76
77
  year?: "numeric" | "2-digit" | false;
77
- /** "2-digit" pads the day so dates line up in a column ("Jan 05"). */
78
+ /** "2-digit" pads the day so dates line up in a column ("05 Jan"). */
78
79
  day?: "numeric" | "2-digit";
79
80
  /** Read the day in UTC, for date-only values that name a calendar day rather than an instant. */
80
81
  utc?: boolean;
@@ -84,10 +85,20 @@ export interface ShortDateOptions {
84
85
 
85
86
  const shortDateFormatters = new Map<string, Intl.DateTimeFormat>();
86
87
 
87
- /** A month-name date such as "Jan 5, 2026", in local time unless `utc` is set. */
88
+ /**
89
+ * A formatter's date written day first ("Fri 5 Jan 2026"). A two-digit year
90
+ * takes an apostrophe ("5 Jan '26"), so it never reads as another day.
91
+ */
92
+ export function dayFirstParts(formatter: Intl.DateTimeFormat, date: Date): string {
93
+ const parts = Object.fromEntries(formatter.formatToParts(date).map((part) => [part.type, part.value]));
94
+ const year = parts.year ? ` ${parts.year.length === 2 ? `'${parts.year}` : parts.year}` : "";
95
+ return `${parts.weekday ? `${parts.weekday} ` : ""}${parts.day} ${parts.month}${year}`;
96
+ }
97
+
98
+ /** A day-first month-name date such as "5 Jan 2026", in local time unless `utc` is set. */
88
99
  export function formatShortDate(value: DisplayDateValue, options: ShortDateOptions = {}): string {
89
100
  const date = parseDisplayDate(value);
90
- if (!date) return options.fallback ?? "-";
101
+ if (!date) return options.fallback ?? MISSING_VALUE;
91
102
  const { year = "numeric", day = "numeric", utc = false } = options;
92
103
  const key = `${year}:${day}:${utc}`;
93
104
  let formatter = shortDateFormatters.get(key);
@@ -100,11 +111,26 @@ export function formatShortDate(value: DisplayDateValue, options: ShortDateOptio
100
111
  });
101
112
  shortDateFormatters.set(key, formatter);
102
113
  }
103
- return formatter.format(date);
114
+ return dayFirstParts(formatter, date);
115
+ }
116
+
117
+ const weekdayDayFormatters = new Map<string, Intl.DateTimeFormat>();
118
+
119
+ /** A weekday and day-first date ("Fri 16 Oct"), with a year only when asked for. */
120
+ export function formatWeekdayDay(value: DisplayDateValue, { timeZone, year = false }: { timeZone?: string; year?: boolean } = {}): string {
121
+ const date = parseDisplayDate(value);
122
+ if (!date) return MISSING_VALUE;
123
+ const key = `${timeZone ?? ""}:${year}`;
124
+ let formatter = weekdayDayFormatters.get(key);
125
+ if (!formatter) {
126
+ formatter = new Intl.DateTimeFormat("en-US", { weekday: "short", day: "numeric", month: "short", year: year ? "numeric" : undefined, timeZone });
127
+ weekdayDayFormatters.set(key, formatter);
128
+ }
129
+ return dayFirstParts(formatter, date);
104
130
  }
105
131
 
106
132
  /**
107
- * The day a filing is dated, as the agency and the filer write it: "Nov 04,
133
+ * The day a filing is dated, as the agency and the filer write it: "04 Nov
108
134
  * 2026", the day padded so a column of them lines up. A calendar day, read in
109
135
  * UTC, so it never moves with the viewer's zone: give it the filing date
110
136
  * (`2026-11-04`, or that day at midnight UTC), not an acceptance instant,
@@ -151,14 +177,14 @@ function utcMidnight(date: Date): number {
151
177
  /**
152
178
  * When a feed item was published, in local time, as a newswire prints it:
153
179
  * the time today ("14:32"), the weekday and time over the six days before
154
- * ("Mon 09:10"), and the date for anything older ("Sep 18", or "Sep 18, 25"
180
+ * ("Mon 09:10"), and the date for anything older ("18 Sep", or "18 Sep '25"
155
181
  * in another year). A weekday never names a day a week or more back. With
156
182
  * `utc`, the same in UTC, for a column whose header names the zone.
157
183
  */
158
184
  export function formatFeedTime(
159
185
  value: DisplayDateValue,
160
186
  now = Date.now(),
161
- fallback = "-",
187
+ fallback = MISSING_VALUE,
162
188
  { utc = false, dayToday = false }: {
163
189
  utc?: boolean;
164
190
  /** Today's time carries its weekday too ("Sat 00:47"), for a column whose other rows name theirs ("Fri 21:00"). */
@@ -178,42 +204,57 @@ export function formatFeedTime(
178
204
  }
179
205
 
180
206
  /**
181
- * A date and time in the host's zone, with the zone named: "Oct 7, 2026 at
182
- * 11:38 PM GMT+2", "... 5:38 PM EDT", "... 9:38 PM UTC". Without the zone a
207
+ * A date and time in the host's zone, with the zone named: "7 Oct 2026,
208
+ * 23:38 CET", "... 17:38 ET", "... 21:38 UTC". Without the zone a
183
209
  * time read beside a list in UTC looks two hours off.
184
210
  */
185
- export function formatDetailDate(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
211
+ export function formatDetailDate(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
186
212
  const date = parseDisplayDate(value);
187
213
  if (!date) return fallback;
188
214
 
189
- const datePart = date.toLocaleDateString("en-US", {
215
+ const datePart = dayFirstParts(new Intl.DateTimeFormat("en-US", {
190
216
  month: "short",
191
217
  day: "numeric",
192
218
  year: "numeric",
193
219
  timeZone,
194
- });
195
- return `${datePart} at ${formatDetailTime(date, fallback, timeZone)}`;
220
+ }), date);
221
+ return `${datePart}, ${formatDetailTime(date, fallback, timeZone)}`;
196
222
  }
197
223
 
198
224
  /**
199
- * The host's zone as a time beside it names it ("GMT+8", "EDT", "UTC"), for a
200
- * column header over times in that zone ("TIME GMT+8"), as `formatDetailTime`
201
- * names it after one time.
225
+ * The host's zone as a time beside it names it, for a column header over times
226
+ * in that zone ("TIME CET"), as `formatDetailTime` names it after one time:
227
+ * the name the charts and session lines give it at that time ("UTC", "ET",
228
+ * "CET" or "CEST", "JST", else the city). News read "TIME GMT+1" over a
229
+ * chart's "CET" (review, 12 Nov 2026).
202
230
  */
203
231
  export function localTimeZoneShortName(now: DisplayDateValue = Date.now(), timeZone?: string): string {
204
- const date = parseDisplayDate(now) ?? new Date();
205
- return new Intl.DateTimeFormat("en-US", { timeZoneName: "short", timeZone }).formatToParts(date)
206
- .find((part) => part.type === "timeZoneName")?.value ?? "UTC";
232
+ const zone = timeZone ?? new Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
233
+ return timeZoneLabel(zone, (parseDisplayDate(now) ?? new Date()).getTime());
207
234
  }
208
235
 
209
- /** The time of `formatDetailDate` alone, its zone named: "11:38 PM GMT+2", for a day stated beside it. */
210
- export function formatDetailTime(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
236
+ const zonedClockFormatters = new Map<string, Intl.DateTimeFormat>();
237
+
238
+ /**
239
+ * A time of day on the 24-hour clock every pane reads ("09:05", "23:38"), in
240
+ * the host's zone unless `timeZone` is given. Never AM/PM: one footer read
241
+ * "8:30 AM" beside another's "14:32" (review, 12 Nov 2026).
242
+ */
243
+ export function formatClockTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
211
244
  const date = parseDisplayDate(value);
212
245
  if (!date) return fallback;
213
- return date.toLocaleTimeString("en-US", {
214
- hour: "numeric",
215
- minute: "2-digit",
216
- timeZoneName: "short",
217
- timeZone,
218
- });
246
+ if (!timeZone) return clockFormatter.format(date);
247
+ let formatter = zonedClockFormatters.get(timeZone);
248
+ if (!formatter) {
249
+ formatter = new Intl.DateTimeFormat("en-US", { hour: "2-digit", minute: "2-digit", hourCycle: "h23", timeZone });
250
+ zonedClockFormatters.set(timeZone, formatter);
251
+ }
252
+ return formatter.format(date);
253
+ }
254
+
255
+ /** The time of `formatDetailDate` alone, its zone named: "23:38 CET", for a day stated beside it. */
256
+ export function formatDetailTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
257
+ const date = parseDisplayDate(value);
258
+ if (!date) return fallback;
259
+ return `${formatClockTime(date, fallback, timeZone)} ${localTimeZoneShortName(date, timeZone)}`;
219
260
  }