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
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import { useCallback, useMemo, useRef, useState } from "react";
2
3
  import { ChartTableHeader, CompositeChart, DataTableStackView, spanDigits, DataTableView, PaneStatusBody, QueryBar, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, useQueryBarSearch, type ChartTableChart, type DataTableColumn, type SelectControl } from "../../../components";
3
4
  import { useAsyncResource, usePluginPaneState, useShortcut } from "../../../public/react";
@@ -40,7 +41,7 @@ const NET_PRICE_PANELS = [{ id: "net", height: 2 }, { id: "price", height: 1 }];
40
41
  const NET_PANEL = [{ id: "net" }];
41
42
  /** Legend, four net rows, two price rows and the axis; a shorter band keeps the net alone. */
42
43
  const PRICE_PANEL_MIN_ROWS = 8;
43
- const rank = (value: number | null | undefined) => value == null ? "--" : value.toFixed(0);
44
+ const rank = (value: number | null | undefined) => value == null ? MISSING_VALUE : value.toFixed(0);
44
45
  /** A class's rank in a percentile column: 1Y, 3Y, or against every stored report (`all`). */
45
46
  const columnRank = (row: CotClassSummary, column: string) =>
46
47
  (column === "one" ? row.percentile1Y : column === "three" ? row.percentile3Y : row.percentileAll)?.value ?? null;
@@ -110,7 +111,7 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
110
111
  ] : [] }), [boardShown, focusSearch]);
111
112
  usePaneNoticeFooter({ registrationId: "cot:board-notices", focused, enabled: !open, notices: data?.gaps ?? [] });
112
113
  usePaneStatusFooter({ registrationId: "cot:board", enabled: !open, loading: resource.loading, error: resource.error,
113
- info: data ? [{ id: "as-of", parts: [{ text: `CFTC ${cotPositionsText(positions)} · ${data.asOf ?? "--"} · contracts`, tone: "muted" }] }] : [] });
114
+ info: data ? [{ id: "as-of", parts: [{ text: `CFTC ${cotPositionsText(positions)} · ${data.asOf ?? MISSING_VALUE} · contracts`, tone: "muted" }] }] : [] });
114
115
  // A class change reloads under the query bar, which stays.
115
116
  return <DataTableStackView<CotBoardRow> columns={BOARD_COLUMNS} items={rows} focused={focused && !searching}
116
117
  status={data ? undefined : { loading: resource.loading, error: resource.error, empty: !resource.loading && !resource.error, subject: "COT history" }}
@@ -196,7 +197,7 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
196
197
  usePaneStatusFooter({ registrationId: "cot:detail", loading: resource.loading, error: resource.error,
197
198
  // The unit the net is counted in, as `fn COT` titles it: what one contract is, where the report says.
198
199
  // Futures and options combined says so; futures only reads as it always has.
199
- info: payload ? [{ id: "as-of", parts: [{ text: `CFTC ${positions === "combined" ? `${cotPositionsText(positions)} · ` : ""}${payload.asOf ?? "--"} · ${cotContractUnitText(payload.contract?.contractUnits) ?? "contracts"}${data?.priceAsOf ? ` · ${data.priceSymbol} ${data.priceAsOf}` : ""}`, tone: "muted" }] }] : [] });
200
+ info: payload ? [{ id: "as-of", parts: [{ text: `CFTC ${positions === "combined" ? `${cotPositionsText(positions)} · ` : ""}${payload.asOf ?? MISSING_VALUE} · ${cotContractUnitText(payload.contract?.contractUnits) ?? "contracts"}${data?.priceAsOf ? ` · ${data.priceSymbol} ${data.priceAsOf}` : ""}`, tone: "muted" }] }] : [] });
200
201
  return <PaneStatusBody loading={resource.loading && !data} error={!data ? resource.error : null} empty={!!payload && !payload.contract} subject="COT contract">
201
202
  {payload && data ? <DataTableView columns={POSITION_COLUMNS} items={payload.positions} focused={focused} rootWidth={width} rootHeight={height}
202
203
  rootBefore={<ChartTableHeader width={width} height={height} tableRows={payload.positions.length} chart={chart}
@@ -1,12 +1,13 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { CpiRow } from "../../../api-client/cpi";
2
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
3
4
  import { fetchCpiBoard } from "./client";
4
5
  import { cpiHeaderLine, cpiMonth, cpiRowOption, cpiRows } from "./model";
5
6
 
6
7
  /** Two decimals; a value that rounds to zero reads 0.00, never -0.00. */
7
- const percent = (value: unknown) => typeof value === "number" ? (Number(value.toFixed(2)) === 0 ? "0.00" : value.toFixed(2)) : "--";
8
- const weight = (value: unknown) => typeof value === "number" ? value.toFixed(3) : "--";
9
- const text = (value: unknown) => typeof value === "string" ? value : "--";
8
+ const percent = (value: unknown) => typeof value === "number" ? (Number(value.toFixed(2)) === 0 ? "0.00" : value.toFixed(2)) : MISSING_VALUE;
9
+ const weight = (value: unknown) => typeof value === "number" ? value.toFixed(3) : MISSING_VALUE;
10
+ const text = (value: unknown) => typeof value === "string" ? value : MISSING_VALUE;
10
11
 
11
12
  /** One row per component in the release's order; numbers stay raw for JSON, rounded for text. */
12
13
  function reportRow(row: CpiRow, indent = true) {
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { CpiBoardPayload, CpiReleaseStatus, CpiRow } from "../../../api-client/cpi";
2
3
  import type { ChartStripSpec } from "../../../components/chart-table/header";
3
4
  import { staticSeries } from "../../../components/chart/static/series";
@@ -94,11 +95,11 @@ function signed(value: number, decimals: number): string {
94
95
  }
95
96
 
96
97
  /** Percent changes as the pane shows them: two decimals, signed, no unit (the header names it). */
97
- export const formatCpiChange = (value: number | null) => value == null ? "--" : signed(value, 2);
98
+ export const formatCpiChange = (value: number | null) => value == null ? MISSING_VALUE : signed(value, 2);
98
99
  /** Contributions in percentage points, two decimals, signed. */
99
- export const formatCpiPoints = (value: number | null) => value == null ? "--" : signed(value, 2);
100
+ export const formatCpiPoints = (value: number | null) => value == null ? MISSING_VALUE : signed(value, 2);
100
101
  /** Share of the basket, percent: one decimal. */
101
- export const formatCpiWeight = (value: number | null) => value == null ? "--" : value.toFixed(1);
102
+ export const formatCpiWeight = (value: number | null) => value == null ? MISSING_VALUE : value.toFixed(1);
102
103
 
103
104
  const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
104
105
 
@@ -107,19 +108,19 @@ export function cpiMonth(period: string): string {
107
108
  return `${MONTHS[Number(period.slice(5, 7)) - 1]} ${period.slice(0, 4)}`;
108
109
  }
109
110
 
110
- /** A release instant on BLS's own clock: "Wed Oct 14 08:30 ET". */
111
+ /** A release instant on BLS's own clock: "Wed 14 Oct 08:30 ET". */
111
112
  function releaseTime(iso: string): string {
112
113
  const parts = Object.fromEntries(new Intl.DateTimeFormat("en-US", {
113
114
  timeZone: "America/New_York", weekday: "short", month: "short", day: "numeric",
114
115
  hour: "2-digit", minute: "2-digit", hourCycle: "h23",
115
116
  }).formatToParts(new Date(iso)).map((part) => [part.type, part.value]));
116
- return `${parts.weekday} ${parts.month} ${parts.day} ${parts.hour}:${parts.minute} ET`;
117
+ return `${parts.weekday} ${parts.day} ${parts.month} ${parts.hour}:${parts.minute} ET`;
117
118
  }
118
119
 
119
120
  /**
120
121
  * The month the data covers, when it came out and when the next release is
121
- * due, on one line: "Aug 2026 · released Fri Sep 11 08:30 ET · next Wed Oct
122
- * 14 08:30 ET". A release past its time and not in yet reads "due".
122
+ * due, on one line: "Aug 2026 · released Fri 11 Sep 08:30 ET · next Wed
123
+ * 14 Oct 08:30 ET". A release past its time and not in yet reads "due".
123
124
  */
124
125
  export function cpiHeaderLine(release: CpiReleaseStatus, now = Date.now()): string | undefined {
125
126
  if (!release.period) return undefined;
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import { useMemo } from "react";
2
3
  import {
3
4
  DELAYED_SEGMENT,
@@ -75,7 +76,7 @@ function IndexDetail({ row, width, height, focused }: { row: CdxRow; width: numb
75
76
  ...(index.recovery != null ? [`${Math.round(index.recovery * 100)}% recovery`] : [])].join(" · ");
76
77
  const items: StatItem[] = [
77
78
  { id: "level", label: index.quote === "spread" ? "5Y spread" : "5Y price", value: formatLevel(index.quote, index.level),
78
- detail: [...(rankOnSpreadEq ? [] : [formatSpreadRank(rank)]), index.date ?? "--", ...(index.kind === "settlement" ? [SETTLEMENT_TEXT] : [])].join(" · ") },
79
+ detail: [...(rankOnSpreadEq ? [] : [formatSpreadRank(rank)]), index.date ?? MISSING_VALUE, ...(index.kind === "settlement" ? [SETTLEMENT_TEXT] : [])].join(" · ") },
79
80
  ...(index.quote === "price" && index.spreadBp !== undefined ? [{ id: "spread", label: "Spread eq", value: formatLevel("spread", index.spreadBp ?? null),
80
81
  ...(spreadDetail ? { detail: spreadDetail } : {}) }] : []),
81
82
  { id: "1d", label: "1D", value: formatMove(index.quote, day.change1D), ...(through ? { detail: through } : {}) },
@@ -83,7 +84,7 @@ function IndexDetail({ row, width, height, focused }: { row: CdxRow; width: numb
83
84
  { id: "1m", label: "1M", value: formatMove(index.quote, day.change1M) },
84
85
  { id: "range", label: "1Y range", value: `${formatLevel(index.quote, year.low)} to ${formatLevel(index.quote, year.high)}` },
85
86
  { id: "contract", label: "Contract", value: formatContract(index.maturity), detail: `${index.couponBp}bp coupon` },
86
- { id: "prints", label: "Prints", value: index.prints == null ? "--" : String(index.prints),
87
+ { id: "prints", label: "Prints", value: index.prints == null ? MISSING_VALUE : String(index.prints),
87
88
  // The value is the count already: the detail says only that the day is still trading, and its last print.
88
89
  ...(day.partial ? { detail: partialDayText(null, day.lastPrintAt) } : {}) },
89
90
  ];
@@ -160,7 +161,7 @@ export function CdxPane({ focused, width, height }: PaneProps) {
160
161
  column: { id: "spread", label: "SPREAD EQ", width: 9, align: "right" as const },
161
162
  sortValue: (row: CdxRow) => row.index.quote === "price" ? row.index.spreadBp ?? null : null,
162
163
  renderCell: (row: CdxRow) => ({
163
- text: row.index.quote === "price" ? formatLevel("spread", row.index.spreadBp ?? null) : "--",
164
+ text: row.index.quote === "price" ? formatLevel("spread", row.index.spreadBp ?? null) : MISSING_VALUE,
164
165
  color: theme.textMuted,
165
166
  }),
166
167
  }] : []),
@@ -168,7 +169,7 @@ export function CdxPane({ focused, width, height }: PaneProps) {
168
169
  column: { id: "prints", label: "PRINTS", width: 7, align: "right" as const },
169
170
  sortValue: (row: CdxRow) => row.index.prints,
170
171
  renderCell: (row: CdxRow) => ({
171
- text: row.index.prints == null ? "--" : String(row.index.prints),
172
+ text: row.index.prints == null ? MISSING_VALUE : String(row.index.prints),
172
173
  color: theme.textMuted,
173
174
  }),
174
175
  },
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { HeadlessPaneColumn, HeadlessPaneDefinition, HeadlessPaneRow } from "../../../types/plugin";
2
3
  import type { CdxBoardIndex, CreditIndexQuote } from "../../../api-client/credit-boards";
3
4
  import { boardPublisher, CDX_MAX_DAYS, fetchCdxBoard, fetchSovrBoard, loadCurrencyMoves } from "./client";
@@ -17,7 +18,7 @@ import {
17
18
  sovrRows,
18
19
  } from "./model";
19
20
 
20
- const percentile = (value: unknown) => value == null ? "--" : Number(value).toFixed(0);
21
+ const percentile = (value: unknown) => value == null ? MISSING_VALUE : Number(value).toFixed(0);
21
22
  /** A 1Y rank as the board draws it, a whole number, so exports do not carry 8.23293172691. */
22
23
  const rank = (value: number | null) => value == null ? null : Math.round(value);
23
24
  /** The series a row is of, as `history` and the data catalog name it: `cdx:hy`, `sovereign-cds:br`. */
@@ -10,7 +10,7 @@ import { historyStatistics } from "../../../components/chart/curve/model";
10
10
  import type { MarketBoardRow } from "../../../components/market-board";
11
11
  import type { PricePoint } from "../../../types/financials";
12
12
  import type { HeadlessPaneColumn } from "../../../types/plugin";
13
- import { formatPercentileRank } from "../../../utils/format";
13
+ import { MISSING_VALUE, formatPercentileRank } from "../../../utils/format";
14
14
 
15
15
  const YEAR_DAYS = 365;
16
16
  /** A level older than this is not the current market. */
@@ -135,13 +135,13 @@ export function partialDayText(prints: number | null, lastPrintAt: string | null
135
135
 
136
136
  /** Spreads in bp with a decimal; prices as quoted, to the cent. */
137
137
  export function formatLevel(quote: CreditIndexQuote, value: number | null): string {
138
- if (value == null || !Number.isFinite(value)) return "--";
138
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
139
139
  return quote === "spread" ? `${value.toFixed(1)}bp` : value.toFixed(2);
140
140
  }
141
141
 
142
142
  /** A move in the quote's unit: `+1.2bp`, or `-0.13` points of price. */
143
143
  export function formatMove(quote: CreditIndexQuote, value: number | null): string {
144
- if (value == null || !Number.isFinite(value)) return "--";
144
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
145
145
  const digits = quote === "spread" ? 1 : 2;
146
146
  const rounded = Number(value.toFixed(digits));
147
147
  const sign = rounded > 0 ? "+" : "";
@@ -235,7 +235,7 @@ function stale(date: string | null, asOf: string | null): boolean {
235
235
 
236
236
  /** `2031-12-20` as `Dec 2031`, how the contract is named on a desk. */
237
237
  export function formatContract(maturity: string | null): string {
238
- if (!maturity) return "--";
238
+ if (!maturity) return MISSING_VALUE;
239
239
  const date = new Date(`${maturity}T00:00:00Z`);
240
240
  return Number.isNaN(date.getTime())
241
241
  ? maturity
@@ -336,7 +336,7 @@ export function sovrRows(
336
336
 
337
337
  /** `BRL -1.2%`; a dollar or dollar-pegged currency still shows its code. */
338
338
  export function formatCurrencyMove(currency: string, movePercent: number | null): string {
339
- if (movePercent == null || !Number.isFinite(movePercent)) return `${currency} --`;
339
+ if (movePercent == null || !Number.isFinite(movePercent)) return `${currency} ${MISSING_VALUE}`;
340
340
  const rounded = Number(movePercent.toFixed(1));
341
341
  const sign = rounded > 0 ? "+" : "";
342
342
  return `${currency} ${sign}${rounded === 0 ? "0.0" : rounded.toFixed(1)}%`;
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type {
2
3
  HeadlessPaneDefinition,
3
4
  HeadlessPaneLoadArgs,
@@ -35,7 +36,7 @@ const COLUMNS = [
35
36
  key: "dailyChangeBp",
36
37
  header: "1D",
37
38
  align: "right" as const,
38
- format: (value: unknown) => value == null ? "-" : `${Number(value) > 0 ? "+" : ""}${Number(value).toFixed(1)}bp`,
39
+ format: (value: unknown) => value == null ? MISSING_VALUE : `${Number(value) > 0 ? "+" : ""}${Number(value).toFixed(1)}bp`,
39
40
  },
40
41
  { key: "date", header: "As of" },
41
42
  ];
@@ -18,7 +18,7 @@ import { StatChartDetail } from "../../../components/market-board";
18
18
  import { useAsyncResource } from "../../../react/async-resource";
19
19
  import { colors } from "../../../theme/colors";
20
20
  import type { PaneProps } from "../../../types/plugin";
21
- import { formatPercentileRank } from "../../../utils/format";
21
+ import { MISSING_VALUE, formatPercentileRank } from "../../../utils/format";
22
22
  import { usePaneSettingValue } from "../../../state/app/context";
23
23
  import { usePluginPaneState } from "../../runtime";
24
24
  import type { PluginModule } from "../plugin-module";
@@ -34,7 +34,7 @@ const EMPTY_ROWS: CreditConditionRow[] = [];
34
34
  const PANELS = [{ id: "main" }];
35
35
 
36
36
  function formatBp(value: number | null, signed = false): string {
37
- if (value == null) return "--";
37
+ if (value == null) return MISSING_VALUE;
38
38
  const sign = signed && value > 0 ? "+" : "";
39
39
  return `${sign}${value.toFixed(1)}bp`;
40
40
  }
@@ -3,7 +3,7 @@ import type { DataTableColumn, StatItem } from "../../../components";
3
3
  import { scalarPoint, staticSeries } from "../../../components/chart/static/series";
4
4
  import { dropColumnsToFit } from "../../../components/ui/table-layout";
5
5
  import type { ResolvedSeries } from "../../../time-series/types";
6
- import { displayWidth } from "../../../utils/format";
6
+ import { MISSING_VALUE, displayWidth } from "../../../utils/format";
7
7
 
8
8
  export const CREDIT_TABS = [{ value: "capital", label: "Capital" }, { value: "covenants", label: "Covenants" }, { value: "maturities", label: "Maturities" }, { value: "screen", label: "Screen" }] as const;
9
9
  export type CreditTab = typeof CREDIT_TABS[number]["value"];
@@ -11,7 +11,7 @@ export const creditTab = (value: unknown): CreditTab => CREDIT_TABS.find((tab) =
11
11
  /** `maintenance_covenant` and `adjustmentReason` both read as words. */
12
12
  export const fieldLabel = (field: string) => field.replace(/_/g, " ").replace(/([a-z])([A-Z])/g, (_, a: string, b: string) => `${a} ${b.toLowerCase()}`).replace(/^./, (value) => value.toUpperCase());
13
13
  /** The one placeholder for a value the documents do not support. */
14
- export const NO_VALUE = "--";
14
+ export const NO_VALUE = MISSING_VALUE;
15
15
  export const sentence = (value: string) => value.replace(/^./, (first) => first.toUpperCase());
16
16
  export const creditAmount = (value: number | null | undefined): string => value == null ? NO_VALUE : new Intl.NumberFormat("en-US", { notation: "compact", maximumFractionDigits: 2 }).format(value);
17
17
  export const creditPercent = (value: number | null | undefined): string => value == null ? NO_VALUE : `${value.toFixed(1)}%`;
@@ -14,7 +14,7 @@ import { handleRefreshKey } from "../../../components/data-table/table-pane";
14
14
  import type { DefiTvlPayload } from "../../../api-client/crypto-markets";
15
15
  import { colors, priceColor } from "../../../theme/colors";
16
16
  import { SERIES_COLORS } from "../../../theme/series-colors";
17
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
17
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
18
18
  import { usePluginPaneState } from "../../runtime";
19
19
  import {
20
20
  buildDefiColumns,
@@ -47,7 +47,7 @@ function signedPercent(value: number | null): DataTableCell {
47
47
 
48
48
  function signedAmount(value: number | null): DataTableCell {
49
49
  return {
50
- text: value == null ? "—" : formatCompactAmount(value, { signed: true }),
50
+ text: value == null ? MISSING_VALUE : formatCompactAmount(value, { signed: true }),
51
51
  color: value == null ? colors.textDim : priceColor(value),
52
52
  };
53
53
  }
@@ -59,7 +59,7 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
59
59
  case "name":
60
60
  return { text: row.name, color: colors.textBright };
61
61
  case "detail":
62
- return { text: row.detail ?? "—", color: colors.textDim };
62
+ return { text: row.detail ?? MISSING_VALUE, color: colors.textDim };
63
63
  case "tvl":
64
64
  return { text: formatTvl(row.tvl) };
65
65
  case "change1dPercent":
@@ -73,9 +73,9 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
73
73
  case "change30dPercent":
74
74
  return signedPercent(row.change30dPercent);
75
75
  case "share":
76
- return { text: row.share == null ? "—" : `${row.share.toFixed(2)}%`, color: colors.textDim };
76
+ return { text: row.share == null ? MISSING_VALUE : `${row.share.toFixed(2)}%`, color: colors.textDim };
77
77
  case "chains":
78
- return { text: row.chains == null ? "—" : String(row.chains), color: colors.textDim };
78
+ return { text: row.chains == null ? MISSING_VALUE : String(row.chains), color: colors.textDim };
79
79
  case "fees24h":
80
80
  case "fees7d":
81
81
  case "fees30d":
@@ -83,7 +83,7 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
83
83
  case "revenue7d":
84
84
  case "revenue30d": {
85
85
  const value = row[column.id];
86
- return value == null ? { text: "—", color: colors.textDim } : { text: formatTvl(value) };
86
+ return value == null ? { text: MISSING_VALUE, color: colors.textDim } : { text: formatTvl(value) };
87
87
  }
88
88
  }
89
89
  }
@@ -93,7 +93,7 @@ function changeFigure(id: string, label: string, amount: number | null, percent:
93
93
  return {
94
94
  id,
95
95
  label,
96
- value: amount == null ? "—" : formatCompactAmount(amount, { signed: true }),
96
+ value: amount == null ? MISSING_VALUE : formatCompactAmount(amount, { signed: true }),
97
97
  detail: formatCryptoPercent(percent),
98
98
  ...(amount == null ? {} : { color: priceColor(amount) }),
99
99
  };
@@ -1,7 +1,7 @@
1
1
  import type { DefiTvlChain, DefiTvlPayload, DefiTvlProtocol } from "../../../api-client/crypto-markets";
2
2
  import type { DataTableColumn } from "../../../components";
3
3
  import { getTableWidth } from "../../../components/ui/table-layout";
4
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
4
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
5
5
  import { compareSortValues, nextHeaderSort, type SortDirection } from "../../../utils/sort-values";
6
6
  import { formatUtcTime } from "../../../utils/utc-time";
7
7
  import { formatCryptoPercent, utcCloseAsOfText } from "./model";
@@ -139,7 +139,7 @@ export function defiHistoryRows(payload: DefiTvlPayload): Array<{ date: string;
139
139
  }
140
140
 
141
141
  const change = (amount: number | null, percent: number | null) =>
142
- amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`;
142
+ amount == null ? MISSING_VALUE : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`;
143
143
 
144
144
  /**
145
145
  * How the total's days are dated: each by the UTC day it closes, which
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { CryptoAssetKind, CryptoMarketAsset, CryptoPeg } from "../../../api-client/crypto-markets";
2
3
  import type { DataTableColumn } from "../../../components";
3
4
  import { getTableWidth } from "../../../components/ui/table-layout";
@@ -283,7 +284,7 @@ function dayRange(asset: CryptoMarketAsset, price: number, updatedAt: number | n
283
284
 
284
285
  /** `Sat 11:30` UTC; a dash when unknown. */
285
286
  export function formatDayRangeTime(ms: number | null): string {
286
- return ms == null ? "—" : formatUtcWeekdayTime(ms) || "—";
287
+ return ms == null ? MISSING_VALUE : formatUtcWeekdayTime(ms) || MISSING_VALUE;
287
288
  }
288
289
 
289
290
  const rowsByAsset = new WeakMap<CryptoMarketAsset, { quote: Quote | null; day: number; row: CryptoRow }>();
@@ -363,14 +364,14 @@ export function cryptoRowObservations(rows: readonly CryptoRow[]): CryptoRowObse
363
364
  * keeps its decimals.
364
365
  */
365
366
  export function formatCryptoPrice(value: number | null, minimumDecimals = 2, referencePrice?: number | null): string {
366
- if (value == null || !Number.isFinite(value) || value <= 0) return "—";
367
+ if (value == null || !Number.isFinite(value) || value <= 0) return MISSING_VALUE;
367
368
  const magnitude = Math.floor(Math.log10(positive(referencePrice) ? referencePrice : value));
368
369
  const decimals = Math.min(12, Math.max(minimumDecimals, 3 - magnitude));
369
370
  return value.toLocaleString("en-US", { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
370
371
  }
371
372
 
372
373
  export function formatCryptoPercent(value: number | null): string {
373
- if (value == null || !Number.isFinite(value)) return "—";
374
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
374
375
  const text = value.toFixed(2);
375
376
  // A move that rounds to zero carries no sign.
376
377
  if (Number(text) === 0) return "0.00%";
@@ -33,7 +33,7 @@ import type { Quote } from "../../../types/financials";
33
33
  import type { QueryEntry } from "../../../market-data/result-types";
34
34
  import type { PaneProps } from "../../../types/plugin";
35
35
  import { publicTickerKey } from "../../../utils/exchanges";
36
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
36
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
37
37
  import { SERIES_COLORS } from "../../../theme/series-colors";
38
38
  import { usePluginPaneState, usePluginTickerActions } from "../../runtime";
39
39
  import { useCommandTab } from "../shared/command-tab";
@@ -133,11 +133,11 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
133
133
  content: <PriceSparkline priceHistory={row.history} width={column.width} period="1M" />,
134
134
  };
135
135
  case "volume24h":
136
- return { text: row.volume24h == null ? "—" : formatCompact(row.volume24h, { fixedDecimals: true }), color: colors.textDim };
136
+ return { text: row.volume24h == null ? MISSING_VALUE : formatCompact(row.volume24h, { fixedDecimals: true }), color: colors.textDim };
137
137
  case "marketCap":
138
- return { text: row.marketCap == null ? "—" : formatCompact(row.marketCap, { fixedDecimals: true }), color: colors.textDim };
138
+ return { text: row.marketCap == null ? MISSING_VALUE : formatCompact(row.marketCap, { fixedDecimals: true }), color: colors.textDim };
139
139
  case "pegText":
140
- return { text: row.pegText || "—", color: row.peg?.accrues || (row.peg && row.peg.currency !== "USD") ? colors.text : colors.textDim };
140
+ return { text: row.pegText || MISSING_VALUE, color: row.peg?.accrues || (row.peg && row.peg.currency !== "USD") ? colors.text : colors.textDim };
141
141
  case "offPegBp": {
142
142
  const severity = offPegSeverity(row.offPegBp);
143
143
  return {
@@ -156,7 +156,7 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
156
156
  case "high24hAt":
157
157
  return { text: formatDayRangeTime(row.high24hAt), value: row.high24hAt == null ? null : new Date(row.high24hAt), color: colors.textDim };
158
158
  case "supply":
159
- return { text: row.supply == null ? "—" : formatCompact(row.supply, { fixedDecimals: true }) };
159
+ return { text: row.supply == null ? MISSING_VALUE : formatCompact(row.supply, { fixedDecimals: true }) };
160
160
  case "supply7dPercent":
161
161
  return signed(row.supply7dPercent);
162
162
  case "supply30dPercent":
@@ -166,13 +166,13 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
166
166
  case "supply30d":
167
167
  return signedAmount(row.supply30d);
168
168
  case "supplyShare":
169
- return { text: row.supplyShare == null ? "—" : `${row.supplyShare.toFixed(2)}%`, color: colors.textDim };
169
+ return { text: row.supplyShare == null ? MISSING_VALUE : `${row.supplyShare.toFixed(2)}%`, color: colors.textDim };
170
170
  }
171
171
  }
172
172
 
173
173
  function signedAmount(value: number | null): DataTableCell {
174
174
  return {
175
- text: value == null ? "—" : formatCompactAmount(value, { signed: true }),
175
+ text: value == null ? MISSING_VALUE : formatCompactAmount(value, { signed: true }),
176
176
  color: value == null ? colors.textDim : priceColor(value),
177
177
  };
178
178
  }
@@ -184,7 +184,7 @@ function supplyChangeFigure(id: string, label: string, amount: number | null, pe
184
184
  return {
185
185
  id,
186
186
  label,
187
- value: amount == null ? "—" : formatCompactAmount(amount, { signed: true }),
187
+ value: amount == null ? MISSING_VALUE : formatCompactAmount(amount, { signed: true }),
188
188
  detail: formatCryptoPercent(percent),
189
189
  ...(amount == null ? {} : { color: priceColor(amount) }),
190
190
  };
@@ -1,5 +1,5 @@
1
1
  import type { StablecoinSupplyCoin, StablecoinSupplyPayload } from "../../../api-client/crypto-markets";
2
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
2
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
3
3
  import { formatCryptoPercent, utcCloseAsOfText, type CryptoRowSupply } from "./model";
4
4
 
5
5
  /**
@@ -128,7 +128,7 @@ export function supplySummaryLine(payload: StablecoinSupplyPayload): string | nu
128
128
  const total = payload.total;
129
129
  if (!total) return null;
130
130
  const change = (amount: number | null, percent: number | null) => (
131
- amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`
131
+ amount == null ? MISSING_VALUE : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`
132
132
  );
133
133
  const since = supplyHistoryStart(payload);
134
134
  return [
@@ -1,7 +1,7 @@
1
1
  import type { CryptoEtfFlowAsset, CryptoEtfFlowDay, CryptoEtfFlowsPayload } from "../../../api-client/crypto-etf-flows";
2
2
  import type { DataTableColumn } from "../../../components";
3
3
  import { calendarMonthsBefore } from "../../../utils/calendar-date";
4
- import { formatCompactAmount, formatNumber } from "../../../utils/format";
4
+ import { MISSING_VALUE, formatCompactAmount, formatNumber } from "../../../utils/format";
5
5
 
6
6
  export const CRYPTO_ETF_FLOWS_PANE_ID = "crypto-etf-flows";
7
7
 
@@ -45,14 +45,14 @@ export const cryptoEtfFlowAssetLabel = (asset: CryptoEtfFlowAsset) => asset ===
45
45
 
46
46
  /** A day's flow in US$ millions as the table shows it: `+665.2`, `-83.6`, `0.0`, `—` for none. */
47
47
  export function formatFlow(value: number | null | undefined): string {
48
- if (value == null || !Number.isFinite(value)) return "—";
48
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
49
49
  const text = formatNumber(Math.abs(value), 1);
50
50
  return value > 0 && text !== "0.0" ? `+${text}` : value < 0 && text !== "0.0" ? `-${text}` : text;
51
51
  }
52
52
 
53
53
  /** A sum of flows in US$ millions as a figure reads it: `+$526.7M`, `-$1.13B`, `$0`. */
54
54
  export function formatFlowAmount(millions: number | null | undefined): string {
55
- if (millions == null || !Number.isFinite(millions)) return "—";
55
+ if (millions == null || !Number.isFinite(millions)) return MISSING_VALUE;
56
56
  const text = formatCompactAmount(millions * 1_000_000, { signed: true });
57
57
  return text.replace(/^([+-]?)/, "$1$");
58
58
  }
@@ -119,7 +119,7 @@ export const hasFundPriceChanges = (payload: CryptoEtfFlowsPayload | null | unde
119
119
 
120
120
  /** A day's price move as the table shows it: `+2.15%`, `-0.40%`, `—` for none. */
121
121
  export function formatPriceChange(value: number | null | undefined): string {
122
- if (value == null || !Number.isFinite(value)) return "—";
122
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
123
123
  return `${value > 0 ? "+" : ""}${value.toFixed(2)}%`;
124
124
  }
125
125
 
@@ -1,6 +1,6 @@
1
1
  import type { GloomPlugin, PaneTemplateCreateOptions } from "../../../types/plugin";
2
2
  import { CUSTOM_VIEW_PANE_ID, CUSTOM_VIEW_SPEC_SETTING, CustomViewPane } from "./pane";
3
- import { parseViewSpec, serializeViewSpec, type ViewSpec } from "./view-spec";
3
+ import { EXAMPLE_VIEW_SPEC, parseViewSpec, serializeViewSpec, type ViewSpec } from "./view-spec";
4
4
 
5
5
  export { CUSTOM_VIEW_PANE_ID } from "./pane";
6
6
  export { setViewRefResolver, trialLoadViewSource, UnknownViewKeysError } from "./loader";
@@ -39,6 +39,8 @@ export const customViewPlugin: GloomPlugin = {
39
39
  defaultMode: "floating",
40
40
  defaultFloatingSize: { width: 100, height: 28 },
41
41
  tableExport: true,
42
+ // The catalog's example is a spec that runs as typed (`catalog VIEW` showed only `<spec JSON or empty>`).
43
+ reportArgument: { kind: "free-text", placeholder: "spec JSON or empty", optional: true, examples: [`'${EXAMPLE_VIEW_SPEC}'`] },
42
44
  settings: {
43
45
  fields: [{
44
46
  key: CUSTOM_VIEW_SPEC_SETTING,
@@ -39,6 +39,7 @@ import {
39
39
  import { loadViewSource, type LoadedView } from "./loader";
40
40
  import {
41
41
  applyViewProjection,
42
+ EXAMPLE_VIEW_SPEC,
42
43
  formatViewValue,
43
44
  growViewColumnDecimals,
44
45
  parseViewSpecOr,
@@ -91,6 +92,9 @@ function columnsFor(spec: ViewSpec, loaded: LoadedView | null): Column[] {
91
92
  });
92
93
  }
93
94
 
95
+ /** What an empty view says: ask for one, or open one from a spec that works as typed. */
96
+ const EMPTY_VIEW_MESSAGE = `Ask Gloom: "make a view of the top S&P movers", or open one from a spec: VIEW ${EXAMPLE_VIEW_SPEC}`;
97
+
94
98
  export function CustomViewPane({ focused, width, height }: PaneProps) {
95
99
  const instance = usePaneInstance();
96
100
  const config = usePaneAppConfig();
@@ -360,7 +364,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
360
364
  if (!spec) {
361
365
  return specError
362
366
  ? <PaneStatusBody error={specError} errorTitle="This view's spec is invalid." />
363
- : <PaneStatusBody empty emptyTitle="This view is empty." emptyMessage={'Ask Gloom: "make a view of the top S&P movers"'} />;
367
+ : <PaneStatusBody empty emptyTitle="This view is empty." emptyMessage={EMPTY_VIEW_MESSAGE} />;
364
368
  }
365
369
 
366
370
  if (loading && !data) {
@@ -84,6 +84,17 @@ export interface ViewSpecValidationResult {
84
84
  warnings: ViewSpecIssue[];
85
85
  }
86
86
 
87
+ /**
88
+ * A spec that works as typed, signed out too: Europe's indices from WEI's
89
+ * board, their names, last and move. The catalog's example and the empty
90
+ * view's both show it.
91
+ */
92
+ export const EXAMPLE_VIEW_SPEC = JSON.stringify({
93
+ version: VIEW_SPEC_VERSION,
94
+ source: { kind: "inline", pane: "WEI" },
95
+ projection: { columns: ["name", "price", "changePercent"], filters: [{ key: "region", op: "eq", value: "europe" }] },
96
+ });
97
+
87
98
  const TRANSFORMS = new Set<ViewTransform>(["raw", "percent", "compact", "abs", "index100"]);
88
99
  const FILTER_OPS = new Set<ViewFilterOp>(["eq", "neq", "gt", "gte", "lt", "lte", "contains", "in", "exists"]);
89
100
  const KEY_PATTERN = /^[A-Za-z0-9_.\-:]{1,80}$/;
@@ -9,14 +9,14 @@ import type {
9
9
  import type { DataTableColumn } from "../../../components";
10
10
  import { scalarPoint } from "../../../components/chart/static/series";
11
11
  import type { TimeSeriesPoint } from "../../../time-series/types";
12
- import { formatCompact, formatPercentileRank } from "../../../utils/format";
12
+ import { MISSING_VALUE, formatCompact, formatPercentileRank } from "../../../utils/format";
13
13
 
14
14
  export type DebtLatest = NonNullable<DebtMaturitiesPayload["latest"]>;
15
15
  export type DebtBucket = DebtLatest["buckets"][number];
16
16
  export const debtAmount = (value: number | null) =>
17
- value === null ? "--" : formatCompact(value, { fixedDecimals: true });
17
+ value === null ? MISSING_VALUE : formatCompact(value, { fixedDecimals: true });
18
18
  export const debtPercent = (value: number | null) =>
19
- value === null ? "--" : `${value.toFixed(1)}%`;
19
+ value === null ? MISSING_VALUE : `${value.toFixed(1)}%`;
20
20
  export const debtMetricValue = (metric: DebtMetric) =>
21
21
  metric.unit === "%"
22
22
  ? debtPercent(metric.value)
@@ -37,7 +37,7 @@ import { isAccessDenied } from "../../../api-client/errors";
37
37
  import { formatCompactAxis } from "../../../components/chart-table";
38
38
  import { staticSeries } from "../../../components/chart/static/series";
39
39
  import type { PaneProps } from "../../../types/plugin";
40
- import { formatPercentileRank } from "../../../utils/format";
40
+ import { MISSING_VALUE, formatPercentileRank } from "../../../utils/format";
41
41
  import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
42
42
  import { SignInWall } from "../cloud/auth-actions";
43
43
  import {
@@ -369,7 +369,7 @@ function FilingDetail({
369
369
  labelWidth={20}
370
370
  label="Comparable filings"
371
371
  value={String(latest.totalPrincipal.percentile.sampleCount)}
372
- detail={`${latest.totalPrincipal.percentile.historyStart ?? "--"} to ${latest.totalPrincipal.percentile.historyEnd ?? "--"}`}
372
+ detail={`${latest.totalPrincipal.percentile.historyStart ?? MISSING_VALUE} to ${latest.totalPrincipal.percentile.historyEnd ?? MISSING_VALUE}`}
373
373
  />
374
374
  {quarter ? (
375
375
  <>
@@ -333,6 +333,8 @@ export function buildDividendMetrics(
333
333
  growth3Y: growth3Y?.growth ?? null,
334
334
  ...(growth1Y?.shortfall ? { growth1YPayments: growth1Y.shortfall } : {}),
335
335
  ...(growth3Y?.shortfall ? { growth3YPayments: growth3Y.shortfall } : {}),
336
+ ...(growth1Y?.notMeaningful ? { growth1YNotMeaningful: true } : {}),
337
+ ...(growth3Y?.notMeaningful ? { growth3YNotMeaningful: true } : {}),
336
338
  paymentFrequency: options.historyAvailable !== false ? inferFrequency(eligible, now) : null,
337
339
  lastExDividendDate,
338
340
  nextExDividendDate,
@@ -353,9 +355,10 @@ export function repriceDividendMetrics(metrics: DividendMetrics, price: number |
353
355
  * when each holds every payment the cadence pays: a year with a hole in its
354
356
  * history (AZN's missing August interim) measures the hole, not a cut, so it
355
357
  * has no growth and says how many payments it holds. A year with none is a
356
- * suspension, which still reads as a full decline.
358
+ * suspension, which still reads as a full decline. Cash paid after a year of
359
+ * none is growth off zero: not meaningful, never a number.
357
360
  */
358
- function computeGrowth(payments: DividendPayment[], years: number, now: Date): { growth: number | null; shortfall?: GrowthPayments } | null {
361
+ function computeGrowth(payments: DividendPayment[], years: number, now: Date): { growth: number | null; shortfall?: GrowthPayments; notMeaningful?: true } | null {
359
362
  const priorEnd = calendarMonthsBefore(now, 12 * years);
360
363
  const priorStart = calendarMonthsBefore(priorEnd, 12);
361
364
  // A new fund's partial first year is not a full-year growth baseline.
@@ -368,7 +371,8 @@ function computeGrowth(payments: DividendPayment[], years: number, now: Date): {
368
371
  }
369
372
  const recent = trailingCashAt(payments, now);
370
373
  const prior = trailingCashAt(payments, priorEnd);
371
- return { growth: prior > 0 ? Math.pow(recent / prior, 1 / years) - 1 : null };
374
+ if (!(prior > 0)) return recent > 0 ? { growth: null, notMeaningful: true } : { growth: null };
375
+ return { growth: Math.pow(recent / prior, 1 / years) - 1 };
372
376
  }
373
377
 
374
378
  function inferFrequency(payments: DividendPayment[], now: Date): DividendMetrics["paymentFrequency"] {