gloomberb 0.13.2 → 0.14.0

package/src/plugins/builtin/earnings/estimate-basis.test.ts

@@ -0,0 +1,158 @@
+import { afterEach, expect, test } from "bun:test";
+import { loadYahooEarningsCalendar } from "../../../sources/yahoo-finance/quote-summary";
+import { mapYahooEarningsCalendarEvent } from "../../../sources/yahoo-finance/mappers";
+import type { YahooQuoteSummaryResult } from "../../../sources/yahoo-finance/types";
+import { MemoryPluginPersistence } from "../../../test-support/plugin-persistence";
+import { attachEarningsCalendarPersistence, loadEarningsCalendar, resetEarningsCalendarPersistence } from "./data/cache";
+import { coherentEarningsValue, earningsEpsChange30d, earningsForecastPeriod } from "./estimate-basis";
+import { projectEarningsCalendarHeadless } from "./headless";
+import { buildEarningsColumns, renderEarningsCell } from "./table";
+import { recordedEarnings } from "./estimate-fixtures.test-data";
+
+const args = { argument: "SYN", rawArgument: "SYN", symbols: ["SYN"], options: { limit: 50 } };
+afterEach(resetEarningsCalendarPersistence);
+const fixtures = [
+  ["SONY", "USD", "JPY", 0.33459],
+  ["6758.T", "JPY", "JPY", 63.08788],
+  ["BABA", "CNY", "CNY", 10.97892],
+  ["9988.HK", "CNY", "CNY", 1.47221],
+  ["AAPL", "USD", "USD", 1.97754],
+] as const;
+for (const [symbol, epsCurrency, revenueCurrency, eps] of fixtures) {
+  test(`recorded ${symbol} keeps each explicit forecast unit and fiscal end through loading/cache/export`, async () => {
+    let requests = 0;
+    const events = await loadYahooEarningsCalendar([symbol], async <T>(url: string) => {
+      requests++;
+      expect(new URL(url).searchParams.get("modules")).toBe("calendarEvents,earningsTrend,quoteType");
+      return { quoteSummary: { result: [recordedEarnings[symbol]] } } as T;
+    });
+    const event = events[0]!;
+    expect(event.epsEstimate).toBe(eps);
+    expect(event.estimateBasis?.epsEstimate).toMatchObject({ currency: epsCurrency, period: "0q", periodEndDate: "2026-09-30", source: "earningsTrend" });
+    expect(event.estimateBasis?.revenueEstimate?.currency).toBe(revenueCurrency);
+    expect(earningsForecastPeriod(event)).toEqual({ period: "0q", periodEndDate: "2026-09-30" });
+    expect(event.earningsDate.toISOString().slice(0, 10)).not.toBe("2026-09-30");
+    attachEarningsCalendarPersistence(new MemoryPluginPersistence());
+    let providerCalls = 0;
+    const provider = { getEarningsCalendar: async () => { providerCalls++; return events; } } as never;
+    await loadEarningsCalendar(provider, [symbol]);
+    const cached = await loadEarningsCalendar(provider, [symbol]);
+    const report = projectEarningsCalendarHeadless(cached, args);
+    expect(report.rows[0]).toMatchObject({ epsEstimate: eps, epsCurrency, revenueCurrency, forecastPeriod: "0q", forecastPeriodEnd: "2026-09-30", estimateBasis: event.estimateBasis });
+    expect(providerCalls).toBe(1);
+    expect(requests).toBe(1);
+    const cell = renderEarningsCell({ kind: "event", key: symbol, eventIdx: 0, event }, buildEarningsColumns(240).find(c => c.id === "epsEstimate")!, false);
+    expect(cell.text).toStartWith(epsCurrency);
+  });
+}
+
+function synthetic(): YahooQuoteSummaryResult {
+  return {
+    price: { currency: "USD" },
+    calendarEvents: { earnings: { earningsDate: [{ raw: Date.parse("2026-11-05T21:00:00Z") / 1000 }], earningsAverage: 5, earningsLow: 4, earningsHigh: 6, revenueAverage: 100 } },
+    earningsTrend: { trend: [{ period: "0q", endDate: "2026-09-30",
+      earningsEstimate: { avg: 150, low: 120, high: 180, yearAgoEps: 100, numberOfAnalysts: 4, growth: 0.5, earningsCurrency: "GBp" },
+      revenueEstimate: { avg: 100, revenueCurrency: "GBP" },
+      epsTrend: { "7daysAgo": 0.2, "30daysAgo": 0.5, epsTrendCurrency: "GBP" },
+      epsRevisions: { upLast30days: 2, downLast30days: 0 },
+    }] },
+  };
+}
+
+test("explicit minor-unit amounts normalize once, including zero, without changing counts or growth", () => {
+  const source = synthetic();
+  const event = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(event).toMatchObject({ epsEstimate: 1.5, epsLow: 1.2, epsHigh: 1.8, epsYearAgo: 1, epsAnalysts: 4, epsGrowth: 0.5, epsTrend30dAgo: 0.5 });
+  expect(event.estimateBasis?.epsEstimate).toMatchObject({ currency: "GBP", sourceCurrency: "GBp", sourceValue: 150 });
+  expect(earningsEpsChange30d(event)).toBe(1);
+  expect(event.estimateBasis?.epsAnalysts?.currency).toBeUndefined();
+  source.earningsTrend!.trend![0]!.earningsEstimate!.avg = 0;
+  const zero = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(zero.epsEstimate).toBe(0);
+  expect(earningsEpsChange30d(zero)).toBe(-0.5);
+});
+
+test("missing or incompatible EPS trend currency/period cannot create a 30-day change", () => {
+  for (const currency of [undefined, "", "XXX", "unknown", "JPY"]) {
+    const source = synthetic();
+    source.earningsTrend!.trend![0]!.epsTrend!.epsTrendCurrency = currency;
+    const event = mapYahooEarningsCalendarEvent(source, "SYN")!;
+    expect(earningsEpsChange30d(event)).toBeNull();
+  }
+  for (const endDate of [undefined, "", "2026-02-30"]) {
+    const source = synthetic();
+    source.earningsTrend!.trend![0]!.endDate = endDate;
+    expect(earningsEpsChange30d(mapYahooEarningsCalendarEvent(source, "SYN")!)).toBeNull();
+  }
+  const source = synthetic();
+  source.earningsTrend!.trend![0]!.earningsEstimate!.earningsCurrency = undefined;
+  const unknown = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(unknown.estimateBasis?.epsEstimate?.currency).toBeNull();
+  expect(unknown.epsEstimate).toBe(150);
+  expect(earningsEpsChange30d(unknown)).toBeNull();
+  const no30d = synthetic();
+  delete no30d.earningsTrend!.trend![0]!.epsTrend!["30daysAgo"];
+  expect(earningsEpsChange30d(mapYahooEarningsCalendarEvent(no30d, "SYN")!)).toBeNull();
+});
+
+test("calendar fallback values retain unknown basis while unrelated trend ranges/counts stay separate", () => {
+  const source = synthetic();
+  source.earningsTrend!.trend![0]!.earningsEstimate!.avg = null;
+  source.earningsTrend!.trend![0]!.earningsEstimate!.high = null;
+  const event = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(event.epsEstimate).toBe(5);
+  expect(event.estimateBasis?.epsEstimate).toEqual({ source: "calendarEvents", sourceValue: 5, period: null, periodEndDate: null, currency: null, sourceCurrency: null });
+  expect(event.epsLow).toBe(1.2);
+  expect(event.epsHigh).toBe(6);
+  expect(coherentEarningsValue(event, "epsLow")).toBeNull();
+  expect(coherentEarningsValue(event, "epsHigh")).toBe(6);
+  for (const field of ["epsGrowth", "epsAnalysts", "epsRevisionUp30d", "epsRevisionDown30d"] as const) expect(coherentEarningsValue(event, field)).toBeNull();
+  expect(earningsEpsChange30d(event)).toBeNull();
+  expect(earningsForecastPeriod(event)).toBeNull();
+  const report = projectEarningsCalendarHeadless({ events: [event], fetchedAt: 123, stale: false }, args);
+  expect(report.rows[0]).toMatchObject({ epsEstimate: 5, epsCurrency: null, epsLow: null, epsHigh: 6, epsGrowth: null, epsAnalysts: null, epsChange30d: null, forecastPeriodEnd: null,
+    sourceEstimates: { epsEstimate: 5, epsLow: 1.2, epsGrowth: 0.5, epsAnalysts: 4, epsRevisionUp30d: 2 } });
+});
+
+test("missing averages cannot combine independently sourced range endpoints", () => {
+  const source = synthetic();
+  const trend = source.earningsTrend!.trend![0]!;
+  const calendar = source.calendarEvents!.earnings!;
+  trend.earningsEstimate!.avg = null;
+  trend.earningsEstimate!.high = null;
+  trend.revenueEstimate!.avg = null;
+  trend.revenueEstimate!.low = 80;
+  calendar.earningsAverage = undefined;
+  calendar.revenueAverage = undefined;
+  calendar.revenueHigh = 120;
+  const event = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  const report = projectEarningsCalendarHeadless({ events: [event], fetchedAt: 123, stale: false }, args);
+  expect(report.rows[0]).toMatchObject({ epsEstimate: null, epsLow: null, epsHigh: null,
+    revenueEstimate: null, revenueLow: null, revenueHigh: null,
+    sourceEstimates: { epsLow: 1.2, epsHigh: 6, revenueLow: 80, revenueHigh: 120 },
+    estimateBasis: { epsLow: { sourceValue: 120, sourceCurrency: "GBp" }, epsHigh: { sourceValue: 6, currency: null } } });
+  for (const id of ["epsRange", "revenueRange"]) {
+    expect(renderEarningsCell({ kind: "event", key: "SYN", eventIdx: 0, event }, buildEarningsColumns(240).find(c => c.id === id)!, false).text).toBe("—");
+  }
+  trend.earningsEstimate!.high = 180;
+  const samePeriod = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(coherentEarningsValue(samePeriod, "epsLow")).toBe(1.2);
+  expect(coherentEarningsValue(samePeriod, "epsHigh")).toBe(1.8);
+});
+
+test("a common fiscal end cannot assign the revenue period to an independently sourced EPS range", () => {
+  const source = synthetic();
+  source.earningsTrend!.trend![0]!.earningsEstimate = {};
+  source.earningsTrend!.trend![0]!.epsTrend = {};
+  source.earningsTrend!.trend![0]!.epsRevisions = {};
+  source.calendarEvents!.earnings!.earningsAverage = undefined;
+  const mixed = mapYahooEarningsCalendarEvent(source, "SYN")!;
+  expect(coherentEarningsValue(mixed, "epsLow")).toBe(4);
+  expect(coherentEarningsValue(mixed, "epsHigh")).toBe(6);
+  expect(earningsForecastPeriod(mixed)).toBeNull();
+  expect(mixed.estimateBasis?.revenueEstimate?.periodEndDate).toBe("2026-09-30");
+  source.calendarEvents!.earnings!.earningsLow = undefined;
+  source.calendarEvents!.earnings!.earningsHigh = undefined;
+  expect(earningsForecastPeriod(mapYahooEarningsCalendarEvent(source, "SYN")!))
+    .toEqual({ period: "0q", periodEndDate: "2026-09-30" });
+});

package/src/plugins/builtin/earnings/estimate-basis.ts

@@ -0,0 +1,76 @@
+import type { EarningsEstimateBasis, EarningsEstimateField, EarningsEvent } from "../../../types/data-provider";
+
+export const EARNINGS_ESTIMATE_FIELDS: readonly EarningsEstimateField[] = [
+  "epsEstimate", "epsLow", "epsHigh", "epsYearAgo", "epsGrowth", "epsAnalysts",
+  "epsTrend7dAgo", "epsTrend30dAgo", "epsRevisionUp7d", "epsRevisionUp30d", "epsRevisionDown7d", "epsRevisionDown30d",
+  "revenueEstimate", "revenueLow", "revenueHigh", "revenueYearAgo", "revenueGrowth", "revenueAnalysts",
+];
+const MONETARY_COMPARISONS = new Set<EarningsEstimateField>([
+  "epsLow", "epsHigh", "epsYearAgo", "epsTrend7dAgo", "epsTrend30dAgo",
+  "revenueLow", "revenueHigh", "revenueYearAgo",
+]);
+const RANGE_PEERS: Partial<Record<EarningsEstimateField, EarningsEstimateField>> = {
+  epsLow: "epsHigh", epsHigh: "epsLow",
+  revenueLow: "revenueHigh", revenueHigh: "revenueLow",
+};
+
+function finiteValue(event: EarningsEvent, field: EarningsEstimateField): number | null {
+  const value = event[field];
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+export function sameEarningsForecast(
+  left: EarningsEstimateBasis | undefined,
+  right: EarningsEstimateBasis | undefined,
+): boolean {
+  if (!left || !right || left.source !== right.source) return false;
+  if (left.source === "calendarEvents") return true;
+  return !!left.period && !!left.periodEndDate
+    && left.period === right.period && left.periodEndDate === right.periodEndDate;
+}
+
+/** Do not present a trend-only range/count/growth as describing a calendar fallback. */
+export function coherentEarningsValue(event: EarningsEvent, field: EarningsEstimateField): number | null {
+  const value = finiteValue(event, field);
+  if (value == null || field === "epsEstimate" || field === "revenueEstimate") return value;
+  const average = field.startsWith("eps") ? "epsEstimate" : "revenueEstimate";
+  const basis = event.estimateBasis?.[field];
+  if (finiteValue(event, average) == null) {
+    const peer = RANGE_PEERS[field];
+    const peerBasis = peer ? event.estimateBasis?.[peer] : undefined;
+    if (peer && finiteValue(event, peer) != null
+      && (!sameEarningsForecast(basis, peerBasis) || (basis?.currency ?? null) !== (peerBasis?.currency ?? null))) return null;
+    return value;
+  }
+  const averageBasis = event.estimateBasis?.[average];
+  if (!sameEarningsForecast(basis, averageBasis)) return null;
+  if (MONETARY_COMPARISONS.has(field) && (basis?.currency ?? null) !== (averageBasis?.currency ?? null)) return null;
+  return value;
+}
+
+export function earningsEpsChange30d(event: EarningsEvent): number | null {
+  const current = finiteValue(event, "epsEstimate");
+  const prior = finiteValue(event, "epsTrend30dAgo");
+  const currentBasis = event.estimateBasis?.epsEstimate;
+  const priorBasis = event.estimateBasis?.epsTrend30dAgo;
+  if (current == null || prior == null || !sameEarningsForecast(currentBasis, priorBasis)
+    || !currentBasis?.period || !currentBasis.periodEndDate
+    || !currentBasis.currency || !/^[A-Z]{3}$/.test(currentBasis.currency) || currentBasis.currency === "XXX"
+    || currentBasis.currency !== priorBasis?.currency) return null;
+  return current - prior;
+}
+
+/** A single fiscal-end column must not assign one field's period to other available estimates. */
+export function earningsForecastPeriod(event: EarningsEvent): { period: string; periodEndDate: string } | null {
+  const bases = EARNINGS_ESTIMATE_FIELDS
+    .filter(field => coherentEarningsValue(event, field) != null)
+    .map(field => event.estimateBasis?.[field]);
+  const first = bases[0];
+  if (!first?.period || !first.periodEndDate || bases.some(basis => !sameEarningsForecast(first, basis))) return null;
+  return { period: first.period, periodEndDate: first.periodEndDate };
+}
+
+/** Source-selected values after normalization; literal provider amounts remain in estimateBasis. */
+export function earningsSourceEstimates(event: EarningsEvent): Record<string, number | null> {
+  return Object.fromEntries(EARNINGS_ESTIMATE_FIELDS.map(field => [field, finiteValue(event, field)]));
+}

package/src/plugins/builtin/earnings/estimate-fixtures.test-data.ts

@@ -0,0 +1,327 @@
+import type { YahooQuoteSummaryResult } from "../../../sources/yahoo-finance/types";
+
+// Relevant fields from captured Yahoo calendar/0q trend modules, 2026-09-12.
+// Display strings and unrelated modules omitted; provider values and currencies unchanged.
+export const recordedEarnings: Record<string, YahooQuoteSummaryResult> = {
+  "SONY": {
+    "quoteType": {
+      "shortName": "Sony Group Corporation",
+      "longName": "Sony Group Corporation"
+    },
+    "calendarEvents": {
+      "earnings": {
+        "earningsDate": [
+          { "raw": 1793881800 }
+        ],
+        "earningsCallDate": [],
+        "isEarningsDateEstimate": false,
+        "earningsAverage": {},
+        "earningsLow": {},
+        "earningsHigh": {},
+        "revenueAverage": { "raw": 3148616803450 },
+        "revenueLow": { "raw": 3040688221520 },
+        "revenueHigh": { "raw": 3325900000000 }
+      }
+    },
+    "earningsTrend": {
+      "trend": [
+        {
+          "period": "0q",
+          "endDate": "2026-09-30",
+          "earningsEstimate": {
+            "avg": { "raw": 0.33459 },
+            "low": { "raw": 0.33459 },
+            "high": { "raw": 0.33459 },
+            "yearAgoEps": { "raw": 0.33591 },
+            "numberOfAnalysts": { "raw": 1 },
+            "growth": { "raw": -0.0039 },
+            "earningsCurrency": "USD"
+          },
+          "revenueEstimate": {
+            "avg": { "raw": 3148616803450 },
+            "low": { "raw": 3040688221520 },
+            "high": { "raw": 3325900000000 },
+            "numberOfAnalysts": { "raw": 10 },
+            "yearAgoRevenue": { "raw": 3107900000000 },
+            "growth": { "raw": 0.013099999 },
+            "revenueCurrency": "JPY"
+          },
+          "epsTrend": {
+            "current": { "raw": 0.33459 },
+            "7daysAgo": { "raw": 0.33459 },
+            "30daysAgo": { "raw": 0.33459 },
+            "60daysAgo": { "raw": 0.33459 },
+            "90daysAgo": { "raw": 0.33788 },
+            "epsTrendCurrency": "USD"
+          },
+          "epsRevisions": {
+            "upLast7days": { "raw": 0 },
+            "upLast30days": { "raw": 0 },
+            "downLast30days": { "raw": 1 },
+            "downLast7Days": { "raw": 1 },
+            "downLast90days": {},
+            "epsRevisionsCurrency": "USD"
+          }
+        }
+      ]
+    }
+  },
+  "6758.T": {
+    "quoteType": {
+      "shortName": "SONY GROUP CORPORATION",
+      "longName": "Sony Group Corporation"
+    },
+    "calendarEvents": {
+      "earnings": {
+        "earningsDate": [
+          { "raw": 1793860200 }
+        ],
+        "earningsCallDate": [],
+        "isEarningsDateEstimate": false,
+        "earningsAverage": {},
+        "earningsLow": {},
+        "earningsHigh": {},
+        "revenueAverage": { "raw": 3148616803450 },
+        "revenueLow": { "raw": 3040688221520 },
+        "revenueHigh": { "raw": 3325900000000 }
+      }
+    },
+    "earningsTrend": {
+      "trend": [
+        {
+          "period": "0q",
+          "endDate": "2026-09-30",
+          "earningsEstimate": {
+            "avg": { "raw": 63.08788 },
+            "low": { "raw": 56.6 },
+            "high": { "raw": 68.5 },
+            "yearAgoEps": { "raw": 60.43 },
+            "numberOfAnalysts": { "raw": 5 },
+            "growth": { "raw": 0.044 },
+            "earningsCurrency": "JPY"
+          },
+          "revenueEstimate": {
+            "avg": { "raw": 3148616803450 },
+            "low": { "raw": 3040688221520 },
+            "high": { "raw": 3325900000000 },
+            "numberOfAnalysts": { "raw": 10 },
+            "yearAgoRevenue": { "raw": 3107900000000 },
+            "growth": { "raw": 0.013099999 },
+            "revenueCurrency": "JPY"
+          },
+          "epsTrend": {
+            "current": { "raw": 63.08788 },
+            "7daysAgo": { "raw": 63.08788 },
+            "30daysAgo": { "raw": 63.08788 },
+            "60daysAgo": { "raw": 58.24652 },
+            "90daysAgo": { "raw": 57.65721 },
+            "epsTrendCurrency": "JPY"
+          },
+          "epsRevisions": {
+            "upLast7days": { "raw": 4 },
+            "upLast30days": { "raw": 5 },
+            "downLast30days": { "raw": 0 },
+            "downLast7Days": { "raw": 0 },
+            "downLast90days": {},
+            "epsRevisionsCurrency": "JPY"
+          }
+        }
+      ]
+    }
+  },
+  "BABA": {
+    "quoteType": {
+      "shortName": "Alibaba Group Holding Limited",
+      "longName": "Alibaba Group Holding Limited"
+    },
+    "calendarEvents": {
+      "earnings": {
+        "earningsDate": [
+          { "raw": 1795523400 }
+        ],
+        "earningsCallDate": [
+          { "raw": 1787225400 }
+        ],
+        "isEarningsDateEstimate": true,
+        "earningsAverage": { "raw": 10.97892 },
+        "earningsLow": { "raw": 8.59 },
+        "earningsHigh": { "raw": 15.46022 },
+        "revenueAverage": { "raw": 270450881010 },
+        "revenueLow": { "raw": 263355000000 },
+        "revenueHigh": { "raw": 279044566170 }
+      }
+    },
+    "earningsTrend": {
+      "trend": [
+        {
+          "period": "0q",
+          "endDate": "2026-09-30",
+          "earningsEstimate": {
+            "avg": { "raw": 10.97892 },
+            "low": { "raw": 8.59 },
+            "high": { "raw": 15.46022 },
+            "yearAgoEps": { "raw": 4.36 },
+            "numberOfAnalysts": { "raw": 17 },
+            "growth": { "raw": 1.5181 },
+            "earningsCurrency": "CNY"
+          },
+          "revenueEstimate": {
+            "avg": { "raw": 270450881010 },
+            "low": { "raw": 263355000000 },
+            "high": { "raw": 279044566170 },
+            "numberOfAnalysts": { "raw": 19 },
+            "yearAgoRevenue": { "raw": 247795000000 },
+            "growth": { "raw": 0.091400005 },
+            "revenueCurrency": "CNY"
+          },
+          "epsTrend": {
+            "current": { "raw": 10.97892 },
+            "7daysAgo": { "raw": 10.97892 },
+            "30daysAgo": { "raw": 9.84987 },
+            "60daysAgo": { "raw": 9.68862 },
+            "90daysAgo": { "raw": 9.54759 },
+            "epsTrendCurrency": "CNY"
+          },
+          "epsRevisions": {
+            "upLast7days": { "raw": 2 },
+            "upLast30days": { "raw": 11 },
+            "downLast30days": { "raw": 3 },
+            "downLast7Days": { "raw": 0 },
+            "downLast90days": {},
+            "epsRevisionsCurrency": "CNY"
+          }
+        }
+      ]
+    }
+  },
+  "9988.HK": {
+    "quoteType": {
+      "shortName": "BABA-W",
+      "longName": "Alibaba Group Holding Limited"
+    },
+    "calendarEvents": {
+      "earnings": {
+        "earningsDate": [
+          { "raw": 1795507800 }
+        ],
+        "earningsCallDate": [
+          { "raw": 1787225400 }
+        ],
+        "isEarningsDateEstimate": true,
+        "earningsAverage": { "raw": 1.47221 },
+        "earningsLow": { "raw": 1.29442 },
+        "earningsHigh": { "raw": 1.93253 },
+        "revenueAverage": { "raw": 270450881010 },
+        "revenueLow": { "raw": 263355000000 },
+        "revenueHigh": { "raw": 279044566170 }
+      }
+    },
+    "earningsTrend": {
+      "trend": [
+        {
+          "period": "0q",
+          "endDate": "2026-09-30",
+          "earningsEstimate": {
+            "avg": { "raw": 1.47221 },
+            "low": { "raw": 1.29442 },
+            "high": { "raw": 1.93253 },
+            "yearAgoEps": { "raw": 0.55 },
+            "numberOfAnalysts": { "raw": 5 },
+            "growth": { "raw": 1.6767 },
+            "earningsCurrency": "CNY"
+          },
+          "revenueEstimate": {
+            "avg": { "raw": 270450881010 },
+            "low": { "raw": 263355000000 },
+            "high": { "raw": 279044566170 },
+            "numberOfAnalysts": { "raw": 19 },
+            "yearAgoRevenue": { "raw": 247795000000 },
+            "growth": { "raw": 0.091400005 },
+            "revenueCurrency": "CNY"
+          },
+          "epsTrend": {
+            "current": { "raw": 1.47221 },
+            "7daysAgo": { "raw": 1.27619 },
+            "30daysAgo": { "raw": 1.27619 },
+            "60daysAgo": { "raw": 1.19985 },
+            "90daysAgo": { "raw": 1.19985 },
+            "epsTrendCurrency": "CNY"
+          },
+          "epsRevisions": {
+            "upLast7days": { "raw": 1 },
+            "upLast30days": { "raw": 4 },
+            "downLast30days": { "raw": 1 },
+            "downLast7Days": { "raw": 0 },
+            "downLast90days": {},
+            "epsRevisionsCurrency": "CNY"
+          }
+        }
+      ]
+    }
+  },
+  "AAPL": {
+    "quoteType": {
+      "shortName": "Apple Inc.",
+      "longName": "Apple Inc."
+    },
+    "calendarEvents": {
+      "earnings": {
+        "earningsDate": [
+          { "raw": 1793304000 }
+        ],
+        "earningsCallDate": [
+          { "raw": 1785441600 }
+        ],
+        "isEarningsDateEstimate": false,
+        "earningsAverage": { "raw": 1.98124 },
+        "earningsLow": { "raw": 1.93 },
+        "earningsHigh": { "raw": 2.07 },
+        "revenueAverage": { "raw": 113624521680 },
+        "revenueLow": { "raw": 112248100000 },
+        "revenueHigh": { "raw": 117219700000 }
+      }
+    },
+    "earningsTrend": {
+      "trend": [
+        {
+          "period": "0q",
+          "endDate": "2026-09-30",
+          "earningsEstimate": {
+            "avg": { "raw": 1.97754 },
+            "low": { "raw": 1.93 },
+            "high": { "raw": 2.07 },
+            "yearAgoEps": { "raw": 1.85 },
+            "numberOfAnalysts": { "raw": 27 },
+            "growth": { "raw": 0.0689 },
+            "earningsCurrency": "USD"
+          },
+          "revenueEstimate": {
+            "avg": { "raw": 113624521680 },
+            "low": { "raw": 112248100000 },
+            "high": { "raw": 117219700000 },
+            "numberOfAnalysts": { "raw": 27 },
+            "yearAgoRevenue": { "raw": 102466000000 },
+            "growth": { "raw": 0.1089 },
+            "revenueCurrency": "USD"
+          },
+          "epsTrend": {
+            "current": { "raw": 1.97754 },
+            "7daysAgo": { "raw": 1.97656 },
+            "30daysAgo": { "raw": 1.97656 },
+            "60daysAgo": { "raw": 2.00825 },
+            "90daysAgo": { "raw": 2.00801 },
+            "epsTrendCurrency": "USD"
+          },
+          "epsRevisions": {
+            "upLast7days": { "raw": 1 },
+            "upLast30days": { "raw": 7 },
+            "downLast30days": { "raw": 14 },
+            "downLast7Days": { "raw": 0 },
+            "downLast90days": {},
+            "epsRevisionsCurrency": "USD"
+          }
+        }
+      ]
+    }
+  }
+};

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

@@ -1,4 +1,5 @@
 import type { EarningsEvent } from "../../../types/data-provider";
+import { coherentEarningsValue, earningsEpsChange30d, earningsForecastPeriod, earningsSourceEstimates } from "./estimate-basis";
 import type {
   HeadlessPaneContext,
   HeadlessPaneDefinition,
@@ -16,6 +17,8 @@ const EARNINGS_COLUMNS = [
   { key: "dateStatus", header: "Status" },
   { key: "symbol", header: "Ticker" },
   { key: "name", header: "Name" },
+  { key: "forecastPeriodEnd", header: "Forecast end" },
+  { key: "epsCurrency", header: "EPS ccy" },
   { key: "epsEstimate", header: "EPS est", align: "right" as const },
   { key: "epsLow", header: "EPS low", align: "right" as const },
   { key: "epsHigh", header: "EPS high", align: "right" as const },
@@ -23,6 +26,7 @@ const EARNINGS_COLUMNS = [
   { key: "epsTrend30dAgo", header: "EPS 30D ago", align: "right" as const },
   { key: "epsRevisionUp30d", header: "Rev up", align: "right" as const },
   { key: "epsRevisionDown30d", header: "Rev down", align: "right" as const },
+  { key: "revenueCurrency", header: "Sales ccy" },
   { key: "revenueEstimate", header: "Sales est", align: "right" as const },
   { key: "revenueLow", header: "Sales low", align: "right" as const },
   { key: "revenueHigh", header: "Sales high", align: "right" as const },
@@ -60,25 +64,32 @@ function eventRow(event: EarningsEvent) {
         : "confirmed",
     symbol: event.symbol,
     name: event.name,
-    epsEstimate: event.epsEstimate ?? null,
-    epsLow: event.epsLow ?? null,
-    epsHigh: event.epsHigh ?? null,
-    epsYearAgo: event.epsYearAgo ?? null,
-    epsGrowth: event.epsGrowth ?? null,
-    epsAnalysts: event.epsAnalysts ?? null,
-    epsTrend7dAgo: event.epsTrend7dAgo ?? null,
-    epsTrend30dAgo: event.epsTrend30dAgo ?? null,
-    epsRevisionUp7d: event.epsRevisionUp7d ?? null,
-    epsRevisionUp30d: event.epsRevisionUp30d ?? null,
-    epsRevisionDown7d: event.epsRevisionDown7d ?? null,
-    epsRevisionDown30d: event.epsRevisionDown30d ?? null,
+    epsCurrency: event.estimateBasis?.epsEstimate?.currency ?? null,
+    revenueCurrency: event.estimateBasis?.revenueEstimate?.currency ?? null,
+    forecastPeriod: earningsForecastPeriod(event)?.period ?? null,
+    forecastPeriodEnd: earningsForecastPeriod(event)?.periodEndDate ?? null,
+    estimateBasis: event.estimateBasis ?? {},
+    sourceEstimates: earningsSourceEstimates(event),
+    epsChange30d: earningsEpsChange30d(event),
+    epsEstimate: coherentEarningsValue(event, "epsEstimate"),
+    epsLow: coherentEarningsValue(event, "epsLow"),
+    epsHigh: coherentEarningsValue(event, "epsHigh"),
+    epsYearAgo: coherentEarningsValue(event, "epsYearAgo"),
+    epsGrowth: coherentEarningsValue(event, "epsGrowth"),
+    epsAnalysts: coherentEarningsValue(event, "epsAnalysts"),
+    epsTrend7dAgo: coherentEarningsValue(event, "epsTrend7dAgo"),
+    epsTrend30dAgo: coherentEarningsValue(event, "epsTrend30dAgo"),
+    epsRevisionUp7d: coherentEarningsValue(event, "epsRevisionUp7d"),
+    epsRevisionUp30d: coherentEarningsValue(event, "epsRevisionUp30d"),
+    epsRevisionDown7d: coherentEarningsValue(event, "epsRevisionDown7d"),
+    epsRevisionDown30d: coherentEarningsValue(event, "epsRevisionDown30d"),
     epsActual: event.epsActual ?? null,
-    revenueEstimate: event.revenueEstimate ?? null,
-    revenueLow: event.revenueLow ?? null,
-    revenueHigh: event.revenueHigh ?? null,
-    revenueYearAgo: event.revenueYearAgo ?? null,
-    revenueGrowth: event.revenueGrowth ?? null,
-    revenueAnalysts: event.revenueAnalysts ?? null,
+    revenueEstimate: coherentEarningsValue(event, "revenueEstimate"),
+    revenueLow: coherentEarningsValue(event, "revenueLow"),
+    revenueHigh: coherentEarningsValue(event, "revenueHigh"),
+    revenueYearAgo: coherentEarningsValue(event, "revenueYearAgo"),
+    revenueGrowth: coherentEarningsValue(event, "revenueGrowth"),
+    revenueAnalysts: coherentEarningsValue(event, "revenueAnalysts"),
     revenueActual: event.revenueActual ?? null,
     surprise: event.surprise ?? null,
   };