gloomberb 0.17.2 → 0.17.3

package/src/components/markdown-text.tsx

@@ -7,6 +7,7 @@ import type { InlineTickerCatalogEntry } from "../state/hooks/inline-tickers";
 import { colors } from "../theme/colors";
 import { displayWidth } from "../utils/format";
 import { useUiCapabilities } from "../ui";
+import { MARKDOWN_HEADING_RE, markdownListItem, parseInlineMarkdown, type MarkdownSegment } from "../utils/markdown";
 
 export interface MarkdownTextProps {
   text: string;
@@ -30,15 +31,9 @@ export interface MarkdownTextProps {
   onOpenLink?: (href: string) => void;
 }
 
-interface StyledSegment {
-  text: string;
-  bold?: boolean;
-  italic?: boolean;
-  dim?: boolean;
-  code?: boolean;
+/** A segment as drawn here: a heading or a table header has its own colour. */
+interface StyledSegment extends MarkdownSegment {
   color?: string;
-  /** Where the segment links to, when links are read. */
-  link?: string;
 }
 
 interface ParsedLine {
@@ -47,52 +42,12 @@ interface ParsedLine {
   indent?: number;
 }
 
-// A backslash escapes the punctuation markdown would read ("\\*" is a star), and
-// an italic span may hold a bold one ("*covers **96%** of value*").
-const INLINE_RE =
-  /(\\(?<escaped>[\\`*_~#>[\]()-])|\[(?<linkLabel>[^\]]+)\]\((?<linkHref>[^)\s]+)\)|\*\*(?<bold>[^*]+)\*\*|(?<!\*)\*(?!\*)(?<italic>(?:[^*]|\*\*[^*]+\*\*)+?)\*(?!\*)|`(?<code>[^`]+)`|~~(?<strike>[^~]+)~~)/g;
-
-function parseInlineMarkdown(text: string, links = false): StyledSegment[] {
-  const segments: StyledSegment[] = [];
-  let cursor = 0;
-
-  const pattern = new RegExp(INLINE_RE.source, "g");
-  let match: RegExpExecArray | null;
-  while ((match = pattern.exec(text)) !== null) {
-    if (match.groups?.linkHref != null && !links) {
-      // Not reading links: the bracket is text, and what is inside it still styles.
-      pattern.lastIndex = match.index + 1;
-      continue;
-    }
-    if (match.index > cursor) {
-      segments.push({ text: text.slice(cursor, match.index) });
-    }
-    if (match.groups?.escaped != null) {
-      segments.push({ text: match.groups.escaped });
-    } else if (match.groups?.linkHref != null) {
-      for (const inner of parseInlineMarkdown(match.groups.linkLabel ?? "", false)) segments.push({ ...inner, link: match.groups.linkHref });
-    } else if (match.groups?.bold != null) {
-      segments.push({ text: match.groups.bold, bold: true });
-    } else if (match.groups?.italic != null) {
-      for (const inner of parseInlineMarkdown(match.groups.italic, links)) segments.push({ ...inner, italic: true });
-    } else if (match.groups?.code != null) {
-      segments.push({ text: match.groups.code, code: true });
-    } else if (match.groups?.strike != null) {
-      segments.push({ text: match.groups.strike, dim: true });
-    }
-    cursor = match.index + match[0].length;
-  }
-  if (cursor < text.length) {
-    segments.push({ text: text.slice(cursor) });
-  }
-  return segments;
+function parseInline(text: string, links = false): StyledSegment[] {
+  return parseInlineMarkdown(text, { links });
 }
 
-const HEADING_RE = /^(#{1,3})\s+(.+)$/;
-
 function parseLine(line: string, links: boolean): ParsedLine {
-  // Headings
-  const headingMatch = line.match(HEADING_RE);
+  const headingMatch = line.match(MARKDOWN_HEADING_RE);
   if (headingMatch) {
     return {
       heading: true,
@@ -100,22 +55,18 @@ function parseLine(line: string, links: boolean): ParsedLine {
     };
   }
 
-  // List items
-  const listMatch = line.match(/^(\s*)([-*]|\d+\.)\s(.*)$/);
-  if (listMatch) {
-    const indent = listMatch[1]!.length;
-    const marker = listMatch[2]!;
-    const content = listMatch[3]!;
+  const item = markdownListItem(line);
+  if (item) {
     return {
-      indent,
+      indent: item.indent,
       segments: [
-        { text: `${marker} `, bold: true, color: colors.borderFocused },
-        ...parseInlineMarkdown(content, links),
+        { text: `${item.marker} `, bold: true, color: colors.borderFocused },
+        ...parseInline(item.text, links),
       ],
     };
   }
 
-  return { segments: parseInlineMarkdown(line, links) };
+  return { segments: parseInline(line, links) };
 }
 
 type TableAlign = "left" | "center" | "right";
@@ -176,7 +127,7 @@ function columnAlign(table: MarkdownTable, column: number): TableAlign {
   const explicit = table.align[column];
   if (explicit) return explicit;
   const values = table.rows
-    .map((row) => parseInlineMarkdown(row[column] ?? "").map((segment) => segment.text).join("").trim())
+    .map((row) => parseInline(row[column] ?? "").map((segment) => segment.text).join("").trim())
     .filter((value) => value !== "" && value !== "-" && value !== "\u2014");
   return values.length > 0 && values.every((value) => NUMERIC_CELL_RE.test(value)) ? "right" : "left";
 }
@@ -214,6 +165,28 @@ function parseMarkdownBlocks(text: string): MarkdownBlock[] {
   return blocks;
 }
 
+/**
+ * The links a text reads as, in reading order, for a reader's pane menu: the
+ * terminal cannot press part of a line.
+ */
+export function markdownLinks(text: string): Array<{ label: string; href: string }> {
+  const links: Array<{ label: string; href: string }> = [];
+  // A label with bold in it is several segments of one link.
+  const read = (segments: StyledSegment[]) => {
+    let previous: string | undefined;
+    for (const { text: part, link } of segments) {
+      if (link && link === previous) links[links.length - 1]!.label += part;
+      else if (link) links.push({ label: part, href: link });
+      previous = link;
+    }
+  };
+  for (const block of parseMarkdownBlocks(text)) {
+    if (block.kind === "line") read(parseLine(block.text, true).segments);
+    else for (const cell of [block.table.header, ...block.table.rows].flat()) read(parseInline(cell, true));
+  }
+  return links;
+}
+
 function segmentsWidth(segments: StyledSegment[]): number {
   return segments.reduce((total, segment) => total + displayWidth(segment.text), 0);
 }
@@ -374,7 +347,7 @@ function layoutTableRows(
 }
 
 function headerCell(text: string, links: boolean): StyledSegment[] {
-  return parseInlineMarkdown(text, links).map((segment) => ({ ...segment, bold: true, color: colors.textDim }));
+  return parseInline(text, links).map((segment) => ({ ...segment, bold: true, color: colors.textDim }));
 }
 
 /**
@@ -384,7 +357,7 @@ function headerCell(text: string, links: boolean): StyledSegment[] {
  */
 function layoutMarkdownTable(table: MarkdownTable, lineWidth?: number, links = false): TableLine[] {
   const header = table.header.map((cell) => headerCell(cell, links));
-  const body = table.rows.map((row) => row.map((cell) => parseInlineMarkdown(cell, links)));
+  const body = table.rows.map((row) => row.map((cell) => parseInline(cell, links)));
   const align = table.header.map((_, column) => columnAlign(table, column));
   const widths = tableColumnWidths([header, ...body], lineWidth);
   if (widths) return layoutTableRows([header, ...body], widths, align);
@@ -460,7 +433,8 @@ function SegmentSpan({ segment, wrap = false, onOpenLink }: {
   const attrs =
     (segment.bold ? TextAttributes.BOLD : 0) |
     (segment.italic ? TextAttributes.ITALIC : 0) |
-    (segment.dim ? TextAttributes.DIM : 0) |
+    // Struck text reads dim here.
+    (segment.strike ? TextAttributes.DIM : 0) |
     (segment.link ? TextAttributes.UNDERLINE : 0);
   const href = segment.link;
   // The terminal cannot press part of a line; there the pane menu lists links.
@@ -627,7 +601,7 @@ export function MarkdownText({
         if (line.trim() === "") {
           // Under a heading set in its own style, the heading's margin is the space: it sits with what it names.
           const previous = blocks[index - 1];
-          if (nativePaneChrome && headingStyle && previous?.kind === "line" && HEADING_RE.test(previous.text)) return null;
+          if (nativePaneChrome && headingStyle && previous?.kind === "line" && MARKDOWN_HEADING_RE.test(previous.text)) return null;
           return nativePaneChrome && paragraphGap
             ? <Box key={index} flexShrink={0} style={{ height: paragraphGap }} />
             : <Text key={index}>{" "}</Text>;

package/src/components/market-board/index.tsx

@@ -84,13 +84,15 @@ export interface MarketBoardStackProps<T extends MarketBoardRow> {
 const FIT_STEPS = ["labelDetail", "history", "shortAsOf", "changeAsOf", "percentile"] as const;
 /** An as-of date without its year ("09-17"). */
 const SHORT_AS_OF_WIDTH = 5;
+/** The word a stale row's date carries, with its space: "2026-09-17 stale". */
+const STALE_WORD = " stale";
 
 function shortIsoDate(text: string): string {
   return /^\d{4}-\d{2}-\d{2}$/.test(text) ? text.slice(5) : text;
 }
 
 /** Fit the board to the pane rather than cut its right edge mid-value. */
-function fitBoardColumns(candidates: DataTableColumn[], width: number): { columns: DataTableColumn[]; shortAsOf: boolean } {
+function fitBoardColumns(candidates: DataTableColumn[], width: number, wordWidth: number): { columns: DataTableColumn[]; shortAsOf: boolean } {
   const withAsOfWidth = (list: DataTableColumn[], asOfWidth: number | null) => asOfWidth === null
     ? list
     : list.map((column) => column.id === "asOf" ? { ...column, width: asOfWidth } : column);
@@ -100,7 +102,7 @@ function fitBoardColumns(candidates: DataTableColumn[], width: number): { column
     if (getTableWidth(columns) <= width) break;
     if (step === "shortAsOf") {
       shortAsOf = true;
-      columns = withAsOfWidth(columns, SHORT_AS_OF_WIDTH);
+      columns = withAsOfWidth(columns, SHORT_AS_OF_WIDTH + wordWidth);
     } else {
       columns = columns.filter((column) => column.id !== step);
     }
@@ -134,6 +136,8 @@ export function MarketBoardStack<T extends MarketBoardRow>({ rows, width, height
     return compareSortValues(left, right, sort.direction);
   }) : rows, [rows, sort, extraColumns]);
   const open = rows.find((row) => row.id === openId);
+  // A stale row's date carries a word, so the column has room for both and the date is never cut.
+  const wordWidth = rows.some((row) => row.status === "stale") ? STALE_WORD.length : 0;
   const { columns, shortAsOf } = fitBoardColumns([
     { id: "label", label: labelHeader, width: labelWidth, align: "left" },
     ...(rows.some((row) => row.labelDetail !== undefined)
@@ -144,8 +148,8 @@ export function MarketBoardStack<T extends MarketBoardRow>({ rows, width, height
     ...(extraColumns?.map((item) => item.column) ?? []),
     { id: "percentile", label: percentileLabel, width: 8, align: "right" },
     { id: "history", label: "1Y", width: 14, align: "left" },
-    { id: "asOf", label: "AS OF", width: asOfWidth, align: "left" },
-  ], width);
+    { id: "asOf", label: "AS OF", width: asOfWidth + wordWidth, align: "left" },
+  ], width, wordWidth);
   const renderCell = (row: T, column: DataTableColumn): DataTableCell => {
     const extra = extraColumns?.find((item) => item.column.id === column.id);
     if (extra) return extra.renderCell(row);
@@ -159,8 +163,10 @@ export function MarketBoardStack<T extends MarketBoardRow>({ rows, width, height
     if (column.id === "percentile") return { text: row.percentileText ?? row.percentile?.toFixed(0) ?? "--", color: row.percentile != null && (row.percentile <= 10 || row.percentile >= 90) ? colors.warning : colors.textMuted };
     if (column.id === "history") return { text: "", content: <PriceSparkline priceHistory={row.history} width={column.width} period="1Y" trend="neutral" /> };
     const asOf = row.asOfText ?? row.asOf ?? "--";
-    // A narrow board drops the year; the export keeps the full date.
-    return { text: shortAsOf ? shortIsoDate(asOf) : asOf, ...(row.asOf ? { value: row.asOf } : {}),
+    const asOfText = shortAsOf ? shortIsoDate(asOf) : asOf;
+    // A narrow board drops the year; the export keeps the full date. The word
+    // stays with the color, so a stale row is not color alone.
+    return { text: row.status === "stale" ? `${asOfText}${STALE_WORD}` : asOfText, ...(row.asOf ? { value: row.asOf } : {}),
       color: row.status === "stale" ? colors.warning : colors.textDim };
   };
   return <DataTableStackView columns={columns} items={items} getItemKey={(row) => row.id} renderCell={renderCell}

package/src/components/reader/detail-reader.tsx

@@ -1,10 +1,10 @@
-import { forwardRef, useMemo } from "react";
-import { t } from "../../i18n";
+import { forwardRef, useCallback, useMemo } from "react";
+import { t, tf } from "../../i18n";
 import { hoverBg } from "../../theme/colors";
 import { useThemeColors } from "../../theme/theme-context";
-import { Box, Text, useUiCapabilities, type ScrollBoxRenderable } from "../../ui";
+import { Box, Text, useRendererHost, useUiCapabilities, type ScrollBoxRenderable } from "../../ui";
 import { wrapTextLines } from "../../utils/text-wrap";
-import { MarkdownText } from "../markdown-text";
+import { MarkdownText, markdownLinks, type MarkdownTextProps } from "../markdown-text";
 import { DetailScrollBody } from "../ui/detail-scroll-body";
 import { KeyValueRow } from "../ui/display";
 import { ExternalLink, usePaneLinkMenuEntry } from "../ui/external-link";
@@ -121,7 +121,7 @@ function NativeDetail({ meta, facts, body, bodyFormat, note }: DetailContentProp
         ) : null}
         {bodyFormat === "markdown" && body ? (
           <Box flexDirection="column" width="100%" style={MARKDOWN_STYLE}>
-            <MarkdownText text={body} paragraphGap={PARAGRAPH_GAP} headingStyle={READER_HEADING_STYLE} />
+            <MarkdownBody text={body} paragraphGap={PARAGRAPH_GAP} headingStyle={READER_HEADING_STYLE} />
           </Box>
         ) : blocks.map((block, index) => (
           <Box key={index} flexDirection="column">
@@ -140,6 +140,28 @@ function NativeDetail({ meta, facts, body, bodyFormat, note }: DetailContentProp
   );
 }
 
+/**
+ * Markdown whose `[label](url)` links open outside the app, as the reader's
+ * other links do. The terminal cannot press part of a line, so the pane menu
+ * lists each link there (inside a `PaneLinkMenu`).
+ */
+function MarkdownBody({ text, ...style }: Pick<MarkdownTextProps, "text" | "lineWidth" | "paragraphGap" | "headingStyle">) {
+  const rendererHost = useRendererHost();
+  const links = useMemo(() => markdownLinks(text), [text]);
+  const open = useCallback((href: string) => { void rendererHost.openExternal(href); }, [rendererHost]);
+  return (
+    <>
+      <MarkdownText text={text} onOpenLink={open} {...style} />
+      {links.map((link, index) => <LinkMenuEntry key={index} {...link} onOpen={open} />)}
+    </>
+  );
+}
+
+function LinkMenuEntry({ label, href, onOpen }: { label: string; href: string; onOpen: (href: string) => void }) {
+  usePaneLinkMenuEntry(`link:${href}`, tf("Open {label}", { label }), () => onOpen(href));
+  return null;
+}
+
 function FactValue({ fact }: { fact: DetailFact }) {
   const colors = useThemeColors();
   const { link } = fact;
@@ -167,7 +189,7 @@ function TerminalDetail({ width, meta, facts, body, bodyFormat, note }: DetailCo
     return (
       <Box flexDirection="column" width={lineWidth}>
         {metaLines.map((line, index) => <Text key={index} fg={colors.textMuted}>{line}</Text>)}
-        <MarkdownText text={body ?? ""} lineWidth={lineWidth} />
+        <MarkdownBody text={body ?? ""} lineWidth={lineWidth} />
       </Box>
     );
   }

package/src/components/ticker/badge/index.tsx

@@ -68,6 +68,8 @@ export function TickerBadge({
         // badges; the desktop leaves a hairline of row above and below.
         justifyContent={nativePaneChrome ? "center" : undefined}
         style={nativePaneChrome ? NATIVE_CHIP_STYLE : undefined}
+        role="button"
+        aria-label={symbol}
         data-gloom-context-menu-surface="true"
         onMouseOver={() => {
           onHoverStart?.();

package/src/components/ui/display.tsx

@@ -226,7 +226,12 @@ export function Divider({ width, height, orientation = "horizontal" }: DividerPr
       flexShrink={0}
       border={vertical ? ["left"] : ["top"]}
       borderColor={colors.border}
-      style={{ border: 0, [vertical ? "borderLeft" : "borderTop"]: `1px solid ${colors.border}` }}
+      style={{
+        border: 0,
+        [vertical ? "borderLeft" : "borderTop"]: `1px solid ${colors.border}`,
+        // A vertical rule given no height runs the height of the row it stands in.
+        ...(vertical && height === undefined ? { height: "auto", alignSelf: "stretch" } : {}),
+      }}
       role="separator"
       data-gloom-ui="divider"
     />

package/src/components/ui/external-link.tsx

@@ -98,11 +98,18 @@ function handleOpen(
   onOpen(url);
 }
 
+/** Desktop and web: a link inside a line of text runs and wraps with the line, rather than standing as a box of its own. */
+const INLINE_LINK_STYLE = { display: "inline", whiteSpace: "pre-wrap", overflowWrap: "anywhere" } as const;
+
 export function ExternalLinkText(
-  { url, label, color, onOpen = openUrl }: {
+  { url, label, color, attributes = 0, inline = false, onOpen = openUrl }: {
     url: string;
     label?: string;
     color?: string;
+    /** Marks drawn with the underline, such as the bold of a bold link. */
+    attributes?: number;
+    /** Flows inside a line of text on the desktop and the web. */
+    inline?: boolean;
     onOpen?: (url: string) => void;
   },
 ) {
@@ -128,8 +135,9 @@ export function ExternalLinkText(
   return (
     <Text
       fg={color ?? colors.textBright}
-      attributes={TextAttributes.UNDERLINE}
+      attributes={TextAttributes.UNDERLINE | attributes}
       cursor="pointer"
+      style={inline ? INLINE_LINK_STYLE : undefined}
       role="link"
       tabIndex={0}
       wrapText

package/src/data/memory-resource-store.ts

@@ -45,7 +45,7 @@ export class MemoryResourceStore {
       this.delete(key);
       return null;
     }
-    if (options.touch !== false) {
+    if (options.touch !== false && (options.touchIntervalMs == null || Date.now() - record.lastAccessedAt >= options.touchIntervalMs)) {
       record.lastAccessedAt = Date.now();
     }
     record.stale = isStale(record);

package/src/data/resource-store.ts

@@ -63,6 +63,13 @@ export interface GetResourceOptions {
   schemaVersion?: number;
   allowExpired?: boolean;
   touch?: boolean;
+  /**
+   * A read refreshes a row's place in the eviction order, one write per row. A
+   * row read many times a second (a quote, a price history) asks for it at most
+   * once per this many ms, so it stays recent without a write on every read.
+   * `touch: false` never refreshes it, and a row read that way looks old.
+   */
+  touchIntervalMs?: number;
 }
 
 export interface ListResourceOptions extends GetResourceOptions {
@@ -141,6 +148,10 @@ export class ResourceStore {
     });
   }
 
+  private touchDue(record: { lastAccessedAt: number }, options: GetResourceOptions): boolean {
+    return options.touchIntervalMs == null || Date.now() - record.lastAccessedAt >= options.touchIntervalMs;
+  }
+
   private touch(key: ResourceCacheKey): number | null {
     const touchedAt = Date.now();
     const result = trySqliteBusyOperation("touch cached resource", () => {
@@ -283,7 +294,7 @@ export class ResourceStore {
       return null;
     }
 
-    if (options.touch !== false) {
+    if (options.touch !== false && this.touchDue(record, options)) {
       const touchedAt = this.touch(key);
       if (touchedAt != null) {
         record.lastAccessedAt = touchedAt;
@@ -340,6 +351,7 @@ export class ResourceStore {
     }
     if (options.touch !== false) {
       for (const record of records) {
+        if (!this.touchDue(record, options)) continue;
         const touchedAt = this.touch(record);
         if (touchedAt != null) record.lastAccessedAt = touchedAt;
       }

package/src/docs/snapshot.json

@@ -1,7 +1,7 @@
 {
  "format": 1,
  "site": "https://gloom.sh",
- "updatedAt": "2026-10-12",
+ "updatedAt": "2026-10-14",
  "categories": [
   {
    "id": "research",
@@ -618,7 +618,7 @@
    "code": "NI",
    "name": "Topic news",
    "description": "News by topic code or sector",
-   "detail": "Market news by topic code (MNA, CB, ENERGY, REG, CRYPTO, EARN, IPO) or by sector.",
+   "detail": "Market news by topic code (MNA, CB, ENERGY, REG, CRYPTO, EARN, IPO) or by sector. LTR lists public fund and investor letters as links to the publisher's page.",
    "category": "news",
    "arg": "ENERGY",
    "shot": "https://gloom.sh/screenshots/fn/NI.png",
@@ -777,8 +777,8 @@
   {
    "code": "FUT",
    "name": "Futures board",
-   "description": "Front-month futures",
-   "detail": "Front-month contracts across equity index, rates, energy, metals, agriculture, and FX with last price and session change, grouped by sector.",
+   "description": "Most active futures",
+   "detail": "Each root's most active contract across equity index, rates, energy, metals, agriculture, and FX with last price, unit and session change, grouped by sector, naming the nearer month while it still trades.",
    "category": "markets",
    "shot": "https://gloom.sh/screenshots/fn/FUT.png",
    "lesson": "/academy/futures-commodities-energy/futures-from-zero"
@@ -816,7 +816,7 @@
    "code": "POWER",
    "name": "Power and grid buildout",
    "description": "Grid queues and large loads",
-   "detail": "Grid interconnection queues, datacentre and other large-load requests, generation capacity and utility exposure, with a link to the source for every project. Pro shows the full data and history; Free shows three rows per section. EPWR opens the Prices tab, free: day-ahead power prices for 32 European markets in EUR/MWh and the EU carbon (EUA) auction clearing price in EUR/tCO2, each with its daily history.",
+   "detail": "Grid interconnection queues, datacentre and other large-load requests, generation capacity and utility exposure, with a link to the source for every project. Pro shows the full data and history; Free shows three rows per section. EPWR opens the Prices tab, free: day-ahead power prices for 32 European markets in EUR/MWh and the EU carbon (EUA) auction clearing price in EUR/tCO2, each with its daily history. EPWR GAS shows European gas storage from GIE AGSI+: % full, TWh and daily injection and withdrawal for the EU and each member state, against a year ago and the five-year range.",
    "category": "markets",
    "arg": "NEE",
    "access": "pro",
@@ -6329,7 +6329,7 @@
     "developer api",
     "market news"
    ],
-   "updatedAt": "2026-10-07",
+   "updatedAt": "2026-10-14",
    "blocks": [
     {
      "type": "heading",
@@ -6360,7 +6360,7 @@
       [
        "Free key",
        "Free",
-       "Delayed 12 hours."
+       "Delayed 12 hours. Real-time with a paid [Gloom Datasets](/docs/datasets) plan."
       ],
       [
        "Unlimited",
@@ -6380,7 +6380,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Every `/v1/news` request requires a News API key. Use either header style:"
+     "text": "Every `/v1/news` request requires a News API key or a [Gloom Datasets](/docs/datasets) key (`gds_`). Use either header style:"
     },
     {
      "type": "code",
@@ -6595,7 +6595,7 @@
     "cftc",
     "cot"
    ],
-   "updatedAt": "2026-10-08",
+   "updatedAt": "2026-10-14",
    "blocks": [
     {
      "type": "heading",
@@ -6620,7 +6620,7 @@
      "items": [
       "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, research attention, congressional trades, operating exposure.",
       "**Filings and company text:** KPIs and guidance, executive pay, risk factors, 8-K events, transcripts, credit documents, debt maturities, revenue breakdown, SEC filings, insiders and 13F, document search.",
-      "**News:** Delayed stories, sources and topics.",
+      "**News:** Real-time stories, sources and topics.",
       "**Macro and positioning:** CPI, EIA inventories, COT, yield curves and macro series, central bank rates, short volume and interest, CDS, government awards.",
       "**Market data and fundamentals:** Quotes and history, financial statements, statistics, profiles, earnings, estimates, IPOs, M&A, screener, options and gamma positioning, futures, rate path, crypto, session tape."
      ]
@@ -6644,7 +6644,7 @@
     },
     {
      "type": "paragraph",
-     "text": "They are different keys from the Gloom API's. A Gloom Pro key (`gloom_mcp_`) or a News API key (`gloom_news_`) gets `401 wrong_key` on a dataset route, and a `gds_` key gets `401` on the Gloom API's own routes, such as the [REST API](/docs/rest-api) and the [News API](/docs/news-api)."
+     "text": "They are different keys from the Gloom API's. A Gloom Pro key (`gloom_mcp_`) or a News API key (`gloom_news_`) gets `401 wrong_key` on a dataset route, and a `gds_` key gets `401` on the Gloom API's own routes, such as the [REST API](/docs/rest-api), but reads the [News API](/docs/news-api) at no credit cost."
     },
     {
      "type": "heading",
@@ -7303,9 +7303,9 @@
   {
    "url": "/academy/futures-commodities-energy/futures-from-zero",
    "title": "Futures from zero (FUT)",
-   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows the front months across markets.",
+   "summary": "A futures contract is a standard, exchange-traded promise to buy or sell a set quantity on a set month at a price agreed today, settled with daily margin, and FUT shows the most active months across markets.",
    "chapter": "Futures, commodities and energy",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/futures-commodities-energy/curves-and-rolling",

package/src/i18n/es.ts

@@ -982,6 +982,7 @@ export const es: Record<string, string> = {
   "Update ready, restart to apply": "Actualización lista; reinicia para aplicar",
   "Update ready": "Actualización lista",
   "Restart": "Reiniciar",
+  "Restart to apply v{version}": "Reinicia para aplicar v{version}",
   "Checking for updates...": "Buscando actualizaciones...",
   "Downloading v{version}: {percent}%": "Descargando v{version}: {percent}%",
   "Update failed: {error}": "Error al actualizar: {error}",

package/src/i18n/ja.ts

@@ -996,6 +996,7 @@ export const ja: Record<string, string> = {
   "Update ready, restart to apply": "アップデートの準備ができました。適用するには再起動してください",
   "Update ready": "アップデートの準備完了",
   "Restart": "再起動",
+  "Restart to apply v{version}": "再起動して v{version} を適用",
   "Checking for updates...": "アップデートを確認中...",
   "Downloading v{version}: {percent}%": "v{version} をダウンロード中: {percent}%",
   "Update failed: {error}": "更新に失敗しました: {error}",

package/src/i18n/ko.ts

@@ -994,6 +994,7 @@ export const ko: Record<string, string> = {
   "Update ready, restart to apply": "업데이트 준비 완료. 적용하려면 다시 시작하세요",
   "Update ready": "업데이트 준비 완료",
   "Restart": "다시 시작",
+  "Restart to apply v{version}": "다시 시작하여 v{version} 적용",
   "Checking for updates...": "업데이트 확인 중...",
   "Downloading v{version}: {percent}%": "v{version} 다운로드 중: {percent}%",
   "Update failed: {error}": "업데이트 실패: {error}",

package/src/i18n/zh-cn.ts

@@ -996,6 +996,7 @@ export const zhCN: Record<string, string> = {
   "Update ready, restart to apply": "更新已就绪，重启后生效",
   "Update ready": "更新已就绪",
   "Restart": "重启",
+  "Restart to apply v{version}": "重启以应用 v{version}",
   "Checking for updates...": "正在检查更新...",
   "Downloading v{version}: {percent}%": "正在下载 v{version}：{percent}%",
   "Update failed: {error}": "更新失败：{error}",

package/src/i18n/zh-tw.ts

@@ -996,6 +996,7 @@ export const zhTW: Record<string, string> = {
   "Update ready, restart to apply": "更新已就緒，重新啟動後生效",
   "Update ready": "更新已就緒",
   "Restart": "重新啟動",
+  "Restart to apply v{version}": "重新啟動以套用 v{version}",
   "Checking for updates...": "正在檢查更新...",
   "Downloading v{version}: {percent}%": "正在下載 v{version}：{percent}%",
   "Update failed: {error}": "更新失敗：{error}",

package/src/market-data/futures-contract.ts

@@ -128,6 +128,13 @@ export function isFuturesContractSpec(spec: unknown): spec is FuturesContractSpe
     && (row.settlement === "physical" || row.settlement === "cash");
 }
 
+function isNearestContract(value: unknown): boolean {
+  if (!value || typeof value !== "object") return false;
+  const row = value as Record<string, unknown>;
+  return typeof row.contract === "string" && typeof row.contractSymbol === "string"
+    && typeof row.deliveryMonth === "string" && /^\d{4}-(0[1-9]|1[0-2])$/.test(row.deliveryMonth) && optionalDate(row.lastTrade);
+}
+
 export function validateFuturesContractTerms(data: FuturesContractTermsPayload): FuturesContractTermsPayload {
   const settlement = data?.settlement as unknown;
   if (!data || typeof data !== "object" || typeof data.root !== "string"
@@ -138,6 +145,9 @@ export function validateFuturesContractTerms(data: FuturesContractTermsPayload):
       && isDate((settlement as { date?: unknown }).date))) {
     throw new Error("The server returned invalid futures contract terms");
   }
+  // A nearest contract the server worded some other way is left out; the terms still stand.
+  const nearest = data.nearest as unknown;
+  if (nearest != null && !isNearestContract(nearest)) return { ...data, nearest: null };
   return data;
 }
 

package/src/market-data/market/format.ts

@@ -428,7 +428,7 @@ export function formatMarketChangeWithCurrency(
   referencePrice?: number,
 ): string {
   if (value == null || !Number.isFinite(value)) return "—";
-  if (resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatSignedMarketPrice(value, options);
+  if (isIndexLevel(options) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatSignedMarketPrice(value, options);
   if (options.fixedFractionDigits !== undefined) {
     const maxWidth = options.maxWidth == null ? undefined : Math.max(1, options.maxWidth - 1);
     const body = formatMarketPriceWithCurrency(Math.abs(value), currency, { ...options, maxWidth });
@@ -603,13 +603,18 @@ export function liveQuoteFormatOptions(
   return withStablePriceDigits(quoteFormatOptions(quote, fallbackAssetCategory, metadataInstrumentType), currency, quote);
 }
 
+/** An index level is points, not money: ^GSPC at 7,805.45 has no currency to name, wherever it is shown. */
+function isIndexLevel(options: MarketFormatOptions): boolean {
+  return options.assetCategory?.trim().toUpperCase() === "INDEX";
+}
+
 export function formatMarketPriceWithCurrency(
   value: number | undefined,
   currency = "USD",
   options: MarketFormatOptions = {},
 ): string {
   if (value === undefined || value === null || Number.isNaN(value)) return "—";
-  if (resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketPrice(value, options);
+  if (isIndexLevel(options) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketPrice(value, options);
   const normalizedCurrency = currency.trim().toUpperCase() || "USD";
   const sign = value < 0 ? "-" : "";
   const symbol = getCurrencySymbol(normalizedCurrency);