@gloom-sh/terminal 0.19.1 → 0.19.3

package/src/plugins/builtin/crypto-board/bitcoin-network.ts

@@ -0,0 +1,143 @@
+import { apiClient } from "../../../api-client";
+import { ApiRequestError } from "../../../api-client/errors";
+import type { BitcoinNetworkDailyValue, BitcoinNetworkPayload } from "../../../api-client/crypto-markets";
+import { createPluginCache } from "../../../data/plugin-cache";
+import type { SeriesAttribution, SeriesDefinition, SeriesPoint } from "../../../series/types";
+import { isFiniteNumber } from "../../../utils/guards";
+import { loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
+import { cachedSeriesNote } from "../shared/series-warning";
+
+const bitcoinNetworkCache = createPluginCache<BitcoinNetworkPayload>({
+  kind: "bitcoin-network",
+  source: "gloom-cloud",
+  schemaVersion: 1,
+  // The server reads the estimate every half hour and the daily figures every six hours.
+  policy: { staleMs: 30 * 60_000, expireMs: 30 * 86_400_000 },
+});
+
+export const BITCOIN_NETWORK_CACHES = [bitcoinNetworkCache] as const;
+
+const MAX_DAYS = 20_000;
+const date = (value: unknown): value is string => typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value);
+const instant = (value: unknown): value is string => typeof value === "string" && Number.isFinite(Date.parse(value));
+const daily = (rows: unknown): rows is BitcoinNetworkDailyValue[] => Array.isArray(rows) && rows.length <= MAX_DAYS
+  && rows.every((row) => !!row && date((row as BitcoinNetworkDailyValue).date) && isFiniteNumber((row as BitcoinNetworkDailyValue).value));
+
+function validateBitcoinNetwork(data: BitcoinNetworkPayload): BitcoinNetworkPayload {
+  const retarget = data?.retarget;
+  if (
+    !data
+    || data.version !== 1
+    || !instant(data.generatedAt)
+    || typeof data.source?.name !== "string" || !data.source.name.trim()
+    || !["available", "stale", "unavailable"].includes(data.status)
+    || !daily(data.hashrate)
+    || !daily(data.hashprice)
+    || !daily(data.retargetHistory)
+    || !Array.isArray(data.difficulty)
+    || !data.difficulty.every((row) => !!row && date(row.date) && isFiniteNumber(row.difficulty) && row.difficulty > 0)
+    || (retarget !== null && (!retarget || !isFiniteNumber(retarget.changePercent) || !instant(retarget.estimatedAt) || !instant(retarget.readAt)))
+    || !Array.isArray(data.warnings)
+  ) {
+    throw new Error("The server returned invalid bitcoin network data");
+  }
+  return data;
+}
+
+async function fetchBitcoinNetwork(client: Pick<typeof apiClient, "getCloudBitcoinNetwork"> = apiClient): Promise<BitcoinNetworkPayload> {
+  try {
+    return validateBitcoinNetwork(await client.getCloudBitcoinNetwork());
+  } catch (error) {
+    if (error instanceof ApiRequestError && error.status === 503) throw unavailableOnServer(error, "Bitcoin network data is temporarily unavailable", [503]);
+    throw unavailableOnServer(error, "Bitcoin network data is not available yet.");
+  }
+}
+
+function loadBitcoinNetwork() {
+  return loadCloudResource(bitcoinNetworkCache, "all", () => fetchBitcoinNetwork(), { validate: validateBitcoinNetwork });
+}
+
+const points = (rows: readonly BitcoinNetworkDailyValue[]): SeriesPoint[] =>
+  rows.map((row) => ({ date: Date.parse(`${row.date}T00:00:00Z`), value: row.value }));
+
+const TAGS = ["bitcoin", "BTC", "BTC-USD", "mining", "miner", "miners", "bitcoin mining", "network", "on-chain"];
+
+/**
+ * A series of the network board: its points, cited as the server names its
+ * source, with the board's warnings about this figure (`concerns`: "Hash
+ * rate, difficulty and hashprice could not refresh" is three series', "The
+ * retarget estimate is unavailable" the estimate's alone) and the
+ * cached-copy note.
+ */
+function networkSeries(
+  definition: Omit<Extract<SeriesDefinition, { load: unknown }>, "load" | "frequency" | "group">
+    & { frequency?: SeriesDefinition["frequency"] },
+  read: (payload: BitcoinNetworkPayload) => SeriesPoint[],
+  { concerns, derived }: { concerns: RegExp; derived?: string },
+): SeriesDefinition {
+  return {
+    frequency: "daily",
+    group: "Crypto",
+    refreshMs: 30 * 60_000,
+    ...definition,
+    load: async () => {
+      const resource = await loadBitcoinNetwork();
+      const found = read(resource.payload);
+      if (!found.length) throw new Error(`${definition.name} is not available yet.`);
+      const note = cachedSeriesNote(resource);
+      const own = resource.payload.warnings.filter((line) => concerns.test(line)).join(" ");
+      const warning = note.warning ?? (own || undefined);
+      const source = resource.payload.source.name.trim();
+      const attribution: SeriesAttribution = { source: derived ? `${source}, ${derived}` : source };
+      return { points: found, attribution, ...note, ...warning ? { warning } : {} };
+    },
+  } as SeriesDefinition;
+}
+
+/**
+ * The bitcoin network for `fn G`: hash rate, difficulty, the next
+ * retarget's estimate and hashprice. `fn G hashrate`, `difficulty`,
+ * `retarget` and `hashprice` chart them by their aliases; `catalog
+ * hashrate`, `hashprice`, `difficulty`, `mining` and `miner` find them by
+ * their tags.
+ */
+export const BITCOIN_NETWORK_SERIES: readonly SeriesDefinition[] = [
+  networkSeries({
+    id: "bitcoin:hashrate",
+    name: "Bitcoin network hash rate",
+    unit: "EH/s",
+    tags: [...TAGS, "hashrate", "hash rate"],
+    aliases: ["hashrate"],
+    description: "The bitcoin network's hash rate in exahashes per second, each UTC day's average, estimated from the blocks found; the newest day is the day so far.",
+  }, (payload) => points(payload.hashrate), { concerns: /\bhash rate\b/i }),
+  networkSeries({
+    id: "bitcoin:difficulty",
+    name: "Bitcoin mining difficulty (trillions)",
+    unit: "number",
+    frequency: "irregular",
+    style: "step",
+    tags: [...TAGS, "difficulty", "retarget", "difficulty adjustment"],
+    aliases: ["difficulty"],
+    description: "The difficulty each retarget set, every 2,016 blocks, in trillions, dated by the block that set it.",
+  }, (payload) => payload.difficulty.map((row) => ({ date: Date.parse(`${row.date}T00:00:00Z`), value: Number((row.difficulty / 1e12).toFixed(4)) })),
+  { concerns: /\bdifficulty\b/i }),
+  networkSeries({
+    id: "bitcoin:retarget-estimate",
+    name: "Bitcoin next difficulty retarget estimate",
+    unit: "%",
+    tags: [...TAGS, "difficulty", "retarget", "difficulty adjustment", "estimate"],
+    aliases: ["retarget"],
+    description: "The estimated change in difficulty at the next retarget, in percent, as read each UTC day since Gloom began keeping it in October 2026.",
+  }, (payload) => points(payload.retargetHistory), { concerns: /\bretarget\b/i }),
+  networkSeries({
+    id: "bitcoin:hashprice",
+    name: "Bitcoin hashprice (derived)",
+    unit: "USD/PH/s/day",
+    tags: [...TAGS, "hashprice", "hash price", "miner revenue"],
+    aliases: ["hashprice"],
+    description: "Derived, not quoted: what 1 PH/s is expected to earn in a day, in USD, at the day's difficulty, average block reward (subsidy and fees) and BTC price.",
+  }, (payload) => points(payload.hashprice), {
+    concerns: /\bhashprice\b/i,
+    derived: "derived from the block rewards, the BTC price and the difficulty",
+  }),
+];

package/src/plugins/builtin/crypto-board/client.ts

@@ -145,10 +145,10 @@ export async function fetchCryptoMarkets(
   try {
     return validateCryptoMarkets(await client.getCloudCryptoMarkets());
   } catch (error) {
-    if (error instanceof ApiRequestError && error.status === 503) {
-      throw new Error("Crypto prices are temporarily unavailable");
-    }
-    throw unavailableOnServer(error, "Crypto markets are not available yet.");
+    // Each keeps its status: a 503 passes with time and a saved copy answers it; a 404 does not.
+    throw error instanceof ApiRequestError && error.status === 503
+      ? unavailableOnServer(error, "Crypto prices are temporarily unavailable", [503])
+      : unavailableOnServer(error, "Crypto markets are not available yet.");
   }
 }
 
@@ -248,7 +248,7 @@ function validateStablecoinSupplyHistory(data: StablecoinSupplyHistoryPayload):
 }
 
 function supplyError(error: unknown, what: string): unknown {
-  if (error instanceof ApiRequestError && error.status === 503) return new Error(`${what} is temporarily unavailable`);
+  if (error instanceof ApiRequestError && error.status === 503) return unavailableOnServer(error, `${what} is temporarily unavailable`, [503]);
   return unavailableOnServer(error, `${what} is not available yet.`);
 }
 

package/src/plugins/builtin/crypto-board/headless.ts

@@ -31,15 +31,16 @@ const COIN_COLUMNS: HeadlessPaneColumn[] = [
   { key: "rank", header: "#", align: "right" },
   { key: "code", header: "Coin" },
   { key: "name", header: "Name" },
-  { key: "price", header: "Price", align: "right", format: (_value, row) => String(row.priceText ?? "—") },
+  // Every coin is priced, traded and valued in US dollars: the text headers say so; an export keeps its headers.
+  { key: "price", header: "Price", textHeader: "Price USD", align: "right", format: (_value, row) => String(row.priceText ?? "—") },
   // Since 00:00 UTC, the day `quote` gives a coin (CRYPTO_CHANGE_BASIS_LABEL): the text says so, as the pane's
   // CHG% UTC does, and an export keeps the header it has always had.
   { key: "changePercent", header: "Chg %", textHeader: "Chg % UTC", align: "right", format: percent },
   { key: "return7d", header: "7D %", align: "right", format: percent },
   { key: "return30d", header: "30D %", align: "right", format: percent },
   { key: "return1y", header: "1Y %", align: "right", format: percent },
-  { key: "volume24h", header: "Vol 24h", align: "right", format: compact },
-  { key: "marketCap", header: "Market cap", align: "right", format: compact },
+  { key: "volume24h", header: "Vol 24h", textHeader: "Vol 24h USD", align: "right", format: compact },
+  { key: "marketCap", header: "Market cap", textHeader: "Market cap USD", align: "right", format: compact },
 ];
 
 /**

package/src/plugins/builtin/crypto-board/index.tsx

@@ -1,8 +1,8 @@
 import type { PluginModule } from "../plugin-module";
 import { LIVE_STREAMING_QUICK_SETTING, withLiveStreamingSetting } from "../../../state/hooks/live-streaming";
 import { cryptoMarketsCache, DEFI_TVL_CACHES, STABLECOIN_SUPPLY_CACHES } from "./client";
+import { BITCOIN_NETWORK_CACHES } from "./bitcoin-network";
 import { cryptoBoardHeadless } from "./headless";
-import { CryptoBoardPane } from "./pane";
 import { CRYPTO_SERIES } from "./series";
 
 export const cryptoBoardModule: PluginModule = {
@@ -12,7 +12,7 @@ export const cryptoBoardModule: PluginModule = {
       id: "crypto-board",
       name: "Crypto",
       icon: "C",
-      component: CryptoBoardPane,
+      get component(): typeof import("./pane").CryptoBoardPane { const { CryptoBoardPane } = require("./pane"); return CryptoBoardPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 120, height: 32 },
@@ -40,10 +40,12 @@ export const cryptoBoardModule: PluginModule = {
     cryptoMarketsCache.attach(ctx.persistence);
     for (const cache of STABLECOIN_SUPPLY_CACHES) cache.attach(ctx.persistence);
     for (const cache of DEFI_TVL_CACHES) cache.attach(ctx.persistence);
+    for (const cache of BITCOIN_NETWORK_CACHES) cache.attach(ctx.persistence);
   },
   dispose() {
     cryptoMarketsCache.reset();
     for (const cache of STABLECOIN_SUPPLY_CACHES) cache.reset();
     for (const cache of DEFI_TVL_CACHES) cache.reset();
+    for (const cache of BITCOIN_NETWORK_CACHES) cache.reset();
   },
 };

package/src/plugins/builtin/crypto-board/series.ts

@@ -1,6 +1,7 @@
 import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
-import { cachedSeriesWarning } from "../shared/series-warning";
+import { cachedSeriesNote } from "../shared/series-warning";
 import { loadDefiTvl, loadStablecoinSupply, loadStablecoinSupplyHistory } from "./client";
+import { BITCOIN_NETWORK_SERIES } from "./bitcoin-network";
 
 const DAY_MS = 86_400_000;
 
@@ -29,7 +30,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupply();
       const history = resource.payload.history;
       if (!history) throw new Error("Stablecoin supply is not available yet.");
-      return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
     },
   },
   {
@@ -45,7 +46,7 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
       const resource = await loadStablecoinSupplyHistory(stablecoinSymbol(ticker!));
       const history = resource.payload.history;
       if (!history) throw new Error(`${resource.payload.symbol} supply history is not available yet.`);
-      return { points: dailyPoints(history.start, history.values), warning: cachedSeriesWarning(resource) };
+      return { points: dailyPoints(history.start, history.values), ...cachedSeriesNote(resource) };
     },
   },
 ];
@@ -63,7 +64,7 @@ const DEFI_TVL_SERIES: SeriesDefinition = {
     const resource = await loadDefiTvl();
     const history = resource.payload.history;
     if (!history) throw new Error("DeFi TVL is not available yet.");
-    return { points: dailyPoints(history.start, history.total), warning: cachedSeriesWarning(resource) };
+    return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
   },
 };
 
@@ -114,4 +115,5 @@ export const CRYPTO_SERIES: readonly SeriesDefinition[] = [
   },
   ...STABLECOIN_SUPPLY_SERIES,
   DEFI_TVL_SERIES,
+  ...BITCOIN_NETWORK_SERIES,
 ];

package/src/plugins/builtin/crypto-etf-flows/client.ts

@@ -18,7 +18,9 @@ const textOrNull = (value: unknown) => value === null || text(value);
 /**
  * The flows as served, or an error: the asset asked for, its funds once each,
  * every day newest first with a figure or none for each fund, and where they
- * are from. A payload that breaks any of it is not drawn.
+ * are from. A payload that breaks any of it is not drawn. A day's price move
+ * that is not a number or null is dropped from that day alone: the flows
+ * stand without it.
  */
 export function validateCryptoEtfFlows(payload: CryptoEtfFlowsPayload, asset: CryptoEtfFlowAsset): CryptoEtfFlowsPayload {
   const invalid = (): never => { throw new Error("The server returned invalid crypto ETF flows"); };
@@ -35,7 +37,12 @@ export function validateCryptoEtfFlows(payload: CryptoEtfFlowsPayload, asset: Cr
       || !Array.isArray(day.pending) || day.pending.some((ticker) => !known.has(ticker))) return invalid();
   }
   if (payload.days[0] && payload.days[0].date !== payload.asOf) return invalid();
-  return payload;
+  if (payload.days.every((day) => day.priceChangePct === undefined || flow(day.priceChangePct))) return payload;
+  return { ...payload, days: payload.days.map((day) => {
+    if (day.priceChangePct === undefined || flow(day.priceChangePct)) return day;
+    const { priceChangePct: _dropped, ...rest } = day;
+    return rest;
+  }) };
 }
 
 export async function fetchCryptoEtfFlows(

package/src/plugins/builtin/crypto-etf-flows/headless.ts

@@ -2,6 +2,7 @@ import type { CryptoEtfFlowsPayload } from "../../../api-client/crypto-etf-flows
 import type { HeadlessPaneColumn } from "../../../types/headless";
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { REPORT_ROWS } from "../shared/headless-options";
+import { readPriceWindow, type PriceWindow } from "../../../utils/price-window";
 import { fetchCryptoEtfFlows } from "./client";
 import {
   cryptoEtfFlowAsset,
@@ -9,16 +10,22 @@ import {
   cryptoEtfFlowSummary,
   formatFlow,
   formatFlowAmount,
+  formatPriceChange,
+  hasFundPriceChanges,
   pendingText,
 } from "./model";
 
 const flowCell = (value: unknown) => formatFlow(typeof value === "number" ? value : null);
+const optionText = (value: unknown) => typeof value === "string" && value.trim() ? value : undefined;
 
-/** Date, the day's total and each fund, in US$ millions as published. */
+/** Date, the day's total, the funds' price move when served, and each fund, in US$ millions as published. */
 function flowColumns(payload: CryptoEtfFlowsPayload): HeadlessPaneColumn[] {
   return [
     { key: "date", header: "Date", shrink: false },
     { key: "total", header: "Total", align: "right", format: flowCell },
+    ...hasFundPriceChanges(payload)
+      ? [{ key: "priceChangePct", header: "Price %", literalHeader: true, align: "right" as const, format: (value: unknown) => formatPriceChange(typeof value === "number" ? value : null) }]
+      : [],
     // A fund the day still waits on reads "pending", as in the pane; none at all is a dash.
     ...payload.funds.map((fund): HeadlessPaneColumn => ({
       key: fund.ticker, header: fund.ticker, literalHeader: true, align: "right",
@@ -28,6 +35,13 @@ function flowColumns(payload: CryptoEtfFlowsPayload): HeadlessPaneColumn[] {
   ];
 }
 
+/** "Net flows of the US spot bitcoin ETFs in US$ millions. 2026-10-19 to 2026-10-23: +$301.20M over 5 trading days." */
+function windowSummaryLine(payload: CryptoEtfFlowsPayload, window: PriceWindow, days: CryptoEtfFlowsPayload["days"]): string {
+  const total = days.some((day) => day.total != null) ? days.reduce((sum, day) => sum + (day.total ?? 0), 0) : null;
+  return `Net flows of the US spot ${cryptoEtfFlowAssetLabel(payload.asset).toLowerCase()} ETFs in US$ millions. ${window.from} to ${window.to}: `
+    + `${formatFlowAmount(total)} over ${days.length} trading ${days.length === 1 ? "day" : "days"}.`;
+}
+
 /** "Net flows of the US spot bitcoin ETFs in US$ millions. 2026-10-20: -$6.70M (IBIT pending); 5 days ..., since 2024-01-11 +$57.47B." */
 function summaryLine(payload: CryptoEtfFlowsPayload): string {
   const summary = cryptoEtfFlowSummary(payload);
@@ -43,6 +57,15 @@ function summaryLine(payload: CryptoEtfFlowsPayload): string {
   ].join(" ");
 }
 
+/**
+ * "Funds: IBIT iShares Bitcoin Trust ETF, ..., BTC Grayscale Bitcoin Mini Trust ETF.": a column is headed by
+ * the fund's ticker, and BTC or ETH there is Grayscale's mini fund, not the coin. Null when no fund is named.
+ */
+function fundsLine(payload: CryptoEtfFlowsPayload): string | null {
+  const named = payload.funds.flatMap((fund) => fund.name ? [`${fund.ticker} ${fund.name}`] : []);
+  return named.length ? `Funds: ${named.join(", ")}.` : null;
+}
+
 export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
   shape: "rows",
   argument: { kind: "none" },
@@ -69,6 +92,22 @@ export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
       minimum: 1,
       maximum: 2000,
     },
+    {
+      key: "from",
+      type: "string",
+      placeholder: "year|date",
+      description: "First US trading day listed, as a year (2024) or a date (2026-10-19); lists every day of the window in place of --limit.",
+      example: "--from 2026-10-19 --to 2026-10-23",
+      shot: { reportOnly: "lists the report's days for those dates" },
+      replaces: ["limit"],
+    },
+    {
+      key: "to",
+      type: "string",
+      placeholder: "year|date",
+      description: "Last US trading day listed, with --from (default the newest).",
+      shot: { reportOnly: "lists the report's days for those dates" },
+    },
   ],
   columns: [
     { key: "date", header: "Date" },
@@ -81,24 +120,36 @@ export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
     limitations: [
       "US spot bitcoin and ether ETFs only, net creations and redemptions in US$ millions as Farside Investors publishes them.",
       "The newest day fills in fund by fund; a fund that has not reported shows as pending.",
+      "0.0 is the publisher's zero for the fund that day; a dash is a day it published no figure for.",
+      "Price % is the funds' price move that day: the median of their close-to-close changes.",
     ],
   },
-  freshness: { source: "Farside Investors", publisher: "Farside Investors", status: "not-a-feed", basis: "daily fund flows", cadence: "daily", tradingDayMarket: "US" },
+  // Stale once a trading day's flows are missing (the load's `cadence`), except in a window that ended before the newest day.
+  freshness: { source: "Farside Investors", publisher: "Farside Investors", status: "not-a-feed", basis: "daily fund flows", tradingDayMarket: "US" },
   async load(args, ctx) {
     const asset = cryptoEtfFlowAsset(args.options.asset);
+    // --from 2026-10-19 --to 2026-10-23 lists those days, every one of them, in place of the newest --limit.
+    const window = readPriceWindow(optionText(args.options.from), optionText(args.options.to));
     const payload = await fetchCryptoEtfFlows(asset, ctx.apiClient);
     const limit = Math.max(1, Number(args.options.limit) || 20);
-    const rows = payload.days.slice(0, limit).map((day) => ({
+    const days = window ? payload.days.filter((day) => day.date >= window.from && day.date <= window.to) : payload.days.slice(0, limit);
+    const priced = hasFundPriceChanges(payload);
+    const rows = days.map((day) => ({
       date: day.date,
       total: day.total,
+      ...(priced ? { priceChangePct: day.priceChangePct ?? null } : {}),
       ...Object.fromEntries(payload.funds.map((fund) => [fund.ticker, day.flows[fund.ticker] ?? null])),
       pending: day.pending,
     }));
     const summary = cryptoEtfFlowSummary(payload);
+    const funds = fundsLine(payload);
+    // A window that ends before the newest day is dated by its own last day.
+    const asOf = window ? days[0]?.date ?? null : payload.asOf;
     return {
       rows,
       columns: flowColumns(payload),
-      notes: [summaryLine(payload), `Source: ${payload.source.publisher}, ${payload.source.url}`],
+      ...(window && !days.length ? { errors: [`No US trading day with flows from ${window.from} to ${window.to}.`] } : {}),
+      notes: [window ? windowSummaryLine(payload, window, days) : summaryLine(payload), ...funds ? [funds] : [], `Source: ${payload.source.publisher}, ${payload.source.url}`],
       complete: !payload.stale,
       ...(payload.stale ? { warnings: [`The flows were last read ${payload.fetchedAt.slice(0, 10)}; newer days may be missing.`] } : {}),
       freshness: {
@@ -106,10 +157,12 @@ export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
         publisher: payload.source.publisher,
         status: "not-a-feed",
         basis: "daily fund flows",
-        cadence: "daily",
+        ...(window && asOf !== payload.asOf ? {} : { cadence: "daily" as const }),
         tradingDayMarket: "US",
-        asOf: payload.asOf,
+        ...(asOf ? { asOf } : {}),
         oldest: null,
+        // When the server last read the publisher's table, which is what this report retrieved.
+        retrievedAt: payload.fetchedAt,
       },
       metadata: {
         asset,
@@ -117,6 +170,8 @@ export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
         asOf: payload.asOf,
         fetchedAt: payload.fetchedAt,
         stale: payload.stale,
+        ...(window ? { requestedWindow: window } : {}),
+        ...(priced ? { priceChangeBasis: "median of the funds' close-to-close price changes, percent" } : {}),
         source: payload.source,
         funds: payload.funds,
         summary: {

package/src/plugins/builtin/crypto-etf-flows/index.tsx

@@ -2,7 +2,6 @@ import type { PluginModule } from "../plugin-module";
 import { cryptoEtfFlowsCache } from "./client";
 import { cryptoEtfFlowsHeadless } from "./headless";
 import { CRYPTO_ETF_FLOWS_PANE_ID } from "./model";
-import { CryptoEtfFlowsPane } from "./pane";
 
 /** ETFF: the daily net flows of the US spot bitcoin and ether ETFs, per fund. */
 export const cryptoEtfFlowsModule: PluginModule = {
@@ -11,7 +10,7 @@ export const cryptoEtfFlowsModule: PluginModule = {
       id: CRYPTO_ETF_FLOWS_PANE_ID,
       name: "Crypto ETF Flows",
       icon: "F",
-      component: CryptoEtfFlowsPane,
+      get component(): typeof import("./pane").CryptoEtfFlowsPane { const { CryptoEtfFlowsPane } = require("./pane"); return CryptoEtfFlowsPane; },
       defaultPosition: "right",
       defaultMode: "floating",
       defaultFloatingSize: { width: 120, height: 32 },

package/src/plugins/builtin/crypto-etf-flows/model.ts

@@ -103,11 +103,24 @@ export function pendingText(day: CryptoEtfFlowDay | null | undefined): string |
 
 export type CryptoEtfFlowColumn = Omit<DataTableColumn, "id"> & { id: string };
 
-/** Date and the day's total, then each fund in the publisher's order. */
+/** Whether the server sent the funds' daily price move beside the flows. */
+export const hasFundPriceChanges = (payload: CryptoEtfFlowsPayload | null | undefined) =>
+  !!payload?.days.some((day) => day.priceChangePct !== undefined);
+
+/** A day's price move as the table shows it: `+2.15%`, `-0.40%`, `—` for none. */
+export function formatPriceChange(value: number | null | undefined): string {
+  if (value == null || !Number.isFinite(value)) return "—";
+  return `${value > 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+
+/** Date, the day's total and the funds' price move that day, then each fund in the publisher's order. */
 export function cryptoEtfFlowColumns(payload: CryptoEtfFlowsPayload | null | undefined): CryptoEtfFlowColumn[] {
   return [
     { id: "date", label: "Date", width: 12, align: "left" },
     { id: "total", label: "Total", width: 9, align: "right", title: "The day's net flow across the funds, US$ millions" },
+    ...hasFundPriceChanges(payload)
+      ? [{ id: "price", label: "Price %", width: 9, align: "right" as const, title: "The funds' price move that day: the median of their close-to-close changes" }]
+      : [],
     ...(payload?.funds ?? []).map((fund): CryptoEtfFlowColumn => ({
       id: `fund:${fund.ticker}`,
       label: fund.ticker,

package/src/plugins/builtin/crypto-etf-flows/pane.tsx

@@ -12,6 +12,7 @@ import {
   type DataTableCell,
   type StatItem,
 } from "../../../components";
+import { ageFooterSegment } from "../../../components/layout/pane/footer";
 import { formatCompactAxis } from "../../../components/chart-table";
 import { useChartViewReset } from "../../../components/chart/core/view-reset";
 import { scalarPoint, staticSeries } from "../../../components/chart/static/series";
@@ -36,6 +37,7 @@ import {
   flowColor,
   formatFlow,
   formatFlowAmount,
+  formatPriceChange,
   fundTickerOfColumn,
   pendingText,
   type CryptoEtfFlowColumn,
@@ -76,13 +78,15 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
   }, [asset, setSelectedByAsset]);
 
   const label = cryptoEtfFlowAssetLabel(asset);
-  // The running total since the first fund launched, drawn over the range the table lists.
+  // The running total since the first fund launched, drawn over the range the table lists. Its legend is the one
+  // place the total and the day it starts from are said; the figures above carry only the table's windows.
   const series = useMemo(() => {
     if (!data) return [];
     const first = days.at(-1)?.date ?? "";
     const points = cumulativeFlows(data).filter((point) => point.date >= first)
       .map((point) => scalarPoint(new Date(`${point.date}T00:00:00Z`), point.value * 1_000_000));
-    return [staticSeries(points, { id: `etf-flows:${asset}`, label: `${label} ETF net flows since launch`, color: colors.positive, calendarSpaced: true })];
+    const launch = data.days.at(-1)?.date;
+    return [staticSeries(points, { id: `etf-flows:${asset}`, label: `${label} ETF net flows since ${launch ?? "launch"}`, color: colors.positive, calendarSpaced: true })];
   }, [asset, data, days, label]);
   const link = useChartTableSelection({ rows: days, getId: rowId, getDate: rowDate, selectedId, onSelect: selectDay, focused });
 
@@ -93,14 +97,12 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
       detail: [latest?.date, pending].filter(Boolean).join(" · ") || undefined },
     { id: "week", label: "5 days", value: formatFlowAmount(summary.week), color: flowColor(summary.week, colors) },
     { id: "month", label: "20 days", value: formatFlowAmount(summary.month), color: flowColor(summary.month, colors) },
-    { id: "launch", label: "Since launch", value: formatFlowAmount(summary.sinceLaunch), color: flowColor(summary.sinceLaunch, colors),
-      detail: summary.firstDate ? `since ${summary.firstDate}` : undefined },
   ] : [];
 
   const updatedAgo = useUpdatedAgo(resource.updatedAt);
   const footerInfo = useMemo(() => data ? [
     { id: "as-of", parts: [{ text: `as of ${data.asOf}`, tone: "muted" as const }] },
-    ...(updatedAgo ? [{ id: "updated", parts: [{ text: updatedAgo, tone: "muted" as const }] }] : []),
+    ...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
   ] : [], [data, updatedAgo]);
   useAutoRefresh(resource.updatedAt, resource.load);
   const refresh = useCallback(() => void resource.reload(), [resource.reload]);
@@ -135,6 +137,7 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
   const renderCell = useCallback((day: CryptoEtfFlowDay, column: CryptoEtfFlowColumn): DataTableCell => {
     if (column.id === "date") return { text: day.date, value: day.date, color: colors.text };
     if (column.id === "total") return { text: formatFlow(day.total), value: day.total, color: flowColor(day.total, colors) };
+    if (column.id === "price") return { text: formatPriceChange(day.priceChangePct), value: day.priceChangePct ?? null, color: flowColor(day.priceChangePct, colors) };
     const ticker = fundTickerOfColumn(column.id) ?? "";
     const value = day.flows[ticker] ?? null;
     // A fund that reported the day before and not yet today: its figure is to come, not none.

package/src/plugins/builtin/debt-maturities/headless.ts

@@ -1,6 +1,6 @@
 import type { HeadlessPaneDefinition } from "../../../types/plugin";
 import { fetchDebtMaturities } from "./client";
-import { bucketShare, debtAmount, debtNewestAsOf, debtNotices, debtPercent, newerQuarter } from "./model";
+import { bucketShare, debtAmount, debtNewestAsOf, debtNewestForm, debtNotices, debtPercent, newerQuarter } from "./model";
 import { SEC_FILINGS } from "../shared/report-freshness";
 import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
 
@@ -118,8 +118,9 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
         },
       ],
       metadata: { ...data },
-      // The latest filing dates the report (a newer 10-Q's balance date); the history rows are past years, not stale data.
-      freshness: { asOf: debtNewestAsOf(data) },
+      // The latest filing dates the report (a newer 10-Q's balance date), named by its form so the date is
+      // not read as the schedule's; the history rows are past years, not stale data.
+      freshness: { asOf: debtNewestAsOf(data), asOfLabel: debtNewestForm(data) ?? undefined },
     };
   },
 };

package/src/plugins/builtin/debt-maturities/model.ts

@@ -219,9 +219,25 @@ export function newerQuarter(data: DebtMaturitiesPayload): DebtQuarter | null {
   const quarter = data.latestQuarter ?? null;
   return quarter && data.latest && quarter.asOf > data.latest.asOf ? quarter : null;
 }
+/** The newest filing the payload reports: the 10-Q when it is newer, else the annual schedule's. */
+function newestDebtFiling(data: DebtMaturitiesPayload): Pick<DebtQuarter, "form" | "asOf" | "filed"> | null {
+  return newerQuarter(data) ?? data.latest ?? null;
+}
 /** The newest balance date the payload reports: the 10-Q's when it is newer, else the schedule's. */
 export function debtNewestAsOf(data: DebtMaturitiesPayload): string | null {
-  return newerQuarter(data)?.asOf ?? data.latest?.asOf ?? null;
+  return newestDebtFiling(data)?.asOf ?? null;
+}
+/** The form of the filing `debtNewestAsOf` dates, which names that date: `10-Q`, `10-K`. */
+export function debtNewestForm(data: DebtMaturitiesPayload): string | null {
+  return newestDebtFiling(data)?.form ?? null;
+}
+/**
+ * Which filing the pane's date is, as its footer says it, longest first:
+ * `10-Q 2026-09-30, filed 2026-10-27`, then `10-Q 2026-09-30`.
+ */
+export function debtNewestFilingText(data: DebtMaturitiesPayload): string[] {
+  const filing = newestDebtFiling(data);
+  return filing ? [`${filing.form} ${filing.asOf}, filed ${filing.filed}`, `${filing.form} ${filing.asOf}`] : [];
 }
 /** The 10-Q's debt in one line, `Current 212.00M · Non-current 6.84B USD`. */
 export function quarterDebtText(quarter: DebtQuarter): string {

package/src/plugins/builtin/debt-maturities/pane.tsx

@@ -24,6 +24,7 @@ import {
   type DataTableCell,
   type StatItem,
 } from "../../../components";
+import { ageFooterSegment } from "../../../components/layout/pane/footer";
 import { colors } from "../../../theme/colors";
 import type {
   DebtFact,
@@ -53,6 +54,7 @@ import {
   debtFilingUrl,
   debtMetricCaption,
   debtMetricValue,
+  debtNewestFilingText,
   debtNotices,
   debtPercent,
   historyAxis,
@@ -431,10 +433,13 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
       metric("next12", "Due next 12 months", latest.next12MonthsShare),
       metric("next3", "Due next 3 years", latest.next3YearsShare),
       { id: "as-of", label: "As of", value: latest.asOf },
-      // A 10-Q filed since: its own row, dated, so it never reads as the schedule's.
+      // A 10-Q filed since: its own row, named by its period, so it never reads
+      // as the schedule's. The filed date goes beside the figures where it fits
+      // and gives way to them where it does not: the footer says it
+      // ("10-Q 2026-09-30, filed 2026-10-27").
       ...(quarter ? [{
-        id: "latest-10q", label: "Latest 10-Q", value: quarterDebtText(quarter),
-        detail: `${quarter.asOf} · filed ${quarter.filed}`, wide: true,
+        id: "latest-10q", label: `10-Q ${quarter.asOf}`, value: quarterDebtText(quarter),
+        detail: `filed ${quarter.filed}`, detailVariants: [""], wide: true,
       }] : []),
     ];
   }, [latest, quarter]);
@@ -445,6 +450,15 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
       label: "Principal total", values, value: debtAmount(last), color: colors.warning,
     };
   }, [bars]);
+  // Which filing the pane's date is, then how long ago it loaded: the age goes first in a narrow footer.
+  const filingFooter = useMemo(() => {
+    const [filing, ...shorter] = data ? debtNewestFilingText(data) : [];
+    return [
+      ...(filing ? [{ id: "filing", asOf: true, parts: [{ text: filing, tone: "muted" as const }],
+        variants: shorter.map((text) => [{ text, tone: "muted" as const }]) }] : []),
+      ...(data && updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
+    ];
+  }, [data, updatedAgo]);
   useAutoRefresh(resource.updatedAt, resource.load);
   usePaneRefreshKey(() => void resource.reload(), { focused });
   usePaneNoticeFooter({
@@ -465,7 +479,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
         ? debtFilingUrl(data.cik, selectedHistoryRow.accession)
         : (latest?.filingUrl ?? data?.source.url ?? null),
     showOpenHint: true,
-    info: data && updatedAgo ? [{ id: "updated", parts: [{ text: updatedAgo, tone: "muted" as const }] }] : [],
+    info: filingFooter,
     stale: !!data && resource.data?.stale,
   });
   const renderBucket = (