gloomberb 0.18.4 → 0.19.0

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

@@ -2,40 +2,31 @@ import type { FundMember } from "../../../api-client/members";
 import type { Portfolio, Watchlist } from "../../../types/ticker";
 import { getSectorCollection } from "../sectors/sector-data";
 
-/**
- * The fund whose holdings name each company's GICS sector: the S&P 500's, as
- * MEMB reads it. A Select Sector SPDR holds the S&P 500's companies of one
- * sector, so its members are these holdings in that sector.
- */
-export const SECTOR_HOLDINGS_FUND = "IVV";
+/** Focused industries, named by the fund whose published holdings define the group. */
+const INDUSTRIES = [
+  { etf: "SOXX", name: "Semiconductors" },
+  { etf: "XPH", name: "Pharmaceuticals" },
+  { etf: "XBI", name: "Biotech" },
+  { etf: "ITA", name: "Aerospace & defense" },
+  { etf: "KRE", name: "Regional banks" },
+  { etf: "IGV", name: "Software" },
+  { etf: "XRT", name: "Retail" },
+  { etf: "XHB", name: "Homebuilders" },
+  { etf: "XOP", name: "Oil & gas exploration" },
+] as const;
 
-/** The GICS sector each of SECT's sector funds holds, as the S&P 500's holdings name it. */
-const SECTOR_OF_FUND: Readonly<Record<string, readonly string[]>> = {
-  XLK: ["Information Technology"],
-  XLV: ["Health Care"],
-  XLF: ["Financials"],
-  XLY: ["Consumer Discretionary"],
-  // The holdings file says "Communication"; GICS's own name is the longer one.
-  XLC: ["Communication", "Communication Services"],
-  XLI: ["Industrials"],
-  XLP: ["Consumer Staples"],
-  XLE: ["Energy"],
-  XLU: ["Utilities"],
-  XLRE: ["Real Estate"],
-  XLB: ["Materials"],
-};
-
-/** Which companies ERN lists: the market's, the user's, one portfolio or watchlist, or one sector fund's. */
+/** Which companies ERN lists: the market, the user's lists, or a fund's holdings. */
 export type EarningsScope =
   | { kind: "all" }
   | { kind: "mine" }
   | { kind: "portfolio" | "watchlist"; id: string; name: string }
-  | { kind: "sector"; etf: string; name: string; sectors: readonly string[] };
+  | { kind: "fund"; etf: string; name: string };
 
 export interface EarningsScopeOption {
   value: string;
   label: string;
   description?: string;
+  group?: string;
   scope: EarningsScope;
 }
 
@@ -47,30 +38,28 @@ export const MINE_SCOPE = "mine";
 const kindNote = (name: string, kind: "Portfolio" | "Watchlist") =>
   name.toLowerCase().includes(kind.toLowerCase()) ? undefined : kind;
 
-/**
- * The choices of ERN's Names filter, in menu order: the market, every held or
- * watched name, each portfolio and watchlist, then SECT's sector funds, each
- * named with its fund ("Technology (XLK)").
- */
+/** Personal lists, broad sectors and focused industries stay separate in the Names menu. */
 export function earningsScopeOptions(collections: { portfolios: readonly Portfolio[]; watchlists: readonly Watchlist[] }): EarningsScopeOption[] {
   return [
     { value: ALL_SCOPE, label: "All", scope: { kind: "all" } },
     { value: MINE_SCOPE, label: "Mine", description: "Portfolios and watchlists", scope: { kind: "mine" } },
     ...collections.portfolios.map((portfolio): EarningsScopeOption => ({
-      value: `portfolio:${portfolio.id}`, label: portfolio.name, description: kindNote(portfolio.name, "Portfolio"),
+      value: `portfolio:${portfolio.id}`, label: portfolio.name, description: kindNote(portfolio.name, "Portfolio"), group: "Your lists",
       scope: { kind: "portfolio", id: portfolio.id, name: portfolio.name },
     })),
     ...collections.watchlists.map((watchlist): EarningsScopeOption => ({
-      value: `watchlist:${watchlist.id}`, label: watchlist.name, description: kindNote(watchlist.name, "Watchlist"),
+      value: `watchlist:${watchlist.id}`, label: watchlist.name, description: kindNote(watchlist.name, "Watchlist"), group: "Your lists",
       scope: { kind: "watchlist", id: watchlist.id, name: watchlist.name },
     })),
-    ...getSectorCollection("sectors").items.flatMap((sector): EarningsScopeOption[] => {
-      const sectors = SECTOR_OF_FUND[sector.etf];
-      return sectors ? [{
-        value: `sector:${sector.etf}`, label: `${sector.name} (${sector.etf})`,
-        scope: { kind: "sector", etf: sector.etf, name: sector.name, sectors },
-      }] : [];
-    }),
+    ...getSectorCollection("sectors").items.map((sector): EarningsScopeOption => ({
+      // Keep the saved sector choice when switching to that fund's own holdings.
+      value: `sector:${sector.etf}`, label: `${sector.name} (${sector.etf})`, group: "Sectors",
+      scope: { kind: "fund", etf: sector.etf, name: sector.name },
+    })),
+    ...INDUSTRIES.map((industry): EarningsScopeOption => ({
+      value: `industry:${industry.etf}`, label: `${industry.name} (${industry.etf})`, group: "Industries",
+      scope: { kind: "fund", etf: industry.etf, name: industry.name },
+    })),
   ];
 }
 
@@ -79,11 +68,10 @@ export function readEarningsScope(value: string, options: readonly EarningsScope
   return options.find((option) => option.value === value) ?? options[0]!;
 }
 
-/** A sector fund's companies: the S&P 500's holdings in its sector, largest weight first. */
-export function sectorSymbols(members: readonly FundMember[], sectors: readonly string[]): string[] {
-  const symbols = members
-    .filter((member) => member.symbol && member.sector && sectors.includes(member.sector))
+/** A fund's companies, largest weight first; cash and other unlisted holdings have no symbol. */
+export function fundSymbols(members: readonly FundMember[]): string[] {
+  const symbols = [...members]
     .sort((left, right) => (right.weight ?? 0) - (left.weight ?? 0))
-    .map((member) => member.symbol!.trim().toUpperCase());
+    .flatMap((member) => member.symbol?.trim() ? [member.symbol.trim().toUpperCase()] : []);
   return [...new Set(symbols)];
 }

package/src/plugins/builtin/earnings-calls/calendar.tsx

@@ -29,7 +29,7 @@ import { usePluginPaneState } from "../../runtime";
 import { newYorkToday } from "../earnings/board-model";
 import { ProWall, SignInWall } from "../cloud/auth-actions";
 import { cachedUpcomingCalls, calendarAway, loadUpcomingCalls, statusOf, upcomingCutNotice, type UpcomingCallsResult } from "./data";
-import { formatPeriod } from "./format";
+import { callPeriod } from "./format";
 import {
   calendarDays,
   calendarSections,
@@ -106,7 +106,7 @@ function renderCalendarCell(row: CalendarRow, column: CalendarColumn, now: numbe
       return clock ? { text: clock, color: tone(colors.textDim) } : { text: MISSING, color: colors.textMuted };
     }
     case "period":
-      return { text: formatPeriod(call.fiscalYear, call.fiscalQuarter), color: tone(colors.textDim) };
+      return { text: callPeriod(call), color: tone(colors.textDim) };
     case "away":
       return { text: calendarAway(call, now), color: over ? colors.textMuted : colors.textBright };
   }

package/src/plugins/builtin/earnings-calls/format.ts

@@ -2,7 +2,7 @@ import type { CloudEarningsCallPayload } from "../../../api-client";
 import { formatShortDate } from "../../../utils/datetime-format";
 
 /** "FQ4 26" — fiscal period, compact enough for a table column. */
-export function formatPeriod(
+function formatPeriod(
   fiscalYear: number | null,
   fiscalQuarter: number | null,
 ): string {
@@ -36,8 +36,37 @@ export function formatTimestamp(seconds: number): string {
   return `${minutes}:${String(remainder).padStart(2, "0")}`;
 }
 
+type NamedCall = Pick<
+  CloudEarningsCallPayload,
+  "ticker" | "fiscalYear" | "fiscalQuarter" | "eventKind" | "eventLabel"
+>;
+
+/** An event that is not an earnings call (a deal call, an investor day), shown by its label and never as a quarter. */
+export function eventLabelOf(call: Omit<NamedCall, "ticker">): string | null {
+  return call.eventKind === "other" && call.eventLabel ? call.eventLabel : null;
+}
+
+// Fits the period column; the full label is in the detail title.
+const SHORT_EVENT_LABELS: Record<string, string> = {
+  "M&A call": "M&A",
+  conference: "Conf",
+  "investor day": "Inv day",
+  "business update": "Update",
+  "trial results": "Trial",
+  "shareholder call": "Holders",
+};
+
+/** The period column: "FQ4 26", or a short event label ("M&A", "Inv day"). */
+export function callPeriod(call: Omit<NamedCall, "ticker">): string {
+  const label = eventLabelOf(call);
+  if (label) return SHORT_EVENT_LABELS[label] ?? label;
+  return formatPeriod(call.fiscalYear, call.fiscalQuarter);
+}
+
 /** Title for the detail stack: names the call so the body need not repeat it. */
-export function callTitle(call: CloudEarningsCallPayload): string {
+export function callTitle(call: NamedCall): string {
+  const label = eventLabelOf(call);
+  if (label) return `${call.ticker} ${label}`;
   const period = formatPeriod(call.fiscalYear, call.fiscalQuarter);
   return period === "—" ? call.ticker : `${call.ticker} ${period}`;
 }

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

@@ -23,7 +23,7 @@ import {
   type UpcomingCallsResult,
   type UpcomingDays,
 } from "./data";
-import { formatPeriod } from "./format";
+import { callPeriod, eventLabelOf } from "./format";
 import type { MarketDay } from "../earnings/board-model";
 import {
   calendarDays,
@@ -53,6 +53,7 @@ const CALL_COLUMNS = [
   { key: "callAt", header: "Call date" },
   { key: "fiscalYear", header: "FY", align: "right" as const },
   { key: "fiscalQuarter", header: "FQ", align: "right" as const },
+  { key: "event", header: "Event" },
   { key: "status", header: "Status" },
   { key: "durationSeconds", header: "Seconds", align: "right" as const },
   { key: "wordCount", header: "Words", align: "right" as const },
@@ -124,6 +125,8 @@ function callRow(call: CloudEarningsCallPayload, now: number) {
     callAt: call.callAt,
     fiscalYear: call.fiscalYear,
     fiscalQuarter: call.fiscalQuarter,
+    // A deal call, a conference, an investor day: not a quarter's earnings call.
+    event: eventLabelOf(call),
     status: call.hasTranscript ? "transcribed" : callStatusLabel(call, now) || call.status,
     upcoming,
     in: upcoming ? callCountdown(call, now) : null,
@@ -219,6 +222,7 @@ function transcriptResult(
       company: transcript.companyName,
       fiscalYear: transcript.fiscalYear,
       fiscalQuarter: transcript.fiscalQuarter,
+      event: eventLabelOf(transcript),
       callAt: transcript.callAt,
       durationSeconds: transcript.durationSeconds,
       wordCount: transcript.wordCount,
@@ -259,7 +263,8 @@ function projectCalendar(
     timeKnown: callTimeKnown(call),
     local: callLocalClock(call),
     newYork: callNewYorkClock(call),
-    period: formatPeriod(call.fiscalYear, call.fiscalQuarter),
+    period: callPeriod(call),
+    event: eventLabelOf(call),
     fiscalYear: call.fiscalYear,
     fiscalQuarter: call.fiscalQuarter,
     in: calendarAway(call, now),

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

@@ -3,6 +3,7 @@ import type {
   CloudEarningsTranscriptPayload,
   CloudTranscriptTurnPayload,
 } from "../../../api-client";
+import { eventLabelOf } from "./format";
 import { splitParagraphs } from "./prose";
 
 export type TranscriptSection =
@@ -210,7 +211,11 @@ export function findCallForQuarter(
 ): CloudEarningsCallPayload | null {
   const sorted = sortCallsNewest(calls);
   const token = requestedQuarter.trim().toUpperCase().replace(/[\s_-]+/g, "");
-  if (!token || token === "LATEST") return sorted[0] ?? null;
+  // The latest earnings call: a deal call or an investor day held after it is
+  // not the quarter's call, unless the company has nothing else.
+  if (!token || token === "LATEST") {
+    return sorted.find((call) => !eventLabelOf(call)) ?? sorted[0] ?? null;
+  }
 
   const quarterFirst = token.match(/^(?:F?Q)?([1-4])(?:\/?(\d{2}|\d{4}))?$/);
   if (quarterFirst) {

package/src/plugins/builtin/earnings-calls/pane.tsx

@@ -49,7 +49,7 @@ import {
   loadTranscript,
   statusOf,
 } from "./data";
-import { callTitle, formatCallDate, formatDuration, formatPeriod, formatSentiment } from "./format";
+import { callPeriod, callTitle, eventLabelOf, formatCallDate, formatDuration, formatSentiment } from "./format";
 import { findCallForQuarter, findInLines, MIN_FIND_LENGTH, turnParagraphs } from "./model";
 import { READER_TABS, TranscriptView, type ReaderTab, type TranscriptPlayback } from "./transcript-view";
 import { PLAYBACK_RATES, SEEK_STEP_SECONDS, useCallPlayback } from "./use-call-playback";
@@ -101,7 +101,7 @@ function renderCell(call: CloudEarningsCallPayload, column: CallColumn, now: num
     case "date":
       return { text: formatCallDate(call.callAt), color: colors.textDim };
     case "period":
-      return { text: formatPeriod(call.fiscalYear, call.fiscalQuarter) };
+      return { text: callPeriod(call) };
     case "length":
       return { text: formatDuration(call.durationSeconds), color: colors.textDim };
     case "sentiment": {
@@ -525,7 +525,8 @@ function CallsListView({
           [
             call.ticker,
             call.companyName ?? "",
-            formatPeriod(call.fiscalYear, call.fiscalQuarter),
+            callPeriod(call),
+            eventLabelOf(call) ?? "",
             formatCallDate(call.callAt),
           ]
             .join(" ")
@@ -1020,7 +1021,7 @@ function CallsListView({
         <AudioPlayer
           src={playback.audio.url}
           sourceKey={selected.id}
-          label={`${callTitle(selected)} call recording`}
+          label={`${callTitle(selected)}${eventLabelOf(selected) ? "" : " call"} recording`}
           durationSeconds={playback.audio.durationSeconds}
           rates={PLAYBACK_RATES}
           rate={playback.rate}

package/src/plugins/builtin/econ/calendar-model.ts

@@ -3,6 +3,7 @@ import type { DataTableColumn } from "../../../components";
 import { colors } from "../../../theme/colors";
 import { displayWidth } from "../../../utils/format";
 import { fetchEconCalendar } from "./calendar-source";
+import { parseEconFigure } from "./figures";
 import { isAllDayEvent, type EconEvent, type EconImpact } from "./types";
 
 const CACHE_KIND = "calendar";
@@ -172,6 +173,17 @@ export function matchesImpact(event: EconEvent, filter: ImpactFilter): boolean {
   return filter === "all" || event.impact === filter;
 }
 
+/**
+ * The releases of the region that the High filter, where the calendar opens,
+ * leaves out (most PMIs among them), for the footer and a report of the pane
+ * to count with the way to list them. None under All, and none under Medium
+ * or Low, which a reader picks to list one level.
+ */
+export function lowerImpactHidden(events: readonly EconEvent[], impact: ImpactFilter, country: CountryFilter): number {
+  if (impact !== "high") return 0;
+  return events.filter((event) => event.impact !== "high" && matchesCountry(event, country)).length;
+}
+
 const IMPACT_WORDS: Record<Exclude<ImpactFilter, "all">, string> = {
   high: "high-impact",
   medium: "medium-impact",
@@ -387,16 +399,9 @@ export function valueColumnWidth(events: readonly EconEvent[], key: "actual" | "
   return width;
 }
 
-function parseNumeric(value: string | null): number | null {
-  if (!value) return null;
-  const cleaned = value.replace(/[%,KMBTkmbts]/g, "").trim();
-  const n = parseFloat(cleaned);
-  return isNaN(n) ? null : n;
-}
-
 export function actualColor(actual: string | null, forecast: string | null): string {
-  const a = parseNumeric(actual);
-  const f = parseNumeric(forecast);
+  const a = parseEconFigure(actual)?.value ?? null;
+  const f = parseEconFigure(forecast)?.value ?? null;
   if (a === null || f === null) return colors.text;
   if (a > f) return colors.positive;
   if (a < f) return colors.negative;

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

@@ -0,0 +1,72 @@
+/**
+ * The figures of an economic calendar row as numbers. The calendar serves
+ * Actual, Forecast and Prior as the text a table prints (`3%`, `30.3K`,
+ * `-4.1M bbl`, `77 Bcf`); an export reads them back so a script gets a number
+ * and what it is a number of.
+ */
+
+/** A figure read back from its text. */
+export interface EconFigure {
+  /** The figure in its unit, its scale multiplied out: `30.3K` is 30300 and `3%` is 3. */
+  value: number;
+  /** What the figure counts: `%`, `bbl`, `b/d`, `Bcf`; empty for a plain count or index level. */
+  unit: string;
+  /** The multiplier the text drew it in: 1, or 1000 for `K`, 1e6 for `M`, 1e9 for `B`, 1e12 for `T`. */
+  scale: number;
+}
+
+const SCALE_DIGITS: Readonly<Record<string, number>> = { K: 3, M: 6, B: 9, T: 12 };
+
+// A sign, then the digits (grouped by commas, or with a decimal point or comma), a scale letter straight after them,
+// then `%` or a unit word: `-4.1M bbl`, `3%`, `30k`, `1,250`, `1,5%`, `77 Bcf`, `50.9`. A range, a bound (`<1.25%`)
+// or a figure with more words after it (`3% y/y`) is not one.
+const FIGURE = /^([+-]?)(?:(\d{1,3}(?:,\d{3})+(?:\.\d+)?)|(\d+(?:[.,]\d+)?|\.\d+))(?:([KMBT])(?![A-Za-z]))?(?:(%)|\s*([A-Za-z][A-Za-z/.]*(?:\s+[A-Za-z/.]+)*))?$/i;
+
+/**
+ * The number, unit and scale of a figure the calendar prints; null for a text
+ * that is not one figure (`<1.25%` is a bound, not a value) and for a missing one.
+ * The one reading of a figure: the table's colours and every export use it, so
+ * a figure the app can read is never a null in an export.
+ */
+export function parseEconFigure(text: string | null | undefined): EconFigure | null {
+  const match = FIGURE.exec((text ?? "").trim().replace(/\u2212/g, "-"));
+  if (!match) return null;
+  const [, sign, grouped, plain, letter, percent, word] = match;
+  const digits = letter ? SCALE_DIGITS[letter.toUpperCase()]! : 0;
+  // A comma before exactly three digits groups thousands (1,250); before fewer it is a decimal comma (1,5).
+  const number = grouped ? grouped.replace(/,/g, "") : plain!.replace(",", ".");
+  // Parsed from the decimal text, so 0.987M is exactly 987000 and not 986999.9999999999.
+  const value = Number(`${sign === "-" ? "-" : ""}${number}e${digits}`);
+  return { value: Object.is(value, -0) ? 0 : value, unit: percent ? "%" : word ?? "", scale: 10 ** digits };
+}
+
+/** What a row's Actual, Forecast and Prior say in numbers, with the unit they share and the scale the first is drawn in. */
+export interface EconRowFigures {
+  actual: number | null;
+  forecast: number | null;
+  prior: number | null;
+  /** The unit of the row's figures; null when it has no figure or they are plain counts. */
+  unit: string | null;
+  /**
+   * The scale the first of its figures is drawn in (actual, else forecast, else prior); null when it has none.
+   * Each figure is multiplied out by its own, so `950K` beside `1.2M` is 950000 and 1200000 under scale 1000.
+   */
+  scale: number | null;
+}
+
+/**
+ * A row's three figures as numbers. They share one unit; a figure drawn in
+ * another (none is today) is null rather than a number in the wrong unit.
+ */
+export function econRowFigures(row: { actual?: string | null; forecast?: string | null; prior?: string | null }): EconRowFigures {
+  const figures = [row.actual, row.forecast, row.prior].map(parseEconFigure);
+  const first = figures.find((figure): figure is EconFigure => figure != null);
+  const numbers = figures.map((figure) => figure && first && figure.unit === first.unit ? figure.value : null);
+  return {
+    actual: numbers[0]!,
+    forecast: numbers[1]!,
+    prior: numbers[2]!,
+    unit: first?.unit ? first.unit : null,
+    scale: first?.scale ?? null,
+  };
+}

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

@@ -46,6 +46,7 @@ import {
   subscribeCalendar,
   impactIndicator,
   loadCalendar,
+  lowerImpactHidden,
   eventCountry,
   matchesCountry,
   matchesImpact,
@@ -103,7 +104,10 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
   // The selected row and the open event are remembered by event id, so a
   // 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);
+  // A level a caller named (`fn ECO --impact all`) is where a new pane opens; a level the reader picks is kept.
+  const [impactSetting] = usePaneSettingValue<string>("impact", "");
+  const openingImpact = FILTER_CYCLE.find((level) => level === impactSetting) ?? DEFAULT_IMPACT_FILTER;
+  const [impactFilter, setImpactFilter] = usePluginPaneState<ImpactFilter>("impactFilter", openingImpact);
   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();
@@ -323,12 +327,22 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
   const showStale = stale && (!loading || calendar.updatedAt !== null);
   // An empty list says it in its empty state instead.
   const listedAfterStatus = listedAfter && !detailEvent && filtered.length > 0 ? listedAfter : null;
+  // What the High filter, where the calendar opens, leaves out, and the key that lists it (Shift+F steps back to All).
+  const hiddenCount = useMemo(() => lowerImpactHidden(events, impactFilter, countryFilter), [countryFilter, events, impactFilter]);
+  const hiddenStatus = hiddenCount > 0 && !detailEvent ? `${hiddenCount} lower-impact hidden` : null;
   const calendarStatus = useMemo<PaneFooterSegment[]>(() => [
+    ...(hiddenStatus ? [{
+      id: "hidden-impact",
+      capture: true,
+      title: `${hiddenStatus}: Shift+F or Impact All lists them`,
+      // First and whole: the countdown and the update time give way before the key does.
+      parts: [{ text: `${hiddenStatus} (Shift+F)`, tone: "muted" as const }],
+    }] : []),
     ...(nextText && !detailEvent ? [{ id: "next", parts: [{ text: nextText, tone: "muted" as const }] }] : []),
     ...(listedAfterStatus ? [{ id: "listed-after", parts: [{ text: listedAfterStatus, tone: "warning" as const }] }] : []),
     ...(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]);
+  ], [detailEvent, hiddenStatus, listedAfterStatus, nextText, showStale, staleness]);
   // A report of the pane (`gloom fn ECO`) says it too.
   const listedThrough = listedEnd ? dateKey(listedEnd) : null;
   useRemoteUiNode(listedAfter && listedThrough ? {
@@ -336,6 +350,15 @@ function EconCalendarPane({ focused, width, height }: PaneProps) {
     label: "Listed through",
     getMetadata: () => ({ text: listedAfter, key: "listedThrough", value: listedThrough }),
   } : null);
+  useRemoteUiNode(hiddenCount > 0 ? {
+    role: "report-notice",
+    label: "Lower-impact hidden",
+    getMetadata: () => ({
+      text: `${hiddenCount} lower-impact ${hiddenCount === 1 ? "release" : "releases"} hidden: add --impact all to list them.`,
+      key: "lowerImpactHidden",
+      value: hiddenCount,
+    }),
+  } : null);
   usePaneStatusFooter({
     registrationId: "econ-calendar",
     loading,
@@ -527,6 +550,13 @@ export const economicCalendarModule: PluginModule = {
         if ("error" in parsed) throw new Error(`${parsed.error} ${COUNTRY_FILTER_HINT}`);
         return parsed.filter;
       },
+    }, {
+      key: "impact",
+      type: "enum",
+      values: [{ value: "high" }, { value: "medium", aliases: ["med"] }, { value: "low" }, { value: "all" }],
+      description: "Impact level to list: high (where the calendar opens, leaving out most PMIs), medium, low or all",
+      example: "--impact all",
+      exampleWithoutArgument: true,
     }],
     settings: {
       title: "Economic Calendar Settings",
@@ -546,7 +576,7 @@ export const economicCalendarModule: PluginModule = {
     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", "rate decision", "ipca",
-      "brazil inflation"],
+      "brazil inflation", "pmi", "ism", "purchasing managers", "flash pmi"],
     // ECO MX,BR opens the calendar on those countries.
     shortcut: {
       prefix: "ECO",

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

@@ -27,6 +27,10 @@ export interface EconEvent {
   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 };
+  /** The indicator this release is of, the same from one release to the next; `id` is this row's alone. */
+  indicatorId?: string | null;
+  /** Which feed the forecast was read from (`week-feed`, `release-calendar`) and when that feed was read. */
+  consensus?: { source: string; readAt: string } | null;
 }
 
 /** Whether a row's time is blank because its publisher states none (a bank whose calendar gives the day only). */

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

@@ -60,6 +60,12 @@ export interface StatDef {
   note: string;
   /** Other words the catalog and the pane's filter find it by: `PMMS` for the mortgage rate. */
   keywords?: readonly string[];
+  /**
+   * The names a reader gives the indicator, read as an argument ahead of any
+   * FRED series id: `PCE` is the price index release, not the series FRED files
+   * under that id (personal spending), and `gdp` is real GDP, not its nowcast.
+   */
+  aliases?: readonly string[];
   /** Concise measurement identity that must remain beside the values. */
   measurementBasis?: string;
   /**