gloomberb 0.18.2 → 0.18.4

package/src/plugins/builtin/iv-history/format.ts

@@ -12,6 +12,9 @@ export const VCA_DEFINITIONS = [
   "VIX is Cboe's 30-day S&P 500 implied vol from the whole SPX strike strip, skew included; IV30 here is at the money, so VIX usually reads higher.",
 ] as const;
 
+/** Words for implied volatility that are no function's code: `fn IVOL` names HIVG and OVDV, which list them as `suggestFor`. */
+export const IMPLIED_VOL_WORDS = ["IVOL", "IV", "OVOL", "IMPVOL", "IMPLIEDVOL"];
+
 /**
  * A skew column's header names its sign, since the conventions differ: the
  * 25-delta skew is put minus call (HIVG, VCA), the risk reversal call minus

package/src/plugins/builtin/iv-history/headless.ts

@@ -2,10 +2,19 @@ import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { resolveHeadlessInstrument } from "../shared/headless-market-data";
 import { createRealizedVolatilityDependencies, loadRealizedVolatilityHistory } from "../realized-vol/client";
 import { createHvDependencies, loadIvHistory, loadIvScreen, loadScreenVolatilities } from "./client";
-import { formatPoints, formatRank, formatSpot, formatStat, formatVol, readingLabel, sharedDates, skewHeader, VCA_DEFINITIONS, verdictLabel } from "./format";
+import { formatPoints, formatRank, formatSpot, formatStat, formatVol, IMPLIED_VOL_WORDS, readingLabel, sharedDates, skewHeader, VCA_DEFINITIONS, verdictLabel } from "./format";
 import { HV_WINDOWS, type HvWindow, type IvLookback, type IvStatRow, projectIvHistory, projectRichCheap, type RichCheapRow, richCheapDates, screenCoverage, VCA_LIMIT, VCA_PRESETS } from "./model";
 import { vcaUniverse } from "./universe";
-import { listingFateNotes, loadListingFate, MovedSymbolError } from "../../../tickers/listing-fate";
+import { offsetText, releaseOffsetRows } from "./events";
+import { loadMacroReleases } from "../macro-day/client";
+import { MACRO_EVENT_LABELS, MACRO_RELEASE_SOURCES, staleMacroReleasesNotice, US_MACRO_EVENT_KINDS, type MacroRelease, type UsMacroEventKind,
+  type MacroReleaseList } from "../macro-day/releases";
+import { lookupScheduledDates } from "../alerts/scheduled";
+import { fetchCpiBoard } from "../cpi/client";
+import { fetchRatePath } from "../rate-path/client";
+import type { HeadlessPaneContext } from "../../../types/headless";
+import { zonedDateKey } from "../../../utils/zoned-date-time";
+import { listingFateNotes, listingFateReport, loadListingFate, MovedSymbolError } from "../../../tickers/listing-fate";
 import { startTickerChangeLookup } from "../../../tickers/ticker-changes";
 
 const METHODOLOGY = "docs/research-data.md#implied-volatility-history";
@@ -17,23 +26,33 @@ export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
   usListingsOnly: "Implied volatility history",
   freshness: { status: "not-a-feed", basis: "daily implied volatility", cadence: "daily", observedKey: "date", oldest: null },
   describe: (args) => `HIVG ${args.symbols[0] ?? ""}`,
-  discovery: { aliases: ["HIVG"], screenshotReadiness: "live-dom", dataRequirements: ["Cloud stored implied volatility", "Daily price history"],
+  discovery: { aliases: ["HIVG"], suggestFor: IMPLIED_VOL_WORDS, screenshotReadiness: "live-dom", dataRequirements: ["Cloud stored implied volatility", "Daily price history"],
     limitations: ["History starts February 2024 (daily option trade closes).", "Rank and percentile use trade-close readings only.",
       "IV1Y needs long-dated trades: it can start later, has gaps, and ranks from 60 prior sessions.",
       "skew25d (put-call) and rr25d (call-put) come from the daily quote captures and are blank before the first one."] },
   options: [
     { key: "lookback", type: "enum", values: [{ value: "1Y" }, { value: "2Y" }, { value: "ALL" }], defaultValue: "1Y", description: "Visible history" },
     { key: "hvWindow", type: "enum", values: HV_WINDOWS.map((window) => ({ value: String(window) })), defaultValue: "20", description: "Realized volatility window in sessions" },
+    { key: "event", type: "enum", aliases: ["release"], values: US_MACRO_EVENT_KINDS.map((value) => ({ value, ...value === "jobs" ? { aliases: ["nfp", "payrolls"] } : {} })),
+      description: "One row per release of this kind whose session at --offset has closed (the next scheduled FOMC or CPI included), in place of the daily history",
+      example: "--event fomc --offset -6", shot: { reportOnly: "lists the readings around past release days" } },
+    { key: "offset", type: "integer", minimum: -60, maximum: 60, defaultValue: 0,
+      description: "Sessions from each release with --event: 0 is the first session on or after the release day, -6 the sixth session before that",
+      example: "--event cpi --offset -1", shot: { reportOnly: "picks the session read around each release" } },
   ],
   async load(args, ctx) {
+    const event = typeof args.options.event === "string" && args.options.event ? args.options.event as UsMacroEventKind : null;
+    const offset = Number(args.options.offset) || 0;
+    if (!event && offset !== 0) throw new Error("--offset counts sessions from a release day: add --event fomc, cpi or jobs.");
     const instrument = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
     // What became of the symbol, as `quote` reads it, looked up beside the figures: FB's are the fund listed
     // there now, TWTR stopped trading, and HFC, which became DINO, has none of its own.
     const changes = startTickerChangeLookup(ctx.marketData, instrument.symbol, instrument.exchange);
     const quote = ctx.marketData.getQuote(instrument.symbol, instrument.exchange ?? "").catch(() => null);
-    const [payload, prices] = await Promise.all([
+    const [payload, prices, releases] = await Promise.all([
       loadIvHistory(instrument.symbol, { signal: ctx.signal }, ctx.apiClient),
       loadRealizedVolatilityHistory({ instrument, signal: ctx.signal }, createRealizedVolatilityDependencies(ctx.marketData)),
+      event ? eventReleases(event, ctx) : null,
     ]);
     const fate = await loadListingFate(instrument, ctx.marketData, { quote, changes });
     if (fate.moved) throw new MovedSymbolError(fate.moved);
@@ -57,11 +76,47 @@ export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
     const skewColumns = [{ key: "skew25d", header: skewHeader("skew25d", "put-call"), format: points },
       { key: "rr25d", header: skewHeader("rr25d", "call-put"), format: points }];
     const served = model.iv30.length > 0 || prices.history.length > 0;
-    const fateNotes = listingFateNotes(fate, { served });
     // With nothing served, the fate is why: no "not a ticker" or missing-history errors beside it.
-    const errors = !served && fateNotes.length > 0 ? []
-      : [prices.error, ...model.warnings].filter((value): value is string => !!value);
+    const { notes: fateNotes, errors } = listingFateReport(fate, { served },
+      [prices.error, ...model.warnings].filter((value): value is string => !!value));
     const notes = [...fateNotes, ...[model.oneYearNote, model.skewNote].filter((note): note is string => !!note)];
+    if (event && releases) {
+      const lookback = String(args.options.lookback) as IvLookback;
+      const label = MACRO_EVENT_LABELS[event];
+      const offsets = releaseOffsetRows(model, releases.list.releases, event, offset, {
+        lookback, readThrough: payload.coverage?.backfilledThrough ?? null });
+      const plural = (count: number, one: string, many: string) => count === 1 ? one : many;
+      const eventNotes = [
+        offsets.beforeLookback > 0
+          ? `${offsets.beforeLookback} earlier ${label} ${plural(offsets.beforeLookback, "release is", "releases are")} outside the ${lookback} lookback; --lookback ALL adds ${plural(offsets.beforeLookback, "it", "them")}.` : null,
+        // Said once the lookback says nothing: the history's own start is then where the rows stop.
+        offsets.beforeHistory > 0 && offsets.beforeLookback === 0
+          ? `${offsets.beforeHistory} earlier ${label} ${plural(offsets.beforeHistory, "release predates", "releases predate")} the IV history, which starts ${offsets.historyStart}.` : null,
+        offsets.pending.length > 0
+          ? `Left out ${label} ${offsets.pending.join(", ")}: no closing reading yet for ${plural(offsets.pending.length, "its session", "their sessions")} at --offset ${offset}.` : null,
+        releases.upcomingNote,
+        staleMacroReleasesNotice(releases.list),
+      ].filter((note): note is string => !!note);
+      const eventColumns = [{ key: "releaseDate", header: "Release date" }, { key: "session", header: "Session" },
+        ...historyColumns.slice(1), ...skewColumns];
+      return {
+        sections: [{
+          title: `${label} releases, ${offsetText(offset)}`,
+          // The export names the release and the offset on every row, so files of several offsets or releases join.
+          columns: [{ key: "release", header: "Release" }, eventColumns[0]!, { key: "offset", header: "Offset (sessions)" }, ...eventColumns.slice(1)],
+          rows: offsets.rows.map(({ date, ...row }) => ({ ...row, session: date, release: label })),
+          textColumns: offsets.rows.some((row) => row.skew25d != null) ? eventColumns : eventColumns.slice(0, -skewColumns.length),
+        }],
+        complete: payload.status === "ready" && errors.length === 0,
+        unavailableSymbols: offsets.rows.some((row) => row.iv30 != null) ? [] : [instrument.symbol], errors,
+        ...(notes.length + eventNotes.length > 0 ? { notes: [...notes, ...eventNotes] } : {}),
+        // Dated by the history read, not by the newest release's session: an old release is no stale reading.
+        ...(model.asOf ? { freshness: { asOf: model.asOf } } : {}),
+        metadata: { status: payload.status, coverage: payload.coverage, event, offset, releasesThrough: releases.list.coveredThrough,
+          nextRelease: releases.upcoming,
+          releaseSource: MACRO_RELEASE_SOURCES[event], unit: "decimal annualized volatility", methodology: METHODOLOGY },
+      };
+    }
     return {
       sections: [
         { title: "Statistics", columns: [
@@ -153,3 +208,32 @@ export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
     };
   },
 };
+
+/**
+ * The releases of `event` HIVG reads around: the days MDAY studies (the list
+ * the app ships with, extended by Gloom Cloud's), and the next one scheduled,
+ * from the CPI board's release calendar or the FOMC meetings WIRP prices, as
+ * scheduled alerts read them. Payrolls have no schedule to read.
+ */
+async function eventReleases(event: UsMacroEventKind, ctx: HeadlessPaneContext): Promise<{
+  list: MacroReleaseList; upcoming: string | null; upcomingNote: string | null;
+}> {
+  const label = MACRO_EVENT_LABELS[event];
+  const [published, next] = await Promise.all([
+    loadMacroReleases({}, () => ctx.apiClient.getCloudMacroReleaseDays()),
+    event === "jobs" ? null : lookupScheduledDates([{ kind: "macro", event }], {
+      earnings: async () => [],
+      cpi: () => fetchCpiBoard(ctx.apiClient),
+      fomc: async () => (await fetchRatePath(ctx.apiClient)).meetings,
+    }, zonedDateKey(Date.now(), "America/New_York")).then((dates) => dates.get(`macro:${event}`) ?? { date: null }),
+  ]);
+  const upcoming = next && "date" in next ? next.date : null;
+  const listed = upcoming != null && published.releases.some((release) => release.kind === event && release.date === upcoming);
+  const releases: MacroRelease[] = upcoming && !listed ? [...published.releases, { kind: event, date: upcoming }] : published.releases;
+  return {
+    list: { ...published, releases },
+    upcoming,
+    upcomingNote: next == null ? `The next ${label} release is not scheduled here, so it has no row yet.`
+      : "error" in next ? `The next ${label} date could not be loaded (${next.error}), so it has no row.` : null,
+  };
+}

package/src/plugins/builtin/iv-history/index.tsx

@@ -37,7 +37,7 @@ export const ivHistoryModule: PluginModule = {
     {
       id: "iv-screen-pane", paneId: "iv-screen", label: "Volatility Rich/Cheap",
       description: "IV rank, percentile, one-year IV, term slope, skew and IV/HV across a list, ranked rich to cheap.",
-      // Where a put seller finds rich premium; OSA owns the exact put-selling phrases and ranks first on them.
+      // Where a put seller finds rich premium; CSP and OSA own the exact put-selling phrases and rank first on them.
       keywords: ["vca", "rich", "cheap", "iv rank", "implied volatility", "screen", "cash-secured puts", "selling puts", "short-put candidates",
         "csp candidates", "wheel candidates"],
       shortcut: { prefix: "VCA", argKind: "ticker-list" as const, argOptional: true }, headless: ivScreenHeadless,

package/src/plugins/builtin/iv-history/model.ts

@@ -2,6 +2,16 @@ import type { PricePoint } from "../../../types/financials";
 import { rollingRealizedVolatility } from "../shared/volatility";
 import type { IvCoverageStatus, IvHistoryPayload, IvMethod, IvPoint, IvScreenRow, IvStats } from "./client";
 
+/**
+ * A history's warnings in words for the reader. A symbol demand coverage could
+ * not take (unavailable, with the server's queue wording as its warning) is
+ * said plainly instead: none of its history is being collected, so nothing is
+ * promised.
+ */
+export function ivHistoryWarnings(payload: Pick<IvHistoryPayload, "status" | "symbol" | "warnings">): string[] {
+  return payload.status === "unavailable" && payload.warnings.length ? [`No IV history for ${payload.symbol} yet.`] : [...payload.warnings];
+}
+
 export const HV_WINDOWS = [20, 30] as const;
 export type HvWindow = (typeof HV_WINDOWS)[number];
 export type IvLookback = "1Y" | "2Y" | "ALL";
@@ -159,7 +169,7 @@ export function projectIvHistory(
 ): IvHistoryModel {
   const lookback = options.lookback ?? "1Y";
   const window = options.hvWindow ?? 20;
-  const warnings = [...payload.warnings];
+  const warnings = ivHistoryWarnings(payload);
   const tradeIv30 = byMethod(payload.series, "trade-close", "iv30");
   const latestDate = [payload.latest?.date, tradeIv30.at(-1) && day(tradeIv30.at(-1)!.date)].filter((value): value is string => !!value).sort().at(-1) ?? null;
   const start = latestDate ? lookbackStart(latestDate, lookback) : null;
@@ -358,9 +368,8 @@ export function screenCoverage(
     notes.push(`Backfilling: ${backfilling.map((row) => row.backfilledThrough ? `${row.symbol} through ${row.backfilledThrough}` : row.symbol).join(", ")}.`);
   }
   if (final.length) notes.push(`No options history: ${final.map((row) => row.symbol).join(", ")}.`);
-  const reasons = new Map<string, string[]>();
-  for (const row of uncovered) reasons.set(row.warning!, [...(reasons.get(row.warning!) ?? []), row.symbol]);
-  for (const [reason, symbols] of reasons) notes.push(`Not queued: ${symbols.join(", ")}. ${reason}`);
+  // The server's queue wording (why demand coverage could not take them) is not repeated: none of their history is being collected, so nothing is promised.
+  if (uncovered.length) notes.push(`No IV history yet: ${uncovered.map((row) => row.symbol).join(", ")}.`);
   const pending = [...queued, ...backfilling, ...uncovered];
   return { notes, pending: pending.map((row) => row.symbol),
     missing: pending.filter((row) => row.iv30 == null && row.date == null).map((row) => row.symbol) };

package/src/plugins/builtin/iv-history/series.ts

@@ -1,5 +1,6 @@
 import type { SeriesDefinition } from "../../../series/types";
 import { loadIvHistory, type IvPoint } from "./client";
+import { ivHistoryWarnings } from "./model";
 
 const TENORS: ReadonlyArray<readonly [key: "iv30" | "iv90" | "iv365", label: string]> = [
   ["iv30", "30-day"],
@@ -18,12 +19,13 @@ export const IV_SERIES: readonly SeriesDefinition[] = TENORS.map(([key, label]):
   input: "ticker",
   load: async ({ ticker, signal }) => {
     const payload = await loadIvHistory(ticker!, { ...(signal ? { signal } : {}) });
+    const warnings = ivHistoryWarnings(payload);
     return {
       points: payload.series.map((point: IvPoint) => ({
         date: point.sessionDate,
         value: point[key] == null ? null : point[key]! * 100,
       })),
-      ...(payload.warnings.length ? { warning: payload.warnings.join("; ") } : {}),
+      ...(warnings.length ? { warning: warnings.join("; ") } : {}),
     };
   },
 }));

package/src/plugins/builtin/jobs/lock-note.ts

@@ -5,7 +5,7 @@ import { proLockNote, type FreeRoute } from "../shared/pro-lock-note";
 
 /** HIRE's preview, for a company whose careers system it reads: Coffee Holding (JVA) is mapped but uncovered. */
 const HIRE_ROUTE: FreeRoute = {
-  text: (ticker, company) => `gloomberb fn HIRE ${ticker} previews ${company}'s hiring with its latest roles, without the full history.`,
+  text: (ticker, company) => `gloom fn HIRE ${ticker} previews ${company}'s hiring with its latest roles, without the full history.`,
   answers: async (symbol, context) => {
     const data = await fetchAttention("hiring", symbol, { limit: 1 }, context.apiClient, context.signal) as HiringPayload;
     return data.evidence.length + data.series.length + data.functions.length > 0;

package/src/plugins/builtin/jobs/model.ts

@@ -9,6 +9,9 @@ import type {
 } from "../../../api-client/types";
 import { formatCompact, formatNumber } from "../../../utils/format";
 import { compareSortValues } from "../../../utils/sort-values";
+import { formatSalaryRange, postingTitle } from "../shared/job-posting";
+
+export { formatSalaryRange };
 
 /**
  * Pure projections from the cloud payload to what the pane, the research tab
@@ -110,20 +113,6 @@ export function formatShare(share: number): string {
   return `${formatNumber(share * 100, share >= 0.1 ? 0 : 1)}%`;
 }
 
-export function formatSalaryRange(
-  min: number | null,
-  max: number | null,
-  currency: string | null,
-  period: string | null,
-): string {
-  if (min == null && max == null) return "";
-  const symbol = currency === "USD" ? "$" : currency === "EUR" ? "€" : currency === "GBP" ? "£" : currency ? `${currency} ` : "";
-  const fmt = (value: number) => (period === "hour" ? formatNumber(value, 0) : formatCompact(value));
-  const range = min != null && max != null && min !== max
-    ? `${symbol}${fmt(min)}–${fmt(max)}`
-    : `${symbol}${fmt((min ?? max)!)}`;
-  return period === "hour" ? `${range}/h` : period === "month" ? `${range}/mo` : range;
-}
 
 /** "3d", "6w", "4mo" from an ISO date, with a `+` when the date is a floor. */
 export function formatAge(posted: string | null, precision: string | null, now = new Date()): string {
@@ -162,7 +151,7 @@ export function buildPostingRows(postings: readonly CloudJobsPosting[], now = ne
   return postings.map((posting) => ({
     key: String(posting.id),
     posting,
-    title: posting.title,
+    title: postingTitle(posting.title),
     function: functionLabel(posting.function),
     seniority: seniorityLabel(posting.seniority),
     location: posting.remote && !/remote/i.test(posting.location ?? "")

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

@@ -32,6 +32,7 @@ import { useAsyncResource } from "../../../react/async-resource";
 import { useShortcut } from "../../../react/input";
 import { colors } from "../../../theme/colors";
 import { Box, Text, TextAttributes, useRendererHost, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
+import { withCountryFlag } from "../../../components/ui/country-flag";
 import { formatNumber } from "../../../utils/format";
 import { isPlainKey } from "../../../utils/keyboard";
 import { nextHeaderSort } from "../../../utils/sort-values";
@@ -85,7 +86,7 @@ function HiringProWall({ symbol, exchange, width, height }: { symbol: string | n
       placement="jobs-wall"
       symbol={symbol} exchange={exchange} width={width} height={height}
       title="Hiring data is part of Gloom Cloud Pro."
-      message={`Gloomberb reads every listed company's own careers system daily: open roles over time, hiring by function and location, new roles, and pay ranges.${symbol ? ` Open ${symbol}'s hiring picture with Pro.` : ""}`}
+      message={`Gloom reads every listed company's own careers system daily: open roles over time, hiring by function and location, new roles, and pay ranges.${symbol ? ` Open ${symbol}'s hiring picture with Pro.` : ""}`}
     />
   );
 }
@@ -486,7 +487,7 @@ function CompanyView({
           <Box flexDirection="column" paddingX={1} paddingTop={1}>
             {countryRows.length === 0
               ? <Text fg={colors.textDim}>No locations in the postings collected so far.</Text>
-              : <ShareBars rows={countryRows} width={Math.min(width - 2, 80)} color={colors.warning} showDelta />}
+              : <ShareBars rows={countryRows} width={Math.min(width - 2, 80)} color={colors.warning} showDelta flags />}
           </Box>
         ) : tab === "seniority" ? (
           <Box flexDirection="column" paddingX={1} paddingTop={1}>
@@ -575,7 +576,7 @@ function CompanyPanel({
       <PaneStatusBody
         empty
         emptyTitle={`No careers system found for ${symbol}.`}
-        emptyMessage="Gloomberb reads companies' own careers systems. This one either has none we can read or lists roles only on third-party job boards."
+        emptyMessage="Gloom reads companies' own careers systems. This one either has none we can read or lists roles only on third-party job boards."
         retry={{ onRetry: reload, pending: loading, label: "Look again", pendingLabel: "Looking again...", unchanged: "Still no careers system." }}
       />
     );
@@ -682,9 +683,10 @@ function HomeView({ width, height, focused, registrationId }: { width: number; h
       case "function":
         return { text: row.function, color: colors.textDim };
       case "country":
-        return { text: row.country, color: colors.textDim };
+        // The column has room for the flag beside the code and its share.
+        return withCountryFlag({ text: row.country, color: colors.textDim }, row.mover.topCountry?.code, nativePaneChrome === true);
     }
-  }, []);
+  }, [nativePaneChrome]);
 
   if (status === "loading" && !data) return <PaneStatusBody loading align="center" loadingLabel="Loading hiring data..." />;
   if (status === "error" && !data) return <PaneStatusBody error={error ?? "Could not load hiring data."} errorTitle="Could not load hiring data." retry={{ onRetry: reload }} />;

package/src/plugins/builtin/jobs/share-bars.tsx

@@ -1,5 +1,6 @@
+import { COUNTRY_FLAG_CELLS, CountryFlagLead } from "../../../components/ui/country-flag";
 import { RatioBar } from "../../../components/ui/ratio-bar";
-import { Box, Text, TextAttributes } from "../../../ui";
+import { Box, Text, TextAttributes, useUiCapabilities } from "../../../ui";
 import { colors } from "../../../theme/colors";
 import { formatNumber, truncateToDisplayWidth } from "../../../utils/format";
 import type { ShareBarRow } from "./model";
@@ -16,6 +17,8 @@ export interface ShareBarsProps {
   color?: string;
   /** Show the 30d delta column when any row has one. */
   showDelta?: boolean;
+  /** Rows are countries: the desktop and the web lead each with its flag. */
+  flags?: boolean;
 }
 
 const COUNT_WIDTH = 6;
@@ -36,9 +39,11 @@ function deltaColor(delta: number | null): string {
   return delta > 0 ? colors.positive : colors.negative;
 }
 
-export function ShareBars({ rows, width, color = colors.borderFocused, showDelta = false }: ShareBarsProps) {
+export function ShareBars({ rows, width, color = colors.borderFocused, showDelta = false, flags = false }: ShareBarsProps) {
+  const desktop = useUiCapabilities().nativePaneChrome === true;
+  const flagged = flags && desktop;
   const hasDelta = showDelta && rows.some((row) => row.delta != null && row.delta !== 0);
-  const labelWidth = labelWidthFor(width);
+  const labelWidth = labelWidthFor(width) + (flagged ? COUNTRY_FLAG_CELLS : 0);
   const trailing = COUNT_WIDTH + SHARE_WIDTH + (hasDelta ? DELTA_WIDTH + 1 : 0) + 2;
   const barWidth = Math.max(4, width - labelWidth - trailing - 2);
 
@@ -46,9 +51,10 @@ export function ShareBars({ rows, width, color = colors.borderFocused, showDelta
     <Box flexDirection="column" width={width} data-gloom-ui="share-bars">
       {rows.map((row) => (
         <Box key={row.key} flexDirection="row" height={1} alignItems="center">
-          <Box width={labelWidth} flexShrink={0} overflow="hidden">
+          <Box width={labelWidth} flexShrink={0} overflow="hidden" flexDirection="row" alignItems="center">
+            {flagged ? <CountryFlagLead value={row.key === "rest" ? null : row.label} reserve /> : null}
             <Text fg={row.key === "rest" ? colors.textDim : colors.text}>
-              {truncateToDisplayWidth(row.label, labelWidth - 1)}
+              {truncateToDisplayWidth(row.label, labelWidth - 1 - (flagged ? COUNTRY_FLAG_CELLS : 0))}
             </Text>
           </Box>
           <RatioBar ratio={row.ratio} width={barWidth} color={color} track />

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

@@ -13,7 +13,8 @@ import { useAsyncResource } from "../../../react/async-resource";
 import { useAutoRefresh } from "../../../react/auto-refresh";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
-import { Box, TextAttributes } from "../../../ui";
+import { Box, TextAttributes, useUiCapabilities } from "../../../ui";
+import { withCountryFlag, withFlagRoom } from "../../../components/ui/country-flag";
 import { usePluginPaneState } from "../../runtime";
 import { fetchBalances } from "./client";
 import {
@@ -39,11 +40,16 @@ export function JodiPane({ focused, width, height }: PaneProps) {
   const balances = resource.data;
   const gas = balances?.gas ?? null;
   const [storedTab, setTab] = usePluginPaneState<string>("commodity", "oil");
-  const tab: BalanceCommodity = gas && storedTab === "gas" ? "gas" : "oil";
+  const tab: BalanceCommodity = storedTab === "gas" ? "gas" : "oil";
   const board = tab === "gas" ? gas : balances?.oil ?? null;
   const rows = board?.rows ?? EMPTY_ROWS;
   const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
-  const columns = useMemo(() => balanceColumns(tab), [tab]);
+  // The desktop and the web lead each country with its flag.
+  const flagged = useUiCapabilities().nativePaneChrome === true;
+  const columns = useMemo(
+    () => balanceColumns(tab).map((column) => (column.id === "country" ? withFlagRoom(column, flagged) : column)),
+    [flagged, tab],
+  );
   const refresh = useCallback(() => {
     resource.reload();
   }, [resource.reload]);
@@ -54,7 +60,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
   const selectTab = useCallback((value: string) => {
     setTab(value === "gas" ? "gas" : "oil");
   }, [setTab]);
-  const { strip: tabs, rows: tabRows } = usePaneTabs(gas ? {
+  const { strip: tabs, rows: tabRows } = usePaneTabs({
     tabs: TABS,
     activeValue: tab,
     onSelect: selectTab,
@@ -62,7 +68,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
     compact: true,
     variant: "underline",
     queryBarWidth: width,
-  } : null);
+  });
   const info = useMemo(
     () => (resource.error || !board ? [] : [{ id: "month", parts: [{ text: formatBalanceMonth(board.month) }] }]),
     [board, resource.error],
@@ -84,7 +90,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
     });
     switch (column.id) {
       case "country":
-        return { text: row.country, color: colors.textBright, attributes: TextAttributes.BOLD };
+        return withCountryFlag({ text: row.country, color: colors.textBright, attributes: TextAttributes.BOLD }, row.country, flagged);
       case "month":
         return { text: row.month ? formatBalanceMonth(row.month) : "—", value: row.month, color: colors.textMuted };
       case "production":
@@ -102,7 +108,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
       default:
         return { text: "" };
     }
-  }, [colors]);
+  }, [colors, flagged]);
 
   if (!balances) {
     return (
@@ -139,7 +145,7 @@ export function JodiPane({ focused, width, height }: PaneProps) {
         onRootKeyDown={onRootKeyDown}
         renderCell={renderCell}
         selectedTextOverridesCellColor
-        emptyStateTitle="No balances for this month."
+        emptyStateTitle={board ? "No balances for this month." : tab === "gas" ? "Gas balances unavailable." : "Oil balances unavailable."}
       />
     </Box>
   );

package/src/plugins/builtin/layout-manager/index.tsx

@@ -111,6 +111,7 @@ export const layoutManagerModule: PluginModule = {
       name: "Layouts",
       icon: "L",
       component: LayoutMarketplacePane,
+      reportFreshness: { status: "not-a-feed", basis: "layout listings" },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 118, height: 34 },

package/src/plugins/builtin/macro-day/headless.ts

@@ -1,8 +1,9 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { resolveHeadlessInstrument } from "../shared/headless-market-data";
 import { loadMacroDayEarnings, loadMacroDayHistory, loadMacroReleases, macroDayEarningsNotice } from "./client";
-import { macroDayEventLabel, projectMacroDays, type MacroDayStats } from "./model";
-import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, MACRO_RELEASE_SOURCES, staleMacroReleasesNotice } from "./releases";
+import { macroDayEventLabel, macroDayStats, matchesSurprise, projectMacroDays, type MacroDayStats } from "./model";
+import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, MACRO_RELEASE_SOURCES, MACRO_SURPRISE_LABELS, MACRO_SURPRISES, staleMacroReleasesNotice,
+  type MacroEventKind, type MacroSurprise } from "./releases";
 
 // A mean that rounds to zero reads 0.00%, never -0.00%.
 const percent = (value: unknown) => typeof value !== "number" ? "--" : /[1-9]/.test((value * 100).toFixed(2)) ? `${(value * 100).toFixed(2)}%` : "0.00%";
@@ -17,12 +18,16 @@ export const macroDayHeadless: HeadlessPaneDefinition<"bundle"> = {
   describe: (args) => `MDAY ${args.symbols[0] ?? ""}`,
   discovery: { screenshotReadiness: "live-dom", limitations: [
     "US listings; close-to-close on the release day.",
-    "Published CPI, jobs and FOMC days; sessions after the list's last covered day (releasesThrough) are left out.",
+    "Published CPI, jobs and FOMC days, and Brazil's IPCA days from Gloom Cloud; sessions after the list's last covered day (releasesThrough) are left out.",
+    "Actual, forecast and prior for the days Gloom Cloud has them (the US headlines from its kept economic calendar, IPCA from the central bank's SGS series); --surprise keeps the days that came in hot, cool or in line with the forecast.",
     "A release day that is also the reaction session of the company's own earnings report is marked earnings and left out of the release averages and the normal day.",
   ] },
   options: [
     { key: "release", type: "enum", values: [{ value: "all" }, ...MACRO_EVENT_KINDS.map((value) => ({ value }))], defaultValue: "all",
       description: "Release the pane lists", pluginState: { pluginId: "ticker-research", key: "release" } },
+    { key: "surprise", type: "enum", values: [{ value: "all" }, ...MACRO_SURPRISES.map((value) => ({ value }))], defaultValue: "all",
+      description: "Release days whose print came in above (hot), below (cool) or at (in-line) the forecast",
+      example: "--release cpi --surprise hot", pluginState: { pluginId: "ticker-research", key: "surprise" } },
     { key: "lookbackYears", type: "integer", minimum: 1, maximum: 5, defaultValue: 5, description: "Years of daily closes" },
   ],
   async load(args, ctx) {
@@ -35,17 +40,25 @@ export const macroDayHeadless: HeadlessPaneDefinition<"bundle"> = {
     const notes = [staleMacroReleasesNotice(releases), macroDayEarningsNotice(earnings)].filter((note): note is string => !!note);
     const row = (label: string, stats: MacroDayStats) => ({ label, ...stats });
     const release = String(args.options.release ?? "all");
-    const events = release === "all" ? model.events : model.events.filter((event) => event.kind === release);
+    const surprise = String(args.options.surprise ?? "all") as MacroSurprise | "all";
+    const events = model.events.filter((event) => (release === "all" || event.kind === release) && matchesSurprise(event, surprise));
+    // The days the filter keeps get a row of their own: how the name moved on hot CPI days.
+    const selected = surprise === "all" ? [] : [row(`${MACRO_SURPRISE_LABELS[surprise]} ${release === "all" ? "release"
+      : MACRO_EVENT_LABELS[release as MacroEventKind]}`, macroDayStats(events, model.normal.meanAbs))];
     return {
       sections: [
         { title: "By release", columns: [{ key: "label", header: "Day" }, { key: "count", header: "Days" },
           { key: "meanAbs", header: "Avg |move|", format: percent }, { key: "multiple", header: "vs normal", format: multiple },
           { key: "mean", header: "Avg move", format: percent }, { key: "hitRate", header: "Up", format: share }],
-        rows: [...MACRO_EVENT_KINDS.map((kind) => row(MACRO_EVENT_LABELS[kind], model.byKind[kind])),
-          row("Any release", model.allEvents), ...(model.earnings.count ? [row("Earnings", model.earnings)] : []), row("Normal day", model.normal)] },
+        rows: [...model.kinds.map((kind) => row(MACRO_EVENT_LABELS[kind], model.byKind[kind])), ...selected,
+          row(model.kinds.includes("ipca") ? "Any US release" : "Any release", model.allEvents), ...(model.earnings.count ? [row("Earnings", model.earnings)] : []), row("Normal day", model.normal)] },
         { title: "Release days", columns: [{ key: "date", header: "Date" }, { key: "event", header: "Release" },
+          { key: "actual", header: "Actual" }, { key: "forecast", header: "Forecast" }, { key: "prior", header: "Prior" },
+          { key: "surprise", header: "Surprise" },
           { key: "session", header: "Session" }, { key: "move", header: "Move", format: percent }, { key: "multiple", header: "vs normal", format: multiple }],
-        rows: events.map((event) => ({ ...event, event: macroDayEventLabel(event) })) },
+        rows: events.map(({ figures, ...event }) => ({ ...event, event: macroDayEventLabel(event), actual: figures?.actual ?? null,
+          forecast: figures?.forecast ?? null, prior: figures?.prior ?? null, surprise: figures?.surprise ?? null,
+          ...(figures ? { headline: figures.event } : {}) })) },
       ],
       complete: !history.stale && !earnings.stale && !history.error && !notes.length && model.events.length > 0,
       unavailableSymbols: model.events.length ? [] : [instrument.symbol],

package/src/plugins/builtin/macro-day/index.tsx

@@ -15,8 +15,9 @@ export const macroDayModule: PluginModule = {
   }],
   paneTemplates: [{ ...createTickerSurfacePaneTemplate({
     id: "macro-day-pane", paneId: "macro-day", label: "Macro-Day Reaction",
-    description: "How a name moves on CPI, jobs and FOMC days against a normal day: average move, direction, hit rate and every release day.",
-    keywords: ["mday", "macro day", "cpi day", "fomc day", "jobs day", "nfp", "payrolls", "event study", "release reaction"],
+    description: "How a name moves on CPI, jobs, FOMC and Brazil IPCA days against a normal day: average move, direction, hit rate, and every release day with its actual, forecast and prior.",
+    keywords: ["mday", "macro day", "cpi day", "fomc day", "jobs day", "nfp", "payrolls", "event study", "release reaction", "ipca",
+      "hot cpi", "cpi surprise", "release surprise"],
     shortcut: "MDAY", publicShare: true,
   }), headless: macroDayHeadless }],
   setup(ctx) { macroReleaseCache.attach(ctx.persistence); },

package/src/plugins/builtin/macro-day/model.ts

@@ -1,7 +1,8 @@
 import type { EarningsTiming } from "../../../api-client/earnings";
 import type { PricePoint } from "../../../types/financials";
 import { zonedDateTimeParts } from "../../../utils/zoned-date-time";
-import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, type MacroEventKind, type MacroRelease } from "./releases";
+import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, US_MACRO_EVENT_KINDS, type MacroEventKind, type MacroRelease, type MacroReleaseFigures,
+  type MacroSurprise } from "./releases";
 
 const DAY_MS = 86_400_000;
 /** Longest calendar gap between two closes that is still one session apart: Thursday to Monday over a Friday holiday. */
@@ -28,6 +29,8 @@ export interface MacroDayEvent {
   move: number;
   /** |move| over the normal day's average |move|. */
   multiple: number | null;
+  /** What the release came out with, when the list has it. */
+  figures: MacroReleaseFigures | null;
 }
 
 export interface MacroDayStats {
@@ -44,13 +47,19 @@ export interface MacroDayModel {
   symbol: string;
   /** Newest first. */
   events: MacroDayEvent[];
+  /** The kinds the list carries: the US releases, and IPCA when Gloom Cloud lists its days. */
+  kinds: MacroEventKind[];
   /** Without the earnings days. */
   byKind: Record<MacroEventKind, MacroDayStats>;
-  /** Every release day of the three kinds together, without the earnings days; a day with two releases counts once. */
+  /**
+   * Every US release day together, without the earnings days; a day with two
+   * releases counts once. IPCA days are summed up on their own only, so a US
+   * name's figures do not move with Brazil's calendar.
+   */
   allEvents: MacroDayStats;
-  /** Release days that are the ticker's earnings reaction, which no other figure counts; a day with two releases counts once. */
+  /** US release days that are the ticker's earnings reaction, which no other figure counts; a day with two releases counts once. */
   earnings: MacroDayStats;
-  /** Sessions with no release of the three kinds, and none of the earnings days among them. */
+  /** Sessions with no US release, and none of the earnings days among them. */
   normal: MacroDayStats;
   start: string | null;
   asOf: string | null;
@@ -70,6 +79,15 @@ function sessionDate(time: number): string {
 const dayNumber = (date: string) => Date.parse(`${date}T00:00:00Z`) / DAY_MS;
 const isWeekday = (date: string) => { const day = new Date(`${date}T00:00:00Z`).getUTCDay(); return day > 0 && day < 6; };
 
+/** The figures over some of the model's release days (the hot CPI days): their moves, the earnings days left out as the kinds' are. */
+export function macroDayStats(events: readonly MacroDayEvent[], normalAbs: number | null): MacroDayStats {
+  return stats(events.filter((event) => !event.earnings).map((event) => event.move), normalAbs);
+}
+
+/** Whether a release day's print matches a surprise filter; `all` matches every day, figures or not. */
+export const matchesSurprise = (event: Pick<MacroDayEvent, "figures">, surprise: MacroSurprise | "all") =>
+  surprise === "all" || event.figures?.surprise === surprise;
+
 function stats(moves: number[], normalAbs: number | null): MacroDayStats {
   if (!moves.length) return { count: 0, meanAbs: null, mean: null, hitRate: null, multiple: null };
   const meanAbs = moves.reduce((sum, move) => sum + Math.abs(move), 0) / moves.length;
@@ -99,6 +117,8 @@ function earningsReactionSessions(reports: readonly MacroDayEarningsReport[], se
   return reacted;
 }
 
+const US_KINDS: ReadonlySet<MacroEventKind> = new Set(US_MACRO_EVENT_KINDS);
+
 /**
  * Close to close on the release day: 8:30 ET releases land before the open
  * and 14:00 FOMC statements before the close, so the release day's close
@@ -129,7 +149,8 @@ export function projectMacroDays(history: readonly PricePoint[], options: {
   const sessions = [...byDate.keys()].sort();
   const last = sessions.at(-1) ?? null;
   const empty = (): MacroDayStats => stats([], null);
-  if (!last) return { symbol: options.symbol, events: [], byKind: { cpi: empty(), jobs: empty(), fomc: empty() },
+  const kinds = MACRO_EVENT_KINDS.filter((kind) => US_KINDS.has(kind) || options.releases.some((release) => release.kind === kind));
+  if (!last) return { symbol: options.symbol, events: [], kinds, byKind: { cpi: empty(), jobs: empty(), fomc: empty(), ipca: empty() },
     allEvents: empty(), earnings: empty(), normal: empty(), start: null, asOf: null };
 
   // Sessions after the published lists end may be unlisted release days, so they are left out of both sides.
@@ -157,8 +178,8 @@ export function projectMacroDays(history: readonly PricePoint[], options: {
     const session = sessions[at]!;
     const move = moves.get(session);
     if (move == null || (session !== release.date && skipsAnotherWeekday(release.date, sessions[at - 1]!, session))) continue;
-    reactionSessions.add(session);
-    found.push({ kind: release.kind, date: release.date, session, move });
+    if (US_KINDS.has(release.kind)) reactionSessions.add(session);
+    found.push({ kind: release.kind, date: release.date, session, move, figures: release.figures ?? null });
   }
 
   const normalMoves = [...moves].filter(([date]) => !reactionSessions.has(date)).map(([, move]) => move);
@@ -170,7 +191,7 @@ export function projectMacroDays(history: readonly PricePoint[], options: {
   const byKind = Object.fromEntries(MACRO_EVENT_KINDS.map((kind) =>
     [kind, stats(events.filter((event) => event.kind === kind && !event.earnings).map((event) => event.move), normalAbs)])) as Record<MacroEventKind, MacroDayStats>;
   const sessionMoves = (flagged: boolean) => [...reactionSessions].filter((session) => reacted.has(session) === flagged).map((session) => moves.get(session)!);
-  return { symbol: options.symbol, events, byKind, allEvents: stats(sessionMoves(false), normalAbs), earnings: stats(sessionMoves(true), normalAbs),
+  return { symbol: options.symbol, events, kinds, byKind, allEvents: stats(sessionMoves(false), normalAbs), earnings: stats(sessionMoves(true), normalAbs),
     normal, start, asOf: end };
 }