@gloom-sh/terminal 0.18.5 → 0.19.0

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}

package/src/plugins/builtin/vol-surface/client.ts

@@ -1,4 +1,5 @@
 import { apiClient } from "../../../api-client";
+import { createTtlCache } from "../../../data/ttl-cache";
 import { getSharedMarketDataCoordinator, MarketDataCoordinator, resolveEntryValue } from "../../../market-data/coordinator";
 import type { InstrumentRef, OptionsRequest } from "../../../market-data/request-types";
 import type { QueryEntry } from "../../../market-data/result-types";
@@ -73,19 +74,8 @@ export function withReusedYieldCurve(
   dependencies: SurfaceLoaderDependencies,
   reuseMs = TREASURY_CURVE_REUSE_MS,
 ): SurfaceLoaderDependencies {
-  let held: { at: number; curve: Promise<YieldPoint[]> } | null = null;
-  return {
-    ...dependencies,
-    loadYieldCurve: () => {
-      const now = Date.now();
-      if (held && now - held.at < reuseMs) return held.curve;
-      const curve = dependencies.loadYieldCurve();
-      const entry = { at: now, curve };
-      held = entry;
-      curve.catch(() => { if (held === entry) held = null; });
-      return curve;
-    },
-  };
+  const curves = createTtlCache<YieldPoint[]>({ ttlMs: reuseMs });
+  return { ...dependencies, loadYieldCurve: () => curves.load("curve", () => dependencies.loadYieldCurve()) };
 }
 
 export interface SurfaceLoadRequest {

package/src/plugins/builtin/vol-surface/headless.ts

@@ -12,7 +12,7 @@ import { createSurfaceDependencies, loadVolatilitySurface } from "./client";
 import { buildSurfaceGrid, type SurfaceGridOptions, type SurfaceSettings, type SurfaceSnapshot } from "./model";
 import { atCapturePrecision, formatCaptureTime, loadDatedSurface, storedSurfaceDate, type DatedSurfaceSnapshot } from "./stored";
 import { listingFateEmpty, loadListingFate } from "../../../tickers/listing-fate";
-import { coinOptionsAlias, coinWithoutOptionsRefusal } from "../../../market-data/options-alternatives";
+import { coinOptionsAlias, coinWithoutOptionsRefusal, fxVolatilityRefusal } from "../../../market-data/options-alternatives";
 import { formatUtcTime } from "../../../utils/utc-time";
 import { dvolCurrency, dvolGap, dvolSeriesId, loadDvol, type DvolPayload } from "../volatility/dvol";
 import {
@@ -118,7 +118,7 @@ function skewSection(snapshot: SurfaceSnapshot): HeadlessBundleSection {
   return { title: "Skew", columns: [
     { key: "expiry", header: "Expiry" }, { key: "days", header: "Days", format: days },
     { key: "put25", header: "25D put IV", format: iv }, { key: "call25", header: "25D call IV", format: iv },
-    // Each difference names its sign: the risk reversal is call minus put, unlike HIVG and VCA's put-minus-call skew.
+    // Each difference names its sign: the risk reversal is call minus put here and in VCA and HIVG's rr25d.
     { key: "riskReversal", header: skewHeader("RR", "call-put"), format: gap }, { key: "butterfly", header: skewHeader("BF", "wings-ATM"), format: gap },
     { key: "moneynessSkew", header: skewHeader("90/110", "90%-110%"), format: (value, row) => typeof value === "number" ? points(value)
       : (row as unknown as SurfaceSkewRow).moneynessGap ?? "--" },
@@ -169,7 +169,7 @@ export const volSurfaceHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle", argument: { kind: "ticker", description: "Underlying ticker" },
   usListingsOnly: "Options data",
   symbolAlias: coinOptionsAlias("OVDV"),
-  refuseSymbol: coinWithoutOptionsRefusal("OVDV"),
+  refuseSymbol: (key) => coinWithoutOptionsRefusal("OVDV")(key) ?? fxVolatilityRefusal("OVDV")(key),
   discovery: { suggestFor: IMPLIED_VOL_WORDS },
   describe: (args) => `OVDV ${args.symbols[0] ?? ""}`,
   options: [

package/src/plugins/builtin/vol-surface/index.tsx

@@ -39,7 +39,7 @@ export const volSurfaceModule: PluginModule = {
   paneTemplates: [createTickerSurfacePaneTemplate({
     id: "vol-surface-pane", paneId: "vol-surface", label: "Volatility Surface",
     description: "Implied volatility surface, smiles, term structure, skew (25-delta risk reversal and butterfly) and forwards; DVOL beside BTC-USD and ETH-USD.",
-    keywords: ["ovdv", "volatility", "surface", "smile", "skew", "options", "risk reversal", "butterfly", "25 delta", "dvol", "deribit", "implied volatility index"],
+    keywords: ["ovdv", "volatility", "vol", "surface", "smile", "skew", "options", "risk reversal", "butterfly", "25 delta", "dvol", "deribit", "implied volatility index"],
     shortcut: "OVDV", publicShare: true,
     settings: (_symbol, _context, options) => options?.values?.expiration
       ? { expiration: Number(options.values.expiration) } : {},

package/src/plugins/builtin/vol-surface/pane.tsx

@@ -43,7 +43,7 @@ import { expiryLabel, formatIv, formatPrice, formatVolPoints, HIDDEN_SLOPE_TEXT,
   surfaceSkewRow, surfaceSpotBasisLabel } from "./tables";
 import { findListedExpiry, unlistedExpiryText } from "../../../utils/option-expiry";
 import { dvolCurrency, dvolGap, loadDvol, type DvolPayload } from "../volatility/dvol";
-import { COIN_OPTIONS_HINT, isCoinWithoutOptions, optionsUnavailableTitle } from "../../../market-data/options-alternatives";
+import { COIN_OPTIONS_HINT, fxVolatilityNote, isCoinWithoutOptions, optionsUnavailableTitle } from "../../../market-data/options-alternatives";
 import { parsePublicTickerKey } from "../../../utils/exchanges";
 import { surfaceThirtyDayAtm } from "./tables";
 
@@ -191,9 +191,10 @@ export function VolSurfacePane({ focused, width, height }: PaneProps) {
   const fateExchange = target?.effectiveExchange ?? "";
   const fateLoader = useCallback(async () => (await getSharedMarketDataCoordinator()
     ?.loadListingFate({ symbol: underlying, exchange: fateExchange }))?.note ?? null, [underlying, fateExchange]);
-  // A coin nothing lists options on (SOL-USD) says which coins have them.
+  // A coin nothing lists options on (SOL-USD) says which coins have them, and an FX pair which funds stand in.
   const coinNote = underlying && isCoinWithoutOptions(underlying)
-    ? `${optionsUnavailableTitle(parsePublicTickerKey(underlying).symbol)} ${COIN_OPTIONS_HINT}` : null;
+    ? `${optionsUnavailableTitle(parsePublicTickerKey(underlying).symbol)} ${COIN_OPTIONS_HINT}`
+    : underlying ? fxVolatilityNote(underlying, target?.effectiveExchange) : null;
   const fateNote = useAsyncResource(underlying && noChain && !coinNote ? fateLoader : null).data ?? coinNote;
   const ivRank = useIvRank(underlying || null);
   // A coin's options (BTC-USD, ETH-USD) come with Deribit's volatility index.
@@ -224,9 +225,10 @@ export function VolSurfacePane({ focused, width, height }: PaneProps) {
   // visible; the upstream chain cache dedupes the requests across users. A
   // delayed surface keeps the configured refresh.
   const realtimeSurface = !!settledSnapshot?.expiries.some((entry) => entry.dataSource === "live" || entry.realtimeEligible === true);
-  const liveActive = useLiveSessionRefresh(reloadLive, SURFACE_LIVE_RELOAD_MS,
+  const liveRefresh = useLiveSessionRefresh(reloadLive, SURFACE_LIVE_RELOAD_MS,
     !!symbol && spotAvailable && !historyDate && !fallbackDate && liveStreaming && realtimeSurface && !resource.loading,
     resource.updatedAt);
+  const liveActive = liveRefresh.live;
   useAutoRefresh(resource.updatedAt, liveActive ? noRefresh : resource.load);
   const shownDate = historyDate ?? fallbackDate;
   const storedLoader = useCallback(async () => storedSurfaceSnapshot(await loadStoredSurface(underlying, shownDate!)), [underlying, shownDate]);
@@ -396,7 +398,7 @@ export function VolSurfacePane({ focused, width, height }: PaneProps) {
     ...(pinned != null && snapshot && !resource.loading && !snapshot.catalogue.includes(pinned)
       && !snapshot.failures.some((failure) => failure.expiration === pinned)
       ? [`${expiryLabel(pinned)}: ${unlistedExpiryText(pinned, snapshot.catalogue)}`] : []),
-    ...(active.error ? [active.error] : [])];
+    ...(active.error ? [active.error] : []), ...(liveRefresh.error ? [liveRefresh.error] : [])];
   const spotBasis = snapshot && !snapshot.stored ? surfaceSpotBasisLabel(snapshot) : null;
   // What the quotes are and when they were observed; a reload moves the time.
   const freshness = !snapshot ? null : snapshot.stored ? `stored close ${snapshot.stored.sessionDate}`

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

@@ -14,13 +14,13 @@ export const volatilityModule: PluginModule = {
   paneTemplates: [{
     id: "volatility-term-structure-pane", paneId: "volatility-term-structure",
     label: "VIX Curve", description: "Dated VIX tenor closes, the 3M/30D ratio history and the cross-asset volatility board.",
-    keywords: ["vix", "volatility", "curve", "contango", "backwardation", "vvix", "skew", "move"],
+    keywords: ["vix", "volatility", "vol", "curve", "contango", "backwardation", "vvix", "skew", "move"],
     shortcut: { prefix: "VIX" }, headless: volatilityHeadless,
     createInstance: () => ({ instanceId: "volatility:curve", title: "VIX", placement: "floating", settings: { initialTab: "curve" } }),
   }, {
     id: "volatility-board-pane", paneId: "volatility-term-structure",
     label: "Cross-asset Volatility", description: "Volatility index closes, daily changes and one-year percentiles.",
-    keywords: ["volatility", "cross asset", "vols", "vxn", "ovx", "gvz"],
+    keywords: ["volatility", "vol", "cross asset", "vols", "vxn", "ovx", "gvz"],
     shortcut: { prefix: "VOLS" }, headless: volatilityHeadless,
     createInstance: () => ({ instanceId: "volatility:board", title: "VOLS", placement: "floating", settings: { initialTab: "board" } }),
   }],

package/src/plugins/builtin/volatility/pane.tsx

@@ -107,7 +107,7 @@ export function VolatilityPane({ focused, width, height }: PaneProps) {
     await coordinator.loadQuotesBatch(quiet.map((target) => ({ symbol: target.symbol, exchange: "" })), { forceRefresh: true });
   }, [liveTargets]);
   // With streaming off the quote layer already polls every minute.
-  useLiveSessionRefresh(refreshIndexLevels, INDEX_LEVEL_REFRESH_MS, liveStreaming && liveTargets.length > 0);
+  const levelRefresh = useLiveSessionRefresh(refreshIndexLevels, INDEX_LEVEL_REFRESH_MS, liveStreaming && liveTargets.length > 0);
   const liveLevels = useThrottledValue(useMemo(() => {
     const levels = new Map<VolatilityIndexId, VolatilityLiveLevel>();
     for (const definition of VOLATILITY_INDICES) {
@@ -139,7 +139,7 @@ export function VolatilityPane({ focused, width, height }: PaneProps) {
   }, [data?.board, sort, loading]);
   const selected = rows.find((row) => row.id === selectedId) ?? rows[0] ?? null;
   useVolatilityEvidence(result, tab, selected, resource.loading);
-  const notices = [resource.error, ...(result?.errors ?? []), ...(data?.warnings ?? []),
+  const notices = [resource.error, levelRefresh.error, ...(result?.errors ?? []), ...(data?.warnings ?? []),
     ...(selected?.warnings ?? [])].filter((notice): notice is string => !!notice);
   usePaneNoticeFooter({ registrationId: "volatility-notices", notices, focused });
   // From the tab the press finds, so the footer's hint never holds an old one.

package/src/plugins/builtin/world-venue-map/headless.ts

@@ -84,15 +84,15 @@ function layerColumns(layer: GeoLayerInfo): HeadlessPaneColumn[] {
 /**
  * What a search that finds nothing says. A search outside a one-country layer
  * finds nothing because the layer has nothing there; ships are found by name,
- * not by the ticker of the company that runs them, so a ticker that links no
- * fleet (or a server that links none) gets a name to try.
+ * or by the name or ticker of an operator whose fleet is linked, so anything
+ * else (or a server that links no fleet) gets a name to try.
  */
 function emptySearchNote(layer: GeoLayerInfo, query: string): string | null {
   const typed = query.trim();
   if (!typed) return null;
   const coverage = layerCoverageNote(layer);
   if (coverage) return `No ${layer.name.toLowerCase()} match "${typed}". ${coverage}`;
-  if (layer.id === "vessels") return `No ${layer.name.toLowerCase()} match "${typed}"; try a ship-name prefix, such as --query Norwegian.`;
+  if (layer.id === "vessels") return `No ${layer.name.toLowerCase()} match "${typed}"; try a ship-name prefix or an operator, such as --query Norwegian or --query "Royal Caribbean".`;
   return null;
 }
 

package/src/plugins/catalog-manifest.ts

@@ -75,7 +75,8 @@ const NATIVE_TARGETS: PluginTarget[] = ["cli", "tui", "desktop"];
  */
 function functionsOf(plugin: GloomPlugin) {
   return pluginFunctions({
-    templates: (plugin.paneTemplates ?? []).map((template) => ({
+    // An unlisted function (`listed: false`) is not published.
+    templates: (plugin.paneTemplates ?? []).filter((template) => template.listed !== false).map((template) => ({
       label: template.label,
       prefix: template.shortcut?.prefix,
       description: template.description,

package/src/plugins/marketplace/model.ts

@@ -186,6 +186,19 @@ function repoDirectory(repo: string | undefined): string | null {
   return name ? name.toLowerCase() : null;
 }
 
+/**
+ * Built-ins write their copy as sentences and registry plugins as labels, so a
+ * row's short line is read without its closing period, whoever wrote it, and
+ * the detail's paragraph always has one. An ellipsis stays as written.
+ */
+function rowLine(text: string | undefined): string {
+  return (text ?? "").trim().replace(/(?<!\.)\.$/, "");
+}
+function detailParagraph(text: string | undefined): string | undefined {
+  const paragraph = text?.trim();
+  return paragraph ? /[\p{L}\p{N}]$/u.test(paragraph) ? `${paragraph}.` : paragraph : undefined;
+}
+
 /** The short line a built-in's row reads: its editorial tagline, else its description. */
 function builtinTagline(local: InstalledPlugin): string {
   return BUILTIN_EDITORIAL[local.id]?.tagline ?? local.description ?? "";
@@ -257,8 +270,8 @@ export function mergeCatalog(options: {
     entries.push({
       id: plugin.id,
       name: builtin?.name ?? plugin.name,
-      tagline: builtin ? builtinTagline(builtin) : plugin.tagline,
-      description: builtin?.description ?? plugin.description,
+      tagline: rowLine(builtin ? builtinTagline(builtin) : plugin.tagline),
+      description: detailParagraph(builtin?.description ?? plugin.description),
       categories: builtin ? BUILTIN_EDITORIAL[plugin.id]?.categories ?? plugin.categories : plugin.categories,
       tier: plugin.tier,
       targets: plugin.targets,
@@ -309,10 +322,10 @@ export function mergeCatalog(options: {
     entries.push({
       id: local.id,
       name: local.name,
-      tagline: local.source === "builtin"
+      tagline: rowLine(local.source === "builtin"
         ? builtinTagline(local)
-        : local.description ?? (local.linked ? "Linked from a local checkout" : "Installed outside the registry"),
-      description: local.description,
+        : local.description ?? (local.linked ? "Linked from a local checkout" : "Installed outside the registry")),
+      description: detailParagraph(local.description),
       categories: local.source === "builtin" ? [...BUILTIN_EDITORIAL[local.id]?.categories ?? []] : ["unlisted"],
       // Shipped by Gloom like every built-in, whether or not the feed lists it.
       tier: local.source === "builtin" ? "official" : "community",

package/src/portfolio/futures-positions.ts

@@ -36,10 +36,12 @@ export interface FuturesSettlement {
   previous: number | null;
 }
 
-/** What a portfolio reads from a future's terms: its contract size and its settlement. */
+/** A future's contract size, settlement and front reference for collection rows. */
 export interface PortfolioFuturesTerms {
   size: FuturesContractSize | null;
   settlement: FuturesSettlement | null;
+  /** A different contract that is currently front, when the terms name one. */
+  front?: Pick<NonNullable<FuturesContractTermsPayload["front"]>, "contract" | "contractSymbol">;
 }
 
 /** A grain or a soft quotes in US cents, so a dollar point value is a hundred of its price units. */
@@ -167,7 +169,7 @@ export function previousFuturesSettlement(
 
 /** What a portfolio reads from a future's terms, with the settlement before the latest when the history has it. */
 export function portfolioFuturesTerms(
-  terms: Pick<FuturesContractTermsPayload, "spec" | "settlement"> | null | undefined,
+  terms: (Pick<FuturesContractTermsPayload, "spec" | "settlement"> & Partial<Pick<FuturesContractTermsPayload, "front" | "contract">>) | null | undefined,
   history?: readonly PricePoint[] | null,
 ): PortfolioFuturesTerms {
   const settlement = terms?.settlement && Number.isFinite(terms.settlement.price) && terms.settlement.price > 0
@@ -177,7 +179,8 @@ export function portfolioFuturesTerms(
       previous: previousFuturesSettlement(history, terms.settlement.date, terms.settlement.price),
     }
     : null;
-  return { size: futuresContractSize(terms?.spec), settlement };
+  const front = terms?.front && terms.front.contract !== terms.contract ? terms.front : undefined;
+  return { size: futuresContractSize(terms?.spec), settlement, ...(front ? { front } : {}) };
 }
 
 /**

package/src/portfolio/position-quantity.ts

@@ -23,21 +23,27 @@ function tradesInWholeUnits(ticker: TickerRecord): boolean {
 }
 
 /**
- * Why a typed size cannot be stored as read: a dot and three digits (`1.250`)
- * on a listing held in whole units, where it is far likelier the thousands
- * grouping many locales write (1,250 shares) than a quarter of a share, so the
- * command asks which, as it does for `1,250`. Null for any other size, and
- * for a listing that may be held in fractions, where `1.250` is 1.25.
+ * Why a typed size cannot be stored as read: a dot and three digits (`1.000`,
+ * `1.250`), which is as likely the thousands grouping many locales write
+ * (1,000 shares, as cash reads `1.000`) as a fraction of a share, so the
+ * command asks which, as it does for `1,250`. On a listing held in whole
+ * units the thousands reading is the only one that can be held, and the
+ * message says so. Null for any other size (`0.500`, `12.25`).
  */
-export function wholeUnitQuantityProblem(
+export function ambiguousQuantityProblem(
   typed: string,
   ticker: TickerRecord,
   options: { label?: PositionQuantityLabel; listing?: string } = {},
 ): string | null {
   const reading = thousandsDotReadings(typed);
-  if (!reading || !tradesInWholeUnits(ticker)) return null;
+  if (!reading) return null;
   const label = options.label ?? positionQuantityLabel(ticker);
   const listing = options.listing ?? ticker.metadata.ticker;
-  const because = `${listing} trades in whole ${label === "Contracts" ? "contracts" : "shares"}`;
-  return `${label} ${ambiguousNumberMessage(typed, reading, { because })}.`;
+  const because = tradesInWholeUnits(ticker)
+    ? `${listing} trades in whole ${label === "Contracts" ? "contracts" : "shares"}`
+    : undefined;
+  // The fraction typed so it does not read two ways itself: 1.234 asks again, 1.2340 does not.
+  const fraction = String(reading.decimal);
+  const decimalAs = thousandsDotReadings(fraction) ? `${fraction}0` : fraction;
+  return `${label} ${ambiguousNumberMessage(typed, reading, { because, decimalAs })}.`;
 }

package/src/remote/resources.ts

@@ -110,7 +110,8 @@ export function createRemoteResources({
       }));
     }
     if (resource === "app://pane-templates") {
-      return [...pluginRegistry.paneTemplates.values()].map((template) => ({
+      // An unlisted function (`listed: false`) is left out, as of every list.
+      return [...pluginRegistry.paneTemplates.values()].filter((template) => template.listed !== false).map((template) => ({
         id: template.id,
         paneId: template.paneId,
         label: template.label,

package/src/renderers/dom/data-table/row.tsx

@@ -457,6 +457,32 @@ function WebDataTableRowInner<
 
 function CellText({ cell, column, color }: { cell: DataTableCell; column: DataTableColumn; color: string }) {
   const style = clippedCellTextStyle(column, color, cell.attributes ?? TextAttributes.NONE);
+  if (cell.note) {
+    const text = (
+      <div
+        style={{
+          display: "flex",
+          flexWrap: "wrap",
+          alignContent: "flex-start",
+          justifyContent: contentJustifyForAlign(column.align),
+          columnGap: "var(--gloom-space-sm)",
+          width: "100%",
+          height: "100%",
+          minWidth: 0,
+          overflow: "hidden",
+        }}
+      >
+        <span title={cell.text} style={{ ...style, width: "auto", flex: "0 1 auto", minWidth: 0 }}>{cell.text}</span>
+        <span data-gloom-role="data-table-cell-note" style={{ ...cellTextStyle(CSS_TEXT_DIM, TextAttributes.NONE), flex: "none" }}>{cell.note}</span>
+      </div>
+    );
+    return cell.leading === undefined ? text : (
+      <div style={{ display: "flex", alignItems: "center", gap: LABEL_GAP_PX, width: "100%", height: "100%", minWidth: 0, overflow: "hidden" }}>
+        <Leading>{cell.leading}</Leading>
+        {text}
+      </div>
+    );
+  }
   if (cell.leading === undefined) return <span title={cell.text} style={style}>{cell.text}</span>;
   return (
     <div

package/src/renderers/dom/desktop/list-view.tsx

@@ -27,6 +27,7 @@ function DefaultDesktopRow({
   stacked: boolean;
 }) {
   const colors = useThemeColors();
+  if (item.kind === "heading") return <Text fg={colors.textMuted}>{item.label}</Text>;
   return (
     <Box
       flexDirection="row"
@@ -142,6 +143,7 @@ export function WebListView({
   const rowHoverBg = hoverBgColor ?? hoverBg(colors);
   const selectedItem = selectedIndex >= 0 ? items[selectedIndex] : undefined;
   const activeScrollIndex = scrollIndex ?? selectedIndex;
+  const headingAboveSelection = items[activeScrollIndex - 1]?.kind === "heading";
   const rowStride = rowHeight + rowGap;
   const tabStopIndex = selectedIndex >= 0 && items[selectedIndex] && !items[selectedIndex].disabled
     ? selectedIndex : items.findIndex((item) => !item.disabled);
@@ -176,14 +178,14 @@ export function WebListView({
     if (!scrollBox) return;
     const safeIndex = Math.min(activeScrollIndex, items.length - 1);
     const viewportHeight = Math.max(scrollBox.viewport?.height ?? 0, 1);
-    const rowTop = safeIndex * rowStride;
-    const rowBottom = rowTop + rowHeight;
+    const rowTop = Math.max(0, safeIndex - (headingAboveSelection ? 1 : 0)) * rowStride;
+    const rowBottom = safeIndex * rowStride + rowHeight;
     if (rowTop < scrollBox.scrollTop) {
       scrollBox.scrollTo(rowTop);
     } else if (rowBottom > scrollBox.scrollTop + viewportHeight) {
       scrollBox.scrollTo(rowBottom - viewportHeight);
     }
-  }, [activeScrollIndex, autoScrollToIndex, items.length, rowHeight, rowStride, scrolls]);
+  }, [activeScrollIndex, autoScrollToIndex, headingAboveSelection, items.length, rowHeight, rowStride, scrolls]);
 
   useEffect(() => {
     if (!scrolls) return;
@@ -202,7 +204,7 @@ export function WebListView({
     const list = document.getElementById(listDomId);
     const active = document.activeElement;
     if (!list || !active || !list.contains(active) || isEditableKeyboardTarget(active)) return;
-    const row = list.querySelectorAll<HTMLElement>('[role="option"]')[selectedIndex];
+    const row = list.querySelector<HTMLElement>(`[data-gloom-list-index="${selectedIndex}"]`);
     if (row && !row.contains(active)) row.focus({ preventScroll: scrolls });
   }, [listDomId, scrolls, selectedIndex]);
 
@@ -246,10 +248,11 @@ export function WebListView({
             onActivate?.(item, index);
           }}
           data-gloom-role="desktop-list-row"
-          role="option"
-          aria-selected={selected}
-          aria-disabled={disabled || undefined}
-          tabIndex={index === tabStopIndex ? 0 : -1}
+          data-gloom-list-index={index}
+          role={item.kind === "heading" ? "presentation" : "option"}
+          aria-selected={item.kind === "heading" ? undefined : selected}
+          aria-disabled={item.kind === "heading" ? undefined : disabled || undefined}
+          tabIndex={item.kind === "heading" ? undefined : index === tabStopIndex ? 0 : -1}
           onKeyDown={(event: React.KeyboardEvent<HTMLElement>) => {
             if (disabled) return;
             if (event.key === " " || (event.key === "Enter" && !checkboxRows)) {
@@ -267,8 +270,8 @@ export function WebListView({
             while (items[nextIndex]?.disabled) nextIndex += direction;
             if (!items[nextIndex]) return;
             onSelect?.(nextIndex);
-            const rows = event.currentTarget.parentElement?.querySelectorAll<HTMLElement>('[role="option"]');
-            rows?.[nextIndex]?.focus();
+            const row = event.currentTarget.parentElement?.querySelector<HTMLElement>(`[data-gloom-list-index="${nextIndex}"]`);
+            row?.focus();
           }}
           style={listRowStyle(selected, disabled, colors, selection === "frame")}
         >