gloomberb 0.16.4 → 0.16.5

package/src/plugins/builtin/equity-screener/pane.tsx

@@ -45,6 +45,7 @@ import {
 } from "../../../api-client/equity-screener";
 import type { PaneProps } from "../../../types/plugin";
 import { formatPercentileRank } from "../../../utils/format";
+import { useOpenDescription } from "../shared/open-description";
 import { useResearchCloudSession } from "../shared/research-cloud-session";
 import { INITIAL_STREAM_RANGE, streamWindowRows } from "../shared/use-quote-board";
 import { usePlanAccess } from "../../../api-client/plan-access";
@@ -205,7 +206,8 @@ function EquityScreenView({
   const colors = useThemeColors(),
     dialog = useDialog(),
     host = useRendererHost();
-  const { notify, createPaneFromTemplate } = usePluginAppActions();
+  const { notify } = usePluginAppActions();
+  const openDescription = useOpenDescription();
   const session = useResearchCloudSession(),
     access = usePlanAccess();
   const [definition, setDefinition] = usePluginPaneState("definition", initial);
@@ -314,16 +316,7 @@ function EquityScreenView({
     setActionError(null);
   };
   const research = () => {
-    if (selected)
-      createPaneFromTemplate("new-ticker-detail-pane", {
-        symbol: selected.symbol,
-        listing: {
-          name: selected.name ?? selected.symbol,
-          exchange: selected.exchange,
-          currency: selected.currency ?? "",
-          type: "STK",
-        },
-      });
+    if (selected) openDescription(selected.symbol, selected.exchange);
   };
   const startSave = () => {
     if (!access.emailVerified) { switchMode("saved"); return; }

package/src/plugins/builtin/exposure/holdings.ts

@@ -4,7 +4,7 @@ import type { Portfolio, TickerRecord } from "../../../types/ticker";
 import { publicTickerKey } from "../../../utils/exchanges";
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
 import { convertCurrency } from "../../../utils/format";
-import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue } from "../portfolio-list/position-metrics";
+import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue } from "../../../portfolio/position-metrics";
 
 /** Explicit NAV preserves cash, shorts and leverage; net holdings are never used as NAV. */
 export async function portfolioHoldings(portfolio: Portfolio, tickers: TickerRecord[], nav: number, market: Pick<DataProvider, "getQuote" | "getExchangeRate">): Promise<ExposureHolding[]> {

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

@@ -10,6 +10,7 @@ import type { PaneProps } from "../../../types/plugin";
 import { Box, ScrollBox, Text, useRendererHost, useUiCapabilities } from "../../../ui";
 import { SignInWall } from "../cloud/auth-actions";
 import { CLOUD_PLAN_KEY, useCloudUpgradeAction } from "../shared/cloud-upgrade";
+import { useOpenDescription } from "../shared/open-description";
 import { Blurred, LockedOverlay, UpgradeLabel } from "../shared/locked-rows";
 import { humanLabel, listingCell, missingCell } from "../shared/research-cells";
 import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
@@ -79,6 +80,7 @@ export function ExposurePane({ width, height, focused }: PaneProps) {
   const accessKey = `${session.requestKey}:${access.hasProAccess ? "full" : "preview"}`;
   const upgrade = useCloudUpgradeAction("expo");
   const { createPaneFromTemplate } = usePluginAppActions();
+  const openDescription = useOpenDescription();
   const [openingScenario] = usePaneSettingValue("scenario", "taiwan-disruption");
   const [customSetting] = usePaneSettingValue("customScenario", "");
   const [openingDepth] = usePaneSettingValue("depth", 2);
@@ -150,7 +152,7 @@ export function ExposurePane({ width, height, focused }: PaneProps) {
     ...(symbol ? [
       ...(activeRow?.driver ? [{ id: "dataset", key: "a", label: "ll disclosures", title: "Open company disclosures", onPress: () => createPaneFromTemplate(activeRow.driver!.kind === "kpi" ? "company-kpis-pane" : activeRow.driver!.kind === "guidance" ? "company-guidance-pane" : "credit-documents-pane", { symbol }) }] : []),
       { id: "supply", key: "c", label: "hain", title: "Supply chain", onPress: () => createPaneFromTemplate("supply-chain-pane", { symbol }) },
-      { id: "des", key: "d", label: "es", onPress: () => createPaneFromTemplate("new-ticker-detail-pane", { symbol }) },
+      { id: "des", key: "d", label: "es", onPress: () => openDescription(symbol) },
       { id: "fa", key: "f", label: "a", onPress: () => createPaneFromTemplate("financial-analysis-pane", { symbol }) },
       { id: "chart", key: "g", label: "raph", onPress: () => createPaneFromTemplate("chart-composer-pane", { arg: symbol }) },
     ] : []),

package/src/plugins/builtin/fear-greed/index.tsx

@@ -7,6 +7,7 @@ import {
 } from "./cache";
 import { FearGreedPane } from "./pane";
 import { fearGreedHeadless } from "./headless";
+import { FEAR_GREED_SERIES } from "./series";
 
 export const fearGreedPlugin: GloomPlugin = {
   id: "fear-greed",
@@ -29,6 +30,9 @@ export const fearGreedPlugin: GloomPlugin = {
     resetFearGreedPersistence();
   },
 
+  // The index and its seven readings, chartable against anything else.
+  series: FEAR_GREED_SERIES,
+
   panes: [
     {
       id: "fear-greed",

package/src/plugins/builtin/fear-greed/series.ts

@@ -0,0 +1,52 @@
+import type { SeriesDefinition, SeriesLoadResult, SeriesPoint } from "../../../series/types";
+import { cachedSeriesWarning } from "../shared/series-warning";
+import { loadFearGreed } from "./cache";
+import type { FearGreedData } from "./data";
+
+/** The index refreshes through the session; the pane's cache keeps a copy for five minutes. */
+const REFRESH_MS = 5 * 60_000;
+
+type Reading = (data: FearGreedData) => SeriesPoint[];
+
+function component(id: string, pick: "primary" | "secondary"): Reading {
+  return (data) => {
+    const indicator = data.indicators.find((entry) => entry.definition.id === id);
+    if (!indicator) throw new Error("This component is missing from the latest reading.");
+    if (pick === "primary") return indicator.points.map((point) => ({ date: point.date, value: point.close }));
+    return indicator.secondaryPoints.flatMap((point) => {
+      const date = indicator.points[point.index]?.date;
+      return date ? [{ date, value: point.value }] : [];
+    });
+  };
+}
+
+function series(id: string, name: string, unit: string, read: Reading, tags: readonly string[]): SeriesDefinition {
+  return {
+    id: `fear-greed:${id}`,
+    name,
+    unit,
+    frequency: "daily",
+    group: "Sentiment",
+    tags: ["fear and greed", ...tags],
+    refreshMs: REFRESH_MS,
+    load: async (): Promise<SeriesLoadResult> => {
+      const result = await loadFearGreed();
+      const warning = cachedSeriesWarning(result);
+      return { points: read(result.data), ...(warning ? { warning } : {}) };
+    },
+  };
+}
+
+/** The index and the seven readings it is built from, as the pane charts them. */
+export const FEAR_GREED_SERIES: readonly SeriesDefinition[] = [
+  series("index", "Fear & Greed index", "score", (data) => data.overall.history.map((point) => ({ date: point.date, value: point.close })), ["sentiment"]),
+  series("market-momentum", "Fear & Greed: S&P 500 momentum", "index", component("market-momentum", "primary"), ["momentum", "S&P 500"]),
+  series("market-momentum-average", "Fear & Greed: S&P 500 125-day average", "index", component("market-momentum", "secondary"), ["momentum", "moving average"]),
+  series("stock-price-strength", "Fear & Greed: net new 52-week highs", "%", component("stock-price-strength", "primary"), ["breadth", "highs and lows"]),
+  series("stock-price-breadth", "Fear & Greed: McClellan volume summation", "index", component("stock-price-breadth", "primary"), ["breadth", "McClellan"]),
+  series("put-call-options", "Fear & Greed: 5-day put/call ratio", "ratio", component("put-call-options", "primary"), ["options", "put call"]),
+  series("market-volatility", "Fear & Greed: VIX", "index", component("market-volatility", "primary"), ["volatility", "VIX"]),
+  series("market-volatility-average", "Fear & Greed: VIX 50-day average", "index", component("market-volatility", "secondary"), ["volatility", "moving average"]),
+  series("safe-haven-demand", "Fear & Greed: stocks minus bonds, 20-day return", "%", component("safe-haven-demand", "primary"), ["safe haven", "bonds"]),
+  series("junk-bond-demand", "Fear & Greed: junk bond spread", "%", component("junk-bond-demand", "primary"), ["credit", "high yield", "junk"]),
+];

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

@@ -13,6 +13,7 @@ import {
   type PaneFooterSegment,
 } from "../../../components";
 import { handleRefreshKey } from "../../../components/data-table/table-pane";
+import { useRemoteUiNode } from "../../../remote/semantic-tree";
 import { usePaneVisible } from "../../../state/app/activity";
 import { usePaneInstance } from "../../../state/app/context";
 import { TICKER_RESEARCH_PANE_ID } from "../../../types/config";
@@ -22,7 +23,9 @@ import { isPlainArrowUp, stopSearchFocusNavigation } from "../../../utils/search
 import { cycleSortPreference, nextHeaderSort } from "../../../utils/sort-values";
 import { useAssetData, usePluginTickerActions } from "../../runtime";
 import type { PluginModule } from "../plugin-module";
+import { FUTURES_SERIES } from "./series";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
+import { quoteObservation } from "../shared/report-freshness";
 import {
   boardErrorMessage,
   quoteBoardFooterInfo,
@@ -34,9 +37,10 @@ import {
 import {
   FUTURES_CONTRACTS,
   FUTURES_SECTOR_LABELS,
+  futuresBoardContract,
   getContractsBySector,
   type FuturesSector,
-} from "./contracts";
+} from "../../../market-data/futures-board";
 import {
   buildFuturesRows,
   DEFAULT_FUTURES_SORT,
@@ -75,7 +79,8 @@ function FuturesPane({ focused, width, height }: PaneProps) {
   const liveStreaming = useLiveStreamingSetting();
   const [selectedId, setSelectedId] = useState<string | null>(null);
   const [sortPreference, setSortPreference] = useState<FuturesSortPreference>(DEFAULT_FUTURES_SORT);
-  const [searchQuery, setSearchQuery] = useState("");
+  // `FUT TTF` opens the board searched for the contract it names.
+  const [searchQuery, setSearchQuery] = useState(() => paneInstance?.params?.query ?? "");
   const { active: searchFocused, focus: focusSearch, searchProps } = useQueryBarSearch();
   const [collapsedSectors, setCollapsedSectors] = useState<ReadonlySet<FuturesSector>>(new Set());
   const [visibleRange, setVisibleRange] = useState<DataTableVisibleRange | null>(null);
@@ -196,6 +201,17 @@ function FuturesPane({ focused, width, height }: PaneProps) {
     return handlePaneKey(event);
   }, [focusSearch, handlePaneKey]);
 
+  // `fn FUT` and `shot FUT` are dated by the quotes the board shows, as `quote` dates them:
+  // the newest, its delay, and whether the markets are open.
+  useRemoteUiNode(quotes.size > 0 ? {
+    role: "report-freshness",
+    label: "Quote freshness",
+    getMetadata: () => {
+      const now = Date.now();
+      return { observations: [...quotes.values()].flatMap((state) => (state.quote ? [quoteObservation(state.quote, now)] : [])) };
+    },
+  } : null);
+
   const status = quoteBoardStatus(quotes);
   const errorMessage = boardErrorMessage(quotes);
   // Every load came back empty: a board of dashes reads as broken, so the
@@ -265,6 +281,7 @@ function FuturesPane({ focused, width, height }: PaneProps) {
       renderSectionHeader={renderSectorHeader}
       renderCell={renderCell}
       selectedTextOverridesCellColor
+      reportEveryRow
       emptyStateTitle={searchQuery.trim()
         ? "No matching contracts."
         : "No market data provider connected."}
@@ -288,6 +305,7 @@ function FuturesPane({ focused, width, height }: PaneProps) {
 }
 
 export const futuresModule: PluginModule = {
+  series: FUTURES_SERIES,
   panes: [
     {
       id: FUTURES_PANE_ID,
@@ -298,6 +316,7 @@ export const futuresModule: PluginModule = {
       defaultMode: "floating",
       defaultFloatingSize: { width: 76, height: 34 },
       tableExport: true,
+      shotFitsRows: true,
       // Resolved per open so the dialog shows the full default set until the
       // user saves a narrower selection.
       settings: (context) => ({
@@ -341,11 +360,32 @@ export const futuresModule: PluginModule = {
         "lumber",
         "aluminum",
         "ttf",
+        "energy",
+        "natural gas",
+        "gas",
+        "lng",
+        "brent",
+        "wti",
+        "heating oil",
+        "gasoline",
         "treasuries",
         "contracts",
         "cme",
       ],
-      shortcut: { prefix: "FUT", aliases: ["GLCO"] },
+      shortcut: {
+        prefix: "FUT",
+        aliases: ["GLCO"],
+        argKind: "text",
+        argPlaceholder: "code or name",
+        argOptional: true,
+      },
+      // A board code or symbol searches for that contract alone (NG=F: a bare NG also matches Orange Juice); other text searches as typed.
+      createInstance: (_context, options) => {
+        const input = options?.arg?.trim();
+        if (!input) return {};
+        const query = futuresBoardContract(input)?.symbol ?? input;
+        return { title: `FUT ${input.toUpperCase()}`, params: { query } };
+      },
     },
   ],
 };

package/src/plugins/builtin/futures/model.ts

@@ -1,7 +1,7 @@
 import type { Quote } from "../../../types/financials";
 import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
 import type { BoardQuoteMap } from "../shared/use-quote-board";
-import { FUTURES_SECTOR_ORDER, type FuturesContract, type FuturesSector } from "./contracts";
+import { FUTURES_SECTOR_ORDER, type FuturesContract, type FuturesSector } from "../../../market-data/futures-board";
 import type { FuturesReturnHorizon } from "./returns";
 import type { FrontReturnsMap } from "./use-front-returns";
 

package/src/plugins/builtin/futures/returns.ts

@@ -1,6 +1,6 @@
 import type { PricePoint, Quote } from "../../../types/financials";
 import { calendarMonthsBefore } from "../../../utils/calendar-date";
-import type { FuturesContract } from "./contracts";
+import type { FuturesContract } from "../../../market-data/futures-board";
 import { quotedContractMonth } from "./model";
 
 export type FuturesReturnHorizon = "1W" | "1M" | "YTD";

package/src/plugins/builtin/futures/series.ts

@@ -0,0 +1,13 @@
+import type { SeriesDefinition } from "../../../series/types";
+import { FUTURES_CONTRACTS, FUTURES_SECTOR_LABELS } from "../../../market-data/futures-board";
+
+/** Each continuous front-month contract on the futures board, as `FUT:ES`. */
+export const FUTURES_SERIES: readonly SeriesDefinition[] = FUTURES_CONTRACTS.map((contract) => ({
+  id: `fut:${contract.code}`,
+  name: contract.name,
+  unit: "USD",
+  frequency: "daily",
+  group: "Futures",
+  tags: [contract.code, FUTURES_SECTOR_LABELS[contract.sector], "futures", "front month"],
+  expression: `FUT:${contract.code}`,
+}));

package/src/plugins/builtin/futures/table.tsx

@@ -4,7 +4,7 @@ import type { Quote } from "../../../types/financials";
 import { TextAttributes } from "../../../ui";
 import { formatCompact, formatNumber, formatPercentRaw } from "../../../utils/format";
 import { isBoardRowLoading, renderQuoteBoardCell, type BoardQuoteMap } from "../shared/use-quote-board";
-import { tickDecimals, type FuturesContract } from "./contracts";
+import { tickDecimals, type FuturesContract } from "../../../market-data/futures-board";
 import { FUTURES_RETURN_COLUMNS, futuresContractName, type FuturesColumnId, type FuturesTableRow } from "./model";
 import type { FrontReturnsMap } from "./use-front-returns";
 

package/src/plugins/builtin/futures/use-front-returns.ts

@@ -2,7 +2,7 @@ import { useEffect, useMemo, useState } from "react";
 import type { DataProvider } from "../../../types/data-provider";
 import type { PricePoint } from "../../../types/financials";
 import type { BoardQuoteMap } from "../shared/use-quote-board";
-import type { FuturesContract } from "./contracts";
+import type { FuturesContract } from "../../../market-data/futures-board";
 import {
   frontContractCandidates,
   frontContractReturns,

package/src/plugins/builtin/futures-curve/client.ts

@@ -1,6 +1,7 @@
 import { apiClient } from "../../../api-client";
 import type { FuturesCurvePayload } from "../../../api-client/futures-curve";
 import { createPluginCache } from "../../../data/plugin-cache";
+import { isFuturesContractSpec } from "../../../market-data/futures-contract";
 import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
 import type { DataProvider } from "../../../types/data-provider";
 import { archivedFuturesCurve, curveLookbackDate, curveSpot, normalizeCurveRoot, unsupportedCurveRootMessage, type CurveSpot } from "./model";
@@ -13,13 +14,17 @@ const finiteOrNull = (value: unknown) => value === null || typeof value === "num
 const timestamp = (value: unknown) => typeof value === "string" && Number.isFinite(Date.parse(value));
 const date = (value: unknown) => timestamp(value) && new Date(value as string).toISOString().slice(0, 10) === value;
 const rank = (value: unknown) => value === null || typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 100;
+const optionalDate = (value: unknown) => value === undefined || value === null || date(value);
+/** Contract terms the pane computes with; a curve from before the server sent them has none. */
+const validSpec = (spec: unknown) => spec === undefined || spec === null || isFuturesContractSpec(spec);
 
 export function validateFuturesCurve(data: FuturesCurvePayload, root: string): FuturesCurvePayload {
   if (!data || data.root !== root || !Array.isArray(data.contracts) || !Array.isArray(data.ghosts)
     || !Array.isArray(data.gaps) || !data.gaps.every((gap) => typeof gap === "string")
     || !data.catalogue || !data.slope || !timestamp(data.fetchedAt)
     || data.asOf !== null && !timestamp(data.asOf)
-    || !["gloom", "cboe"].includes(data.source) || !["available", "partial", "unavailable"].includes(data.status)) {
+    || !["gloom", "cboe"].includes(data.source) || !["available", "partial", "unavailable"].includes(data.status)
+    || !optionalDate(data.settlementDate) || !validSpec(data.spec)) {
     throw new Error("The server returned an invalid futures curve");
   }
   const symbols = new Set<string>();
@@ -30,7 +35,9 @@ export function validateFuturesCurve(data: FuturesCurvePayload, root: string): F
       || typeof row.currency !== "string"
       || !rank(row.percentile) || !Number.isInteger(row.samples) || row.samples < 0
       || row.asOf !== null && !timestamp(row.asOf)
-      || ![row.volume, row.openInterest, row.delayMinutes].every((value) => finiteOrNull(value) && (value === null || value >= 0))) {
+      || ![row.volume, row.openInterest, row.delayMinutes].every((value) => finiteOrNull(value) && (value === null || value >= 0))
+      || row.settlement !== undefined && !finiteOrNull(row.settlement) || !optionalDate(row.lastTrade) || !optionalDate(row.firstNotice)
+      || row.inDelivery !== undefined && typeof row.inDelivery !== "boolean") {
       throw new Error("The server returned an invalid futures contract");
     }
     symbols.add(row.symbol);
@@ -80,7 +87,9 @@ export async function loadFuturesCurveAsOf(root: string, date: string,
       client.getCloudFuturesCurveAsOf(normalized, curveLookbackDate(date, 30)).catch(() => null),
     ]);
     if (!curve || curve.root !== normalized || !Array.isArray(curve.contracts) || !Array.isArray(curve.gaps)
-      || curve.contracts.some((row) => !row || typeof row.symbol !== "string" || !Number.isFinite(row.price))) {
+      || curve.contracts.some((row) => !row || typeof row.symbol !== "string" || !Number.isFinite(row.price)
+        || row.settled !== undefined && typeof row.settled !== "boolean" || !optionalDate(row.firstNotice) || !optionalDate(row.lastTrade))
+      || !validSpec(curve.spec)) {
       throw new Error("The server returned an invalid past futures curve");
     }
     return archivedFuturesCurve(normalized, curve, { "1W": week, "1M": month }, new Date().toISOString());

package/src/plugins/builtin/futures-curve/headless.ts

@@ -1,7 +1,9 @@
-import type { HeadlessPaneDefinition, HeadlessPaneFreshness } from "../../../types/plugin";
+import type { FuturesContract, FuturesCurvePayload } from "../../../api-client/futures-curve";
+import { futuresSpecLines } from "../../../market-data/futures-contract";
+import type { HeadlessPaneColumn, HeadlessPaneDefinition, HeadlessPaneEntry, HeadlessPaneFreshness } from "../../../types/plugin";
 import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
 import { fetchFuturesCurve, loadCurveSpot, loadFuturesCurveAsOf } from "./client";
-import { basisSpotSymbol, contractBasis, curveAsOfDate, curveSpotLabel, normalizeCurveRoot, thinContractCount, unsupportedCurveRootMessage } from "./model";
+import { basisSpotSymbol, catalogueCurveUnit, contractBasis, curveAsOfDate, curveBasisPercent, curveChangeText, curveContractCode, curvePrice, curveRoundedPrice, curveSpotLabel, curveSpreadLabel, curveTimestamp, curveUnitLabel, normalizeCurveRoot, thinContractCount, unsupportedCurveRootMessage, type ContractBasis } from "./model";
 
 /** The root a report shows when none is given. */
 const DEFAULT_ROOT = "ES";
@@ -12,6 +14,63 @@ const rank = (value: number | null) => value == null ? null : Math.round(value);
 /** The basis fields are read to four decimals, finer than any cell shows. */
 const basisValue = (value: number | null) => value == null ? null : Number(value.toFixed(4));
 
+/**
+ * One contract as the report reads it, the same fields in the same order for
+ * every root. Prices and changes are at the root's tick precision. `price` is
+ * the latest trade and `settlement` the exchange settlement for the curve's
+ * settlement session (a past curve's settled rows have no separate trade).
+ */
+function contractRow(row: FuturesContract, data: FuturesCurvePayload, root: string, past: boolean, basis?: ContractBasis) {
+  const price = (value: number | null | undefined) => curveRoundedPrice(value, root);
+  return {
+    symbol: row.symbol, label: row.label, expiration: row.expiration, lastTrade: row.lastTrade ?? row.expiration,
+    firstNotice: row.firstNotice ?? null, inDelivery: row.inDelivery ?? false,
+    settlement: price(row.settlement), settlementDate: row.settlement != null ? data.settlementDate ?? null : null,
+    price: past && row.settlement != null ? null : price(row.price), change: price(row.change),
+    asOf: row.asOf, stale: row.stale, volume: row.volume, openInterest: row.openInterest, percentile: rank(row.percentile),
+    samples: row.samples, historyStart: row.historyStart, historyEnd: row.historyEnd,
+    currency: row.currency, quoteUnit: curveUnitLabel(data) ?? row.quoteUnit, delayMinutes: row.delayMinutes,
+    ...(basis ? { vsSpotPct: basisValue(basis.vsSpotPct), annualisedBasisPct: basisValue(basis.annualisedBasisPct) } : {}),
+  };
+}
+
+/** The text table: what a hedge reads, in one order for every root; JSON keeps every field. */
+function contractColumns(root: string, settlementDate: string | null, options: { basis: boolean; last: boolean; notice: boolean }): HeadlessPaneColumn[] {
+  const price = (value: unknown) => typeof value === "number" ? curvePrice(value, root) : "--";
+  const date = (value: unknown) => typeof value === "string" ? value : "--";
+  return [
+    { key: "symbol", header: "Contract", shrink: false, format: (value) => curveContractCode(String(value)) },
+    { key: "lastTrade", header: "Last Trade", shrink: false, format: date },
+    // Cash-settled roots have no first notice day.
+    ...options.notice ? [{ key: "firstNotice", header: "1st Notice", shrink: false,
+      format: (value: unknown, row: Record<string, unknown>) => typeof value === "string" ? `${value}${row.inDelivery ? " passed" : ""}` : "--" }] : [],
+    { key: "settlement", header: settlementDate ? `Settle ${settlementDate}` : "Settle", align: "right", format: price },
+    // A Cboe price is the settlement itself, with no separate last trade.
+    ...options.last ? [{ key: "price", header: "Last", align: "right" as const, format: price }] : [],
+    { key: "change", header: "Change", align: "right", format: (value) => typeof value === "number" ? curveChangeText(value, root) : "--" },
+    ...options.basis ? [{ key: "vsSpotPct", header: "Vs Spot", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 2) },
+      { key: "annualisedBasisPct", header: "Ann Basis", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 1) }] : [],
+    { key: "asOf", header: "As Of UTC", shrink: false, format: (value) => typeof value === "string" ? curveTimestamp(value) : "--" },
+    { key: "openInterest", header: "Open Int", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
+    { key: "volume", header: "Volume", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
+    { key: "percentile", header: "Pctl", align: "right", format: (value) => typeof value === "number" ? String(value) : "--" },
+  ];
+}
+
+/** What one contract is: the terms a hedge is sized on, once rather than on every row, worded as `ticker` words them. */
+function specEntries(data: FuturesCurvePayload): HeadlessPaneEntry[] {
+  const spec = data.spec;
+  // A root without terms still says what its prices count: Dutch TTF gas is euros per MWh.
+  if (!spec) {
+    const unit = catalogueCurveUnit(data.root);
+    return unit ? [{ key: "unit", label: "Unit", value: unit }] : [];
+  }
+  return futuresSpecLines(spec).map((line) => {
+    const value = spec[line.key as keyof typeof spec];
+    return { key: line.key, label: line.label, value, ...line.value === String(value) ? {} : { formatted: line.value } };
+  });
+}
+
 export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
   discovery: { aliases: ["CTM"], dataRequirements: ["Gloom Cloud futures curve endpoint"],
     limitations: ["Listed-contract catalogues can be incomplete", "Ghosts and percentiles use the same listed contracts", "Cboe VIX is daily settlement"] },
@@ -35,6 +94,8 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
       spotSymbol ? loadCurveSpot(spotSymbol, ctx.marketData, now) : null,
     ]);
     const bases = spot ? data.contracts.map((row) => contractBasis(row, spot)) : [];
+    const unit = curveUnitLabel(data);
+    const terms = specEntries(data);
     const notices = [...args.argument ? [] : [`Showing ${DEFAULT_ROOT}. Try fn CTM ${EXAMPLE_ROOT}.`],
       ...spot ? [spot.status === "ok" ? `Basis against ${curveSpotLabel(spot, root, now)}.` : `Basis blank: ${spot.reason}.`] : []];
     // Dated by the contracts' own quotes; the same-contract history rows are a year of context, not observations.
@@ -46,17 +107,17 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
     return {
       freshness,
       sections: [
-        { title: "Contracts", rows: data.contracts.map((row, index) => {
-          const basis = bases[index];
-          return { ...row, percentile: rank(row.percentile),
-            ...(basis ? { vsSpotPct: basisValue(basis.vsSpotPct), annualisedBasisPct: basisValue(basis.annualisedBasisPct) } : {}) };
-        }) },
-        { title: "Front spread", rows: [{ ...data.slope, annualizedRollYield: data.slope.annualizedRollYield == null ? null : Number(data.slope.annualizedRollYield.toFixed(2)),
+        { title: "Contracts", columns: contractColumns(root, data.settlementDate ?? null,
+          { basis: !!spot, last: data.source !== "cboe", notice: data.contracts.some((row) => row.firstNotice) }),
+          rows: data.contracts.map((row, index) => contractRow(row, data, root, !!date, bases[index])) },
+        { title: "Front spread", rows: [{ label: curveSpreadLabel(data.slope), ...data.slope, value: curveRoundedPrice(data.slope.value, root),
+          annualizedRollYield: data.slope.annualizedRollYield == null ? null : Number(data.slope.annualizedRollYield.toFixed(2)),
           percentile: rank(data.slope.percentile), rollPercentile: rank(data.slope.rollPercentile) }] },
+        ...terms.length ? [{ title: "Contract terms", entries: terms }] : [],
         ...data.ghosts.map((ghost) => ({ title: `${ghost.label} same-contract history`, rows: ghost.points.map((point) => ({ ...point })) })),
       ],
       errors: data.gaps,
-      metadata: { ...data, ...(spot ? { spot, basisBlankedThin: thinContractCount(bases) } : {}), ...(args.argument ? {} : { defaultArgument: DEFAULT_ROOT }),
+      metadata: { ...data, quoteUnit: unit, ...(spot ? { spot, basisBlankedThin: thinContractCount(bases) } : {}), ...(args.argument ? {} : { defaultArgument: DEFAULT_ROOT }),
         ...(notices.length ? { notices } : {}),
         complete: data.status === "available", percentileBasis: "Same-contract observations within one year; actual sample start/end retained" },
     };

package/src/plugins/builtin/futures-curve/index.tsx

@@ -18,7 +18,7 @@ export const futuresCurveModule: PluginModule = {
   }],
   paneTemplates: [{ id: "futures-curve-pane", paneId: "futures-curve", label: "Futures Curve",
     description: "Listed futures contracts, historical curves, roll yield and open interest including VIX and CME crypto futures.",
-    keywords: ["ctm", "futures", "curve", "contango", "backwardation", "roll", "vix"],
+    keywords: ["ctm", "futures", "curve", "contango", "backwardation", "roll", "vix", "crude oil", "natural gas"],
     shortcut: { prefix: "CTM", aliases: ["CT"], argKind: "text", argPlaceholder: "root", argOptional: true,
       argOptions: () => CURVE_ROOTS },
     headless: futuresCurveHeadless,