gloomberb 0.16.3 → 0.16.4

package/src/plugins/builtin/market-movers/model.ts

@@ -1,5 +1,13 @@
 import { resolveCurrencyUnit } from "../../../utils/currency-units";
 import { overlayScreenerQuoteEntries } from "../../../market-data/quotes/screener-live-quotes";
+import {
+  getExtendedSessionDisplay,
+  getRegularSessionDisplay,
+  type ExtendedSession,
+  type ExtendedSessionDisplay,
+} from "../../../market-data/market/status";
+import { buildQuoteKey, resolveEntryData } from "../../../market-data/selectors";
+import { isFiniteNumber } from "../../../utils/guards";
 import type { Quote } from "../../../types/financials";
 import type { CloudSessionMoversCategory } from "../../../api-client/market-movers";
 import type { QueryEntry } from "../../../market-data/result-types";
@@ -37,12 +45,20 @@ type MarketMoverColumnId =
   | "name"
   | "price"
   | "changePercent"
+  | "preMarket"
+  | "afterHours"
   | "volume"
   | "volumeRatio"
   | "range"
   | "marketCap";
 export type MarketMoverColumn = DataTableColumn & { id: MarketMoverColumnId };
-export type MarketMoverRow = ScreenerQuote & { rank: number };
+/**
+ * A list row. Price and change are the regular session's, as `ticker` reads
+ * them; a row whose quote has a pre-market or after-hours print carries it in
+ * `extended`, measured from that session's close.
+ */
+export type MoverQuote = ScreenerQuote & { extended?: ExtendedSessionDisplay | null };
+export type MarketMoverRow = MoverQuote & { rank: number };
 
 export interface MarketMoverSortPreference {
   columnId: MarketMoverColumnId | null;
@@ -96,6 +112,9 @@ function getSortValue(
       return row.price;
     case "changePercent":
       return row.changePercent;
+    case "preMarket":
+    case "afterHours":
+      return moverExtendedMove(row, columnId === "preMarket" ? "PRE" : "POST");
     case "volume":
       return row.volume;
     case "volumeRatio":
@@ -123,7 +142,17 @@ export function sortRows(
 /** A row is rebuilt only when its quote or rank moved, so unchanged rows skip the render. */
 const moverRows = new WeakMap<ScreenerQuote, MarketMoverRow>();
 
-export function createRows(quotes: ScreenerQuote[]): MarketMoverRow[] {
+/** The extended print's move from the close, when the row has one for `session`. */
+export function moverExtendedMove(row: MoverQuote, session: ExtendedSession): number | null {
+  return row.extended?.session === session && isFiniteNumber(row.extended.changePercent) ? row.extended.changePercent : null;
+}
+
+/** The extended sessions some row has a print for, in the order their columns go. */
+export function moverExtendedSessions(rows: readonly MoverQuote[]): ExtendedSession[] {
+  return (["PRE", "POST"] as const).filter((session) => rows.some((row) => row.extended?.session === session));
+}
+
+export function createRows(quotes: readonly MoverQuote[]): MarketMoverRow[] {
   return quotes.map((quote, index) => {
     const cached = moverRows.get(quote);
     if (cached?.rank === index + 1) return cached;
@@ -137,26 +166,36 @@ export function createRows(quotes: ScreenerQuote[]): MarketMoverRow[] {
   });
 }
 
-export function summaryQuoteFromQuote(
-  symbol: string,
-  quote: { name?: string; price: number; change: number; changePercent: number },
-): MarketSummaryQuote {
+/** An index in the summary strip, at its regular session's level and move. */
+export function summaryQuoteFromQuote(symbol: string, quote: Quote): MarketSummaryQuote {
+  const headline = getRegularSessionDisplay(quote)!;
   return {
     symbol,
     name: quote.name ?? symbol,
-    price: quote.price,
-    change: quote.change,
-    changePercent: quote.changePercent,
+    price: headline.price,
+    change: headline.change ?? Number.NaN,
+    changePercent: headline.changePercent ?? Number.NaN,
   };
 }
 
-export function screenerQuoteFromQuote(symbol: string, quote: { name?: string; price?: number; change?: number; changePercent?: number; volume?: number; currency?: string; exchangeName?: string; listingExchangeName?: string; lastUpdated?: number; previousClose?: number }): ScreenerQuote {
+/** The extended print beside a quote's regular session, or null; a non-finite price is none. */
+function moverExtended(quote: Quote): ExtendedSessionDisplay | null {
+  const extended = getExtendedSessionDisplay(quote);
+  return extended && isFiniteNumber(extended.price) ? extended : null;
+}
+
+/**
+ * A trending row from its quote: Last and Chg% are the regular session, as
+ * `ticker` reads it, and a pre-market or after-hours print rides beside them.
+ */
+export function screenerQuoteFromQuote(symbol: string, quote: Quote): MoverQuote {
+  const headline = getRegularSessionDisplay(quote)!;
   return {
     symbol,
     name: quote.name ?? symbol,
-    price: screenerNumber(quote.price),
-    change: screenerNumber(quote.change),
-    changePercent: screenerNumber(quote.changePercent),
+    price: screenerNumber(headline.price),
+    change: screenerNumber(headline.change),
+    changePercent: screenerNumber(headline.changePercent),
     volume: screenerVolume(quote.volume),
     avgVolume: null,
     volumeRatio: null,
@@ -169,6 +208,7 @@ export function screenerQuoteFromQuote(symbol: string, quote: { name?: string; p
     exchange: quote.listingExchangeName ?? quote.exchangeName ?? "",
     lastUpdated: quote.lastUpdated,
     previousClose: screenerNumber(quote.previousClose) ?? undefined,
+    extended: moverExtended(quote),
   };
 }
 
@@ -198,21 +238,35 @@ export function formatMoverPrice(price: number | null, currency: string, referen
 }
 
 /** Keyed by the overlaid row, which the shared overlay keeps while its quote holds. */
-const convertedOverlays = new WeakMap<ScreenerQuote, ScreenerQuote>();
+const convertedOverlays = new WeakMap<ScreenerQuote, MoverQuote>();
 
-/** Range endpoints and the previous close belong to the original screener price denomination. */
+/**
+ * Live quotes on the list's rows, which keep the list's order. Price and
+ * change are the regular session's, as `ticker` reads them, so after the
+ * close they hold at it and a pre-market or after-hours print is the row's
+ * `extended`. Range endpoints and the previous close belong to the original
+ * screener price denomination.
+ */
 export function overlayMarketMoverQuotes(
-  rows: readonly ScreenerQuote[],
+  rows: readonly MoverQuote[],
   entries: ReadonlyMap<string, QueryEntry<Quote>>,
-): ScreenerQuote[] {
+): MoverQuote[] {
   return overlayScreenerQuoteEntries(rows, entries).map((row, index) => {
     const original = rows[index]!;
     if (row === original) return row;
     const cached = convertedOverlays.get(row);
     if (cached) return cached;
     const convert = (value: number | undefined) => convertScreenerPriceUnit(value, original.currency, row.currency);
+    const quote = resolveEntryData(entries.get(buildQuoteKey({ symbol: row.symbol, exchange: row.exchange })));
+    const headline = quote ? getRegularSessionDisplay(quote) : null;
     const converted = {
       ...row,
+      ...(quote && headline ? {
+        price: headline.price,
+        change: isFiniteNumber(headline.change) ? headline.change : null,
+        changePercent: isFiniteNumber(headline.changePercent) ? headline.changePercent : null,
+        extended: moverExtended(quote),
+      } : {}),
       fiftyTwoWeekLow: convert(original.fiftyTwoWeekLow),
       fiftyTwoWeekHigh: convert(original.fiftyTwoWeekHigh),
       dayLow: convert(original.dayLow),

package/src/plugins/builtin/market-movers/table.ts

@@ -1,9 +1,11 @@
 import type { DataTableCell } from "../../../components";
+import { getTableWidth } from "../../../components/ui/table-layout";
 import { TextAttributes } from "../../../ui";
 import { colors, priceColor } from "../../../theme/colors";
 import { formatCompact, formatPercentRaw } from "../../../utils/format";
+import { marketStateLabel, type ExtendedSession } from "../../../market-data/market/status";
 import type { MarketMoverColumn, MarketMoverRow } from "./model";
-import { fiftyTwoWeekPositionPercent, formatMoverPrice, moverReferencePrice } from "./model";
+import { fiftyTwoWeekPositionPercent, formatMoverPrice, moverExtendedMove, moverReferencePrice } from "./model";
 
 export function formatVolRatio(ratio: number | null): string {
   if (ratio == null || !Number.isFinite(ratio) || ratio < 0) return "—";
@@ -22,30 +24,45 @@ function fiftyTwoWeekPosition(price: number | null, low: number | undefined, hig
   return pct == null ? "—" : `${Math.round(pct)}%`;
 }
 
-export function buildMarketMoverColumns(width: number): MarketMoverColumn[] {
-  const rankWidth = 3;
-  const tickerWidth = 8;
-  const priceWidth = 11;
-  const chgWidth = 9;
-  const volWidth = 8;
-  const volRatioWidth = 6;
-  const rangeWidth = 6;
-  const mcapWidth = 8;
-  const columnCount = 9;
-  const fixedWidth = rankWidth + tickerWidth + priceWidth + chgWidth + volWidth + volRatioWidth + rangeWidth + mcapWidth;
-  const nameWidth = Math.max(6, width - 2 - columnCount - fixedWidth);
+const EXTENDED_COLUMN_WIDTH = 9;
+/** With an extended column, a narrow pane drops MCAP, then 52W%, before the name gets narrower than this. */
+const EXTENDED_MIN_NAME_WIDTH = 12;
 
-  return [
-    { id: "rank", label: "#", width: rankWidth, align: "left" },
-    { id: "symbol", label: "TICKER", width: tickerWidth, align: "left" },
-    { id: "name", label: "NAME", width: nameWidth, align: "left" },
-    { id: "price", label: "LAST", width: priceWidth, align: "right" },
-    { id: "changePercent", label: "CHG%", width: chgWidth, align: "right" },
-    { id: "volume", label: "VOL", width: volWidth, align: "right" },
-    { id: "volumeRatio", label: "V/AVG", width: volRatioWidth, align: "right" },
-    { id: "range", label: "52W%", width: rangeWidth, align: "right" },
-    { id: "marketCap", label: "MCAP", width: mcapWidth, align: "right" },
+/**
+ * The list's columns at `width`. A pre-market or after-hours column follows
+ * CHG% for each session in `extendedSessions`; to make room for it a narrow
+ * pane gives up MCAP, then 52W%, before it cuts the names short.
+ */
+export function buildMarketMoverColumns(width: number, extendedSessions: readonly ExtendedSession[] = []): MarketMoverColumn[] {
+  const lead: MarketMoverColumn[] = [
+    { id: "rank", label: "#", width: 3, align: "left" },
+    { id: "symbol", label: "TICKER", width: 8, align: "left" },
   ];
+  const quote: MarketMoverColumn[] = [
+    { id: "price", label: "LAST", width: 11, align: "right" },
+    { id: "changePercent", label: "CHG%", width: 9, align: "right" },
+    ...extendedSessions.map((session): MarketMoverColumn => ({
+      id: session === "PRE" ? "preMarket" : "afterHours",
+      // Named for the session it trades in, as the header labels it.
+      label: marketStateLabel(session),
+      width: EXTENDED_COLUMN_WIDTH,
+      align: "right",
+    })),
+  ];
+  const trailing: MarketMoverColumn[] = [
+    { id: "volume", label: "VOL", width: 8, align: "right" },
+    { id: "volumeRatio", label: "V/AVG", width: 6, align: "right" },
+    { id: "range", label: "52W%", width: 6, align: "right" },
+    { id: "marketCap", label: "MCAP", width: 8, align: "right" },
+  ];
+  // Measured the way the table draws them (a header and its sort mark widen a
+  // column, gaps between them); the name adds its own width and a gap.
+  const nameRoom = () => width - getTableWidth([...lead, ...quote, ...trailing]) - 1;
+  for (const id of ["marketCap", "range"] as const) {
+    if (extendedSessions.length === 0 || nameRoom() >= EXTENDED_MIN_NAME_WIDTH) break;
+    trailing.splice(trailing.findIndex((column) => column.id === id), 1);
+  }
+  return [...lead, { id: "name", label: "NAME", width: Math.max(6, nameRoom()), align: "left" }, ...quote, ...trailing];
 }
 
 export function renderMarketMoverCell(
@@ -71,6 +88,16 @@ export function renderMarketMoverCell(
         value: row.changePercent,
         color: priceColor(row.changePercent ?? 0),
       };
+    case "preMarket":
+    case "afterHours": {
+      // The extended print's move from the close in LAST.
+      const move = moverExtendedMove(row, column.id === "preMarket" ? "PRE" : "POST");
+      return {
+        text: formatPercentRaw(move ?? undefined),
+        value: move,
+        color: move == null ? colors.textDim : priceColor(move),
+      };
+    }
     case "volume":
       return { text: formatCompact(row.volume ?? undefined, { fixedDecimals: true }), value: row.volume, color: colors.textDim };
     case "volumeRatio":

package/src/plugins/builtin/news/headless.ts

@@ -11,6 +11,7 @@ import {
   mapCloudNewsArticle,
 } from "../../../sources/gloomberb-cloud/news";
 import { parsePublicTickerKey } from "../../../utils/exchanges";
+import { cloudNewsFreshness, cloudRealtimeAccess } from "../shared/report-freshness";
 
 const NEWS_COLUMNS = [
   { key: "publishedAt", header: "Published" },
@@ -27,11 +28,14 @@ export interface NewsHeadlessDependencies {
     context: HeadlessPaneContext,
   ): Promise<CloudNewsListResponse>;
   now(): Date;
+  /** Whether the session has real-time news; without it the stories are held back. */
+  realtimeAccess?(): Promise<boolean | null>;
 }
 
 const defaultDependencies: NewsHeadlessDependencies = {
   loadNews: (query, context) => context.apiClient.getCloudNews(cloudNewsParams(query)),
   now: () => new Date(),
+  realtimeAccess: cloudRealtimeAccess,
 };
 
 function newsRow(article: NewsArticle) {
@@ -67,6 +71,7 @@ function projectNewsHeadless(
   response: CloudNewsListResponse,
   args: HeadlessPaneLoadArgs,
   now: Date,
+  realtime: boolean | null,
 ): HeadlessSnapshotResult {
   const sentiment = selectedSentiment(args);
   const minImportance = Number(args.options.minImportance ?? 0);
@@ -81,8 +86,8 @@ function projectNewsHeadless(
   return {
     asOf: now.toISOString(),
     items,
-    // Published stories, dated by the newest; the list is a history, so its last story is not stale data.
-    freshness: { status: "not-a-feed", basis: "published stories", observedKey: "publishedAt", oldest: null },
+    // Dated by the newest story, held back for an account without real-time news.
+    freshness: cloudNewsFreshness(realtime),
     metadata: {
       nextCursor: response.nextCursor,
       sentiment,
@@ -179,6 +184,7 @@ export function createNewsFeedHeadless(
         await dependencies.loadNews(queryFor(args, "latest"), context),
         args,
         dependencies.now(),
+        await dependencies.realtimeAccess?.() ?? null,
       );
     },
   };
@@ -205,6 +211,7 @@ export function createTickerNewsHeadless(
         ),
         args,
         dependencies.now(),
+        await dependencies.realtimeAccess?.() ?? null,
       );
     },
   };

package/src/plugins/builtin/news/wire/news/footer.ts

@@ -10,6 +10,7 @@ import { CLOUD_NEWS_DELAY_HOURS } from "../../../../../api-client/plan-access";
 import { usePaneStatusLinkFooter } from "../../../../../components/layout/pane/status-footer";
 import { usePluginAppActions } from "../../../../runtime";
 import { useOptionalPaneInstanceId } from "../../../../../state/app/context";
+import { useRemoteUiNode } from "../../../../../remote/semantic-tree";
 
 interface NewsFooterArticle {
   title?: string | null;
@@ -60,6 +61,15 @@ export function useNewsArticleFooter({
     shortcutScope: `${registrationId}:news-upgrade`,
   });
 
+  // A report or capture of the pane says how far its stories are held back, as the footer does.
+  useRemoteUiNode({
+    role: "report-freshness",
+    label: "News freshness",
+    getMetadata: () => (access.hasProAccess
+      ? { status: "live" }
+      : { status: "delayed", delayMinutes: CLOUD_NEWS_DELAY_HOURS * 60 }),
+  });
+
   const accessInfo = useMemo<PaneFooterSegment[]>(() => {
     if (access.isPayingPro) {
       return [{ id: "news-access", parts: [{ text: t("real-time news"), tone: "positive" }] }];

package/src/plugins/builtin/openfda/client.ts

@@ -280,7 +280,7 @@ export class OpenFdaClient {
   async listPage(dataset: OpenFdaDataset, query: string, offset: number, signal?: AbortSignal): Promise<OpenFdaPage> {
     const response = await openFdaFetch.fetch(buildOpenFdaUrl(dataset, query, offset), {
       headers: authorizationHeaders(),
-      signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(DEFAULT_TIMEOUT_MS)]) : undefined,
+      signal,
     });
     // openFDA answers a search with no matches with a 404.
     if (response.status === 404) {

package/src/plugins/builtin/options/carry.ts

@@ -0,0 +1,95 @@
+import type { OptionContract } from "../../../types/financials";
+import { daysToExpiryFrom, optionMid, type OptionSide } from "../shared/volatility";
+import { optionSpread } from "./market-reference";
+
+/**
+ * What holding a contract costs in time value, read the same way by the OMON
+ * columns and the LEAPS screen (`gloomberb options --leaps`):
+ *
+ *   intrinsic          = max(0, spot - strike) for a call, max(0, strike - spot) for a put
+ *   extrinsic          = midpoint - intrinsic, the midpoint of a two-sided quote
+ *   extrinsic per year = extrinsic / spot / years to expiry
+ *
+ * Years are calendar days to the 16:00 New York close on the expiry date, over
+ * 365, counted from the instant the Greeks are valued at. Under a day from the
+ * close there is no yearly figure: a few cents over a few hours annualises to
+ * noise. Extrinsic is negative when the midpoint sits below intrinsic value, as
+ * a wide deep in-the-money quote can. Without a two-sided quote or a current
+ * spot there is no figure, never a zero.
+ */
+export interface OptionCarry {
+  /** Time value per share, in the contract's currency. */
+  extrinsic: number;
+  /** Time value as a fraction of spot per year: 0.042 reads 4.2%. Null under a day from expiry. */
+  extrinsicPerYear: number | null;
+}
+
+/** Less time than this to expiry and a yearly rate means nothing. */
+const MIN_CARRY_DAYS = 1;
+
+function positive(value: number | null | undefined): value is number {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+
+function optionIntrinsicValue(side: OptionSide, strike: number, spot: number): number {
+  return Math.max(0, side === "call" ? spot - strike : strike - spot);
+}
+
+export function optionCarry(
+  contract: Pick<OptionContract, "bid" | "ask" | "strike" | "expiration">,
+  side: OptionSide,
+  spot: number | null | undefined,
+  valuationTime: number,
+): OptionCarry | null {
+  const mid = optionMid(contract);
+  if (mid == null || !positive(spot) || !positive(contract.strike)) return null;
+  const extrinsic = mid - optionIntrinsicValue(side, contract.strike, spot);
+  const days = daysToExpiryFrom(contract.expiration, valuationTime);
+  return { extrinsic, extrinsicPerYear: days >= MIN_CARRY_DAYS ? extrinsic / spot / (days / 365) : null };
+}
+
+/** Bid/ask width as a percent of the midpoint; null without a two-sided quote. */
+export function optionSpreadPercent(contract: Pick<OptionContract, "bid" | "ask">): number | null {
+  const spread = optionSpread(contract);
+  return spread.kind === "two-sided" ? spread.percentOfMid : null;
+}
+
+/**
+ * What a contract costs against the stock it covers: the midpoint of a
+ * two-sided quote over spot, so a protective put's premium reads as a share of
+ * the position it protects (a 5.495 put on a 778.57 underlying is 0.706%).
+ * Null without a two-sided quote or a current spot, never a zero.
+ */
+export function optionCostOfSpot(
+  contract: Pick<OptionContract, "bid" | "ask">,
+  spot: number | null | undefined,
+): number | null {
+  const mid = optionMid(contract);
+  return mid == null || !positive(spot) ? null : mid / spot;
+}
+
+/** Below this a cost of spot reads as a bound: the digits would outrun the column. */
+const MIN_COST_OF_SPOT_PERCENT = 0.001;
+
+/**
+ * A fraction as a percent to three significant digits: 0.00706 reads 0.706%,
+ * 0.0123 reads 1.23%, 0.123 reads 12.3%. Under a thousandth of a percent it
+ * reads <0.001%, so a far out-of-the-money quote stays inside the column.
+ */
+export function formatCostOfSpot(value: number | null | undefined): string {
+  if (value == null || !Number.isFinite(value) || value < 0) return "\u2014";
+  const percent = value * 100;
+  if (percent === 0) return "0%";
+  if (percent < MIN_COST_OF_SPOT_PERCENT) return `<${MIN_COST_OF_SPOT_PERCENT}%`;
+  // Rounded first, so 9.996 reads 10.0% rather than 10.00%.
+  const rounded = Number(percent.toPrecision(3));
+  const decimals = Math.max(0, 2 - Math.floor(Math.log10(rounded)));
+  return `${rounded.toFixed(decimals)}%`;
+}
+
+/** A fraction as a percent: one decimal under 100% (0.0421 reads 4.2%), whole percents above. */
+export function formatCarryPercent(value: number | null | undefined): string {
+  if (value == null || !Number.isFinite(value)) return "—";
+  const percent = value * 100;
+  return `${percent.toFixed(Math.abs(percent) < 100 ? 1 : 0)}%`;
+}

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

@@ -1,9 +1,10 @@
-import type { PaneSettingsDef, TickerResearchTabProps } from "../../../types/plugin";
+import type { PaneReportOptionDef, PaneSettingsDef, TickerResearchTabProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import type { OptionsViewProps } from "./types";
 import { OptionsView } from "./view";
 import { isKnownMutualFund } from "../../../tickers/instrument-kind";
+import { expirationOptionSeconds, expiryIsoDate, OPTION_EXPIRATION_FORMAT, OPTION_EXPIRATION_PLACEHOLDER, readOptionExpiration } from "../../../utils/option-expiry";
 
 /** The registered chain shows IV rank; isolated view renders stay offline. */
 function OptionsPane(props: OptionsViewProps) {
@@ -22,19 +23,40 @@ import {
   LIVE_STREAMING_QUICK_SETTING,
   withLiveStreamingSetting,
 } from "../../../state/hooks/live-streaming";
-import { OPTION_FIELD_DEFS, resolveOptionFieldIds } from "./table";
+import { OPTION_FIELD_DEFS, normalizeOptionColumnsOption, resolveOptionFieldIds } from "./table";
+import {
+  STRIKE_WINDOW_PRESETS,
+  STRIKE_WINDOW_SETTING,
+  normalizeStrikeWindowOption,
+  resolveStrikeWindow,
+  strikeWindowShortLabel,
+  strikeWindowValue,
+} from "./strike-window";
 
 function optionsSettings(settings: Record<string, unknown>): PaneSettingsDef {
+  const strikeWindow = resolveStrikeWindow(settings[STRIKE_WINDOW_SETTING]);
+  const strikeWindowText = strikeWindowValue(strikeWindow);
+  const strikeWindowOptions = STRIKE_WINDOW_PRESETS.map(({ value, label, description }) => ({ value, label, description }));
   return {
     title: "Options Settings",
     values: {
       optionColumnIds: resolveOptionFieldIds(settings.optionColumnIds),
+      [STRIKE_WINDOW_SETTING]: strikeWindowText,
     },
     fields: [
+      {
+        key: STRIKE_WINDOW_SETTING,
+        label: "Strikes",
+        description: "Which strikes the chain lists: all of them, a count either side of the money, or those whose call or put delta falls in a band.",
+        type: "select",
+        // A window typed on the command line that no preset matches stays selectable.
+        options: strikeWindowOptions.some((option) => option.value === strikeWindowText) ? strikeWindowOptions
+          : [...strikeWindowOptions, { value: strikeWindowText, label: strikeWindowShortLabel(strikeWindow), description: "Set from the command line." }],
+      },
       {
         key: "optionColumnIds",
         label: "Columns",
-        description: "Choose and order the fields mirrored around the strike.",
+        description: "Choose and order the fields mirrored around the strike. Cost % of spot shows on the put side only.",
         type: "ordered-multi-select",
         options: OPTION_FIELD_DEFS.map((field) => ({
           value: field.id,
@@ -58,6 +80,16 @@ function optionsSettings(settings: Record<string, unknown>): PaneSettingsDef {
   };
 }
 
+/** `fn OMON AAPL --expiration 2028-01-21`: the expiry the chain opens at, as the pane setting a handoff sets. */
+const EXPIRATION_REPORT_OPTION: PaneReportOptionDef = {
+  key: "expiration",
+  type: "string",
+  placeholder: OPTION_EXPIRATION_PLACEHOLDER,
+  description: `The expiry to show, as ${OPTION_EXPIRATION_FORMAT}. Without it, the nearest one.`,
+  example: "--expiration 2028-01-21",
+  normalize: (value) => expiryIsoDate(expirationOptionSeconds(value)),
+};
+
 export const optionsModule: PluginModule = {
   panes: [
     {
@@ -72,6 +104,25 @@ export const optionsModule: PluginModule = {
       quickSettings: [LIVE_STREAMING_QUICK_SETTING],
       settings: (context) => withLiveStreamingSetting(optionsSettings(context.settings), context.settings),
       tableExport: true,
+      reportOptions: [EXPIRATION_REPORT_OPTION, {
+        key: STRIKE_WINDOW_SETTING,
+        aliases: ["delta"],
+        type: "string",
+        placeholder: "all|count|delta band",
+        description: "Strikes to list: all (the default), a count either side of the money such as 10, "
+          + "or a call or put delta band such as 0.70-0.90. --delta 0.70-0.90 reads the same",
+        example: "--strikes 0.70-0.90",
+        normalize: normalizeStrikeWindowOption,
+      }, {
+        key: "columns",
+        settingKey: "optionColumnIds",
+        type: "string",
+        placeholder: "fields",
+        description: `Fields mirrored around the strike, in order, as the Columns setting picks them: ${OPTION_FIELD_DEFS.map((field) => field.id).join(", ")}. `
+          + "costOfSpot (the put's midpoint as a percent of spot) shows on the put side only",
+        example: "--columns bid,ask,spread,delta,openInterest,extrinsicPerYear",
+        normalize: normalizeOptionColumnsOption,
+      }],
     },
   ],
 
@@ -83,8 +134,10 @@ export const optionsModule: PluginModule = {
       description: "Options chain for the selected ticker.",
       keywords: ["options", "chain", "calls", "puts", "omon"],
       shortcut: "OMON",
-      settings: (_symbol, _context, options) => options?.values?.expiration
-        ? { expiration: Number(options.values.expiration), expirationTargetKey: null } : {},
+      settings: (_symbol, _context, options) => {
+        const expiration = readOptionExpiration(options?.values?.expiration);
+        return expiration == null ? {} : { expiration, expirationTargetKey: null };
+      },
       publicShare: true,
     }),
   ],