gloomberb 0.17.1 → 0.17.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/src/{plugins/builtin/cloud → account}/auth-dialog.tsx

@@ -6,13 +6,13 @@
  * hosted terminal's sign-in gate reuses.
  */
 import { useEffect, useRef, useState } from "react";
-import type { AuthUser } from "../../../api-client";
-import { DialogFrame } from "../../../components/ui/frame";
-import { useAppLanguage } from "../../../i18n/react";
-import { useDialog, type PromptContext } from "../../../ui/dialog";
-import { AuthForm, authFormTitle } from "../../../account/auth-form";
-import type { AccountMode } from "../../../account/auth-model";
-import { CloudVerificationPanel } from "../../../account/verification-panel";
+import type { AuthUser } from "../api-client";
+import { DialogFrame } from "../components/ui/frame";
+import { useAppLanguage } from "../i18n/react";
+import { useDialog, type PromptContext } from "../ui/dialog";
+import { AuthForm, authFormTitle } from "./auth-form";
+import type { AccountMode } from "./auth-model";
+import { CloudVerificationPanel } from "./verification-panel";
 
 function AuthDialog({
   initialMode,

package/src/api-client/earnings.ts

@@ -38,7 +38,9 @@ export interface EarningsReport {
   reportedAt: string | null;
   /** Fiscal quarter end month, YYYY-MM. */
   fiscalPeriod: string | null;
+  /** The company's cap as RV reads it: its latest snapshot at the regular session's price. */
   marketCap: number | null;
+  /** For an upcoming report, the consensus every earnings view shows, with `epsAnalysts` behind it. */
   epsEstimate: number | null;
   epsActual: number | null;
   epsAnalysts: number | null;
@@ -48,6 +50,8 @@ export interface EarningsReport {
   realized: EarningsRealizedMove | null;
   /** Whether the date is out, announced or projected; absent from older servers. */
   dateStatus?: EarningsDateStatus;
+  /** The reported figure's basis, null when it cannot be determined; absent from older servers. */
+  epsBasis?: EarningsEpsBasis | null;
 }
 
 export interface EarningsCalendarReport extends EarningsReport {
@@ -65,8 +69,6 @@ export interface EarningsCalendarPayload {
 
 interface EarningsHistoryReport extends EarningsReport {
   revenueActual: number | null;
-  /** Null when the basis cannot be determined; absent from older servers. */
-  epsBasis?: EarningsEpsBasis | null;
 }
 
 export interface EarningsHistoryPayload {

package/src/app/global-shortcuts.ts

@@ -212,6 +212,16 @@ export function useAppGlobalShortcuts({
       return;
     }
 
+    // Text fields keep Cmd+Z. Everywhere else it restores the previous layout.
+    // A detached window has no layout history of its own.
+    if (action === "layout-undo" || action === "layout-redo") {
+      if (isDetachedWindow || dialogOpen || state.commandBarOpen || state.inputCaptured || event.targetEditable === true) return;
+      event.preventDefault();
+      event.stopPropagation();
+      dispatch({ type: action === "layout-undo" ? "UNDO_LAYOUT" : "REDO_LAYOUT" });
+      return;
+    }
+
     if (dialogOpen) return;
 
     if (!isDetachedWindow && action === "command-bar") {

package/src/app/keybindings/actions.ts

@@ -30,6 +30,8 @@ export type CoreKeybindingActionId =
   | "pane-share"
   | "pane-ask"
   | "layout-gallery"
+  | "layout-undo"
+  | "layout-redo"
   | "tidy-windows"
   | "window-move-mode"
   | "window-resize-mode";
@@ -62,6 +64,8 @@ export const PANE_ACTION_IDS = new Set<CoreKeybindingActionId>([
   "pane-share",
   "pane-ask",
   "layout-gallery",
+  "layout-undo",
+  "layout-redo",
   "tidy-windows",
   "window-move-mode",
   "window-resize-mode",
@@ -245,6 +249,18 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
     description: "Open layout actions.",
     defaults: ["CmdOrCtrl+Shift+L"],
   },
+  {
+    id: "layout-undo",
+    category: "Pane Management",
+    description: "Undo the last layout change.",
+    defaults: ["CmdOrCtrl+Z"],
+  },
+  {
+    id: "layout-redo",
+    category: "Pane Management",
+    description: "Redo the last undone layout change.",
+    defaults: ["CmdOrCtrl+Shift+Z"],
+  },
   {
     id: "tidy-windows",
     category: "Pane Management",

package/src/app/runtime/desktop-deeplink.ts

@@ -11,7 +11,7 @@ import {
 import type { DesktopDeepLinkBridge } from "../../types/desktop-deeplink";
 import type { DesktopWindowBridge } from "../../types/desktop-window";
 import { requestAccountManagementTab } from "../../plugins/builtin/account-management/navigation";
-import { openTeamPane } from "../../plugins/builtin/cloud/team/pane-request";
+import { openTeamPane } from "../../team/pane-request";
 import { chatController } from "../../plugins/builtin/chat/controller";
 import { getShare, type ShareRecord } from "../../shares/api";
 import { openShareLink, registerShareOpener } from "../../shares/open";

package/src/app.tsx

@@ -14,7 +14,7 @@ import { Header } from "./components/layout/header";
 import { StatusBar } from "./components/layout/status-bar";
 import { useAppChromeShown } from "./components/layout/presentation";
 import { useLinkedLayoutSync } from "./layout-marketplace/linked-sync";
-import { useTeamCollectionsSync } from "./plugins/builtin/cloud/team/collections-sync";
+import { useTeamCollectionsSync } from "./team/collections-sync";
 import { Shell } from "./components/layout/shell";
 import { DetachedPaneShell } from "./components/layout/detached-pane-shell";
 import { TransientLayoutProvider } from "./components/layout/transient-layout";

package/src/architecture/core-builtin-allowlist.json

@@ -4,11 +4,11 @@
   "src/app/global-shortcuts.ts": ["help"],
   "src/app/pane-runtime/plugin-bindings.ts": ["broker-manager","layout-manager"],
   "src/app/runtime/broker-import.ts": ["portfolio-list"],
-  "src/app/runtime/desktop-deeplink.ts": ["account-management","chat","cloud"],
+  "src/app/runtime/desktop-deeplink.ts": ["account-management","chat"],
   "src/app/runtime/startup.ts": ["chat"],
   "src/cli/commands/market.ts": ["holders","insider","research","sec"],
   "src/cli/commands/options-chain.ts": ["options","options-calculator"],
-  "src/cli/commands/options-leaps.ts": ["options","vol-surface"],
+  "src/cli/commands/options-leaps.ts": ["iv-history","options","vol-surface"],
   "src/cli/commands/overview.ts": ["correlation","econ","market-movers","sectors","world-indices"],
   "src/cli/commands/ticker.ts": ["notes"],
   "src/cli/desktop-pane-shot.ts": ["market-valuation","time-sales"],
@@ -24,21 +24,16 @@
   "src/components/command-bar/routes/root/command-items.ts": ["portfolio-list"],
   "src/components/command-bar/routes/root/help-items.ts": ["help"],
   "src/components/command-bar/routes/root/shortcut-items.ts": ["portfolio-list"],
-  "src/components/command-bar/workflow/builtin.ts": ["cloud","portfolio-list"],
-  "src/components/command-bar/workflow/collection-actions.ts": ["cloud","portfolio-list"],
+  "src/components/command-bar/workflow/builtin.ts": ["portfolio-list"],
+  "src/components/command-bar/workflow/collection-actions.ts": ["portfolio-list"],
   "src/components/command-bar/workflow/ops.ts": ["correlation","portfolio-list","ticker-detail"],
   "src/components/command-bar/workflow/tickers.ts": ["portfolio-list"],
-  "src/components/feedback-dialog.tsx": ["cloud"],
   "src/components/form-modal/routes.ts": ["portfolio-list"],
   "src/components/index.ts": ["portfolio-list"],
   "src/components/layout/shell/index.tsx": ["cloud"],
-  "src/components/layout/status-bar-groups.ts": ["cloud"],
-  "src/components/layout/status-bar.tsx": ["cloud"],
   "src/components/onboarding/use-onboarding-upgrade.ts": ["chat"],
   "src/components/onboarding/wizard-model.ts": ["portfolio-list"],
   "src/components/onboarding/wizard-positions.ts": ["portfolio-list"],
-  "src/layout-marketplace/gallery.tsx": ["cloud"],
-  "src/layout-marketplace/linked-sync.ts": ["cloud"],
   "src/layout/desks.ts": ["chart-composer"],
   "src/plugins/catalog-browser.ts": ["alerts","analytics","attention","awards","backtest","bond-calculator","catalysts","cds","central-bank-rates","changelog","chart-composer","clinical-trials","cloud","comment-letters","commodities-energy","commodity-balances","company-attention","company-kpis","connections","correlation","cot","cpi","credit-boards","credit-conditions","credit-documents","crypto-board","debt-maturities","dividend-yield","docs","doe","earnings-calls","earnings-ripple","econ","econ-statistics","equity-screener","estimate-revisions","executives","exposure","fear-greed","filing-events","fixed-income","futures","futures-curve","fx-matrix","gpu","help","insider","ipo-calendar","iv-history","jobs","jodi","kelly-sizer","layout-manager","macro-day","market-halts","market-heatmap","market-valuation","members","mna","money-markets","news","openfda","options","options-calculator","options-positioning","options-scenario","pe-band","perps","portfolio-list","power","primary-dealers","rate-path","realized-vol","relative-rotation","research","research-search","revenue-breakdown","reverse-dcf","risk-factors","scanner","seasonality","sec","sectors","short-interest","short-volume","social-mentions","supply-chain","ticker-detail","time-sales","trace-bonds","treasury-auctions","treasury-daily","vol-surface","volatility","world-indices","world-venue-map","yield-curve"],
   "src/plugins/catalog-ui.ts": ["alerts","clinical-trials","cloud","comment-letters","custom-view","fear-greed","ipo-calendar","market-halts","market-heatmap","members","news","notes","openfda","research-search"],

package/src/cli/commands/market.ts

@@ -55,18 +55,19 @@ import {
   formatOptionDeltaCell,
   formatOptionIvCell,
   formatOptionQuoteCell,
-  missingExpiryMessage,
   OPTION_MODEL_RATE,
   OPTIONS_USAGE,
   optionRows,
   optionsBasisFields,
   optionsBasisFootnote,
   parseOptionExpiration,
-  requestListedOpenInterest,
   valueChainAtModelSpot,
   type OptionsChainBasis,
 } from "./options-chain";
-import { DEFAULT_LEAPS_CRITERIA, LEAPS_USAGE, parseLeapsCriteria, runLeapsScreen, takeLeapsOptions } from "./options-leaps";
+import { missingExpiryMessage } from "../../utils/option-expiry";
+import {
+  DEFAULT_LEAPS_CRITERIA, LEAPS_EXTRA_COLUMNS, LEAPS_USAGE, parseLeapsCriteria, runLeapsScreen, takeLeapsOptions,
+} from "./options-leaps";
 import type { CliResultColumn } from "../result";
 import type { PriceHistoryResult } from "../../types/price-history";
 import {
@@ -143,7 +144,7 @@ import { formatBasisPoints, toBasisPoints } from "../../utils/basis-points";
 import { notATickerSymbol, providerMissReason } from "../../sources/provider-errors";
 import { isNotATickerMessage, withListingSuggestion } from "../not-a-ticker";
 import { describeSuggestion, suggestListing } from "../listing-suggestion";
-import { splitSymbolArgs } from "../symbol-args";
+import { splitSymbolArgs, uniqueSecuritySymbols } from "../symbol-args";
 import { cliPerpetualContract, perpetualContractStats, type PerpetualContractPayload } from "../perpetual-contract";
 import { subMinuteDataMessage } from "../known-gaps";
 import { secRegistrantMismatchMessage, SecRegistrantMismatchError, areDifferentCompanies } from "../../sources/sec-registrant";
@@ -224,9 +225,13 @@ function parseNewsFeed(value: string | undefined): NewsQuery["feed"] | undefined
   return value && VALID_NEWS_FEEDS.has(value as NewsFeed) ? value as NewsQuery["feed"] : undefined;
 }
 
-/** The symbols of a command's arguments, one each however they were separated: spaces, commas or pasted lines. */
+/**
+ * The symbols of a command's arguments, one each however they were separated
+ * (spaces, commas or pasted lines), and each security once however its case or
+ * share class was written: `AAPL aapl BRK.B BRK-B` is AAPL and BRK.B.
+ */
 function normalizeSymbols(args: string[]): string[] {
-  return splitSymbolArgs(args).map((symbol) => symbol.toUpperCase());
+  return uniqueSecuritySymbols(splitSymbolArgs(args).map((symbol) => symbol.toUpperCase()));
 }
 
 /** What JSON metadata says about the listing a command resolved. */
@@ -1472,10 +1477,9 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
   const expiration = takeOption(args, "--expiration");
   const exchangeOption = takeOption(args, "--exchange");
   if (leapsOptions.leaps) {
-    if (expiration != null || rawArgs.includes("--expiration")) {
-      ctx.fail("--leaps reads every expiry more than a year out; drop --expiration.", `Usage: gloomberb ${LEAPS_USAGE}`);
-    }
-    const criteria = parseLeapsCriteria(leapsOptions.raw);
+    // With --leaps, --expiration is a window of one expiry.
+    const expirationGiven = expiration != null || rawArgs.some((arg) => arg === "--expiration" || arg.startsWith("--expiration="));
+    const criteria = parseLeapsCriteria({ ...leapsOptions.raw, ...expirationGiven ? { "--expiration": expiration ?? "" } : {} });
     if ("error" in criteria) ctx.fail(criteria.error, `Usage: gloomberb ${LEAPS_USAGE}`);
     const symbols = normalizeSymbols(args);
     if (symbols.length === 0) ctx.fail("--leaps needs at least one symbol.", `Usage: gloomberb ${LEAPS_USAGE}`);
@@ -1505,8 +1509,6 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const quotePromise = loadListingQuote(market.dataProvider, listing);
     const fate = listingFateLoader(listing, market, quotePromise);
     const inputsPromise = loadOptionModelInputs(market.dataProvider, listing, quotePromise, refresh);
-    // OPX's listing dates the chain's open interest; asked for alongside the chain when the expiry is known.
-    const listedOpenInterest = expirationDate != null ? requestListedOpenInterest(symbol, expirationDate) : null;
     const { result, chain: loaded } = await loadForListing(listing, market, ctx, async () => {
       const cached = await market.dataProvider.getCachedQuery?.("getOptionsChain", [symbol, exchange, expirationDate, undefined])
         .load({ force: refresh });
@@ -1539,7 +1541,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     // IV and delta are valued at one spot and instant, named under the table and on every exported row.
     const { chain, spot: modelSpot } = valueChainAtModelSpot(loaded, inputs, Date.now(), identity.exchange);
     const basis: OptionsChainBasis = { spot: modelSpot, dividendYield: inputs.dividendYield ?? null,
-      openInterest: await loadOptionsChainOpenInterest(symbol, chain, listedOpenInterest) };
+      openInterest: await loadOptionsChainOpenInterest(symbol, chain) };
     const basisFields = optionsBasisFields(basis);
     const currency = [...chain.calls, ...chain.puts].find((contract) => contract.currency?.trim())?.currency.trim().toUpperCase()
       ?? quote?.currency ?? null;
@@ -1815,10 +1817,10 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
       options: [
         {
           flags: "--expiration <YYYY-MM-DD|unix>",
-          description: "Expiration as a date (2028-01-21) or Unix seconds; defaults to the nearest one, and lists the others",
+          description: "Expiration as a date (2028-01-21) or Unix seconds; defaults to the nearest one, and lists the others. With --leaps: rank that expiry alone",
         },
         EXCHANGE_OPTION,
-        { flags: "--leaps", description: "Rank contracts more than a year out across the symbols given, as a stock replacement" },
+        { flags: "--leaps", description: "Rank long-dated contracts across the symbols given, as a stock replacement; more than a year out unless a window says otherwise" },
         { flags: "--side <calls|puts>", description: `With --leaps: the side to rank (default ${DEFAULT_LEAPS_CRITERIA.side}s)` },
         {
           flags: "--delta <low-high>",
@@ -1829,6 +1831,17 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
           description: `With --leaps: widest bid/ask spread, in percent of the midpoint (default ${DEFAULT_LEAPS_CRITERIA.maxSpreadPercent})`,
         },
         { flags: "--min-oi <contracts>", description: `With --leaps: least open interest (default ${DEFAULT_LEAPS_CRITERIA.minOpenInterest})` },
+        {
+          flags: "--min-days <days>",
+          description: `With --leaps: fewest calendar days to expiry (default ${DEFAULT_LEAPS_CRITERIA.minDays}); 180 reaches six months out`,
+        },
+        { flags: "--max-days <days>", description: "With --leaps: most calendar days to expiry; --min-days 365 --max-days 730 is 12 to 24 months" },
+        { flags: "--expiry-from <YYYY-MM-DD>", description: "With --leaps: first expiry date kept; replaces the one-year floor" },
+        { flags: "--expiry-to <YYYY-MM-DD>", description: "With --leaps: last expiry date kept" },
+        {
+          flags: "--columns <list>",
+          description: `With --leaps: add figures, comma-separated: ${LEAPS_EXTRA_COLUMNS.join(", ")}`,
+        },
         {
           flags: "--sort <order>",
           description: "With --leaps: carry (extrinsic per year, lowest first; the default), spread, oi, delta, expiry or symbol",
@@ -1837,7 +1850,10 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
       sections: [{
         title: "LEAPS",
         lines: [
-          "--leaps reads every expiry more than a year out for each symbol and keeps the liquid contracts in the delta band, ranked by extrinsic per year: time value (midpoint less intrinsic) as a percent of spot, per year to expiry.",
+          "--leaps reads each symbol's expiries in the window and keeps the liquid contracts in the delta band, ranked by extrinsic per year: time value (midpoint less intrinsic) as a percent of spot, per year to expiry.",
+          "--min-days, --max-days, --expiry-from and --expiry-to set the window together; without a lower bound it starts a year out. Each symbol reads at most 8 expiries, the ones nearest the window's start, and a warning names any it left.",
+          "--columns adds iv (the contract's implied vol), ivr (the underlying's IV rank), cost (midpoint x 100 per contract), breakeven (at the midpoint, and its distance from spot), next-earnings, ex-dividend and carry-net "
+            + `(extrinsic per year net of the ${Number((OPTION_MODEL_RATE * 100).toFixed(2))}% rate on the strike and the dividend yield). A figure a symbol lacks is blank, with a warning.`,
           "A symbol without LEAPS, a quote or a chain is named in a warning and the others still rank. docs/research-data.md defines each figure.",
         ],
       }],
@@ -1847,6 +1863,8 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
         "options AAPL:NASDAQ --json",
         "options AAPL MSFT NVDA GOOGL AMZN META --leaps",
         "options SPY QQQ --leaps --side puts --delta 0.20-0.40 --csv",
+        "options MSFT --leaps --min-days 365 --max-days 730",
+        "options AAPL MSFT NVDA --leaps --min-days 180 --columns iv,ivr,cost,breakeven,carry-net",
       ],
     },
     execute: runOptions,

package/src/cli/commands/options-chain.ts

@@ -1,4 +1,4 @@
-import type { OptionContract, OptionsChain, Quote } from "../../types/financials";
+import type { OptionContract, OptionsChain, Quote, TickerFinancials } from "../../types/financials";
 import type { DataProvider } from "../../types/data-provider";
 import type { CliListing } from "../listing-arg";
 import { cliStyles, cliTerminalWidth, wrapText } from "../../utils/cli-output";
@@ -9,10 +9,10 @@ import {
   formatModelSpotPrice, modelSpotLabel, optionModelSpot, type OptionModelSpot,
 } from "../../plugins/builtin/options/model-spot";
 import {
-  chainOpenInterestAsOf, loadListedOpenInterest, openInterestAsOfLabel, type OpenInterestAsOf,
+  chainOpenInterestAsOf, loadListedOpenInterest, openInterestAsOfLabel, type OpenInterestAsOf, statedOpenInterestAsOf,
 } from "../../plugins/builtin/options/open-interest-as-of";
 import { DEFAULT_OPTION_CALC_DRAFT } from "../../plugins/builtin/options-calculator/model";
-import { expiryIsoDate, missingExpiryText, parseOptionExpiration } from "../../utils/option-expiry";
+import { expiryIsoDate, parseOptionExpiration } from "../../utils/option-expiry";
 
 export const OPTIONS_USAGE = "options <symbol> [--expiration <YYYY-MM-DD|unix>]";
 
@@ -29,22 +29,6 @@ function listedDates(expirations: readonly number[]): string[] {
   return [...new Set(expirations.map((expiration) => expiryIsoDate(expiration)).filter(Boolean))].sort();
 }
 
-/**
- * Why a chain request for one expiry came back without contracts, and which
- * expiries it could have been: the few nearest the requested date, so a typo or
- * an unlisted LEAPS date points at the neighbours to pick.
- */
-export function missingExpiryMessage(
-  symbol: string,
-  requested: number,
-  expirations: readonly number[],
-): { message: string; details?: string } {
-  return {
-    message: missingExpiryText(requested, expirations, symbol),
-    details: `Run gloomberb options ${symbol} to list every expiry (--json carries them too).`,
-  };
-}
-
 const EXPIRY_LIST_LIMIT = 40;
 const EXPIRY_LIST_WIDTH = 100;
 const EXPIRY_GAP = 2;
@@ -113,16 +97,30 @@ function optionModelFigures(chain: OptionsChain, inputs: OptionModelInputs): Map
   return figures;
 }
 
-/** Spot and dividend yield for IV and delta, read from the underlying the way the options pane does; missing ones stay missing. */
+/** The underlying's financials, as DES reads them: its dividend yield, ex-dividend date and next report. Null when they cannot be read. */
+export function loadUnderlyingFinancials(
+  dataProvider: Pick<DataProvider, "getTickerFinancials">,
+  listing: CliListing,
+  refresh: boolean,
+): Promise<TickerFinancials | null> {
+  return Promise.resolve().then(() => dataProvider.getTickerFinancials(
+    listing.request.symbol, listing.request.exchange, { cacheMode: refresh ? "refresh" : "default" },
+  )).catch(() => null);
+}
+
+/**
+ * Spot and dividend yield for IV and delta, read from the underlying the way the
+ * options pane does; missing ones stay missing. `financials` shares one read of
+ * them with a caller that needs more of them.
+ */
 export async function loadOptionModelInputs(
   dataProvider: Pick<DataProvider, "getTickerFinancials">,
   listing: CliListing,
   quote: Promise<Quote | null>,
   refresh: boolean,
+  underlying: Promise<TickerFinancials | null> = loadUnderlyingFinancials(dataProvider, listing, refresh),
 ): Promise<OptionModelInputs> {
-  const financials = await Promise.resolve().then(() => dataProvider.getTickerFinancials(
-    listing.request.symbol, listing.request.exchange, { cacheMode: refresh ? "refresh" : "default" },
-  )).catch(() => null);
+  const financials = await underlying;
   const current = [await quote, financials?.quote]
     .find((candidate) => candidate && candidate.stale !== true && isFiniteNumber(candidate.price) && candidate.price > 0);
   const dividendYield = financials?.fundamentals?.dividendYield;
@@ -161,21 +159,19 @@ export function valueChainAtModelSpot(
   };
 }
 
-/** The open-interest date of the chain's expiry, from OPX's listing of it; null when the listing cannot be read. */
-export async function loadOptionsChainOpenInterest(
-  symbol: string, chain: OptionsChain, listed?: ReturnType<typeof loadListedOpenInterest> | null,
-): Promise<OpenInterestAsOf | null> {
+/**
+ * The open-interest date of the chain's expiry: the chain's own, else (a chain
+ * that does not say) from OPX's listing of it; null when the listing cannot be read.
+ */
+export async function loadOptionsChainOpenInterest(symbol: string, chain: OptionsChain): Promise<OpenInterestAsOf | null> {
+  const stated = statedOpenInterestAsOf(chain);
+  if (stated) return stated;
   const expiration = [...chain.calls, ...chain.puts][0]?.expiration;
   if (expiration == null) return null;
-  const payload = await (listed ?? loadListedOpenInterest(symbol, expiryIsoDate(expiration)));
+  const payload = await loadListedOpenInterest(symbol, expiryIsoDate(expiration));
   return payload ? chainOpenInterestAsOf(chain, payload) : null;
 }
 
-/** OPX's listing of an expiry, requested while the chain loads. */
-export function requestListedOpenInterest(symbol: string, expiration: number) {
-  return loadListedOpenInterest(symbol, expiryIsoDate(expiration));
-}
-
 /**
  * The line under the chain: `Greeks at spot 89.79 (close Mon 12 Oct 20:00 UTC), dividend yield 2.34%, rate 4% · OI as of Fri 9 Oct`.
  * An open interest whose date cannot be established says why.