gloomberb 0.17.0 → 0.17.2

package/src/plugins/builtin/earnings/history-model.ts

@@ -87,7 +87,7 @@ export function historyRows(payload: EarningsHistoryPayload | null, today: strin
         epsEstimate: coherentEarningsValue(upcoming, "epsEstimate"),
         epsAnalysts: coherentEarningsValue(upcoming, "epsAnalysts"),
         epsActual: null,
-        epsBasis: null,
+        epsBasis: earningsEpsBasis(upcoming.epsBasis),
         epsSurprise: null,
         revenueEstimate: coherentEarningsValue(upcoming, "revenueEstimate"),
         revenueActual: null,

package/src/plugins/builtin/earnings/history-table.ts

@@ -3,7 +3,7 @@ import { TABLE_COLUMN_GAP, tableColumnWidth } from "../../../components/ui/table
 import { colors } from "../../../theme/colors";
 import { TextAttributes } from "../../../ui";
 import { datedYear, epsText, fiscalMonth, impliedText, moneyText, signedPercent, TIMING_LABEL } from "./format";
-import { epsBasisShort } from "../shared/earnings-report";
+import { epsBasisShort, showsEpsBasis } from "../shared/earnings-report";
 import type { HistoryRow } from "./history-model";
 
 type HistoryColumnId =
@@ -74,7 +74,7 @@ export function renderHistoryCell(row: HistoryRow, column: HistoryColumn): DataT
     case "epsActual":
       return { text: epsText(row.epsActual), color: colors.text };
     case "basis":
-      return row.epsActual == null
+      return !showsEpsBasis(row)
         ? { text: "--", color: dim }
         : { text: epsBasisShort(row.epsBasis), color: row.epsBasis ? colors.textMuted : dim };
     case "epsSurprise":

package/src/plugins/builtin/earnings-calls/headless.ts

@@ -8,8 +8,7 @@ import type {
   HeadlessPaneLoadArgs,
   HeadlessRowsResult,
 } from "../../../types/plugin";
-import { cloudAccountNeed, cloudDeniedStatus, type CloudDeniedStatus } from "../shared/cloud-denied";
-import { countOf, freePreviewNote } from "../shared/free-preview";
+import { explainRefusal } from "../shared/cloud-denied";
 import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
 import {
   callStatusLabel,
@@ -18,6 +17,7 @@ import {
   loadTranscriptWithClient,
   type EarningsCallsResult,
 } from "./data";
+import { callsLockNote } from "./lock-note";
 import {
   buildTranscriptSegments,
   findCallForQuarter,
@@ -68,23 +68,9 @@ const defaultDependencies: EarningsCallsHeadlessDependencies = {
   loadTranscript: (callId, context) => loadTranscriptWithClient(context.apiClient, callId),
 };
 
-/** The whole feature is Pro, so a free account's lock line says there is no preview rather than the server's bare "Pro plan required". */
-const CALLS_PRO_NOTE = freePreviewNote({ shows: countOf(0, "earnings call"), adds: "every call with its transcript, speaker turns and analyst Q&A" });
-
-/**
- * What a refused account needs, as the pane's walls say it: sign in, then
- * verify the email, then Pro. The list itself is Pro, so a signed-out reader
- * hears about Pro too rather than meeting it after signing in.
- */
-function callsDeniedMessage(status: CloudDeniedStatus): string {
-  if (status === 401) return `CALLS needs ${cloudAccountNeed(status)} (log in or sign up free in the app), then Gloom Pro: earnings call transcripts are part of Gloom Cloud Pro.`;
-  if (status === 403) return `CALLS needs ${cloudAccountNeed(status)} (Resend Verification Email in the app).`;
-  return CALLS_PRO_NOTE;
-}
-
-function explainDenied(error: unknown): never {
-  const status = cloudDeniedStatus(error);
-  throw status ? new Error(callsDeniedMessage(status), { cause: error }) : error;
+/** A refused read says what the lock note says (CALLS is Pro whole), so a free account meets the same words as a signed-out one. */
+function explainDenied(ticker: string | null) {
+  return (error: unknown): never => { throw explainRefusal(error, callsLockNote, { symbol: ticker }); };
 }
 
 function callRow(call: CloudEarningsCallPayload) {
@@ -292,7 +278,7 @@ export function createEarningsCallsHeadless(
     },
     async load(args, context) {
       const ticker = typeof args.argument === "string" ? args.argument : null;
-      const calls = await dependencies.loadCalls(ticker, 200, context).catch(explainDenied);
+      const calls = await dependencies.loadCalls(ticker, 200, context).catch(explainDenied(ticker));
       if (!ticker || !readsTranscript(args)) {
         return projectEarningsCallsHeadless(calls, { ...args, options: { ...args.options, limit: args.options.limit ?? 50 } });
       }
@@ -306,7 +292,7 @@ export function createEarningsCallsHeadless(
         }
         throw new Error(`No ${quarter} earnings call found for ${ticker}.`);
       }
-      const transcript = await dependencies.loadTranscript(selected.id, context).catch(explainDenied);
+      const transcript = await dependencies.loadTranscript(selected.id, context).catch(explainDenied(ticker));
       if (isPendingTranscript(transcript)) {
         throw new Error(`Transcript for ${ticker} ${quarter} is still being produced.`);
       }

package/src/plugins/builtin/earnings-calls/index.tsx

@@ -2,6 +2,7 @@ import type { PluginModule } from "../plugin-module";
 import { attachEarningsCallsPersistence, resetEarningsCallsPersistence } from "./data";
 import { EarningsCallsPane, EARNINGS_CALLS_PANE_ID } from "./pane";
 import { earningsCallsHeadless } from "./headless";
+import { callsLockNote } from "./lock-note";
 
 
 const description =
@@ -32,6 +33,7 @@ export const earningsCallsModule: PluginModule = {
   panes: [
     {
       id: EARNINGS_CALLS_PANE_ID,
+      reportLockNote: callsLockNote,
       name: "Earnings Calls",
       icon: "C",
       component: EarningsCallsPane,

package/src/plugins/builtin/earnings-calls/lock-note.ts

@@ -0,0 +1,17 @@
+import type { PaneLock } from "../../../types/plugin";
+import { proLockNote } from "../shared/pro-lock-note";
+
+/**
+ * CALLS is Pro whole, the list of calls included. `events` needs no account
+ * and lists a company's earnings dates, each with the EPS it reported and the
+ * next one's estimate, without the call or its transcript.
+ */
+export function callsLockNote(lock: PaneLock): string {
+  return proLockNote(lock, {
+    token: "CALLS",
+    argument: "optional",
+    does: "it reads each earnings call into a transcript with speaker turns, analyst Q&A and extracted guidance",
+    shows: "it",
+    free: (ticker, company) => `gloomberb events ${ticker} lists ${company}'s earnings dates, with the EPS reported at each and the next estimate.`,
+  });
+}

package/src/plugins/builtin/equity-screener/headless.ts

@@ -1,9 +1,16 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
+import type { HeadlessPaneColumn, HeadlessPaneContext } from "../../../types/headless";
 import {
   NUMERIC_FIELDS,
   type NumericField,
+  type ScreenRow,
 } from "../../../api-client/equity-screener";
+import { EXTENDED_SESSION_LABELS, type ExtendedSession } from "../../../market-data/market/status";
+import { buildQuoteKey } from "../../../market-data/selectors";
+import type { Quote } from "../../../types/financials";
+import { formatCurrency, formatPercentRaw } from "../../../utils/format";
 import { fetchScreen } from "./client";
+import { overlayScreenQuotes, screenExtendedSessions } from "./live";
 import {
   DEFAULT_SCREEN,
   EXAMPLE_SCREEN_DEFINITION,
@@ -22,6 +29,41 @@ const spacedJson = (definition: ScreenDefinition) =>
 /** The `--definition` value of the catalog's worked example, quoted for a shell. */
 const EXAMPLE_DEFINITION_OPTION = `--definition '${spacedJson(EXAMPLE_SCREEN_DEFINITION)}'`;
 
+/**
+ * Each row's quote through the standard quote path, keyed as the overlay
+ * reads it. A row without one, or every row when the batch fails, keeps the
+ * snapshot's figures.
+ */
+async function loadRowQuotes(rows: readonly ScreenRow[], ctx: HeadlessPaneContext): Promise<Map<string, Quote>> {
+  const provider = ctx.marketData;
+  if (!provider?.getQuotesBatch || rows.length === 0) return new Map();
+  try {
+    const results = await provider.getQuotesBatch(
+      rows.map((row) => ({ symbol: row.symbol, exchange: row.exchange })),
+      { forceRefresh: ctx.refresh, signal: ctx.signal },
+    );
+    return new Map(results.flatMap((result) => result.quote ? [[buildQuoteKey(result.target), result.quote] as const] : []));
+  } catch {
+    return new Map();
+  }
+}
+
+const price = (value: unknown, row: Record<string, unknown>) =>
+  typeof value === "number" && typeof row.currency === "string" && row.currency ? formatCurrency(value, row.currency) : "-";
+const percent = (value: unknown) => typeof value === "number" ? formatPercentRaw(value) : "-";
+
+/** The pre-market, after-hours or overnight print and its move from the close in Last, for the rows 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)}${row.extendedMark ? " mid" : ""} ${percent(row.extendedChangePercent)}`
+      : "-",
+  };
+}
+
 /** A typed `--definition`, checked; every error points at the worked example. */
 function readDefinition(text: string): ScreenDefinition {
   const pointer = "The example in gloomberb catalog EQS is a valid definition to start from.";
@@ -81,6 +123,10 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
       : DEFAULT_SCREEN;
     const data = await fetchScreen(definition, null, ctx.signal, ctx.apiClient);
     const metric = (args.options.metric ?? "marketCap") as NumericField;
+    // Last, Chg% and market cap are the regular session, as `quote` and the
+    // pane read each row's quote; an extended print is a column of its own.
+    const rows = overlayScreenQuotes(data.rows, await loadRowQuotes(data.rows, ctx));
+    const extendedSessions = screenExtendedSessions(rows);
     // Payload status also counts ordinary per-field sparsity; only generation
     // warnings are failures, and more pages are not an error.
     return {
@@ -94,19 +140,30 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
             { key: "symbol", header: "Symbol" },
             { key: "exchange", header: "Exchange" },
             { key: "name", header: "Name" },
+            // The focus metric says it once when it is the price or the move.
+            ...(metric === "price" ? [] : [{ key: "price", header: "Last", align: "right" as const, format: price }]),
+            ...(metric === "changePercent" ? [] : [{ key: "changePercent", header: "Chg%", align: "right" as const, format: percent }]),
+            ...extendedSessions.map(extendedColumn),
             { key: "value", header: SHORT_LABELS[metric], align: "right" },
             { key: "unit", header: "Unit" },
             { key: "percentile", header: "Covered pctl", align: "right" },
             { key: "asOf", header: "As of" },
             { key: "state", header: "State" },
           ],
-          rows: data.rows.map((row) => {
+          rows: rows.map((row) => {
             const observation = row.metrics[metric];
             const stamp = metricDate(observation);
             return {
               symbol: row.symbol,
               exchange: row.exchange,
               name: row.name,
+              currency: row.currency,
+              price: row.metrics.price.value,
+              changePercent: row.metrics.changePercent.value,
+              extendedSession: row.extended?.session ?? null,
+              extendedPrice: row.extended?.price ?? null,
+              extendedChangePercent: row.extended?.changePercent ?? null,
+              ...(row.extended?.mark ? { extendedMark: true } : {}),
               value: formatScreenValue(metric, observation.value),
               unit: observation.unit,
               percentile:
@@ -127,6 +184,7 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
         covered: data.universe.covered,
         returned: data.rows.length,
         hasMore: !!data.nextCursor,
+        priceBasis: "price, changePercent and the market cap are the regular session, read from each row's quote as `quote` reads it: after the close, its close and that close's move. A pre-market, after-hours or overnight print is in extendedPrice and extendedChangePercent, measured from that close. Membership, order and percentiles are the snapshot's, which ranks by the close.",
         notices: data.nextCursor
           ? [
               `Top ${data.rows.length} of ${data.universe.matched} matches; narrow the criteria to see the rest.`,

package/src/plugins/builtin/equity-screener/live.ts

@@ -1,9 +1,19 @@
 import type { ScreenMetric, ScreenRow } from "../../../api-client/equity-screener";
+import { getExtendedSessionDisplay, type ExtendedSession, type ExtendedSessionDisplay } from "../../../market-data/market/status";
+import { quoteTradingDay } from "../../../market-data/quotes/day-range";
+import { getRegularSessionQuoteDisplay } from "../../../market-data/quotes/screener-live-quotes";
 import type { QueryEntry } from "../../../market-data/result-types";
 import { buildQuoteKey, resolveEntryData } from "../../../market-data/selectors";
 import type { Quote } from "../../../types/financials";
 import { isFiniteNumber } from "../../../utils/guards";
 
+/**
+ * A screen row with its quote laid over it: price, change, volume and market
+ * cap are the regular session's, and a pre-market, after-hours or overnight
+ * print rides beside them in `extended`, measured from that session's close.
+ */
+export type LiveScreenRow = ScreenRow & { extended?: ExtendedSessionDisplay };
+
 function metricTime(metric: ScreenMetric | undefined): number | null {
   const stamp = metric?.observedAt ?? metric?.asOf ?? null;
   if (!stamp) return null;
@@ -15,54 +25,69 @@ function screenRowQuoteKey(row: Pick<ScreenRow, "symbol" | "exchange">): string
   return buildQuoteKey({ symbol: row.symbol, exchange: row.exchange });
 }
 
-function liveMetric(metric: ScreenMetric, value: number, observedAt: string): ScreenMetric {
-  return { ...metric, value, asOf: observedAt, observedAt, state: "available" };
+function liveMetric(metric: ScreenMetric, value: number, asOf: string, observedAt: string): ScreenMetric {
+  return { ...metric, value, asOf, observedAt, state: "available" };
 }
 
 /**
- * Price, day change, volume and market cap from a live quote, over a snapshot
- * row. Market cap scales with price so it keeps the snapshot's share basis.
- * Membership, sort order and percentiles stay the snapshot's, so rows neither
- * reshuffle nor vanish between snapshots. A quote in another currency unit
- * (GBp against GBP) or older than the snapshot leaves the row alone.
+ * Price, day change, volume and market cap from a quote, over a snapshot row,
+ * as `quote` headlines them: the live quote while the regular session trades,
+ * then the completed session's close and its move (getRegularSessionQuoteDisplay,
+ * as the boards read it), weekend and overnight included, so an extended print
+ * never moves them. That print is the row's `extended`. Market cap scales with
+ * the price so it keeps the snapshot's share basis. Membership, sort order and
+ * percentiles stay the snapshot's, which ranks by the close too, so rows
+ * neither reshuffle nor vanish between snapshots. A quote in another currency
+ * unit (GBp against GBP), a stale one, or one older than the snapshot (a
+ * live quote observed before it, a quote of an earlier day than the
+ * snapshot's price) leaves the row alone.
  */
-function overlayLiveScreenRow(row: ScreenRow, quote: Quote | null): ScreenRow {
-  if (!quote || quote.stale === true || !isFiniteNumber(quote.price) || quote.price <= 0) return row;
-  const snapshotPrice = row.metrics.price;
-  if (!snapshotPrice) return row;
+function overlayLiveScreenRow(row: ScreenRow, quote: Quote | null | undefined): LiveScreenRow {
+  if (!quote || quote.stale === true || !isFiniteNumber(quote.price) || quote.price <= 0 || !isFiniteNumber(quote.lastUpdated)) return row;
   const quoteCurrency = quote.currency?.trim();
   if (quoteCurrency && row.currency && quoteCurrency !== row.currency) return row;
-  const snapshotAt = metricTime(snapshotPrice);
-  if (snapshotAt != null && isFiniteNumber(quote.lastUpdated) && quote.lastUpdated < snapshotAt) return row;
-  if (!isFiniteNumber(quote.lastUpdated)) return row;
-  if (snapshotPrice.value === quote.price && row.metrics.changePercent?.value === quote.changePercent) return row;
+  const snapshotPrice = row.metrics.price;
+  const headline = getRegularSessionQuoteDisplay(quote);
+  if (!headline || !isFiniteNumber(headline.price) || headline.price <= 0) return row;
+  if (headline.completed) {
+    // The snapshot dates a session's price by that session (a pre-market
+    // print by the day it trades in); a quote of an earlier day is older.
+    const snapshotSession = snapshotPrice.asOf && /^\d{4}-\d{2}-\d{2}$/.test(snapshotPrice.asOf) ? snapshotPrice.asOf : null;
+    const quoteDay = quoteTradingDay(quote) ?? headline.closedSession;
+    if (quoteDay && snapshotSession && quoteDay < snapshotSession) return row;
+  } else {
+    const snapshotAt = metricTime(snapshotPrice);
+    if (snapshotAt != null && quote.lastUpdated < snapshotAt) return row;
+  }
+  const print = getExtendedSessionDisplay(quote);
+  const extended = print && isFiniteNumber(print.price) && print.price > 0 ? print : null;
+  if (!extended && snapshotPrice.value === headline.price && row.metrics.changePercent.value === headline.changePercent) return row;
 
   const observedAt = new Date(quote.lastUpdated).toISOString();
-  const metrics = { ...row.metrics, price: liveMetric(snapshotPrice, quote.price, observedAt) };
-  if (isFiniteNumber(quote.changePercent) && metrics.changePercent) {
-    metrics.changePercent = liveMetric(metrics.changePercent, quote.changePercent, observedAt);
+  // A close is dated by its session, as the snapshot dates one.
+  const asOf = headline.completed ? headline.closedSession ?? observedAt : observedAt;
+  const metrics = { ...row.metrics, price: liveMetric(snapshotPrice, headline.price, asOf, observedAt) };
+  if (isFiniteNumber(headline.changePercent)) {
+    metrics.changePercent = liveMetric(metrics.changePercent, headline.changePercent, asOf, observedAt);
   }
-  if (isFiniteNumber(quote.volume) && quote.volume >= 0 && metrics.volume) {
-    metrics.volume = liveMetric(metrics.volume, quote.volume, observedAt);
+  // Outside the session the quote's volume may be the next pre-market's; the snapshot's is the close's session's.
+  if (!headline.completed && isFiniteNumber(quote.volume) && quote.volume >= 0) {
+    metrics.volume = liveMetric(metrics.volume, quote.volume, asOf, observedAt);
   }
   const cap = metrics.marketCap;
-  if (cap && isFiniteNumber(cap.value) && isFiniteNumber(snapshotPrice.value) && snapshotPrice.value > 0) {
-    metrics.marketCap = liveMetric(cap, cap.value * (quote.price / snapshotPrice.value), observedAt);
+  if (isFiniteNumber(cap.value) && isFiniteNumber(snapshotPrice.value) && snapshotPrice.value > 0) {
+    metrics.marketCap = liveMetric(cap, cap.value * (headline.price / snapshotPrice.value), asOf, observedAt);
   }
-  return { ...row, metrics };
+  return { ...row, metrics, ...(extended ? { extended } : {}) };
 }
 
 /** The last overlay per snapshot row, so a row whose quote did not move keeps its object. */
-const liveRows = new WeakMap<ScreenRow, { quote: Quote | null; row: ScreenRow }>();
+const liveRows = new WeakMap<ScreenRow, { quote: Quote | null; row: LiveScreenRow }>();
 
-export function overlayLiveScreenRows(
-  rows: readonly ScreenRow[],
-  entries: ReadonlyMap<string, QueryEntry<Quote>>,
-): ScreenRow[] {
+function overlayRows(rows: readonly ScreenRow[], quoteOf: (key: string) => Quote | null | undefined): LiveScreenRow[] {
   return rows.map((row) => {
-    const entry = entries.get(screenRowQuoteKey(row));
-    if (!entry) return row;
-    const quote = resolveEntryData(entry);
+    const quote = quoteOf(screenRowQuoteKey(row));
+    if (quote === undefined) return row;
     const cached = liveRows.get(row);
     if (cached && cached.quote === quote) return cached.row;
     const next = overlayLiveScreenRow(row, quote);
@@ -70,3 +95,29 @@ export function overlayLiveScreenRows(
     return next;
   });
 }
+
+/** The pane's rows with the streamed quotes on screen laid over them. */
+export function overlayLiveScreenRows(
+  rows: readonly ScreenRow[],
+  entries: ReadonlyMap<string, QueryEntry<Quote>>,
+): LiveScreenRow[] {
+  return overlayRows(rows, (key) => {
+    const entry = entries.get(key);
+    return entry ? resolveEntryData(entry) : undefined;
+  });
+}
+
+/** Rows with quotes keyed by screenRowQuoteKey laid over them, for a report. */
+export function overlayScreenQuotes(rows: readonly ScreenRow[], quotes: ReadonlyMap<string, Quote>): LiveScreenRow[] {
+  return overlayRows(rows, (key) => quotes.get(key));
+}
+
+/** The extended sessions some row has a print for, in the order their columns go. */
+export function screenExtendedSessions(rows: readonly LiveScreenRow[]): ExtendedSession[] {
+  return (["PRE", "POST", "OVERNIGHT"] as const).filter((session) => rows.some((row) => row.extended?.session === session));
+}
+
+/** A row's move in `session`'s print from the close in its price, when it has one. */
+export function screenExtendedMove(row: LiveScreenRow, session: ExtendedSession): number | null {
+  return row.extended?.session === session && isFiniteNumber(row.extended.changePercent) ? row.extended.changePercent : null;
+}

package/src/plugins/builtin/equity-screener/pane.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import {
   Box,
   ScrollBox,
@@ -41,10 +41,10 @@ import {
   type NumericField,
   type ScreenDefinition,
   type ScreenField,
-  type ScreenRow,
 } from "../../../api-client/equity-screener";
 import type { PaneProps } from "../../../types/plugin";
-import { formatPercentileRank } from "../../../utils/format";
+import { formatPercentileRank, formatPercentRaw } from "../../../utils/format";
+import { EXTENDED_SESSION_LABELS, extendedSessionStateLabel, type ExtendedSession } from "../../../market-data/market/status";
 import { useOpenDescription } from "../shared/open-description";
 import { useResearchCloudSession } from "../shared/research-cloud-session";
 import { INITIAL_STREAM_RANGE, streamWindowRows } from "../shared/use-quote-board";
@@ -71,7 +71,7 @@ import {
   screenRowId,
 } from "./model";
 import { useScreenResults } from "./results";
-import { overlayLiveScreenRows } from "./live";
+import { overlayLiveScreenRows, screenExtendedMove, screenExtendedSessions, type LiveScreenRow } from "./live";
 import { useLiveQuoteEntries } from "../../../state/hooks/quote-streaming";
 import { buildScreenerQuoteTargets } from "../../../market-data/quotes/screener-live-quotes";
 import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
@@ -88,15 +88,21 @@ const date = (value: string | null) => value?.slice(0, 10) ?? "--";
 const rank = (value: number | null) =>
   value == null ? "--" : value.toFixed(0);
 
+const EXTENDED_COLUMN_PREFIX = "ext:";
+
 /**
  * Symbol and name, then the focus metric with its covered-universe percentile
  * and date, then the screen's criteria and context metrics as width allows.
+ * A PRE-MKT, AFTER-HRS or OVERNIGHT column, named as MOST names it, follows
+ * CHG% for each session in `extendedSessions`, and is added only whole, as
+ * the metrics are.
  */
 function resultColumns(
   width: number,
   definition: ScreenDefinition,
   metric: NumericField,
   asOf: boolean,
+  extendedSessions: readonly ExtendedSession[] = [],
 ): DataTableColumn[] {
   const [focus, ...others] = resultFields(definition, metric);
   const metricColumn = (field: NumericField): DataTableColumn => ({
@@ -105,6 +111,17 @@ function resultColumns(
     width: columnWidth(field),
     align: "right",
   });
+  const extendedColumns = extendedSessions.map((session): DataTableColumn => ({
+    id: `${EXTENDED_COLUMN_PREFIX}${session}`,
+    label: extendedSessionStateLabel(session),
+    width: 9,
+    align: "right",
+  }));
+  // The extended move reads beside CHG%, or first after the focus metric when that is CHG%.
+  const extras = [
+    ...(focus === "changePercent" ? extendedColumns : []),
+    ...others.flatMap((field) => field === "changePercent" ? [metricColumn(field), ...extendedColumns] : [metricColumn(field)]),
+  ];
   const build = (
     extra: DataTableColumn[],
     exchange: boolean,
@@ -123,8 +140,8 @@ function resultColumns(
   // column is only added when it fits whole.
   const fits = (columns: DataTableColumn[]) => getTableWidth(columns) <= width;
   let shown: DataTableColumn[] = [];
-  for (const field of others) {
-    const next = [...shown, metricColumn(field)];
+  for (const column of extras) {
+    const next = [...shown, column];
     if (!fits(build(next, false, false))) break;
     shown = next;
   }
@@ -138,7 +155,7 @@ function ScreenDetail({
   width,
   height,
 }: {
-  row: ScreenRow;
+  row: LiveScreenRow;
   width: number;
   height: number;
 }) {
@@ -153,22 +170,33 @@ function ScreenDetail({
         {NUMERIC_FIELDS.map((field) => {
           const metric = row.metrics[field];
           const stamp = metricDate(metric);
+          const extended = field === "changePercent" ? row.extended : undefined;
           return (
-            <KeyValueRow
-              key={field}
-              label={screenLabel(field)}
-              labelWidth={24}
-              value={`${formatScreenValue(field, metric.value)} ${metric.unit}`}
-              detail={
-                metric.value === null
-                  ? (metric.reason ?? "unavailable")
-                  : [
-                      metric.percentile.value == null ? null : formatPercentileRank(metric.percentile.value),
-                      stamp.collected ? `collected ${stamp.text}` : stamp.text,
-                      metric.state === "available" ? null : metric.state,
-                    ].filter(Boolean).join(" \u00b7 ")
-              }
-            />
+            <Fragment key={field}>
+              <KeyValueRow
+                label={screenLabel(field)}
+                labelWidth={24}
+                value={`${formatScreenValue(field, metric.value)} ${metric.unit}`}
+                detail={
+                  metric.value === null
+                    ? (metric.reason ?? "unavailable")
+                    : [
+                        metric.percentile.value == null ? null : formatPercentileRank(metric.percentile.value),
+                        stamp.collected ? `collected ${stamp.text}` : stamp.text,
+                        metric.state === "available" ? null : metric.state,
+                      ].filter(Boolean).join(" \u00b7 ")
+                }
+              />
+              {extended ? (
+                // The pre-market, after-hours or overnight print, from the close in Price.
+                <KeyValueRow
+                  label={EXTENDED_SESSION_LABELS[extended.session]}
+                  labelWidth={24}
+                  value={`${formatScreenValue("price", extended.price)} ${row.metrics.price.unit}`}
+                  detail={`${formatPercentRaw(extended.changePercent)}${extended.mark ? " mid" : ""}`}
+                />
+              ) : null}
+            </Fragment>
           );
         })}
       </Box>
@@ -299,7 +327,9 @@ function EquityScreenView({
   // AS OF earns its column only when some row's focus metric is stale; the
   // snapshot decides, so a live quote freshening a row does not reflow the table.
   const staleFocus = snapshotRows.some((row) => row.metrics[metric]?.state === "stale");
-  const columns = resultColumns(width, definition, metric, staleFocus);
+  // A pre-market, after-hours or overnight column only while a row has such a print.
+  const extendedSessions = screenExtendedSessions(rows);
+  const columns = resultColumns(width, definition, metric, staleFocus, extendedSessions);
   const apply = (next: ScreenDefinition) => {
     try {
       setDefinition(parseScreenDefinition(next));
@@ -895,6 +925,13 @@ function EquityScreenView({
             ) : null
           }
           renderCell={(row, column) => {
+            if (column.id.startsWith(EXTENDED_COLUMN_PREFIX)) {
+              // The extended print's move from the close in PRICE and CHG%.
+              const move = screenExtendedMove(row, column.id.slice(EXTENDED_COLUMN_PREFIX.length) as ExtendedSession);
+              return move == null
+                ? { text: "--", color: colors.textDim }
+                : { text: formatPercentRaw(move), color: priceColor(move, colors) };
+            }
             const field = column.id.startsWith("m:")
               ? (column.id.slice(2) as NumericField)
               : null;

package/src/plugins/builtin/estimate-revisions/client.ts

@@ -248,7 +248,7 @@ export async function fetchEstimates(
     );
   } catch (error) {
     // The route answers a missing or unverified session with a bare 401/403; the pane's sign-in wall keys on the shared gate.
-    if (isAccessDenied(error)) throw new Error(CLOUD_SESSION_REQUIRED);
+    if (isAccessDenied(error)) throw new Error(CLOUD_SESSION_REQUIRED, { cause: error });
     throw unavailableOnServer(error, "Estimate revisions are not available yet.");
   }
 }

package/src/plugins/builtin/estimate-revisions/headless.ts

@@ -1,5 +1,7 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
+import { explainRefusal } from "../shared/cloud-denied";
 import { fetchEstimates } from "./client";
+import { estimateRevisionsLockNote } from "./lock-note";
 import { estimateCurrent, periodLabel, pinnedEstimatePeriods } from "./model";
 export const estimateRevisionsHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
@@ -27,7 +29,7 @@ export const estimateRevisionsHeadless: HeadlessPaneDefinition<"bundle"> = {
   ],
   discovery: {
     aliases: ["EM", "GUID", "EEO"],
-    dataRequirements: ["Gloom Cloud analyst snapshots"],
+    dataRequirements: ["Free Gloom sign-in", "Gloom Cloud analyst snapshots"],
     limitations: [
       "Actual collection days and provider backfills remain separate.",
       "Range dispersion is not standard deviation.",
@@ -42,7 +44,12 @@ export const estimateRevisionsHeadless: HeadlessPaneDefinition<"bundle"> = {
       instrument?.symbol ?? symbol,
       instrument?.exchange ?? "",
       ctx.apiClient,
-    );
+    ).catch((error: unknown) => {
+      throw explainRefusal(error, estimateRevisionsLockNote, {
+        symbol: args.symbols[0] ?? null,
+        token: ctx.settings?.tab === "guidance" ? "GUID" : "EM",
+      });
+    });
     const periods = pinnedEstimatePeriods(
       data.periods,
       args.options.period,

package/src/plugins/builtin/estimate-revisions/index.tsx

@@ -2,11 +2,14 @@ import type { PluginModule } from "../plugin-module";
 import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
 import { estimateRevisionsCache } from "./client";
 import { estimateRevisionsHeadless } from "./headless";
+import { estimateRevisionsLockNote } from "./lock-note";
 import { EstimateRevisionsPane } from "./pane";
 export const estimateRevisionsModule: PluginModule = {
   panes: [
     {
       id: "estimate-revisions",
+      reportLockNote: estimateRevisionsLockNote,
+      reportRequirements: ["Free Gloom sign-in"],
       name: "Estimate Revisions",
       icon: "E",
       component: EstimateRevisionsPane,

package/src/plugins/builtin/estimate-revisions/lock-note.ts

@@ -0,0 +1,23 @@
+import type { PaneLock } from "../../../types/plugin";
+import { proLockNote } from "../shared/pro-lock-note";
+
+/**
+ * EM, EEO and GUID read one Gloom Cloud route that asks for a signed-in account
+ * with a verified email, and no plan. The report names the function it was run
+ * for. GUIDE lists a company's latest guidance ranges, as a free preview;
+ * `earnings` lists the next report date with its consensus EPS estimate.
+ */
+export function estimateRevisionsLockNote(lock: PaneLock): string {
+  const guidance = lock.token === "GUID";
+  return proLockNote(lock, {
+    token: guidance ? "GUID" : "EM",
+    needs: "sign-in",
+    does: guidance
+      ? "it reads the EPS guidance a company issued, cited from its filings and calls, against consensus"
+      : "it reads consensus EPS estimates by fiscal period, how they were revised, the surprises against reported EPS and the guidance",
+    shows: "it",
+    free: guidance
+      ? (ticker, company) => `gloomberb fn GUIDE ${ticker} lists ${company}'s latest guidance ranges, with the date each was issued.`
+      : (ticker, company) => `gloomberb earnings ${ticker} lists ${company}'s next report date with its consensus EPS estimate.`,
+  });
+}