gloomberb 0.16.2 → 0.16.4

package/src/plugins/builtin/risk-factors/headless.ts

@@ -1,6 +1,7 @@
 import type { HeadlessBundleSection, HeadlessPaneDefinition } from "../../../types/plugin";
 import { loadRiskReportWithClient, loadRiskReportsWithClient, type RiskReportsResult } from "./data";
 import { SEC_FILINGS } from "../shared/report-freshness";
+import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
 
 export const riskFactorsHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
@@ -16,9 +17,11 @@ export const riskFactorsHeadless: HeadlessPaneDefinition<"bundle"> = {
     const selection = String(args.options.year ?? "latest").trim().toLowerCase();
     if (selection !== "latest" && !/^\d{4}$/.test(selection)) throw new Error("Risk report year must be a four-digit filing year or latest.");
     const force = args.options.refresh === true;
+    // A listing abroad names its venue and company, so it never reads a US namesake's reports.
+    const listing = await resolveHeadlessIssuerListing(context, ticker);
     // A specific immutable filing does not depend on the latest discovery list.
     let list: RiskReportsResult | null = null;
-    if (selection === "latest") list = await loadRiskReportsWithClient(context.apiClient, ticker, { force });
+    if (selection === "latest") list = await loadRiskReportsWithClient(context.apiClient, ticker, { force, listing });
     const year = list
       ? [...list.reports].sort((a, b) => b.reportYear - a.reportYear)[0]?.reportYear
       : Number(selection);
@@ -27,7 +30,7 @@ export const riskFactorsHeadless: HeadlessPaneDefinition<"bundle"> = {
         ? `No cached risk report available for ${ticker}; report discovery failed: ${list.refreshError}`
         : `No 10-K risk reports on file for ${ticker}.`);
     }
-    const report = await loadRiskReportWithClient(context.apiClient, ticker, year, { force });
+    const report = await loadRiskReportWithClient(context.apiClient, ticker, year, { force, listing });
     const sections: HeadlessBundleSection[] = [
       { title: "Filing", entries: [
         { label: "Ticker", value: report.ticker },

package/src/plugins/builtin/risk-factors/pane.tsx

@@ -21,7 +21,7 @@ import { isPermanentClientError } from "../../../api-client/errors";
 import { usePluginPaneState } from "../../runtime";
 import { useFilingYearReader } from "../shared/filing-year-reader";
 import { useProFeatureWall, type ProFeatureWallCopy, type ReadGuard } from "../shared/pro-feature-wall";
-import { useBoundTicker } from "../shared/ticker-request";
+import { useBoundTicker, useIssuerListing } from "../shared/ticker-request";
 import { loadRiskReport, loadRiskReports } from "./data";
 
 export const RISK_FACTORS_PANE_ID = "risk-factors";
@@ -100,8 +100,9 @@ function RiskFactorsReader({
   nested = false,
   guard,
 }: RiskFactorsPaneProps & { guard: ReadGuard }) {
-  const { symbol } = useBoundTicker();
+  const { symbol, ticker: boundTicker } = useBoundTicker();
   const ticker = symbol ? symbol.toUpperCase() : null;
+  const listing = useIssuerListing(boundTicker);
   const nativePaneChrome = useUiCapabilities().nativePaneChrome === true;
   const rendererHost = useRendererHost();
 
@@ -109,13 +110,13 @@ function RiskFactorsReader({
   // one the pane opened with, so a restored year applies to it.
   const [selectedYear, setSelectedYear] = usePluginPaneState<number | null>("filingYear", null);
   const [selectedTicker, setSelectedTicker] = useState<string | null>(ticker);
-  const listLoader = useCallback((force: boolean) => guard(loadRiskReports(ticker!, { force })), [guard, ticker]);
+  const listLoader = useCallback((force: boolean) => guard(loadRiskReports(ticker!, { force, listing })), [guard, listing, ticker]);
   const list = useAsyncResource(ticker ? listLoader : null, { clearOnError: isPermanentClientError });
   const years = useMemo(() => (list.data?.reports ?? []).map((entry) => entry.reportYear).sort((a, b) => b - a), [list.data]);
   // Null follows the newest discovered filing; an explicit choice stays on that year.
   const year = selectedTicker === ticker && selectedYear !== null
     ? selectedYear : years[0] ?? null;
-  const reportLoader = useCallback((force: boolean) => guard(loadRiskReport(ticker!, year!, { force })), [guard, ticker, year]);
+  const reportLoader = useCallback((force: boolean) => guard(loadRiskReport(ticker!, year!, { force, listing })), [guard, listing, ticker, year]);
   const detail = useAsyncResource(ticker && year !== null ? reportLoader : null, { clearOnError: isPermanentClientError });
   const report = detail.data;
   const listError = list.error ?? list.data?.refreshError ?? null;
@@ -166,7 +167,7 @@ function RiskFactorsReader({
   const bodyWidth = Math.max(12, width - 2);
   const proseWidth = Math.min(bodyWidth, READING_WIDTH);
 
-  if (!ticker) return <EmptyState title="Pick a ticker to see its risk factors." />;
+  if (!ticker) return <EmptyState title="Select a ticker." />;
   if (!list.data && list.loading) return <PaneStatusBody loading align="center" loadingLabel="Loading risk factors..." />;
   if (!list.data && listError && year === null) return <PaneStatusBody error={listError} errorTitle="Could not load risk reports." />;
   if (year === null) return <EmptyState title={`No 10-K risk factors on file for ${ticker}.`} />;

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

@@ -133,7 +133,7 @@ export function SeasonalityPane({ width, height, focused }: PaneProps) {
   return <Box width={width} height={height} flexDirection="column" overflow="hidden">
     {strip}
     <QueryBar width={width} filters={[{ id: "lookback", label: "Lookback", value: String(lookback), options: LOOKBACK_OPTIONS, onChange: setLookback }]} />
-    {!symbol ? <EmptyState title="Choose a ticker." /> : <PaneStatusBody subject="seasonality" loading={history.loading && !model}
+    {!symbol ? <EmptyState title="Select a ticker." /> : <PaneStatusBody subject="seasonality" loading={history.loading && !model}
       error={!model ? history.error ?? identityError ?? null : null} empty={!!model && !model.years.length}>
       {model ? <>
         <StatGrid items={stats} width={width} />

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

@@ -10,7 +10,7 @@ import { useDebouncedPluginPaneState } from "../../runtime";
 import { usePaneSettingValue } from "../../../state/app/context";
 import type { ScrollBoxRenderable } from "../../../ui";
 import { EmptyState, FeedDataTableStackView, Spinner, StatGrid, usePaneNoticeFooter, useTableLoadMore, type FeedDataTableItem, type StatItem } from "../../../components";
-import { isUsEquityOrFundTicker, isUsEquityTicker, secFilingItemCodes } from "../../../utils/sec";
+import { mayBeUsEquityOrFundTicker, mayBeUsEquityTicker, secFilingItemCodes } from "../../../utils/sec";
 import { parseForm4Xml, transactionTypeLabel } from "../insider/insider-data";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import {
@@ -241,7 +241,7 @@ function SecView({ width, height, focused }: { width: number; height: number; fo
   // ticker. The fund filings view (ETF) lists other forms, so it leaves it.
   useSecFilingFocusRequest(forms ? null : ticker?.metadata.ticker, setOpenItemId);
   // A form list is the fund filings view (ETF), which US-listed funds open too.
-  const eligibleTicker = forms ? isUsEquityOrFundTicker(ticker) : isUsEquityTicker(ticker);
+  const eligibleTicker = forms ? mayBeUsEquityOrFundTicker(ticker) : mayBeUsEquityTicker(ticker);
   const instrument = instrumentFromTicker(ticker, ticker?.metadata.ticker ?? null);
   const filingsEntry = useSecFilingsQuery(
     instrument && eligibleTicker
@@ -449,7 +449,7 @@ export const secModule: PluginModule = {
         keywords: ["sec", "filings", "10-k", "10-q", "8-k"],
         shortcut: "SEC",
         shortcutAliases: ["CF"],
-        canCreate: (_context, options) => !options?.ticker || isUsEquityTicker(options.ticker),
+        canCreate: (_context, options) => !options?.ticker || mayBeUsEquityTicker(options.ticker),
       }),
       headless: secHeadless,
     },
@@ -462,7 +462,7 @@ export const secModule: PluginModule = {
         keywords: ["etf", "fund", "n-1a", "485bpos", "497", "n-csr", "n-cen", "n-port", "prospectus"],
         shortcut: "ETF",
         viewKey: "etf",
-        canCreate: (_context, options) => !options?.ticker || isUsEquityOrFundTicker(options.ticker),
+        canCreate: (_context, options) => !options?.ticker || mayBeUsEquityOrFundTicker(options.ticker),
         settings: () => ({ forms: ETF_FORMS_SETTING }),
       }),
       headless: createSecHeadless(undefined, {
@@ -481,7 +481,7 @@ export const secModule: PluginModule = {
       order: 45,
       component: SecView,
       instruments: ["equity"],
-      isVisible: ({ ticker }) => isUsEquityTicker(ticker),
+      isVisible: ({ ticker }) => mayBeUsEquityTicker(ticker),
     });
   },
   dispose() {

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

@@ -1,10 +1,12 @@
 import type { DataProvider } from "../../../types/data-provider";
 import type { PricePoint, Quote } from "../../../types/financials";
 import type { SectorDef } from "./sector-data";
+import { getRegularSessionDisplay } from "../../../market-data/market/status";
 import {
   computeTrailingReturn,
   historySessionBefore,
   latestHistoryDate,
+  sectorExtendedFields,
   sectorReturnTargetDate,
   sectorQuoteSessionDate,
   sectorReturnStartDate,
@@ -41,6 +43,8 @@ export async function loadSectorRows(
     sector.etf,
     await provider.getPriceHistory(sector.etf, "", "1Y").catch(() => []),
   ] as const)));
+  // The quotes as sent carry any pre-market or after-hours print, for its own column.
+  const sentQuotes = new Map(quotes);
   for (const [symbol, quote] of quotes) {
     if (quote) quotes.set(symbol, completedSessionQuote(quote, histories.get(symbol) ?? []));
   }
@@ -52,7 +56,10 @@ export async function loadSectorRows(
     let history: PricePoint[] = histories.get(sector.etf) ?? [];
     const quote = quotes.get(sector.etf) ?? null;
     if (!quote && history.length === 0) return { etf: sector.etf, row: null };
-    const lastReportedPrice = quote && Number.isFinite(quote.price) && quote.price > 0 ? quote.price : null;
+    // Price and 1D are the regular session, as `ticker` reads them: after the close
+    // its close and move, with an extended print in its own column.
+    const headline = getRegularSessionDisplay(quote);
+    const lastReportedPrice = headline && Number.isFinite(headline.price) && headline.price > 0 ? headline.price : null;
     const sessionDate = quoteDates.get(sector.etf) ?? null;
     const priceIssue = !quote || lastReportedPrice == null ? "quote unavailable"
       : !sessionDate ? "quote session unknown"
@@ -60,7 +67,7 @@ export async function loadSectorRows(
       : sessionDate !== asOfDate ? `quote from ${sessionDate}; shared session is ${asOfDate}`
       : null;
     const price = priceIssue ? null : lastReportedPrice;
-    const changePercent = price != null && Number.isFinite(quote?.changePercent) ? quote!.changePercent : null;
+    const changePercent = price != null && Number.isFinite(headline?.changePercent) ? headline!.changePercent! : null;
     const quoteIssue = priceIssue ?? (changePercent == null ? "1D change unavailable" : null);
     // A strict trailing request may begin after the prior year's weekend or
     // holiday. Ask for a small boundary buffer when the provider supports it.
@@ -89,6 +96,7 @@ export async function loadSectorRows(
         quoteUpdatedAt: quote && Number.isFinite(quote.lastUpdated) ? quote.lastUpdated : null,
         quoteDataSource: quote?.dataSource,
         changePercent,
+        ...sectorExtendedFields(price == null ? null : sentQuotes.get(sector.etf)),
         return1M: month?.value ?? null,
         return1Y: year?.value ?? null,
         returnAsOfDate: asOfDate,

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

@@ -3,19 +3,39 @@ import type {
   HeadlessPaneDefinition,
   HeadlessPaneLoadArgs,
 } from "../../../types/plugin";
+import type { HeadlessPaneColumn } from "../../../types/headless";
 import { formatCurrency, formatPercentRaw } from "../../../utils/format";
+import { EXTENDED_SESSION_LABELS, type ExtendedSession } from "../../../market-data/market/status";
 import { loadSectorRows, type SectorRowOutcome } from "./client";
 import { getSectorCollection, type SectorCollectionId, type SectorDef } from "./sector-data";
-import { DEFAULT_SORT_PREFERENCE, sectorRowIssues, sortRows, type SectorRow } from "./sector-model";
+import { DEFAULT_SORT_PREFERENCE, sectorExtendedSessions, sectorRowIssues, sortRows, type SectorRow } from "./sector-model";
 
-const COLUMNS = [
+const price = (value: unknown, row: Record<string, unknown>) => value == null ? "-" : formatCurrency(Number(value), String(row.currency));
+const percent = (value: unknown) => value == null ? "-" : formatPercentRaw(Number(value));
+
+const LEAD_COLUMNS: HeadlessPaneColumn[] = [
   { key: "name", header: "Sector" },
   { key: "etf", header: "ETF" },
-  { key: "price", header: "Last", align: "right" as const, format: (value: unknown, row: Record<string, unknown>) => value == null ? "-" : formatCurrency(Number(value), String(row.currency)) },
-  { key: "changePercent", header: "1D", align: "right" as const, format: (value: unknown) => value == null ? "-" : formatPercentRaw(Number(value)) },
-  { key: "return1M", header: "1M", align: "right" as const, format: (value: unknown) => value == null ? "-" : formatPercentRaw(Number(value)) },
-  { key: "return1Y", header: "1Y", align: "right" as const, format: (value: unknown) => value == null ? "-" : formatPercentRaw(Number(value)) },
+  { key: "price", header: "Last", align: "right", format: price },
+  { key: "changePercent", header: "1D", align: "right", format: percent },
+];
+const RETURN_COLUMNS: HeadlessPaneColumn[] = [
+  { key: "return1M", header: "1M", align: "right", format: percent },
+  { key: "return1Y", header: "1Y", align: "right", format: percent },
 ];
+const COLUMNS = [...LEAD_COLUMNS, ...RETURN_COLUMNS];
+
+/** The pre-market or after-hours print and its move from the regular close, for the funds that have one. */
+function extendedColumn(session: ExtendedSession): HeadlessPaneColumn {
+  return {
+    key: "extendedPrice",
+    header: EXTENDED_SESSION_LABELS[session],
+    align: "right",
+    format: (value, row) => row.extendedSession === session && typeof value === "number"
+      ? `${price(value, row)} ${percent(row.extendedChangePercent)}`
+      : "-",
+  };
+}
 
 export function projectSectorRows(
   definitions: readonly SectorDef[],
@@ -36,6 +56,10 @@ export function projectSectorRows(
     quoteDataSource: byEtf.get(definition.etf)?.quoteDataSource,
     quoteIssue: byEtf.get(definition.etf)?.quoteIssue ?? null,
     lastReportedPrice: byEtf.get(definition.etf)?.lastReportedPrice ?? null,
+    extendedSession: byEtf.get(definition.etf)?.extendedSession ?? null,
+    extendedPrice: byEtf.get(definition.etf)?.extendedPrice ?? null,
+    extendedChange: byEtf.get(definition.etf)?.extendedChange ?? null,
+    extendedChangePercent: byEtf.get(definition.etf)?.extendedChangePercent ?? null,
     returnIntegrity: byEtf.get(definition.etf)?.returnIntegrity ?? {},
     returnAsOfDate: byEtf.get(definition.etf)?.returnAsOfDate ?? null,
     return1MStartDate: byEtf.get(definition.etf)?.return1MStartDate ?? null,
@@ -82,7 +106,12 @@ export function createSectorsHeadless(
       const unavailableReturns = rows.filter((row) => row.return1M == null || row.return1Y == null).map((row) => row.etf);
       const unavailableDailyChanges = rows.filter((row) => row.changePercent == null).map((row) => row.etf);
       const unavailableSymbols = [...new Set([...unavailableQuotes, ...unavailableReturns, ...unavailableDailyChanges])];
+      // Last and 1D are the regular session; an extended print gets a column only when a fund has one.
+      const extendedSessions = sectorExtendedSessions(rows);
       return {
+        ...(extendedSessions.length > 0
+          ? { columns: [...LEAD_COLUMNS, ...extendedSessions.map(extendedColumn), ...RETURN_COLUMNS] }
+          : {}),
         unavailableSymbols: unavailableSymbols.length > 0 ? unavailableSymbols : undefined,
         errors: rows.flatMap((row) => sectorRowIssues(row).map((issue) => `${row.etf}: ${issue}.`)),
         // The quote behind each row says whether it is real-time or delayed, and how current it is.

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

@@ -12,6 +12,7 @@ import { useLiveQuoteEntries } from "../../../state/hooks/quote-streaming";
 import { buildQuoteKey, resolveEntryData } from "../../../market-data/selectors";
 import type { QuoteSubscriptionTarget } from "../../../types/data-provider";
 import type { Quote } from "../../../types/financials";
+import type { ExtendedSession } from "../../../market-data/market/status";
 import { useAutoRefresh, useUpdatedAgo } from "../../../react/auto-refresh";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { isStreamCarryingQuote, useVisibleBoardSymbols } from "../shared/use-quote-board";
@@ -33,6 +34,7 @@ import {
   nextSortPreference,
   normalizeRowsForCollection,
   overlayLiveSectorQuote,
+  sectorExtendedSessions,
   sectorRowFollowsQuote,
   sectorRowIssues,
   sortRows,
@@ -149,7 +151,6 @@ function EtfBoard({ collectionId, focused, width, height, rootBefore }: EtfBoard
   const fetchGenRef = useRef(0);
   const [loadError, setLoadError] = useState<string | null>(null);
 
-  const columns = useMemo(() => buildSectorColumns(width), [width]);
   const rows = useMemo(
     () => normalizeRowsForCollection(rowsByCollection, activeCollection.id, activeItems),
     [activeCollection.id, activeItems, rowsByCollection],
@@ -203,6 +204,12 @@ function EtfBoard({ collectionId, focused, width, height, rootBefore }: EtfBoard
     return carried && !!quote && sectorRowFollowsQuote(row, quote);
   }), [freshnessNow, liveEntries, liveStreaming, rows, subscriptionStartedAt]);
   const sortedRows = useMemo(() => sortRows(liveRows, sortPreference), [liveRows, sortPreference]);
+  // A pre-market or after-hours column only while a fund has such a print.
+  const extendedSessionsKey = sectorExtendedSessions(liveRows).join(",");
+  const columns = useMemo(
+    () => buildSectorColumns(width, extendedSessionsKey ? extendedSessionsKey.split(",") as ExtendedSession[] : []),
+    [extendedSessionsKey, width],
+  );
   const lastRefreshMs = lastRefreshByCollection[activeCollection.id] ?? null;
   const loading = rows.some((row) => row.loading);
   /**
@@ -296,6 +303,16 @@ function EtfBoard({ collectionId, focused, width, height, rootBefore }: EtfBoard
           text: row.changePercent !== null ? formatPercentRaw(shownPercent(row.changePercent)) : "—",
           color: row.changePercent !== null ? priceColor(shownPercent(row.changePercent)) : colors.textDim,
         };
+      case "preMarket":
+      case "afterHours": {
+        // The extended print's move from the close in LAST.
+        const move = row.extendedSession === (column.id === "preMarket" ? "PRE" : "POST") ? row.extendedChangePercent ?? null : null;
+        return {
+          text: move !== null ? formatPercentRaw(shownPercent(move)) : "—",
+          value: move,
+          color: move !== null ? priceColor(shownPercent(move)) : colors.textDim,
+        };
+      }
       case "return1M":
         return {
           text: row.loading && row.return1M === null ? "…" : row.return1M !== null ? formatPercentRaw(shownPercent(row.return1M)) : "—",

package/src/plugins/builtin/sectors/sector-model.ts

@@ -1,8 +1,15 @@
 import type { DataTableColumn } from "../../../components";
+import { getTableWidth, tableColumnWidth } from "../../../components/ui/table-layout";
 import type { PricePoint, Quote } from "../../../types/financials";
 import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
 import { getPricePointTimestamp } from "../../../utils/price-history";
 import { mergePriceHistoryIntegrity, pricePointIntegrity, type PriceHistoryIntegrity } from "../../../utils/price-history-integrity";
+import {
+  getExtendedSessionDisplay,
+  getRegularSessionDisplay,
+  marketStateLabel,
+  type ExtendedSession,
+} from "../../../market-data/market/status";
 import {
   getSectorCollection,
   type SectorCollectionId,
@@ -12,8 +19,21 @@ import {
 const DAY_MS = 24 * 60 * 60 * 1000;
 export const DEFAULT_COLLECTION_ID: SectorCollectionId = "sectors";
 
-export interface SectorRow extends SectorDef {
+/**
+ * The pre-market or after-hours print beside a row's regular close, measured
+ * from that close (getExtendedSessionDisplay); all null without one.
+ */
+export interface SectorExtendedFields {
+  extendedSession?: ExtendedSession | null;
+  extendedPrice?: number | null;
+  extendedChange?: number | null;
+  extendedChangePercent?: number | null;
+}
+
+export interface SectorRow extends SectorDef, SectorExtendedFields {
+  /** The regular session's price: its close once it is over, never an extended print. */
   price: number | null;
+  /** The regular session's move, as `ticker` reports it. */
   changePercent: number | null;
   return1M: number | null;
   return1Y: number | null;
@@ -33,7 +53,7 @@ export interface SectorRow extends SectorDef {
   return1YStartDate?: string | null;
 }
 
-type SectorColumnId = "name" | "etf" | "price" | "changePercent" | "return1M" | "return1Y" | "bar";
+type SectorColumnId = "name" | "etf" | "price" | "changePercent" | "preMarket" | "afterHours" | "return1M" | "return1Y" | "bar";
 export type SectorColumn = DataTableColumn & { id: SectorColumnId };
 export type SectorRowsByCollection = Record<SectorCollectionId, SectorRow[]>;
 export type SectorRefreshByCollection = Partial<Record<SectorCollectionId, number>>;
@@ -48,6 +68,45 @@ export const DEFAULT_SORT_PREFERENCE: SectorSortPreference = {
   direction: "desc",
 };
 
+const NO_EXTENDED_PRINT: Required<SectorExtendedFields> = {
+  extendedSession: null,
+  extendedPrice: null,
+  extendedChange: null,
+  extendedChangePercent: null,
+};
+
+/** A quote's pre-market or after-hours print, from the regular close a row shows, as row fields. */
+export function sectorExtendedFields(quote: Quote | null | undefined): Required<SectorExtendedFields> {
+  const extended = getExtendedSessionDisplay(quote);
+  if (!extended || !Number.isFinite(extended.price)) return NO_EXTENDED_PRINT;
+  return {
+    extendedSession: extended.session,
+    extendedPrice: extended.price,
+    extendedChange: Number.isFinite(extended.change) ? extended.change! : null,
+    extendedChangePercent: Number.isFinite(extended.changePercent) ? extended.changePercent! : null,
+  };
+}
+
+function extendedFieldsOf(row: SectorExtendedFields | undefined): Required<SectorExtendedFields> {
+  return {
+    extendedSession: row?.extendedSession ?? null,
+    extendedPrice: row?.extendedPrice ?? null,
+    extendedChange: row?.extendedChange ?? null,
+    extendedChangePercent: row?.extendedChangePercent ?? null,
+  };
+}
+
+function sameExtended(left: SectorExtendedFields, right: SectorExtendedFields): boolean {
+  return (left.extendedSession ?? null) === (right.extendedSession ?? null)
+    && (left.extendedPrice ?? null) === (right.extendedPrice ?? null)
+    && (left.extendedChangePercent ?? null) === (right.extendedChangePercent ?? null);
+}
+
+/** The extended sessions some row has a print for, in the order their columns go. */
+export function sectorExtendedSessions(rows: readonly SectorExtendedFields[]): ExtendedSession[] {
+  return (["PRE", "POST"] as const).filter((session) => rows.some((row) => row.extendedSession === session));
+}
+
 /** Full length at a 5% session move, which covers all but crash days. */
 const MOVE_BAR_FULL_SCALE_PERCENT = 5;
 
@@ -99,6 +158,7 @@ export function normalizeRowsForCollection(
       quoteIssue: existing?.quoteIssue ?? null,
       lastReportedPrice: existing?.lastReportedPrice ?? null,
       quoteUpdatedAt: existing?.quoteUpdatedAt ?? null,
+      ...extendedFieldsOf(existing),
       returnIntegrity: existing?.returnIntegrity ?? {},
       returnAsOfDate: existing?.returnAsOfDate ?? null,
       return1MStartDate: existing?.return1MStartDate ?? null,
@@ -138,6 +198,7 @@ const UNAVAILABLE_SECTOR_ROW: Partial<SectorRow> = {
   lastReportedPrice: null,
   quoteUpdatedAt: null,
   returnIntegrity: {},
+  ...NO_EXTENDED_PRINT,
 };
 
 function sameSectorRow(left: SectorRow, right: SectorRow): boolean {
@@ -276,33 +337,49 @@ export function sectorRowIssues(row: SectorRow): string[] {
   return issues;
 }
 
-export function buildSectorColumns(width: number): SectorColumn[] {
-  const etfWidth = 4;
-  const priceWidth = 8;
-  const changeWidth = 8;
-  const returnWidth = 8;
-  const showBar = width >= 67;
-  const compactBar = width < 82;
-  const barWidth = showBar
-    ? compactBar ? 6 : Math.max(8, Math.min(18, Math.floor(width * 0.16)))
-    : 0;
-  const columnCount = showBar ? 7 : 6;
-  const fixedWidth = etfWidth + priceWidth + changeWidth + returnWidth * 2 + barWidth;
-  const nameWidth = Math.max(10, Math.min(22, width - 2 - columnCount - fixedWidth));
-
-  const columns: SectorColumn[] = [
-    { id: "name", label: "SECTOR", width: nameWidth, align: "left", flexGrow: 1 },
-    { id: "etf", label: "ETF", width: etfWidth, align: "left" },
-    { id: "price", label: "LAST", width: priceWidth, align: "right" },
-    { id: "changePercent", label: "1D", width: changeWidth, align: "right" },
-    { id: "return1M", label: "1M", width: returnWidth, align: "right" },
-    { id: "return1Y", label: "1Y", width: returnWidth, align: "right" },
+const EXTENDED_COLUMN_WIDTH = 9;
+/** The longest name in either collection ("Consumer Staples"), which a narrow pane keeps whole as long as it can. */
+const FULL_NAME_WIDTH = 16;
+
+/**
+ * The board's columns at `width`. A pre-market or after-hours column follows
+ * 1D for each session in `extendedSessions`. A narrow pane gives up the move
+ * bar first, then that column, before it cuts a sector's name.
+ */
+export function buildSectorColumns(width: number, extendedSessions: readonly ExtendedSession[] = []): SectorColumn[] {
+  const lead: SectorColumn[] = [
+    { id: "etf", label: "ETF", width: 4, align: "left" },
+    { id: "price", label: "LAST", width: 8, align: "right" },
+    { id: "changePercent", label: "1D", width: 8, align: "right" },
+  ];
+  const returns: SectorColumn[] = [
+    { id: "return1M", label: "1M", width: 8, align: "right" },
+    { id: "return1Y", label: "1Y", width: 8, align: "right" },
+  ];
+  const extendedColumns = extendedSessions.map((session): SectorColumn => ({
+    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",
+  }));
+  // 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 = (columns: SectorColumn[]) => width - getTableWidth(columns) - 1;
+  const shownExtended = extendedColumns.length > 0 && nameRoom([...lead, ...extendedColumns, ...returns]) >= FULL_NAME_WIDTH
+    ? extendedColumns
+    : [];
+  const extendedWidth = shownExtended.reduce((total, column) => total + tableColumnWidth(column) + 1, 0);
+  const barWidth = width - extendedWidth < 82 ? 6 : Math.max(8, Math.min(18, Math.floor(width * 0.16)));
+  // Labelled with the window it encodes: it sits after 1Y but tracks 1D.
+  const bar: SectorColumn = { id: "bar", label: "1D MOVE", width: barWidth, align: "left" };
+  const withBar = [...lead, ...shownExtended, ...returns, bar];
+  const showBar = width - extendedWidth >= 67 && nameRoom(withBar) >= FULL_NAME_WIDTH;
+  const columns = showBar ? withBar : [...lead, ...shownExtended, ...returns];
+  return [
+    { id: "name", label: "SECTOR", width: Math.max(10, Math.min(22, nameRoom(columns))), align: "left", flexGrow: 1 },
+    ...columns,
   ];
-  if (showBar) {
-    // Labelled with the window it encodes: it sits after 1Y but tracks 1D.
-    columns.push({ id: "bar", label: "1D MOVE", width: barWidth, align: "left" });
-  }
-  return columns;
 }
 
 function getSortValue(columnId: SectorColumnId, row: SectorRow): string | number | null {
@@ -315,6 +392,9 @@ function getSortValue(columnId: SectorColumnId, row: SectorRow): string | number
       return row.price;
     case "changePercent":
       return row.changePercent;
+    case "preMarket":
+    case "afterHours":
+      return row.extendedSession === (columnId === "preMarket" ? "PRE" : "POST") ? row.extendedChangePercent ?? null : null;
     case "return1M":
       return row.return1M;
     case "return1Y":
@@ -338,6 +418,8 @@ export function nextSortPreference(current: SectorSortPreference, columnId: stri
     return {
       columnId: typedColumnId,
       direction: typedColumnId === "changePercent"
+        || typedColumnId === "preMarket"
+        || typedColumnId === "afterHours"
         || typedColumnId === "return1M"
         || typedColumnId === "return1Y"
         || typedColumnId === "bar"
@@ -373,17 +455,30 @@ export function sectorQuoteSessionDate(quote: Quote): string | null {
 /**
  * A live quote extends a loaded row only inside the session its returns are
  * measured to. Every fund shares that session, so a pre-market print (the
- * next session) or a quote older than the snapshot leaves the row alone and
- * the board keeps ranking on one completed session. The 1M and 1Y returns
- * keep their baselines: the row's own return and price imply the start close.
+ * next session) or a quote older than the snapshot leaves the row's price
+ * alone and the board keeps ranking on one completed session. The 1M and 1Y
+ * returns keep their baselines: the row's own return and price imply the
+ * start close.
  */
 function isLiveSectorQuote(row: SectorRow, quote: Quote | null | undefined): quote is Quote {
-  if (!quote || quote.stale === true || !finitePositive(quote.price)) return false;
-  if (!finitePositive(row.price) || !row.returnAsOfDate) return false;
-  if (row.quoteUpdatedAt != null && quote.lastUpdated < row.quoteUpdatedAt) return false;
+  if (!isCurrentSectorQuote(row, quote) || !finitePositive(getRegularSessionDisplay(quote)?.price)) return false;
   return sectorQuoteSessionDate(quote) === row.returnAsOfDate;
 }
 
+/** A usable quote no older than the snapshot behind a loaded row. */
+function isCurrentSectorQuote(row: SectorRow, quote: Quote | null | undefined): quote is Quote {
+  if (!quote || quote.stale === true) return false;
+  if (!finitePositive(row.price) || !row.returnAsOfDate) return false;
+  return row.quoteUpdatedAt == null || quote.lastUpdated >= row.quoteUpdatedAt;
+}
+
+/** A pre-market print of the session after the row's, which moves only the extended column. */
+function isNextPreMarketQuote(row: SectorRow, quote: Quote): boolean {
+  if (quote.marketState !== "PRE" && quote.marketState !== "PREPRE") return false;
+  const session = sectorQuoteSessionDate(quote);
+  return !!session && !!row.returnAsOfDate && session > row.returnAsOfDate;
+}
+
 /**
  * Whether the feed keeps a loaded row as current as a snapshot reload would,
  * given a quote the feed is carrying. It does when the quote belongs to the
@@ -402,18 +497,32 @@ export function sectorRowFollowsQuote(row: SectorRow, quote: Quote): boolean {
   return quote.marketState === "PRE" || quote.marketState === "PREPRE";
 }
 
+/**
+ * A row with the feed's quote on it. Price and 1D are the regular session,
+ * as `ticker` reads them, so they hold at the close; a pre-market or
+ * after-hours print moves only the extended column, measured from that close.
+ */
 export function overlayLiveSectorQuote(row: SectorRow, quote: Quote | null | undefined): SectorRow {
-  if (!isLiveSectorQuote(row, quote) || row.price == null) return row;
-  const changePercent = Number.isFinite(quote.changePercent) ? quote.changePercent : row.changePercent;
-  if (quote.price === row.price && changePercent === row.changePercent) return row;
-  const scale = quote.price / row.price;
-  const rescale = (value: number | null) => (value == null ? null : ((1 + value / 100) * scale - 1) * 100);
+  if (!isCurrentSectorQuote(row, quote) || row.price == null) return row;
+  if (!isLiveSectorQuote(row, quote)) {
+    if (!isNextPreMarketQuote(row, quote)) return row;
+    const extended = sectorExtendedFields(quote);
+    return sameExtended(extended, row) ? row : { ...row, ...extended };
+  }
+  const headline = getRegularSessionDisplay(quote)!;
+  const extended = sectorExtendedFields(quote);
+  const changePercent = Number.isFinite(headline.changePercent) ? headline.changePercent! : row.changePercent;
+  if (headline.price === row.price && changePercent === row.changePercent && sameExtended(extended, row)) return row;
+  const scale = headline.price / row.price;
+  // A held close leaves the returns exactly as they were.
+  const rescale = (value: number | null) => (value == null || scale === 1 ? value : ((1 + value / 100) * scale - 1) * 100);
   return {
     ...row,
-    price: quote.price,
-    lastReportedPrice: quote.price,
+    price: headline.price,
+    lastReportedPrice: headline.price,
     changePercent,
     return1M: rescale(row.return1M),
     return1Y: rescale(row.return1Y),
+    ...extended,
   };
 }

package/src/plugins/builtin/shared/command-tab.ts

@@ -0,0 +1,51 @@
+import { useEffect, useRef } from "react";
+import { usePluginPaneState } from "../../../public/react";
+import { usePaneInstance } from "../../../state/app/context";
+import type { PaneTemplateDef, PaneTemplateInstanceConfig } from "../../../types/plugin";
+
+/** A command's request to show one tab, stamped so a later command can ask again. */
+export function commandTabParams(tab: string, params?: Record<string, string>): Record<string, string> {
+  return { ...(params ?? {}), tab, tabAt: String(Date.now()) };
+}
+
+/** The template's pane, with the command's tab written onto the instance. */
+function stampCommandTab(instance: PaneTemplateInstanceConfig | null, tab: string): PaneTemplateInstanceConfig | null {
+  return instance ? { ...instance, params: commandTabParams(tab, instance.params) } : null;
+}
+
+export function withCommandTab(template: PaneTemplateDef, tab: string): PaneTemplateDef {
+  const create = template.createInstance;
+  return {
+    ...template,
+    createInstance: (context, options) => {
+      const created = create?.(context, options);
+      if (!created) return null;
+      return created instanceof Promise ? created.then((instance) => stampCommandTab(instance, tab)) : stampCommandTab(created, tab);
+    },
+  };
+}
+
+/**
+ * The tab a command asked this pane to show. A stored choice wins until a
+ * newer command arrives. Another pane's params, such as Ticker Research
+ * around a nested tab, are ignored.
+ */
+export function useCommandTab<T extends string>(
+  paneId: string,
+  stateKey: string,
+  tabs: readonly T[],
+  fallback: T,
+): [T, (next: T) => void] {
+  const instance = usePaneInstance();
+  const params = instance?.paneId === paneId ? instance.params : undefined;
+  const requested = params && (tabs as readonly string[]).includes(params.tab ?? "") ? params.tab as T : null;
+  const requestAt = params?.tabAt ?? "";
+  const [tab, setTab] = usePluginPaneState<T>(stateKey, requested ?? fallback);
+  const seen = useRef(requestAt);
+  useEffect(() => {
+    if (!requested || requestAt === seen.current) return;
+    seen.current = requestAt;
+    setTab(requested);
+  }, [requestAt, requested, setTab]);
+  return [tab, setTab];
+}