@gloom-sh/terminal 0.18.5 → 0.19.1

package/src/plugins/builtin/ticker-detail/overview-tab.tsx

@@ -42,7 +42,7 @@ import { appTtmRate, enterpriseValueReconciliationNote, ttmAtAppRate, ttmConvers
 import { atRegularSessionPrice } from "../../../market-data/quotes/regular-session-valuation";
 import { zonedDateKey } from "../../../utils/zoned-date-time";
 import { sharesOutstandingInReceipts } from "../../../utils/depositary-receipt";
-import { isReceiptSide, listingDepositaryPair } from "../../../market-data/depositary-pair";
+import { isReceiptSide, listingCedearRatio, listingDepositaryPair } from "../../../market-data/depositary-pair";
 import {
   CompactRangeBar,
   FundamentalsGrid,
@@ -335,6 +335,7 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
     nextEarnings: financials?.nextEarnings,
     depositaryReceipt: sharesOutstandingInReceipts(quote, fundamentals, description),
     depositaryPair: depositaryPair ? { pair: depositaryPair, receiptSide: isReceiptSide(financials) } : null,
+    cedearRatio: listingCedearRatio(financials),
     // Report and ex-dividend dates are the listing's calendar days.
     today: zonedDateKey(Date.now(), chartTimeZone ?? "America/New_York"),
     dividend,

package/src/plugins/builtin/ticker-detail/pane.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../utils/log-failure";
 import { Box } from "../../../ui";
 import { getCurrentPluginTarget } from "../../current-target";
 import { recordResearchActivity, recordResearchTabView } from "../../../api-client/research-activity";
@@ -283,7 +284,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
           choices={choices.map((item) => ({ ...item, label: t(item.label) }))} />,
       }).then((templateId) => {
         if (templateId && choices.some((item) => item.id === templateId)) createPaneFromTemplate(templateId, { symbol: companySymbol });
-      }).catch(() => {});
+      }).catch(logFailure("ticker-detail.pane", "Open company research choices failed"));
     } }];
   }, [companySymbol, createPaneFromTemplate, dialog, disabledPlugins, registry, tickerResearchTabsSnapshot]);
   usePaneMenuItems("ticker-research:go-to-tab", () => {
@@ -304,7 +305,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
           ),
         }).then((tabId) => {
           if (tabId) selectResearchTab(tabId);
-        }).catch(() => {});
+        }).catch(logFailure("ticker-detail.pane", "Open research tab choices failed"));
       },
     }];
   }, [dialog, resolvedTabId, selectResearchTab, showTabs, tabItems]);
@@ -325,16 +326,21 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
     selectResearchTab(tabId);
     return true;
   }, [selectResearchTab, visibleTabIds]);
+  // Without a ticker the pane draws only its empty state, and the tab list has
+  // no Overview, so the fallback above lands on the first tab that needs no
+  // ticker. Nobody opened it, and keeping it mounted would load its data on
+  // every ticker switch.
+  const shownTabId = ticker && visibleTabIds.has(resolvedTabId) ? resolvedTabId : null;
   const renderedTabIds = useMemo(() => {
     const next = new Set<string>();
     for (const tabId of mountedTabIds) {
       if (visibleTabIds.has(tabId)) next.add(tabId);
     }
-    if (visibleTabIds.has(resolvedTabId)) {
-      next.add(resolvedTabId);
+    if (shownTabId) {
+      next.add(shownTabId);
     }
     return next;
-  }, [mountedTabIds, resolvedTabId, visibleTabIds]);
+  }, [mountedTabIds, shownTabId, visibleTabIds]);
 
   const handlePluginCapture = useCallback((capturing: boolean) => {
     setPluginCaptured(capturing);
@@ -353,12 +359,12 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
       for (const tabId of current) {
         if (visibleTabIds.has(tabId)) next.add(tabId);
       }
-      if (visibleTabIds.has(resolvedTabId)) {
-        next.add(resolvedTabId);
+      if (shownTabId) {
+        next.add(shownTabId);
       }
       return sameStringSet(current, next) ? current : next;
     });
-  }, [resolvedTabId, visibleTabIds]);
+  }, [shownTabId, visibleTabIds]);
 
   if (!ticker) {
     const isEmptyFollowCollection = paneInstance?.binding?.kind === "follow" && !!collectionId && collectionTickerCount === 0;

package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { PerpEquityRow } from "../../perps/equity-row";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, useUiCapabilities } from "../../../../ui";
@@ -173,7 +174,7 @@ export function QuoteMonitorPane({ paneId, focused, width, height }: PaneProps)
   useEffect(() => {
     const coordinator = getSharedMarketDataCoordinator();
     if (!coordinator || !liveStreaming || boardInstruments.length === 0) return;
-    void coordinator.loadQuotesBatch(boardInstruments).catch(() => {});
+    void coordinator.loadQuotesBatch(boardInstruments).catch(logFailure("ticker-detail.quote-monitor", "Warm quote monitor board failed"));
   }, [boardInstrumentKey, liveStreaming]);
   const { pinTicker } = usePluginTickerActions();
   const { openPaneSettings } = usePluginAppActions();

package/src/plugins/builtin/ticker-detail/settings.ts

@@ -119,6 +119,7 @@ export function getQuoteMonitorPaneSettings(
     try {
       symbols = parseTickerListInput(storedText, MAX_TICKER_LIST_SIZE);
     } catch {
+      // Intentional ignore: unparseable saved ticker text falls back to the legacy symbol or the pane's ticker.
       symbols = [];
     }
   }

package/src/plugins/builtin/time-sales/pane.tsx

@@ -1,7 +1,9 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { Box } from "../../../ui";
 import { usePaneSettingValue, useShortcut } from "../../../public/react";
-import { splitDelayedStatus, DataTableStackView, KeyValueRow, PaneStatusBody, StatGrid, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, usePaneTicker, type DataTableColumn } from "../../../components";
+import { createDataTableCsv } from "../../../components/data-table/export";
+import { dropColumnsToFit } from "../../../components/ui/table-layout";
+import { splitDelayedStatus, DataTableStackView, KeyValueRow, PaneStatusBody, StatGrid, usePaneFooter, usePaneNoticeFooter, usePaneStatusFooter, usePaneTabs, usePaneTicker, type DataTableCell, type DataTableColumn } from "../../../components";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
 import type { TapeQuote, TapeSnapshot, TapeTrade } from "../../../api-client/tape";
@@ -32,6 +34,12 @@ const QUOTES: DataTableColumn[] = [
   { id: "askExchange", label: "VENUE", width: 9, align: "left" },
   { id: "spread", label: "SPREAD BP", width: 10, align: "right" },
 ];
+/**
+ * A narrow pane gives up the venues, then the lots, before the right edge cuts
+ * the spread: each pair together, since one side's alone would not say which
+ * side it is. The scrollbar keeps one cell, and exports keep every column.
+ */
+const QUOTE_DROP_ORDER = [["bidExchange", "askExchange"], ["bidSize", "askSize"]];
 const rank = (value: number | null) => value == null ? "pctl --" : `${value.toFixed(0)} pctl`;
 type TapeRow = { id: string; trade?: TapeTrade; quote?: TapeQuote };
 
@@ -112,13 +120,32 @@ function TimeSalesView({ width, height, focused, symbol, exchange }: PaneProps &
     info: data ? [...splitDelayedStatus({ id: "feed", quoteStatus: true, parts: [{ text: `${data.feed === "sip" ? "real-time" : "15m delayed"} · ${tapeStampNewYork(data.asOf)}`, tone: "muted" }] }),
       ...(frozen ? [{ id: "paused", parts: [{ text: "paused", tone: "warning" as const }] }] : []),
       ...(!data.connected || resource.snapshotOnly ? [{ id: "snapshot", parts: [{ text: "snapshot", tone: "warning" as const }] }] : [])] : [] });
+  const quoteColumns = useMemo(() => dropColumnsToFit(QUOTES, width - 1, QUOTE_DROP_ORDER), [width]);
+  const columns = tab === "quotes" ? quoteColumns : TRADES;
   const selectTab = (value: string) => { setTab(value); setDetail(null); setSelected(null); };
   const { strip: tabStrip, rows: tabRows } = usePaneTabs({ tabs: TABS, activeValue: tab, onSelect: selectTab, focused: focused && !detail, dense: true });
+  const renderCell = (row: TapeRow, column: DataTableColumn): DataTableCell => {
+    if (row.trade) {
+      const trade = row.trade;
+      const tick = ticks.get(trade);
+      return { text: column.id === "time" ? tapeClockNewYork(trade.timestamp) : column.id === "price" ? tapePrice(trade.price, tradeDigits)
+        : column.id === "size" ? tapeQuantity(trade.size) : column.id === "venue" ? tapeVenue(trade.exchange)
+        : column.id === "conditions" ? tapeConditionWords(trade.conditions) : trade.tape,
+        // Price by tick, as on a tape; a block print lights the rest of its row.
+        color: laterThanPin(row) ? colors.textMuted : column.id === "price" ? tick === "up" ? colors.positive : tick === "down" ? colors.negative : colors.text
+          : trade.size >= 10_000 ? colors.warning : colors.textMuted };
+    }
+    const quote = row.quote!, spread = quoteSpread(quote);
+    return { text: column.id === "time" ? tapeClockNewYork(quote.timestamp) : column.id === "bid" ? tapePrice(quote.bid, quoteDigits) : column.id === "ask" ? tapePrice(quote.ask, quoteDigits)
+      : column.id === "bidSize" ? tapeQuantity(quote.bidSize) : column.id === "askSize" ? tapeQuantity(quote.askSize)
+      : column.id === "bidExchange" ? tapeVenue(quote.bidExchange) : column.id === "askExchange" ? tapeVenue(quote.askExchange)
+      : spread.bps == null ? "--" : spread.bps.toFixed(2), color: laterThanPin(row) ? colors.textMuted : spread.state === "normal" ? colors.text : colors.warning };
+  };
   if (!data && isCloudSessionRequired(resource.error)) return <SignInWall placement="time-sales-signin" action="view time and sales" needsVerification={session.needsVerification} />;
   return <Box width={width} height={height} flexDirection="column">
     {tabStrip}
     <PaneStatusBody loading={resource.loading && !data} error={!data ? resource.error : null} empty={!!data && !rows.length} subject={tab === "quotes" ? "NBBO observations" : "trade observations"}>
-      {data && stats ? <DataTableStackView<TapeRow> columns={tab === "quotes" ? QUOTES : TRADES} items={rows}
+      {data && stats ? <DataTableStackView<TapeRow> columns={columns} items={rows}
         focused={focused} rootWidth={width} rootHeight={Math.max(3, height - tabRows)}
         selection={{ kind: "id", selectedId: selected, getId: (row) => row.id, onChange: setSelected }}
         onActivate={(row) => { setPaused({ data, epoch: resource.epoch }); setDetail({ row, epoch: resource.epoch }); }} getItemKey={(row) => row.id}
@@ -136,23 +163,8 @@ function TimeSalesView({ width, height, focused, symbol, exchange }: PaneProps &
           ]),
           ...(data.session.high != null && data.session.low != null ? [{ id: "session", label: "Session", value: `${tapePrice(data.session.low, sessionDigits)} to ${tapePrice(data.session.high, sessionDigits)}` }] : []),
         ]} />}
-        renderCell={(row, column) => {
-          if (row.trade) {
-            const trade = row.trade;
-            const tick = ticks.get(trade);
-            return { text: column.id === "time" ? tapeClockNewYork(trade.timestamp) : column.id === "price" ? tapePrice(trade.price, tradeDigits)
-              : column.id === "size" ? tapeQuantity(trade.size) : column.id === "venue" ? tapeVenue(trade.exchange)
-              : column.id === "conditions" ? tapeConditionWords(trade.conditions) : trade.tape,
-              // Price by tick, as on a tape; a block print lights the rest of its row.
-              color: laterThanPin(row) ? colors.textMuted : column.id === "price" ? tick === "up" ? colors.positive : tick === "down" ? colors.negative : colors.text
-                : trade.size >= 10_000 ? colors.warning : colors.textMuted };
-          }
-          const quote = row.quote!, spread = quoteSpread(quote);
-          return { text: column.id === "time" ? tapeClockNewYork(quote.timestamp) : column.id === "bid" ? tapePrice(quote.bid, quoteDigits) : column.id === "ask" ? tapePrice(quote.ask, quoteDigits)
-            : column.id === "bidSize" ? tapeQuantity(quote.bidSize) : column.id === "askSize" ? tapeQuantity(quote.askSize)
-            : column.id === "bidExchange" ? tapeVenue(quote.bidExchange) : column.id === "askExchange" ? tapeVenue(quote.askExchange)
-            : spread.bps == null ? "--" : spread.bps.toFixed(2), color: laterThanPin(row) ? colors.textMuted : spread.state === "normal" ? colors.text : colors.warning };
-        }} emptyStateTitle="No observations in this window." /> : null}
+        renderCell={renderCell} exportCsv={() => createDataTableCsv({ columns: tab === "quotes" ? QUOTES : TRADES, items: rows, renderCell })}
+        emptyStateTitle="No observations in this window." /> : null}
     </PaneStatusBody>
   </Box>;
 }

package/src/plugins/builtin/treasury-auctions/headless.ts

@@ -28,27 +28,34 @@ import {
 } from "./model";
 
 /**
- * A completed auction's missing bid-to-cover or bidder split is a blank cell:
- * the source has bid-to-cover regularly from late 1999 and the split only from
- * 2008-04-07. "-" stays for an announced auction whose results are not out yet.
+ * A missing bid-to-cover or bidder split is a blank cell: the source has
+ * bid-to-cover regularly from late 1999 and the split only from 2008-04-07,
+ * and an announced auction has no results to fill them; its Rate says so.
  */
-const missing = (row: Record<string, unknown>) => isPendingAuction(row as unknown as TreasuryAuction) ? "-" : "";
-const formatPercent = (value: unknown, row: Record<string, unknown>) => value == null ? missing(row) : `${Number(value).toFixed(1)}%`;
+const formatPercent = (value: unknown) => value == null ? "" : `${Number(value).toFixed(1)}%`;
+
+/** What an announced auction's Rate reads until the source publishes its results. */
+const RESULTS_NOT_PUBLISHED = "results not published";
+const pending = (row: Record<string, unknown>) => isPendingAuction(row as unknown as TreasuryAuction);
 
 /** Why the stop-out column is not a tail; the docs page says the same at length. */
 const STOP_OUT_NOTE = "Stop-out vs avg is the high yield minus the average/median yield, in bp (bills: discount rates). "
   + "A true tail, the stop-out against the 1 pm when-issued yield, needs the when-issued yield, which the source does not carry.";
 
 const MISSING_METRICS_NOTE = "A blank B/C or bidder share is one the source does not have for that auction: "
-  + "bid-to-cover is regular from late 1999, the indirect, direct and dealer split from 2008-04-07. - is a result not out yet.";
+  + "bid-to-cover is regular from late 1999, the indirect, direct and dealer split from 2008-04-07.";
 
 /** A completed auction the source gives no bid-to-cover or no bidder split for. */
 const lacksMetrics = (auction: TreasuryAuction) => !isPendingAuction(auction)
   && (auction.bidToCoverRatio == null || indirectPct(auction) == null || directPct(auction) == null || dealerPct(auction) == null);
 
-/** The rate as the table prints it; a TIPS or FRN row says what its number is (`2.653% real`, `4.0bp spread`). */
+/**
+ * The rate as the table prints it; a TIPS or FRN row says what its number is
+ * (`2.653% real`, `4.0bp spread`), and an announced auction that its results
+ * are not published yet.
+ */
 const rateCell = (value: unknown, row: Record<string, unknown>) => {
-  const text = formatAuctionRate(row as unknown as TreasuryAuction, value == null ? null : Number(value), "-");
+  const text = formatAuctionRate(row as unknown as TreasuryAuction, value == null ? null : Number(value), pending(row) ? RESULTS_NOT_PUBLISHED : "-");
   const qualifier = value == null ? null : rateQualifier(row as unknown as TreasuryAuction);
   return qualifier ? `${text} ${qualifier}` : text;
 };
@@ -61,14 +68,16 @@ const COLUMNS = [
     key: "rate",
     header: "Rate",
     align: "right" as const,
-    format: (value: unknown, row: Record<string, unknown>) => formatAuctionRate(row as unknown as TreasuryAuction, value == null ? null : Number(value), "-"),
+    format: (value: unknown, row: Record<string, unknown>) => formatAuctionRate(
+      row as unknown as TreasuryAuction, value == null ? null : Number(value), pending(row) ? RESULTS_NOT_PUBLISHED : "-",
+    ),
     textFormat: rateCell,
   },
-  { key: "stopOutVsAvgBp", header: "Stop-out vs avg (bp)", align: "right" as const, format: (value: unknown) => value == null ? "-" : Number(value).toFixed(1) },
   {
-    key: "bidToCoverRatio", header: "B/C", align: "right" as const,
-    format: (value: unknown, row: Record<string, unknown>) => value == null ? missing(row) : Number(value).toFixed(2),
+    key: "stopOutVsAvgBp", header: "Stop-out vs avg (bp)", align: "right" as const,
+    format: (value: unknown, row: Record<string, unknown>) => value == null ? pending(row) ? "" : "-" : Number(value).toFixed(1),
   },
+  { key: "bidToCoverRatio", header: "B/C", align: "right" as const, format: (value: unknown) => value == null ? "" : Number(value).toFixed(2) },
   { key: "indirectPercent", header: "Indirect", align: "right" as const, format: formatPercent },
   { key: "directPercent", header: "Direct", align: "right" as const, format: formatPercent },
   { key: "dealerPercent", header: "Dealer", align: "right" as const, format: formatPercent },

package/src/plugins/builtin/treasury-auctions/pane.tsx

@@ -105,6 +105,9 @@ function secTypeColor(secType: string, selected: boolean): string {
   }
 }
 
+/** An announced auction's Rate in the table, the word other panes use for a figure not out yet (KPI's Later actual). */
+const RESULTS_PENDING = "Pending";
+
 // Stable table adapter so memoized rows survive pane re-renders.
 const auctionKey = (auction: TreasuryAuction) => auction.id;
 
@@ -119,8 +122,8 @@ function renderAuctionCell(
 
   switch (column.id) {
     case "date":
-      // Announced auctions have no results yet; every metric cell reads "—",
-      // so the date carries the distinction instead of a second placeholder.
+      // Announced auctions have no results yet: Rate reads Pending, the other
+      // metric cells "—", and the date is bright.
       return {
         text: showYear ? auction.auctionDate : formatShortDate(auction.auctionDate, { year: false, utc: true, fallback: "\u2014" }),
         color: rowState.selected ? colors.selectedText : isPendingAuction(auction) ? colors.textBright : colors.textDim,
@@ -134,7 +137,10 @@ function renderAuctionCell(
     case "term":
       return { text: auction.securityTerm, color: selected ?? colors.text };
     case "rate":
-      return { text: formatAuctionRate(auction, rateValue(auction), "—"), color: selected ?? colors.textBright };
+      // An announced auction says its results are pending, as its detail does; other metric cells stay "—".
+      return isPendingAuction(auction)
+        ? { text: RESULTS_PENDING, color: dimmed }
+        : { text: formatAuctionRate(auction, rateValue(auction), "—"), color: selected ?? colors.textBright };
     case "stopOut":
       return { text: formatBp(stopOutVsAverageBp(auction)), color: selected ?? colors.text };
     case "btc":

package/src/plugins/builtin/treasury-daily/client.ts

@@ -1,8 +1,16 @@
 import { httpFetch } from "../../../utils/http-transport";
 import { numericOrNull, scalarTextOrNull } from "../../../utils/guards";
-import type { CashAccount, DebtDay, OperatingCash } from "./model";
+import { cashLineLabel, type CashAccount, type DebtDay, type OperatingCash, type TgaClose } from "./model";
 
 const CASH_URL = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/dts/operating_cash_balance?sort=-record_date&page[size]=40";
+// One line of the statement, every day since it took its present form in 2022: about a thousand closes.
+const TGA_CLOSING_ACCOUNT = "Treasury General Account (TGA) Closing Balance";
+const TGA_HISTORY_URL = `https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/dts/operating_cash_balance?${new URLSearchParams({
+  filter: `account_type:eq:${TGA_CLOSING_ACCOUNT}`,
+  fields: "record_date,open_today_bal",
+  sort: "-record_date",
+  "page[size]": "3000",
+})}`;
 const DEBT_URL = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?sort=-record_date&page[size]=20";
 const FETCH_TIMEOUT_MS = 15_000;
 const DEBT_DAYS = 20;
@@ -10,6 +18,9 @@ const DEBT_DAYS = 20;
 export interface TreasuryDaily {
   cash: OperatingCash;
   debt: DebtDay[];
+  /** The Treasury General Account's closing balance each day, oldest first. Empty when it could not be read, with the reason. */
+  tga: TgaClose[];
+  tgaError?: string;
 }
 
 function recordDate(value: unknown): string | null {
@@ -39,7 +50,7 @@ function parseOperatingCash(payload: unknown): OperatingCash {
     parsed.push({
       id: `${date}:${line ?? account}`,
       date,
-      account,
+      account: cashLineLabel(account),
       // Since the 2022 statement format the day's figures are in open_today_bal
       // and close_today_bal is always "null".
       today: numericOrNull(row.open_today_bal),
@@ -60,6 +71,17 @@ function parseOperatingCash(payload: unknown): OperatingCash {
   };
 }
 
+function parseTgaHistory(payload: unknown): TgaClose[] {
+  const byDate = new Map<string, number>();
+  for (const row of rowsOf(payload)) {
+    const date = recordDate(row.record_date);
+    // The closing balance is sent in open_today_bal, as the statement's other lines are.
+    const millions = numericOrNull(row.open_today_bal);
+    if (date && millions != null && !byDate.has(date)) byDate.set(date, millions);
+  }
+  return [...byDate].map(([date, millions]) => ({ date, millions })).sort((a, b) => a.date.localeCompare(b.date));
+}
+
 function parseDebtToPenny(payload: unknown): DebtDay[] {
   const byDate = new Map<string, DebtDay>();
   for (const row of rowsOf(payload)) {
@@ -87,10 +109,24 @@ async function readJson(url: string, label: string, signal?: AbortSignal): Promi
   return response.json() as Promise<unknown>;
 }
 
-export async function fetchTreasuryDaily(signal?: AbortSignal): Promise<TreasuryDaily> {
-  const [cash, debt] = await Promise.all([
+/**
+ * The latest day's cash lines and the last 20 days of debt, with the account's
+ * closing balance history unless `history` is off (a report that does not draw it).
+ * A history that cannot be read leaves the figures as they are.
+ */
+export async function fetchTreasuryDaily(signal?: AbortSignal, { history = true }: { history?: boolean } = {}): Promise<TreasuryDaily> {
+  const [cash, debt, tga] = await Promise.all([
     readJson(CASH_URL, "Treasury cash", signal),
     readJson(DEBT_URL, "Treasury debt", signal),
+    history ? readJson(TGA_HISTORY_URL, "Treasury account history", signal).then(parseTgaHistory).then(
+      (closes) => ({ closes }),
+      (error: unknown) => ({ closes: [] as TgaClose[], error: error instanceof Error ? error.message : String(error) }),
+    ) : { closes: [] as TgaClose[] },
   ]);
-  return { cash: parseOperatingCash(cash), debt: parseDebtToPenny(debt) };
+  return {
+    cash: parseOperatingCash(cash),
+    debt: parseDebtToPenny(debt),
+    tga: tga.closes,
+    ...("error" in tga ? { tgaError: tga.error } : {}),
+  };
 }

package/src/plugins/builtin/treasury-daily/headless.ts

@@ -3,7 +3,7 @@ import { fetchTreasuryDaily } from "./client";
 import { formatBillions, formatTrillions } from "./model";
 
 const CASH_COLUMNS: HeadlessPaneColumn[] = [
-  { key: "account", header: "Account" },
+  { key: "account", header: "Treasury General Account" },
   { key: "today", header: "Today $bn", align: "right", description: "The day's figure, billions of dollars", format: formatBillions },
   { key: "month", header: "This month $bn", align: "right", description: "Month to date, billions of dollars", format: formatBillions },
 ];
@@ -32,7 +32,7 @@ export const treasuryDailyHeadless: HeadlessPaneDefinition<"bundle"> = {
   describe: "Treasury operating cash and public debt",
   freshness: { source: "US Treasury", status: "not-a-feed", basis: "daily statement" },
   async load(_args, ctx) {
-    const { cash, debt } = await fetchTreasuryDaily(ctx.signal);
+    const { cash, debt } = await fetchTreasuryDaily(ctx.signal, { history: false });
     return {
       complete: cash.rows.length > 0 && debt.length > 0,
       sections: [

package/src/plugins/builtin/treasury-daily/index.tsx

@@ -8,7 +8,7 @@ export const treasuryDailyModule: PluginModule = {
     id: "treasury-daily-pane",
     paneId: TREASURY_DAILY_PANE_ID,
     label: "Treasury Cash and Debt",
-    description: "Treasury operating cash for the latest day, and debt held by the public for the last 20 business days.",
+    description: "Treasury operating cash for the latest day with the Treasury General Account's closing balance history, and debt held by the public for the last 20 business days.",
     keywords: ["treasury", "dts", "debt", "cash", "tga", "debt to the penny", "operating cash"],
     shortcut: { prefix: "DTS" },
     headless: treasuryDailyHeadless,

package/src/plugins/builtin/treasury-daily/model.ts

@@ -1,4 +1,5 @@
 import type { DataTableColumn } from "../../../components";
+import { formatNumber } from "../../../utils/format";
 
 export const TREASURY_DAILY_PANE_ID = "treasury-daily";
 
@@ -23,6 +24,51 @@ export interface OperatingCash {
   rows: CashAccount[];
 }
 
+/** One day's Treasury General Account closing balance, millions of dollars. */
+export interface TgaClose {
+  date: string;
+  millions: number;
+}
+
+/** The longest stretch of closing balances the Cash tab charts, and the ranges it offers. */
+export type TgaRange = "3M" | "6M" | "1Y" | "ALL";
+export const TGA_RANGES: ReadonlyArray<{ value: TgaRange; label: string; hint: string; months: number | null }> = [
+  { value: "3M", label: "3M", hint: "1", months: 3 },
+  { value: "6M", label: "6M", hint: "2", months: 6 },
+  { value: "1Y", label: "1Y", hint: "3", months: 12 },
+  { value: "ALL", label: "All", hint: "4", months: null },
+];
+const DEFAULT_TGA_RANGE: TgaRange = "1Y";
+
+export function tgaRange(value: unknown): TgaRange {
+  return TGA_RANGES.find((range) => range.value === value)?.value ?? DEFAULT_TGA_RANGE;
+}
+
+/** The closes of the last `range`, counted back from the newest one, oldest first. */
+export function tgaClosesInRange(closes: readonly TgaClose[], range: TgaRange): TgaClose[] {
+  const months = TGA_RANGES.find((entry) => entry.value === range)?.months ?? null;
+  const last = closes.at(-1);
+  if (months == null || !last) return [...closes];
+  const start = new Date(`${last.date}T00:00:00Z`);
+  start.setUTCMonth(start.getUTCMonth() - months);
+  const from = start.toISOString().slice(0, 10);
+  return closes.filter((close) => close.date >= from);
+}
+
+/**
+ * What the Treasury's statement calls a line of the Treasury General Account,
+ * said plainly: `Treasury General Account (TGA) Opening Balance` is the
+ * opening balance, `Total TGA Withdrawals (Table II) (-)` the withdrawals. A
+ * line the statement adds later keeps its own words, less the table reference.
+ */
+export function cashLineLabel(account: string): string {
+  if (/^Treasury General Account \(TGA\) Opening Balance$/i.test(account)) return "Opening balance";
+  if (/^Treasury General Account \(TGA\) Closing Balance$/i.test(account)) return "Closing balance";
+  if (/^Total TGA Deposits\b/i.test(account)) return "Deposits";
+  if (/^Total TGA Withdrawals\b/i.test(account)) return "Withdrawals";
+  return account.replace(/\s*\(Table [IVX]+\)/g, "").replace(/\s*\(-\)$/, "").trim();
+}
+
 export interface DebtDay {
   id: string;
   date: string;
@@ -40,7 +86,7 @@ export type CashColumn = DataTableColumn & { id: CashColumnId };
 export type DebtColumn = DataTableColumn & { id: DebtColumnId };
 
 export const CASH_COLUMNS: CashColumn[] = [
-  { id: "account", label: "Account", width: 28, align: "left", flexGrow: 1 },
+  { id: "account", label: "Treasury General Account", width: 26, align: "left", flexGrow: 1 },
   { id: "today", label: "Today $bn", width: 12, align: "right" },
   { id: "month", label: "This month $bn", width: 15, align: "right" },
 ];
@@ -52,10 +98,11 @@ export const DEBT_COLUMNS: DebtColumn[] = [
   { id: "total", label: "Total $tn", width: 12, align: "right" },
 ];
 
+/** Two decimals with thousands separators, as every money table writes a large figure: `2,594.63`. */
 function scaled(value: unknown, divisor: number): string {
   if (typeof value !== "number" || !Number.isFinite(value)) return "--";
-  const text = (value / divisor).toFixed(2);
-  return text === "-0.00" ? "0.00" : text;
+  const rounded = Number((value / divisor).toFixed(2));
+  return formatNumber(rounded === 0 ? 0 : rounded, 2);
 }
 
 /** Millions of dollars, drawn as billions. */

package/src/plugins/builtin/treasury-daily/pane.tsx

@@ -1,33 +1,52 @@
 import { useCallback, useMemo, useState } from "react";
 import {
+  ChartTableHeader,
   DataTableView,
   PaneStatusBody,
+  QueryBar,
+  usePaneNoticeFooter,
   usePaneStatusFooter,
   usePaneTabs,
+  type ChartTableChart,
   type DataTableCell,
+  type DataTableKeyEvent,
 } from "../../../components";
-import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
+import { spanAxisFormatter } from "../../../components/chart-table";
+import { useChartViewReset } from "../../../components/chart/core/view-reset";
+import { scalarPoint, staticSeries } from "../../../components/chart/static/series";
+import { handleRefreshKey, usePaneRefreshKey } from "../../../components/data-table/table-pane";
 import { useAsyncResource, useAutoRefresh, usePluginPaneState } from "../../../public/react";
 import { useThemeColors } from "../../../theme/theme-context";
 import type { PaneProps } from "../../../types/plugin";
 import { Box } from "../../../ui";
+import { formatNumber } from "../../../utils/format";
+import { isPlainKeyboardEvent } from "../../../utils/keyboard";
 import { fetchTreasuryDaily } from "./client";
 import {
   CASH_COLUMNS,
   DEBT_COLUMNS,
+  TGA_RANGES,
   TREASURY_DAILY_PANE_ID,
   TREASURY_TABS,
   formatBillions,
   formatTrillions,
+  tgaClosesInRange,
+  tgaRange,
   type CashAccount,
   type CashColumn,
   type DebtColumn,
   type DebtDay,
+  type TgaRange,
   type TreasuryTab,
 } from "./model";
 
 const EMPTY_CASH: CashAccount[] = [];
 const EMPTY_DEBT: DebtDay[] = [];
+const RANGE_OPTIONS = TGA_RANGES.map(({ value, label, hint }) => ({ value, label, hint }));
+const TGA_SERIES_LABEL = "TGA closing balance $bn";
+/** Ticks in billions, with thousands separators and the decimals the plotted range needs. */
+const formatBillionsAxis = spanAxisFormatter((value, digits) => formatNumber(value, digits));
+const formatBillionsLevel = (value: number) => formatNumber(value, 2);
 
 function scaledCell(value: number | null, text: string, muted: string): DataTableCell {
   return value == null ? { text, value, color: muted } : { text, value };
@@ -44,6 +63,9 @@ export function TreasuryDailyPane({ width, height, focused }: PaneProps) {
   const debtRows = data?.debt ?? EMPTY_DEBT;
   const activeRows = tab === "cash" ? cashRows : debtRows;
   const recordDate = tab === "cash" ? data?.cash.recordDate ?? null : debtRows[0]?.date ?? null;
+  const [storedRange, setStoredRange] = usePluginPaneState<string>("range", "1Y");
+  const range = tgaRange(storedRange);
+  const resetChartView = useChartViewReset();
   const [selectedId, setSelectedId] = useState<string | null>(null);
   const resolvedId = activeRows.some((row) => row.id === selectedId) ? selectedId : activeRows[0]?.id ?? null;
   const info = useMemo(
@@ -58,13 +80,46 @@ export function TreasuryDailyPane({ width, height, focused }: PaneProps) {
     dense: true,
   });
   useAutoRefresh(resource.updatedAt, resource.load);
-  usePaneRefreshKey(() => void resource.reload(), { focused });
+  const refresh = useCallback(() => void resource.reload(), [resource.reload]);
+  usePaneRefreshKey(refresh, { focused });
   usePaneStatusFooter({
     registrationId: TREASURY_DAILY_PANE_ID,
     loading: resource.loading,
     error: resource.error,
     info,
   });
+  usePaneNoticeFooter({
+    registrationId: `${TREASURY_DAILY_PANE_ID}:history`,
+    focused: focused && tab === "cash",
+    notices: data?.tgaError ? [`Closing balance history is unavailable: ${data.tgaError}`] : [],
+  });
+
+  // The closing balance the table's last line states for the day, drawn over the range chosen.
+  const series = useMemo(() => {
+    const closes = tgaClosesInRange(data?.tga ?? [], range);
+    return closes.length < 2 ? [] : [staticSeries(
+      closes.map((close) => scalarPoint(new Date(`${close.date}T00:00:00Z`), close.millions / 1_000)),
+      { id: "tga-closing-balance", label: TGA_SERIES_LABEL, color: colors.positive, calendarSpaced: true },
+    )];
+  }, [colors.positive, data?.tga, range]);
+  const chart: ChartTableChart | null = data?.tgaError ? null : {
+    series,
+    formatValue: formatBillionsLevel,
+    formatAxisValue: formatBillionsAxis,
+    remoteKind: "treasury-general-account",
+    empty: "No closing balance history.",
+  };
+  // The number keys pick the range, as the bar's hints say; picking the one showing sends the chart back to it.
+  const handleKeyDown = useCallback((event: DataTableKeyEvent) => {
+    if (handleRefreshKey(event, refresh, { stopPropagation: true })) return true;
+    if (!isPlainKeyboardEvent(event)) return false;
+    const picked = TGA_RANGES.find((option) => option.hint === event.name);
+    if (!picked) return false;
+    event.preventDefault?.();
+    if (picked.value === range) resetChartView();
+    else setStoredRange(picked.value);
+    return true;
+  }, [range, refresh, resetChartView, setStoredRange]);
 
   const bodyHeight = Math.max(1, height - tabRows);
   const renderCash = useCallback((row: CashAccount, column: CashColumn): DataTableCell => {
@@ -91,6 +146,30 @@ export function TreasuryDailyPane({ width, height, focused }: PaneProps) {
         focused={focused}
         rootWidth={width}
         rootHeight={bodyHeight}
+        rootBefore={chart ? (
+          <ChartTableHeader
+            width={width}
+            height={bodyHeight}
+            tableRows={cashRows.length}
+            tableColumns={CASH_COLUMNS}
+            query={(
+              <QueryBar
+                width={width}
+                filters={[{
+                  id: "range",
+                  label: "Range",
+                  inline: true,
+                  chartRange: true,
+                  value: range,
+                  options: RANGE_OPTIONS,
+                  onChange: (value: string) => setStoredRange(tgaRange(value) satisfies TgaRange),
+                }]}
+              />
+            )}
+            chart={chart}
+          />
+        ) : undefined}
+        onRootKeyDown={handleKeyDown}
         columns={CASH_COLUMNS}
         items={cashRows}
         sortColumnId={null}