gloomberb 0.16.4 → 0.16.6

package/src/plugins/builtin/portfolio-list/quick-add/index.tsx

@@ -18,6 +18,7 @@ import type { TickerRecord } from "../../../../types/ticker";
 import { addTickerToPortfolio, addTickerToWatchlist } from "../mutations";
 import { captureAttentionAction } from "../../../../telemetry/attention-counts";
 import { publicTickerKey } from "../../../../utils/exchanges";
+import { tickerChangeLine } from "../../../../tickers/ticker-changes";
 import {
   IDLE_VALIDATION,
   isPlausibleTickerQuery,
@@ -30,6 +31,8 @@ import {
 } from "./resolution";
 
 const QUICK_ADD_DEBOUNCE_MS = 300;
+/** The pane key that opens the add row, as its footer hint shows it. */
+export const QUICK_ADD_KEY = "a";
 
 export type { QuickAddCollectionKind } from "./resolution";
 
@@ -80,15 +83,20 @@ function QuickAddPreview({
   const exchange = exchangeLabelFromValidation(validation);
   const showSymbol = normalizeQuickAddQuery(validation.symbol) !== validation.query;
   const symbolPrefix = showSymbol ? `${validation.symbol} ` : "";
+  // A symbol whose company moved on says where it went before it is added, ahead of the
+  // name of what lists there now; the add notice prints the whole line.
+  const change = validation.change?.kind === "moved" ? validation.change : null;
+  const moved = change?.listed ? `${change.issuer ?? `the former ${change.symbol}`} trades as ${change.tradesAs}` : change?.note;
 
   return (
     <Box flexDirection="row" overflow="hidden">
-      <Text fg={colors.textDim}>{`${symbolPrefix}${priceText} `}</Text>
-      <Text fg={changeValue == null ? colors.textDim : priceColor(changeValue)}>
+      <Text fg={colors.textDim} flexShrink={0}>{`${symbolPrefix}${priceText} `}</Text>
+      <Text fg={changeValue == null ? colors.textDim : priceColor(changeValue)} flexShrink={0}>
         {formatPercentRaw(changeValue)}
       </Text>
-      {name ? <Text fg={colors.textMuted}>{`  ${name}`}</Text> : null}
-      {exchange ? <Text fg={colors.textDim}>{`  ${exchange}`}</Text> : null}
+      {moved ? <Text fg={colors.warning} flexShrink={0}>{`  ${moved}`}</Text> : null}
+      {name && (!change || change.listed) ? <Text fg={colors.textMuted}>{`  ${name}`}</Text> : null}
+      {exchange && !change ? <Text fg={colors.textDim}>{`  ${exchange}`}</Text> : null}
     </Box>
   );
 }
@@ -101,6 +109,7 @@ export function QuickAddTickerInput({
   width,
   onAdded,
   onFocusChange,
+  focusRequest = 0,
 }: {
   collectionId: string;
   collectionKind: QuickAddCollectionKind;
@@ -109,6 +118,12 @@ export function QuickAddTickerInput({
   width: number;
   onAdded: (symbol: string) => void;
   onFocusChange?: (focused: boolean) => void;
+  /**
+   * Bumped by a control outside the row, such as the empty table's
+   * "+ ticker" button, to open it. A click there focuses the pane in the same
+   * press, so the row opens once the pane is focused.
+   */
+  focusRequest?: number;
 }) {
   const dispatch = useAppDispatch();
   const { notify } = usePluginAppActions();
@@ -132,6 +147,13 @@ export function QuickAddTickerInput({
     setInputFocused(false);
   }, []);
 
+  const handledFocusRequestRef = useRef(focusRequest);
+  useEffect(() => {
+    if (focusRequest === handledFocusRequestRef.current || !focused) return;
+    handledFocusRequestRef.current = focusRequest;
+    focusInput();
+  }, [focusInput, focusRequest, focused]);
+
   const resetInput = useCallback(() => {
     setInputValue("");
     setValidation(IDLE_VALIDATION);
@@ -295,13 +317,13 @@ export function QuickAddTickerInput({
       }
 
       onAdded(result.ticker.metadata.ticker);
-      notify({
-        type: "success",
-        body: tf("Added {symbol} to {collection}.", {
-          symbol: result.ticker.metadata.ticker,
-          collection: collectionName,
-        }),
+      const added = tf("Added {symbol} to {collection}.", {
+        symbol: result.ticker.metadata.ticker,
+        collection: collectionName,
       });
+      // As `watchlist add` prints it: FB now lists another security, Meta trades as META.
+      const change = tickerChangeLine(currentValidation.change);
+      notify({ type: "success", body: change ? `${added} ${change}.` : added });
       resetInput();
       queueMicrotask(() => inputRef.current?.focus?.());
     } catch {
@@ -350,7 +372,7 @@ export function QuickAddTickerInput({
 
   // The row shows only its placeholder, so the footer says which key reaches it.
   usePaneFooter("portfolio-list:quick-add", () => ({
-    hints: inputFocused ? [] : [{ id: "add", key: "a", label: "dd", onPress: focusInput }],
+    hints: inputFocused ? [] : [{ id: "add", key: QUICK_ADD_KEY, label: "dd", onPress: focusInput }],
   }), [focusInput, inputFocused]);
 
   return (

package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts

@@ -8,6 +8,14 @@ import {
 import type { Quote } from "../../../../types/financials";
 import type { TickerRecord } from "../../../../types/ticker";
 import { canonicalExchange, parsePublicTickerKey, publicTickerKey } from "../../../../utils/exchanges";
+import {
+  describeTickerChange,
+  isUsSymbolVenue,
+  quotedListing,
+  startTickerChangeLookup,
+  tickerChangeLine,
+  type TickerChange,
+} from "../../../../tickers/ticker-changes";
 
 const QUICK_ADD_MAX_QUERY_LENGTH = 32;
 const QUICK_ADD_SYMBOL_RE = /^[A-Z0-9][A-Z0-9.\-\s]*$/;
@@ -20,6 +28,8 @@ interface ResolvedQuickAdd {
   resolved: ResolvedTickerSearch;
   ticker: TickerRecord | null;
   quote: Quote | null;
+  /** The symbol changed (FB became META), as `watchlist add` says it. */
+  change: TickerChange | null;
 }
 
 export type QuickAddValidation =
@@ -135,6 +145,8 @@ export async function resolveQuickAddValidation({
   if (!registry) {
     return { status: "error", query, message: "Ticker lookup unavailable" };
   }
+  // Beside the search, so a symbol that changed (FB is now META) costs no wait.
+  const changes = startTickerChangeLookup(registry.marketData, query);
 
   try {
     const resolved = await resolveTickerSearch({
@@ -144,7 +156,8 @@ export async function resolveQuickAddValidation({
       dataProvider: registry.marketData,
     });
     if (!resolved) {
-      return { status: "missing", query, message: "No exact ticker match" };
+      const change = describeTickerChange(query, await changes.settle(), null);
+      return { status: "missing", query, message: tickerChangeLine(change) ?? "No exact ticker match" };
     }
 
     const symbol = resolved.symbol;
@@ -163,6 +176,12 @@ export async function resolveQuickAddValidation({
       }
     }
 
+    // A listing abroad is not the US symbol the changes are of.
+    const venue = resolved.kind === "provider" && resolved.result.exchange === "SMART"
+      ? resolved.result.primaryExchange
+      : exchangeFromResolved(resolved);
+    const payload = isUsSymbolVenue(venue) ? await changes.settle() : null;
+    const name = ticker?.metadata.name || (resolved.kind === "provider" ? resolved.result.name : "");
     return {
       status: tickerBelongsToCollection(ticker, collectionKind, collectionId) ? "duplicate" : "ready",
       query,
@@ -170,6 +189,7 @@ export async function resolveQuickAddValidation({
       resolved,
       ticker,
       quote,
+      change: describeTickerChange(query, payload, quote ? quotedListing(quote) : { name }),
     };
   } catch (error) {
     if (error instanceof AmbiguousTickerError && !(error instanceof AmbiguousContractError)) {

package/src/plugins/builtin/portfolio-list/settings.ts

@@ -13,6 +13,8 @@ export interface PortfolioPaneSettings {
   viewMode: PortfolioViewMode;
   hideHeader: boolean;
   hideCash: boolean;
+  /** Value a portfolio at the regular close rather than the latest print (`fn PF --close`). */
+  valueAtClose: boolean;
 }
 
 export interface CollectionEntry {
@@ -47,6 +49,9 @@ const PORTFOLIO_COLUMN_DEFS: ColumnConfig[] = [
   { id: "rating", label: "RATING", width: 7, align: "right", format: "number" },
   { id: "ex_div", label: "EX-DIV", width: 7, align: "right" },
   { id: "next_earn", label: "ERN", width: 7, align: "right" },
+  // The stock's perpetual: its premium to the stock's last price and its funding per eight hours.
+  { id: "perp_premium", label: "PERP%", width: 7, align: "right", format: "percent" },
+  { id: "perp_funding", label: "FUND 8H", width: 8, align: "right", format: "percent" },
   { id: "side", label: "SIDE", width: 5, align: "left" },
   { id: "shares", label: "SHARES", width: 9, align: "right", format: "number" },
   { id: "avg_cost", label: "AVG COST", width: 10, align: "right", format: "currency" },
@@ -64,6 +69,8 @@ const PORTFOLIO_COLUMN_DEFS: ColumnConfig[] = [
   { id: "mark_delta", label: "MARK%", width: 8, align: "right", format: "percent" },
   { id: "acq_date", label: "ACQ", width: 7, align: "right" },
   { id: "held", label: "HELD", width: 6, align: "right" },
+  // When the price a row is valued at is from: its print, or the regular close.
+  { id: "as_of", label: "AS OF UTC", width: 10, align: "right" },
 ];
 
 const PORTFOLIO_COLUMNS_BY_ID = new Map(PORTFOLIO_COLUMN_DEFS.map((column) => [column.id, column]));
@@ -171,6 +178,9 @@ function withTargetColumns(columnIds: string[]): string[] {
 function describeColumnOption(column: ColumnConfig): string {
   if (column.id === PRICE_SPARKLINE_COLUMN_ID) return "One-month price sparkline.";
   if (TARGET_COLUMN_IDS.has(column.id)) return "Shown by default once the portfolio has target weights.";
+  if (column.id === "perp_premium") return "Premium of the stock's perpetual to its last price.";
+  if (column.id === "perp_funding") return "Funding of the stock's perpetual, per 8 hours.";
+  if (column.id === "as_of") return "When each row's price is from: its last print, or the regular close.";
   return PORTFOLIO_ONLY_COLUMN_IDS.has(column.id)
     ? "Visible only when this pane is showing a portfolio."
     : "Visible for watchlists and portfolios.";
@@ -191,6 +201,7 @@ export function getPortfolioPaneSettings(settings: Record<string, unknown> | und
     viewMode: isPortfolioViewMode(settings?.viewMode) ? settings.viewMode : "table",
     hideHeader: settings?.hideHeader === true,
     hideCash: settings?.hideCash === true,
+    valueAtClose: settings?.valueAtClose === true,
   };
 }
 
@@ -306,6 +317,12 @@ export function buildPortfolioPaneSettingsDef(
       type: "select",
       options: VIEW_MODE_OPTIONS,
     });
+    fields.push({
+      key: "valueAtClose",
+      label: "Value at Regular Close",
+      description: "Price holdings at the regular close instead of the latest print, which includes extended hours.",
+      type: "toggle",
+    });
   }
 
   if (settings.collectionScope === "custom") {

package/src/plugins/builtin/portfolio-list/summary/index.tsx

@@ -22,6 +22,13 @@ import { formatAllocationDrift, formatAllocationWeight, type PortfolioCashLine }
 import { getMostRecentQuoteUpdate } from "../../../../market-data/quotes/time";
 import { fxStatusLabel, type FxRateStatus } from "../../../../utils/fx-status";
 import { t } from "../../../../i18n";
+import type { PortfolioValuationBasis } from "../../../../portfolio/valuation-basis";
+
+/** What the value beside it is priced at, short enough that the header row keeps it with the value. */
+const PRICED_AT_TEXT: Record<PortfolioValuationBasis, string> = {
+  "latest-print": "(latest print)",
+  "regular-close": "(regular close)",
+};
 
 export interface PortfolioSummarySegment {
   id: string;
@@ -225,8 +232,11 @@ export function buildPortfolioSummarySegments({
   baseCurrency = "USD",
   manualCash = null,
   brokerPortfolio = false,
+  valuationBasis,
 }: {
   totals: PortfolioSummaryTotals;
+  /** What the values are priced at, said beside the value; left out when absent. */
+  valuationBasis?: PortfolioValuationBasis;
   accountState: PortfolioSummaryAccountState | null;
   isPortfolioTab?: boolean;
   /** Synced from a broker, so it is worth its account's equity even while the account is missing. */
@@ -285,9 +295,11 @@ export function buildPortfolioSummarySegments({
     ]));
   }
 
+  // Which price the value uses goes with it, so a narrow row never shows one without the other.
   candidates.push(createSummarySegment("val", [
     { text: broker || totals.hasShorts ? "Gross" : "Val", tone: "label" },
     { text: money(totalMarketValue), tone: "value", bold: true },
+    ...(valuationBasis ? [{ text: PRICED_AT_TEXT[valuationBasis], tone: "muted" as const }] : []),
   ]));
 
   if (totals.hasShorts && totals.netMktValue != null) {

package/src/plugins/builtin/portfolio-list/summary/totals.ts

@@ -7,14 +7,14 @@ import { isQuoteStaleForCurrentSession } from "../../../../market-data/quotes/fr
 import { headlineQuoteDisplay } from "../column-values";
 import { isManualPortfolio } from "../mutations";
 import type { AllocationHolding } from "../allocation";
+import { getPortfolioValuationDisplay, type PortfolioValuationBasis } from "../../../../portfolio/valuation-basis";
 import {
   getPortfolioPositionMetrics,
-  getPortfolioQuoteDisplay,
   resolvePortfolioMarketValue,
   resolvePortfolioPositionPnl,
   portfolioPnlPercent,
   type PortfolioPositionPnl,
-} from "../position-metrics";
+} from "../../../../portfolio/position-metrics";
 
 /** A position lot valued from a current quote, in the totals currency. */
 interface PricedPortfolioLot {
@@ -90,7 +90,11 @@ export function formatPortfolioAmount(
   return `${sign}${getCurrencySymbol(currency)}${text.slice(sign.length)}`;
 }
 
-/** Totals over the collection, every amount converted into `totalsCurrency`. */
+/**
+ * Totals over the collection, every amount converted into `totalsCurrency`,
+ * valued at `valuationBasis`: the latest print unless given, or the regular
+ * close, whose day is that session's move.
+ */
 export function calculatePortfolioSummaryTotals(
   tickers: TickerRecord[],
   financialsMap: Map<string, TickerFinancials>,
@@ -98,6 +102,7 @@ export function calculatePortfolioSummaryTotals(
   exchangeRates: Map<string, number>,
   isPortfolio: boolean,
   collectionId: string | null,
+  valuationBasis: PortfolioValuationBasis = "latest-print",
 ): PortfolioSummaryTotals {
   let totalMktValue = 0;
   let netMktValue = 0;
@@ -144,7 +149,7 @@ export function calculatePortfolioSummaryTotals(
     const positionMetrics = getPortfolioPositionMetrics(ticker, collectionId ?? undefined, quoteCurrency, {
       currency: totalsCurrency, convert: toBase,
     }, quote);
-    activeQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
+    activeQuote = getPortfolioValuationDisplay(positionMetrics, quote, valuationBasis);
     const { totalPriceUnits, grossPriceUnits, totalCost } = positionMetrics;
     if (positionMetrics.positionCount === 0) {
       // Not held, so a missing rate is no gap in the totals: it only leaves the trade in units out.

package/src/plugins/builtin/portfolio-list/table.tsx

@@ -1,4 +1,5 @@
 import { useCallback, useMemo, useRef } from "react";
+import { QUICK_ADD_KEY } from "./quick-add";
 import {
   TickerListTableView,
   type DataTableKeyEvent,
@@ -8,18 +9,29 @@ import { useDataTableSortMenu } from "../../../components/data-table/sort-menu";
 import { followLiveSparklinePrice } from "../../../components/price-sparkline/model";
 import { PRICE_SPARKLINE_COLUMN_ID } from "../../../components/price-sparkline/view";
 import type { QuoteFlashDirection } from "../../../components/quote-flash";
+import type { TickerTableCell } from "../../../components/ticker/list-table-view";
 import { createRowValueCache } from "../../../components/ui/row-value-cache";
 import type { ColumnConfig } from "../../../types/config";
 import type { PricePoint, TickerFinancials } from "../../../types/financials";
 import type { TickerRecord } from "../../../types/ticker";
 import { objectVersion } from "../../../utils/object-version";
-import { columnContextVersion } from "./cell-version";
+import { columnContextVersion, PERPETUAL_COLUMN_IDS } from "./cell-version";
 import { getColumnValue, type ColumnContext } from "./metrics";
-import { portfolioPnlLabel } from "./position-metrics";
+import { tickerDisplayName } from "./column-values";
+import { displayWidth } from "../../../utils/format";
+import { portfolioPnlLabel } from "../../../portfolio/position-metrics";
 import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
 
 export type { QuoteFlashDirection };
 
+/** The market-state dot and the space after it, before each symbol in the Ticker column. */
+const TICKER_DOT_WIDTH = 2;
+/**
+ * The widest the Ticker column grows for its symbols: a perpetual as its venue writes it (`xyz:BRENTOIL`) and an
+ * option as its terms (`NVDA C $1250 Dec'26`) fit, so only a list holding options is given the width.
+ */
+const MAX_TICKER_COLUMN_WIDTH = 22;
+
 /** A cell recomputes only when its row's records or a context input it reads change. */
 function buildCellVersion(
   column: ColumnConfig,
@@ -98,6 +110,8 @@ export function PortfolioTickerTable({
   visibleRangeBuffer,
   resetScrollKey,
   onRowActivate,
+  onAddTicker,
+  onOpenPerpetual,
   rootHeight,
 }: {
   columns: ColumnConfig[];
@@ -117,18 +131,26 @@ export function PortfolioTickerTable({
   visibleRangeBuffer?: number;
   resetScrollKey?: unknown;
   onRowActivate?: (ticker: TickerRecord) => void;
+  /** Opens the add row; the empty table offers it as a button. */
+  onAddTicker?: () => void;
+  /** Opens PERP on a row's stock perpetual: its PERP% and FUND 8H cells link to it. */
+  onOpenPerpetual?: (marketId: string) => void;
   rootHeight?: number;
 }) {
-  const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue>>(5000));
+  const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue> & TickerTableCell>(5000));
+  const openPerpetualRef = useRef(onOpenPerpetual);
+  openPerpetualRef.current = onOpenPerpetual;
   const sparklineVisible = columns.some((column) => column.id === PRICE_SPARKLINE_COLUMN_ID);
   const tableFinancialsMap = useLiveSparklineFinancials(financialsMap, sortedTickers, sparklineVisible);
   const resolveCell = useCallback(
     (column: ColumnConfig, ticker: TickerRecord, financials: TickerFinancials | undefined) => {
       const key = `${ticker.metadata.ticker}:${column.id}`;
       const version = buildCellVersion(column, ticker, financials, columnContext);
-      return cellCacheRef.current.get(key, version, () => (
-        getColumnValue(column, ticker, financials, columnContext)
-      ));
+      return cellCacheRef.current.get(key, version, () => {
+        const cell = getColumnValue(column, ticker, financials, columnContext);
+        const marketId = PERPETUAL_COLUMN_IDS.has(column.id) ? columnContext.perpetuals?.get(ticker.metadata.ticker)?.marketId : undefined;
+        return marketId ? { ...cell, onPress: () => openPerpetualRef.current?.(marketId) } : cell;
+      });
     },
     [columnContext],
   );
@@ -139,11 +161,17 @@ export function PortfolioTickerTable({
   const hasNonShareQuantity = useMemo(() => sortedTickers.some(ticker => ticker.metadata.positions.some(position =>
     (!columnContext.activeTab || position.portfolio === columnContext.activeTab) && position.shares !== 0 && (position.priceBasis === "percent-of-par" || ticker.metadata.assetCategory?.toUpperCase() === "BOND"))),
   [columnContext.activeTab, sortedTickers]);
+  // The Ticker column grows to its longest symbol, so ETH-USD shows whole beside its market-state dot.
+  const tickerWidth = useMemo(() => Math.min(MAX_TICKER_COLUMN_WIDTH, sortedTickers.reduce(
+    (widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(tickerDisplayName(ticker))),
+    0,
+  )), [sortedTickers]);
   const displayColumns = useMemo(() => columns.map((column) => column.id === "shares" && hasNonShareQuantity ? { ...column, label: "QTY" }
+    : column.id === "ticker" && tickerWidth > column.width ? { ...column, width: tickerWidth }
     : pnlLabel !== "P&L" && (column.id === "pnl" || column.id === "pnl_pct") ? {
     ...column,
     label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
-  } : column), [columns, hasNonShareQuantity, pnlLabel]);
+  } : column), [columns, hasNonShareQuantity, pnlLabel, tickerWidth]);
   // The table offers "Sort by…" while it has a sort column. A watchlist starts
   // unsorted and a third header click turns sorting off, so the unsorted state
   // needs its own entry until TickerListTableView takes `sortable`.
@@ -175,6 +203,8 @@ export function PortfolioTickerTable({
       resetScrollKey={resetScrollKey}
       onRowActivate={onRowActivate}
       rowMenuAccelerators={PORTFOLIO_ROW_MENU_KEYS}
+      onAddTicker={onAddTicker}
+      addTickerShortcut={onAddTicker ? QUICK_ADD_KEY : undefined}
       rootHeight={rootHeight}
     />
   );

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

@@ -2,6 +2,8 @@ import { apiClient } from "../../../api-client";
 import type { PowerBoard, PowerDetail, PowerFilter, PowerHistory, PowerProject } from "../../../api-client/power";
 import { createPluginCache } from "../../../data/plugin-cache";
 import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
+import { powerTickerScopes, type PowerTab, type PowerTickerScope } from "./model";
+import { powerQuery } from "./query";
 
 const cacheOptions = { source: "gloom-cloud", schemaVersion: 1, policy: { staleMs: 60 * 60_000, expireMs: 30 * 86_400_000 } };
 export const powerBoardCache = createPluginCache<PowerBoard>({ ...cacheOptions, kind: "power-board" });
@@ -88,6 +90,20 @@ export async function fetchAllPowerHistory(filter: PowerFilter, client: Pick<Pow
   }
   return { ...first, points, hasMore: false, nextOffset: null };
 }
+/**
+ * How many records name a ticker on each other tab, for a tab that has none:
+ * one single-row page per scope, read for its total, which a free preview
+ * reports in full. A scope that fails to answer has no total rather than
+ * failing the tab it explains.
+ */
+export async function fetchPowerTickerScopes(symbol: string, tab: PowerTab, context: string,
+  client: Pick<PowerApi, "getCloudPowerBoard"> = apiClient, signal?: AbortSignal): Promise<PowerTickerScope[]> {
+  return Promise.all(powerTickerScopes(tab, context).map((scope) => {
+    const count = () => fetchPowerBoard({ ...powerQuery({ tab: scope.tab, context: scope.context }, symbol), limit: 1 }, client, signal).then((board) => board.total);
+    // One retry: a count is cheap, and the first of several at once is the one most often refused.
+    return count().catch(() => count()).then((total) => ({ ...scope, total }), () => ({ ...scope, total: null }));
+  }));
+}
 const key = (query: unknown, scope: string) => `${scope}:${JSON.stringify(query)}`;
 export const loadPowerBoard = (filter: PowerFilter, scope: string, force = false, signal?: AbortSignal) =>
   loadCloudResource(powerBoardCache, key(filter, scope), () => fetchPowerBoard(filter, apiClient, signal), { force, validate: validatePowerBoard });

package/src/plugins/builtin/power/evidence.ts

@@ -1,56 +1,109 @@
+import type { CarbonBoard, CarbonHistory, EuropePowerBoard, EuropePowerHistory } from "../../../api-client/europe-energy";
 import type { PowerBoard, PowerHistory } from "../../../api-client/power";
 import type { PaneScreenshotEvidenceHook } from "../../../cli/pane-functions/screenshot-evidence";
 import { useRemoteUiNode } from "../../../remote/semantic-tree";
 import { isRecord } from "../../../utils/guards";
-import { fetchPowerBoard, fetchAllPowerHistory, validatePowerBoard, validatePowerHistory } from "./client";
+import { fetchPowerBoard, fetchAllPowerHistory, fetchPowerTickerScopes, validatePowerBoard, validatePowerHistory } from "./client";
 import { otherRows, powerTab, projectRows } from "./model";
+import { fetchCarbonHistory, fetchCarbonPrice, fetchPowerPriceHistory, fetchPowerPrices, validateCarbonPrice, validatePowerPrices } from "./prices-client";
+import { DEFAULT_PRICE_MARKET, isCarbonQuery, powerPriceMarket } from "./prices-model";
 import { powerQuery } from "./query";
 interface PowerEvidence {
   kind: "power";
   version: 1;
   complete: boolean;
   plottedValueCount: number;
-  board: PowerBoard;
+  /** The grid board, on every tab but Prices. */
+  board: PowerBoard | null;
   history: PowerHistory | null;
+  /** The day-ahead board and the EUA board, on the Prices tab. */
+  prices?: EuropePowerBoard | null;
+  carbon?: CarbonBoard | null;
   tab: string;
   rowIds: string[];
 }
+/** What the Prices tab draws, frozen by `shot` so the capture and its check read the same days. */
+export interface PowerPricesSnapshot {
+  board: EuropePowerBoard;
+  /** The charted history: the selected market's, or the carbon allowance's for EPWR EUA. */
+  history: EuropePowerHistory | CarbonHistory | null;
+  /** Null when the server has no EUA price yet; the tab then shows the board alone. */
+  carbon: CarbonBoard | null;
+}
 export function usePowerEvidence(board: PowerBoard | undefined, history: PowerHistory | undefined, tab: string, rowIds: string[], loading: boolean) {
   useRemoteUiNode({ role: "chart-data", label: "Rendered power and grid observations", getMetadata: () => ({
     kind: "power", version: 1, complete: !!board && !loading, ready: !!board && !loading,
     plottedValueCount: rowIds.length, board, history: history ?? null, tab, rowIds,
   }) });
 }
+export function usePowerPricesEvidence(prices: EuropePowerBoard | null, carbon: CarbonBoard | null, rowIds: string[], loading: boolean) {
+  useRemoteUiNode({ role: "chart-data", label: "Rendered day-ahead power and carbon prices", getMetadata: () => ({
+    kind: "power", version: 1, complete: !!prices && !loading, ready: !!prices && !loading,
+    plottedValueCount: rowIds.length, board: null, history: null, prices, carbon, tab: "prices", rowIds,
+  }) });
+}
+const instanceSettings = (payload: Parameters<PaneScreenshotEvidenceHook["mismatches"]>[1]["payload"]) =>
+  payload.config.layout.instances.find((entry) => entry.instanceId === payload.paneId)?.settings;
 export const powerScreenshotEvidence: PaneScreenshotEvidenceHook<PowerEvidence> = {
   paneId: "power", kind: "power", label: "power and grid",
   async prepare({ resolved, settings }) {
     const tab = powerTab(settings.tab ?? resolved.options.tab);
+    if (tab === "prices") {
+      const board = await fetchPowerPrices();
+      // The carbon figures are captured when the server has them, and left out when it does not.
+      const carbon = await fetchCarbonPrice().catch(() => null);
+      const arg = resolved.createOptions?.arg;
+      const market = powerPriceMarket(arg)?.code ?? DEFAULT_PRICE_MARKET;
+      const history = isCarbonQuery(arg) && carbon?.row.date ? await fetchCarbonHistory()
+        : board.rows.some((row) => row.code === market && row.date) ? await fetchPowerPriceHistory(market) : null;
+      return { settings: { powerPricesSnapshot: { board, history, carbon } satisfies PowerPricesSnapshot }, financials: [] };
+    }
     const symbol = resolved.createOptions?.symbol ?? resolved.createOptions?.arg;
     const filter = powerQuery({ ...settings, ...resolved.options, tab }, symbol);
     const board = await fetchPowerBoard({ ...filter, limit: 100 });
     const history = tab === "history" ? await fetchAllPowerHistory(filter) : undefined;
-    return { settings: { powerSnapshot: { board, ...(history ? { history } : {}) } }, financials: [] };
+    // A ticker with nothing on this tab: the counts that say where its records are, captured with the rest.
+    const empty = !!symbol && tab !== "coverage" && !(tab === "history" ? history?.points.length : tab === "outcomes" ? board.rates.length
+      : tab === "utilities" ? board.exposure.length : board.projects.length);
+    const tickerScopes = empty && symbol ? await fetchPowerTickerScopes(symbol, tab, String(settings.context ?? resolved.options.context ?? "capacity")) : undefined;
+    return { settings: { powerSnapshot: { board, ...(history ? { history } : {}), ...(tickerScopes ? { tickerScopes } : {}) } }, financials: [] };
   },
   read(value) {
-    if (!isRecord(value) || value.kind !== "power" || value.version !== 1 || value.complete !== true || !isRecord(value.board)
+    if (!isRecord(value) || value.kind !== "power" || value.version !== 1 || value.complete !== true
       || !Array.isArray(value.rowIds) || !value.rowIds.every((id) => typeof id === "string") || value.plottedValueCount !== value.rowIds.length) return null;
     try {
+      const tab = powerTab(value.tab);
+      if (tab === "prices") {
+        if (!isRecord(value.prices)) return null;
+        const prices = validatePowerPrices(value.prices as unknown as EuropePowerBoard);
+        if (value.carbon != null) validateCarbonPrice(value.carbon as unknown as CarbonBoard);
+        if (value.rowIds.some((id) => !prices.rows.some((row) => row.code === id))) return null;
+        return value as unknown as PowerEvidence;
+      }
+      if (!isRecord(value.board)) return null;
       const board = validatePowerBoard(value.board as unknown as PowerBoard);
       const history = value.history ? validatePowerHistory(value.history as PowerHistory) : null;
-      const tab = powerTab(value.tab);
       const rows = ["queue", "loads", "capacity"].includes(tab) ? projectRows(board.projects) : otherRows(tab, board, history?.points ?? []);
       if (value.rowIds.some((id) => !rows.some((r) => r.id === id))) return null;
       return value as unknown as PowerEvidence;
     } catch { return null; }
   },
   mismatches(evidence, { resolved, payload }) {
-    const snapshot = payload.config.layout.instances.find((entry) => entry.instanceId === payload.paneId)?.settings?.powerSnapshot;
+    const settings = instanceSettings(payload);
     const errors: string[] = [];
-    if (!isRecord(snapshot) || JSON.stringify(snapshot.board) !== JSON.stringify(evidence.board)
-      || JSON.stringify(snapshot.history ?? null) !== JSON.stringify(evidence.history)) errors.push("Power observations differ from the captured data.");
-    if (evidence.tab !== powerTab(resolved.options.tab)) errors.push("Power tab does not match the requested view.");
+    if (evidence.tab === "prices") {
+      const snapshot = settings?.powerPricesSnapshot;
+      if (!isRecord(snapshot) || JSON.stringify(snapshot.board) !== JSON.stringify(evidence.prices)
+        || JSON.stringify(snapshot.carbon ?? null) !== JSON.stringify(evidence.carbon ?? null)) errors.push("Power prices differ from the captured data.");
+    } else {
+      const snapshot = settings?.powerSnapshot;
+      if (!isRecord(snapshot) || JSON.stringify(snapshot.board) !== JSON.stringify(evidence.board)
+        || JSON.stringify(snapshot.history ?? null) !== JSON.stringify(evidence.history)) errors.push("Power observations differ from the captured data.");
+    }
+    // EPWR opens the Prices tab by its settings; POWER by --tab.
+    if (evidence.tab !== powerTab(resolved.options.tab ?? settings?.tab)) errors.push("Power tab does not match the requested view.");
     return errors;
   },
-  unavailable(evidence) { return evidence?.complete ? [] : ["power observations"]; },
+  unavailable(evidence) { return evidence?.complete ? [] : [evidence?.tab === "prices" ? "power prices" : "power observations"]; },
   symbols() { return []; },
 };