gloomberb 0.17.0 → 0.17.2

package/src/plugins/builtin/congress-trades/detail.tsx

@@ -1,6 +1,7 @@
 import { aggregateLoadedCongress } from "./aggregates";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Box, ScrollBox, Text, useRendererHost, type ScrollBoxRenderable } from "../../../ui";
+import { Box, ScrollBox, Text, useRendererHost, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
+import { ClippedText } from "../../../components/ui/display";
 import {
   DataTableView,
   KeyValueRow,
@@ -51,6 +52,9 @@ export function TradeDetail({
   width: number;
 }) {
   const lineWidth = Math.max(1, width - 2);
+  // The desktop's rows cut long values where they end, by CSS; the terminal at its columns.
+  const desktop = !!useUiCapabilities().nativePaneChrome;
+  const fit = (value: string) => desktop ? value : truncateWithEllipsis(value, Math.max(10, lineWidth - 16));
   return (
     <ScrollBox scrollY focusable={false} flexGrow={1} paddingX={1}>
       <Box flexDirection="column" width={lineWidth}>
@@ -58,7 +62,7 @@ export function TradeDetail({
         <KeyValueRow {...DETAIL_ROW} label="chamber" value={`${trade.chamber === "senate" ? "Senate" : "House"}${trade.stateDistrict ? ` · ${trade.stateDistrict}` : ""}`} tone="muted" />
         <KeyValueRow {...DETAIL_ROW} label="party" value={trade.party ?? "--"} />
         <KeyValueRow {...DETAIL_ROW} label="side" value={trade.transactionType} tone={trade.side === "BUY" ? "positive" : trade.side === "SELL" ? "negative" : trade.side === "OTHER" ? "muted" : undefined} />
-        <KeyValueRow {...DETAIL_ROW} label="asset" value={truncateWithEllipsis(trade.assetName, Math.max(10, lineWidth - 16))} />
+        <KeyValueRow {...DETAIL_ROW} label="asset" value={fit(trade.assetName)} />
         <KeyValueRow {...DETAIL_ROW} label="amount" value={trade.amount} color={colors.textBright} />
         <KeyValueRow {...DETAIL_ROW} label="owner" value={trade.owner} />
         <KeyValueRow {...DETAIL_ROW} label="tx return" value={formatCongressReturn(trade.returnSinceTx)} />
@@ -69,12 +73,12 @@ export function TradeDetail({
         <KeyValueRow {...DETAIL_ROW} label="filed" value={trade.filingDate} />
         <KeyValueRow {...DETAIL_ROW} label="lag" value={`${formatLag(trade.lagDays)}${(trade.lagDays ?? 0) > 45 ? " (past 45 days)" : ""}`} tone={(trade.lagDays ?? 0) > 45 ? "warning" : undefined} />
         {trade.filingStatus ? <KeyValueRow {...DETAIL_ROW} label="status" value={trade.filingStatus} /> : null}
-        {trade.subholdingOf ? <KeyValueRow {...DETAIL_ROW} label="subholding" value={truncateWithEllipsis(trade.subholdingOf, Math.max(10, lineWidth - 16))} /> : null}
+        {trade.subholdingOf ? <KeyValueRow {...DETAIL_ROW} label="subholding" value={fit(trade.subholdingOf)} /> : null}
         {trade.description ? (
           <>
             <Text>{" "}</Text>
             <Text fg={colors.textDim}>description</Text>
-            <Text fg={colors.text}>{truncateWithEllipsis(trade.description, lineWidth)}</Text>
+            <ClippedText fg={colors.text} text={trade.description} width={lineWidth} cut={truncateWithEllipsis} wrap />
           </>
         ) : null}
       </Box>

package/src/plugins/builtin/connections/pane.tsx

@@ -9,7 +9,8 @@ import type {
 } from "../../../core/connection-health";
 import { colors } from "../../../theme/colors";
 import type { PaneProps } from "../../../types/plugin";
-import { Box, ScrollBox, Text } from "../../../ui";
+import { Box, ScrollBox, Text, useUiCapabilities } from "../../../ui";
+import { ClippedText } from "../../../components/ui/display";
 import { truncateToDisplayWidth } from "../../../utils/format";
 import { formatRelativeAge } from "../../../utils/datetime-format";
 import { nextHeaderSort } from "../../../utils/sort-values";
@@ -29,6 +30,15 @@ const STATUS_ORDER: Record<ConnectionHealthStatus, number> = {
   idle: 4,
 };
 
+function connectionKindLabel(kind: string): string {
+  if (kind === "asset-data") return "Market data";
+  if (kind === "news") return "News";
+  if (kind === "api") return "Request";
+  if (kind === "websocket") return "Live feed";
+  if (kind === "capability") return "Plugin";
+  return "Connection";
+}
+
 function statusLabel(status: ConnectionHealthStatus): string {
   if (status === "connected") return "Connected";
   if (status === "connecting") return "Connecting";
@@ -64,12 +74,13 @@ function columnsForWidth(width: number): ConnectionColumn[] {
 
 function ConnectionDetail({ source, width, now }: { source: ConnectionHealthState; width: number; now: number }) {
   const lineWidth = Math.max(24, width - 2);
+  // The desktop's detail row cuts a long value where it ends, by CSS.
+  const desktop = !!useUiCapabilities().nativePaneChrome;
   return (
     <ScrollBox scrollY focusable={false} flexGrow={1} paddingX={1}>
       <Box flexDirection="column" width={lineWidth}>
         <KeyValueRow labelWidth={16} emphasis={false} label="Status" value={statusLabel(source.status)} color={statusColor(source.status)} />
-        <KeyValueRow labelWidth={16} emphasis={false} label="Type" value={source.kind} color={colors.textDim} />
-        {source.ownerId ? <KeyValueRow labelWidth={16} emphasis={false} label="Owner" value={source.ownerId} color={colors.textDim} /> : null}
+        <KeyValueRow labelWidth={16} emphasis={false} label="Type" value={connectionKindLabel(source.kind)} color={colors.textDim} />
         {source.socketState ? <KeyValueRow labelWidth={16} emphasis={false} label="Socket" value={source.socketState} color={statusColor(source.status)} /> : null}
         {source.lastTransitionAt ? (
           <KeyValueRow labelWidth={16} emphasis={false} label="Transition" value={formatRelativeAge(source.lastTransitionAt, now)} color={colors.textMuted} />
@@ -78,7 +89,7 @@ function ConnectionDetail({ source, width, now }: { source: ConnectionHealthStat
         <KeyValueRow labelWidth={16} emphasis={false} label="Operation" value={source.lastOperation ?? "-"} color={colors.textDim} />
         <KeyValueRow labelWidth={16} emphasis={false} label="Latency" value={formatLatency(source.lastLatencyMs)} color={colors.textMuted} />
         {source.currentDetail ? (
-          <KeyValueRow labelWidth={16} emphasis={false} label="Detail" value={truncateToDisplayWidth(source.currentDetail, Math.max(8, lineWidth - 16))} color={source.status === "error" ? colors.negative : colors.textDim} />
+          <KeyValueRow labelWidth={16} emphasis={false} label="Detail" value={desktop ? source.currentDetail : truncateToDisplayWidth(source.currentDetail, Math.max(8, lineWidth - 16))} color={source.status === "error" ? colors.negative : colors.textDim} />
         ) : null}
         {source.lastSuccess ? (
           <KeyValueRow labelWidth={16} emphasis={false}
@@ -103,7 +114,7 @@ function ConnectionDetail({ source, width, now }: { source: ConnectionHealthStat
                 <Box width={7}><Text fg={request.success ? colors.positive : colors.negative}>{request.success ? "ok" : "error"}</Text></Box>
                 <Box width={9}><Text fg={colors.textMuted}>{formatLatency(request.latencyMs)}</Text></Box>
                 <Box width={10}><Text fg={colors.textMuted}>{formatRelativeAge(request.at, now)}</Text></Box>
-                <Text fg={colors.textDim}>{truncateToDisplayWidth(request.error ?? request.operation, Math.max(8, lineWidth - 26))}</Text>
+                <ClippedText fg={colors.textDim} text={request.error ?? request.operation} width={Math.max(8, lineWidth - 26)} />
               </Box>
             ))}
           </>

package/src/plugins/builtin/cpi/pane.tsx

@@ -19,8 +19,8 @@ import { priceColor } from "../../../theme/colors";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { ResolvedSeries } from "../../../time-series/types";
 import type { PaneProps } from "../../../types/plugin";
-import { Box, Text, TextAttributes } from "../../../ui";
-import { truncateToDisplayWidth } from "../../../utils/format";
+import { Box, TextAttributes } from "../../../ui";
+import { ClippedText } from "../../../components/ui/display";
 import { nextHeaderSort } from "../../../utils/sort-values";
 import { CPI_NOT_AVAILABLE, getCachedCpiBoard, loadCpiBoard } from "./client";
 import {
@@ -67,14 +67,15 @@ function CpiChart({ row, series, width, height }: { row: CpiRow; series: Resolve
   const colors = useThemeColors();
   const latest = row.history.at(-1)?.[0] ?? null;
   const axis = useMemo(() => cpiTimeAxis(row.history), [row.history]);
-  const read = row.read ? truncateToDisplayWidth(row.read, Math.max(0, width - 2)) : "";
+  // The plain read under the axis; the desktop cuts it where its line ends.
+  const read = row.read && width > 2 ? row.read : "";
   return (
     <Box width={width} height={height} flexDirection="column">
       <CompositeChart series={series} panels={PANELS} width={width} height={Math.max(3, height - (read ? 1 : 0))}
         focused={false} navigable={false} showLegend showTimeAxis cursorDate={latest ? cpiMonthDate(latest) : null}
         viewport={axis?.viewport} xAxis={axis?.xAxis} clipToViewport={!!axis}
         formatValue={legendValue} formatAxisValue={formatPercentAxis} remoteKind="cpi-component-history" />
-      {read ? <Box height={1} paddingX={1}><Text fg={colors.textMuted}>{read}</Text></Box> : null}
+      {read ? <Box height={1} paddingX={1}><ClippedText fg={colors.textMuted} text={read} width={width - 2} /></Box> : null}
     </Box>
   );
 }

package/src/plugins/builtin/custom-view/pane.tsx

@@ -4,8 +4,8 @@ import { DataTableView } from "../../../components/data-table/view";
 import { ChoiceDialog } from "../../../components/ui/choice-dialog";
 import { useDialog, type PromptContext } from "../../../ui/dialog";
 import { getSharedRegistry } from "../../registry";
-import { teamPrefix } from "../cloud/team/model";
-import { teamStore } from "../cloud/team/store";
+import { teamPrefix } from "../../../team/model";
+import { teamStore } from "../../../team/store";
 import { teamViewsStore } from "../cloud/team/views";
 import { setPaneSettings } from "../../../pane-settings";
 import { customViewInstanceSettings } from "./index";

package/src/plugins/builtin/dividend-yield/headless.ts

@@ -55,6 +55,12 @@ function dateEntry(label: string, date: Date | null) {
   return { label, value: date, formatted: date ? date.toISOString().slice(0, 10) : "—" };
 }
 
+/** The next pay date, when it is the one stated beside the ex-date the forward rate is dated by. */
+function forwardPayDate(metrics: DividendData["metrics"]): Date | null {
+  const exDate = metrics.nextExDividendDate?.toISOString().slice(0, 10);
+  return exDate != null && exDate === metrics.forwardRateAsOf ? metrics.nextPayDate : null;
+}
+
 function matchesType(payment: DividendPayment, type: string): boolean {
   return type === "all" || payment.type === type;
 }
@@ -95,7 +101,7 @@ export function projectDividendYieldHeadless(
             : "Reference price time unavailable; cash yield may be out of date." }] : []),
           { label: "Trailing yield", value: metrics.trailingYield, formatted: formatDividendYield(metrics.trailingYield) },
           { label: "Forward yield", value: metrics.forwardYield, formatted: metrics.forwardYield == null ? formatDividendYield(null)
-            : `${formatDividendYield(metrics.forwardYield)} (${forwardDividendBasis(metrics.forwardRateAsOf)})` },
+            : `${formatDividendYield(metrics.forwardYield)} (${forwardDividendBasis(metrics.forwardRateAsOf, { payDate: forwardPayDate(metrics) })})` },
           { label: "Trailing rate", value: metrics.trailingRate, formatted: currency ? formatDistributionAmount(metrics.trailingRate ?? undefined, currency) : "—" },
           { label: "Forward rate", value: metrics.forwardRate, formatted: currency ? formatDistributionAmount(metrics.forwardRate ?? undefined, currency) : "—" },
           { label: "Earnings Payout", value: metrics.payoutRatio, formatted: formatDividendYield(metrics.payoutRatio) },
@@ -132,7 +138,7 @@ export function projectDividendYieldHeadless(
       limitations: data.notes ?? [],
       yieldMethod: "Cash distributions with ex-dates in the preceding 12 months, one payment per period for a regular cadence, divided by the reference share price; excludes reinvestment and is not SEC yield or total return.",
       forwardRateAsOf: metrics.forwardRateAsOf,
-      forwardRateMethod: "Indicated annual cash rate, the one fundamentals use: the latest regular distribution annualized, dated by its ex-date (forwardRateAsOf). Only when its currency units are comparable with the share price.",
+      forwardRateMethod: "Indicated annual cash rate, the one fundamentals use: the latest regular distribution annualized, or once the next one is declared that one, dated by its ex-date (forwardRateAsOf; a date still ahead is the declared distribution's). Only when its currency units are comparable with the share price.",
       paymentFrequencyMethod: "Cadence inferred from ex-dates in the last two years, unavailable when no cash was reported in the last year; not an announced payment schedule.",
     },
   };

package/src/plugins/builtin/dividend-yield/pane.tsx

@@ -22,6 +22,7 @@ import { colors, priceColor } from "../../../theme/colors";
 import { TextAttributes, useUiCapabilities } from "../../../ui";
 import { displayWidth, formatCurrency, formatDistributionAmount, formatPercentRaw } from "../../../utils/format";
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
+import { forwardDividendNote } from "../../../utils/forward-dividend";
 import { nextHeaderSort } from "../../../utils/sort-values";
 import { handleRefreshKey, loadingErrorFooterInfo } from "../../../components/data-table/table-pane";
 import { SignInWall } from "../cloud/auth-actions";
@@ -76,11 +77,12 @@ function buildMetricItems(metrics: DividendMetrics, currency: string, hasHistory
   const exDate: StatItem[] = metrics.nextExDividendDate
     ? [{ id: "next-ex", label: "Next ex", value: formatDate(metrics.nextExDividendDate) }]
     : hasHistory ? [] : [{ id: "last-ex", label: "Last ex", value: formatDate(metrics.lastExDividendDate) }];
+  const forwardNote = metrics.forwardYield != null ? forwardDividendNote(metrics.forwardRateAsOf) : null;
   return [
     { id: "ttm-yield", label: short ? "TTM yld" : "TTM yield", value: formatDividendYield(metrics.trailingYield), color: priceColor(metrics.trailingYield ?? 0) },
-    // Dated by the distribution it annualizes; docs/research-data.md says how it is built.
+    // Dated by the distribution it annualizes, or marked declared beside the next ex-date; docs/research-data.md says how it is built.
     { id: "forward-yield", label: short ? "Fwd yld" : "Fwd yield", value: formatDividendYield(metrics.forwardYield), color: priceColor(metrics.forwardYield ?? 0),
-      ...(metrics.forwardYield != null && metrics.forwardRateAsOf ? { detail: `as of ${metrics.forwardRateAsOf}` } : {}) },
+      ...(forwardNote ? { detail: forwardNote } : {}) },
     { id: "ttm-rate", label: short ? "TTM/sh" : "TTM/share", value: formatRate(metrics.trailingRate, currency) },
     { id: "forward-rate", label: short ? "Fwd/sh" : "Fwd/share", value: formatRate(metrics.forwardRate, currency) },
     { id: "growth-1y", label: short ? "1Y chg" : "1Y growth", value: formatGrowth(metrics.growth1Y), color: priceColor(metrics.growth1Y ?? 0) },

package/src/plugins/builtin/docs/blocks.tsx

@@ -6,6 +6,7 @@
  */
 import { useState } from "react";
 import { ActionRow, MarkdownText, RemoteImage, usePaneLinkMenuEntry } from "../../../components";
+import { READER_HEADING_STYLE } from "../../../components/reader/reader-text";
 import type { DocsBlock } from "../../../docs/content";
 import { tf } from "../../../i18n";
 import { isDarkTheme } from "../../../theme/themes";
@@ -25,6 +26,9 @@ const CALLOUT_LABELS: Record<string, string> = {
   example: "Example",
 };
 
+/** The reader's section heading size; the space around it is the blocks' own. */
+const SECTION_HEADING_STYLE = { fontSize: READER_HEADING_STYLE.fontSize, lineHeight: READER_HEADING_STYLE.lineHeight } as const;
+
 const LINK_PATTERN = /\[([^\]]+)\]\(([^)\s]+)\)/g;
 
 /** Inline links of a block, for the pane menu: the terminal cannot press a word. */
@@ -122,9 +126,16 @@ function Block({ block, width, onOpenLink }: { block: DocsBlock; width: number;
     case "paragraph":
       return <MarkdownText text={block.text.replace(/\n/g, " ")} lineWidth={width} onOpenLink={onOpenLink} />;
     case "heading":
-      // A section reads bright; a step inside it, in the text colour.
+      // A section reads bright and, on the desktop and the web, a step larger, as in every reader; a step inside it, in the text colour.
       return (
-        <Text fg={block.level === 2 ? colors.textBright : colors.text} attributes={TextAttributes.BOLD} wrapText selectable width={nativePaneChrome ? "100%" : width}>
+        <Text
+          fg={block.level === 2 ? colors.textBright : colors.text}
+          attributes={TextAttributes.BOLD}
+          wrapText
+          selectable
+          width={nativePaneChrome ? "100%" : width}
+          style={nativePaneChrome && block.level === 2 ? SECTION_HEADING_STYLE : undefined}
+        >
           {block.text.replace(/[*`]/g, "")}
         </Text>
       );

package/src/plugins/builtin/docs/pane.tsx

@@ -54,6 +54,7 @@ import type { PaneProps } from "../../../types/plugin";
 import { Box, Text, TextAttributes, useRendererHost, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
 import { usePluginAppActions, usePluginPaneState } from "../../runtime";
 import { badgeCell } from "../help/table-cells";
+import { READER_COLUMN_FONT } from "../../../components/reader/reader-text";
 import { DocsBlocks } from "./blocks";
 import { useDocsFeed, useDocsLesson } from "./use-docs";
 
@@ -73,12 +74,12 @@ const STACK_LIMIT = 30;
 /** Prose reads best at about seventy columns, however wide the pane. */
 const MEASURE = 72;
 /**
- * On the desktop and the web the text reads a size up from the table text,
- * with more air between lines, at most 69 characters of it to the line (as
- * wide as a screenshot of the measure): the column fills a narrower pane and
- * stops there in a wider one.
+ * On the desktop and the web the text reads at the reader's body size, a step
+ * up from the table text, with more air between lines, at most 69 characters
+ * of it to the line (as wide as a screenshot of the measure): the column fills
+ * a narrower pane and stops there in a wider one.
  */
-const READING_STYLE = { fontSize: "1.1667em", "--cell-h": "1.7em", maxWidth: "69ch" } as const;
+const READING_STYLE = { fontSize: READER_COLUMN_FONT, "--cell-h": "1.7em", maxWidth: "69ch" } as const;
 /** The terminal wraps at `width` columns; the desktop and the web at the reading column's own width. */
 function useTextWidth(width: number): number | "100%" {
   return useUiCapabilities().nativePaneChrome ? "100%" : width;

package/src/plugins/builtin/doe/index.tsx

@@ -1,8 +1,9 @@
 import type { DoeTab } from "../../../api-client/doe";
 import type { PaneTemplateCreateOptions, PaneTemplateInstanceConfig } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
-import { DOE_SERIES } from "./series";
+import { DOE_CATALOG_SERIES } from "./series";
 import { doeBoardCache } from "./client";
+import { doePriceCache } from "./prices";
 import { doeHeadless } from "./headless";
 import { DOE_SERIES_OPTIONS, doeSeriesOption } from "./model";
 import { DoePane } from "./pane";
@@ -21,7 +22,7 @@ const shortcut = (prefix: string, tab: DoeTab | null) => ({
 });
 
 export const doeModule: PluginModule = {
-  series: DOE_SERIES,
+  series: DOE_CATALOG_SERIES,
   panes: [{ id: "doe", name: "Oil and Gas Inventories", icon: "D", component: DoePane,
     defaultPosition: "right", defaultMode: "floating", defaultFloatingSize: { width: 96, height: 34 },
     tableExport: true, headless: doeHeadless("all") }],
@@ -38,6 +39,12 @@ export const doeModule: PluginModule = {
     shortcut: shortcut("NGS", "gas"), headless: doeHeadless("gas"),
     createInstance: (_context, options) => doeInstance("gas", options),
   }],
-  setup(ctx) { doeBoardCache.attach(ctx.persistence); },
-  dispose() { doeBoardCache.reset(); },
+  setup(ctx) {
+    doeBoardCache.attach(ctx.persistence);
+    doePriceCache.attach(ctx.persistence);
+  },
+  dispose() {
+    doeBoardCache.reset();
+    doePriceCache.reset();
+  },
 };

package/src/plugins/builtin/doe/pane.tsx

@@ -18,8 +18,8 @@ import { usePaneInstance } from "../../../state/app/context";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { ResolvedSeries } from "../../../time-series/types";
 import type { PaneProps } from "../../../types/plugin";
-import { Box, Text } from "../../../ui";
-import { truncateToDisplayWidth } from "../../../utils/format";
+import { Box } from "../../../ui";
+import { ClippedText } from "../../../components/ui/display";
 import { DOE_NOT_AVAILABLE, getCachedDoeBoard, loadDoeBoard } from "./client";
 import {
   DOE_TABS,
@@ -71,14 +71,15 @@ function SeasonalChart({ row, series, width, height }: { row: DoeSeriesRow; seri
   const latestWeek = row.seasonal?.current.at(-1)?.[0] ?? null;
   const viewport = useMemo(() => ({ start: doeWeekDate(1), end: doeWeekDate(weeks) }), [weeks]);
   const xAxis = useMemo(() => ({ ticks: doeWeekTicks(weeks), formatCursor: (ratio: number) => `W${Math.round(ratio * (weeks - 1)) + 1}` }), [weeks]);
-  const read = row.read ? truncateToDisplayWidth(row.read, Math.max(0, width - 2)) : "";
+  // The plain read under the axis; the desktop cuts it where its line ends.
+  const read = row.read && width > 2 ? row.read : "";
   return (
     <Box width={width} height={height} flexDirection="column">
       <CompositeChart series={series} panels={PANELS} width={width} height={Math.max(3, height - (read ? 1 : 0))}
         focused={false} navigable={false} showLegend showTimeAxis viewport={viewport} clipToViewport xAxis={xAxis}
         cursorDate={latestWeek ? doeWeekDate(latestWeek) : null} formatValue={legendValue(row)} formatAxisValue={doeAxisFormatter(row.unit)}
         remoteKind="doe-seasonal" />
-      {read ? <Box height={1} paddingX={1}><Text fg={colors.textMuted}>{read}</Text></Box> : null}
+      {read ? <Box height={1} paddingX={1}><ClippedText fg={colors.textMuted} text={read} width={width - 2} /></Box> : null}
     </Box>
   );
 }

package/src/plugins/builtin/doe/prices.ts

@@ -0,0 +1,84 @@
+import { apiClient } from "../../../api-client";
+import type { DoePricesPayload } from "../../../api-client/doe";
+import { createPluginCache } from "../../../data/plugin-cache";
+import type { SeriesDefinition } from "../../../series/types";
+import { cachedSeriesWarning } from "../shared/series-warning";
+import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
+
+/**
+ * EIA weekly retail prices the petroleum board does not carry, served by Gloom
+ * Cloud from the EIA's history workbooks. `key` is the EIA series id a report
+ * of the series cites.
+ */
+const PRICE_SERIES = [
+  {
+    id: "gasoline-price",
+    name: "US regular gasoline retail price",
+    key: "EMM_EPMR_PTE_NUS_DPG",
+    url: "https://www.eia.gov/dnav/pet/hist/LeafHandler.ashx?n=PET&s=EMM_EPMR_PTE_NUS_DPG&f=W",
+    tags: ["gasoline", "retail", "pump price"],
+  },
+  {
+    id: "diesel-price",
+    name: "US No. 2 diesel retail price",
+    key: "EMD_EPD2D_PTE_NUS_DPG",
+    url: "https://www.eia.gov/dnav/pet/hist/LeafHandler.ashx?n=PET&s=EMD_EPD2D_PTE_NUS_DPG&f=W",
+    tags: ["diesel", "retail", "pump price"],
+  },
+] as const;
+
+export const doePriceCache = createPluginCache<DoePricesPayload>({
+  kind: "doe-retail-prices", source: "gloom-cloud", schemaVersion: 1,
+  // Weekly data: a quarter hour is soon enough to catch a Monday release.
+  policy: { staleMs: 15 * 60_000, expireMs: 14 * 24 * 60 * 60_000 },
+});
+
+const isDate = (value: unknown) => typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)
+  && new Date(`${value}T00:00:00Z`).toISOString().slice(0, 10) === value;
+
+/** A payload that breaks the contract is refused whole rather than charted with holes in it. */
+function validatePrices(payload: DoePricesPayload): DoePricesPayload {
+  if (!payload || payload.source !== "EIA" || !Number.isFinite(Date.parse(payload.generatedAt))
+    || !["available", "partial", "unavailable"].includes(payload.status)
+    || !Array.isArray(payload.gaps) || !payload.gaps.every((gap) => typeof gap === "string")
+    || !Array.isArray(payload.series) || !payload.series.every((series) => typeof series?.id === "string"
+      && typeof series.key === "string" && series.unit === "usd-per-gallon" && Array.isArray(series.points)
+      && series.points.every((point) => Array.isArray(point) && isDate(point[0])
+        && typeof point[1] === "number" && Number.isFinite(point[1])))) {
+    throw new Error("The server returned invalid EIA retail prices");
+  }
+  return payload;
+}
+
+/** A server without the route (404), or without its tables yet (503), has no prices to give. */
+async function fetchDoePrices(): Promise<DoePricesPayload> {
+  try {
+    return validatePrices(await apiClient.getCloudDoePrices());
+  } catch (error) {
+    throw unavailableOnServer(error, "EIA retail prices are not available yet.", [404, 503]);
+  }
+}
+
+export const DOE_PRICE_SERIES: readonly SeriesDefinition[] = PRICE_SERIES.map((series) => ({
+  id: `doe:${series.id}`,
+  name: series.name,
+  unit: "USD/gallon",
+  frequency: "weekly",
+  group: "Energy",
+  publisher: "EIA",
+  url: series.url,
+  tags: ["oil", "petroleum", "EIA", "weekly", ...series.tags],
+  description: "EIA weekly US retail price. Not gasoline stocks, and not the AAA daily average.",
+  load: async () => {
+    const resource = await loadCloudResource(doePriceCache, "prices", () => fetchDoePrices(), { validate: validatePrices });
+    const row = resource.payload.series.find((entry) => entry.id === series.id);
+    if (!row?.points.length) throw new Error(`${series.name} is not available yet.`);
+    const warning = cachedSeriesWarning(resource);
+    return {
+      points: row.points.map(([date, value]) => ({ date, value })),
+      ...(warning ? { warning } : {}),
+      // Cited as the EIA series it is, not as the route that served it.
+      attribution: { source: `EIA series ${series.key}`, publisher: "EIA" },
+    };
+  },
+}));

package/src/plugins/builtin/doe/series.ts

@@ -3,6 +3,7 @@ import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
 import { cachedSeriesWarning } from "../shared/series-warning";
 import { loadDoeBoard } from "./client";
 import { DOE_SERIES_OPTIONS } from "./model";
+import { DOE_PRICE_SERIES } from "./prices";
 
 /** Stocks in million barrels, as the pane shows them; flows, rates and gas as published. */
 const UNITS: Record<DoeUnit, { unit: string; scale: number }> = {
@@ -40,7 +41,7 @@ function doeRowPoints(row: DoeSeriesRow): SeriesPoint[] {
   return [...dated(seasonal.year - 1, seasonal.previous), ...dated(seasonal.year, seasonal.current)];
 }
 
-export const DOE_SERIES: readonly SeriesDefinition[] = DOE_SERIES_OPTIONS.map((option): SeriesDefinition => {
+const DOE_SERIES: readonly SeriesDefinition[] = DOE_SERIES_OPTIONS.map((option): SeriesDefinition => {
   const unit = ROW_UNITS[option.value] ?? (option.tab === "gas" ? "bcf" : "kb");
   const gas = option.tab === "gas";
   return {
@@ -60,3 +61,5 @@ export const DOE_SERIES: readonly SeriesDefinition[] = DOE_SERIES_OPTIONS.map((o
     },
   };
 });
+
+export const DOE_CATALOG_SERIES = [...DOE_SERIES, ...DOE_PRICE_SERIES];

package/src/plugins/builtin/earnings/board-model.ts

@@ -1,7 +1,9 @@
 import type { EarningsCalendarReport, EarningsTiming } from "../../../api-client/earnings";
 import { getPublishedUsEquityCalendarDay } from "../../../market-data/published-us-sessions";
 import type { EarningsEvent } from "../../../types/data-provider";
+import type { EarningsDateStatus, EarningsEpsBasis } from "../../../types/financials";
 import type { TickerRecord } from "../../../types/ticker";
+import { dateStatusFromEstimateFlag, earningsDateStatus, earningsEpsBasis } from "../shared/earnings-report";
 import { coherentEarningsValue } from "./estimate-basis";
 import { shortDate, weekday } from "./format";
 
@@ -16,9 +18,15 @@ export interface BoardReport {
   timing: EarningsTiming | null;
   /** Timing taken from the company's last reports, not announced yet. */
   expectedTiming: boolean;
+  /** Whether the date is out, announced or projected; null when the source does not say. */
+  dateStatus: EarningsDateStatus | null;
   marketCap: number | null;
   epsEstimate: number | null;
+  /** Analysts behind `epsEstimate`. */
+  epsAnalysts: number | null;
   epsActual: number | null;
+  /** Null when the reported figure's basis cannot be determined. */
+  epsBasis: EarningsEpsBasis | null;
   revenueEstimate: number | null;
   impliedMove: number | null;
   averageMove: number | null;
@@ -120,9 +128,12 @@ export function boardReport(report: EarningsCalendarReport, owned: ReadonlyMap<s
     date: report.date,
     timing: report.timing,
     expectedTiming: report.timingSource === "history",
+    dateStatus: earningsDateStatus(report.dateStatus),
     marketCap: report.marketCap,
     epsEstimate: report.epsEstimate,
+    epsAnalysts: report.epsAnalysts,
     epsActual: report.epsActual,
+    epsBasis: earningsEpsBasis(report.epsBasis),
     revenueEstimate: report.revenueEstimate,
     impliedMove: report.implied?.move ?? null,
     averageMove: report.averageReports >= MIN_AVERAGE_REPORTS ? report.averageMove : null,
@@ -139,6 +150,7 @@ export function fallbackReport(event: EarningsEvent, owned: ReadonlyMap<string,
     const currency = event.estimateBasis?.[field]?.currency;
     return currency && currency !== "USD" ? null : coherentEarningsValue(event, field);
   };
+  const epsEstimate = dollars("epsEstimate");
   return {
     key: `${event.symbol}:${date}`,
     symbol: event.symbol,
@@ -146,9 +158,14 @@ export function fallbackReport(event: EarningsEvent, owned: ReadonlyMap<string,
     date,
     timing,
     expectedTiming: false,
+    dateStatus: dateStatusFromEstimateFlag(event.isDateEstimate),
     marketCap: null,
-    epsEstimate: dollars("epsEstimate"),
+    epsEstimate,
+    // The count belongs to the estimate beside it.
+    epsAnalysts: epsEstimate == null ? null : coherentEarningsValue(event, "epsAnalysts"),
     epsActual: null,
+    // The estimate's basis goes with it.
+    epsBasis: epsEstimate == null ? null : earningsEpsBasis(event.epsBasis),
     revenueEstimate: dollars("revenueEstimate"),
     impliedMove: null,
     averageMove: null,

package/src/plugins/builtin/earnings/board-table.ts

@@ -2,10 +2,13 @@ import type { DataTableCell, DataTableColumn } from "../../../components";
 import { TABLE_COLUMN_GAP, tableColumnWidth } from "../../../components/ui/table-layout";
 import { colors } from "../../../theme/colors";
 import { TextAttributes } from "../../../ui";
+import { epsBasisShort, showsEpsBasis } from "../shared/earnings-report";
 import type { BoardRow, BoardSort } from "./board-model";
 import { epsText, impliedText, moneyText, moveSize, TIMING_LABEL, weekday } from "./format";
 
-type BoardColumnId = "owned" | "symbol" | "name" | "when" | "cap" | "epsEstimate" | "epsActual" | "revenueEstimate" | "implied" | "average";
+type BoardColumnId =
+  | "owned" | "symbol" | "name" | "when" | "status" | "cap" | "epsEstimate" | "analysts" | "epsActual" | "basis"
+  | "revenueEstimate" | "implied" | "average";
 
 export type BoardColumn = DataTableColumn & { id: BoardColumnId };
 
@@ -16,16 +19,19 @@ const ALL_COLUMNS: BoardColumn[] = [
   { id: "symbol", label: "TICKER", width: 6, align: "left" },
   { id: "name", label: "NAME", width: NAME_MIN_WIDTH, align: "left" },
   { id: "when", label: "WHEN", width: 7, align: "left" },
+  { id: "status", label: "STATUS", width: 9, align: "left" },
   { id: "implied", label: "IMPLIED", width: 7, align: "right" },
   { id: "average", label: "AVG MOVE", width: 8, align: "right" },
   { id: "epsEstimate", label: "EPS EST", width: 7, align: "right" },
+  { id: "analysts", label: "ESTS", width: 4, align: "right" },
   { id: "epsActual", label: "EPS ACT", width: 7, align: "right" },
+  { id: "basis", label: "BASIS", width: 5, align: "left" },
   { id: "revenueEstimate", label: "SALES EST", width: 9, align: "right" },
   { id: "cap", label: "MKT CAP", width: 8, align: "right" },
 ];
 
-/** Dropped first when narrow; the implied move and its average stay beside the name. */
-const DROP_ORDER: BoardColumnId[] = ["epsActual", "cap", "revenueEstimate", "epsEstimate", "owned"];
+/** Dropped first when narrow, the report's labels before its figures; the implied move and its average stay beside the name. */
+const DROP_ORDER: BoardColumnId[] = ["basis", "analysts", "status", "epsActual", "cap", "revenueEstimate", "epsEstimate", "owned"];
 
 /** Header clicks sort these; the rest keep the ranking. */
 export const SORTABLE: Partial<Record<BoardColumnId, BoardSort["column"]>> = {
@@ -66,14 +72,23 @@ export function renderBoardCell(row: BoardRow, column: BoardColumn): DataTableCe
       // An expected time, from the company's last reports, reads quieter than an announced one.
       return { text: row.showDay ? `${weekday(report.date)} ${timing}` : timing, color: report.expectedTiming ? colors.textMuted : dim };
     }
+    case "status":
+      // A projected date reads quieter than an announced one, as an expected time does.
+      return { text: report.dateStatus ?? "--", color: report.dateStatus === "projected" ? colors.textMuted : dim };
     case "cap":
       return { text: moneyText(report.marketCap), color: dim };
     case "epsEstimate":
       return { text: epsText(report.epsEstimate), color: dim };
+    case "analysts":
+      return { text: report.epsAnalysts == null ? "--" : String(report.epsAnalysts), color: dim };
     case "epsActual": {
       const beat = report.epsActual != null && report.epsEstimate != null ? report.epsActual - report.epsEstimate : null;
       return { text: report.epsActual == null ? "" : epsText(report.epsActual), color: beat == null || beat === 0 ? colors.text : beat > 0 ? colors.positive : colors.negative };
     }
+    case "basis":
+      return !showsEpsBasis(report)
+        ? { text: "" }
+        : { text: epsBasisShort(report.epsBasis), color: report.epsBasis ? colors.textMuted : dim };
     case "revenueEstimate":
       return { text: moneyText(report.revenueEstimate), color: dim };
     case "implied":

package/src/plugins/builtin/earnings/headless.ts

@@ -13,7 +13,7 @@ import { fetchEarningsCalendar, fetchEarningsHistory } from "./client";
 import { loadEarningsCalendar } from "./data/cache";
 import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL } from "./format";
 import { historyRows } from "./history-model";
-import { EPS_BASIS_NOTE, epsBasisName } from "../shared/earnings-report";
+import { EPS_BASIS_NOTE, epsBasisName, showsEpsBasis } from "../shared/earnings-report";
 import { isUsListingExchange } from "../../../utils/exchanges";
 import { listingAbroadVenue } from "../../../utils/sec";
 import { findUsListingOfCompany } from "../../../tickers/us-listing";
@@ -24,17 +24,23 @@ const num = (value: unknown) => (typeof value === "number" && Number.isFinite(va
 
 const BOARD_COLUMNS: HeadlessPaneColumn[] = [
   { key: "date", header: "Date" },
+  { key: "dateStatus", header: "Status" },
   { key: "timing", header: "When" },
   { key: "symbol", header: "Ticker" },
   { key: "name", header: "Name" },
   { key: "marketCap", header: "Mkt cap", align: right, format: (value) => moneyText(num(value)) },
   { key: "epsEstimate", header: "EPS est", align: right, format: (value) => epsText(num(value)) },
+  { key: "epsAnalysts", header: "Ests", align: right },
   { key: "epsActual", header: "EPS act", align: right, format: (value) => epsText(num(value)) },
+  { key: "epsBasis", header: "Basis" },
   { key: "revenueEstimate", header: "Sales est", align: right, format: (value) => moneyText(num(value)) },
   { key: "impliedMove", header: "Implied", align: right, format: (value) => impliedText(num(value)) },
   { key: "averageMove", header: "Avg move", align: right, format: (value) => moveSize(num(value)) },
 ];
 
+/** Where the board's caps come from and how old they can be, in its metadata. */
+const MARKET_CAP_NOTE = "Each company's market cap as RV shows it: its latest financials snapshot at the regular session's price (the close outside the session), from the newest quote Gloom Cloud holds for it. A company with no snapshot shows the earnings calendar's figure.";
+
 const HISTORY_COLUMNS: HeadlessPaneColumn[] = [
   { key: "date", header: "Date" },
   { key: "dateStatus", header: "Status" },
@@ -105,13 +111,16 @@ async function boardRows(args: HeadlessPaneLoadArgs, context: HeadlessPaneContex
   const all = [...reports, ...extra].sort((left, right) => left.date.localeCompare(right.date) || (right.marketCap ?? 0) - (left.marketCap ?? 0));
   const rows = all.slice(0, limit).map((report) => ({
     date: report.date,
+    dateStatus: report.dateStatus,
     timing: report.timing ? TIMING_LABEL[report.timing] : null,
     timingExpected: report.expectedTiming,
     symbol: report.symbol,
     name: report.name,
     marketCap: report.marketCap,
     epsEstimate: report.epsEstimate,
+    epsAnalysts: report.epsAnalysts,
     epsActual: report.epsActual,
+    epsBasis: showsEpsBasis(report) ? epsBasisName(report.epsBasis) : null,
     revenueEstimate: report.revenueEstimate,
     impliedMove: report.impliedMove,
     averageMove: report.averageMove,
@@ -127,6 +136,8 @@ async function boardRows(args: HeadlessPaneLoadArgs, context: HeadlessPaneContex
       from: query.from,
       to: query.to,
       averageMoveOver: `last 8 reports, at least ${MIN_AVERAGE_REPORTS}`,
+      epsBasis: EPS_BASIS_NOTE,
+      marketCap: MARKET_CAP_NOTE,
       total: all.length,
       returned: rows.length,
       truncated: rows.length < all.length,
@@ -168,7 +179,7 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
     epsEstimate: row.epsEstimate,
     epsAnalysts: row.epsAnalysts,
     epsActual: row.epsActual,
-    epsBasis: row.epsActual == null ? null : epsBasisName(row.epsBasis),
+    epsBasis: showsEpsBasis(row) ? epsBasisName(row.epsBasis) : null,
     epsSurprise: row.epsSurprise,
     revenueEstimate: row.revenueEstimate,
     revenueActual: row.revenueActual,