gloomberb 0.18.2 → 0.18.4

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

@@ -1,6 +1,7 @@
-import { Box } from "../../../ui";
+import { Box, useUiCapabilities } from "../../../ui";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { TextAttributes, type ScrollBoxRenderable } from "../../../ui";
+import { COUNTRY_FLAG_CELLS, withCountryFlag } from "../../../components/ui/country-flag";
 import {
   Button,
   DataTableStackView,
@@ -12,18 +13,25 @@ import {
   type PaneFooterSegment,
 } from "../../../components";
 import { usePluginPaneState } from "../../runtime";
+import { useAppConfig, usePaneSettingValue } from "../../../public/react";
+import { readerTimeZone, timeZoneCity, zonedClock } from "../../../utils/utc-time";
+import { usePaneInstance } from "../../../state/app/context";
+import { commandRequestParams } from "../shared/command-tab";
 import { useAsyncResource } from "../../../react/async-resource";
 import { useAutoRefresh } from "../../../react/auto-refresh";
 import { usePaneVisible } from "../../../state/app/activity";
+import { formatCountdown } from "../../../utils/datetime-format";
 import type { PaneProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
 import { colors, blendHex } from "../../../theme/colors";
-import type { EconEvent } from "./types";
+import { hasNoReleaseTime, hasNoStatedTime, isAllDayEvent, type EconEvent } from "./types";
 import { FRED_CATALOG_SERIES } from "./fred-catalog";
 import { ECON_PRINT_NOTIFICATIONS_ENABLED_KEY, retainVisiblePrintRefresh, setupHighImpactPrintNotifications } from "./print-watch";
 import { EconDetailView } from "./detail-view";
 import {
   COUNTRY_CYCLE,
+  COUNTRY_FILTER_HINT,
+  countriesWithoutEvents,
   DEFAULT_IMPACT_FILTER,
   FILTER_CYCLE,
   attachEconCalendarPersistence,
@@ -33,18 +41,21 @@ import {
   dateKey,
   dayLabel,
   filteredEmptyTitle,
-  formatCountdown,
   formatStaleness,
   getCalendarCache,
   subscribeCalendar,
   impactIndicator,
   loadCalendar,
+  eventCountry,
   matchesCountry,
   matchesImpact,
+  noScheduledReleasesMessage,
+  parseCountryFilter,
   resetEconCalendarPersistence,
   shortCalendarEnd,
   shortDayLabel,
   timeLabel,
+  valueColumnWidth,
   type CountryFilter,
   type DisplayRow,
   type EconCalendarColumn,
@@ -93,7 +104,21 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
   // reload or a shared layout comes back to the same release.
   const [selectedKey, setSelectedKey] = usePluginPaneState<string | null>("selectedKey", null);
   const [impactFilter, setImpactFilter] = usePluginPaneState<ImpactFilter>("impactFilter", DEFAULT_IMPACT_FILTER);
-  const [countryFilter, setCountryFilter] = usePluginPaneState<CountryFilter>("countryFilter", "all");
+  const [chosenCountry, setCountryFilter] = usePluginPaneState<CountryFilter>("countryFilter", "all");
+  // Countries a caller named (`ECO MX,BR`, `fn ECO --country MX`) are shown once per request; a later choice is the reader's.
+  const pane = usePaneInstance();
+  const [countrySetting] = usePaneSettingValue<string>("country", "");
+  const requestedCountry = pane?.params?.country || countrySetting || null;
+  const countryRequest = pane?.params?.country ? `${pane.params.country}|${pane.params.tabAt ?? ""}`
+    : countrySetting ? `setting|${countrySetting}` : "";
+  const [shownCountryRequest, setShownCountryRequest] = usePluginPaneState("countryRequest", "");
+  const countryPending = !!countryRequest && countryRequest !== shownCountryRequest;
+  const countryFilter: CountryFilter = countryPending && requestedCountry ? requestedCountry : chosenCountry;
+  useEffect(() => {
+    if (!countryPending || !requestedCountry) return;
+    setShownCountryRequest(countryRequest);
+    setCountryFilter(requestedCountry);
+  }, [countryPending, countryRequest, requestedCountry, setCountryFilter, setShownCountryRequest]);
   const [now, setNow] = useState(Date.now());
   const [openKey, setOpenKey] = usePluginPaneState<string | null>("openKey", null);
 
@@ -221,35 +246,47 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     handleRefreshKey(event, () => void calendar.reload(), { stopPropagation: true })
   ), [calendar.reload]);
 
+  // The desktop and the web lead each country's code with its flag.
+  const flagged = useUiCapabilities().nativePaneChrome === true;
+  // A reader who set a time zone (`config set timezone`) gets their clock in a column beside UTC.
+  const readerZone = readerTimeZone(useAppConfig().timezone);
   const columns = useMemo<EconCalendarColumn[]>(() => {
     // The header names the zone, so the column is as wide as the header needs.
     const timeLabelText = `TIME (${CALENDAR_TIME_ZONE_LABEL})`;
     const timeWidth = tableColumnWidth({ width: 6, label: timeLabelText });
-    const actualWidth = 9;
-    const forecastWidth = 10;
-    const priorWidth = 9;
+    const actualWidth = valueColumnWidth(filtered, "actual", 9);
+    const forecastWidth = valueColumnWidth(filtered, "forecast", 10);
+    const priorWidth = valueColumnWidth(filtered, "prior", 9);
     const minEventWidth = 12;
+    // The reader's clock, with the weekday on rows where it is another day than the UTC one they are listed under.
+    const readerLabel = readerZone ? timeZoneCity(readerZone).toUpperCase() : null;
+    const readerWidth = !readerZone || !readerLabel ? 0 : tableColumnWidth({ label: readerLabel,
+      width: filtered.some((ev) => !hasNoReleaseTime(ev) && zonedClock(ev.date.getTime(), readerZone).label.length > 5) ? 9 : 5 });
     // Padding, one gap per column boundary, and the vertical scrollbar lane;
     // one column short of that clipped the PRIOR values at the right edge.
-    const columnCount = 7;
-    const eventRoom = (impactWidth: number, countryWidth: number) => (
-      width - 3 - columnCount - (timeWidth + impactWidth + countryWidth + actualWidth + forecastWidth + priorWidth)
+    const roomBeside = (count: number, timesWidth: number) => (impactWidth: number, countryWidth: number) => (
+      width - 3 - count - (timesWidth + impactWidth + countryWidth + actualWidth + forecastWidth + priorWidth)
     );
+    const codeWidth = 2 + (flagged ? COUNTRY_FLAG_CELLS : 0);
+    // The reader's column only where the event names keep room to read beside it, under the short headers.
+    const withReader = readerWidth > 0 && roomBeside(8, timeWidth + readerWidth)(4, Math.max(3, codeWidth)) >= minEventWidth;
+    const eventRoom = withReader ? roomBeside(8, timeWidth + readerWidth) : roomBeside(7, timeWidth);
     // IMPACT and COUNTRY in words while event names keep room to read; the
     // short labels otherwise, with the word on hover where there is one.
     const spelledImpactWidth = tableColumnWidth({ width: 1, label: SPELLED_IMPACT });
-    const spelledCountryWidth = tableColumnWidth({ width: 1, label: SPELLED_COUNTRY });
+    const spelledCountryWidth = Math.max(codeWidth, tableColumnWidth({ width: 1, label: SPELLED_COUNTRY }));
     const spelled = eventRoom(spelledImpactWidth, spelledCountryWidth) >= SPELLED_HEADER_MIN_EVENT_WIDTH;
     const impactColumn = spelled
       ? { label: SPELLED_IMPACT, width: spelledImpactWidth }
       : { label: "IMP", width: 4, title: "Impact" };
     const countryColumn = spelled
       ? { label: SPELLED_COUNTRY, width: spelledCountryWidth }
-      : { label: "CTY", width: 3, title: "Country" };
+      : { label: "CTY", width: Math.max(3, codeWidth), title: "Country" };
     const eventWidth = Math.max(minEventWidth, eventRoom(impactColumn.width, countryColumn.width));
 
     return [
       { id: "time", label: timeLabelText, width: timeWidth, align: "left" },
+      ...withReader ? [{ id: "readerTime" as const, label: readerLabel!, width: readerWidth, align: "left" as const, title: readerZone! }] : [],
       { id: "impact", ...impactColumn, align: "left" },
       { id: "country", ...countryColumn, align: "left" },
       { id: "event", label: "EVENT", width: eventWidth, align: "left" },
@@ -257,11 +294,15 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
       { id: "forecast", label: "FORECAST", width: forecastWidth, align: "right" },
       { id: "prior", label: "PRIOR", width: priorWidth, align: "right" },
     ];
-  }, [width]);
+  }, [filtered, flagged, readerZone, width]);
   const separatorBg = blendHex(colors.bg, colors.border, 0.3);
   const staleness = fetchedAt ? formatStaleness(fetchedAt, now) : "";
   // The calendar has events and the filters hid them all: say which, with the way back.
-  const filterEmptyTitle = events.length > 0 ? filteredEmptyTitle(impactFilter, countryFilter) : null;
+  // Countries named one by one with nothing in the calendar: a quiet window there, said plainly.
+  const unscheduled = useMemo(() => countriesWithoutEvents(countryFilter, events), [countryFilter, events]);
+  const filterEmptyTitle = events.length === 0 ? null
+    : unscheduled.length > 0 && unscheduled.length === countryFilter.split(",").length ? noScheduledReleasesMessage(unscheduled).replace(/\.$/, "")
+    : filteredEmptyTitle(impactFilter, countryFilter);
   const emptyStateHint = !loading && !error
     ? [
         impactFilter !== "all" ? `impact: ${impactFilter}` : null,
@@ -271,7 +312,10 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
 
   // Next upcoming event for countdown
   const nextEvent = nextUpcomingEventIdx >= 0 ? filtered[nextUpcomingEventIdx] : undefined;
-  const nextCountdown = nextEvent ? formatCountdown(nextEvent.date.getTime() - now) : null;
+  // A bank that states no time, or an all-day event, has a day to count to, not an hour.
+  const nextCountdown = !nextEvent ? null
+    : hasNoReleaseTime(nextEvent) ? shortDayLabel(nextEvent.date)
+    : formatCountdown(nextEvent.date.getTime() - now);
   // The countdown changes every tick, so it is footer status, not query bar
   // context; the footer ellipsizes a long event name.
   const nextText = nextEvent && nextCountdown ? `next ${nextEvent.event} ${nextCountdown}` : null;
@@ -285,7 +329,7 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     ...(showStale ? [{ id: "stale", parts: [{ text: "STALE", tone: "warning" as const }] }] : []),
     ...(staleness ? [{ id: "updated", parts: [{ text: staleness, tone: "muted" as const }] }] : []),
   ], [detailEvent, listedAfterStatus, nextText, showStale, staleness]);
-  // A report of the pane (`gloomberb fn ECO`) says it too.
+  // A report of the pane (`gloom fn ECO`) says it too.
   const listedThrough = listedEnd ? dateKey(listedEnd) : null;
   useRemoteUiNode(listedAfter && listedThrough ? {
     role: "report-notice",
@@ -346,7 +390,10 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     const ev = row.event;
     switch (column.id) {
       case "time":
-        return { text: timeLabel(ev.date), color: colors.textMuted };
+        // A bank that states no time has none here, and its detail says why; an all-day event (a plenum, an election) says so.
+        return { text: hasNoStatedTime(ev) ? "" : isAllDayEvent(ev) ? "All day" : timeLabel(ev.date), color: colors.textMuted };
+      case "readerTime":
+        return { text: hasNoReleaseTime(ev) || !readerZone ? "" : zonedClock(ev.date.getTime(), readerZone).label, color: colors.textMuted };
       case "impact": {
         const indicator = impactIndicator(ev.impact);
         return {
@@ -354,10 +401,14 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
           color: indicator.color,
         };
       }
-      case "country":
-        // The ISO code, not a flag emoji: emoji widths do not match a fixed
-        // column and pushed the right-hand columns off the pane.
-        return { text: ev.country, color: colors.textMuted };
+      case "country": {
+        // The ISO code, led on the desktop by the flag drawn as art, never a
+        // flag emoji: emoji widths do not match a fixed column and pushed the
+        // right-hand columns off the pane. A national euro-area release is
+        // its member's (DE for German Ifo), the ECB's the euro area's.
+        const country = eventCountry(ev);
+        return withCountryFlag({ text: country, color: colors.textMuted }, country, flagged);
+      }
       case "event":
         return { text: ev.event, color: colors.text };
       case "actual":
@@ -370,7 +421,7 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
       case "prior":
         return { text: ev.prior ?? "—", color: colors.textDim };
     }
-  }, []);
+  }, [flagged, readerZone]);
 
   const selectedEvent = filtered[selectedIdx];
   const filterControls = (
@@ -381,7 +432,9 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
           options: FILTER_CYCLE.map((value) => ({ value, label: IMPACT_LABELS[value] })),
           onChange: (value: string) => selectImpactFilter(value as ImpactFilter) },
         { id: "region", label: "Region", inline: true, value: countryFilter, defaultValue: "all",
-          options: COUNTRY_CYCLE.map((value) => ({ value, label: value === "all" ? "All" : value })),
+          // Countries a command named stay a choice beside the regions while they are shown.
+          options: [...COUNTRY_CYCLE, ...(COUNTRY_CYCLE.includes(countryFilter) ? [] : [countryFilter])]
+            .map((value) => ({ value, label: value === "all" ? "All" : value.split(",").join(", ") })),
           onChange: (value: string) => selectCountryFilter(value as CountryFilter) },
       ]}
       meta={selectedEvent ? dayLabel(selectedEvent.date, today) : undefined}
@@ -462,6 +515,19 @@ export const economicCalendarModule: PluginModule = {
     defaultMode: "floating",
     defaultFloatingSize: { width: 100, height: 30 },
     tableExport: true,
+    reportOptions: [{
+      key: "country",
+      type: "string",
+      placeholder: "countries",
+      description: "Regions or two-letter country codes to list, comma separated: US, G7, EU, or such as MX,BR,ZA",
+      example: "--country MX,BR,ZA",
+      exampleWithoutArgument: true,
+      normalize: (value) => {
+        const parsed = parseCountryFilter(value);
+        if ("error" in parsed) throw new Error(`${parsed.error} ${COUNTRY_FILTER_HINT}`);
+        return parsed.filter;
+      },
+    }],
     settings: {
       title: "Economic Calendar Settings",
       fields: [{
@@ -479,8 +545,29 @@ export const economicCalendarModule: PluginModule = {
     label: "Economic Calendar",
     description: "Upcoming economic events, releases, and indicators.",
     // "econ" stays a keyword so the old ECON prefix still finds this pane.
-    keywords: ["econ", "economic", "calendar", "events", "macro", "releases", "fed", "cpi", "gdp"],
-    shortcut: { prefix: "ECO" },
+    keywords: ["econ", "economic", "calendar", "events", "macro", "releases", "fed", "cpi", "gdp", "rate decision", "ipca",
+      "brazil inflation"],
+    // ECO MX,BR opens the calendar on those countries.
+    shortcut: {
+      prefix: "ECO",
+      argKind: "text",
+      argPlaceholder: "countries",
+      argOptional: true,
+      openWithoutArg: true,
+      argOptions: () => [
+        { value: "US", label: "United States" },
+        { value: "G7", label: "G7" },
+        { value: "EU", label: "Euro area" },
+        { value: "MX,BR,ZA,IN,KR", label: "Mexico, Brazil, South Africa, India and Korea" },
+      ],
+    },
+    createInstance: (_context, options) => {
+      const typed = options?.arg?.trim();
+      if (!typed) return {};
+      const parsed = parseCountryFilter(typed);
+      if ("error" in parsed) throw new Error(`${parsed.error} ${COUNTRY_FILTER_HINT}`);
+      return { params: commandRequestParams({ country: parsed.filter }) };
+    },
   }],
   setup(ctx) {
     attachEconCalendarPersistence(ctx.persistence);

package/src/plugins/builtin/econ/print-watch.ts

@@ -1,5 +1,6 @@
 import type { GloomPluginContext } from "../../../types/plugin";
 import {
+  eventCountry,
   getCalendarCache,
   landedHighImpactPrints,
   loadCalendar,
@@ -92,7 +93,7 @@ export function startHighImpactPrintWatch(
 
   const toast = (event: EconEvent) => {
     ctx.notify({
-      title: event.country,
+      title: eventCountry(event),
       body: printBody(event),
       type: "info",
       desktop: "always",

package/src/plugins/builtin/econ/types.ts

@@ -1,4 +1,3 @@
-
 export type EconImpact = "high" | "medium" | "low";
 
 export interface EconEvent {
@@ -11,4 +10,36 @@ export interface EconEvent {
   forecast: string | null;
   prior: string | null;
   impact: EconImpact;
+  /**
+   * Rows Gloom Cloud adds beside its feeds: a central bank's kept decision or
+   * a statistics office's listed release. The feeds' own rows carry none of
+   * the fields below.
+   */
+  kind?: "central-bank-decision" | "statistics-release";
+  /** The publisher's own clock time and its IANA zone; null when it states no time. */
+  localTime?: string | null;
+  timeZone?: string;
+  /** Why a row has no time, when its publisher states none. */
+  timeNote?: string | null;
+  /** The day the prior level was observed. */
+  priorAsOf?: string | null;
+  /** The period a release covers, as its publisher names it. */
+  referencePeriod?: string | null;
+  /** Who publishes it (Freddie Mac for the 30-year mortgage rate), and its page when one is named. */
+  source?: { name: string; url?: string };
+}
+
+/** Whether a row's time is blank because its publisher states none (a bank whose calendar gives the day only). */
+export function hasNoStatedTime(event: Pick<EconEvent, "timeNote">): boolean {
+  return typeof event.timeNote === "string" && event.timeNote.length > 0;
+}
+
+/** A row that takes its whole day (a plenum, an election, a summit): it has a day and no release time. */
+export function isAllDayEvent(event: Pick<EconEvent, "time" | "timeNote">): boolean {
+  return event.time === "All Day" && !hasNoStatedTime(event);
+}
+
+/** A row with a day and no clock time to count to: an all-day event, or a bank that states no time. */
+export function hasNoReleaseTime(event: Pick<EconEvent, "time" | "timeNote">): boolean {
+  return hasNoStatedTime(event) || isAllDayEvent(event);
 }

package/src/plugins/builtin/econ-statistics/client.ts

@@ -12,6 +12,8 @@ export interface StatBuild {
   stat: StatDef;
   points: StatPoint[];
   trend: TrendFit;
+  /** The day the latest point's figure was released (`YYYY-MM-DD`), when FRED says. */
+  releasedOn?: string;
   cache?: SeriesCacheMetadata;
 }
 
@@ -45,10 +47,12 @@ function build(def: StatDef, result: DatedObservation[] | SeriesCacheLoadResult)
     ? observations
     : observations.map((entry) => ({
       date: entry.date,
-      value: entry.value == null ? null : entry.value * scale,
+      // Rounded off the float's last digits: 2.36 × 100 is 236, not 236.00000000000003.
+      value: entry.value == null ? null : Number((entry.value * scale).toPrecision(12)),
     }));
   const points = applyTransform(scaled, def.transform);
   if (points.length === 0) return null;
+  const releasedOn = latestRelease(observations, points.at(-1)!.date);
   const cache = Array.isArray(result) ? undefined : {
     fetchedAt: result.fetchedAt,
     stale: result.stale,
@@ -56,7 +60,14 @@ function build(def: StatDef, result: DatedObservation[] | SeriesCacheLoadResult)
     ...(result.refreshError ? { refreshError: result.refreshError } : {}),
   };
   // These go negative routinely, so the fit stays linear.
-  return { stat: def, points, trend: fitTrend(points, "linear"), ...(cache ? { cache } : {}) };
+  return { stat: def, points, trend: fitTrend(points, "linear"), ...(releasedOn ? { releasedOn } : {}), ...(cache ? { cache } : {}) };
+}
+
+/** When the newest observation was released, if the latest point is that observation's. */
+function latestRelease(observations: readonly DatedObservation[], latestDate: string): string | undefined {
+  const newest = observations.reduce<DatedObservation | null>((best, entry) =>
+    entry.value != null && (!best || entry.date > best.date) ? entry : best, null);
+  return newest?.date === latestDate && typeof newest.releasedOn === "string" ? newest.releasedOn : undefined;
 }
 
 /**
@@ -72,7 +83,9 @@ function alignDerivedBuilds(builds: StatBuild[]): StatBuild[] {
     const cap = (legs as string[]).reduce((oldest, date) => date < oldest ? date : oldest);
     if ((entry.points.at(-1)?.date ?? "") <= cap) return entry;
     const points = entry.points.filter((point) => point.date <= cap);
-    return points.length > 0 ? { ...entry, points, trend: fitTrend(points, "linear") } : entry;
+    if (points.length === 0) return entry;
+    const { releasedOn: _cutRelease, ...rest } = entry;
+    return { ...rest, points, trend: fitTrend(points, "linear") };
   });
 }
 

package/src/plugins/builtin/econ-statistics/defs.ts

@@ -5,6 +5,7 @@ export type StatCategoryId =
   | "inflation"
   | "labor"
   | "growth"
+  | "nowcasts"
   | "consumer"
   | "housing"
   | "rates"
@@ -14,6 +15,7 @@ export const STAT_CATEGORIES: ReadonlyArray<{ id: StatCategoryId; label: string
   { id: "inflation", label: "Inflation" },
   { id: "labor", label: "Labor" },
   { id: "growth", label: "Growth" },
+  { id: "nowcasts", label: "Nowcasts & conditions" },
   { id: "consumer", label: "Consumer" },
   { id: "housing", label: "Housing" },
   { id: "rates", label: "Rates & Money" },
@@ -56,6 +58,8 @@ export interface StatDef {
   staleAfterMs: number;
   /** Searchable description; the long-form reference lives in docs/economics-reference.md. */
   note: string;
+  /** Other words the catalog and the pane's filter find it by: `PMMS` for the mortgage rate. */
+  keywords?: readonly string[];
   /** Concise measurement identity that must remain beside the values. */
   measurementBasis?: string;
   /**

package/src/plugins/builtin/econ-statistics/detail.tsx

@@ -1,6 +1,6 @@
 import { useMemo } from "react";
 import { ExternalLinkText, type StatItem } from "../../../components/ui";
-import { fredSeriesUrl } from "../../../sources/gloomberb-cloud/fred-series";
+import { fredSeriesUrl, fredSourceLabel } from "../../../sources/gloomberb-cloud/fred-series";
 import { colors } from "../../../theme/colors";
 import { Box, Text } from "../../../ui";
 import { formatBasisPoints } from "../../../utils/basis-points";
@@ -74,7 +74,7 @@ export function StatDetail({
         <Box flexDirection="row" flexWrap="wrap" paddingX={1} flexShrink={0}>
           <ExternalLinkText
             url={fredSeriesUrl(stat.seriesId)}
-            label={`FRED ${stat.seriesId}`}
+            label={fredSourceLabel(stat.seriesId)}
             color={colors.text}
           />
           {stat.measurementBasis ? <Text fg={colors.textDim}>{` · ${stat.measurementBasis}`}</Text> : null}

package/src/plugins/builtin/econ-statistics/headless.ts

@@ -3,6 +3,7 @@ import type {
   HeadlessPaneDefinition,
   HeadlessPaneEntry,
 } from "../../../types/plugin";
+import { fredSourceLabel } from "../../../sources/gloomberb-cloud/fred-series";
 import { formatBasisPoints, toBasisPoints } from "../../../utils/basis-points";
 import { formatNumber } from "../../../utils/format";
 import type { StatDef } from "./defs";
@@ -70,8 +71,9 @@ function detailEntries(view: StatViewModel, cutoffShown: boolean): HeadlessPaneE
     })),
     // FRED dates a monthly reading at the month's first day; the text says which period it is.
     // A Treasury yield adds when in the day it was taken, so it is not read against ^TNX's earlier close.
-    { label: "Period", value: view.latest.date, formatted: view.stat.cutoff && !cutoffShown ? `${view.reading} ${view.stat.cutoff}` : view.reading },
-    { label: "Source", value: `FRED ${view.stat.seriesId}` },
+    // A figure dated by its period also says when it was released: "Sep 2026, released Tue 20 Oct".
+    { label: "Period", value: view.latest.date, formatted: view.stat.cutoff && !cutoffShown ? `${view.reading} ${view.stat.cutoff}` : view.readingReleased },
+    { label: "Source", value: fredSourceLabel(view.stat.seriesId) },
   ];
 }
 
@@ -115,6 +117,11 @@ export function projectStatsHeadlessBundle(
           format: (value: unknown) => formatNumber(Number(value), 0),
         },
         { key: "asOf", header: "Period", format: (_value: unknown, row: Record<string, unknown>) => String(row.reading) },
+        {
+          key: "releasedOn",
+          header: "Released",
+          format: (_value: unknown, row: Record<string, unknown>) => typeof row.released === "string" ? row.released.replace(/^released /, "") : "",
+        },
       ],
       rows: categoryViews.map((view) => ({
         id: view.stat.id,
@@ -129,8 +136,12 @@ export function projectStatsHeadlessBundle(
           previousBasisPoints: view.previous ? toBasisPoints(view.previous.value) : null,
         } : {}),
         percentile: view.percentile,
+        // The period the figure covers; `releasedOn` is when it was published, which the report is as of.
         asOf: view.latest.date,
+        releasedOn: view.releasedOn,
+        ...(view.periodicity ? { periodicity: view.periodicity } : {}),
         reading: view.reading,
+        released: view.released,
         stale: view.observationStale || view.cacheStale,
         fetchedAt: view.fetchedAt,
         cacheStale: view.cacheStale,

package/src/plugins/builtin/econ-statistics/index.tsx

@@ -23,15 +23,15 @@ export const econStatisticsModule: PluginModule = {
     paneId: ECON_STATISTICS_PANE_ID,
     label: "Economic Statistics",
     description: "Inflation, labour, growth, housing and rates against their own history.",
-    keywords: [
+    keywords: [...new Set([
       "economic",
       "statistics",
       "macro",
       "indicators",
       "data",
       ...STAT_CATEGORIES.map((entry) => entry.label.toLowerCase()),
-      ...STATS.map((entry) => entry.shortLabel.toLowerCase()),
-    ],
+      ...STATS.flatMap((entry) => [entry.shortLabel, ...entry.keywords ?? []].map((keyword) => keyword.toLowerCase())),
+    ])],
     shortcut: {
       prefix: "ECST",
       argPlaceholder: "statistic",

package/src/plugins/builtin/econ-statistics/pane.tsx

@@ -63,6 +63,7 @@ function matchesQuery(view: StatViewModel, query: string): boolean {
     view.stat.seriesId,
     categoryLabel(view.stat.category),
     view.stat.note,
+    ...view.stat.keywords ?? [],
   ].join(" ").toLowerCase();
   return query.split(/\s+/).every((token) => haystack.includes(token));
 }
@@ -150,7 +151,7 @@ export function EconStatisticsPane({ focused, width, height }: PaneProps) {
     // A Treasury yield names when in the day it was taken, as GC does, so it is not read against ^TNX's earlier close.
     const cutoff = selected.stat.cutoff ? ` ${selected.stat.cutoff}` : "";
     const info: PaneFooterSegment[] = [
-      { id: "as-of", parts: [{ text: `reading for ${selected.reading}${cutoff}`, tone: "muted" }] },
+      { id: "as-of", parts: [{ text: `reading for ${cutoff ? selected.reading : selected.readingReleased}${cutoff}`, tone: "muted" }] },
     ];
     // The cached first paint is being replaced; its age only counts once that load fails.
     const seeding = resource.loading && resource.updatedAt === null && !selected.refreshError;

package/src/plugins/builtin/econ-statistics/stats.ts

@@ -5,6 +5,9 @@ import type { StatDef } from "./defs";
 const DAY_MS = 24 * 60 * 60 * 1000;
 const DAILY = 6 * DAY_MS;
 const WEEKLY = 21 * DAY_MS;
+// GDPNow is dated at quarter start but updated through the following month's
+// advance GDP release; allow that ~120-day span plus two weeks.
+const NOWCAST_QUARTERLY = 135 * DAY_MS;
 // FRED dates a print at the start of its period, so an on-time print is two
 // periods plus the release lag old just before the next one lands. Each limit
 // adds about two weeks to the slowest normal lag of its group.
@@ -16,11 +19,14 @@ const QUARTERLY = 235 * DAY_MS; // GDP, productivity: two quarters plus a lag up
 const pct = (value: number) => `${formatNumber(value, 1)}%`;
 const pct2 = (value: number) => `${formatNumber(value, 2)}%`;
 const plain = (value: number) => formatNumber(value, 1);
+const index2 = (value: number) => formatNumber(value, 2);
 /** FRED reports payrolls and claims in thousands already. */
 const thousands = (value: number) => `${formatNumber(value / 1000, value >= 10_000 ? 1 : 2)}M`;
 const signedThousands = (value: number) =>
   `${value > 0 ? "+" : ""}${formatNumber(value, 0)}k`;
 const billions = (value: number) => `${formatNumber(value, 0)}B`;
+/** A spread already scaled to basis points; the label says the unit. */
+const basisPoints = (value: number) => formatNumber(value, 0);
 
 function stat(def: StatDef): StatDef {
   return def;
@@ -249,6 +255,68 @@ export const STATS: readonly StatDef[] = [
     limit: 500,
   }),
 
+  // ---- Nowcasts & conditions --------------------------------------------
+  stat({
+    id: "gdpnow",
+    measurementBasis: "Estimate · q/q annualized",
+    label: "Atlanta Fed GDPNow",
+    shortLabel: "GDPNow",
+    category: "nowcasts",
+    seriesId: "GDPNOW",
+    transform: "level",
+    direction: "higher-is-good",
+    axisUnit: "%",
+    formatValue: pct,
+    reference: { value: 0, label: "flat" },
+    staleAfterMs: NOWCAST_QUARTERLY,
+    note: "Atlanta Fed model estimate of real GDP growth, updated within the quarter. Already an annualized percentage change, not a GDP level.",
+  }),
+  stat({
+    id: "nfci",
+    measurementBasis: "Weekly · index",
+    label: "Chicago Fed Financial Conditions",
+    shortLabel: "Chicago NFCI",
+    category: "nowcasts",
+    seriesId: "NFCI",
+    transform: "level",
+    direction: "higher-is-bad",
+    axisUnit: "",
+    formatValue: index2,
+    reference: { value: 0, label: "average" },
+    staleAfterMs: WEEKLY,
+    note: "Chicago Fed National Financial Conditions Index. Positive values mean tighter-than-average conditions; negative values mean looser conditions.",
+  }),
+  stat({
+    id: "financial-stress",
+    measurementBasis: "Weekly · index",
+    label: "St. Louis Fed Financial Stress",
+    shortLabel: "St. Louis FSI",
+    category: "nowcasts",
+    seriesId: "STLFSI4",
+    transform: "level",
+    direction: "higher-is-bad",
+    axisUnit: "",
+    formatValue: index2,
+    reference: { value: 0, label: "average" },
+    staleAfterMs: WEEKLY,
+    note: "St. Louis Fed Financial Stress Index, current fourth version. Positive values mean above-average stress; negative values mean below-average stress.",
+  }),
+  stat({
+    id: "median-cpi",
+    measurementBasis: "m/m annualized · seasonally adjusted",
+    label: "Cleveland Fed Median CPI",
+    shortLabel: "Median CPI",
+    category: "nowcasts",
+    seriesId: "MEDCPIM158SFRBCLE",
+    transform: "level",
+    direction: "higher-is-bad",
+    axisUnit: "%",
+    formatValue: pct,
+    reference: null,
+    staleAfterMs: MONTHLY_EARLY,
+    note: "Cleveland Fed weighted median consumer price change. Published as an annualized monthly percentage change, not a year-over-year inflation rate.",
+  }),
+
   // ---- Consumer --------------------------------------------------------
   stat({
     id: "retail-sales",
@@ -378,6 +446,41 @@ export const STATS: readonly StatDef[] = [
     note: "Newly built homes sold, at an annual rate.",
     limit: 900,
   }),
+  stat({
+    id: "mortgage-30y",
+    measurementBasis: "Weekly · Freddie Mac PMMS",
+    label: "30-Year Mortgage Rate",
+    shortLabel: "30Y mortgage rate",
+    category: "housing",
+    seriesId: "MORTGAGE30US",
+    transform: "level",
+    direction: "neutral",
+    axisUnit: "%",
+    formatValue: pct2,
+    reference: null,
+    staleAfterMs: WEEKLY,
+    note: "Freddie Mac's weekly average 30-year fixed mortgage rate, what a home purchase is financed at.",
+    keywords: ["mortgage rates", "PMMS", "Freddie Mac", "homebuilders"],
+  }),
+  stat({
+    id: "mortgage-spread",
+    measurementBasis: "30Y mortgage minus 10Y Treasury on the PMMS date",
+    label: "Mortgage–10Y Spread (bp)",
+    shortLabel: "Mortgage–10Y (bp)",
+    category: "housing",
+    seriesId: "MORTGAGE30US10Y",
+    derivedFrom: ["mortgage-30y", "ten-year"],
+    transform: "level",
+    // Gloom Cloud serves it in percentage points, as FRED does its spreads.
+    scale: 100,
+    direction: "neutral",
+    axisUnit: "",
+    formatValue: basisPoints,
+    reference: null,
+    staleAfterMs: WEEKLY,
+    note: "The 30-year mortgage rate less the 10-year Treasury yield on each survey date, how much mortgages pay over Treasuries.",
+    keywords: ["mortgage spread", "PMMS", "homebuilders"],
+  }),
   // ---- Rates & money ---------------------------------------------------
   stat({
     id: "fed-funds",