gloomberb 0.5.0 → 0.6.0

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

@@ -1,15 +1,13 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { TextAttributes, type ScrollBoxRenderable } from "@opentui/core";
-import { useKeyboard } from "@opentui/react";
-import { DataTable, type DataTableCell, type DataTableColumn } from "../../../components";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { TextAttributes } from "../../../ui";
+import { DataTableView, usePaneFooter, type DataTableCell, type DataTableColumn, type DataTableKeyEvent } from "../../../components";
 import type { GloomPlugin, PaneProps } from "../../../types/plugin";
 import type { EarningsEvent } from "../../../types/data-provider";
 import { colors } from "../../../theme/colors";
-import { getSharedDataProvider } from "../../registry";
 import { useAppSelector, getFocusedCollectionId } from "../../../state/app-context";
 import { getCollectionTickers } from "../../../state/selectors";
-import { formatCompact } from "../../../utils/format";
-import { usePluginPaneState, usePluginTickerActions } from "../../plugin-runtime";
+import { formatCompact, formatNumber, formatPercent } from "../../../utils/format";
+import { useAssetData, usePluginPaneState, usePluginTickerActions } from "../../plugin-runtime";
 import {
   attachEarningsCalendarPersistence,
   loadEarningsCalendar,
@@ -20,7 +18,21 @@ type DisplayRow =
   | { kind: "separator"; key: string; label: string }
   | { kind: "event"; key: string; event: EarningsEvent; eventIdx: number };
 
-type EarningsColumnId = "date" | "symbol" | "name" | "epsEstimate" | "revenueEstimate";
+type EarningsColumnId =
+  | "date"
+  | "when"
+  | "status"
+  | "symbol"
+  | "name"
+  | "epsEstimate"
+  | "epsRange"
+  | "epsGrowth"
+  | "epsTrend"
+  | "epsRevisions"
+  | "revenueEstimate"
+  | "revenueRange"
+  | "revenueGrowth"
+  | "analysts";
 type EarningsColumn = DataTableColumn & { id: EarningsColumnId };
 
 function groupByRelativeDate(events: EarningsEvent[]): DisplayRow[] {
@@ -83,33 +95,90 @@ function formatDate(date: Date): string {
   return `${MONTH_NAMES[date.getMonth()]} ${date.getDate()}`;
 }
 
+function formatTime(date: Date | null | undefined): string {
+  if (!date) return "—";
+  return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+}
+
+function formatMaybeNumber(value: number | null | undefined, decimals = 2): string {
+  return value == null ? "—" : formatNumber(value, decimals);
+}
+
+function formatRange(
+  low: number | null | undefined,
+  high: number | null | undefined,
+  formatter: (value: number) => string,
+): string {
+  if (low == null && high == null) return "—";
+  return `${low == null ? "—" : formatter(low)}-${high == null ? "—" : formatter(high)}`;
+}
+
+function formatRevisionSummary(event: EarningsEvent): string {
+  const up = event.epsRevisionUp30d ?? event.epsRevisionUp7d;
+  const down = event.epsRevisionDown30d ?? event.epsRevisionDown7d;
+  if (up == null && down == null) return "—";
+  return `${up ?? 0}/${down ?? 0}`;
+}
+
+function formatAnalystSummary(event: EarningsEvent): string {
+  const eps = event.epsAnalysts;
+  const revenue = event.revenueAnalysts;
+  if (eps == null && revenue == null) return "—";
+  if (eps === revenue || revenue == null) return String(eps);
+  if (eps == null) return String(revenue);
+  return `${eps}/${revenue}`;
+}
+
+function estimateColor(value: number | null | undefined, selectedColor: string | undefined): string | undefined {
+  if (selectedColor) return selectedColor;
+  if (value == null) return colors.textDim;
+  return value >= 0 ? colors.positive : colors.negative;
+}
+
 function buildColumns(width: number): EarningsColumn[] {
   const dateWidth = 8;
+  const whenWidth = 8;
+  const statusWidth = 4;
   const symbolWidth = 8;
-  const epsWidth = 10;
-  const revenueWidth = 10;
-  const columnCount = 5;
-  const fixedWidth = dateWidth + symbolWidth + epsWidth + revenueWidth;
-  const nameWidth = Math.max(12, width - 2 - columnCount - fixedWidth);
+  const epsWidth = 8;
+  const epsRangeWidth = 11;
+  const growthWidth = 8;
+  const trendWidth = 8;
+  const revisionsWidth = 7;
+  const revenueWidth = 9;
+  const revenueRangeWidth = 13;
+  const analystsWidth = 7;
+  const columnCount = 14;
+  const fixedWidth = dateWidth + whenWidth + statusWidth + symbolWidth + epsWidth
+    + epsRangeWidth + growthWidth + trendWidth + revisionsWidth + revenueWidth
+    + revenueRangeWidth + growthWidth + analystsWidth;
+  const nameWidth = Math.max(14, width - 2 - columnCount - fixedWidth);
 
   return [
     { id: "date", label: "DATE", width: dateWidth, align: "left" },
+    { id: "when", label: "WHEN", width: whenWidth, align: "left" },
+    { id: "status", label: "ST", width: statusWidth, align: "left" },
     { id: "symbol", label: "TICKER", width: symbolWidth, align: "left" },
     { id: "name", label: "NAME", width: nameWidth, align: "left" },
-    { id: "epsEstimate", label: "EPS EST", width: epsWidth, align: "right" },
-    { id: "revenueEstimate", label: "REV EST", width: revenueWidth, align: "right" },
+    { id: "epsEstimate", label: "EPS", width: epsWidth, align: "right" },
+    { id: "epsRange", label: "EPS RNG", width: epsRangeWidth, align: "right" },
+    { id: "epsGrowth", label: "EPS YOY", width: growthWidth, align: "right" },
+    { id: "epsTrend", label: "EPS 30D", width: trendWidth, align: "right" },
+    { id: "epsRevisions", label: "REV", width: revisionsWidth, align: "right" },
+    { id: "revenueEstimate", label: "SALES", width: revenueWidth, align: "right" },
+    { id: "revenueRange", label: "SALES RNG", width: revenueRangeWidth, align: "right" },
+    { id: "revenueGrowth", label: "SALES YOY", width: growthWidth, align: "right" },
+    { id: "analysts", label: "ANL", width: analystsWidth, align: "right" },
   ];
 }
 
 function EarningsCalendarPane({ focused, width, height }: PaneProps) {
+  const dataProvider = useAssetData();
   const { navigateTicker } = usePluginTickerActions();
   const [events, setEvents] = useState<EarningsEvent[]>([]);
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const [selectedIdx, setSelectedIdx] = usePluginPaneState<number>("selectedIdx", 0);
-  const [hoveredIdx, setHoveredIdx] = useState<number | null>(null);
-  const scrollRef = useRef<ScrollBoxRenderable>(null);
-  const headerScrollRef = useRef<ScrollBoxRenderable>(null);
 
   const state = useAppSelector((current) => current);
   const collectionId = getFocusedCollectionId(state);
@@ -130,18 +199,6 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
   const selectedRowIndex = rows.findIndex((row) => row.kind === "event" && row.eventIdx === activeEventIdx);
   const columns = useMemo(() => buildColumns(width), [width]);
 
-  const syncHeaderScroll = useCallback(() => {
-    const bodyScrollBox = scrollRef.current;
-    const headerScrollBox = headerScrollRef.current;
-    if (bodyScrollBox && headerScrollBox && headerScrollBox.scrollLeft !== bodyScrollBox.scrollLeft) {
-      headerScrollBox.scrollLeft = bodyScrollBox.scrollLeft;
-    }
-  }, []);
-
-  const handleBodyScrollActivity = useCallback(() => {
-    syncHeaderScroll();
-  }, [syncHeaderScroll]);
-
   const reload = useCallback((force = false) => {
     if (tickerSymbols.length === 0) {
       setEvents([]);
@@ -150,10 +207,9 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
       return;
     }
 
-    const provider = getSharedDataProvider();
     setLoading(true);
     setError(null);
-    loadEarningsCalendar(provider, tickerSymbols, { force })
+    loadEarningsCalendar(dataProvider, tickerSymbols, { force })
       .then((data) => {
         setEvents(data);
       })
@@ -163,7 +219,7 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
       .finally(() => {
         setLoading(false);
       });
-  }, [tickerSymbols]);
+  }, [dataProvider, tickerSymbols]);
 
   useEffect(() => {
     reload(false);
@@ -175,34 +231,18 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
     }
   }, [eventCount, selectedIdx, setSelectedIdx]);
 
-  useEffect(() => {
-    const scrollBox = scrollRef.current;
-    if (!scrollBox || selectedRowIndex < 0) return;
-    scrollBox.scrollTo?.(0, Math.max(0, selectedRowIndex - Math.floor((height - 3) / 2)));
-  }, [height, selectedRowIndex]);
-
   const openEvent = useCallback((event: EarningsEvent) => {
     navigateTicker(event.symbol);
   }, [navigateTicker]);
 
-  const selectEventIndex = useCallback((index: number) => {
-    if (eventCount === 0) return;
-    setSelectedIdx(Math.min(Math.max(index, 0), eventCount - 1));
-  }, [eventCount, setSelectedIdx]);
-
-  useKeyboard((event) => {
-    if (!focused) return;
-    if (event.name === "j" || event.name === "down") {
-      selectEventIndex(activeEventIdx + 1);
-    } else if (event.name === "k" || event.name === "up") {
-      selectEventIndex(activeEventIdx - 1);
-    } else if (event.name === "return" || event.name === "enter") {
-      const selected = eventRows[activeEventIdx];
-      if (selected) openEvent(selected.event);
-    } else if (event.name === "r") {
+  const handleTableKeyDown = useCallback((event: DataTableKeyEvent) => {
+    if (event.name === "r") {
+      event.preventDefault?.();
       reload(true);
+      return true;
     }
-  });
+    return false;
+  }, [reload]);
 
   const selectDisplayRow = useCallback((row: DisplayRow) => {
     if (row.kind !== "event") return;
@@ -234,6 +274,22 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
     switch (column.id) {
       case "date":
         return { text: formatDate(row.event.earningsDate), color: selectedColor ?? colors.textDim };
+      case "when":
+        return {
+          text: row.event.timing || formatTime(row.event.earningsCallDate),
+          color: selectedColor ?? colors.textDim,
+        };
+      case "status":
+        if (row.event.isDateEstimate == null) {
+          return {
+            text: "—",
+            color: selectedColor ?? colors.textDim,
+          };
+        }
+        return {
+          text: row.event.isDateEstimate === true ? "est" : "firm",
+          color: selectedColor ?? (row.event.isDateEstimate === true ? colors.warning : colors.textDim),
+        };
       case "symbol":
         return {
           text: row.event.symbol,
@@ -244,56 +300,93 @@ function EarningsCalendarPane({ focused, width, height }: PaneProps) {
         return { text: row.event.name, color: selectedColor ?? colors.text };
       case "epsEstimate":
         return {
-          text: row.event.epsEstimate != null ? row.event.epsEstimate.toFixed(2) : "—",
+          text: formatMaybeNumber(row.event.epsEstimate),
+          color: selectedColor ?? colors.textDim,
+        };
+      case "epsRange":
+        return {
+          text: formatRange(row.event.epsLow, row.event.epsHigh, (value) => formatNumber(value, 2)),
           color: selectedColor ?? colors.textDim,
         };
+      case "epsGrowth":
+        return {
+          text: row.event.epsGrowth != null ? formatPercent(row.event.epsGrowth) : "—",
+          color: estimateColor(row.event.epsGrowth, selectedColor),
+        };
+      case "epsTrend": {
+        const current = row.event.epsEstimate;
+        const prior = row.event.epsTrend30dAgo ?? row.event.epsTrend7dAgo;
+        const change = current != null && prior != null ? current - prior : null;
+        return {
+          text: change != null ? formatNumber(change, 2) : "—",
+          color: estimateColor(change, selectedColor),
+        };
+      }
+      case "epsRevisions": {
+        const net = (row.event.epsRevisionUp30d ?? row.event.epsRevisionUp7d ?? 0)
+          - (row.event.epsRevisionDown30d ?? row.event.epsRevisionDown7d ?? 0);
+        return {
+          text: formatRevisionSummary(row.event),
+          color: selectedColor ?? (net > 0 ? colors.positive : net < 0 ? colors.negative : colors.textDim),
+        };
+      }
       case "revenueEstimate":
         return {
           text: row.event.revenueEstimate != null ? formatCompact(row.event.revenueEstimate) : "—",
           color: selectedColor ?? colors.textDim,
         };
+      case "revenueRange":
+        return {
+          text: formatRange(row.event.revenueLow, row.event.revenueHigh, formatCompact),
+          color: selectedColor ?? colors.textDim,
+        };
+      case "revenueGrowth":
+        return {
+          text: row.event.revenueGrowth != null ? formatPercent(row.event.revenueGrowth) : "—",
+          color: estimateColor(row.event.revenueGrowth, selectedColor),
+        };
+      case "analysts":
+        return {
+          text: formatAnalystSummary(row.event),
+          color: selectedColor ?? colors.textDim,
+        };
     }
   }, []);
 
+  usePaneFooter("earnings-calendar", () => ({
+    info: [
+      ...(loading ? [{ id: "loading", parts: [{ text: "loading", tone: "muted" as const }] }] : []),
+      ...(error ? [{ id: "error", parts: [{ text: error, tone: "warning" as const }] }] : []),
+    ],
+    hints: [{ id: "refresh", key: "r", label: "efresh", onPress: () => reload(true) }],
+  }), [error, loading, reload]);
+
   return (
-    <box flexDirection="column" width={width} height={height}>
-      <box height={1} paddingX={1} flexDirection="row">
-        <text fg={colors.textDim}>
-          {loading ? "loading..." : `${eventCount} upcoming`}
-        </text>
-      </box>
-
-      {error ? (
-        <box paddingX={1}>
-          <text fg={colors.negative}>{error}</text>
-        </box>
-      ) : null}
-
-      <DataTable<DisplayRow, EarningsColumn>
-        columns={columns}
-        items={rows}
-        sortColumnId={null}
-        sortDirection="asc"
-        onHeaderClick={() => {}}
-        headerScrollRef={headerScrollRef}
-        scrollRef={scrollRef}
-        syncHeaderScroll={syncHeaderScroll}
-        onBodyScrollActivity={handleBodyScrollActivity}
-        hoveredIdx={hoveredIdx}
-        setHoveredIdx={setHoveredIdx}
-        getItemKey={(row) => row.key}
-        isSelected={(row) => row.kind === "event" && row.eventIdx === activeEventIdx}
-        onSelect={selectDisplayRow}
-        renderSectionHeader={renderSectionHeader}
-        renderCell={renderCell}
-        emptyStateTitle={loading ? "Loading earnings..." : "No upcoming earnings found"}
-        showHorizontalScrollbar={false}
-      />
-
-      <box height={1} paddingX={1}>
-        <text fg={colors.textMuted}>[r]efresh</text>
-      </box>
-    </box>
+    <DataTableView<DisplayRow, EarningsColumn>
+      focused={focused}
+      selectedIndex={selectedRowIndex}
+      isNavigable={(row) => row.kind === "event"}
+      onSelectIndex={(_index, row) => {
+        if (row.kind === "event") setSelectedIdx(row.eventIdx);
+      }}
+      onActivateIndex={(_index, row) => {
+        if (row.kind === "event") openEvent(row.event);
+      }}
+      onRootKeyDown={handleTableKeyDown}
+      rootWidth={width}
+      rootHeight={height}
+      columns={columns}
+      items={rows}
+      sortColumnId={null}
+      sortDirection="asc"
+      onHeaderClick={() => {}}
+      getItemKey={(row) => row.key}
+      isSelected={(row) => row.kind === "event" && row.eventIdx === activeEventIdx}
+      onSelect={selectDisplayRow}
+      renderSectionHeader={renderSectionHeader}
+      renderCell={renderCell}
+      emptyStateTitle={loading ? "Loading earnings..." : "No upcoming earnings found"}
+    />
   );
 }
 

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

@@ -1,121 +1,14 @@
-import type { PersistedResourceValue } from "../../../types/persistence";
-import type { PluginPersistence } from "../../../types/plugin";
-import { createThrottledFetch } from "../../../utils/throttled-fetch";
-import type { EconEvent, EconImpact } from "./types";
+import { apiClient, type CloudEconEventPayload } from "../../../utils/api-client";
+import type { EconEvent } from "./types";
 
-const CALENDAR_URL = "https://nfs.faireconomy.media/ff_calendar_thisweek.json";
-const CACHE_KIND = "calendar";
-const CACHE_KEY = "this-week";
-const CACHE_SOURCE = "forexfactory";
-export const ECON_CALENDAR_CACHE_POLICY = {
-  staleMs: 30 * 60 * 1000,
-  expireMs: 7 * 24 * 60 * 60 * 1000,
-} as const;
-
-let econCalendarPersistence: PluginPersistence | null = null;
-
-const calendarClient = createThrottledFetch({
-  requestsPerMinute: 5,
-  maxRetries: 2,
-  timeoutMs: 15_000,
-  defaultHeaders: {
-    "User-Agent": "Gloomberb/0.4.1",
-    Accept: "application/json",
-  },
-});
-
-export function attachEconCalendarPersistence(persistence: PluginPersistence): void {
-  econCalendarPersistence = persistence;
-}
-
-export function resetEconCalendarPersistence(): void {
-  econCalendarPersistence = null;
-}
-
-function readCalendarCache(options?: {
-  allowExpired?: boolean;
-}): PersistedResourceValue<unknown> | null {
-  return econCalendarPersistence?.getResource<unknown>(CACHE_KIND, CACHE_KEY, {
-    sourceKey: CACHE_SOURCE,
-    allowExpired: options?.allowExpired,
-  }) ?? null;
-}
-
-function writeCalendarCache(data: unknown): void {
-  econCalendarPersistence?.setResource(CACHE_KIND, CACHE_KEY, data, {
-    sourceKey: CACHE_SOURCE,
-    cachePolicy: ECON_CALENDAR_CACHE_POLICY,
-  });
-}
-
-const CURRENCY_TO_COUNTRY: Record<string, string> = {
-  USD: "US", EUR: "EU", GBP: "GB", JPY: "JP", CAD: "CA",
-  AUD: "AU", CHF: "CH", CNY: "CN", NZD: "NZ", SEK: "SE",
-  All: "--",
-};
-
-function resolveCountry(currency: string): string {
-  return CURRENCY_TO_COUNTRY[currency] ?? currency.slice(0, 2);
-}
-
-function resolveImpact(raw: string): EconImpact {
-  const lower = raw.toLowerCase();
-  if (lower === "high") return "high";
-  if (lower === "medium") return "medium";
-  return "low";
-}
-
-interface RawCalendarEvent {
-  title: string;
-  country: string;
-  date: string;
-  impact: string;
-  forecast: string;
-  previous: string;
-}
-
-export function parseCalendarJson(data: unknown): EconEvent[] {
-  if (!Array.isArray(data)) return [];
-
-  return data
-    .filter((entry: any) => entry?.title && entry?.date)
-    .filter((entry: any) => entry.impact !== "Holiday")
-    .map((entry: any, idx: number): EconEvent => {
-      const raw = entry as RawCalendarEvent;
-      const date = new Date(raw.date);
-      const hours = date.getHours().toString().padStart(2, "0");
-      const minutes = date.getMinutes().toString().padStart(2, "0");
-      const time = `${hours}:${minutes}`;
-
-      return {
-        id: `ff-${idx}`,
-        date,
-        time,
-        country: resolveCountry(raw.country),
-        event: raw.title,
-        actual: null, // ForexFactory this-week feed doesn't include actuals
-        forecast: raw.forecast || null,
-        prior: raw.previous || null,
-        impact: resolveImpact(raw.impact),
-      };
-    });
+function toEconEvent(event: CloudEconEventPayload): EconEvent {
+  return {
+    ...event,
+    date: new Date(event.date),
+  };
 }
 
 export async function fetchEconCalendar(): Promise<EconEvent[]> {
-  const cached = readCalendarCache();
-  if (cached && !cached.stale) {
-    return parseCalendarJson(cached.value);
-  }
-
-  try {
-    const data = await calendarClient.fetchJson(CALENDAR_URL);
-    writeCalendarCache(data);
-    return parseCalendarJson(data);
-  } catch (err) {
-    const staleCache = cached ?? readCalendarCache({ allowExpired: true });
-    if (staleCache) {
-      return parseCalendarJson(staleCache.value);
-    }
-    throw err;
-  }
+  const events = await apiClient.getCloudEconomicCalendar();
+  return events.map(toEconEvent);
 }

package/src/plugins/builtin/econ/fred-client.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import { resolveFredMapping, getFredSeriesId, getRelatedTickers } from "./fred-series-map";
+import { resolveFredMapping, getRelatedTickers } from "./fred-series-map";
 
 describe("resolveFredMapping", () => {
   test("maps exact US event titles", () => {
@@ -40,16 +40,6 @@ describe("resolveFredMapping", () => {
   });
 });
 
-describe("getFredSeriesId", () => {
-  test("returns series ID for known events", () => {
-    expect(getFredSeriesId("Unemployment Rate", "US")).toBe("UNRATE");
-  });
-
-  test("returns null for unknown events", () => {
-    expect(getFredSeriesId("Some Random Event", "US")).toBeNull();
-  });
-});
-
 describe("getRelatedTickers", () => {
   test("returns related tickers for known events", () => {
     const tickers = getRelatedTickers("CPI m/m", "US");
@@ -57,7 +47,4 @@ describe("getRelatedTickers", () => {
     expect(tickers).toContain("DX-Y.NYB");
   });
 
-  test("returns empty array for unknown events", () => {
-    expect(getRelatedTickers("Unknown Event", "US")).toEqual([]);
-  });
 });

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

@@ -1,3 +1,4 @@
+
 interface FredMapping {
   seriesId: string;
   /** How to display the value: "level" shows the raw number, "change" shows month-over-month or quarter-over-quarter percent change */