@gloom-sh/terminal 0.18.5 → 0.19.1

package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx

@@ -16,12 +16,12 @@ import { TIME_RANGES, type TimeRange } from "../../../../time-series/range";
 import type { PaneProps } from "../../../../types/plugin";
 import type { PricePoint } from "../../../../types/financials";
 import { colors, priceColor } from "../../../../theme/colors";
-import { formatCompact, formatPercent } from "../../../../utils/format";
+import { displayWidth, formatCompact, formatPercent } from "../../../../utils/format";
 import { isPlainKeyboardEvent } from "../../../../utils/keyboard";
 import { publicTickerKey } from "../../../../utils/exchanges";
-import { quoteFormatOptions } from "../../../../market-data/market/format";
+import { isPenceQuotedLine, penceFigure, quoteFormatOptions } from "../../../../market-data/market/format";
 import {
-  barPriceDecimals, formatBarPrice, historyAllStart, historyBarsAfterHole, historyChangeBaseNote, historyMissingPeriodsNote,
+  barPriceDecimals, formatBarPrice, historyAllStart, historyBarsAfterHole, historyChangeBaseNote, historyMissingPeriodsNote, quotedPriceDivisor,
 } from "../../../../cli/history-rows";
 import {
   MISSING_VOLUME_TEXT, missingVolumeCount, missingVolumeNotice, pricePointValues, priceHistoryIntegrityNotice,
@@ -89,8 +89,8 @@ function formatMaybePrice(value: number | null | undefined, decimals: number, wi
 }
 
 /** The decimals the table's prices need: the one rule `history` and `fn HP` print by (barPriceDecimals). */
-function historicalPriceDecimals(rows: readonly HistoricalPriceRow[], assetCategory?: string): number {
-  return barPriceDecimals(rows.map(({ point }) => point), assetCategory);
+function historicalPriceDecimals(rows: readonly HistoricalPriceRow[], assetCategory?: string, priceDivisor = 1): number {
+  return barPriceDecimals(rows.map(({ point }) => point), assetCategory, priceDivisor);
 }
 
 /** The exported price: the digits the table shows, without the width limit. */
@@ -178,19 +178,27 @@ const HISTORY_NUMERIC_IDS = ["open", "high", "low", "close", "change", "changePe
 /**
  * Fixed date and volume columns; the price columns take the rest of the pane
  * evenly, and give up cells down to a floor when it is narrow, so the volume
- * stays on screen.
+ * stays on screen. A close with a note beside it (a London line's pence) asks
+ * for `closeWidth`, the widest close and note: the other columns give way to
+ * it first, down to their minimum, before it gives up its note.
  */
-function buildHistoryColumns(width: number, intraday: boolean, size: HistoryBarSize, newestDate: string): HistoryColumn[] {
+function buildHistoryColumns(width: number, intraday: boolean, size: HistoryBarSize, newestDate: string, closeWidth = 0): HistoryColumn[] {
   // A month reads as `2026-10`; the newest bar, when its week or month runs on, adds `MTD` or `WTD`.
   const dateWidth = Math.max(intraday ? 16 : size === "1mo" ? 7 : 10, newestDate.length);
-  const numeric: number[] = HISTORY_NUMERIC_IDS.map((id) => id === "changePercent" ? HISTORY_PERCENT_WIDTH : HISTORY_PRICE_WIDTH);
+  const numeric: number[] = HISTORY_NUMERIC_IDS.map((id) => id === "changePercent" ? HISTORY_PERCENT_WIDTH
+    : id === "close" ? Math.max(HISTORY_PRICE_WIDTH, closeWidth) : HISTORY_PRICE_WIDTH);
   // One gap per column plus the table's inset on both sides.
   const available = width - dateWidth - HISTORY_VOLUME_WIDTH - 8 - 2;
   let spare = available - numeric.reduce((sum, value) => sum + value, 0);
-  for (let index = 0; spare < 0 && numeric.some((value) => value > HISTORY_NUMERIC_MIN_WIDTH); index = (index + 1) % numeric.length) {
-    if (numeric[index]! > HISTORY_NUMERIC_MIN_WIDTH) {
-      numeric[index]! -= 1;
-      spare += 1;
+  // The close keeps the width its note asks for while another column can give way, then gives it up too.
+  const closeAt = HISTORY_NUMERIC_IDS.indexOf("close");
+  for (const closeFloor of [Math.max(HISTORY_NUMERIC_MIN_WIDTH, closeWidth), HISTORY_NUMERIC_MIN_WIDTH]) {
+    const floor = (index: number) => index === closeAt ? closeFloor : HISTORY_NUMERIC_MIN_WIDTH;
+    for (let index = 0; spare < 0 && numeric.some((value, at) => value > floor(at)); index = (index + 1) % numeric.length) {
+      if (numeric[index]! > floor(index)) {
+        numeric[index]! -= 1;
+        spare += 1;
+      }
     }
   }
   if (spare > 0) {
@@ -256,13 +264,25 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
   // Daily and longer bars are dates; only intraday bars carry a time.
   const intraday = rows.length > 0 ? rows.some((row) => row.timed) : range === "1D" || range === "1W";
   const newestRowDate = rows[0]?.date ?? "";
-  const columns = useMemo(() => buildHistoryColumns(width, intraday, size, newestRowDate), [intraday, newestRowDate, size, width]);
   const assetCategory = quoteFormatOptions(
     financials?.quote,
     ticker?.metadata.assetCategory,
     financials?.quoteMetadata?.instrumentType,
   ).assetCategory;
-  const priceDecimals = useMemo(() => historicalPriceDecimals(rows, assetCategory), [assetCategory, rows]);
+  const priceDivisor = quotedPriceDivisor(quote);
+  const priceDecimals = useMemo(() => historicalPriceDecimals(rows, assetCategory, priceDivisor), [assetCategory, priceDivisor, rows]);
+  // A London line's close reads in pence too (6.385 638.5p): the close column asks for room for the widest.
+  const pence = isPenceQuotedLine(quote);
+  const closeWidth = useMemo(() => !pence ? 0 : rows.reduce((widest, row) => {
+    const close = row.point.close;
+    const pence = penceFigure(exportPrice(close, priceDecimals), quote, priceDecimals);
+    // A cell more than the text, so the close never runs into the low before it.
+    return pence ? Math.max(widest, displayWidth(` ${formatMaybePrice(close, priceDecimals, Infinity)} ${pence}`)) : widest;
+  }, 0), [pence, priceDecimals, quote, rows]);
+  const columns = useMemo(
+    () => buildHistoryColumns(width, intraday, size, newestRowDate, closeWidth),
+    [closeWidth, intraday, newestRowDate, size, width],
+  );
   const boundedSelectedIdx = rows.length > 0 ? Math.min(selectedIdx, rows.length - 1) : -1;
   const cycleRange = useCallback(() => setRange((current) => nextHistoryRange(current)), [setRange]);
 
@@ -296,12 +316,17 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
       case "open":
       case "high":
       case "low":
-      case "close":
+      case "close": {
+        const value = row.point[column.id];
+        // A London line's close also reads in the pence it trades in, where the column has room: 6.385 638.5p.
+        const pence = column.id === "close" ? penceFigure(exportPrice(value, priceDecimals), quote, priceDecimals) : null;
         return {
-          text: formatMaybePrice(row.point[column.id], priceDecimals, column.width),
-          value: exportPrice(row.point[column.id], priceDecimals),
+          text: formatMaybePrice(value, priceDecimals, column.width),
+          value: exportPrice(value, priceDecimals),
+          ...(pence ? { note: pence } : {}),
           ...(column.id === "close" ? { color: colors.textBright, attributes: TextAttributes.BOLD } : { color: colors.text }),
         };
+      }
       case "change":
         return { text: spanMark(formatMaybePrice(row.change, priceDecimals, column.width - (row.changeSpansGap ? 1 : 0)), row, row.change),
           value: exportPrice(row.change, priceDecimals), color: priceColor(row.change ?? 0) };
@@ -311,7 +336,7 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
       case "volume":
         return { text: formatVolume(row.point.volume, volumeMissing > 0), value: row.point.volume ?? null, color: colors.textDim };
     }
-  }, [priceDecimals, volumeMissing]);
+  }, [priceDecimals, quote, volumeMissing]);
 
   // ALL starts where the source's bars do, when that is well inside the window (BTC-USD's in 2014-09).
   const oldestDate = rows.at(-1)?.exportDate;

package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts

@@ -1,3 +1,4 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { fetchHistoryResult, InvalidHistoryResultError } from "../../../../sources/history-result";
 import { historyRetentionNotice, isHistoryRetentionError } from "../../../../sources/history-retention";
 import {
@@ -74,8 +75,8 @@ async function sessionVenue(provider: DataProvider, symbol: string, exchange: st
       ? await provider.getQuoteMetadata(symbol, exchange)
       : await provider.getQuote(symbol, exchange);
     return metadata?.listingExchangeName ?? "";
-  } catch {
-    return "";
+  } catch (error) {
+    return logFailure("ticker-detail.data-panes.returns-history", "Read return session venue failed", "")(error);
   }
 }
 

package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts

@@ -17,7 +17,9 @@ import {
 import { isRoundTheClockCoin } from "../../../../utils/crypto-pair";
 import { currentFxClosureStart, isCurrencyPairListing } from "../../../../utils/fx-market-hours";
 import { pricePointValues } from "../../../../utils/price-history-integrity";
+import { timeZoneCity, zonedClock } from "../../../../utils/utc-time";
 import { zonedDateKey } from "../../../../utils/zoned-date-time";
+import { historyDateHeader } from "./history-bars";
 
 export type ReturnRange = "6H" | "1D" | "5D" | TimeRange;
 
@@ -347,6 +349,66 @@ export function returnBaseCloseDay(
   return period ? barLastSession(day, period, venue, now) ?? barCloseDay(day, resolution, venue) : day;
 }
 
+/**
+ * The clock an intraday bar's time is shown on: its venue's own, where the app
+ * knows its sessions, so the open reads 09:30 and not 13:30; null for UTC, which
+ * is where a coin, a currency pair or a venue with no known zone keeps its bars.
+ */
+function returnClockZone(venue: string | undefined): string | null {
+  if (!venue || isAlwaysOpenExchange(venue)) return null;
+  return sessionCalendarTimeZone(venue);
+}
+
+/**
+ * A bar as the table dates it: an intraday bar's open on its venue's clock
+ * (`2026-10-23 09:30`), a daily or longer bar its session day.
+ */
+export function returnTimeText(timestamp: number, resolution: ManualChartResolution, venue: string | undefined): string {
+  if (!isIntradayResolution(resolution)) return barSessionDay(timestamp, venue);
+  const zone = returnClockZone(venue);
+  if (!zone) return new Date(timestamp).toISOString().slice(0, 16).replace("T", " ");
+  const clock = zonedClock(timestamp, zone);
+  return `${clock.date} ${clock.time}`;
+}
+
+/**
+ * What the time column is headed: the clock its times are on (`ET` for New York,
+ * as TAS heads it, the venue's city for another zone, else `UTC`), or what a
+ * daily or longer bar is dated by.
+ */
+export function returnTimeHeader(resolution: ManualChartResolution, venue: string | undefined): string {
+  if (!isIntradayResolution(resolution)) return historyDateHeader(resolution)?.toUpperCase() ?? "DATE";
+  const zone = returnClockZone(venue);
+  return `TIME ${!zone ? "UTC" : zone === "America/New_York" ? "ET" : timeZoneCity(zone).toUpperCase()}`;
+}
+
+/** The figures a window's rows add up to: its total, and the bars that moved most each way. */
+export interface ReturnSummary {
+  /** The newest row's total return, a fraction. Null when no bar has one. */
+  total: number | null;
+  best: ReturnRow | null;
+  worst: ReturnRow | null;
+}
+
+/**
+ * The window's total return (the newest priced row's, measured from the base
+ * close) with its best and worst interval. A single bar has no interval worth
+ * ranking, and a window whose every interval is the same move has no best or
+ * worst, so neither is named then.
+ */
+export function summarizeReturns(rows: readonly ReturnRow[]): ReturnSummary {
+  // Rows are newest first.
+  const total = rows.find((row) => row.cumulativePercent !== null)?.cumulativePercent ?? null;
+  const moves = rows.filter((row) => row.intervalPercent !== null);
+  let best: ReturnRow | null = null;
+  let worst: ReturnRow | null = null;
+  for (const row of moves) {
+    if (!best || row.intervalPercent! > best.intervalPercent!) best = row;
+    if (!worst || row.intervalPercent! < worst.intervalPercent!) worst = row;
+  }
+  return best && worst && best.intervalPercent !== worst.intervalPercent ? { total, best, worst } : { total, best: null, worst: null };
+}
+
 /** Whether the newest daily row is the session still trading at its venue, which its table marks. */
 export function isTodayReturnRow(row: Pick<ReturnRow, "timestamp"> | undefined, resolution: ManualChartResolution, venue: string | undefined, now: number): boolean {
   return !!row && resolution === "1d" && isIntradayDailyBar(barSessionDay(row.timestamp, venue), venue, now);

package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx

@@ -1,8 +1,10 @@
+import { logFailure } from "../../../../utils/log-failure";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { TextAttributes } from "../../../../ui";
 import {
   DataTableView,
   QueryBar,
+  StatGrid,
   loadingText,
   unavailableText,
   usePaneNoticeFooter,
@@ -12,11 +14,13 @@ import {
   type DataTableColumn,
   type PaneFooterSegment,
   type PaneHint,
+  type StatItem,
 } from "../../../../components";
 import { usePaneRefreshKey } from "../../../../components/data-table/table-pane";
 import { CHART_RESOLUTIONS } from "../../../../time-series/range";
 import {
   getChartResolutionLabel,
+  isIntradayResolution,
   type ChartResolutionSupport,
   type ManualChartResolution,
 } from "../../../../time-series/resolution";
@@ -25,7 +29,7 @@ import { cleanFloat32Price, historyPriceDecimals } from "../../../../cli/history
 import { formatPriceObservation, quoteFormatOptions } from "../../../../market-data/market/format";
 import { usePaneTicker } from "../../../../state/app/context";
 import type { PaneProps } from "../../../../types/plugin";
-import { colors, priceColor } from "../../../../theme/colors";
+import { colors, shownPriceColor } from "../../../../theme/colors";
 import { formatPercent } from "../../../../utils/format";
 import { publicTickerKey } from "../../../../utils/exchanges";
 import { priceHistoryIntegrityNotice } from "../../../../utils/price-history-integrity";
@@ -39,9 +43,12 @@ import {
   effectiveReturnResolution,
   isTodayReturnRow,
   returnBaseCloseDay,
+  returnTimeHeader,
+  returnTimeText,
   RETURN_RANGES,
   type ReturnRange,
   type ReturnRow,
+  summarizeReturns,
 } from "./returns-model";
 import { loadReturnSeries, type ReturnSeries } from "./returns-history";
 import { formingHistoryBar, formingHistoryBarText, historyBarDate } from "./history-bars";
@@ -64,12 +71,6 @@ const COLUMNS: ReturnColumn[] = [
   { id: "cumulativePercent", label: "TOTAL %", width: 9, align: "right", flexGrow: 1 },
 ];
 
-function formatDateTime(date: Date): string {
-  const iso = date.toISOString();
-  const hasTime = date.getUTCHours() !== 0 || date.getUTCMinutes() !== 0 || date.getUTCSeconds() !== 0;
-  return hasTime ? iso.slice(0, 16).replace("T", " ") : iso.slice(0, 10);
-}
-
 /** Every price and dollar change at one decimal count, so the columns line up. */
 function returnPriceDecimals(rows: readonly ReturnRow[], assetCategory?: string): number {
   return historyPriceDecimals(rows.flatMap((row) => row.price === null ? [] : [{
@@ -95,6 +96,12 @@ function formatMaybePercent(value: number | null): string {
   return value === null ? "-" : formatPercent(value);
 }
 
+/** A move's tone as it is printed: one that rounds to 0.00% is neutral, never red or green. */
+function moveTone(fraction: number): StatItem["tone"] {
+  const shown = Number((fraction * 100).toFixed(2));
+  return shown > 0 ? "positive" : shown < 0 ? "negative" : "neutral";
+}
+
 function sortValue(row: ReturnRow, id: ReturnColumnId): number | null {
   switch (id) {
     case "time":
@@ -127,7 +134,7 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
     symbol && dataProvider?.getChartResolutionSupport
       ? dataProvider.getChartResolutionSupport(symbol, exchange)
       : NO_SUPPORT,
-  ).catch(() => NO_SUPPORT), [dataProvider, exchange, symbol]);
+  ).catch(logFailure("ticker-detail.data-panes.returns-pane", "Read return interval support failed", NO_SUPPORT)), [dataProvider, exchange, symbol]);
   const [support, setSupport] = useState<readonly ChartResolutionSupport[] | null>(null);
   useEffect(() => {
     let cancelled = false;
@@ -162,15 +169,20 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
     () => data ? buildReturnRows(data.points, data.visibleFrom, data.visibleTo) : [],
     [data],
   );
+  const barSize = data?.resolution ?? shownResolution;
+  const venue = data?.venue || undefined;
+  // The times are dated on the venue's own clock, which the column's header names.
+  const timeHeader = returnTimeHeader(barSize, venue);
+  const columns = useMemo(() => COLUMNS.map((column) => column.id === "time" ? { ...column, label: timeHeader } : column), [timeHeader]);
   const table = useMemo(() => {
     const searchable = returnRows.length >= SEARCH_MIN_ROWS;
     const needle = searchable ? query.trim().toLowerCase() : "";
     const rows = (needle
-      ? returnRows.filter((row) => formatDateTime(new Date(row.timestamp)).toLowerCase().includes(needle))
+      ? returnRows.filter((row) => returnTimeText(row.timestamp, barSize, venue).includes(needle))
       : returnRows.slice()
     ).sort((left, right) => compareSortValues(sortValue(left, sort.columnId), sortValue(right, sort.columnId), sort.direction));
     return { rows, searchable };
-  }, [query, returnRows, sort]);
+  }, [barSize, query, returnRows, sort, venue]);
   // The quote knows the instrument type even when the saved ticker does not,
   // so prices take the same decimals as Historical Prices.
   const { financials } = usePaneTicker();
@@ -199,7 +211,6 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
   // Today's daily bar is the session still trading, marked as Historical Prices marks it.
   const dayToDate = !!data && isTodayReturnRow(returnRows[0], data.resolution, data.venue || undefined, Date.now());
   const formingKey = forming || dayToDate ? returnRows[0]?.key : undefined;
-  const barSize = data?.resolution ?? shownResolution;
   // The close every total is measured from: `from Mon 21 Sep close`.
   const baseText = useMemo(() => {
     const day = data && returnRows.length ? returnBaseCloseDay(data.points, data.visibleFrom, data.resolution, data.venue || undefined, Date.now()) : null;
@@ -225,6 +236,29 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
     title: "Price history data",
   });
 
+  // The window's total and its best and worst interval, over every bar it holds, whatever the search narrows the table to.
+  const summary = useMemo<StatItem[]>(() => {
+    const { total, best, worst } = summarizeReturns(returnRows);
+    const moveItem = (id: string, label: string, row: ReturnRow | null): StatItem[] => {
+      if (row?.intervalPercent == null) return [];
+      const when = historyBarDate(returnTimeText(row.timestamp, barSize, venue), barSize, false);
+      return [{
+        id,
+        label,
+        value: formatPercent(row.intervalPercent),
+        tone: moveTone(row.intervalPercent),
+        detail: when,
+        // A narrow pane keeps the day without its year, so the three figures stay on one row.
+        ...isIntradayResolution(barSize) ? { detailVariants: [when.slice(5)] } : {},
+      }];
+    };
+    return [
+      ...total === null ? [] : [{ id: "total", label: "Total", value: formatPercent(total), tone: moveTone(total) }],
+      ...moveItem("best", "Best", best),
+      ...moveItem("worst", "Worst", worst),
+    ];
+  }, [barSize, returnRows, venue]);
+
   const chooseSort = useCallback((id: string) => {
     setSort((current) => nextHeaderSort(current, id as ReturnColumnId, { firstDirection: "desc" }));
   }, []);
@@ -232,10 +266,10 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
   const renderCell = useCallback((row: ReturnRow, column: ReturnColumn): DataTableCell => {
     switch (column.id) {
       case "time": {
-        const shown = formatDateTime(new Date(row.timestamp));
+        const shown = returnTimeText(row.timestamp, barSize, venue);
         // A daily or longer bar is a date; a month's reads as the month, and one still running says so.
         return {
-          text: shown.length > 10 ? shown : historyBarDate(shown, barSize, row.key === formingKey),
+          text: isIntradayResolution(barSize) ? shown : historyBarDate(shown, barSize, row.key === formingKey),
           value: new Date(row.timestamp).toISOString(),
           color: colors.textDim,
         };
@@ -243,15 +277,15 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
       case "price":
         return { text: formatMaybePrice(row.price, priceDecimals, column.width), value: exportPrice(row.price, priceDecimals), color: colors.textBright, attributes: TextAttributes.BOLD };
       case "intervalChange":
-        return { text: formatMaybePrice(row.intervalChange, priceDecimals, column.width), value: exportPrice(row.intervalChange, priceDecimals), color: priceColor(row.intervalChange ?? 0) };
+        return { text: formatMaybePrice(row.intervalChange, priceDecimals, column.width), value: exportPrice(row.intervalChange, priceDecimals), color: shownPriceColor(row.intervalChange ?? 0, priceDecimals) };
       case "intervalPercent":
-        return { text: formatMaybePercent(row.intervalPercent), value: row.intervalPercent === null ? null : row.intervalPercent * 100, color: priceColor(row.intervalPercent ?? 0) };
+        return { text: formatMaybePercent(row.intervalPercent), value: row.intervalPercent === null ? null : row.intervalPercent * 100, color: shownPriceColor((row.intervalPercent ?? 0) * 100, 2) };
       case "cumulativeChange":
-        return { text: formatMaybePrice(row.cumulativeChange, priceDecimals, column.width), value: exportPrice(row.cumulativeChange, priceDecimals), color: priceColor(row.cumulativeChange ?? 0) };
+        return { text: formatMaybePrice(row.cumulativeChange, priceDecimals, column.width), value: exportPrice(row.cumulativeChange, priceDecimals), color: shownPriceColor(row.cumulativeChange ?? 0, priceDecimals) };
       case "cumulativePercent":
-        return { text: formatMaybePercent(row.cumulativePercent), value: row.cumulativePercent === null ? null : row.cumulativePercent * 100, color: priceColor(row.cumulativePercent ?? 0) };
+        return { text: formatMaybePercent(row.cumulativePercent), value: row.cumulativePercent === null ? null : row.cumulativePercent * 100, color: shownPriceColor((row.cumulativePercent ?? 0) * 100, 2) };
     }
-  }, [barSize, formingKey, priceDecimals]);
+  }, [barSize, formingKey, priceDecimals, venue]);
 
   return (
     <DataTableView<ReturnRow, ReturnColumn>
@@ -259,7 +293,7 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
       selection={{ kind: "none" }}
       rootWidth={width}
       rootHeight={height}
-      columns={COLUMNS}
+      columns={columns}
       items={table.rows}
       sortColumnId={sort.columnId}
       sortDirection={sort.direction}
@@ -268,33 +302,36 @@ export function ReturnsPane({ focused, width, height }: PaneProps) {
       renderCell={renderCell}
       selectedTextOverridesCellColor
       rootBefore={(
-        <QueryBar
-          width={width}
-          search={table.searchable ? {
-            value: query,
-            onChange: setQuery,
-            placeholder: "date or time",
-            focused,
-            ...searchProps,
-          } : undefined}
-          filters={[{
-            id: "range",
-            label: "Range",
-            value: range,
-            options: RETURN_RANGES.map((value) => ({ value, label: value })),
-            onChange: setRange,
-          }, {
-            id: "interval",
-            label: "Interval",
-            value: shownResolution,
-            options: INTERVAL_OPTIONS.map((value) => ({
-              value,
-              label: getChartResolutionLabel(value),
-              disabled: support !== null && !availableResolutions.has(value),
-            })),
-            onChange: setResolution,
-          }]}
-        />
+        <>
+          <QueryBar
+            width={width}
+            search={table.searchable ? {
+              value: query,
+              onChange: setQuery,
+              placeholder: "date or time",
+              focused,
+              ...searchProps,
+            } : undefined}
+            filters={[{
+              id: "range",
+              label: "Range",
+              value: range,
+              options: RETURN_RANGES.map((value) => ({ value, label: value })),
+              onChange: setRange,
+            }, {
+              id: "interval",
+              label: "Interval",
+              value: shownResolution,
+              options: INTERVAL_OPTIONS.map((value) => ({
+                value,
+                label: getChartResolutionLabel(value),
+                disabled: support !== null && !availableResolutions.has(value),
+              })),
+              onChange: setResolution,
+            }]}
+          />
+          <StatGrid items={summary} width={width} />
+        </>
       )}
       getExportMetadata={() => [
         ["Ticker", symbol ? publicTickerKey(symbol, exchange) : ""],

package/src/plugins/builtin/ticker-detail/headless.ts

@@ -4,7 +4,7 @@ import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, quoteHeadlineTime, type
 import type { HeadlessPaneColumn, HeadlessPaneDefinition, HeadlessPaneFreshness, HeadlessPaneOptionValues } from "../../../types/headless";
 import type { TimeRange } from "../../../time-series/range";
 import { formatNumber, formatPercentRaw } from "../../../utils/format";
-import { formatMarketPrice, formatMarketPriceWithCurrency, formatPriceObservation, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../../market-data/market/format";
+import { formatMarketPrice, formatMarketPriceWithCurrency, formatPriceObservation, penceFigure, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../../market-data/market/format";
 import {
   MISSING_VOLUME_TEXT, missingVolumeCount, missingVolumeNotice, pricePointValues, priceHistoryIntegrityNotice,
 } from "../../../utils/price-history-integrity";
@@ -36,7 +36,8 @@ import {
 } from "../shared/headless-market-data";
 import { barHistoryFreshness, quoteFreshnessFields, REPORTED_DATA } from "../shared/report-freshness";
 import {
-  BAR_INTERVAL_LABELS, barPriceDecimals, cleanFloat32Price, formatBarPrice, historyAllStart, historyAllStartNote, historyMissingPeriodsNote, historyPriceDecimals,
+  BAR_INTERVAL_LABELS, barPriceDecimals, cleanBarPrice, cleanFloat32Price, formatBarPrice, historyAllStart, historyAllStartNote, historyMissingPeriodsNote, historyPriceDecimals,
+  quotedPriceDivisor,
 } from "../../../cli/history-rows";
 import { formatUtcTime } from "../../../utils/utc-time";
 import { maxDrawdown, maxDrawdownText } from "../../../utils/max-drawdown";
@@ -197,7 +198,7 @@ async function loadRatioReport(
   const history = oldest && tab.key === "valuation"
     ? await resolveHeadlessInstrument(ctx, symbol)
       .then(({ symbol: bare, exchange }) => loadPeriodEndHistory(ctx.marketData, bare, exchange ?? "", oldest))
-      .catch(() => null)
+      .catch(logFailure("ticker-detail.headless", "Load valuation price history failed", null))
     : null;
   const table = hasRequestedStatements ? ratioTableForFinancials(financials, tab, period, history) : null;
   const statementCurrency = financialStatementCurrency(financials, [
@@ -339,12 +340,16 @@ export const quoteComparisonHeadless: HeadlessPaneDefinition<"rows"> = {
  * report declares before it has bars keep every digit the source sent. A bar without
  * volume in a history that reports it (`volumeMissing`) prints it as missing, never as 0.
  */
-const historyPriceColumns = (volumeMissing: boolean, decimals?: number): HeadlessPaneColumn[] => ["open", "high", "low", "close", "volume"].map((key) => ({
+const historyPriceColumns = (volumeMissing: boolean, decimals?: number, pence?: (close: number) => string | null): HeadlessPaneColumn[] => ["open", "high", "low", "close", "volume"].map((key) => ({
   key, header: key, align: "right" as const,
-  format: (value: unknown) => value == null || !Number.isFinite(Number(value)) ? key === "volume" && volumeMissing ? MISSING_VOLUME_TEXT : "-"
-    : key === "volume" ? formatNumber(Number(value), 0)
-    : decimals == null ? formatPriceObservation(Number(value), { minimumFractionDigits: 2 })
-    : formatBarPrice(Number(value), decimals),
+  format: (value: unknown) => {
+    if (value == null || !Number.isFinite(Number(value))) return key === "volume" && volumeMissing ? MISSING_VOLUME_TEXT : "-";
+    if (key === "volume") return formatNumber(Number(value), 0);
+    if (decimals == null) return formatPriceObservation(Number(value), { minimumFractionDigits: 2 });
+    // A London line's close also reads in pence, as the pane's close notes it: 6.385 638.5p.
+    const note = key === "close" ? pence?.(Number(value)) : null;
+    return `${formatBarPrice(Number(value), decimals)}${note ? ` ${note}` : ""}`;
+  },
 }));
 
 /**
@@ -353,7 +358,14 @@ const historyPriceColumns = (volumeMissing: boolean, decimals?: number): Headles
  * whose period runs on (`2026-10 MTD`); the export keeps each bar's own date
  * and adds a `Partial` column when one is.
  */
-function historyColumns(size: HistoryBarSize, partial: boolean, text: boolean, volumeMissing = false, decimals?: number): HeadlessPaneColumn[] {
+function historyColumns(
+  size: HistoryBarSize,
+  partial: boolean,
+  text: boolean,
+  volumeMissing = false,
+  decimals?: number,
+  pence?: (close: number) => string | null,
+): HeadlessPaneColumn[] {
   const daily = isDailyOrLongerBar(size);
   const date: HeadlessPaneColumn = {
     key: "date",
@@ -365,7 +377,7 @@ function historyColumns(size: HistoryBarSize, partial: boolean, text: boolean, v
   const marked: HeadlessPaneColumn[] = partial && !text
     ? [{ key: "partial", header: "Partial", format: (value) => value === true ? "true" : "" }]
     : [];
-  return [date, ...historyPriceColumns(volumeMissing, decimals), ...marked];
+  return [date, ...historyPriceColumns(volumeMissing, decimals, text ? pence : undefined), ...marked];
 }
 
 export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
@@ -386,14 +398,16 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
       window ? loadPriceWindowHistory(ctx.marketData, listing, exchange ?? "", window).then((result) => result.points)
         : loadHeadlessPriceHistory(ctx, symbol, range),
       pastWindow || (!window && isIntradayResolution(RANGE_HISTORY_RESOLUTION[range])) ? null
-        : ctx.marketData.getQuote(listing, exchange ?? "").catch(() => null),
+        : ctx.marketData.getQuote(listing, exchange ?? "").catch(logFailure("ticker-detail.headless", "Load historical prices quote failed", null)),
     ]);
     // The venue whose sessions say whether a day, week or month is still running: the key's, or for a bare symbol its quote's.
     const venue = exchange || quote?.listingExchangeName || quote?.exchangeName || undefined;
     const now = Date.now();
     const points = withSessionBar(loaded, quote, { now, venue });
-    // Providers serve float32 prices (4013.39990234 for 4013.4): the rows hold the decimal each is, as `history` does.
-    const clean = (value: number | null) => value == null ? null : cleanFloat32Price(value);
+    // Providers serve float32 prices (4013.39990234 for 4013.4): the rows hold the decimal each is, as `history` does,
+    // a London line's cleaned in the pence it was priced in.
+    const priceDivisor = quotedPriceDivisor(quote);
+    const clean = (value: number | null) => value == null ? null : cleanBarPrice(value, priceDivisor);
     const rows = points.map((point) => {
       const date = new Date(point.date);
       const values = pricePointValues(point);
@@ -417,7 +431,7 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
       && quote.lastUpdated >= Date.parse(`${rows.at(-1)!.date.slice(0, 10)}T00:00:00Z`) ? new Date(quote.lastUpdated).toISOString() : null;
     const shown = forming ? [...rows.slice(0, -1), { ...rows.at(-1)!, partial: true }] : rows;
     // One decimal count for the table, by the instrument's display rules when the quote names its kind.
-    const decimals = barPriceDecimals(rows, quoteFormatOptions(quote).assetCategory);
+    const decimals = barPriceDecimals(rows, quoteFormatOptions(quote).assetCategory, priceDivisor);
     const marked = shown.some((row) => row.partial === true);
     const volumeMissing = missingVolumeCount(shown);
     const volumeNote = missingVolumeNotice(volumeMissing, shown.length);
@@ -443,7 +457,8 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
     return {
       rows: shown,
       columns: historyColumns(size, marked, false, false, decimals),
-      textColumns: historyColumns(size, marked, true, volumeMissing > 0, decimals),
+      textColumns: historyColumns(size, marked, true, volumeMissing > 0, decimals,
+        (close) => penceFigure(Number(close.toFixed(Math.min(20, decimals))), quote, decimals)),
       freshness,
       ...(notes.length > 0 ? { notes } : {}),
       ...(notice ? { complete: false } : {}),
@@ -474,7 +489,7 @@ export const returnsHeadless: HeadlessPaneDefinition<"rows"> = {
     // --from 2007 --to 2009 measures those dates' returns in place of the range.
     const window = readReportWindow(options);
     const pastWindow = !!window && isPastPriceWindow(window);
-    const support = await Promise.resolve(ctx.marketData.getChartResolutionSupport?.(symbol, exchange ?? "") ?? []).catch(() => []);
+    const support = await Promise.resolve(ctx.marketData.getChartResolutionSupport?.(symbol, exchange ?? "") ?? []).catch(logFailure("ticker-detail.headless", "Read return interval support failed", []));
     const now = Date.now();
     const series = await loadReturnSeries(ctx.marketData, {
       symbol, exchange: exchange ?? "", range, resolution: requested, support, now, forceRefresh: ctx.refresh, window,

package/src/plugins/builtin/ticker-detail/overview/model.ts

@@ -1,9 +1,9 @@
 import { formatPriceEarnings, NOT_MEANINGFUL } from "../../../../utils/price-earnings";
 import { convertMarketCapitalization } from "../../../../utils/market-capitalization";
 import { priceColor } from "../../../../theme/colors";
-import type { CompanyProfile, DepositaryPair, NextEarnings, Quote, TickerFinancials } from "../../../../types/financials";
+import type { CedearRatio, CompanyProfile, DepositaryPair, NextEarnings, Quote, TickerFinancials } from "../../../../types/financials";
 import { adrRatioText } from "../../../../utils/depositary-receipt";
-import { ratioCount } from "../../../../market-data/depositary-pair";
+import { cedearRatioText, ratioCount } from "../../../../market-data/depositary-pair";
 import { ADR_PAIR_TAB_ID, ADR_PAIR_TEMPLATE_ID } from "../adr-pair/model";
 import type { Portfolio, TickerPosition, TickerRecord } from "../../../../types/ticker";
 import type { BrokerInstanceConfig } from "../../../../types/config";
@@ -151,6 +151,7 @@ export function buildOverviewStats({
   nextEarnings,
   depositaryReceipt = false,
   depositaryPair = null,
+  cedearRatio = null,
   today,
   dividend,
   bond = null,
@@ -169,6 +170,8 @@ export function buildOverviewStats({
   depositaryReceipt?: boolean;
   /** The receipt pair the listing is a side of, as Gloom Cloud serves it; `receiptSide` when the listing is the receipt. */
   depositaryPair?: { pair: DepositaryPair; receiptSide: boolean } | null;
+  /** A Buenos Aires CEDEAR's ratio in its company's shares, as Gloom Cloud serves it. */
+  cedearRatio?: CedearRatio | null;
   /** The listing's calendar day, YYYY-MM-DD; dates before it are left out. */
   today?: string;
   /** The history the dividend yield reads (useOverviewDividend): a trailing one is measured from its cash, a forward one stops with it; without it the yield stands. */
@@ -221,7 +224,12 @@ export function buildOverviewStats({
     const count = ratioCount(pair.ratio);
     stats.push(receiptSide
       ? { label: "ADR Ratio", value: `1:${count}`, detail: [adrRatioText(pair.ratio)!, `${count} sh per ADR`], link: ADR_PAIR }
-      : { label: "ADR", value: pair.receipt, detail: [`1 ADR = ${count} of these share${pair.ratio === 1 ? "" : "s"}`, `1:${count}`], link: ADR_PAIR });
+      : { label: "ADR", value: pair.receipt, detail: [`1 ADR = ${count} of these shares`, `1:${count}`], link: ADR_PAIR });
+  }
+  if (cedearRatio) {
+    const receipts = ratioCount(cedearRatio.receipts);
+    const shares = ratioCount(cedearRatio.shares);
+    stats.push({ label: "CEDEAR Ratio", value: `${receipts}:${shares}`, detail: [cedearRatioText(cedearRatio), `${receipts} per ${shares} sh`] });
   }
   const trailingPE = liveTrailingPE(quote, fundamentals);
   if (trailingPE != null) {