gloomberb 0.18.3 → 0.18.4

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 {
@@ -43,7 +44,12 @@ export function JodiPane({ focused, width, height }: PaneProps) {
   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]);
@@ -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 (

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 };
 }
 

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

@@ -2,6 +2,8 @@ import { useCallback, useEffect, useMemo, useRef } from "react";
 import { DataTableView, EmptyState, PaneStatusBody, QueryBar, StatGrid, statGridRows, usePaneFooter, usePaneNoticeFooter,
   usePaneTicker, type DataTableCell, type DataTableColumn, type StatItem } from "../../../components";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
+import { tableColumnWidth } from "../../../components/ui/table-layout";
+import { displayWidth } from "../../../utils/format";
 import { instrumentFromTicker } from "../../../market-data/request-types";
 import { usePaneSettingValue, usePluginPaneState } from "../../../public/react";
 import { useAsyncResource } from "../../../react/async-resource";
@@ -10,11 +12,13 @@ import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
 import { Box } from "../../../ui";
 import { loadMacroDayEarnings, loadMacroDayHistory, loadMacroReleases, macroDayEarningsNotice } from "./client";
-import { macroDayEventLabel, projectMacroDays, type MacroDayEvent, type MacroDayModel } from "./model";
-import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, staleMacroReleasesNotice, type MacroEventKind } from "./releases";
+import { macroDayEventLabel, macroDayStats, matchesSurprise, projectMacroDays, type MacroDayEvent, type MacroDayModel } from "./model";
+import { MACRO_EVENT_KINDS, MACRO_EVENT_LABELS, MACRO_SURPRISE_LABELS, MACRO_SURPRISES, staleMacroReleasesNotice, type MacroEventKind,
+  type MacroSurprise } from "./releases";
 
 export const LOOKBACK_OPTIONS = [{ value: "1", label: "1Y" }, { value: "2", label: "2Y" }, { value: "3", label: "3Y" }, { value: "5", label: "5Y" }];
 const RELEASE_OPTIONS = [{ value: "all", label: "All" }, ...MACRO_EVENT_KINDS.map((kind) => ({ value: kind, label: MACRO_EVENT_LABELS[kind] }))];
+const SURPRISE_OPTIONS = [{ value: "all", label: "All" }, ...MACRO_SURPRISES.map((surprise) => ({ value: surprise, label: MACRO_SURPRISE_LABELS[surprise] }))];
 
 function pct(value: number | null | undefined, signed = true): string {
   if (value == null) return "--";
@@ -29,21 +33,45 @@ const MOVE: DataTableColumn[] = [
   { id: "move", label: "Move", width: 9, align: "right" },
   { id: "multiple", label: "vs Normal", width: 10, align: "right" },
 ];
+/** What each release came out with, under the labels the economic calendar gives them. */
+const FIGURES = [["actual", "Actual"], ["forecast", "Forecast"], ["prior", "Prior"]] as const;
+
+/** The figure columns, shown once any listed day has figures, each as wide as its header and its widest value. */
+function figureColumns(rows: readonly MacroDayEvent[]): DataTableColumn[] {
+  if (!rows.some((event) => event.figures)) return [];
+  return FIGURES.map(([id, label]) => ({ id, label, align: "right", width: tableColumnWidth({ label,
+    width: Math.max(6, ...rows.map((event) => displayWidth(event.figures?.[id] ?? ""))) }) }));
+}
 
 /**
  * With every release listed, the release's name, widened to take the earnings marker where a row has one. With one
  * selected, a column only for the marker: every row would repeat the name.
  */
-function columnsFor(release: string, rows: readonly MacroDayEvent[]): DataTableColumn[] {
+export function columnsFor(release: string, rows: readonly MacroDayEvent[]): DataTableColumn[] {
   const marked = rows.some((event) => event.earnings);
-  if (release === "all") return [DATE, { id: "release", label: "Release", width: marked ? 15 : 8, align: "left" }, ...MOVE];
-  return marked ? [DATE, { id: "release", label: "Note", width: EARNINGS_MARK.length, align: "left" }, ...MOVE] : [DATE, ...MOVE];
+  const values = [...figureColumns(rows), ...MOVE];
+  if (release === "all") return [DATE, { id: "release", label: "Release", width: marked ? 15 : 8, align: "left" }, ...values];
+  return marked ? [DATE, { id: "release", label: "Note", width: EARNINGS_MARK.length, align: "left" }, ...values] : [DATE, ...values];
+}
+
+const tone = (value: number | null) => value == null ? undefined : value >= 0 ? "positive" as const : "negative" as const;
+
+/** The figures over the days a surprise filter keeps: the same four as one release's. */
+function surpriseFigures(model: MacroDayModel, rows: readonly MacroDayEvent[]): StatItem[] {
+  const stats = macroDayStats(rows, model.normal.meanAbs);
+  return [
+    { id: "abs", label: "Avg |move|", value: pct(stats.meanAbs, false), detail: stats.count ? `${times(stats.multiple)} normal` : undefined },
+    { id: "mean", label: "Avg move", value: pct(stats.mean), tone: tone(stats.mean) },
+    { id: "up", label: "Up", value: stats.hitRate == null ? "--" : `${Math.round(stats.hitRate * 100)}%`,
+      detail: stats.count ? `${Math.round(stats.hitRate! * stats.count)} of ${stats.count}` : undefined },
+    { id: "normal", label: "Normal day", value: pct(model.normal.meanAbs, false), detail: "avg |move|" },
+  ];
 }
 
 function figures(model: MacroDayModel, release: string): StatItem[] {
   const normal: StatItem = { id: "normal", label: "Normal day", value: pct(model.normal.meanAbs, false), detail: "avg |move|" };
   if (release === "all") {
-    return [...MACRO_EVENT_KINDS.map((kind): StatItem => {
+    return [...model.kinds.map((kind): StatItem => {
       const stats = model.byKind[kind];
       return { id: kind, label: `${MACRO_EVENT_LABELS[kind]} day`, value: pct(stats.meanAbs, false),
         detail: stats.count ? `${times(stats.multiple)} normal` : undefined };
@@ -51,7 +79,6 @@ function figures(model: MacroDayModel, release: string): StatItem[] {
       detail: `${times(model.earnings.multiple)} normal` }] : []), normal];
   }
   const stats = model.byKind[release as MacroEventKind];
-  const tone = (value: number | null) => value == null ? undefined : value >= 0 ? "positive" as const : "negative" as const;
   return [
     { id: "abs", label: "Avg |move|", value: pct(stats.meanAbs, false), detail: stats.count ? `${times(stats.multiple)} normal` : undefined },
     { id: "mean", label: "Avg move", value: pct(stats.mean), tone: tone(stats.mean) },
@@ -66,6 +93,7 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
   const { symbol, ticker, error: identityError } = usePaneTicker();
   const [lookback, setLookback] = usePaneSettingValue("lookbackYears", "5");
   const [release, setRelease] = usePluginPaneState("release", "all");
+  const [surprise, setSurprise] = usePluginPaneState<MacroSurprise | "all">("surprise", "all");
   const [selectedRow, setSelectedRow] = usePluginPaneState<string | null>("selectedRow", null);
   const instrument = instrumentFromTicker(ticker, symbol);
   const instrumentKey = JSON.stringify(instrument);
@@ -88,8 +116,10 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
   [history.data, lookback, symbol]);
   const releasesNotice = history.data ? staleMacroReleasesNotice(history.data.releases) : null;
   const earningsNotice = history.data ? macroDayEarningsNotice(history.data.earnings) : null;
-  const rows = useMemo(() => model ? model.events.filter((event) => release === "all" || event.kind === release) : [], [model, release]);
-  const stats = useMemo(() => model?.events.length ? figures(model, release) : [], [model, release]);
+  const rows = useMemo(() => model ? model.events.filter((event) => (release === "all" || event.kind === release)
+    && matchesSurprise(event, surprise)) : [], [model, release, surprise]);
+  const stats = useMemo(() => !model?.events.length ? [] : surprise === "all" ? figures(model, release) : surpriseFigures(model, rows),
+    [model, release, surprise, rows]);
   const columns = useMemo(() => columnsFor(release, rows), [release, rows]);
 
   usePaneNoticeFooter({ registrationId: "macro-day-notices", focused,
@@ -103,6 +133,11 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
   const renderCell = useCallback((event: MacroDayEvent, column: DataTableColumn): DataTableCell => {
     if (column.id === "date") return { text: event.session === event.date ? event.date : `${event.date} → ${event.session.slice(5)}`, value: event.date };
     if (column.id === "release") return { text: release === "all" ? macroDayEventLabel(event) : event.earnings ? EARNINGS_MARK : "" };
+    // The print colored against the consensus, as the economic calendar colors it.
+    if (column.id === "actual") return { text: event.figures?.actual ?? "", color: event.figures?.surprise === "hot" ? colors.positive
+      : event.figures?.surprise === "cool" ? colors.negative : undefined };
+    if (column.id === "forecast") return { text: event.figures?.forecast ?? "" };
+    if (column.id === "prior") return { text: event.figures?.prior ?? "" };
     if (column.id === "move") return { text: pct(event.move), value: event.move * 100,
       color: event.move > 0 ? colors.positive : event.move < 0 ? colors.negative : undefined };
     return { text: times(event.multiple), value: event.multiple };
@@ -114,6 +149,7 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
   return <Box width={width} height={height} flexDirection="column" overflow="hidden">
     <QueryBar width={width} filters={[
       { id: "release", label: "Release", value: release, options: RELEASE_OPTIONS, onChange: setRelease, inline: true },
+      { id: "surprise", label: "Surprise", value: surprise, options: SURPRISE_OPTIONS, onChange: (value) => setSurprise(value as MacroSurprise | "all") },
       { id: "lookback", label: "Lookback", value: String(lookback), options: LOOKBACK_OPTIONS, onChange: setLookback },
     ]} />
     {!symbol ? <EmptyState title="Select a ticker." /> : <PaneStatusBody subject="macro-day moves" loading={history.loading && !model}
@@ -121,7 +157,7 @@ export function MacroDayPane({ width, height, focused }: PaneProps) {
       {model ? <>
         <StatGrid items={stats} width={width} />
         <DataTableView<MacroDayEvent> focused={focused} columns={columns} items={rows} rootWidth={width} rootHeight={contentHeight}
-          getItemKey={key} emptyStateTitle="No release days." sortColumnId={null} sortDirection="desc" selectedTextOverridesCellColor
+          getItemKey={key} emptyStateTitle={surprise === "all" ? "No release days." : `No ${MACRO_SURPRISE_LABELS[surprise].toLowerCase()} prints.`} sortColumnId={null} sortDirection="desc" selectedTextOverridesCellColor
           selection={{ kind: "id", selectedId: selectedRow, getId: key, onChange: (id) => setSelectedRow(id) }}
           getExportMetadata={() => [["symbol", model.symbol], ["from", model.start ?? ""], ["to", model.asOf ?? ""],
             ["units", "percent, close to close on the release day"]]}

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

@@ -1,27 +1,47 @@
-// Published US release days, not a rule engine: the dates each release came
+// Published release days, not a rule engine: the dates each release came
 // out, read from the publishers' own archives. A release cancelled or moved (the
 // 2025 shutdown) is as published, and a scheduled date is not a release day
-// until it is out. Dates are New York calendar days.
+// until it is out. Dates are New York calendar days. Brazil's IPCA days come
+// from Gloom Cloud only; the list the app ships with has the US releases.
 import { zonedDateKey } from "../../../utils/zoned-date-time";
 import { MACRO_RELEASE_TABLE } from "./release-table";
 
-export type MacroEventKind = "cpi" | "jobs" | "fomc";
+/** The US releases the bundled list carries, and the ones HIVG reads around. */
+export type UsMacroEventKind = "cpi" | "jobs" | "fomc";
+export type MacroEventKind = UsMacroEventKind | "ipca";
 
-export const MACRO_EVENT_KINDS: readonly MacroEventKind[] = ["cpi", "jobs", "fomc"];
+export const US_MACRO_EVENT_KINDS: readonly UsMacroEventKind[] = ["cpi", "jobs", "fomc"];
+export const MACRO_EVENT_KINDS: readonly MacroEventKind[] = [...US_MACRO_EVENT_KINDS, "ipca"];
 
-export const MACRO_EVENT_LABELS: Record<MacroEventKind, string> = { cpi: "CPI", jobs: "Jobs", fomc: "FOMC" };
+export const MACRO_EVENT_LABELS: Record<MacroEventKind, string> = { cpi: "CPI", jobs: "Jobs", fomc: "FOMC", ipca: "IPCA" };
 
-/** BLS news release archives for CPI and the Employment Situation, and the Federal Reserve's meeting calendar. */
+/** BLS news release archives for CPI and the Employment Situation, the Federal Reserve's meeting calendar, IBGE's calendar. */
 export const MACRO_RELEASE_SOURCES: Record<MacroEventKind, string> = {
   cpi: "https://www.bls.gov/bls/news-release/cpi.htm",
   jobs: "https://www.bls.gov/bls/news-release/empsit.htm",
   fomc: "https://www.federalreserve.gov/monetarypolicy/fomccalendars.htm",
+  ipca: "https://www.ibge.gov.br/calendario-indicadores-novoportal.html",
 };
 
 /** A list more than this many days behind today says so: a release day may be missing from its end. */
 export const MACRO_RELEASES_STALE_DAYS = 14;
 
-export interface MacroRelease { kind: MacroEventKind; date: string }
+/** Above the consensus (hot), below it (cool), at it (in-line). */
+export type MacroSurprise = "hot" | "cool" | "in-line";
+export const MACRO_SURPRISES: readonly MacroSurprise[] = ["hot", "cool", "in-line"];
+export const MACRO_SURPRISE_LABELS: Record<MacroSurprise, string> = { hot: "Hot", cool: "Cool", "in-line": "In line" };
+
+/** What a release day came out with: the headline, its print, the consensus before it and the figure before that. */
+export interface MacroReleaseFigures {
+  /** The headline the figures are for: "Inflation Rate YoY", "IPCA m/m". */
+  event: string;
+  actual: string | null;
+  forecast: string | null;
+  prior: string | null;
+  surprise: MacroSurprise | null;
+}
+
+export interface MacroRelease { kind: MacroEventKind; date: string; figures?: MacroReleaseFigures }
 
 export interface MacroReleaseList {
   /** Oldest first. */
@@ -37,29 +57,51 @@ const byDate = (left: MacroRelease, right: MacroRelease) => left.date.localeComp
 
 /** The list the app ships with: the floor whenever the server's list is missing or older. */
 export function bundledMacroReleases(): MacroReleaseList {
-  const releases = MACRO_EVENT_KINDS.flatMap((kind) => Object.entries(MACRO_RELEASE_TABLE.days[kind]).flatMap(([year, days]) =>
+  const releases = US_MACRO_EVENT_KINDS.flatMap((kind) => Object.entries(MACRO_RELEASE_TABLE.days[kind]).flatMap(([year, days]) =>
     days.map((day) => ({ kind, date: `${year}-${day}` }))));
   return { releases: releases.sort(byDate), coveredThrough: MACRO_RELEASE_TABLE.coveredThrough };
 }
 
+const text = (value: unknown) => typeof value === "string" && value.trim() ? value.trim() : null;
+
+/** A day's figures as served, or undefined when they break the contract. */
+function servedFigures(value: unknown): MacroReleaseFigures | undefined {
+  const figures = value as Partial<Record<keyof MacroReleaseFigures, unknown>> | null;
+  const event = text(figures?.event);
+  if (!event) return undefined;
+  const surprise = MACRO_SURPRISES.find((candidate) => candidate === figures?.surprise) ?? null;
+  return { event, actual: text(figures?.actual), forecast: text(figures?.forecast), prior: text(figures?.prior), surprise };
+}
+
 /**
  * The served list extends the floor past its end; the floor keeps its own
- * days up to there. A served list that breaks the contract, or ends no later
- * than the floor, adds nothing.
+ * days up to there. IPCA, which the floor does not carry, is the served list's
+ * through its end, and left out when the server lists none. Every day takes
+ * the figures the server has for it. A served list that breaks the contract,
+ * or ends no later than the floor, adds nothing.
  */
 export function mergeMacroReleases(floor: MacroReleaseList, served: unknown): MacroReleaseList {
-  const payload = served as { coveredThrough?: unknown; releases?: Partial<Record<MacroEventKind, unknown>> } | null;
+  const payload = served as { coveredThrough?: unknown; releases?: Partial<Record<MacroEventKind, unknown>>;
+    figures?: Partial<Record<MacroEventKind, Record<string, unknown>>> } | null;
   const coveredThrough = payload?.coveredThrough;
   if (!isDate(coveredThrough) || coveredThrough <= floor.coveredThrough) return floor;
   const later: MacroRelease[] = [];
-  for (const kind of MACRO_EVENT_KINDS) {
+  for (const kind of US_MACRO_EVENT_KINDS) {
     const dates = payload?.releases?.[kind];
     if (!Array.isArray(dates) || !dates.every(isDate)) return floor;
     for (const date of new Set(dates)) {
       if (date > floor.coveredThrough && date <= coveredThrough) later.push({ kind, date });
     }
   }
-  return { releases: [...floor.releases, ...later].sort(byDate), coveredThrough };
+  const ipca = payload?.releases?.ipca;
+  if (Array.isArray(ipca) && ipca.every(isDate)) {
+    for (const date of new Set(ipca)) if (date <= coveredThrough) later.push({ kind: "ipca", date });
+  }
+  const figuresOf = (release: MacroRelease): MacroRelease => {
+    const figures = servedFigures(payload?.figures?.[release.kind]?.[release.date]);
+    return figures ? { ...release, figures } : release;
+  };
+  return { releases: [...floor.releases, ...later].map(figuresOf).sort(byDate), coveredThrough };
 }
 
 /** Whole days from the list's last covered day to today in New York. */

package/src/plugins/builtin/market-heatmap/data.ts

@@ -31,7 +31,14 @@ export interface MarketHeatmapBoard extends MarketHeatmapResult {
 const DEFAULT_COUNT = 80;
 /** The most names one board asks for; a server that serves fewer answers with its own maximum. */
 const MAX_MARKET_HEATMAP_COUNT = 500;
-const CACHE_TTL_MS = 60_000;
+/**
+ * How often a board is worth checking again: a real-time board's live read
+ * is renewed every 15 seconds on the server, a delayed board's snapshot is
+ * cached there for a minute.
+ */
+export function heatmapCheckIntervalMs(board: Pick<MarketHeatmapResult, "access"> | null | undefined): number {
+  return board?.access === "realtime" ? 15_000 : 60_000;
+}
 const activeFetches = new Map<string, Promise<MarketHeatmapBoard>>();
 const memoryCache = new Map<string, { expiresAt: number; result: MarketHeatmapBoard }>();
 
@@ -90,7 +97,7 @@ export async function fetchMarketHeatmap(
   const fetchPromise = loadMarketHeatmap(universe, count, sources)
     .then((result) => {
       if (useCache) {
-        memoryCache.set(cacheKey, { result, expiresAt: Date.now() + CACHE_TTL_MS });
+        memoryCache.set(cacheKey, { result, expiresAt: Date.now() + heatmapCheckIntervalMs(result) });
       }
       return result;
     })

package/src/plugins/builtin/market-heatmap/evidence.ts

@@ -1,5 +1,5 @@
 /**
- * What `gloomberb shot HM` certifies: the tab the heat map drew, what its tiles
+ * What `gloom shot HM` certifies: the tab the heat map drew, what its tiles
  * are sized by, how many tiles and sectors are plotted, and whether its
  * snapshot had loaded. The heat map has
  * no table rows or labeled values, so this is how a capture counts as data.