gloomberb 0.16.4 → 0.16.6

package/src/plugins/builtin/news/wire/news/detail-view.tsx

@@ -1,11 +1,9 @@
-import { Box, ScrollBox, Text, useRendererHost, useUiCapabilities } from "../../../../../ui";
-import { TextAttributes, type ScrollBoxRenderable } from "../../../../../ui";
-import { useShortcut } from "../../../../../react/input";
-import { scrollByLines } from "../../../../../state/pane-scroll-registry";
+import { Box, Text, useRendererHost, useUiCapabilities } from "../../../../../ui";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import type { MarketNewsItem, NewsStoryItem } from "../../../../../types/news-source";
 import { colors } from "../../../../../theme/colors";
-import { InlineTickerBadge } from "../../../../../components/ticker/badge";
+import { ArticleReader } from "../../../../../components/reader/article-reader";
+import type { ArticleBlock } from "../../../../../components/reader/article-text";
 import { ChoiceDialog, ExternalLinkText } from "../../../../../components/ui";
 import { usePaneFooter } from "../../../../../components/layout/pane/footer";
 import { t } from "../../../../../i18n";
@@ -14,7 +12,6 @@ import { useOpenTickerChoice } from "../../../shared/ticker-choice";
 import { collectNewsDisplayTickers } from "../../../../../news/ticker-symbols";
 import { useInlineTickers } from "../../../../../state/hooks/inline-tickers";
 import { truncateToDisplayWidth } from "../../../../../utils/format";
-import { isPlainKey } from "../../../../../utils/keyboard";
 import { wrapTextLines } from "../../../../../utils/text-wrap";
 import { formatDetailDate } from "../../../../../utils/datetime-format";
 import { mergeNewsArticle } from "../../../../../news/news-model";
@@ -151,6 +148,8 @@ function sortStoryItems(items: readonly NewsStoryItem[] | undefined): NewsStoryI
 }
 
 const NATIVE_STRETCH_STYLE = { minWidth: 0 };
+/** A story is its summary and its coverage: the reader has no article text for it. */
+const NO_BODY: ArticleBlock[] = [];
 const NATIVE_TEXT_STYLE = { display: "block" };
 
 function TextLines({
@@ -182,16 +181,29 @@ function TextLines({
   ));
 }
 
+/** The time alone on the story's own day, which the header already dates; the date otherwise. */
+function coverageTime(value: Date, storyDay: Date): string {
+  return value.toDateString() === storyDay.toDateString()
+    ? value.toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" })
+    : formatDetailDate(value);
+}
+
 function NewsStoryTimelineItemView({
   item,
+  storyTitle,
+  storyDay,
   width,
   nativePaneChrome,
 }: {
   item: NewsStoryItem;
+  /** An outlet's headline that is the story's own is not printed again. */
+  storyTitle: string;
+  storyDay: Date;
   width: number;
   nativePaneChrome: boolean;
 }) {
-  const time = formatDetailDate(storyItemDate(item.publishedAt));
+  const time = coverageTime(storyItemDate(item.publishedAt), storyDay);
+  const title = item.title.trim() === storyTitle.trim() ? "" : item.title;
   const summary = item.summary && item.summary.trim() !== item.title.trim() ? item.summary : "";
   const source = item.sourceName || item.sourceKey;
   const contentWidth = Math.max(10, width - 2);
@@ -204,7 +216,7 @@ function NewsStoryTimelineItemView({
         <ExternalLinkText url={item.url} label={sourceLabel} color={colors.textBright} />
       </Box>
       <Box flexDirection="column" paddingLeft={2} width={nativePaneChrome ? "100%" : undefined} style={nativePaneChrome ? NATIVE_STRETCH_STYLE : undefined}>
-        <TextLines text={item.title} width={contentWidth} color={colors.text} nativePaneChrome={nativePaneChrome} />
+        <TextLines text={title} width={contentWidth} color={colors.text} nativePaneChrome={nativePaneChrome} />
         <TextLines text={summary} width={contentWidth} color={colors.textDim} nativePaneChrome={nativePaneChrome} />
       </Box>
     </Box>
@@ -215,31 +227,25 @@ export function NewsDetailView({ item, focused, width, showTitle = true }: {
   item: MarketNewsItem;
   focused: boolean;
   width: number;
+  /** Off where the pane's own title is the headline, as in a story popped out to its own pane. */
   showTitle?: boolean;
 }) {
-  const scrollRef = useRef<ScrollBoxRenderable>(null);
   const { nativePaneChrome } = useUiCapabilities();
-
-  const innerW = Math.max(10, Math.floor(width) - 2);
-  const contentWidth = nativePaneChrome ? "100%" : innerW;
-  const contentStyle = nativePaneChrome ? NATIVE_STRETCH_STYLE : undefined;
   const tickers = useMemo(
     () => collectNewsDisplayTickers(item.tickers),
     [item.tickers],
   );
   const tickerTexts = useMemo(() => tickers.map((ticker) => `$${ticker}`), [tickers]);
-  const { catalog, openTicker } = useInlineTickers(tickerTexts, { badgeQuotes: true });
-  const [hoveredTicker, setHoveredTicker] = useState<string | null>(null);
+  const { catalog } = useInlineTickers(tickerTexts, { badgeQuotes: true });
   const timelineItems = useMemo(() => sortStoryItems(item.items), [item.items]);
   const categoryLabels = useMemo(
-    () => item.categories.map(formatNewsCategory).filter(Boolean).join(" · "),
+    () => item.categories.map(formatNewsCategory).filter(Boolean).join(" \u00b7 "),
     [item.categories],
   );
   const lastUpdatedAt = new Date(Math.max(
     storyItemDate(item.publishedAt).getTime(),
     storyItemDate(timelineItems[0]?.publishedAt ?? item.publishedAt).getTime(),
   ));
-  const lastUpdatedStr = formatDetailDate(lastUpdatedAt);
 
   // The badges and outlet links, for the keyboard: [t]icker opens a mentioned
   // company, [s]ources picks another outlet's coverage to read.
@@ -285,95 +291,38 @@ export function NewsDetailView({ item, focused, width, showTitle = true }: {
     ],
   }), [chooseSource, dialog, hasOtherCoverage, openTickerChoice, openableTickers]);
 
-  useEffect(() => {
-    const scrollBox = scrollRef.current;
-    if (scrollBox) scrollBox.scrollTop = 0;
-  }, [item.id]);
-
-  useShortcut((event) => {
-    if (!focused) return;
-    const delta = isPlainKey(event, "j", "down") ? 1 : isPlainKey(event, "k", "up") ? -1 : 0;
-    if (!delta) return;
-    event.stopPropagation();
-    event.preventDefault();
-    if (scrollRef.current) scrollByLines(scrollRef.current, delta);
-  });
+  // One outlet's own headline is the story's: the timeline is worth its rows
+  // once a second outlet has written about it.
+  const showTimeline = timelineItems.length > 1 || (timelineItems.length === 1 && timelineItems[0]!.title.trim() !== item.title.trim());
+  const coverageWidth = Math.max(20, Math.min(72, Math.floor(width) - 6));
 
   return (
-    <Box flexDirection="column" width={nativePaneChrome ? "100%" : width} flexGrow={1} flexBasis={0} minHeight={0} overflow="hidden">
-      <ScrollBox ref={scrollRef} flexGrow={1} flexBasis={0} minHeight={0} scrollY focusable={false}>
-        <Box flexDirection="column" paddingX={1} paddingY={1} gap={1} width={nativePaneChrome ? "100%" : undefined} style={contentStyle}>
-          {showTitle && (
-            <Box flexDirection="column">
-              <TextLines
-                text={item.title}
-                width={innerW}
-                color={colors.textBright}
-                attributes={TextAttributes.BOLD}
-                nativePaneChrome={nativePaneChrome === true}
-              />
-            </Box>
-          )}
-          {/* The source is the footer's [o]pen link; without a link the footer has no source, so it stays here. */}
-          <Box height={nativePaneChrome ? undefined : 1} flexDirection="row">
-            <Text fg={colors.textDim} wrapText={nativePaneChrome}>
-              {`${item.url?.trim() || !item.source ? "" : `${item.source} · `}Last updated ${lastUpdatedStr} · score ${item.importance}/100`}
-            </Text>
-          </Box>
-          <TextLines text={item.summary} width={innerW} color={colors.text} nativePaneChrome={nativePaneChrome === true} />
-          {tickers.length > 0 && (
-            <Box flexDirection="row" flexWrap="wrap" width={contentWidth} style={contentStyle}>
-              {tickers.map((ticker) => {
-                const entry = catalog[ticker];
-                if (!entry || entry.status === "missing") {
-                  return (
-                    <Box key={ticker} paddingRight={1}>
-                      <Text fg={colors.textBright} attributes={TextAttributes.BOLD}>
-                        {ticker}
-                      </Text>
-                    </Box>
-                  );
-                }
-
-                return (
-                  <InlineTickerBadge
-                    key={ticker}
-                    symbol={ticker}
-                    entry={entry}
-                    hovered={hoveredTicker === ticker}
-                    onHoverStart={() => setHoveredTicker(ticker)}
-                    onHoverEnd={() => {
-                      setHoveredTicker((current) => (current === ticker ? null : current));
-                    }}
-                    onOpen={openTicker}
-                  />
-                );
-              })}
-            </Box>
-          )}
-          {item.categories.length > 0 && (
-            nativePaneChrome ? (
-              <TextLines text={categoryLabels} width={innerW} color={colors.textMuted} nativePaneChrome />
-            ) : (
-              <Box height={1} flexDirection="row">
-                <Text fg={colors.textMuted}>{categoryLabels}</Text>
-              </Box>
-            )
-          )}
-          {timelineItems.length > 0 && (
-            <Box flexDirection="column" gap={1} width={contentWidth} style={contentStyle}>
-              {timelineItems.map((timelineItem) => (
-                <NewsStoryTimelineItemView
-                  key={timelineItem.id}
-                  item={timelineItem}
-                  width={innerW}
-                  nativePaneChrome={nativePaneChrome === true}
-                />
-              ))}
-            </Box>
-          )}
+    <ArticleReader
+      articleKey={item.id}
+      title={showTitle ? item.title : null}
+      meta={[item.source, formatDetailDate(lastUpdatedAt), categoryLabels]}
+      tickers={tickers}
+      lead={item.summary}
+      body={NO_BODY}
+      focused={focused}
+      width={width}
+      height={0}
+      childrenLabel={showTimeline ? "Coverage" : undefined}
+    >
+      {showTimeline && (
+        <Box flexDirection="column" gap={1} width={nativePaneChrome ? "100%" : coverageWidth} style={nativePaneChrome ? NATIVE_STRETCH_STYLE : undefined}>
+          {timelineItems.map((timelineItem) => (
+            <NewsStoryTimelineItemView
+              key={timelineItem.id}
+              item={timelineItem}
+              storyTitle={item.title}
+              storyDay={lastUpdatedAt}
+              width={coverageWidth}
+              nativePaneChrome={nativePaneChrome === true}
+            />
+          ))}
         </Box>
-      </ScrollBox>
-    </Box>
+      )}
+    </ArticleReader>
   );
 }

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

@@ -1,15 +1,10 @@
-import { useCallback, useMemo } from "react";
+import { useMemo } from "react";
 import type { PaneFooterSegment } from "../../../../../components";
 import { t, tf } from "../../../../../i18n";
 import { useAppLanguage } from "../../../../../i18n/react";
-import { useShortcut } from "../../../../../react/input";
-import { useUiCapabilities } from "../../../../../ui";
-import { isPlainKey } from "../../../../../utils/keyboard";
 import { useCloudAccessFooter } from "../../../shared/cloud-upgrade";
 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 {
@@ -38,21 +33,6 @@ export function useNewsArticleFooter({
   onPopOut,
 }: UseNewsArticleFooterOptions) {
   const language = useAppLanguage();
-  const { publicSharing } = useUiCapabilities();
-  const { sharePane } = usePluginAppActions();
-  const paneInstanceId = useOptionalPaneInstanceId();
-  // The open story is pane state, so sharing the pane shares the story: the
-  // receiver's terminal opens on the same article.
-  const shareArticle = useCallback(() => {
-    if (!article?.title || !paneInstanceId) return;
-    sharePane(paneInstanceId);
-  }, [article?.title, paneInstanceId, sharePane]);
-  useShortcut((event) => {
-    if (!focused || !publicSharing || !article?.title || !isPlainKey(event, "y")) return;
-    event.preventDefault();
-    event.stopPropagation();
-    shareArticle();
-  });
   const { access, hint: upgradeHint, segment } = useCloudAccessFooter({
     delayLabel: tf("{count}h", { count: CLOUD_NEWS_DELAY_HOURS }),
     focused,
@@ -78,18 +58,15 @@ export function useNewsArticleFooter({
   }, [access.isPayingPro, language, segment]);
   const footerInfo = useMemo(() => [...accessInfo, ...(info ?? [])], [accessInfo, info]);
 
+  // The story's header names its source, so the footer keeps to the link.
   usePaneStatusLinkFooter({
     registrationId,
     focused,
     url: article?.url,
-    source: article?.source,
     info: footerInfo,
     // [o]pen is appended after these, so the story's own actions stay rightmost.
     hints: [
       ...(upgradeHint ? [upgradeHint] : []),
-      ...(publicSharing && article?.title && paneInstanceId
-        ? [{ id: "share", key: "y", label: " share", onPress: shareArticle }]
-        : []),
       ...(onPopOut ? [{ id: "pop-out", key: "p", label: "op out", onPress: onPopOut }] : []),
     ],
     showOpenHint: true,

package/src/plugins/builtin/news/wire/news/preset-pane.tsx

@@ -115,12 +115,10 @@ export function useNewsArticleStack({
         item={detailArticle}
         focused={listFocused}
         width={width}
-        showTitle={false}
       />
     ) : (
       <Box flexGrow={1} />
     ),
-    detailTitle: detailArticle?.title,
     search: searchBar,
     searchQuery: search.searchQuery,
   };

package/src/plugins/builtin/notes/cli.ts

@@ -3,7 +3,7 @@ import { withCliServices, withConfigData } from "../../../cli/scoped-context";
 import { CLI_COMMAND_GROUPS } from "../../../cli/help";
 import { dryRunNote } from "../../../cli/helpers";
 import { requireArg, takeOption } from "../../../cli/commands/command-utils";
-import { EXCHANGE_OPTION, requireListingArg } from "../../../cli/listing-arg";
+import { EXCHANGE_OPTION, listingReadNotes, requireListingArg } from "../../../cli/listing-arg";
 import { createPluginPersistence } from "../../plugin-persistence";
 import type { CliCommandDef } from "../../../types/plugin";
 import { cliStyles } from "../../../utils/cli-output";
@@ -25,9 +25,14 @@ export const notesCliCommand: CliCommandDef = {
     const args = [...rawArgs];
     const exchange = takeOption(args, "--exchange");
     // A note belongs to one listing: SAN:EPA, or SAN with --exchange EPA.
-    const noteSymbol = async (usage: string) => (
-      await requireListingArg(requireArg(args[1], usage, ctx), exchange, ctx)
-    ).key;
+    // What a typed listing was read as (7203:TSE as 7203:JPX) is said beside the note.
+    let read: { warnings?: string[] } = {};
+    const noteSymbol = async (usage: string) => {
+      const listing = await requireListingArg(requireArg(args[1], usage, ctx), exchange, ctx);
+      const notes = listingReadNotes(listing);
+      if (notes.length > 0) read = { warnings: notes };
+      return listing.key;
+    };
     await withConfigData(ctx, async (config) => {
       const notes = new NotesFiles(config.dataDir);
       const action = args[0] ?? "list";
@@ -71,7 +76,7 @@ export const notesCliCommand: CliCommandDef = {
       }
       if (action === "show") {
         const symbol = await noteSymbol("Usage: gloomberb notes show <symbol>");
-        ctx.printResult({ data: { symbol, text: await notes.load(symbol) } }, {
+        ctx.printResult({ data: { symbol, text: await notes.load(symbol) }, ...read }, {
           text: (data) => data.text?.trim() ? data.text.trimEnd() : cliStyles.muted(`No note for ${symbol}.`),
         });
         return;
@@ -80,7 +85,7 @@ export const notesCliCommand: CliCommandDef = {
         const symbol = await noteSymbol("Usage: gloomberb notes set <symbol> <text...>");
         const text = args.slice(2).join(" ");
         if (!ctx.cliOptions.dryRun) await notes.save(symbol, text);
-        ctx.printResult({ data: { changed: !ctx.cliOptions.dryRun, dryRun: ctx.cliOptions.dryRun, symbol, bytes: text.length } }, {
+        ctx.printResult({ data: { changed: !ctx.cliOptions.dryRun, dryRun: ctx.cliOptions.dryRun, symbol, bytes: text.length }, ...read }, {
           text: (data) => `Saved the note for ${symbol}.${dryRunNote(data.dryRun)}`,
         });
         return;
@@ -90,7 +95,7 @@ export const notesCliCommand: CliCommandDef = {
         // Only picks the message; an unreadable note is still deleted.
         const existed = await notes.load(symbol).then((text) => !!text?.trim(), () => true);
         if (!ctx.cliOptions.dryRun) await notes.delete(symbol);
-        ctx.printResult({ data: { changed: !ctx.cliOptions.dryRun, dryRun: ctx.cliOptions.dryRun, symbol } }, {
+        ctx.printResult({ data: { changed: !ctx.cliOptions.dryRun, dryRun: ctx.cliOptions.dryRun, symbol }, ...read }, {
           text: (data) => existed
             ? `Deleted the note for ${symbol}.${dryRunNote(data.dryRun)}`
             : cliStyles.muted(`No note for ${symbol}.`),

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

@@ -81,6 +81,7 @@ export const notesPlugin: GloomPlugin = {
       id: "quick-notes",
       reportFreshness: { source: "Your notes", status: "not-a-feed", basis: "your notes" },
       name: "Notes",
+      personalData: "messages",
       icon: "N",
       component: QuickNotesPane,
       defaultPosition: "right",

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

@@ -1,5 +1,6 @@
 import type { PaneReportOptionDef, PaneSettingsDef, TickerResearchTabProps } from "../../../types/plugin";
 import type { PluginModule } from "../plugin-module";
+import { holdsActiveTicker } from "../../../shares/pane-image";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import type { OptionsViewProps } from "./types";
 import { OptionsView } from "./view";
@@ -99,6 +100,8 @@ export const optionsModule: PluginModule = {
       component: OptionsPane,
       defaultPosition: "right",
       tickerFollower: true,
+      // An option the person holds shows their position.
+      personalData: (context) => (holdsActiveTicker(context) ? "holdings" : null),
       defaultMode: "floating",
       defaultFloatingSize: { width: 112, height: 28 },
       quickSettings: [LIVE_STREAMING_QUICK_SETTING],

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

@@ -60,7 +60,7 @@ import {
 import { useOptionsAccessFooter } from "./footer";
 import { AnalyticsAsOfDialog, analyticsAsOfRows } from "./analytics-as-of";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
-import { signedPositionDirection } from "../portfolio-list/position-metrics";
+import { signedPositionDirection } from "../../../portfolio/position-metrics";
 import { optionMarketReference } from "./market-reference";
 import { useOptionsEnrichment } from "./enrichment";
 import type { OptionsEnrichmentSnapshot } from "./enrichment-model";

package/src/plugins/builtin/options-calculator/inputs.ts

@@ -1,3 +1,4 @@
+import { numberErrorMessage } from "../../../utils/decimal-comma";
 import { DEFAULT_OPTION_CALC_DRAFT, updateOptionCalcDraft, type OptionCalcDraft } from "./model";
 import type { CashDividend } from "./binomial";
 
@@ -5,7 +6,7 @@ const DECIMAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
 
 function numberInput(value: unknown, label: string): number {
   if (typeof value !== "number" && (typeof value !== "string" || !DECIMAL.test(value.trim()))) {
-    throw new Error(`${label} must be a finite number.`);
+    throw new Error(numberErrorMessage(`${label} must be a finite number.`, value));
   }
   const result = Number(value);
   if (!Number.isFinite(result)) throw new Error(`${label} must be a finite number.`);

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

@@ -1,5 +1,5 @@
 import { apiClient } from "../../../api-client";
-import { parsePublicTickerKey } from "../../../utils/exchanges";
+import { usListingSymbol } from "../../../utils/sec";
 
 export interface ExpiryOpenInterest {
   date: string;
@@ -78,8 +78,12 @@ export interface GammaPayload {
 
 export type OptionsPositioningApi = Pick<typeof apiClient, "optionsPositioning">;
 
-/** A listing key ("SPY:ARCX") keeps only its symbol; an index keeps its caret (^SPX). */
-export const positioningSymbol = (symbol: string) => parsePublicTickerKey(symbol.trim()).symbol.toUpperCase();
+/**
+ * A US listing key ("SPY:ARCX") keeps only its symbol; an index keeps its
+ * caret (^SPX). A listing abroad is refused: its bare symbol's chain is
+ * another company's (SAN:EPA's would be Banco Santander's).
+ */
+export const positioningSymbol = (symbol: string) => usListingSymbol(symbol, "Options data");
 
 const query = (symbol: string, expiry: string | null) =>
   new URLSearchParams({ symbol: positioningSymbol(symbol), ...(expiry ? { expiry } : {}) }).toString();

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

@@ -26,15 +26,16 @@ export const optionsPositioningHeadless = (initialTab: PositioningTab): Headless
   shape: "bundle",
   freshness: { status: "not-a-feed", basis: "daily open interest", cadence: "daily" },
   argument: { kind: "ticker", optional: true, description: "US option underlying, or SPX; SPY when omitted" },
+  usListingsOnly: "Options data",
   describe: (args) => `${initialTab === "gex" ? "GEX" : "OPX"} ${args.symbols[0] ?? "SPY"}`,
   discovery: {
     aliases: initialTab === "gex" ? ["GEX"] : ["OPX", "MAXPAIN"],
     screenshotReadiness: "live-dom",
     dataRequirements: ["Cloud listed open interest", "Option chains"],
     limitations: [
-      "Open interest is as of the prior session's close",
-      "Dealer gamma assumes dealers are long every call and short every put",
-      "NDX and RUT index options are not covered; use QQQ and IWM",
+      "Open interest is as of the prior session's close.",
+      "Dealer gamma assumes dealers are long every call and short every put.",
+      "NDX and RUT index options are not covered; use QQQ and IWM.",
     ],
   },
   options: [

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

@@ -34,13 +34,13 @@ import type { ResolvedSeries } from "../../../time-series/types";
 import type { PaneProps } from "../../../types/plugin";
 import { Box, Text } from "../../../ui";
 import { formatCompact } from "../../../utils/format";
+import { parsePublicTickerKey } from "../../../utils/exchanges";
 import { isPlainKey } from "../../../utils/keyboard";
 import { nextHeaderSort, type SortDirection } from "../../../utils/sort-values";
 import { useCloudAccessFooter } from "../shared/cloud-upgrade";
 import {
   loadGamma,
   loadOpenInterest,
-  positioningSymbol,
   type ExpiryOpenInterest,
   type GammaPayload,
   type GammaStrike,
@@ -583,7 +583,7 @@ function OptionsPositioningView({ width, height, focused, symbol }: PaneProps &
   return <Box width={width} height={height} flexDirection="column">
     <PaneStatusBody loading={openInterest.loading && !data} error={!data ? openInterest.error : null}
       empty={!!data && !data.expiries.length} subject="open interest"
-      emptyTitle={`No listed options for ${positioningSymbol(symbol).replace(/^\^/, "")}.`}>
+      emptyTitle={`No listed options for ${parsePublicTickerKey(symbol).symbol.replace(/^\^/, "")}.`}>
       {data?.expiries.length ? <>
         {tabStrip}
         {content}

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

@@ -5,6 +5,7 @@ import type { QueryEntry } from "../../../market-data/result-types";
 import type { DataProvider } from "../../../types/data-provider";
 import type { OptionsChain, Quote, TickerFinancials } from "../../../types/financials";
 import { canonicalExchange, parsePublicTickerKey } from "../../../utils/exchanges";
+import { numberErrorMessage } from "../../../utils/decimal-comma";
 import { expiryIsoDate, findListedExpiry, missingExpiryText } from "../../../utils/option-expiry";
 import { surfaceTreasuryRate } from "../vol-surface/model";
 import { daysToExpiryFrom, extractImpliedForward, optionMid, solveImpliedVolatility } from "../shared/volatility";
@@ -159,7 +160,7 @@ function numericSetting(settings: Record<string, unknown>, key: string): number
   if (!supplied(value)) return undefined;
   if ((typeof value !== "string" && typeof value !== "number")
     || (typeof value === "string" && !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/.test(value.trim()))
-    || !Number.isFinite(Number(value))) throw new Error(`${key} must be a finite number`);
+    || !Number.isFinite(Number(value))) throw new Error(numberErrorMessage(`${key} must be a finite number`, value));
   return Number(value);
 }
 

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

@@ -29,6 +29,7 @@ const VALUATION_LABELS: Record<string, (currency: string) => string> = {
 
 export const optionsScenarioHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle", argument: { kind: "ticker", description: "Underlying ticker" },
+  usListingsOnly: "Options data",
   describe: (args) => `OSA ${args.symbols[0] ?? ""}`,
   description: "A typed or chain-seeded options position valued across spot, date and volatility: its legs, value and Greeks, expiry risk and a "
     + "scenario P&L grid. With --nav and --budget-bps, how many contracts a hedge budget buys, the premium spent, the notional protected and "

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

@@ -1,6 +1,7 @@
 import type { StatItem } from "../../../components";
 import type { OptionsChain } from "../../../types/financials";
 import type { HeadlessPaneEntry } from "../../../types/headless";
+import { numberErrorMessage } from "../../../utils/decimal-comma";
 import { formatCompact } from "../../../utils/format";
 import { UNKNOWN_CURRENCY, type ScenarioPosition } from "./model";
 
@@ -82,7 +83,7 @@ export function parseHedgeAmount(value: unknown, flag: string): number {
 function parseBudgetBps(value: unknown): number {
   const text = typeof value === "number" ? String(value) : typeof value === "string" ? value.trim() : "";
   const bps = /^-?(?:\d+(?:\.\d+)?|\.\d+)$/.test(text) ? Number(text) : Number.NaN;
-  if (!Number.isFinite(bps)) throw new Error(`--budget-bps must be a number of basis points, such as 50 for 0.5% of NAV; got "${text}".`);
+  if (!Number.isFinite(bps)) throw new Error(numberErrorMessage(`--budget-bps must be a number of basis points, such as 50 for 0.5% of NAV; got "${text}".`, text));
   if (!(bps > 0)) throw new Error("--budget-bps must be greater than zero.");
   if (bps > 10_000) throw new Error("--budget-bps must be at most 10,000 (all of NAV).");
   return bps;