gloomberb 0.18.1 → 0.18.3

package/src/plugins/builtin/options/view.tsx

@@ -1,11 +1,12 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Text, useUiCapabilities } from "../../../ui";
-import { usePaneSettingValue, usePaneTicker, useUpdatePaneSettings } from "../../../state/app/context";
+import { usePaneAppConfig, usePaneSettingValue, usePaneTicker, useUpdatePaneSettings } from "../../../state/app/context";
 import { colors, priceColor } from "../../../theme/colors";
 import { isPlainKey } from "../../../utils/keyboard";
 import { formatCompact, formatPercentRaw } from "../../../utils/format";
 import { formatMarketPrice, formatSignedMarketPrice, liveQuoteFormatOptions } from "../../../market-data/market/format";
-import { formatExpDate, resolveOptionsTarget } from "../../../utils/options";
+import { getRegularSessionDisplay } from "../../../market-data/market/status";
+import { chainOptionContract, formatExpDate, optionContractName, resolveOptionsTarget } from "../../../utils/options";
 import {
   expiryIsoDate, findListedExpiry, formatDaysToExpiry, daysToExpiry, missingExpiryMessage, missingExpiryText, readOptionExpiration,
 } from "../../../utils/option-expiry";
@@ -34,7 +35,9 @@ import { useLiveQuoteEntries, useQuoteUpdates } from "../../../state/hooks/quote
 import { buildChartKey } from "../../../market-data/selectors";
 import type { ChartRequest } from "../../../market-data/request-types";
 import { quoteSubscriptionTargetFromTicker } from "../../../market-data/request-types";
-import { usePluginAppActions } from "../../runtime";
+import { usePluginAppActions, usePluginBrokerActions, usePluginTickerActions } from "../../runtime";
+import { brokerCanTrade, openTradeTicket } from "../broker-trading/command";
+import type { OptionContract } from "../../../types/financials";
 import { OPTIONS_CALCULATOR_TEMPLATE_ID } from "../options-calculator/model";
 import { buildChainCalcParams, resolveCalcSide } from "./calc-seed";
 import { useOptionsCatalogue } from "./expiry-catalogue";
@@ -66,7 +69,7 @@ import { signedPositionDirection } from "../../../portfolio/position-metrics";
 import { optionMarketReference } from "./market-reference";
 import { useOptionsEnrichment } from "./enrichment";
 import type { OptionsEnrichmentSnapshot } from "./enrichment-model";
-import { optionMid, type OptionSide } from "../shared/volatility";
+import { daysToExpiryFrom, optionMid, type OptionSide } from "../shared/volatility";
 import type { TickerRecord } from "../../../types/ticker";
 import type { TickerFinancials } from "../../../types/financials";
 import type { IvStats } from "../iv-history/client";
@@ -74,7 +77,10 @@ import { useIvRank } from "../iv-history/rank";
 import { useOptionsSessionOpen, useThrottledValue } from "../shared/volatility/live-session";
 import { useRemoteUiNode } from "../../../remote/semantic-tree";
 import { optionCarry, optionCostOfSpot } from "./carry";
-import { formatModelSpotPrice, modelSpotLabel, optionModelSpot } from "./model-spot";
+import {
+  formatModelSpotPrice, modelSpotExtendedPrint, modelSpotLabel, modelSpotStamp, modelSpotStampVariants, optionModelSpot,
+  type OptionModelSpot,
+} from "./model-spot";
 import { chainOpenInterestAsOf, loadListedOpenInterest, openInterestAsOfLabel, statedOpenInterestAsOf } from "./open-interest-as-of";
 import { useAsyncResource } from "../../../react/async-resource";
 import {
@@ -111,13 +117,35 @@ function transientTicker(symbol: string, exchange: string, currency: string): Ti
 }
 
 /**
- * The underlying's price and day change: the level every strike is read
- * against. A stale quote stays on screen, muted, while the footer says why.
+ * The underlying's price: the level every strike is read against. A chain
+ * priced at a session's close or an extended-session print shows that spot
+ * with its stamp (`modelSpotStamp`), and any extended print after it named by
+ * its session; the regular session's live price shows its day change. A stale
+ * quote stays on screen, muted, while the footer says why.
  */
-function spotItem(underlying: TickerFinancials | null | undefined, assetCategory: string | undefined): StatItem {
+function spotItem(
+  underlying: TickerFinancials | null | undefined,
+  assetCategory: string | undefined,
+  modelSpot: OptionModelSpot | null,
+): StatItem {
   const quote = underlying?.quote;
   if (!quote || !Number.isFinite(quote.price)) return { id: "spot", label: "Spot", value: "--" };
   const options = liveQuoteFormatOptions(quote, quote.currency, assetCategory, underlying?.quoteMetadata?.instrumentType);
+  const stamp = modelSpot ? modelSpotStamp(modelSpot) : null;
+  if (modelSpot && stamp) {
+    const move = modelSpot.basis === "close" ? getRegularSessionDisplay(quote)?.change : quote.change;
+    const extended = modelSpotExtendedPrint(quote, modelSpot, (price) => formatMarketPrice(price, options));
+    // The band keeps its columns: the extended print, then the stamp's day, give way first.
+    const shorter = modelSpotStampVariants(modelSpot);
+    return {
+      id: "spot",
+      label: "Spot",
+      value: formatMarketPrice(modelSpot.price, options),
+      detail: extended ? `${stamp} · ${extended}` : stamp,
+      detailVariants: extended ? [stamp, ...shorter] : shorter,
+      color: quote.stale ? colors.textDim : priceColor(Number.isFinite(move) ? move! : 0),
+    };
+  }
   const change = Number.isFinite(quote.change) ? quote.change : 0;
   return {
     id: "spot",
@@ -176,6 +204,9 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   const ticker = useMemo(() => savedTicker ?? (boundSymbol ? transientTicker(boundSymbol, fallbackExchange, fallbackCurrency) : null),
     [savedTicker, boundSymbol, fallbackExchange, fallbackCurrency]);
   const { createPaneFromTemplate } = usePluginAppActions();
+  const { pinTicker } = usePluginTickerActions();
+  const { getBrokerAdapter } = usePluginBrokerActions();
+  const appConfig = usePaneAppConfig();
   const liveStreaming = useLiveStreamingSetting();
   // A number from the app, or the date or seconds `fn OMON --expiration` took as text.
   const [seededSetting] = usePaneSettingValue<unknown>("expiration", undefined);
@@ -238,13 +269,20 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   const strikeWindowText = strikeWindowValue(strikeWindow);
   const initialChainEntry = useOptionsQuery(baseRequest);
   const initialChain = useResolvedEntryValue(initialChainEntry);
-  const initialExpiration = initialChain?.expirationDates.reduce((best, expiration) => (
+  // A listing can still carry a date whose 16:00 ET close has passed. The chain
+  // never opens there, nor on a saved date that has since passed: it takes the nearest live one.
+  const now = Date.now();
+  const liveExpiration = (expiration: number) => daysToExpiryFrom(expiration, now) > 0;
+  const listedExpirations = initialChain?.expirationDates ?? [];
+  const openingExpirations = listedExpirations.some(liveExpiration) ? listedExpirations.filter(liveExpiration) : listedExpirations;
+  const initialExpiration = openingExpirations.length === 0 ? undefined : openingExpirations.reduce((best, expiration) => (
     parsed && Math.abs(expiration - parsed.expTs) < Math.abs(best - parsed.expTs) ? expiration : best
-  ), initialChain.expirationDates[0]!);
+  ), openingExpirations[0]!);
   // A typed date names a day; the catalogue's stamp for that day is the expiry.
   const seededDate = readOptionExpiration(seededSetting);
-  const seededExpiration = seededDate == null ? undefined
-    : findListedExpiry(seededDate, initialChain?.expirationDates ?? []) ?? seededDate;
+  const seededListed = seededDate == null ? undefined : findListedExpiry(seededDate, listedExpirations) ?? seededDate;
+  const seededExpiration = seededListed != null && (liveExpiration(seededListed) || !openingExpirations.some(liveExpiration))
+    ? seededListed : undefined;
   const selectedExpiration = expirationTargetKey == null || expirationTargetKey === selectionTargetKey
     ? seededExpiration ?? initialExpiration : initialExpiration;
   const viewportKey = `${effectiveTicker}:${selectedExpiration ?? "initial"}`;
@@ -281,8 +319,11 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
     ?? (matchesSelectedExpiration(initialChain) ? initialChain : null);
   const strikesLoading = strikeChain === null && !expirationUnavailable;
   const expirationDates = useMemo(() => {
-    return selectedExpirationMissing
+    const listed = selectedExpirationMissing
       ? [...availableExpirations, selectedExpiration!].sort((left, right) => left - right) : availableExpirations;
+    // A date that has ended has no contracts left to show; the strip leaves it out, unless every date has.
+    const current = (expiration: number) => daysToExpiry(expiration, Date.now()) >= 0;
+    return listed.some(current) ? listed.filter((expiration) => expiration === selectedExpiration || current(expiration)) : listed;
   }, [availableExpirations, selectedExpiration, selectedExpirationMissing]);
   // Keep the date strip stable while a mouse press focuses this pane. A new
   // tab list asks the web host to reveal the active tab and can move the date
@@ -468,13 +509,17 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
         : { key: viewportKey, range }
     ));
   }, [viewportKey]);
+  // A chain read from a broker profile has its contracts quoted by that profile too.
+  const quoteBrokerId = instrument?.brokerId, quoteBrokerInstanceId = instrument?.brokerInstanceId;
+  const optionQuoteBroker = useMemo(() => quoteBrokerId || quoteBrokerInstanceId
+    ? { brokerId: quoteBrokerId, brokerInstanceId: quoteBrokerInstanceId } : undefined, [quoteBrokerId, quoteBrokerInstanceId]);
   const optionQuoteTargets = useMemo(
     () => buildOptionQuoteTargets(quoteRows, {
       fallbackHeight: height,
       selectedIndex: selectedStrikeIdx,
       visibleRange: visibleStrikeRange,
-    }),
-    [height, quoteRows, selectedStrikeIdx, visibleStrikeRange],
+    }, optionQuoteBroker),
+    [height, quoteRows, selectedStrikeIdx, visibleStrikeRange, optionQuoteBroker],
   );
   const {
     entries: optionQuoteEntries,
@@ -497,8 +542,8 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   // The snapshot object itself comes back while nothing streamed, so the
   // memos below only recompute when a quote actually landed.
   const liveChain = useMemo(
-    () => strikeChain ? overlayOptionChainQuotes(strikeChain, optionQuoteEntries, optionQuoteFreshness).chain : null,
-    [optionQuoteEntries, optionQuoteFreshness, strikeChain],
+    () => strikeChain ? overlayOptionChainQuotes(strikeChain, optionQuoteEntries, optionQuoteFreshness, optionQuoteBroker).chain : null,
+    [optionQuoteEntries, optionQuoteFreshness, strikeChain, optionQuoteBroker],
   );
   const callsByStrike = useMemo(
     () => new Map(liveChain?.calls.map((c) => [c.strike, c]) ?? []),
@@ -533,10 +578,10 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
       putGreeks: volatilities ? calculateOptionGreeks(put, "put", greeksSpot, dividendYield, volatilities) : undefined,
       callExtrinsicPerYear: call && volatilities ? optionCarry(call, "call", greeksSpot, volatilities.valuationTime)?.extrinsicPerYear ?? null : null,
       putExtrinsicPerYear: put && volatilities ? optionCarry(put, "put", greeksSpot, volatilities.valuationTime)?.extrinsicPerYear ?? null : null,
-      putCostOfSpot: put ? optionCostOfSpot(put, spot) : null,
+      putCostOfSpot: put ? optionCostOfSpot(put, greeksSpot) : null,
       isPositionStrike: !!parsed && strike === parsed.strike,
     };
-  }), [callsByStrike, dividendYield, greeksSpot, parsed, putsByStrike, spot, strikes, volatilities]);
+  }), [callsByStrike, dividendYield, greeksSpot, parsed, putsByStrike, strikes, volatilities]);
   // The open interest's session: the chain's own, or for a chain that does not say, OPX's listing of the
   // same expiry, stated only when the counts are OPX's.
   const statedOpenInterest = useMemo(() => strikeChain ? statedOpenInterestAsOf(strikeChain) : undefined, [strikeChain]);
@@ -565,10 +610,12 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   } : null);
   // What IV and the Greeks are valued at, and the open interest's date. In a
   // crowded footer it shortens, then gives way to the contract under the cursor.
-  const basisText = [modelSpot ? `spot ${formatModelSpotPrice(modelSpot.price)} ${modelSpotLabel(modelSpot)}` : null,
+  // A stamped spot (a close, an extended print) is already the Spot figure's.
+  const footerSpot = modelSpot && !modelSpotStamp(modelSpot) ? modelSpot : null;
+  const basisText = [footerSpot ? `spot ${formatModelSpotPrice(footerSpot.price)} ${modelSpotLabel(footerSpot)}` : null,
     strikeChain && !listedOpenInterest.loading ? openInterestAsOfLabel(openInterestAsOf) : null].filter(Boolean).join(" · ");
-  const shortBasisText = [modelSpot ? `${formatModelSpotPrice(modelSpot.price)} ${modelSpot.basis === "close" ? "close" : modelSpot.session ?? "last"} `
-    + `${new Date(modelSpot.observedAt).toISOString().slice(11, 16)} UTC` : null,
+  const shortBasisText = [footerSpot ? `${formatModelSpotPrice(footerSpot.price)} last `
+    + `${new Date(footerSpot.observedAt).toISOString().slice(11, 16)} UTC` : null,
   strikeChain && !listedOpenInterest.loading ? openInterestAsOf?.date ? `OI ${openInterestAsOf.date.slice(5)}` : "OI undated" : null]
     .filter(Boolean).join(" · ");
   usePaneFooter("options-basis", () => ({ info: basisText ? [{ id: "greeks-basis",
@@ -578,9 +625,9 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   // busy stream reads as a steady strip rather than flicker.
   // A new expiry, a refreshed snapshot or the underlying price arriving or
   // going stale shows at once; only the stream itself is paced.
-  const summaryResetKey = useMemo(() => ({}), [strikeSelectionKey, strikeChain, spot == null]);
+  const summaryResetKey = useMemo(() => ({}), [strikeSelectionKey, strikeChain, greeksSpot == null]);
   const summaryInput = useThrottledValue(
-    useMemo(() => ({ chain: liveChain, spot, volatilities }), [liveChain, spot, volatilities]),
+    useMemo(() => ({ chain: liveChain, spot: greeksSpot, volatilities }), [liveChain, greeksSpot, volatilities]),
     OPTIONS_SUMMARY_THROTTLE_MS,
     summaryResetKey,
   );
@@ -594,7 +641,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
     instrument: baseRequest?.instrument ?? null, expiration: selectedExpiration,
     selectedEntry: strikeChain === expirationChain ? expirationChainEntry
       : strikeChain === initialChain ? initialChainEntry : null,
-    catalogue: availableExpirations, spot, spotAsOf: underlying?.quote?.lastUpdated,
+    catalogue: availableExpirations, spot: greeksSpot, spotAsOf: modelSpot?.observedAt,
     liveChain: liveChain !== strikeChain ? liveChain : null,
   });
   const enrichment = expirationUnavailable ? null : enrichmentState.snapshot;
@@ -672,6 +719,28 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   }, [scenarioContract, scenarioAvailable, scenarioMid, scenarioVolatility, createPaneFromTemplate, dividendYield, effectiveTicker,
     effectiveExchange, selectedSide, spot, underlying?.quote?.lastUpdated]);
 
+  // A contract opens as its own listing: quote, chart and Trade. It stays on
+  // the chain's broker while that profile is on, else it opens by its symbol.
+  const contractListing = useCallback((contract: OptionContract) => {
+    const symbol = contract.contractSymbol.trim().toUpperCase();
+    const currency = contract.currency || underlying?.quote?.currency || "USD";
+    const brokerOn = !!instrument && appConfig.brokerInstances.some((profile) => profile.id === instrument.brokerInstanceId && profile.enabled !== false);
+    return { symbol, selection: { instrument: brokerOn ? chainOptionContract(symbol, instrument, currency) : null,
+      listing: { name: optionContractName(symbol) ?? symbol, exchange: "", currency, type: "OPT" } } };
+  }, [appConfig.brokerInstances, instrument, underlying?.quote?.currency]);
+  const openContract = useCallback((contract: OptionContract | null | undefined) => {
+    if (!contract) return;
+    const { symbol, selection } = contractListing(contract);
+    pinTicker(symbol, selection);
+  }, [contractListing, pinTicker]);
+  const tradable = !!scenarioContract && brokerCanTrade(appConfig.brokerInstances, getBrokerAdapter, scenarioContract.contractSymbol.trim().toUpperCase(), "OPT");
+  const tradeContract = useCallback(() => {
+    if (!scenarioContract || !tradable) return;
+    const { symbol, selection } = contractListing(scenarioContract);
+    // A new contract's ticket starts on Buy; b and s choose the side in it.
+    openTradeTicket({ pinTicker }, symbol, { action: "BUY" }, selection);
+  }, [contractListing, pinTicker, scenarioContract, tradable]);
+
   const openSurface = useCallback(() => {
     if (!ticker || selectedExpiration == null) return;
     createPaneFromTemplate("vol-surface-pane", { symbol: ticker.metadata.ticker, ticker, instrument,
@@ -703,12 +772,14 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
     setCalcSide(sideTarget);
   }, [selectContract, selectedRow, selectedStrikeIdx, sideTarget]);
 
+  // With a broker that trades the contract, [t]rade opens its ticket on Buy, and Sell is chosen there.
   const footerHints = useMemo(() => [
     ...(sideTarget ? [{ id: "side", key: SIDE_KEY, label: ` ${sideTarget}`, title: sideTarget === "put" ? "Select Put" : "Select Call", onPress: switchSide }] : []),
+    ...(tradable ? [{ id: "trade-contract", key: "t", label: "rade", title: "Trade Contract", onPress: tradeContract }] : []),
     ...(calcParams ? [{ id: "calc", key: "c", label: "alc", onPress: openCalculator }] : []),
     ...(scenarioAvailable ? [{ id: "scenario", key: "a", label: "dd to OSA", onPress: openScenario }] : []),
     ...(ticker && selectedExpiration != null ? [{ id: "surface", key: "s", label: "urface", onPress: openSurface }] : []),
-  ], [sideTarget, switchSide, calcParams, openCalculator, scenarioAvailable, openScenario, ticker, selectedExpiration, openSurface]);
+  ], [sideTarget, switchSide, tradable, tradeContract, calcParams, openCalculator, scenarioAvailable, openScenario, ticker, selectedExpiration, openSurface]);
 
   // Back to where the chain opens: the held contract's strike, else the money.
   const defaultStrikeIndex = strikes.length === 0 ? -1 : (() => {
@@ -732,8 +803,10 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
     { id: "default-strike", label: parsed ? "Go to Held Strike" : "Go to ATM Strike",
       enabled: defaultStrikeIndex >= 0, onSelect: goToDefaultStrike },
     ...(enrichment?.asOf && dialog ? [{ id: "analytics-as-of", label: "Analytics As Of…", onSelect: showAnalyticsAsOf }] : []),
+    { id: "open-contract", label: "Open Contract", accelerator: "Enter", enabled: !!scenarioContract, onSelect: () => openContract(scenarioContract) },
+    ...(tradable ? [{ id: "trade-contract", label: "Trade Contract", accelerator: "t", onSelect: tradeContract }] : []),
   ], [defaultStrikeIndex, dialog, enrichment?.asOf, expirationDates.length, goToDefaultStrike, parsed,
-    selectAdjacentExpiration, selectedExpirationIndex, showAnalyticsAsOf]);
+    selectAdjacentExpiration, selectedExpirationIndex, showAnalyticsAsOf, scenarioContract, openContract, tradable, tradeContract]);
 
   const renderCell = useCallback((
     row: OptionTableRow,
@@ -756,6 +829,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   }, [selectContract, selectedSide]);
 
   useOptionsAccessFooter({
+    broker: !!optionQuoteBroker,
     chain,
     error: [error, underlyingStale ? "Underlying quote stale: Greeks and calculator unavailable" : null,
       selectedContract && strikeChain && !selectedContractAvailable
@@ -789,7 +863,21 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   // the arrows for it; in a research tab those stay with the tab strip.
   useShortcut((event) => {
     if (event.defaultPrevented || event.propagationStopped || event.targetEditable) return;
-    if (event.ctrl || event.meta || event.alt || event.shift) return;
+    if (event.ctrl || event.meta || event.alt) return;
+    const surface = isPlainKey(event, "s");
+    if (surface && ticker && selectedExpiration != null) {
+      event.preventDefault();
+      event.stopPropagation();
+      openSurface();
+      return;
+    }
+    if (event.shift) return;
+    if (tradable && isPlainKey(event, "t") && !event.repeat) {
+      event.preventDefault();
+      event.stopPropagation();
+      tradeContract();
+      return;
+    }
 
     const expiryStep = isPlainKey(event, EXPIRY_PREVIOUS_KEY) || (!nestedInTabs && isPlainKey(event, "h", "left")) ? -1
       : isPlainKey(event, EXPIRY_NEXT_KEY) || (!nestedInTabs && isPlainKey(event, "l", "right")) ? 1 : 0;
@@ -799,12 +887,6 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
       selectAdjacentExpiration(expiryStep);
       return;
     }
-    if (isPlainKey(event, "s") && ticker && selectedExpiration != null) {
-      event.preventDefault();
-      event.stopPropagation();
-      openSurface();
-      return;
-    }
     if (isPlainKey(event, "c") && calcParams) {
       event.preventDefault();
       event.stopPropagation();
@@ -847,7 +929,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
   // The root insets the terminal body, so the band gets the width inside it.
   const statWidth = Math.max(1, width - (nativePaneChrome ? 0 : 2));
   const figures = optionsSummaryItems({
-    spot: spotItem(underlying, isOpt ? undefined : ticker.metadata.assetCategory),
+    spot: spotItem(underlying, isOpt ? undefined : ticker.metadata.assetCategory, modelSpot),
     summary, enrichment, currency: underlying?.quote?.currency || ticker.metadata.currency || "",
     ivRank: showIvRank ? { stats: ivRank } : null,
   });
@@ -925,6 +1007,7 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
         onVisibleRangeChange={handleVisibleStrikeRangeChange}
         getItemKey={(row) => String(row.strike)}
         renderCell={renderCell}
+        onActivate={(row) => openContract(selectedSide === "put" ? row.put : selectedSide === "call" ? row.call : null)}
         selectedTextOverridesCellColor
         emptyStateTitle={unavailableExpiry ?? (error && !strikeChain ? "Selected expiration unavailable." : strikesLoading ? "Loading strikes..."
           : strikeWindowResult.total > 0 ? "No strikes in this window." : "No strikes available.")}

package/src/plugins/builtin/options-calculator/pane.tsx

@@ -1,5 +1,6 @@
+import { unavailableText } from "../../../components/ui/status";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { FieldGrid, KeyValueRow, QueryBar, usePaneFooter, usePaneNoticeFooter, type GridField } from "../../../components";
+import { delayedFooterSegment, FieldGrid, KeyValueRow, QueryBar, usePaneFooter, usePaneNoticeFooter, type GridField } from "../../../components";
 import { CompositeChart } from "../../../components/chart/composite/composite-chart";
 import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
 import { useAsyncResource, useInputCapture } from "../../../public/react";
@@ -194,7 +195,7 @@ export function OptionsCalculatorPane({ focused, width, height }: PaneProps) {
   const calculation = useMemo(() => {
     const unavailable = seedError ?? (american ? dividendInput.error : null)
       ?? (surfaceSource && !draft.symbol ? "Choose an underlying ticker for surface IV." : null)
-      ?? (surfaceSource && !surfaceResource.loading && surface?.volatility == null ? surface?.error ?? surfaceResource.error ?? "Surface IV unavailable." : null);
+      ?? (surfaceSource && !surfaceResource.loading && surface?.volatility == null ? surface?.error ?? surfaceResource.error ?? unavailableText("Surface IV") : null);
     if (unavailable || surfaceSource && surface?.volatility == null) {
       return { valuation: null, implied: { volatility: null, note: null }, problem: unavailable };
     }
@@ -279,7 +280,9 @@ export function OptionsCalculatorPane({ focused, width, height }: PaneProps) {
       ...(surfaceSource && surfaceResource.loading ? [{ id: "loading", parts: [{ text: "loading surface", tone: "muted" as const }] }] : []),
       ...(surfaceSource && surface?.asOf ? [{ id: "surface-asof", parts: [{ text: `surface · ${surface.asOf}`, tone: "muted" as const }] }] : []),
       ...(effectiveSteps && effectiveSteps !== (draft.steps ?? 400) ? [{ id: "refined", parts: [{ text: `tree refined to ${effectiveSteps} steps`, tone: "muted" as const }] }] : []),
-      ...(liveInputs ? [{ id: "market", parts: [{ text: liveInputs.delayed ? "delayed market" : "real-time market", tone: "muted" as const }] }] : []),
+      ...(liveInputs ? [liveInputs.delayed
+        ? delayedFooterSegment({ id: "market", detail: "Delayed market inputs" })
+        : { id: "market", parts: [{ text: "real-time market", tone: "muted" as const }] }] : []),
     ],
     hints: activeFieldId ? [] : [
       // Names the cell Enter or `e` edits, which the grid does not mark.
@@ -398,7 +401,7 @@ function ContractPremiumChart({
   width: number;
   focused: boolean;
 }) {
-  const empty = unavailable ? "Premium history unavailable." : series.length < 1 ? "No premium history." : undefined;
+  const empty = unavailable ? unavailableText("Premium history") : series.length < 1 ? "No premium history." : undefined;
   return (
     <Box flexDirection="column" paddingX={1} height={PREMIUM_CHART_ROWS} flexShrink={0}>
       {empty && !loading ? (

package/src/plugins/builtin/options-positioning/headless.ts

@@ -2,6 +2,8 @@ import type { HeadlessPaneDefinition, HeadlessPaneEntry } from "../../../types/p
 import { expirationOptionSeconds, expiryIsoDate, OPTION_EXPIRATION_FORMAT, OPTION_EXPIRATION_PLACEHOLDER } from "../../../utils/option-expiry";
 import { formatUtcTime } from "../../../utils/utc-time";
 import { loadGamma, loadOpenInterest, positioningSymbol, type GammaPayload, type OpenInterestPayload } from "./client";
+import { listingFateReport, loadListingFate } from "../../../tickers/listing-fate";
+import { resolveHeadlessInstrument } from "../shared/headless-market-data";
 import {
   ALL_EXPIRIES,
   expiryLabel,
@@ -10,6 +12,7 @@ import {
   formatDistance,
   formatGamma,
   formatLevel,
+  formatPositioningSpot,
   formatPayout,
   formatRatio,
   formatStrike,
@@ -49,7 +52,7 @@ function summary(openInterest: OpenInterestPayload, dealer: GammaPayload | null)
     { key: "oiDate", label: "Open interest as of", value: openInterest.oiDate },
   ];
   const textEntries: HeadlessPaneEntry[] = [
-    { label: "Spot", value: spot, formatted: spot == null ? "--" : spotAsOf ? `${formatLevel(spot)} at ${time(spotAsOf)}` : formatLevel(spot) },
+    { label: "Spot", value: spot, formatted: formatPositioningSpot(spot, spotAsOf) },
     ...(dealer ? [{ label: "Quotes as of", value: dealer.quotesAsOf, formatted: time(dealer.quotesAsOf) }] : []),
     { label: "Open interest as of", value: openInterest.oiDate, formatted: openInterest.oiDate ?? "--" },
   ];
@@ -118,7 +121,7 @@ export const optionsPositioningHeadless = (initialTab: PositioningTab): Headless
     // VIX has no dealer gamma, so its expiries have no column for it.
     const expiryGamma = !(allExpiries instanceof Error) && allExpiries.total ? netGammaByExpiry(allExpiries) : null;
     const gammaColumn = allExpiries instanceof Error || !!allExpiries.total;
-    const errors = [
+    const loadErrors = [
       ...openInterest.warnings,
       ...(dealer instanceof Error ? [`Dealer gamma: ${dealer.message}`] : [
         ...dealer.warnings,
@@ -126,6 +129,11 @@ export const optionsPositioningHeadless = (initialTab: PositioningTab): Headless
       ]),
       ...(everyExpiry instanceof Error ? [`Net GEX by expiry: ${everyExpiry.message}`] : []),
     ];
+    // A symbol with no listed open interest says what became of it when something did (TWTR stopped
+    // trading, FB is a fund now) in place of the load's errors.
+    const fate = openInterest.expiries.length || expiry ? null
+      : listingFateReport(await loadListingFate(await resolveHeadlessInstrument(ctx, symbol), ctx.marketData), { served: false }, loadErrors);
+    const errors = fate?.errors ?? loadErrors;
     const changes = openInterest.previousOiDate != null;
     const gammaShown = dealer instanceof Error || !dealer.total ? null : dealer;
     const scope = dealer instanceof Error ? null : dealer.expiry ? expiryLabel(dealer.expiry) : "all expiries";
@@ -173,7 +181,7 @@ export const optionsPositioningHeadless = (initialTab: PositioningTab): Headless
       ],
       complete: !!openInterest.expiries.length && !(dealer instanceof Error) && errors.length === 0,
       unavailableSymbols: openInterest.expiries.length ? [] : [symbol],
-      errors,
+      errors, ...(fate?.notes.length ? { notes: fate.notes } : {}),
       metadata: {
         underlying: openInterest.underlying,
         oiDate: openInterest.oiDate,

package/src/plugins/builtin/options-positioning/model.ts

@@ -1,5 +1,6 @@
 import { formatCompact, formatCompactAmount } from "../../../utils/format";
 import { formatExpDate } from "../../../utils/options";
+import { modelSpotLabel, modelSpotStamp, modelSpotStampVariants, observedModelSpot } from "../options/model-spot";
 
 export type PositioningTab = "strikes" | "expiries" | "gex";
 export const POSITIONING_TABS: { value: PositioningTab; label: string }[] = [
@@ -66,6 +67,29 @@ export function formatRatio(value: number | null | undefined): string {
 export function formatLevel(value: number | null | undefined): string {
   return value == null || !Number.isFinite(value) ? "--" : value.toFixed(2);
 }
+/**
+ * The spot Gloom Cloud read the distances and dealer gamma at, stamped as
+ * every options pane stamps its spot (`modelSpotStamp`), as a stat cell
+ * carries it: `pre-market Wed 21 Oct 09:35 UTC`, its shorter forms, then
+ * none, so the band keeps the columns it has in regular hours. Nothing for
+ * the regular session's price.
+ */
+export function positioningSpotDetail(spot: number | null | undefined, spotAsOf: string | null | undefined):
+  { detail?: string; detailVariants?: string[] } {
+  const at = spotAsOf ? Date.parse(spotAsOf) : Number.NaN;
+  if (spot == null || !Number.isFinite(at)) return {};
+  const observed = observedModelSpot(spot, at);
+  const stamp = modelSpotStamp(observed);
+  return stamp ? { detail: stamp, detailVariants: [...modelSpotStampVariants(observed), ""] } : {};
+}
+
+/** The spot as a report says it: `770.88 pre-market Wed 21 Oct 09:35 UTC`, `770.10 last Wed 21 Oct 14:05 UTC`. */
+export function formatPositioningSpot(spot: number | null | undefined, spotAsOf: string | null | undefined): string {
+  const at = spotAsOf ? Date.parse(spotAsOf) : Number.NaN;
+  if (spot == null || !Number.isFinite(spot)) return "--";
+  return Number.isFinite(at) ? `${formatLevel(spot)} ${modelSpotLabel(observedModelSpot(spot, at))}` : formatLevel(spot);
+}
+
 /** Where a level sits against spot: +0.6%. */
 export function formatDistance(level: number | null | undefined, spot: number | null | undefined): string {
   if (level == null || spot == null || !(spot > 0)) return "--";

package/src/plugins/builtin/options-positioning/pane.tsx

@@ -57,6 +57,7 @@ import {
   formatDistance,
   formatGamma,
   formatLevel,
+  positioningSpotDetail,
   formatPayout,
   formatRatio,
   formatStrike,
@@ -204,6 +205,7 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
   const openInterest = useAsyncResource<OpenInterestPayload>(openInterestLoader, { keepPreviousData: true });
   const data = openInterest.data;
   const spot = data?.spot ?? null;
+  const spotStamp = useMemo(() => positioningSpotDetail(spot, data?.spotAsOf), [spot, data?.spotAsOf]);
   const expiries = data?.expiries ?? [];
   const shownExpiry = data?.expiry ?? requestedExpiry;
   const changes = data?.previousOiDate != null;
@@ -264,9 +266,7 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
       enabled: expiryIndex < expiryDates.length - 1, onSelect: () => stepExpiry(1) },
   ], [expiryDates.length, expiryIndex, stepExpiry, tab]);
 
-  const { strip: tabStrip, rows: tabRows } = usePaneTabs(data?.expiries.length
-    ? { tabs, activeValue: tab, onSelect: (value: string) => setTab(value), focused, dense: true }
-    : null);
+  const { strip: tabStrip, rows: tabRows } = usePaneTabs({ tabs, activeValue: tab, onSelect: (value: string) => setTab(value), focused, dense: true });
   const bodyHeight = Math.max(3, height - tabRows);
 
   // Footer: what the data is (delayed or real time, the OI session), and its gaps.
@@ -335,13 +335,13 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
   const strikeFigures = useMemo<StatItem[]>(() => !callTotal ? [] : [
     { id: "max-pain", label: "Max pain", value: maxPain == null ? "--" : formatStrike(maxPain), color: colors.warning,
       detail: maxPain == null ? undefined : `${formatDistance(maxPain, spot)} vs spot` },
-    { id: "spot", label: "Spot", value: formatLevel(spot) },
+    { id: "spot", label: "Spot", value: formatLevel(spot), ...spotStamp },
     { id: "pc", label: "P/C OI", value: formatRatio(callTotal.putCallRatio) },
     { id: "calls", label: "Call OI", value: formatCompact(callTotal.callOI), color: colors.positive,
       detail: callTotal.callChange == null ? undefined : formatCountChange(callTotal.callChange) },
     { id: "puts", label: "Put OI", value: formatCompact(callTotal.putOI), color: colors.negative,
       detail: callTotal.putChange == null ? undefined : formatCountChange(callTotal.putChange) },
-  ], [callTotal, colors.negative, colors.positive, colors.warning, maxPain, spot]);
+  ], [callTotal, colors.negative, colors.positive, colors.warning, maxPain, spot, spotStamp]);
   const selectedStrikeRow = strikes.find((row) => strikeKey(row) === strikeSelectedId) ?? null;
   const strikeStrip = useMemo<ChartStripSpec | null>(() => strikeWindow.length < 3 ? null : {
     label: "Open interest by strike",
@@ -404,9 +404,9 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
         split: [{ id: "calls", value: calls, color: colors.positive }, { id: "puts", value: puts, color: colors.negative }] },
       { id: "pc", label: "P/C OI", value: formatRatio(calls > 0 ? puts / calls : null) },
       { id: "largest", label: "Largest expiry", value: expiryLabel(largest.date), detail: formatCompact(expirySize(largest)) },
-      { id: "spot", label: "Spot", value: formatLevel(spot) },
+      { id: "spot", label: "Spot", value: formatLevel(spot), ...spotStamp },
     ];
-  }, [changes, colors.negative, colors.positive, expiries, spot]);
+  }, [changes, colors.negative, colors.positive, expiries, spot, spotStamp]);
   const selectedExpiryRow = expiries.find((row) => row.date === expirySelectedId) ?? null;
   const expiryStrip = useMemo<ChartStripSpec | null>(() => expiries.length < 3 ? null : {
     label: "Open interest by expiry",
@@ -479,7 +479,7 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
     })),
     ...(band ? [{ id: "band", label: "Dealer range", value: `${formatGamma(band.low)} to ${formatGamma(band.high)}`,
       detail: `${shares} with dealers${gammaData.boxes?.length ? ", boxes out" : ""}` }] : []),
-    { id: "spot", label: "Spot", value: formatLevel(gammaSpot) },
+    { id: "spot", label: "Spot", value: formatLevel(gammaSpot), ...positioningSpotDetail(gammaSpot, gammaData.spotAsOf) },
   ], [band, colors.negative, colors.positive, gammaData, gammaSpot, shares, walls]);
   // The assumption rides in the legend, where the numbers it changes are read; the
   // dealer range figure names its own share. It gives way before the series name does.
@@ -610,13 +610,11 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
   }
 
   return <Box width={width} height={height} flexDirection="column">
+    {tabStrip}
     <PaneStatusBody loading={openInterest.loading && !data} error={!data ? openInterest.error : null}
       empty={!!data && !data.expiries.length} subject="open interest"
       emptyTitle={`No listed options for ${parsePublicTickerKey(symbol).symbol.replace(/^\^/, "")}.`}>
-      {data?.expiries.length ? <>
-        {tabStrip}
-        {content}
-      </> : null}
+      {data?.expiries.length ? content : null}
     </PaneStatusBody>
   </Box>;
 }

package/src/plugins/builtin/options-scenario/client.ts

@@ -13,7 +13,7 @@ import type { YieldPoint } from "../yield-curve/treasury-data";
 import { parseLegs, scenarioCurrency, validatePosition, type ScenarioControls, type ScenarioLeg, type ScenarioPosition } from "./model";
 import { loadModelDividendYield, type ModelDividendYield } from "../../../market-data/model-dividend-yield";
 import { abortable, abortError } from "../../../utils/async-deadline";
-import { extendedSession } from "../options/model-spot";
+import { extendedSession, modelSpotStamp, modelSpotStampVariants, type OptionModelSpot } from "../options/model-spot";
 import { errorMessage } from "../../../utils/errors";
 
 export interface ScenarioMarketSnapshot {
@@ -191,6 +191,24 @@ export function scenarioSpotBasis(
   return (market?.underlyingQuote ? extendedSession(market.underlyingQuote) : null) ?? "last price";
 }
 
+const EXTENDED_BASES: readonly string[] = ["pre-market", "after hours", "overnight"];
+
+/**
+ * A spot basis as the pane and report name it: an extended-session print with
+ * its time, stamped as every options pane stamps its spot (`modelSpotStamp`),
+ * `pre-market Wed 21 Oct 09:42 UTC`; any other basis as it is.
+ */
+export function scenarioSpotStamp(basis: string, observedAt: number): string {
+  if (!EXTENDED_BASES.includes(basis)) return basis;
+  return modelSpotStamp({ basis: "last", session: basis as OptionModelSpot["session"], observedAt }) ?? basis;
+}
+
+/** That stamp's shorter forms, longest first (`modelSpotStampVariants`): `pre-market 09:42 UTC`, `pre-market`. */
+export function scenarioSpotStampVariants(basis: string, observedAt: number): string[] {
+  if (!EXTENDED_BASES.includes(basis)) return [];
+  return modelSpotStampVariants({ basis: "last", session: basis as OptionModelSpot["session"], observedAt });
+}
+
 function supplied(value: unknown): boolean { return value != null && value !== ""; }
 
 /** A position typed whole: its legs and the spot, rate and dividend yield they are valued at, so no market data is read. */