gloomberb 0.18.2 → 0.18.4

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

@@ -8,13 +8,16 @@ import {
   DataTableStackView,
   EmptyState,
   PaneStatusBody, QueryBar,
+  StatGrid,
   usePaneFooter,
   useQueryBarSearch,
   useTableLoadMore,
   type DataTableCell,
   type DataTableKeyEvent,
   type DataTableRootKeyContext,
-  type PaneFooterSegment
+  type PaneFooterSegment,
+  type QueryBarView,
+  type StatItem,
 } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
 import { AudioPlayer, useCanPlayAudio } from "../../../components/ui";
@@ -35,7 +38,9 @@ import { usePluginPaneState } from "../../runtime";
 import { ProWall, SignInWall } from "../cloud/auth-actions";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import { listingAbroad } from "../../../api-client/paths";
+import { useAgeClock } from "../../../react/auto-refresh";
 import { useBoundTicker as useSymbolBinding } from "../shared/ticker-request";
+import { CALLS_VIEWS, UpcomingCallsView, type CallsView } from "./calendar";
 import {
   cachedEarningsCalls,
   callStatusLabel,
@@ -48,6 +53,7 @@ import { callTitle, formatCallDate, formatDuration, formatPeriod, formatSentimen
 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";
+import { callAway, callCountdown, callStartText, isUpcomingCall, nextCall } from "./upcoming";
 
 export const EARNINGS_CALLS_PANE_ID = "earnings-calls";
 
@@ -86,7 +92,7 @@ function buildColumns(width: number, showTicker: boolean): CallColumn[] {
   return columns;
 }
 
-function renderCell(call: CloudEarningsCallPayload, column: CallColumn): DataTableCell {
+function renderCell(call: CloudEarningsCallPayload, column: CallColumn, now: number): DataTableCell {
   switch (column.id) {
     case "ticker":
       return { text: call.ticker };
@@ -99,7 +105,9 @@ function renderCell(call: CloudEarningsCallPayload, column: CallColumn): DataTab
     case "length":
       return { text: formatDuration(call.durationSeconds), color: colors.textDim };
     case "sentiment": {
-      if (!call.hasTranscript) return { text: callStatusLabel(call), color: colors.textDim };
+      // A call still to come says how far away it is, not that it is queued.
+      if (isUpcomingCall(call, now)) return { text: callCountdown(call, now), color: colors.text };
+      if (!call.hasTranscript) return { text: callStatusLabel(call, now), color: colors.textDim };
       const tone =
         call.sentiment === null
           ? colors.textDim
@@ -180,13 +188,86 @@ interface EarningsCallsViewProps {
   height: number;
 }
 
+/** The next call's own line: when it starts here and in New York, and how far away it is. */
+function nextCallFigure(call: CloudEarningsCallPayload, now: number): StatItem {
+  const { start, newYork } = callStartText(call, now);
+  // A countdown that is a day's name repeats the start's; it says something within a day.
+  const away = callAway(call, now);
+  const detail = [newYork, away].filter(Boolean).join(" · ");
+  return {
+    id: "next-call",
+    label: "Next call",
+    value: start,
+    ...(detail ? { detail, detailVariants: [away ?? newYork ?? ""] } : {}),
+    tone: "accent",
+  };
+}
+
+/**
+ * CALLS: with a ticker, that company's calls, its next one on its own line;
+ * alone, the calendar of every company's calls this week, or the shelf of
+ * transcripts.
+ */
 export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewProps) {
   const { symbol, exchange, ticker: boundTicker } = useSymbolBinding();
+  // `shot CALLS --view transcripts` (a pane setting) opens on the shelf; a choice made in the pane wins.
+  const [requestedView] = usePaneSettingValue<string>("view", "");
+  const [chosenView, setView] = usePluginPaneState<CallsView | null>("view", null);
+  const view: CallsView = chosenView ?? (CALLS_VIEWS.some((option) => option.value === requestedView) ? requestedView as CallsView : "upcoming");
+  const viewChoice = useMemo<QueryBarView<CallsView>>(() => ({ value: view, options: CALLS_VIEWS, onChange: setView }), [setView, view]);
+
+  if (symbol) {
+    return (
+      <CallsListView
+        focused={focused} width={width} height={height}
+        symbol={symbol} exchange={exchange} listingName={boundTicker?.metadata.name}
+      />
+    );
+  }
+  if (view === "transcripts") {
+    return <CallsListView focused={focused} width={width} height={height} symbol={null} view={viewChoice} />;
+  }
+  return (
+    <UpcomingCallsView
+      focused={focused} width={width} height={height} view={viewChoice}
+      renderCompany={({ ticker, focused: companyFocused, height: companyHeight, onHoldsKeys }) => (
+        <CallsListView
+          key={ticker}
+          focused={companyFocused} width={width} height={companyHeight}
+          symbol={ticker} stateKey="company:" footerId={`${EARNINGS_CALLS_PANE_ID}:company`}
+          openFromSettings={false} onHoldsKeys={onHoldsKeys}
+        />
+      )}
+    />
+  );
+}
+
+interface CallsListProps extends EarningsCallsViewProps {
+  /** The company whose calls these are; null for the shelf of every company's transcripts. */
+  symbol: string | null;
+  exchange?: string;
+  /** The listing's company name, so a listing abroad reads its own calls. */
+  listingName?: string;
+  /** Prefix of the pane state this view keeps, so a company opened from the calendar keeps its own. */
+  stateKey?: string;
+  footerId?: string;
+  /** The calendar or the shelf, chosen in the query bar of CALLS alone. */
+  view?: QueryBarView<CallsView>;
+  /** Whether the pane's `quarter` and `reader` settings open a call here (a layout or a shot). */
+  openFromSettings?: boolean;
+  /** Told when this view holds the keys a stack around it would take: a call open, or its search focused. */
+  onHoldsKeys?: (holds: boolean) => void;
+}
+
+function CallsListView({
+  focused, width, height, symbol, exchange, listingName: boundName, stateKey = "", footerId = EARNINGS_CALLS_PANE_ID,
+  view, openFromSettings = true, onHoldsKeys,
+}: CallsListProps) {
   const access = usePlanAccess();
   // Read once per mount: a binding change reads the cache again in its own effect.
   const [initialShelf] = useState(() => {
     const initialTicker = symbol ? symbol.toUpperCase() : null;
-    const initialAbroad = initialTicker ? listingAbroad(initialTicker, exchange, boundTicker?.metadata.name) : null;
+    const initialAbroad = initialTicker ? listingAbroad(initialTicker, exchange, boundName) : null;
     return cachedEarningsCalls(initialTicker, {
       limit: CALL_PAGE_SIZE, exchange: initialAbroad?.exchange, name: initialAbroad?.name,
     });
@@ -206,8 +287,8 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   const [nextOffset, setNextOffset] = useState(initialShelf?.calls.length ?? 0);
   const tableScrollRef = useRef<ScrollBoxRenderable | null>(null);
 
-  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selectedId", null);
-  const [detailOpen, setDetailOpen] = usePluginPaneState<boolean>("detailOpen", false);
+  const [selectedId, setSelectedId] = usePluginPaneState<string | null>(`${stateKey}selectedId`, null);
+  const [detailOpen, setDetailOpen] = usePluginPaneState<boolean>(`${stateKey}detailOpen`, false);
   const [transcript, setTranscript] = useState<CloudEarningsTranscriptPayload | null>(null);
   useEffect(() => {
     if (focused && transcript && detailOpen) recordResearchActivity("pro_feature_used", "transcripts");
@@ -217,13 +298,15 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
     message: string;
     status?: number;
   } | null>(null);
-  const [readerTab, setReaderTab] = usePluginPaneState<ReaderTab>("readerTab", "summary");
-  // A layout or `gloomberb shot CALLS NVDA --quarter latest --reader summary`
+  const [readerTab, setReaderTab] = usePluginPaneState<ReaderTab>(`${stateKey}readerTab`, "summary");
+  // A layout or `gloom shot CALLS NVDA --quarter latest --reader summary`
   // can land straight on a transcript instead of the shelf. `quarter` takes
   // the same tokens as the headless option; only transcribed calls qualify,
   // since opening a call without one asks the server to produce it.
-  const [openQuarter] = usePaneSettingValue<string>("quarter", "");
-  const [openReader] = usePaneSettingValue<string>("reader", "");
+  const [quarterSetting] = usePaneSettingValue<string>("quarter", "");
+  const [readerSetting] = usePaneSettingValue<string>("reader", "");
+  const openQuarter = openFromSettings ? quarterSetting : "";
+  const openReader = openFromSettings ? readerSetting : "";
   const openedQuarter = useRef<string | null>(null);
   const [sort, setSort] = useState<CallSort>(DEFAULT_SORT);
   const [searchQuery, setSearchQuery] = useState("");
@@ -240,7 +323,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
 
   const ticker = symbol ? symbol.toUpperCase() : null;
   // A listing abroad asks for its own calls by venue and company, never a US namesake's.
-  const abroad = ticker ? listingAbroad(ticker, exchange, boundTicker?.metadata.name) : null;
+  const abroad = ticker ? listingAbroad(ticker, exchange, boundName) : null;
   const listingVenue = abroad?.exchange;
   const listingName = abroad?.name;
 
@@ -429,10 +512,16 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
     ];
   }, [calls, lookup, listFetchedAt]);
 
+  // Countdowns move on a coarse clock that rests while the pane is hidden.
+  const now = useAgeClock(listFetchedAt || null);
+  // A company's next call is its own line above its calls, not one of the rows.
+  const next = useMemo(() => (ticker ? nextCall(allCalls, now) : null), [allCalls, now, ticker]);
+  const listedCalls = useMemo(() => (next ? allCalls.filter((call) => call.id !== next.id) : allCalls), [allCalls, next]);
+
   const rows = useMemo(() => {
     const query = searchQuery.trim().toLowerCase();
     const matched = query
-      ? allCalls.filter((call) =>
+      ? listedCalls.filter((call) =>
           [
             call.ticker,
             call.companyName ?? "",
@@ -443,7 +532,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
             .toLowerCase()
             .includes(query),
         )
-      : allCalls;
+      : listedCalls;
     const sorted = [...matched].sort((a, b) => {
       const left = sortValue(a, sort.columnId);
       const right = sortValue(b, sort.columnId);
@@ -452,7 +541,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
       return sort.direction === "asc" ? order : -order;
     });
     return sorted;
-  }, [allCalls, sort, searchQuery]);
+  }, [listedCalls, sort, searchQuery]);
 
   useEffect(() => {
     const quarter = openQuarter.trim();
@@ -474,6 +563,9 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   );
   const selectedCallId = selected?.id ?? null;
   const selectedHasTranscript = selected?.hasTranscript ?? false;
+  // A call still to come has nothing to read, and asking for its transcript
+  // would ask the server to produce one before the call has happened.
+  const selectedUpcoming = !!selected && isUpcomingCall(selected, now);
   // The reader shows only a call the pane can find. A restored call that is not
   // on the reloaded shelf (a lookup result, or one that aged off) closes once
   // the shelf has loaded, rather than leave the keys pointing at a reader that
@@ -544,7 +636,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   // a call that has none asks the server to produce it, then checks back
   // until it arrives.
   useEffect(() => {
-    if (!detailOpen || !selectedCallId || !access.emailVerified || !access.hasProAccess) return;
+    if (!detailOpen || !selectedCallId || selectedUpcoming || !access.emailVerified || !access.hasProAccess) return;
     // A binding change clears selection in an effect; do not start a request
     // for that previous selection during the same render's effect pass.
     if (ticker && selected?.ticker.toUpperCase() !== ticker) return;
@@ -592,7 +684,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
     };
     // The call's identity is what matters; list refreshes must not restart this.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [detailOpen, selectedCallId, ticker, access.emailVerified, access.hasProAccess]);
+  }, [detailOpen, selectedCallId, selectedUpcoming, ticker, access.emailVerified, access.hasProAccess]);
 
   const scrollTranscriptBy = useCallback((delta: number) => {
     if (transcriptScrollRef.current) scrollByLines(transcriptScrollRef.current, delta);
@@ -629,6 +721,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   const transcriptProRequired = transcriptError?.status === 402;
 
   const columns = useMemo(() => buildColumns(width, !ticker), [width, ticker]);
+  const renderRow = useCallback((call: CloudEarningsCallPayload, column: CallColumn) => renderCell(call, column, now), [now]);
 
   const handleRootKey = useCallback(
     (event: DataTableKeyEvent, context: DataTableRootKeyContext) => {
@@ -664,6 +757,13 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   // Only a loaded transcript has a find field; a wall, an upsell or a first
   // load has no list or reader for the search keys to reach.
   const readerSearchable = readerOpen && !!selectedTranscript && !transcriptProRequired;
+  // A calendar around this view gives it Back, Esc and Backspace while a call
+  // is open here or the search has the keys.
+  const holdsKeys = readerOpen || searchFocused;
+  useEffect(() => {
+    onHoldsKeys?.(holdsKeys);
+  }, [holdsKeys, onHoldsKeys]);
+  useEffect(() => () => onHoldsKeys?.(false), [onHoldsKeys]);
   // Mirrors the bodies below: the list renders unless a wall, an upsell, or an
   // empty shelf's loading, failed or research-tab state takes its place.
   const listShown = !signInRequired && !verificationRequired && !proRequired
@@ -717,7 +817,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
   );
 
   usePaneFooter(
-    EARNINGS_CALLS_PANE_ID,
+    footerId,
     () => {
       const info: PaneFooterSegment[] = [];
       if (listStatus === "loading") {
@@ -847,7 +947,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
         placement="calls-wall"
         width={width} height={height} symbol={symbol} exchange={exchange}
         title="Earnings call transcripts are part of Gloom Cloud Pro."
-        message="Gloomberb transcribes the calls itself: full transcripts with speaker attribution, analyst Q&A, and extracted guidance, risks and tone."
+        message="Full transcripts of each earnings call with speaker attribution, analyst Q&A, and extracted guidance, risks and tone."
       />
     );
   }
@@ -884,6 +984,8 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
       title="Earnings call transcripts are part of Gloom Cloud Pro."
       message="Full transcripts with speaker attribution, analyst Q&A, guidance and risk extraction, transcribed from the call itself."
     />
+  ) : selected && selectedUpcoming ? (
+    <UpcomingCallState call={selected} now={now} />
   ) : selected && !selectedTranscript && (producing || (!selected.hasTranscript && !transcriptError)) ? (
     <PaneStatusBody loading loadingLabel="Producing the transcript. This usually takes two to three minutes." />
   ) : (
@@ -945,17 +1047,21 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
       detailContent={detailContent}
       detailTitle={selected ? callTitle(selected) : undefined}
       rootBefore={
-        <QueryBar
-          width={width}
-          search={{
-            value: searchQuery,
-            onChange: setSearchQuery,
-            placeholder: "ticker, company, or period",
-            focused: focused && !readerOpen,
-            ...searchProps,
-            debounceMs: 80,
-          }}
-        />
+        <Box flexDirection="column" flexShrink={0}>
+          <QueryBar
+            width={width}
+            search={{
+              value: searchQuery,
+              onChange: setSearchQuery,
+              placeholder: "ticker, company, or period",
+              focused: focused && !readerOpen,
+              ...searchProps,
+              debounceMs: 80,
+            }}
+            view={view}
+          />
+          {next ? <StatGrid items={[nextCallFigure(next, now)]} width={width} /> : null}
+        </Box>
       }
       onRootKeyDown={handleRootKey}
       onDetailKeyDown={handleDetailKey}
@@ -986,7 +1092,7 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
         setSort((current) => nextHeaderSort(current, columnId, { firstDirection: "desc" }))
       }
       getItemKey={(call) => call.id}
-      renderCell={renderCell}
+      renderCell={renderRow}
       emptyStateTitle={
         lookupTicker && lookupState
           ? lookupState === "unknown"
@@ -998,9 +1104,21 @@ export function EarningsCallsPane({ focused, width, height }: EarningsCallsViewP
                 : `Looking up ${lookupTicker}...`
           : searchQuery.trim()
             ? "No matching calls."
-            : "No calls yet."
+            : next ? "No calls before this one yet." : "No calls yet."
       }
       emptyStateHint={searchQuery.trim() ? "Clear the search to see all calls." : undefined}
     />
   );
 }
+
+/** An open call still to come: when it starts, here and in New York, and how far away. */
+function UpcomingCallState({ call, now }: { call: CloudEarningsCallPayload; now: number }) {
+  const { start, newYork } = callStartText(call, now);
+  const away = callAway(call, now);
+  return (
+    <EmptyState
+      title={`Starts ${start}${newYork ? ` (${newYork})` : ""}${away ? `, ${away}` : ""}.`}
+      message="The transcript follows once the call is over."
+    />
+  );
+}

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

@@ -0,0 +1,195 @@
+import type { CloudEarningsCallPayload } from "../../../api-client";
+import type { TableSection } from "../../../components";
+import { formatCountdown } from "../../../utils/datetime-format";
+import { addDays, marketDays, newYorkToday, type MarketDay } from "../earnings/board-model";
+import { shortDate, weekday } from "../earnings/format";
+
+const DAY_MS = 86_400_000;
+
+/**
+ * Whether a call's `callAt` is its start. A call known by its day alone is
+ * stored at 00:00 UTC of that New York day; a server that does not say which
+ * is read the same way.
+ */
+export function callTimeKnown(call: Pick<CloudEarningsCallPayload, "callAt" | "callTimeKnown">): boolean {
+  const at = call.callAt ? Date.parse(call.callAt) : Number.NaN;
+  if (!Number.isFinite(at)) return false;
+  if (typeof call.callTimeKnown === "boolean") return call.callTimeKnown;
+  return at % DAY_MS !== 0;
+}
+
+/** The New York day a call is on (YYYY-MM-DD): its start's, or the day it is known by. */
+export function callDay(call: Pick<CloudEarningsCallPayload, "callAt" | "callTimeKnown">): string | null {
+  const at = call.callAt ? Date.parse(call.callAt) : Number.NaN;
+  if (!Number.isFinite(at)) return null;
+  return callTimeKnown(call) ? newYorkToday(new Date(at)) : new Date(at).toISOString().slice(0, 10);
+}
+
+/**
+ * A call still to come: no transcript yet, and its start ahead, or, known by
+ * its day alone, that day today or later in New York. A transcribed call has
+ * happened, whatever its date says.
+ */
+export function isUpcomingCall(call: CloudEarningsCallPayload, now = Date.now()): boolean {
+  if (call.hasTranscript) return false;
+  if (callTimeKnown(call)) return Date.parse(call.callAt!) > now;
+  const day = callDay(call);
+  return day !== null && day >= newYorkToday(new Date(now));
+}
+
+/** Earliest first: by New York day, then the calls with a start, in order, then those known by the day. */
+export function compareCallStarts(left: CloudEarningsCallPayload, right: CloudEarningsCallPayload): number {
+  const leftDay = callDay(left) ?? "9999-12-31";
+  const rightDay = callDay(right) ?? "9999-12-31";
+  if (leftDay !== rightDay) return leftDay < rightDay ? -1 : 1;
+  const leftKnown = callTimeKnown(left);
+  const rightKnown = callTimeKnown(right);
+  if (leftKnown !== rightKnown) return leftKnown ? -1 : 1;
+  return (Date.parse(left.callAt ?? "") || 0) - (Date.parse(right.callAt ?? "") || 0) || left.ticker.localeCompare(right.ticker);
+}
+
+/** A company's next call: the soonest of its calls still to come. */
+export function nextCall(calls: readonly CloudEarningsCallPayload[], now = Date.now()): CloudEarningsCallPayload | null {
+  return calls.filter((call) => isUpcomingCall(call, now)).sort(compareCallStarts)[0] ?? null;
+}
+
+const localDay = (at: number) => {
+  const date = new Date(at);
+  return Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());
+};
+
+/**
+ * How far away a call is. With its start: "in 25m" and "in 3h" within a day
+ * (the countdown econ events use), then its weekday on this machine's clock
+ * within the week ("Thu"), then its date ("Oct 30"); "started" once it has.
+ * Known by its day alone: "today", "tomorrow", then the same.
+ */
+export function callCountdown(call: CloudEarningsCallPayload, now = Date.now()): string {
+  const day = callDay(call);
+  if (!day) return "";
+  if (!callTimeKnown(call)) {
+    const today = newYorkToday(new Date(now));
+    if (day < today) return shortDate(day);
+    if (day === today) return "today";
+    if (day === addDays(today, 1)) return "tomorrow";
+    return day <= addDays(today, 6) ? weekday(day) : shortDate(day);
+  }
+  const at = Date.parse(call.callAt!);
+  const ahead = at - now;
+  if (ahead <= 0) return "started";
+  if (ahead < DAY_MS) return formatCountdown(ahead);
+  const days = Math.round((localDay(at) - localDay(now)) / DAY_MS);
+  const date = new Date(at);
+  const local = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
+  return days <= 6 ? weekday(local) : shortDate(local);
+}
+
+/**
+ * The countdown when it says more than the call's day does: "in 3h", "today",
+ * "tomorrow". Null when it would only name the day ("Thu", "Oct 30").
+ */
+export function callAway(call: CloudEarningsCallPayload, now = Date.now()): string | null {
+  const countdown = callCountdown(call, now);
+  return /^(in |today$|tomorrow$)/.test(countdown) ? countdown : null;
+}
+
+const clockFormatters = new Map<string, Intl.DateTimeFormat>();
+
+function clockFormatter(timeZone: string | undefined, withDay: boolean): Intl.DateTimeFormat {
+  const key = `${timeZone ?? ""}:${withDay}`;
+  let formatter = clockFormatters.get(key);
+  if (!formatter) {
+    formatter = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      hour: "2-digit",
+      minute: "2-digit",
+      hourCycle: "h23",
+      ...(withDay ? { weekday: "short", month: "short", day: "numeric" } : {}),
+    });
+    clockFormatters.set(key, formatter);
+  }
+  return formatter;
+}
+
+function clock(at: number, timeZone: string | undefined, withDay: boolean): string {
+  const parts = Object.fromEntries(clockFormatter(timeZone, withDay).formatToParts(new Date(at)).map((part) => [part.type, part.value]));
+  const time = `${parts.hour}:${parts.minute}`;
+  return withDay ? `${parts.weekday} ${parts.month} ${parts.day} ${time}` : time;
+}
+
+const NEW_YORK = "America/New_York";
+
+/** Its start on this machine's clock ("22:30"), or null for a call known by its day alone. */
+export function callLocalClock(call: CloudEarningsCallPayload): string | null {
+  return callTimeKnown(call) ? clock(Date.parse(call.callAt!), undefined, false) : null;
+}
+
+/** Its start on New York's clock ("16:30"), or null for a call known by its day alone. */
+export function callNewYorkClock(call: CloudEarningsCallPayload): string | null {
+  return callTimeKnown(call) ? clock(Date.parse(call.callAt!), NEW_YORK, false) : null;
+}
+
+/** Whether this machine's clock reads New York's at every one of these starts, so one time says both. */
+export function clockIsNewYork(calls: readonly CloudEarningsCallPayload[], now = Date.now()): boolean {
+  const starts = [now, ...calls.filter(callTimeKnown).map((call) => Date.parse(call.callAt!))];
+  return starts.every((at) => clock(at, undefined, true) === clock(at, NEW_YORK, true));
+}
+
+/**
+ * When the next call starts, as its own line names it: the day and time here,
+ * then New York's ("Thu Oct 22 22:30", "16:30 ET"), New York's alone when the
+ * two agree ("Thu Oct 22 16:30 ET"), or the day alone ("Thu Oct 22").
+ */
+export function callStartText(call: CloudEarningsCallPayload, now = Date.now()): { start: string; newYork: string | null } {
+  const day = callDay(call);
+  if (!day) return { start: "", newYork: null };
+  if (!callTimeKnown(call)) return { start: `${weekday(day)} ${shortDate(day)}`, newYork: null };
+  const at = Date.parse(call.callAt!);
+  if (clockIsNewYork([call], now)) return { start: `${clock(at, NEW_YORK, true)} ET`, newYork: null };
+  return { start: clock(at, undefined, true), newYork: `${clock(at, NEW_YORK, false)} ET` };
+}
+
+/** The calendar's days: today when the market trades, the next session, then the rest of that week (ERN's board). */
+export function calendarDays(now = Date.now()): MarketDay[] {
+  return marketDays(newYorkToday(new Date(now)));
+}
+
+export type CalendarSort = { column: "time" | "ticker" | "company"; direction: "asc" | "desc" };
+
+export const DEFAULT_CALENDAR_SORT: CalendarSort = { column: "time", direction: "asc" };
+
+function compareRows(left: CloudEarningsCallPayload, right: CloudEarningsCallPayload, sort: CalendarSort): number {
+  const order = sort.column === "ticker"
+    ? left.ticker.localeCompare(right.ticker)
+    : sort.column === "company"
+      ? (left.companyName ?? left.ticker).localeCompare(right.companyName ?? right.ticker, undefined, { sensitivity: "base" })
+      : compareCallStarts(left, right);
+  return (sort.direction === "asc" ? order : -order) || compareCallStarts(left, right);
+}
+
+/**
+ * The calendar's sections: one per day with calls on it, its calls in start
+ * order (or the sort's), one per company and start.
+ */
+export function calendarSections(
+  calls: readonly CloudEarningsCallPayload[],
+  days: readonly MarketDay[],
+  sort: CalendarSort = DEFAULT_CALENDAR_SORT,
+): Array<TableSection<CloudEarningsCallPayload>> {
+  const seen = new Set<string>();
+  const unique = calls.filter((call) => {
+    const key = `${call.ticker}:${call.callAt}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+  return days.map((day) => ({
+    label: day.label,
+    items: unique
+      .filter((call) => {
+        const on = callDay(call);
+        return on !== null && on >= day.from && on <= day.to;
+      })
+      .sort((left, right) => compareRows(left, right, sort)),
+  }));
+}

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

@@ -46,11 +46,16 @@ const HOP_SEPARATOR = " › ";
 
 /**
  * Holding to via, then via to the company that reports. The first hop is
- * padded with no-break spaces, which the desktop does not collapse.
+ * padded with no-break spaces, which the desktop does not collapse. A column
+ * too narrow for the route keeps each share whole or leaves it out (`8% of
+ * NVDA purchases › …`), never a figure cut off from whose it is.
  */
-function shareText(row: SecondHopRow, firstHopWidth: number) {
-  const first = hopLabel(row.hops[0]);
-  return `${first}${"\u00a0".repeat(Math.max(0, firstHopWidth - displayWidth(first)))}${HOP_SEPARATOR}${hopLabel(row.hops[1])}`;
+function shareText(row: SecondHopRow, firstHopWidth: number, cells = Infinity) {
+  const first = hopLabel(row.hops[0]), second = hopLabel(row.hops[1]);
+  const lined = `${first}${"\u00a0".repeat(Math.max(0, firstHopWidth - displayWidth(first)))}${HOP_SEPARATOR}${second}`;
+  if (displayWidth(lined) <= cells) return lined;
+  const whole = `${first}${HOP_SEPARATOR}${second}`;
+  return displayWidth(whole) <= cells ? whole : `${first}${HOP_SEPARATOR}…`;
 }
 
 /**
@@ -113,7 +118,7 @@ function renderSecondHopCell(row: SecondHopRow, column: DataTableColumn, firstHo
     case "link": return { text: row.link === "customer" ? "customer's customer" : "supplier's supplier" };
     case "via": return { text: row.via };
     case "holding": return { text: row.holding };
-    case "shares": return { text: shareText(row, firstHopWidth), value: shareText(row, 0) };
+    case "shares": return { text: shareText(row, firstHopWidth, column.width), value: shareText(row, 0) };
     case "move": return move(row);
     default: return { text: row.holdingDate ?? "--" };
   }