gloomberb 0.18.3 → 0.18.4

package/src/plugins/builtin/econ-statistics/view.ts

@@ -2,6 +2,7 @@ import { historySpan, type HistorySpan } from "../shared/history-span";
 import { latestMoveRank, MOVE_HORIZONS, type MoveRank } from "../shared/move-rank";
 import { periodsPerYear, type StatPoint } from "../shared/stat-transform";
 import { sigmaVsTrend } from "../shared/trend";
+import { periodReleasedText, periodStartPeriodicity, releasedText } from "../../../utils/release-date";
 import type { StatBuild } from "./client";
 import type { StatDef } from "./defs";
 
@@ -23,6 +24,14 @@ export interface StatViewModel {
   period: string;
   /** What the latest print is a reading of, in full: "Aug 2026", "Q2 2026", "week ending 2026-10-03", "2026-10-09". */
   reading: string;
+  /** The day the latest print was released (`YYYY-MM-DD`), when FRED says; null for a daily rate. */
+  releasedOn: string | null;
+  /** `released Tue 20 Oct`, or null when the release is not known. */
+  released: string | null;
+  /** The reading and its release, as every macro pane says it: "Sep 2026, released Tue 20 Oct". */
+  readingReleased: string;
+  /** How often a print dated by its period's first day publishes; null for weekly and daily prints. */
+  periodicity: "monthly" | "quarterly" | "annual" | null;
   /** The print before this one, for the direction of the last move. */
   previous: StatPoint | null;
   yearAgo: StatPoint | null;
@@ -130,13 +139,19 @@ export function projectStat(
   // High, low, mean and percentile describe the selected window, like the chart.
   const visible = sliceByRange(points, range);
   const atOrBelow = visible.filter((point) => point.value <= latest.value).length;
+  const reading = formatStatReading(latest.date, perYear);
+  const releasedOn = build.releasedOn ?? null;
 
   return {
     stat,
     range,
     latest,
     period: formatStatPeriod(latest.date, perYear),
-    reading: formatStatReading(latest.date, perYear),
+    reading,
+    releasedOn,
+    released: releasedText(releasedOn, latest.date),
+    readingReleased: periodReleasedText(reading, releasedOn, latest.date),
+    periodicity: periodStartPeriodicity(latest.date, perYear),
     previous,
     yearAgo,
     changeOnPrevious: previous ? latest.value - previous.value : null,

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

@@ -6,7 +6,9 @@ import type {
   ScreenPayload,
   ScreenQuery,
   SavedScreen,
+  ScreenCheckPayload,
 } from "../../../api-client/equity-screener";
+import { screenCheckTicker, validateScreenCheck } from "./screen-check";
 
 type ScreenerClient = Pick<typeof apiClient, "equityScreener">;
 const json = (method: string, body: unknown, init: RequestInit = {}): RequestInit => ({
@@ -22,7 +24,8 @@ export const screenerApi = {
   fields: (signal?: AbortSignal) => apiClient.equityScreener<ScreenFieldsResponse>("fields?include=social,research,attention,hiring-apps,kpis,volatility,dividends", { signal }),
   export: (definition: ScreenDefinition, snapshotId: string) =>
     apiClient.equityScreener<ScreenExportResponse>("export", json("POST", { ...definition, snapshotId }, { headers: { Accept: "application/json" } })),
-  saved: async () => (await apiClient.equityScreener<{ screens: SavedScreen[] }>("saved")).screens,
+  saved: async (signal?: AbortSignal, client: ScreenerClient = apiClient) =>
+    (await client.equityScreener<{ screens: SavedScreen[] }>("saved", { signal })).screens,
   create: async (name: string, definition: ScreenDefinition) =>
     (await apiClient.equityScreener<{ screen: SavedScreen }>("saved", json("POST", { name, definition }))).screen,
   update: async (id: string, revision: number, name: string, definition: ScreenDefinition) =>
@@ -75,9 +78,24 @@ export function validateSavedScreen(screen: SavedScreen): SavedScreen {
   parseScreenDefinition(screen.definition);
   return screen;
 }
-export async function fetchSavedScreens() {
-  const rows = await screenerApi.saved();
+export async function fetchSavedScreens(signal?: AbortSignal, client: ScreenerClient = apiClient) {
+  const rows = await screenerApi.saved(signal, client);
   if (!Array.isArray(rows) || rows.length > 50)
     throw new Error("Invalid saved screen collection.");
   return rows.map(validateSavedScreen);
 }
+
+export async function fetchScreenCheck(
+  definition: ScreenDefinition,
+  tickerText: string,
+  snapshotId?: string,
+  signal?: AbortSignal,
+  client: ScreenerClient = apiClient,
+): Promise<ScreenCheckPayload> {
+  const ticker = screenCheckTicker(tickerText);
+  const parsed = parseScreenDefinition(definition);
+  const payload = await client.equityScreener<ScreenCheckPayload>("check", json("POST", {
+    ...parsed, ...ticker, ...(snapshotId ? { snapshotId } : {}),
+  }, { signal }));
+  return validateScreenCheck(payload, parsed, ticker, snapshotId);
+}

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

@@ -11,12 +11,13 @@ import { EXTENDED_SESSION_LABELS, type ExtendedSession } from "../../../market-d
 import { buildQuoteKey } from "../../../market-data/selectors";
 import type { Quote } from "../../../types/financials";
 import { formatCurrency, formatPercentRaw } from "../../../utils/format";
-import { fetchScreen } from "./client";
+import { fetchSavedScreens, fetchScreen, fetchScreenCheck } from "./client";
+import { checkRows, screenCheckSummary, screenCheckTicker } from "./screen-check";
 import { overlayScreenQuotes, screenExtendedSessions, sortLiveScreenRows } from "./live";
 import {
   DEFAULT_SCREEN,
   EXAMPLE_SCREEN_DEFINITION,
-  formatScreenValue,
+  formatScreenMetric,
   metricDate,
   parseScreenDefinition,
   screenColumnLabel,
@@ -72,7 +73,7 @@ function extendedColumn(session: ExtendedSession): HeadlessPaneColumn {
 
 /** 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.";
+  const pointer = "The example in gloom catalog EQS is a valid definition to start from.";
   let value: unknown;
   try {
     value = JSON.parse(text);
@@ -91,6 +92,26 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
   freshness: { status: "not-a-feed", basis: "screener snapshot" },
   argument: { kind: "none" },
   options: [
+    {
+      key: "check",
+      type: "string",
+      placeholder: "ticker",
+      description: "Check one ticker against every criterion, including the screen's currency filter.",
+      example: "--check NVDA",
+      shot: { reportOnly: "checks a ticker against the screen; use Check ticker in the EQS pane" },
+      normalize: (value) => {
+        screenCheckTicker(value);
+        return value.trim();
+      },
+    },
+    {
+      key: "saved",
+      type: "string",
+      placeholder: "id-or-name",
+      description: "Use a saved screen by ID or exact name. Cannot be combined with --definition.",
+      shot: { reportOnly: "opens a saved screen for the report; open it from Saved in the EQS pane" },
+      replaces: ["definition"],
+    },
     {
       key: "definition",
       type: "string",
@@ -124,9 +145,50 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
     ],
   },
   async load(args, ctx) {
-    const definition = args.options.definition
+    if (args.options.saved && args.options.definition) throw new Error("Choose --saved or --definition, not both.");
+    let definition = args.options.definition
       ? readDefinition(String(args.options.definition))
       : DEFAULT_SCREEN;
+    let savedName: string | undefined;
+    if (args.options.saved) {
+      const screens = await fetchSavedScreens(ctx.signal, ctx.apiClient);
+      const wanted = String(args.options.saved).trim();
+      const byId = screens.find((screen) => screen.id === wanted);
+      const matches = byId ? [byId] : screens.filter((screen) => screen.name.toLowerCase() === wanted.toLowerCase());
+      if (matches.length !== 1) throw new Error(matches.length
+        ? `More than one saved screen is named ${JSON.stringify(wanted)}. Use its ID with --saved.`
+        : `Saved screen ${JSON.stringify(wanted)} was not found. Open Saved in EQS to see your screens.`);
+      definition = matches[0]!.definition;
+      savedName = matches[0]!.name;
+    }
+    if (args.options.check) {
+      const data = await fetchScreenCheck(definition, String(args.options.check), undefined, ctx.signal, ctx.apiClient);
+      return {
+        freshness: { asOf: data.snapshot.assembledAt },
+        complete: data.status === "available" && data.warnings.length === 0,
+        errors: data.warnings,
+        sections: data.criteria.length === 0 ? [{
+          title: data.row ? `${data.row.symbol}:${data.row.exchange}` : data.symbol,
+          entries: [{ label: "Result", value: screenCheckSummary(data) }],
+        }] : [{
+          title: `${data.row ? `${data.row.symbol}:${data.row.exchange}` : data.symbol} · ${screenCheckSummary(data)}`,
+          columns: [
+            { key: "criterion", header: "Criterion" },
+            { key: "value", header: "Value", align: "right" as const },
+            { key: "result", header: "Result" },
+            { key: "asOf", header: "As of" },
+            { key: "state", header: "State" },
+            { key: "reason", header: "Reason", underRow: true },
+          ],
+          rows: checkRows(data),
+        }],
+        metadata: {
+          definition: data.definition, snapshot: data.snapshot, symbol: data.symbol,
+          listing: data.row, matches: data.matches, status: data.status,
+          criteria: data.criteria, ...(savedName ? { savedScreen: savedName } : {}),
+        },
+      };
+    }
     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
@@ -147,7 +209,7 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
     const empty = currencyEmpty
       ? [
         `${currencyEmpty.title} ${currencyEmpty.detail}`,
-        `In the base currency, ${currencyEmpty.base.currency}: gloomberb fn EQS --definition '${spacedJson(currencyEmpty.base)}'${metric === "marketCap" ? "" : ` --metric ${metric}`}`,
+        `In the base currency, ${currencyEmpty.base.currency}: gloom fn EQS --definition '${spacedJson(currencyEmpty.base)}'${metric === "marketCap" ? "" : ` --metric ${metric}`}`,
       ].join("\n")
       : null;
     // Payload status also counts ordinary per-field sparsity; only generation
@@ -190,7 +252,7 @@ export const equityScreenerHeadless: HeadlessPaneDefinition<"bundle"> = {
               extendedPrice: row.extended?.price ?? null,
               extendedChangePercent: row.extended?.changePercent ?? null,
               ...(row.extended?.mark ? { extendedMark: true } : {}),
-              value: formatScreenValue(metric, observation.value),
+              value: formatScreenMetric(metric, observation),
               unit: observation.unit,
               percentile:
                 observation.percentile.value == null

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

@@ -119,7 +119,7 @@ const LIVE_SORT_FIELDS: ReadonlySet<string> = new Set(["price", "changePercent",
  * Rows in the screen's order by the figures they show. A sort on a field the
  * quotes move (price, change, volume, market cap) is redone on the overlaid
  * values, so the column reads monotone: GRAB's snapshot cap, two closes old,
- * kept it above MANH after its quote moved it below (GLO-754). Rows without a
+ * kept it above MANH after its quote moved it below. Rows without a
  * value stay last, and ties keep the snapshot's order. Any other sort is the
  * snapshot's, which the overlay does not touch.
  */

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

@@ -21,6 +21,7 @@ import { yearToDateBaseLabel } from "../../../market-data/market/year-to-date";
 import { canonicalExchange } from "../../../utils/exchanges";
 import { LATEST_DISTRIBUTION, TRAILING_DIVIDEND_BASIS } from "../../../utils/forward-dividend";
 import { formatCompact, formatNumber } from "../../../utils/format";
+import { formatPriceEarnings, NOT_MEANINGFUL } from "../../../utils/price-earnings";
 import { kpiFreeLimitNote } from "../company-kpis/model";
 
 /**
@@ -135,6 +136,11 @@ export function formatScreenValue(field: NumericField, value: number | null): st
   return SIGNED.has(field) && value > 0 && fixed !== "0.0" ? `+${fixed}` : fixed;
 }
 
+/** A row's metric as a cell prints it: N/M for a multiple that is not meaningful, as RV and `valuation` print it. */
+export function formatScreenMetric(field: NumericField, metric: Pick<ScreenMetric, "value" | "notMeaningful">): string {
+  return metric.value == null && metric.notMeaningful ? formatPriceEarnings(NOT_MEANINGFUL) : formatScreenValue(field, metric.value);
+}
+
 /**
  * A row's dividend yield basis, in the words `ticker` and `DVD` use. Gloom
  * Cloud serves each row's statistics yield as it is stated, forward for most

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

@@ -3,8 +3,10 @@ import {
   Box,
   ScrollBox,
   useRendererHost,
+  useUiCapabilities,
   type ScrollBoxRenderable,
 } from "../../../ui";
+import { withCompanyLogo } from "../../../components/company-logo";
 import {
   Button,
   confirmDialog,
@@ -52,6 +54,7 @@ import { useSampledValue } from "../../../state/hooks/live-ticker-financials";
 import { usePlanAccess } from "../../../api-client/plan-access";
 import { SignInWall } from "../cloud/auth-actions";
 import { CriterionEditor } from "./criterion-editor";
+import { ScreenTickerCheck } from "./ticker-check";
 import {
   fetchSavedScreens,
   fetchScreenFields,
@@ -63,6 +66,7 @@ import {
   criterionText,
   DEFAULT_SCREEN,
   dividendYieldBasis,
+  formatScreenMetric,
   formatScreenValue,
   metricDate,
   parseScreenDefinition,
@@ -70,6 +74,7 @@ import {
   SIGN_COLORED,
   screenColumnLabel,
   screenCurrencyEmpty,
+  screenDefinitionKey,
   screenLabel,
   screenRowId,
   screenYtdBase,
@@ -183,7 +188,7 @@ function ScreenDetail({
               <KeyValueRow
                 label={screenLabel(field)}
                 labelWidth={24}
-                value={`${formatScreenValue(field, metric.value)} ${metric.unit}`}
+                value={metric.value == null && metric.notMeaningful ? formatScreenMetric(field, metric) : `${formatScreenValue(field, metric.value)} ${metric.unit}`}
                 detail={
                   metric.value === null
                     ? (metric.reason ?? "unavailable")
@@ -242,6 +247,7 @@ function EquityScreenView({
   const colors = useThemeColors(),
     dialog = useDialog(),
     host = useRendererHost();
+  const logos = useUiCapabilities().nativePaneChrome === true;
   const { notify } = usePluginAppActions();
   const openDescription = useOpenDescription();
   const session = useResearchCloudSession(),
@@ -275,6 +281,10 @@ function EquityScreenView({
   const [saveForm, setSaveForm] = useState(false),
     [name, setName] = useState("");
   const [actionError, setActionError] = useState<string | null>(null);
+  const [check, setCheck] = useState<{
+    definition: ScreenDefinition;
+    snapshotId?: string;
+  } | null>(null);
   const fields = useAsyncResource(loadFields);
   const savedLoader = useCallback(
     () => fetchSavedScreens(),
@@ -362,6 +372,7 @@ function EquityScreenView({
     try {
       setDefinition(parseScreenDefinition(next));
       setOpenId(null);
+      setCheck(null);
       setActionError(null);
     } catch (error) {
       setActionError(errorText(error));
@@ -371,11 +382,22 @@ function EquityScreenView({
     setMode(next);
     setEditing(null);
     setSaveForm(false);
+    setCheck(null);
     setActionError(null);
   };
   const research = () => {
     if (selected) openDescription(selected.symbol, selected.exchange);
   };
+  const startCheck = () => {
+    setCheck({
+      definition,
+      snapshotId: data?.snapshot && screenDefinitionKey(data.definition) === screenDefinitionKey(definition)
+        ? data.snapshot.id
+        : undefined,
+    });
+    setActionError(null);
+  };
+  const checkHint = { id: "check", key: "t", label: "check ticker", title: "Check ticker", onPress: startCheck, disabled: false };
   const startSave = () => {
     if (!access.emailVerified) { switchMode("saved"); return; }
     setName(currentSaved?.name ?? "");
@@ -472,7 +494,7 @@ function EquityScreenView({
   useAutoRefresh(results.updatedAt, results.load);
   const openQueryControl = () => queryControl.current?.open();
   const hints =
-    saveForm || editing !== null
+    saveForm || editing !== null || check
       ? []
       : mode === "criteria"
         ? [
@@ -499,6 +521,7 @@ function EquityScreenView({
                 }),
               disabled: !definition.criteria.length,
             },
+            checkHint,
           ]
         : mode === "saved"
           ? [
@@ -518,6 +541,7 @@ function EquityScreenView({
                 ? [{ id: "metric", key: "m", label: "etric", onPress: openQueryControl }]
                 : []),
               { id: "save", key: "s", label: "ave screen", onPress: startSave },
+              checkHint,
               {
                 id: "export",
                 key: "x",
@@ -538,7 +562,7 @@ function EquityScreenView({
             ];
   usePaneFooter(
     "equity-screener",
-    () => ({
+    () => check ? null : ({
       info: [
         ...(results.loading || results.loadingMore
           ? [
@@ -594,11 +618,13 @@ function EquityScreenView({
       saving,
       exporting,
       hints,
+      check,
     ],
   );
   usePaneNoticeFooter({
     registrationId: "equity-screener:notices",
     focused,
+    enabled: !check,
     notices: [
       ...(data?.warnings ?? []),
       ...(opened?.warnings ?? []),
@@ -650,6 +676,7 @@ function EquityScreenView({
       event.targetEditable ||
       event.ctrl ||
       event.meta ||
+      check ||
       editing !== null
     )
       return;
@@ -679,7 +706,7 @@ function EquityScreenView({
     tabs: TABS,
     activeValue: mode,
     onSelect: switchMode,
-    focused: focused && !saveForm && editing === null,
+    focused: focused && !saveForm && editing === null && !check,
     dense: true,
   });
   const bodyHeight = Math.max(5, height - 1 - tabRows);
@@ -972,7 +999,7 @@ function EquityScreenView({
                   ? priceColor(Math.abs(observation.value) < 0.05 ? 0 : observation.value, colors)
                   : undefined;
                 return {
-                  text: formatScreenValue(field, observation.value),
+                  text: formatScreenMetric(field, observation),
                   color: observation.state === "stale" ? colors.warning : change,
                 };
               }
@@ -983,7 +1010,7 @@ function EquityScreenView({
                 return focus.state === "stale"
                   ? { text: metricDate(focus).text, color: colors.warning }
                   : { text: "" };
-              if (column.id === "name") return { text: row.name ?? "--" };
+              if (column.id === "name") return withCompanyLogo({ text: row.name ?? "--" }, row.name ? row : null, logos);
               return { text: String(row[column.id as "symbol"] ?? "--") };
             }}
             sortColumnId={
@@ -1026,11 +1053,19 @@ function EquityScreenView({
       {tabStrip}
       <PageStackView
         focused={focused}
-        detailOpen={saveForm}
-        onBack={() => setSaveForm(false)}
-        detailTitle="Save screen"
+        detailOpen={saveForm || !!check}
+        onBack={() => { setSaveForm(false); setCheck(null); }}
+        detailTitle={check ? "Check ticker" : "Save screen"}
         rootContent={body}
-        detailContent={saveForm ? saveContent : null}
+        detailContent={check ? (
+          <ScreenTickerCheck
+            definition={check.definition}
+            snapshotId={check.snapshotId}
+            width={width}
+            height={bodyHeight - 1}
+            focused={focused}
+          />
+        ) : saveForm ? saveContent : null}
       />
     </Box>
   );

package/src/plugins/builtin/equity-screener/screen-check.ts

@@ -0,0 +1,90 @@
+import type { ScreenCheckPayload, ScreenCriterion, ScreenDefinition } from "../../../api-client/equity-screener";
+import { canonicalExchange, parsePublicTickerKey } from "../../../utils/exchanges";
+import { criterionText, parseScreenDefinition, screenDefinitionKey, screenLabel } from "./model";
+
+/** One listing, with the same exchange aliases the rest of the app accepts. */
+export function screenCheckTicker(text: string): { symbol: string; exchange?: string } {
+  const ticker = parsePublicTickerKey(text.trim());
+  if (!/^[A-Z0-9][A-Z0-9./-]{0,31}$/.test(ticker.symbol)
+    || (ticker.exchange !== undefined && !/^[A-Z0-9_-]{1,24}$/.test(ticker.exchange)))
+    throw new Error("Enter one ticker, such as NVDA or NVDA:NASDAQ.");
+  return ticker;
+}
+
+const dated = (value: unknown): value is string => typeof value === "string" && Number.isFinite(Date.parse(value));
+const nullableText = (value: unknown) => value === null || typeof value === "string";
+// Stored equity listings share one identity across share-class separators.
+const listingSymbol = (symbol: string) => symbol.replace(/[./]/g, "-");
+
+/** Reject a response for another definition, listing or snapshot before showing its verdict. */
+export function validateScreenCheck(
+  value: unknown,
+  definition: ScreenDefinition,
+  ticker: { symbol: string; exchange?: string },
+  snapshotId?: string,
+): ScreenCheckPayload {
+  const data = value as ScreenCheckPayload;
+  const invalid = () => new Error("Invalid ticker check response. Refresh the screen and try again.");
+  if (!data || data.version !== 1 || !["available", "partial", "not-covered"].includes(data.status)
+    || data.symbol !== ticker.symbol || !Array.isArray(data.criteria)
+    || !Array.isArray(data.warnings) || data.warnings.some((warning) => typeof warning !== "string")
+    || !data.snapshot || typeof data.snapshot.id !== "string"
+    || !dated(data.snapshot.assembledAt) || !dated(data.snapshot.expiresAt)
+    || Date.parse(data.snapshot.expiresAt) <= Date.parse(data.snapshot.assembledAt)
+    || (snapshotId !== undefined && data.snapshot.id !== snapshotId)) throw invalid();
+  if (screenDefinitionKey(data.definition) !== screenDefinitionKey(definition)) throw invalid();
+  const expected: ScreenCriterion[] = [
+    ...(definition.currency ? [{ field: "currency", op: "in", value: [definition.currency] } as ScreenCriterion] : []),
+    ...parseScreenDefinition(definition).criteria,
+  ];
+  if (data.criteria.length !== expected.length) throw invalid();
+  const covered = data.status !== "not-covered";
+  if (covered) {
+    if (!data.row || typeof data.row.symbol !== "string" || listingSymbol(data.row.symbol) !== listingSymbol(ticker.symbol) || typeof data.row.exchange !== "string"
+      || (ticker.exchange && canonicalExchange(data.row.exchange) !== ticker.exchange)
+      || ![data.row.name, data.row.currency, data.row.sector, data.row.industry].every(nullableText)
+      || typeof data.matches !== "boolean") throw invalid();
+  } else if (data.row !== null || data.matches !== null) throw invalid();
+  for (let i = 0; i < expected.length; i++) {
+    const entry = data.criteria[i]!;
+    if (!entry || typeof entry.implicit !== "boolean" || entry.implicit !== (i === 0 && !!definition.currency)
+      || !["available", "partial", "stale", "unavailable", "missing", "not-covered"].includes(entry.state)
+      || typeof entry.unit !== "string" || !nullableText(entry.reason)
+      || (entry.asOf !== null && !dated(entry.asOf))
+      || (entry.observedAt !== null && !dated(entry.observedAt))
+      || (entry.value !== null && typeof entry.value !== "string" && (typeof entry.value !== "number" || !Number.isFinite(entry.value)))
+      || (covered ? typeof entry.passes !== "boolean" : entry.passes !== null || entry.value !== null || entry.state !== "not-covered")) throw invalid();
+    // Parsing normalizes object key order and category lists on both sides.
+    const one = (criterion: ScreenCriterion) => screenDefinitionKey({ ...definition, criteria: [criterion] });
+    if (one(entry.criterion) !== one(expected[i]!)) throw invalid();
+  }
+  if (covered && data.matches !== data.criteria.every((entry) => entry.passes)) throw invalid();
+  return data;
+}
+
+const number = (value: number) => value.toLocaleString("en-US", { maximumSignificantDigits: 21 });
+function checkCriterionText(criterion: ScreenCriterion): string {
+  if (!("value" in criterion) || criterion.op === "in") return criterionText(criterion);
+  const operators = { gte: ">=", lte: "<=", gt: ">", lt: "<", eq: "=", between: "between" };
+  const threshold = Array.isArray(criterion.value) ? criterion.value.map(number).join(", ") : number(criterion.value);
+  return `${screenLabel(criterion.field)} ${operators[criterion.op]} ${threshold}`;
+}
+
+/** The verdict uses stored screening values, never the live quote overlaid on Results. */
+export function screenCheckSummary(data: ScreenCheckPayload): string {
+  return data.matches === null ? "Not covered" : data.matches ? "Passes all criteria" : "Does not match";
+}
+
+export function checkRows(data: ScreenCheckPayload) {
+  return data.criteria.map((entry, index) => ({
+    id: String(index),
+    criterion: checkCriterionText(entry.criterion),
+    value: entry.state === "not-covered" ? "Not covered" : entry.value === null ? "Missing" : typeof entry.value === "number"
+      ? `${number(entry.value)}${entry.unit ? ` ${entry.unit}` : ""}` : entry.value,
+    result: entry.passes === null ? "Not evaluated" : entry.passes ? "Pass" : "Fail",
+    asOf: entry.asOf?.slice(0, 10) ?? (entry.observedAt ? `${entry.observedAt.slice(0, 10)} (collected)` : "--"),
+    state: entry.state,
+    reason: entry.reason,
+    passes: entry.passes,
+  }));
+}