gloomberb 0.18.2 → 0.18.4

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

@@ -1,8 +1,9 @@
 import { createPluginCache } from "../../../data/plugin-cache";
 import type { DataTableColumn } from "../../../components";
 import { colors } from "../../../theme/colors";
+import { displayWidth } from "../../../utils/format";
 import { fetchEconCalendar } from "./calendar-source";
-import type { EconEvent, EconImpact } from "./types";
+import { isAllDayEvent, type EconEvent, type EconImpact } from "./types";
 
 const CACHE_KIND = "calendar";
 const CACHE_KEY = "global";
@@ -14,7 +15,10 @@ const CACHE_POLICY = {
 } as const;
 
 export type ImpactFilter = "high" | "medium" | "low" | "all";
-/** A region the pane cycles through, or one country by its two-letter code (`econ --country TR`). */
+/**
+ * A region the pane cycles through, or countries by their ISO codes, comma
+ * separated (`econ --country MX,BR,ZA`); a list matches any of its parts.
+ */
 export type CountryFilter = "all" | "US" | "G7" | "EU" | (string & {});
 
 export const FILTER_CYCLE: ImpactFilter[] = ["all", "high", "medium", "low"];
@@ -39,6 +43,7 @@ export type DisplayRow =
 
 type EconCalendarColumnId =
   | "time"
+  | "readerTime"
   | "impact"
   | "country"
   | "event"
@@ -76,7 +81,7 @@ export function dateKey(d: Date): string {
 
 /**
  * The release's UTC clock time. Rows group by UTC day and the column header
- * names the zone, as `gloomberb econ` prints it; local time would move a 23:00
+ * names the zone, as `gloom econ` prints it; local time would move a 23:00
  * UTC release under another day and read differently on every machine.
  */
 export function timeLabel(d: Date): string {
@@ -179,16 +184,113 @@ const IMPACT_WORDS: Record<Exclude<ImpactFilter, "all">, string> = {
  */
 export function filteredEmptyTitle(impact: ImpactFilter, country: CountryFilter): string | null {
   if (impact === "all" && country === "all") return null;
-  const words = [impact === "all" ? null : IMPACT_WORDS[impact], country === "all" ? null : country];
+  const words = [impact === "all" ? null : IMPACT_WORDS[impact], country === "all" ? null : country.split(",").join(", ")];
   return `No ${words.filter(Boolean).join(" ")} events listed`;
 }
 
-export function matchesCountry(event: EconEvent, filter: CountryFilter): boolean {
+function matchesOneCountry(country: string, filter: string): boolean {
   if (filter === "all") return true;
-  if (filter === "US") return event.country === "US";
-  if (filter === "G7") return G7_COUNTRIES.has(event.country);
-  if (filter === "EU") return event.country === "EU";
-  return event.country === filter;
+  if (filter === "G7") return G7_COUNTRIES.has(country);
+  return country === filter;
+}
+
+/**
+ * The euro area's members by the word a national release's title starts
+ * with ("German Ifo Business Climate"). Both feeds list such a release under
+ * EU: the week feed by its currency, with the member's adjective in front of
+ * the title, and Gloom Cloud writes the release calendar's members the same
+ * way. Each word names exactly one member.
+ */
+const EURO_AREA_MEMBERS: Readonly<Record<string, string>> = {
+  Austrian: "AT", Belgian: "BE", Croatian: "HR", Cypriot: "CY", Dutch: "NL", Estonian: "EE", Finnish: "FI",
+  French: "FR", German: "DE", Greek: "GR", Irish: "IE", Italian: "IT", Latvian: "LV", Lithuanian: "LT",
+  Luxembourgish: "LU", Maltese: "MT", Portuguese: "PT", Slovak: "SK", Slovenian: "SI", Spanish: "ES",
+};
+
+/**
+ * The member state an EU row is a national release of ("German Ifo Business
+ * Climate" is DE), by the adjective its title starts with; null for a
+ * release of the whole euro area (ECB, euro area CPI) and for any other row.
+ */
+function euroAreaMember(event: Pick<EconEvent, "country" | "event">): string | null {
+  if (event.country !== "EU") return null;
+  const word = /^([A-Z][a-z]+) /.exec(event.event)?.[1];
+  return word ? EURO_AREA_MEMBERS[word] ?? null : null;
+}
+
+/** The country a row is for, as the calendar shows it: a national euro-area release's member, otherwise its own. */
+export function eventCountry(event: Pick<EconEvent, "country" | "event">): string {
+  return euroAreaMember(event) ?? event.country;
+}
+
+/** A national euro-area release matches EU (and G7, as EU) and its own member's code. */
+export function matchesCountry(event: Pick<EconEvent, "country" | "event">, filter: CountryFilter): boolean {
+  const member = euroAreaMember(event);
+  return filter.split(",").some((part) => matchesOneCountry(event.country, part) || (member !== null && member === part));
+}
+
+/** What people type for a country whose ISO code is another. */
+const COUNTRY_ALIASES: Readonly<Record<string, string>> = { UK: "GB" };
+
+let regionNames: Intl.DisplayNames | null | undefined;
+
+/** An ISO 3166 country (or the EU) the runtime can name; any two letters when it names none. */
+function isCountryCode(code: string): boolean {
+  if (regionNames === undefined) {
+    try {
+      regionNames = new Intl.DisplayNames(["en"], { type: "region", fallback: "none" });
+    } catch {
+      regionNames = null;
+    }
+  }
+  if (!regionNames) return /^[A-Z]{2}$/.test(code);
+  try {
+    // ZZ is CLDR's "Unknown Region".
+    return code !== "ZZ" && regionNames.of(code) !== undefined;
+  } catch {
+    return false;
+  }
+}
+
+export const COUNTRY_FILTER_HINT = `Use ${COUNTRY_CYCLE.join(", ")}, or two-letter country codes such as MX, or several as MX,BR,ZA.`;
+
+/**
+ * A country filter as typed: the pane's regions and ISO country codes, any
+ * case, comma separated (`mx, br`, `G7,MX`, `UK` for GB). The filter as the
+ * pane stores it (`MX,BR`), or why it is not one.
+ */
+export function parseCountryFilter(text: string): { filter: CountryFilter } | { error: string } {
+  const parts: string[] = [];
+  for (const token of text.split(/[\s,]+/).filter(Boolean)) {
+    const region = COUNTRY_CYCLE.find((candidate) => candidate.toLowerCase() === token.toLowerCase());
+    const upper = token.toUpperCase();
+    const code = region ?? COUNTRY_ALIASES[upper] ?? (/^[A-Z]{2}$/.test(upper) && isCountryCode(upper) ? upper : null);
+    if (!code) return { error: `Unknown country "${token}".` };
+    if (!parts.includes(code)) parts.push(code);
+  }
+  if (parts.length === 0) return { error: "No country given." };
+  return { filter: parts.includes("all") ? "all" : parts.join(",") };
+}
+
+/** The countries a filter names one by one (MX and BR in `G7,MX,BR`), leaving out the regions. */
+function filterCountries(filter: CountryFilter): string[] {
+  return filter.split(",").filter((part) => !(COUNTRY_CYCLE as readonly string[]).includes(part));
+}
+
+/**
+ * Countries the filter names that no event in `events` is for, so a list
+ * says which of them has nothing scheduled instead of reading as a quiet week
+ * (or as a country the terminal does not know).
+ */
+export function countriesWithoutEvents(filter: CountryFilter, events: ReadonlyArray<Pick<EconEvent, "country" | "event">>): string[] {
+  const listed = new Set(events.flatMap((event) => [event.country, euroAreaMember(event) ?? event.country]));
+  return filterCountries(filter).filter((country) => !listed.has(country));
+}
+
+/** "No scheduled releases for MX in this window", or for MX or ZA. */
+export function noScheduledReleasesMessage(countries: readonly string[]): string {
+  const named = countries.length > 1 ? `${countries.slice(0, -1).join(", ")} or ${countries.at(-1)}` : countries.join("");
+  return `No scheduled releases for ${named} in this window.`;
 }
 
 /**
@@ -198,10 +300,16 @@ export function matchesCountry(event: EconEvent, filter: CountryFilter): boolean
  */
 export const PRINT_PENDING_MS = 20 * 60 * 1000;
 
-/** High-impact releases whose time has come in the last {@link PRINT_PENDING_MS} and that have no actual yet. */
+/**
+ * High-impact releases whose time has come in the last {@link PRINT_PENDING_MS}
+ * and that have no actual yet. Rows Gloom Cloud adds from a bank's or a
+ * statistics office's calendar (`kind`) never get an actual, and a bank's
+ * untimed decision would fall due at midnight UTC, so they are never waited
+ * on; nor is an all-day event (an election), which prints nothing.
+ */
 export function pendingHighImpactPrints(events: readonly EconEvent[], now: number): EconEvent[] {
   return events.filter((event) => {
-    if (event.impact !== "high" || event.actual) return false;
+    if (event.impact !== "high" || event.actual || event.kind || isAllDayEvent(event)) return false;
     const releasedFor = now - event.date.getTime();
     return releasedFor >= 0 && releasedFor <= PRINT_PENDING_MS;
   });
@@ -222,15 +330,6 @@ export function landedHighImpactPrints(
   });
 }
 
-export function formatCountdown(ms: number): string {
-  if (ms <= 60_000) return "in <1m";
-  const totalMin = Math.floor(ms / 60_000);
-  if (totalMin < 60) return `in ${totalMin}m`;
-  const h = Math.floor(totalMin / 60);
-  const m = totalMin % 60;
-  return m > 0 ? `in ${h}h ${m}m` : `in ${h}h`;
-}
-
 export function formatStaleness(fetchedAt: number, now: number): string {
   const elapsed = now - fetchedAt;
   if (elapsed < 60_000) return "updated just now";
@@ -275,6 +374,19 @@ export function loadCalendar(
   return cache.load(CACHE_KEY, loader, { force });
 }
 
+/** The widest a value column grows: "-3.061M bbl" and "0.034M b/d" whole. */
+const MAX_VALUE_WIDTH = 12;
+
+/**
+ * A value column as wide as the widest figure shown, from its usual width up
+ * to MAX_VALUE_WIDTH, so an energy row keeps its unit (77 Bcf, -3.061M bbl).
+ */
+export function valueColumnWidth(events: readonly EconEvent[], key: "actual" | "forecast" | "prior", base: number): number {
+  let width = base;
+  for (const event of events) width = Math.max(width, Math.min(MAX_VALUE_WIDTH, displayWidth(event[key] ?? "")));
+  return width;
+}
+
 function parseNumeric(value: string | null): number | null {
   if (!value) return null;
   const cleaned = value.replace(/[%,KMBTkmbts]/g, "").trim();

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

@@ -3,6 +3,7 @@ import { apiClient } from "../../../api-client";
 import {
   ChartTableHeader,
   DataTableView,
+  ExternalLinkText,
   formatPercentAxis,
   PaneStatusBody,
   scalarPoint,
@@ -10,6 +11,7 @@ import {
   staticSeries,
   TickerBadgeList,
   useChartTableSelection,
+  useExternalLinkFooter,
   usePaneFooter,
   usePaneNoticeFooter,
   type DataTableColumn,
@@ -26,11 +28,11 @@ import {
 } from "../../../sources/gloomberb-cloud/fred-series";
 import { colors } from "../../../theme/colors";
 import { Box, Text } from "../../../ui";
-import { displayWidth } from "../../../utils/format";
+import { displayWidth, truncateToDisplayWidth } from "../../../utils/format";
 import { useOpenTickerChoice } from "../shared/ticker-choice";
 import { resolveFredMapping, projectFredHistory, fredHistoryUnits } from "./fred-series-map";
 import { actualColor, CALENDAR_TIME_ZONE_LABEL, timeLabel } from "./calendar-model";
-import type { EconEvent } from "./types";
+import { hasNoStatedTime, isAllDayEvent, type EconEvent } from "./types";
 
 interface EconDetailViewProps {
   event: EconEvent;
@@ -96,6 +98,24 @@ function formatLevelAxis(value: number, domain: CompositeAxisDomain): string {
   return `${(value / divisor).toFixed(digits)}${suffix}`;
 }
 
+/**
+ * The publisher's calendar the row was read from, on the detail's last row,
+ * named and linked like a statistic's series under its chart (ECST), never as
+ * a bare address.
+ */
+function SourceLine({ source, kind, width }: { source: NonNullable<EconEvent["source"]>; kind: EconEvent["kind"]; width: number }) {
+  const detail = ` · ${kind === "central-bank-decision" ? "meeting calendar" : "release calendar"}`;
+  const label = truncateToDisplayWidth(source.name, Math.max(4, width - 2 - displayWidth(detail)));
+  return (
+    <Box flexDirection="row" paddingX={1} height={1} flexShrink={0}>
+      {source.url
+        ? <ExternalLinkText url={source.url} label={label} color={colors.text} />
+        : <Text fg={colors.text}>{label}</Text>}
+      <Text fg={colors.textDim}>{detail}</Text>
+    </Box>
+  );
+}
+
 const historyKey = (row: HistoryRow) => row.date;
 const historyDate = (row: HistoryRow) => new Date(`${row.date}T00:00:00Z`);
 
@@ -188,6 +208,8 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       onPress: () => openTickerChoice(relatedTickers),
     }],
   } : null, [openTickerChoice, relatedTickers]);
+  // `o` opens the publisher's calendar, the link on the last row.
+  useExternalLinkFooter({ registrationId: "econ-detail:source", focused, url: event.source?.url ?? null });
 
   // The stack bar names the event; the detail opens on the release figures,
   // the outcome first so a short detail keeps it.
@@ -195,8 +217,17 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
     ...(event.actual ? [{ id: "actual", label: "Actual", value: event.actual, color: actualColor(event.actual, event.forecast) }] : []),
     ...(event.forecast ? [{ id: "forecast", label: "Forecast", value: event.forecast }] : []),
     ...(event.prior ? [{ id: "prior", label: "Prior", value: event.prior }] : []),
-    { id: "time", label: "Release", value: `${timeLabel(event.date)} ${CALENDAR_TIME_ZONE_LABEL}` },
+    // The date the prior rate was observed, labelled as Central Bank Rates labels it.
+    ...(event.prior && event.priorAsOf ? [{ id: "priorAsOf", label: "As of", value: event.priorAsOf }] : []),
+    // A bank that states no time has none here, and says so; a publisher's own clock sits under the time.
+    hasNoStatedTime(event)
+      ? { id: "time", label: "Release", value: "No time stated", detail: event.timeNote! }
+      : isAllDayEvent(event)
+      ? { id: "time", label: "Release", value: "All day" }
+      : { id: "time", label: "Release", value: `${timeLabel(event.date)} ${CALENDAR_TIME_ZONE_LABEL}`,
+        ...(event.localTime && event.timeZone ? { detail: `${event.localTime} ${event.timeZone.split("/").at(-1)!.replaceAll("_", " ")}` } : {}) },
   ];
+  const sourceLine = event.source ? <SourceLine source={event.source} kind={event.kind} width={width} /> : null;
 
   const projected = useMemo(
     () => data && mapping ? projectFredHistory(data.observations, mapping) : [],
@@ -230,6 +261,7 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
           emptyTitle="No historical data available for this indicator"
           align="center"
         />
+        {sourceLine}
       </Box>
     );
   }
@@ -244,8 +276,9 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
       detail: [units, data.info?.frequency, data.info?.seasonalAdjustment].filter(Boolean).join(" · ") || undefined },
   ];
   const relatedRows = mapping.relatedTickers.length > 0 ? 1 : 0;
-  // The header and the history share every row above the related tickers.
-  const bodyHeight = Math.max(1, height - relatedRows);
+  const afterRows = relatedRows + (sourceLine ? 1 : 0);
+  // The header and the history share every row above the source and the related tickers.
+  const bodyHeight = Math.max(1, height - afterRows);
 
   return (
     <DataTableView<HistoryRow>
@@ -263,11 +296,16 @@ export function EconDetailView({ event, width, height, focused }: EconDetailView
           remoteKind: "econ-fred-history",
           ...link,
         } : null} />}
-      rootAfter={relatedRows ? (
-        <Box paddingX={1} height={1} flexDirection="row" flexShrink={0}>
-          <Text fg={colors.textDim}>Related: </Text>
-          <TickerBadgeList symbols={mapping.relatedTickers} width={Math.max(8, width - 12)} liveQuote={false} />
-        </Box>
+      rootAfter={afterRows ? (
+        <>
+          {sourceLine}
+          {relatedRows ? (
+            <Box paddingX={1} height={1} flexDirection="row" flexShrink={0}>
+              <Text fg={colors.textDim}>Related: </Text>
+              <TickerBadgeList symbols={mapping.relatedTickers} width={Math.max(8, width - 12)} liveQuote={false} />
+            </Box>
+          ) : null}
+        </>
       ) : undefined}
       getItemKey={historyKey}
       renderCell={(row, column, _index, state) => {

package/src/plugins/builtin/econ/fred-catalog.ts

@@ -8,8 +8,9 @@ type FredRow = readonly [seriesId: string, name: string, unit: string, frequency
  * maturities (UST:2Y and so on, from the yield curve) and the credit spreads
  * and yields (from the credit plugin). Ids follow the server's allowlist: a
  * series added there is listed here to reach the catalog.
- * Türkiye's CPI is served the same way but is not on FRED; its rows name
- * TurkStat (`seriesNotOnFred`).
+ * Türkiye's CPI, Brazil's IPCA and NAHB's housing market index are served
+ * the same way but are not on FRED; their rows name TurkStat, IBGE and NAHB
+ * (`seriesNotOnFred`).
  */
 const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
   {
@@ -65,10 +66,15 @@ const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
       ["RSFSXMV", "Retail sales excluding autos", "million USD", "monthly", ["consumer", "spending"]],
       ["UMCSENT", "University of Michigan consumer sentiment", "index", "monthly", ["consumer", "sentiment"]],
       ["CSCICP03USM665S", "Consumer confidence (OECD)", "index", "monthly", ["consumer", "sentiment"]],
-      ["HOUST", "Housing starts", "thousand units", "monthly", ["housing"]],
-      ["PERMIT", "Building permits", "thousand units", "monthly", ["housing"]],
-      ["EXHOSLUSM495S", "Existing home sales", "units", "monthly", ["housing"]],
-      ["HSN1F", "New home sales", "thousand units", "monthly", ["housing"]],
+      ["HOUST", "Housing starts", "thousand units", "monthly", ["housing", "homebuilders"]],
+      ["PERMIT", "Building permits", "thousand units", "monthly", ["housing", "homebuilders"]],
+      ["EXHOSLUSM495S", "Existing home sales", "units", "monthly", ["housing", "homebuilders"]],
+      ["HSN1F", "New home sales", "thousand units", "monthly", ["housing", "homebuilders"]],
+      ["MORTGAGE30US", "30-year fixed mortgage rate (Freddie Mac PMMS)", "%", "weekly", ["housing", "mortgage rate", "PMMS", "Freddie Mac", "homebuilders"]],
+      ["MORTGAGE15US", "15-year fixed mortgage rate (Freddie Mac PMMS)", "%", "weekly", ["housing", "mortgage rate", "PMMS", "Freddie Mac", "homebuilders"]],
+      // Computed by Gloom Cloud: MORTGAGE30US less DGS10 on each PMMS date.
+      ["MORTGAGE30US10Y", "30-year mortgage rate minus 10Y Treasury, on the PMMS date", "%", "weekly", ["housing", "mortgage spread", "PMMS", "treasury", "homebuilders"]],
+      ["NAHBHMI", "NAHB housing market index (builder sentiment)", "index", "monthly", ["housing", "NAHB", "HMI", "homebuilders", "sentiment"]],
       ["DGORDER", "Durable goods orders", "million USD", "monthly", ["manufacturing", "orders"]],
       ["ADXTNO", "Durable goods orders excluding transportation", "million USD", "monthly", ["manufacturing", "orders"]],
       ["AMTMNO", "Manufacturing new orders", "million USD", "monthly", ["manufacturing", "factory orders"]],
@@ -127,6 +133,9 @@ const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
       ["T5YIFR", "5Y, 5Y forward inflation expectation", "%", "daily", ["breakeven", "expectations", "5y5y"]],
       ["TURCPIYOY", "Türkiye CPI, y/y", "%", "monthly", ["CPI", "headline", "Turkey", "TR", "inflation", "lira"]],
       ["TURCPIMOM", "Türkiye CPI, m/m", "%", "monthly", ["CPI", "headline", "Turkey", "TR", "inflation", "lira"]],
+      ["BRAIPCAMOM", "Brazil IPCA, m/m", "%", "monthly", ["IPCA", "CPI", "headline", "Brazil", "BR", "Brazil inflation", "inflation", "real"]],
+      ["BRAIPCA15MOM", "Brazil IPCA-15 mid-month, m/m", "%", "monthly",
+        ["IPCA-15", "IPCA", "CPI", "mid-month", "Brazil", "BR", "Brazil inflation", "inflation", "real"]],
     ],
   },
   {
@@ -173,6 +182,14 @@ const GROUPS: ReadonlyArray<{ group: string; rows: readonly FredRow[] }> = [
       ["NATURALGAS", "Natural gas consumption", "billion cubic feet", "monthly", ["natural gas"]],
     ],
   },
+  {
+    // The IMF's monthly world prices: the closest public series to LME copper and aluminium, which FUT does not list.
+    group: "Commodities",
+    rows: [
+      ["PCOPPUSDM", "Global price of copper", "USD/ton", "monthly", ["copper", "metals", "LME"]],
+      ["PALUMUSDM", "Global price of aluminum", "USD/ton", "monthly", ["aluminum", "aluminium", "metals", "LME"]],
+    ],
+  },
   {
     group: "Valuation",
     rows: [

package/src/plugins/builtin/econ/fred-series-map.ts

@@ -35,6 +35,10 @@ const SERIES_MAP: Record<string, FredMapping> = {
   "building permits": { seriesId: "PERMIT", displayMode: "level", relatedTickers: ["XHB", "ITB"] },
   "existing home sales": { seriesId: "EXHOSLUSM495S", displayMode: "level", relatedTickers: ["XHB"] },
   "new home sales": { seriesId: "HSN1F", displayMode: "level", relatedTickers: ["XHB", "ITB"] },
+  // Freddie Mac's PMMS, not the MBA's contract rate ("mba 30-year mortgage rate"), which is another survey.
+  "30-year mortgage rate": { seriesId: "MORTGAGE30US", displayMode: "level", relatedTickers: ["XHB", "ITB"] },
+  "15-year mortgage rate": { seriesId: "MORTGAGE15US", displayMode: "level", relatedTickers: ["XHB", "ITB"] },
+  "nahb housing market index": { seriesId: "NAHBHMI", displayMode: "level", relatedTickers: ["XHB", "ITB"] },
   "durable goods orders m/m": { seriesId: "DGORDER", displayMode: "mom", relatedTickers: ["XLI", "SPY"] },
   "core durable goods orders m/m": { seriesId: "ADXTNO", displayMode: "mom", relatedTickers: ["XLI"] },
   "factory orders m/m": { seriesId: "AMTMNO", displayMode: "mom", relatedTickers: ["XLI"] },