@gloom-sh/terminal 0.18.5 → 0.19.1

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

@@ -40,7 +40,6 @@ import {
   DEFAULT_ISSUER_SORT,
   DEFAULT_TRADE_SORT,
   ISSUER_SORT_COLUMN_IDS,
-  TRADE_SORT_COLUMN_IDS,
   buildIssuerColumns,
   buildTradeColumns,
   cdsFreshness,
@@ -48,9 +47,11 @@ import {
   formatEventTime,
   formatMaturity,
   formatNotional,
+  formatPoints,
   formatQuoted,
   formatQuotedMove,
   formatUpfront,
+  hasPointsQuotes,
   issuerListSort,
   lastTradeOf,
   noLevelMessage,
@@ -63,6 +64,7 @@ import {
   spreadChartPoints,
   spreadFigures,
   summarizeIssuers,
+  tradeSortColumnIds,
   tradesForIssuer,
   withSpreadLevels,
   type CdsIssuerSummary,
@@ -138,6 +140,11 @@ function renderTradeCell(row: CdsTrade, column: TradeColumn, lineMaturity: strin
         text: formatBp(row.spreadBp),
         color: dimmed ?? (row.spreadBp == null ? colors.textDim : colors.textBright),
       };
+    case "points":
+      return {
+        text: formatPoints(row.pointsUpfront),
+        color: dimmed ?? (row.pointsUpfront == null ? colors.textDim : colors.textBright),
+      };
     case "upfront":
       return {
         text: formatUpfront(row),
@@ -175,7 +182,8 @@ function CdsTradeTable({
   /** What an empty table says: the window and the name searched. */
   emptyMessage: string;
 }) {
-  const columns = useMemo(() => buildTradeColumns(width), [width]);
+  const points = hasPointsQuotes(trades);
+  const columns = useMemo(() => buildTradeColumns(width, points), [points, width]);
   const renderTradeRow = useCallback((trade: CdsTrade, column: TradeColumn) => (
     renderTradeCell(trade, column, lineMaturity)
   ), [lineMaturity]);
@@ -276,7 +284,7 @@ function IssuerHeader({ issuer, line, trades, width, height, focused, loading, s
   });
   return (
     <ChartTableHeader width={width} height={height} tableRows={trades.length} figures={figures}
-      tableColumns={buildTradeColumns(width)}
+      tableColumns={buildTradeColumns(width, hasPointsQuotes(trades))}
       chart={points.length >= 2 || loading || why ? {
         series,
         formatValue: (value: number) => formatQuoted(unit, value),
@@ -388,12 +396,13 @@ export function CdsPane({
     setDetailOpen(false);
   }, [issuerQuery, issuers, selectedIssuerKey]);
 
+  const tradePoints = hasPointsQuotes(visibleTrades);
   const cycleTradeSort = useCallback((step: 1 | -1) => {
     setTradeSort((current) => {
-      const next = cycleSortPreference<TradeColumnId>(TRADE_SORT_COLUMN_IDS, current, step);
+      const next = cycleSortPreference<TradeColumnId>(tradeSortColumnIds(tradePoints), current, step);
       return { columnId: next.columnId ?? DEFAULT_TRADE_SORT.columnId, direction: next.direction };
     });
-  }, []);
+  }, [tradePoints]);
   const cycleIssuerSort = useCallback((step: 1 | -1) => {
     setIssuerSort((current) => {
       const next = cycleSortPreference<IssuerColumnId>(ISSUER_SORT_COLUMN_IDS, current, step);
@@ -451,6 +460,8 @@ export function CdsPane({
     query: issuerQuery ? activity?.query ?? issuerQuery : selectedSummary?.issuer ?? null,
     issuer: issuerQuery ? activity?.issuer ?? null : selectedSummary?.issuer ?? null,
     days: activity?.days ?? CDS_TRADE_DAYS,
+    // A name the covered issuers do not have, once the tape has neither trades nor a line under it.
+    unmatched: issuerQuery && activity?.unmatched && !trades.length && history.data && !history.data.issuer ? activity.unmatched : null,
   });
 
   if (status === "loading" && !activity) {

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

@@ -11,6 +11,7 @@ import {
 } from "../../../components";
 import { DetailReader } from "../../../components/reader/detail-reader";
 import { loadingErrorFooterInfo, usePaneRefreshKey } from "../../../components/data-table/table-pane";
+import { createTtlCache } from "../../../data/ttl-cache";
 import { fetchChangelogReleases, type ChangelogRelease } from "../../../updater/github-releases";
 import { colors } from "../../../theme/colors";
 import type { PaneProps } from "../../../types/plugin";
@@ -32,7 +33,8 @@ const CHANGELOG_CACHE_TTL_MS = 10 * 60 * 1000;
 
 // Process-lifetime cache. Move it into the updater module if other
 // surfaces start reading releases too.
-let cachedReleases: { releases: ChangelogRelease[]; fetchedAt: number } | null = null;
+const releaseCache = createTtlCache<ChangelogRelease[]>({ ttlMs: CHANGELOG_CACHE_TTL_MS });
+const RELEASES = "releases";
 
 type ChangelogColumn = DataTableColumn & { id: ChangelogColumnId };
 type LoadStatus = "loading" | "loaded" | "error";
@@ -83,10 +85,10 @@ function ChangelogDetail({
 function ChangelogPane({ focused, width, height }: PaneProps) {
   const paneInstance = usePaneInstance();
   const requestedVersion = paneInstance?.params?.version ?? null;
-  const [releases, setReleases] = useState<ChangelogRelease[]>(() => cachedReleases?.releases ?? []);
+  const [releases, setReleases] = useState<ChangelogRelease[]>(() => releaseCache.peek(RELEASES, { stale: true }) ?? []);
   // The mount effect starts the request immediately, so the first paint is a
   // spinner and never "No changelog entries found".
-  const [status, setStatus] = useState<LoadStatus>(() => (cachedReleases ? "loaded" : "loading"));
+  const [status, setStatus] = useState<LoadStatus>(() => (releaseCache.peek(RELEASES, { stale: true }) ? "loaded" : "loading"));
   const [error, setError] = useState<string | null>(null);
   // The selected row and the open release are pane state, so a reload or a
   // shared layout comes back to the same release.
@@ -98,8 +100,9 @@ function ChangelogPane({ focused, width, height }: PaneProps) {
   const requestedVersionOpenedRef = useRef(false);
 
   const loadReleases = useCallback(async (force = false) => {
-    if (!force && cachedReleases && Date.now() - cachedReleases.fetchedAt < CHANGELOG_CACHE_TTL_MS) {
-      setReleases(cachedReleases.releases);
+    const fresh = force ? undefined : releaseCache.peek(RELEASES);
+    if (fresh) {
+      setReleases(fresh);
       setError(null);
       setStatus("loaded");
       return;
@@ -118,7 +121,7 @@ function ChangelogPane({ focused, width, height }: PaneProps) {
 
     try {
       const nextReleases = await fetchChangelogReleases(CHANGELOG_LIMIT, controller.signal);
-      cachedReleases = { releases: nextReleases, fetchedAt: Date.now() };
+      releaseCache.set(RELEASES, nextReleases);
       setReleases(nextReleases);
       setStatus("loaded");
     } catch (loadError) {

package/src/plugins/builtin/chart-composer/catalog-inventory.ts

@@ -31,6 +31,8 @@ export interface CatalogSeriesRow {
   /** The registered expression, `{ticker}` where a symbol goes. */
   template: string;
   url?: string;
+  /** A limit the publisher sets on the series' data, such as how far back its history goes. */
+  limitation?: string;
   /** Asks for a symbol before charting. */
   input?: SeriesInput;
   /** The symbol a row filled in for a typed ticker charts. */
@@ -120,6 +122,7 @@ function rowFromEntry(entry: SeriesCatalogEntry): Omit<CatalogSeriesRow, "order"
     expression,
     template: entry.expression,
     ...(entry.url ? { url: entry.url } : {}),
+    ...(entry.limitation ? { limitation: entry.limitation } : {}),
     ...(entry.input ? { input: entry.input } : {}),
     ...(entry.placement || entry.lines?.length ? {
       seriesName: entry.name,

package/src/plugins/builtin/chart-composer/cli-options.ts

@@ -81,6 +81,10 @@ export function applyChartComposerCapabilityOptions(
     next = { ...next, viewport: { ...next.viewport, extendedHours: true } };
   }
 
+  if (capabilityId === "price-comparison" && options.totalReturn === true) {
+    next = { ...next, viewport: { ...next.viewport, totalReturn: true } };
+  }
+
   if (PRICE_CAPABILITIES.has(capabilityId) && options.axisMode) {
     const transform = options.axisMode === "percent" ? "percent" : "raw";
     next = {

package/src/plugins/builtin/chart-composer/data-catalog-pane.tsx

@@ -4,6 +4,7 @@ import { Box } from "../../../ui";
 import {
   DataTableView,
   QueryBar,
+  usePaneNoticeFooter,
   usePaneTabs,
   useQueryBarSearch,
   type DataTableCell,
@@ -242,6 +243,12 @@ export function DataCatalogPane({ focused, width, height }: PaneProps) {
     }
   }, []);
 
+  usePaneNoticeFooter({
+    registrationId: `${DATA_CATALOG_PANE_ID}:notices`,
+    focused,
+    notices: selectedRow?.limitation ? [`${selectedRow.label}: ${selectedRow.limitation}`] : [],
+  });
+
   usePaneStatusLinkFooter({
     registrationId: DATA_CATALOG_PANE_ID,
     focused,

package/src/plugins/builtin/chart-composer/editor/controller.ts

@@ -10,7 +10,7 @@ import type {
   SeriesTimestampMode,
   SeriesTransform,
 } from "../../../../time-series/types";
-import { hasStudyInputCount, validateChartSpec } from "../../../../time-series/spec";
+import { hasStudyInputCount, isOhlcSeriesStyle, validateChartSpec } from "../../../../time-series/spec";
 import { isPlainKey } from "../../../../utils/keyboard";
 import { getSharedRegistry } from "../../../registry";
 import {
@@ -415,7 +415,7 @@ export function useSeriesEditorController({
         : current.panels,
       series: replaceAt(current.series, selectedIndex, (() => {
         const currentSeries = current.series[selectedIndex]!;
-        const ohlcStyle = currentSeries.style === "candles" || currentSeries.style === "ohlc" || currentSeries.style === "hlc";
+        const ohlcStyle = isOhlcSeriesStyle(currentSeries.style);
         return {
           ...currentSeries,
           style: transform !== "raw" && ohlcStyle

package/src/plugins/builtin/chart-composer/follow-binding.ts

@@ -21,6 +21,16 @@ function normalized(instrument: InstrumentRef): InstrumentRef {
 const key = (instrument: InstrumentRef) => instrumentIdentityKey(normalized(instrument));
 const publicKey = (instrument: InstrumentRef) => publicTickerKey(instrument.symbol, instrument.exchange);
 
+/**
+ * One listing however a series names it: the same symbol and broker contract, on the same venue
+ * or with the venue left out on either side (`AAPL` added beside a revenue line on `AAPL:NASDAQ`).
+ */
+function sameListing(left: InstrumentRef, right: InstrumentRef): boolean {
+  const a = normalized(left), b = normalized(right);
+  return key({ ...a, exchange: "" }) === key({ ...b, exchange: "" })
+    && (!a.exchange || !b.exchange || canonicalExchange(a.exchange) === canonicalExchange(b.exchange));
+}
+
 /** Bootstrap old charts once; persisted IDs keep ownership through comparison collisions. */
 export function resolveFollowSeriesIds(
   spec: ChartSpec,
@@ -44,8 +54,10 @@ export function resolveFollowSeriesIds(
     || (next && securities.find(series => series.source.kind === "security" && publicKey(normalized(series.source.instrument)) === publicKey(next)))
     || securities[0];
   if (!owner || owner.source.kind !== "security") return [];
-  const ownerKey = key(owner.source.instrument);
-  return securities.filter(series => series.source.kind === "security" && key(series.source.instrument) === ownerKey).map(series => series.id);
+  const ownerInstrument = owner.source.instrument;
+  // Every field of the followed ticker moves with it (revenue and total debt); other tickers stay.
+  return securities.filter(series => series.source.kind === "security" && sameListing(series.source.instrument, ownerInstrument))
+    .map(series => series.id);
 }
 
 /** Only the followed series move; other contracts and comparisons stay authored. */

package/src/plugins/builtin/chart-composer/headless-schema.ts

@@ -138,6 +138,12 @@ export const paneSchemas = {
         ],
         defaultValue: "percent",
       },
+      {
+        key: "totalReturn",
+        description: "Reinvest each cash distribution at its ex-date close, so the returns are total returns, not price returns.",
+        type: "boolean",
+        defaultValue: false,
+      },
       {
         key: "chartResolution",
         description: BAR_SIZE_DESCRIPTION,
@@ -151,7 +157,7 @@ export const paneSchemas = {
     discovery: {
       id: "price-comparison",
       aliases: ["stock comparison", "price performance comparison", "returns comparison", "compare stock prices"],
-      limitations: ["Compares closing-price changes in each listing's currency over shared observation dates. Cash distributions and FX conversion are excluded; these are not reinvested total returns."],
+      limitations: ["Compares closing-price changes in each listing's currency over shared observation dates. Cash distributions and FX conversion are excluded unless totalReturn is set, which reinvests each distribution at its ex-date close; FX conversion is never applied."],
       screenshotReadiness: "ready",
     },
   },

package/src/plugins/builtin/chart-composer/headless.ts

@@ -228,6 +228,8 @@ export async function loadChartPaneModel(
         ...reported,
         ...name ? { name } : {},
         ...valueDecimals !== undefined ? { textDecimals: valueDecimals } : {},
+        // A company's reported total (revenue, market cap) reads as 63.33B in the report, as in the legend and the tables.
+        ...series.unitGroup.split(":")[0] === "currency-total" ? { textCompact: true } : {},
         derived: !ids.has(series.id),
         points: series.points.map((point) => ({
           ...point,
@@ -251,7 +253,7 @@ export async function loadChartPaneModel(
       ...(chart.priceHistoryIntegrity?.length ? { priceHistoryIntegrity: chart.priceHistoryIntegrity } : {}),
       ...(valuationPriceIssues.length ? { valuationPriceIssues } : {}),
       ...(periodCoverage.length ? { periodCoverage } : {}),
-      notices: [...chart.warnings.filter((warning) => warning === FINANCIAL_VINTAGE_NOTICE || warning === SEC_EPS_BASIS_NOTICE || warning === chart.priceComparison?.notice
+      notices: [...chart.coverageNotices ?? [], ...chart.returnBasisNotice ? [chart.returnBasisNotice] : [], ...chart.warnings.filter((warning) => warning === FINANCIAL_VINTAGE_NOTICE || warning === SEC_EPS_BASIS_NOTICE || warning === chart.priceComparison?.notice
         || chart.delistings?.some((delisting) => delisting.notice === warning)), ...integrityNotices],
       priceComparison: chart.priceComparison ?? null,
       summaries: chart.series.filter((series) => !series.profile).map((series) => ({ id: series.id, ...summarizeResolvedSeries(series) })),
@@ -723,6 +725,9 @@ export function chartHeadless(template: keyof typeof paneSchemas): HeadlessPaneD
         }, context.marketData) };
       }
       const model = await loadChartPaneModel(spec, context);
+      // A bare coin ticker charted as another listing (ETH, the Grayscale fund) says where the coin is, as `quote` does.
+      const coinNotes = (await Promise.all(listings.values())).flatMap((read) => read?.coinNote ?? []);
+      if (coinNotes.length) model.warnings = [...model.warnings ?? [], ...coinNotes];
       if (template === "graph-intraday-price-pane" && !intradayHistories.length && model.chart.viewport) {
         const { start, end } = model.chart.viewport;
         for (const { target, data } of [

package/src/plugins/builtin/chart-composer/index.tsx

@@ -10,7 +10,6 @@ import { parseTickerListInput } from "../../../tickers/list";
 import { canonicalExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
 import { tickerInstrumentLabel } from "../../../tickers/instrument-label";
 import type { ChartSpec } from "../../../time-series/types";
-import { isPriceOnlyMarketFieldId } from "../../../time-series/field-catalog";
 import { ChartComposerPane, ChartComposerResearchTab } from "./pane";
 import { DataCatalogPane } from "./data-catalog-pane";
 import { listFieldSeries } from "./field-series";
@@ -453,7 +452,7 @@ const chartComposerTemplates: PaneTemplateDef[] = [
     prefix: "CMP",
     aliases: ["COMP", "TRA"],
     label: "Comparison Chart",
-    description: "Compare price returns over shared observation dates for two or more tickers. A leveraged or inverse fund gets its daily objective drawn from its index fund (3× daily QQQ beside TQQQ) and its decay against it.",
+    description: "Compare price returns over shared observation dates for two or more tickers, or total returns with distributions reinvested. A leveraged or inverse fund gets its daily objective drawn from its index fund (3× daily QQQ beside TQQQ) and its decay against it.",
     // Leveraged and inverse funds: the daily line and the decay come with the comparison.
     keywords: ["leveraged", "inverse", "decay", "daily-reset", "daily reset", "volatility decay"],
     argKind: "ticker-list",
@@ -484,9 +483,10 @@ const chartComposerTemplates: PaneTemplateDef[] = [
 ];
 
 /**
- * A price chart of one security (GP, GIP, a custom price chart of one ticker) can follow a list.
- * A comparison would move only its first ticker, a FRED-only chart has no ticker to follow, and
- * fundamental and valuation graphs (GF, GE) stay out even for one ticker.
+ * A chart whose securities are all one ticker can follow a list: GP, GIP, and GF or GE of one
+ * ticker, whatever fields it shows (revenue beside total debt). Every series of that ticker moves
+ * to the selected one and keeps its field; FRED and other series stay as they are. A comparison
+ * of several tickers would move only one of them, and a FRED-only chart has no ticker to follow.
  */
 function chartShowsOneSecurity(pane: PaneInstanceConfig): boolean {
   const spec = parseChartSpec(pane.settings?.[CHART_SPEC_SETTING_KEY]);
@@ -495,7 +495,6 @@ function chartShowsOneSecurity(pane: PaneInstanceConfig): boolean {
   const symbols = new Set<string>();
   for (const series of spec.series) {
     if (series.source.kind !== "security") continue;
-    if (!isPriceOnlyMarketFieldId(series.source.fieldId)) return false;
     symbols.add(parsePublicTickerKey(series.source.instrument.symbol).symbol.toUpperCase());
   }
   return symbols.size === 1;

package/src/plugins/builtin/chart-composer/pane.tsx

@@ -55,7 +55,9 @@ import {
 import { colors } from "../../../theme/colors";
 import { isUsListingExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
 import { getTimeSeriesField, isMarketFieldId } from "../../../time-series/field-catalog";
-import { isDatasetChart } from "../../../time-series/spec";
+import { isDatasetChart, isOhlcSeriesStyle } from "../../../time-series/spec";
+import { useThemeColors } from "../../../theme/theme-context";
+import { priceComparisonSeriesIds } from "../../../time-series/price-comparison";
 import { seriesMessageName, studyMessageName } from "../../../time-series/series-name";
 import { CHART_COMPOSER_PANE_ID } from "../../../types/config";
 import { useRemoteUiNode } from "../../../remote/semantic-tree";
@@ -117,6 +119,8 @@ import {
   CHART_BAR_SIZE_PRESETS,
   CHART_RANGES as RANGES,
   CHART_RESOLUTIONS,
+  CHART_CANDLE_COLOURS_SETTING_KEY,
+  chartCandleColours,
   chartStudyOptionsFor,
   chartStudyPeriodTitle,
   chartStudySettingLabel,
@@ -342,6 +346,14 @@ function ChartComposerSurface({
   // plausible time is dropped without pinning. This handle only sets the
   // pin; the chart it opens on is what shows and keeps it.
   const [pinnedMoment, setPinnedMoment] = usePaneSettingValue<unknown>(CHART_PINNED_MOMENT_SETTING_KEY, null);
+  const [candleColoursSetting] = usePaneSettingValue<unknown>(CHART_CANDLE_COLOURS_SETTING_KEY, null);
+  const gainColour = useThemeColors().positive;
+  // Rising candles in the gain colour; falling ones already take the loss colour.
+  const candleColour = useCallback((list: ResolvedSeries[]) => (
+    chartCandleColours(candleColoursSetting) === "change"
+      ? list.map((entry) => isOhlcSeriesStyle(entry.style) ? { ...entry, color: gainColour } : entry)
+      : list
+  ), [candleColoursSetting, gainColour]);
   const momentLink = useTabCursorLink(paneId ? `${paneId}:moment` : null, { viewer: false });
   useEffect(() => {
     if (pinnedMoment == null || !momentLink?.pin) return;
@@ -475,9 +487,9 @@ function ChartComposerSurface({
     });
     const resolvedIds = new Set(resolved.map((entry) => entry.id));
     const missing = spec.series.filter((entry) => !resolvedIds.has(entry.id));
-    if (missing.length === 0) return resolved;
+    if (missing.length === 0) return candleColour(resolved);
     const bySpecOrder = new Map(spec.series.map((entry, index) => [entry.id, index] as const));
-    return [
+    return candleColour([
       ...resolved,
       ...missing.map((entry): ResolvedSeries => ({
         id: entry.id,
@@ -495,15 +507,15 @@ function ChartComposerSurface({
         hidden: true,
         points: [],
       })),
-    ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER));
-  }, [listings.names, nameSeries, resolution.legendSeries, spec.series]);
+    ].sort((a, b) => (bySpecOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (bySpecOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER)));
+  }, [candleColour, listings.names, nameSeries, resolution.legendSeries, spec.series]);
   const plottedSeries = useMemo(
-    () => projectVisibleChartSeries(
+    () => candleColour(projectVisibleChartSeries(
       spec,
       resolution.bufferedSeries ?? resolution.series,
       resolution.legendSeries,
-    ),
-    [resolution.bufferedSeries, resolution.legendSeries, resolution.series, spec],
+    )),
+    [candleColour, resolution.bufferedSeries, resolution.legendSeries, resolution.series, spec],
   );
   const { notify } = usePluginAppActions();
   const { runtime } = usePluginRenderContext();
@@ -1190,6 +1202,22 @@ function ChartComposerSurface({
     }]
     : [];
 
+  // Returns of two or more prices compare as price returns; the toggle reinvests their cash distributions.
+  const totalReturnOn = spec.viewport.totalReturn === true;
+  const totalReturnFilters = totalReturnOn || priceComparisonSeriesIds(spec) !== null
+    ? [{
+      id: "total-return",
+      kind: "toggle" as const,
+      label: "Total return",
+      short: "Total ret",
+      value: totalReturnOn,
+      onChange: (value: boolean) => {
+        const { totalReturn: _previous, ...viewport } = specRef.current.viewport;
+        updateSpec({ ...specRef.current, viewport: value ? { ...viewport, totalReturn: true } : viewport });
+      },
+    }]
+    : [];
+
   // A company that reports no quarterly figures says so, and where its annual ones are.
   const unreported = resolution.legendSeries?.find((entry) => entry.unreportedPeriod && entry.points.length === 0);
   const emptyMessage = spec.series.length === 0
@@ -1216,6 +1244,7 @@ function ChartComposerSurface({
             onChange: (value: string) => setRange(value as TimeRange) },
           ...genericFilters,
           ...extendedHoursFilters,
+          ...totalReturnFilters,
         ]}
         view={resolutionOptions.length > 1 ? {
           value: spec.viewport.resolution,

package/src/plugins/builtin/chart-composer/settings.ts

@@ -129,6 +129,20 @@ export const CHART_SETTING_KEYS = {
   realizedVolEstimator: "chartRealizedVolEstimator",
 } as const;
 
+/**
+ * Whether rising candles take their series' colour or the theme's gain colour.
+ * Kept beside the spec in the pane's settings, so a build without it opens the
+ * chart unchanged; it is not one of CHART_SETTING_KEYS, which a spec edit
+ * clears as derived from the spec.
+ */
+export const CHART_CANDLE_COLOURS_SETTING_KEY = "chartCandleColours";
+
+export type ChartCandleColours = "series" | "change";
+
+export function chartCandleColours(value: unknown): ChartCandleColours {
+  return value === "change" ? "change" : "series";
+}
+
 function fallbackSpec(symbol: string | null | undefined): ChartSpec {
   return symbol ? buildPriceChartPreset(symbol) : buildEmptyChartPreset();
 }
@@ -417,6 +431,7 @@ export function buildChartComposerPaneSettingsDef(
       [CHART_SETTING_KEYS.range]: spec.viewport.range,
       [CHART_SETTING_KEYS.resolution]: spec.viewport.resolution,
       [CHART_SETTING_KEYS.mode]: inlineStyleTarget?.style ?? "",
+      [CHART_CANDLE_COLOURS_SETTING_KEY]: chartCandleColours(settings[CHART_CANDLE_COLOURS_SETTING_KEY]),
       ...(realizedVol ? {
         [CHART_SETTING_KEYS.realizedVolWindow]: String(realizedVol.parameters.window ?? 30),
         [CHART_SETTING_KEYS.realizedVolEstimator]: realizedVol.parameters.estimator ?? "close-to-close",
@@ -494,6 +509,18 @@ export function buildChartComposerPaneSettingsDef(
           options: modes.map((mode) => ({ value: mode, label: mode.toUpperCase() })),
         }]
         : []),
+      ...(spec.series.some((series) => isOhlcSeriesStyle(series.style))
+        ? [{
+          key: CHART_CANDLE_COLOURS_SETTING_KEY,
+          label: "Candle Colours",
+          description: "Draw rising candles in their series' colour, or in the theme's gain colour against its loss colour.",
+          type: "select" as const,
+          options: [
+            { value: "series", label: "Series colour" },
+            { value: "change", label: "Gains & losses" },
+          ],
+        }]
+        : []),
     ],
     applyValue: applyChartComposerPaneSetting,
   };

package/src/plugins/builtin/chat/content/command-suggestions.ts

@@ -55,6 +55,7 @@ export function filterCommandSuggestions(
   const byCode: ChatFunction[] = [];
   const byName: ChatFunction[] = [];
   for (const fn of new Set(functions.values())) {
+    if (fn.unlisted) continue;
     if (fn.code.startsWith(upper) || fn.aliases.includes(upper)) byCode.push(fn);
     else if (fn.name.toLowerCase().split(/[\s/&()-]+/).some((word) => word.startsWith(lower))) byName.push(fn);
   }

package/src/plugins/builtin/chat/controller/index.ts

@@ -74,6 +74,7 @@ import { ChatControllerMessageLoading } from "./message-loading";
 import { ChatMentionCandidates } from "./mention-candidates";
 import { ChatControllerStorage } from "./storage";
 import { listUnreadInboxItems } from "../unread-inbox";
+import { ChatStatusPreview } from "../status-preview";
 import type { ChatConversationList } from "../conversations";
 import {
   conversationActivityAt,
@@ -118,6 +119,8 @@ export class ChatController {
   );
   private notifyFn: (notification: AppNotificationRequest) => AppNotificationDelivery | void = () => {};
   private openMessageFn: ((channelId: string, messageId: string) => void) | undefined;
+  /** A DM, mention or reply that shows in the status bar on arrival; the status bar widget draws it. */
+  readonly statusPreview = new ChatStatusPreview();
   private readonly alerts = new ChatNotificationAlerts({
     getAppActive: () => this.appActive,
     ensureChannelState: (channelId) => this.ensureChannelState(channelId),
@@ -125,6 +128,7 @@ export class ChatController {
     getChannel: (channelId) => this.channelCatalog.getChannels().find((channel) => channel.id === channelId),
     getNotify: () => this.notifyFn,
     getOpenMessage: () => this.openMessageFn,
+    statusPreview: this.statusPreview,
   });
 
   private readonly storage = new ChatControllerStorage({
@@ -271,7 +275,7 @@ export class ChatController {
    * Keeps who sent each channel's unread messages (`unreadPeople` in the
    * snapshot) current until the returned stop is called, reading what the
    * device does not hold. Nothing is read, and the snapshot leaves it empty,
-   * unless something tracks it: only the app badge needs it.
+   * unless something tracks it: the app badge and the status bar widget.
    */
   trackUnreadPeople(): () => void {
     return this.unreadPeople.track();

package/src/plugins/builtin/chat/controller/notifications.ts

@@ -5,7 +5,9 @@ import type {
 import { apiClient, type ChatChannel, type ChatMessage, type ChatNotification } from "../../../../api-client";
 import type { ChannelRuntimeState, MergeMessagesOptions } from "./state";
 import { formatChatPaneTitle } from "../channel-labels";
+import type { ChatStatusPreview } from "../status-preview";
 import {
+  chatMessageLine,
   formatChannelToast,
   formatMentionToast,
   formatReplyToast,
@@ -28,6 +30,8 @@ interface ChatNotificationAlertsOptions {
   getChannel: (channelId: string) => ChatChannel | undefined;
   getNotify: () => Notify;
   getOpenMessage: () => ((channelId: string, messageId: string) => void) | undefined;
+  /** Where a message for you shows on arrival instead of a toast, while the status bar has room. */
+  statusPreview: ChatStatusPreview;
 }
 
 /** Whether this window holds the message as read: its read marker is at or after it. */
@@ -53,9 +57,9 @@ function acknowledge(notification: ChatNotification, seen: boolean): void {
 }
 
 /**
- * Decides, once per message, whether a chat notification becomes a toast or
- * a desktop banner. A message already read here or on another device stays
- * quiet, whether it arrives live or again on reconnect.
+ * Decides, once per message, whether a chat notification shows in the status
+ * bar, as a toast or as a desktop banner. A message already read here or on
+ * another device stays quiet, whether it arrives live or again on reconnect.
  */
 export class ChatNotificationAlerts {
   private readonly notifiedMessageIds = new Set<string>();
@@ -94,6 +98,7 @@ export class ChatNotificationAlerts {
     for (const timer of this.waiting.values()) clearTimeout(timer);
     this.waiting.clear();
     this.notifiedMessageIds.clear();
+    this.options.statusPreview.dismiss();
   }
 
   /** Read here, or open in front of the reader: nothing to raise, and the server hears it was seen. */
@@ -124,8 +129,33 @@ export class ChatNotificationAlerts {
     this.present(notification);
   }
 
+  /**
+   * A DM or group message, a mention or a reply, while the app is in front:
+   * the status bar shows it in place of the toast when it has room, and the
+   * server hears it was seen, as for a toast. Channel chatter never shows there.
+   */
+  private presentInStatusBar(notification: ChatNotification, channel: ChatChannel | undefined): boolean {
+    const direct = channel?.kind === "direct" || channel?.kind === "group";
+    if (!this.options.getAppActive() || (notification.type === "channel" && !direct)) return false;
+    const { message } = notification;
+    const sentAt = Date.parse(message.createdAt);
+    const shown = this.options.statusPreview.offer({
+      channelId: notification.channelId,
+      messageId: notification.messageId,
+      senderName: message.user.username?.trim() || message.user.displayName,
+      direct,
+      text: chatMessageLine(message),
+      at: Number.isFinite(sentAt) ? sentAt : Date.now(),
+    });
+    if (!shown) return false;
+    this.notifiedMessageIds.add(notification.messageId);
+    acknowledge(notification, true);
+    return true;
+  }
+
   private present(notification: ChatNotification): void {
     const channel = this.options.getChannel(notification.channelId);
+    if (this.presentInStatusBar(notification, channel)) return;
     const body = notification.type === "reply"
       ? formatReplyToast(notification.message)
       : notification.type === "mention"

package/src/plugins/builtin/chat/controller/state.ts

@@ -46,12 +46,34 @@ export interface PersistedTranscript {
   messages: ChatMessage[];
 }
 
+/** An unread message for you: who sent it, and when. */
+export interface UnreadMessageForYou {
+  /** Null for a DM whose unread messages are not on this device: only the sender is known. */
+  messageId: string | null;
+  senderId: string;
+  /** The sender's username, or their name without one. */
+  senderName: string;
+  /** When it was sent, in ms; zero when not known. */
+  at: number;
+}
+
 /** Who the unread messages of one channel are from, by account id. */
 export interface ChannelUnreadPeople {
   /** Everyone who sent an unread message there. */
   senders: string[];
-  /** The ones among them with an unread message that mentions you. */
+  /** The ones among them with an unread message that mentions you or replies to you. */
   mentioners: string[];
+  /**
+   * The newest unread message for you: in a DM or group chat the newest
+   * unread message, elsewhere the newest that mentions or replies to you.
+   * Null when none is known on this device.
+   */
+  latestForYou: UnreadMessageForYou | null;
+  /**
+   * How many unread messages are for you: every one in a DM or group chat,
+   * the ones known to mention or reply to you elsewhere.
+   */
+  forYouCount: number;
 }
 
 export interface ChatControllerSnapshot {
@@ -83,7 +105,8 @@ export interface ChatControllerSnapshot {
   unreadMentionCount: number;
   /**
    * Who sent the unread messages of each channel with any, by channel id: what
-   * the app badge counts people from. Empty unless the badge asked for it
+   * the app badge counts people from and the status bar names them from.
+   * Empty unless one of them asked for it
    * ({@link ChatController.trackUnreadPeople}). A channel whose unread messages
    * are not on this device yet lists only the ones that are, until they load.
    */