gloomberb 0.15.7 → 0.15.8

package/README.md

@@ -76,6 +76,7 @@ Press `Ctrl+P` to open the command bar, or press `` ` `` to search for a ticker.
 | `HVG AAPL` / `HVT AAPL` | Realized volatility and volatility cones |
 | `SEAS AAPL` | Seasonality: monthly returns by year and year overlays |
 | `COT [code or root]` | CFTC positioning and cross-market extremes |
+| `DOE` / `NGS` | EIA weekly oil stocks and gas storage, with builds, draws and five-year ranges |
 | `TOP` | Market stories |
 | `WIRP` / `FFIP` | US rate path and conditional FOMC probabilities |
 | `BTMM` | Funding rates, bill curves and Federal Reserve liquidity |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.15.7",
+  "version": "0.15.8",
   "packageManager": "bun@1.3.11",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/public/index.ts",

package/src/api-client/data.ts

@@ -14,6 +14,7 @@ import type { ShortVolumePayload, ShortVolumeScope } from "./short-volume";
 import type { SocialMentionDayPosts, SocialMentionsPayload, SocialMentionsRange } from "./social-mentions";
 import type { FuturesCurveAsOfPayload, FuturesCurvePayload } from "./futures-curve";
 import type { CotBoardPayload, CotContractPayload, CotFamily, CotClass } from "./cot";
+import type { DoeBoardPayload } from "./doe";
 import type { TapeSnapshot } from "./tape";
 import type { ExchangeRateSnapshot } from "../types/exchange-rate";
 import type { RatePathPayload } from "./rates";
@@ -385,6 +386,10 @@ export class CloudDataApi {
     return this.request<CotContractPayload>(`/cloud/cot/contracts/${encodeURIComponent(code)}?${new URLSearchParams({ report })}`);
   }
 
+  async getCloudDoeBoard(): Promise<DoeBoardPayload> {
+    return this.request<DoeBoardPayload>("/cloud/doe/board");
+  }
+
   async getCloudTape(symbol: string, exchange: string, signal?: AbortSignal): Promise<TapeSnapshot> {
     return this.request<TapeSnapshot>(`/cloud/tape/${encodeURIComponent(symbol)}?exchange=${encodeURIComponent(exchange)}`, { signal: signal ?? AbortSignal.timeout(30_000) });
   }

package/src/api-client/doe.ts

@@ -0,0 +1,75 @@
+/** EIA weekly petroleum and natural gas storage, as GET /cloud/doe/board serves it. */
+export type DoeReport = "petroleum" | "gas";
+export type DoeTab = "crude" | "products" | "gas";
+/** Thousand barrels, thousand barrels a day, percent, billion cubic feet: as published. */
+export type DoeUnit = "kb" | "kbd" | "pct" | "bcf";
+
+interface DoeFiveYear {
+  /** Calendar years in the band, oldest first; fewer than five where history is short. */
+  years: number[];
+  min: number;
+  max: number;
+  average: number;
+  /** The average change into this week over the same years. */
+  averageChange: number | null;
+  vsAverage: number;
+  vsAveragePercent: number | null;
+  /** 0 at the five-year low, 100 at the high, beyond either outside the range. */
+  position: number | null;
+}
+
+interface DoeYearAgo {
+  weekEnding: string;
+  value: number;
+  change: number;
+  changePercent: number | null;
+}
+
+interface DoeSeasonal {
+  /** The calendar year of the latest week. */
+  year: number;
+  /** Fridays in that year: 52 or 53. */
+  weeks: number;
+  /** [week of year, value]. */
+  current: Array<[number, number]>;
+  previous: Array<[number, number]>;
+  /** [week, min, average, max] of the band years on that week's day. */
+  band: Array<[number, number | null, number | null, number | null]>;
+}
+
+export interface DoeSeriesRow {
+  id: string;
+  key: string;
+  report: DoeReport;
+  tab: DoeTab;
+  label: string;
+  unit: DoeUnit;
+  weekEnding: string | null;
+  value: number | null;
+  previousWeekEnding: string | null;
+  weekChange: number | null;
+  yearAgo: DoeYearAgo | null;
+  fiveYear: DoeFiveYear | null;
+  /** One plain read worked out from the numbers. */
+  read: string | null;
+  seasonal: DoeSeasonal | null;
+}
+
+export interface DoeReportStatus {
+  id: DoeReport;
+  weekEnding: string | null;
+  releasedAt: string | null;
+  releaseHoliday: string | null;
+  nextWeekEnding: string | null;
+  nextReleaseAt: string | null;
+  nextReleaseHoliday: string | null;
+}
+
+export interface DoeBoardPayload {
+  source: "EIA";
+  generatedAt: string;
+  status: "available" | "partial" | "unavailable";
+  gaps: string[];
+  reports: DoeReportStatus[];
+  series: DoeSeriesRow[];
+}

package/src/api-client/index.ts

@@ -721,6 +721,7 @@ class GloomApiClient {
   getCloudShiller = this.data.getCloudShiller.bind(this.data);
   getCloudCotBoard = this.data.getCloudCotBoard.bind(this.data);
   getCloudCotContract = this.data.getCloudCotContract.bind(this.data);
+  getCloudDoeBoard = this.data.getCloudDoeBoard.bind(this.data);
   getCloudTape = this.data.getCloudTape.bind(this.data);
   getCloudYieldCurve = this.data.getCloudYieldCurve.bind(this.data);
   getCloudCurve = this.data.getCloudCurve.bind(this.data);

package/src/api-client/paths.ts

@@ -13,6 +13,8 @@ export type CloudHistoryParams = {
   endDate?: string;
   rangeKey?: string;
   historyRecovery?: HistoryRetention;
+  /** Ask for pre-market and after-hours bars too. */
+  session?: "extended";
 };
 
 export type CloudFredSeriesParams = {
@@ -172,6 +174,7 @@ export function cloudHistoryPath(
   if (params.endDate) search.set("endDate", params.endDate);
   if (params.rangeKey) search.set("rangeKey", params.rangeKey);
   if (params.historyRecovery) search.set("historyRecovery", JSON.stringify(params.historyRecovery));
+  if (params.session) search.set("session", params.session);
   return appendQuery("/market/history", search);
 }
 

package/src/api-client/types.ts

@@ -1293,6 +1293,8 @@ export interface CloudMarketResponse<T> {
   historyRetention?: unknown;
   /** Source-declared history semantics; validated separately from quote metadata. */
   historySession?: unknown;
+  /** "extended" when the history includes the pre-market and after-hours bars asked for. */
+  session?: unknown;
   /** Untrusted until the history adapter validates its boundary dates. */
   coverage?: CloudHistoryCoverage;
   providerMeta?: {

package/src/cli/pane-functions/function-help.ts

@@ -582,6 +582,21 @@ export const FUNCTION_HELP: Readonly<Record<string, FunctionHelp>> = {
     data: same("Weekly: Tuesday positions, out on Friday"),
     bloomberg: ["COT"],
   },
+  DOE: {
+    summary: "The EIA's weekly petroleum and natural gas storage numbers: crude, Cushing and the SPR, gasoline, distillates, jet fuel and propane, refinery runs, trade and demand, and gas storage by region. Each row shows the week's build or draw, the change on a year ago and where it sits in its five-year range; the selected one is charted over the year against the five-year band with a plain read of the numbers.",
+    usage: ["DOE", "NGS"],
+    keys: [],
+    data: same("Weekly, on release"),
+    bloomberg: ["DOE"],
+  },
+  NGS: {
+    summary: "Lower 48 working gas in storage and each region's, the week's injection or withdrawal against a year ago and the five-year average, charted over the year. The Gas Storage tab of DOE.",
+    usage: ["NGS"],
+    keys: [],
+    data: same("Weekly, on release"),
+    bloomberg: [],
+    docs: "DOE",
+  },
   VIX: {
     summary: "Daily VIX tenor closes, the term structure and whether it is in contango or inverted, with the cross-asset volatility board beside it.",
     usage: ["VIX"],

package/src/components/chart/composite/composite-chart.tsx

@@ -1159,6 +1159,17 @@ function CompositePanelSurface({
       color: marker.color,
     };
   }, [formatAxisValue, panel]);
+  const priorCloseMarker = useMemo(() => {
+    const marker = panel.priorClose;
+    const domain = marker ? panel.axes[marker.axis] : undefined;
+    if (!marker || !domain) return null;
+    return {
+      side: marker.axis,
+      yRatio: marker.yRatio,
+      label: formatAxisValue ? formatAxisValue(marker.value, domain) : formatCompositeCursorValue(marker.value, domain),
+      color: colors.textDim,
+    };
+  }, [colors.textDim, formatAxisValue, panel]);
   const levelMarkers = useMemo(() => levelDomain ? [...projectedLevels]
     // The picked level's label first, then alerts', when they compete for room.
     .sort((left, right) => Number(right.level.id === selectedLevelId) - Number(left.level.id === selectedLevelId)
@@ -1181,7 +1192,8 @@ function CompositePanelSurface({
       !!marker && (marker.side === null || marker.side === side)
     );
     const fixed = [lastPriceMarker, axisMarkers].filter(onSide).map(toAxisMarker);
-    const levelLabels = levelMarkers.filter(onSide).map(toAxisMarker);
+    // The prior close's label yields to every level's.
+    const levelLabels = [...levelMarkers, priorCloseMarker].filter(onSide).map(toAxisMarker);
     // A label is a row tall, so close levels would stack into an unreadable
     // pile and hide the last price: each keeps its line, and only the labels
     // with a row to themselves show. Desktop badges sit between rows.
@@ -2885,7 +2897,7 @@ export function CompositeChart({
   const timeAxisCursorLabel = xAxis?.formatCursor && scene.cursorXRatio !== null
     ? xAxis.formatCursor(scene.cursorXRatio)
     : scene.cursorDate
-      ? formatCompositeTimeAxisDate(scene.cursorDate, scene.startTime, scene.endTime)
+      ? formatCompositeTimeAxisDate(scene.cursorDate, scene.startTime, scene.endTime, scene.timeZone)
       : null;
   // The crosshair labels the moving end, so the axis only adds the anchor.
   const timeAxisMarkers = toolSpan
@@ -2895,6 +2907,7 @@ export function CompositeChart({
         new Date(toolSpan.startTime),
         scene.startTime,
         scene.endTime,
+        scene.timeZone,
       ),
       color: toolSpan.color,
     }]

package/src/components/chart/composite/format.ts

@@ -1,6 +1,7 @@
 import { formatMarketPrice, formatMarketPriceWithCurrency, stablePriceFractionDigits, type MarketFormatOptions } from "../../../market-data/market/format";
 import type { ResolvedSeries, TimeSeriesPoint } from "../../../time-series/types";
 import type { CompositeAxisDomain, CompositePanelScene } from "./types";
+import { timeZoneLabel, zonedWallClockMs } from "../../../utils/zoned-date-time";
 
 const CURRENCY_SYMBOLS: Record<string, string> = {
   USD: "$",
@@ -411,17 +412,28 @@ function utcTime(date: Date): string {
   return date.toISOString().slice(11, 16);
 }
 
+/** The date's wall-clock reading in `timeZone` (UTC when absent), and the zone's short name. */
+function onClock(date: Date, timeZone: string | undefined): { wall: Date; zone: string } {
+  if (!timeZone || timeZone === "UTC") return { wall: date, zone: "UTC" };
+  try {
+    return { wall: new Date(zonedWallClockMs(date.getTime(), timeZone)), zone: timeZoneLabel(timeZone) };
+  } catch {
+    return { wall: date, zone: "UTC" };
+  }
+}
+
 function isIntradaySpan(startTime: number, endTime: number): boolean {
   return Number.isFinite(startTime)
     && Number.isFinite(endTime)
     && Math.abs(endTime - startTime) <= INTRADAY_SPAN_MAX_MS;
 }
 
-/** Shared-cursor timestamp using the chart's explicit UTC convention. */
-export function formatCompositeCursorDate(date: Date, startTime: number, endTime: number): string {
+/** Shared-cursor timestamp on the chart's clock: the venue's for intraday bars, else UTC. */
+export function formatCompositeCursorDate(date: Date, startTime: number, endTime: number, timeZone?: string): string {
+  const { wall, zone } = onClock(date, timeZone);
   return isIntradaySpan(startTime, endTime)
-    ? `${utcDate(date)} ${utcTime(date)} UTC`
-    : utcDate(date);
+    ? `${utcDate(wall)} ${utcTime(wall)} ${zone}`
+    : utcDate(wall);
 }
 
 function validUtcTimestamp(date: Date | undefined): string | null {
@@ -462,12 +474,13 @@ export function formatCompositePointDetails(point: TimeSeriesPoint | null | unde
   return details.join(" · ");
 }
 
-/** Compact UTC tick label selected from the full visible chart span. */
-export function formatCompositeTimeAxisDate(date: Date, startTime: number, endTime: number): string {
-  if (!isIntradaySpan(startTime, endTime)) return utcDate(date);
-  const startDate = utcDate(new Date(startTime));
-  const endDate = utcDate(new Date(endTime));
+/** Compact tick label on the chart's clock, selected from the full visible chart span. */
+export function formatCompositeTimeAxisDate(date: Date, startTime: number, endTime: number, timeZone?: string): string {
+  const { wall, zone } = onClock(date, timeZone);
+  if (!isIntradaySpan(startTime, endTime)) return utcDate(wall);
+  const startDate = utcDate(onClock(new Date(startTime), timeZone).wall);
+  const endDate = utcDate(onClock(new Date(endTime), timeZone).wall);
   return startDate === endDate
-    ? `${utcTime(date)} UTC`
-    : `${utcDate(date).slice(5)} ${utcTime(date)} UTC`;
+    ? `${utcTime(wall)} ${zone}`
+    : `${utcDate(wall).slice(5)} ${utcTime(wall)} ${zone}`;
 }

package/src/components/chart/composite/rasterizer.ts

@@ -39,6 +39,9 @@ interface RenderCompositePanelBitmapOptions {
 const LAST_PRICE_DASH_PIXELS = 6;
 const LAST_PRICE_GAP_PIXELS = 5;
 const LAST_PRICE_OPACITY = 0.9;
+const PRIOR_CLOSE_DOT_PIXELS = 2;
+const PRIOR_CLOSE_GAP_PIXELS = 3;
+const PRIOR_CLOSE_OPACITY = 0.7;
 
 function pixelPoint(point: CompositeProjectedPoint, width: number, height: number): { x: number; y: number } {
   return {
@@ -118,6 +121,53 @@ function fillAreaGradient(
   }
 }
 
+const BAND_FILL_OPACITY = 0.2;
+
+/**
+ * The range a band series spans, one flat fill per pixel column between its
+ * points' `low` and `high`, read straight across between neighbouring points.
+ */
+function fillBand(
+  data: Uint8Array,
+  width: number,
+  height: number,
+  series: CompositeProjectedSeries,
+  domain: CompositeAxisDomain,
+  color: RgbaColor,
+): void {
+  const edges = series.points.map((projected) => {
+    const { high, low } = projected.point;
+    const x = pixelPoint(projected, width, height).x;
+    if (high == null || low == null || !Number.isFinite(high) || !Number.isFinite(low)) return null;
+    const top = pixelY(high, domain, height);
+    const bottom = pixelY(low, domain, height);
+    return top === null || bottom === null ? null : { x, top: Math.min(top, bottom), bottom: Math.max(top, bottom) };
+  });
+  const filled = new Uint8Array(width);
+  const fillColumn = (x: number, top: number, bottom: number) => {
+    if (x < 0 || x >= width || filled[x]) return;
+    filled[x] = 1;
+    for (let y = Math.max(0, Math.round(top)); y <= Math.min(height - 1, Math.round(bottom)); y += 1) {
+      blendPixel(data, width, height, x, y, color, BAND_FILL_OPACITY);
+    }
+  };
+  for (let index = 0; index < edges.length; index += 1) {
+    const current = edges[index];
+    if (!current) continue;
+    const previous = index > 0 && !series.points[index]?.breakBefore ? edges[index - 1] : null;
+    if (!previous) {
+      fillColumn(Math.round(current.x), current.top, current.bottom);
+      continue;
+    }
+    const start = Math.round(previous.x);
+    const span = Math.max(1, Math.round(current.x) - start);
+    for (let x = start; x <= start + span; x += 1) {
+      const t = (x - start) / span;
+      fillColumn(x, previous.top + (current.top - previous.top) * t, previous.bottom + (current.bottom - previous.bottom) * t);
+    }
+  }
+}
+
 function drawConnectedSeries(
   data: Uint8Array,
   width: number,
@@ -343,27 +393,19 @@ function drawOhlc(
   }
 }
 
-function drawLastPriceLevel(
+function drawDashedLevel(
   data: Uint8Array,
   width: number,
   height: number,
   yRatio: number,
   color: RgbaColor,
+  dash = LAST_PRICE_DASH_PIXELS,
+  gap = LAST_PRICE_GAP_PIXELS,
+  opacity = LAST_PRICE_OPACITY,
 ): void {
   const y = Math.round(clamp(yRatio * Math.max(height - 1, 0), 0, Math.max(height - 1, 0)));
-  const period = LAST_PRICE_DASH_PIXELS + LAST_PRICE_GAP_PIXELS;
-  for (let x = 0; x < width; x += period) {
-    fillRect(
-      data,
-      width,
-      height,
-      x,
-      y,
-      Math.min(x + LAST_PRICE_DASH_PIXELS - 1, width - 1),
-      y,
-      color,
-      LAST_PRICE_OPACITY,
-    );
+  for (let x = 0; x < width; x += dash + gap) {
+    fillRect(data, width, height, x, y, Math.min(x + dash - 1, width - 1), y, color, opacity);
   }
 }
 
@@ -388,9 +430,14 @@ export function renderCompositePanelBitmap(
     fillRect(data, width, height, 0, y, width - 1, y + 0.6, grid, 0.42);
   }
   if (panel.volumeProfile) paintVolumeProfile(data, width, height, panel.volumeProfile);
+  // Under the bars, which read across it.
+  if (panel.priorClose) {
+    drawDashedLevel(data, width, height, panel.priorClose.yRatio, parseHex(options.colors.textDim),
+      PRIOR_CLOSE_DOT_PIXELS, PRIOR_CLOSE_GAP_PIXELS, PRIOR_CLOSE_OPACITY);
+  }
 
   const ordered = [...panel.series].sort((left, right) => {
-    const rank = (style: string) => style === "area" || style === "columns" ? 0 : 1;
+    const rank = (style: string) => style === "area" || style === "columns" || style === "band" ? 0 : 1;
     return rank(left.source.style) - rank(right.source.style);
   });
   const columnLayout = buildCompositeColumnLayout(panel);
@@ -430,6 +477,10 @@ export function renderCompositePanelBitmap(
       case "area":
         drawConnectedSeries(data, width, height, series, domain, color, true);
         break;
+      case "band":
+        fillBand(data, width, height, series, domain, color);
+        drawConnectedSeries(data, width, height, series, domain, color, false);
+        break;
       case "points":
         for (const point of series.points) {
           const projected = pixelPoint(point, width, height);
@@ -449,7 +500,7 @@ export function renderCompositePanelBitmap(
   }
 
   if (panel.lastPrice) {
-    drawLastPriceLevel(data, width, height, panel.lastPrice.yRatio, parseHex(panel.lastPrice.color));
+    drawDashedLevel(data, width, height, panel.lastPrice.yRatio, parseHex(panel.lastPrice.color));
   }
 
   return { width, height, pixels: data };

package/src/components/chart/composite/scene.ts

@@ -24,7 +24,8 @@ import { compositeAxisMaxTicks, seriesPriceReference } from "./format";
 import type { CompositeTimeScale } from "./types";
 import { isFiniteNumber } from "../../../utils/guards";
 import { volumeProfile } from "../../../time-series/trader-studies";
-import { extendedHoursSpans } from "./session-shading";
+import { extendedHoursSpans, isIntradaySeries } from "./session-shading";
+import { listingTimeZone } from "../../../market-data/market/trading-sessions";
 
 const DAY_MS = 24 * 60 * 60 * 1000;
 
@@ -247,6 +248,10 @@ function seriesDomainValues(series: ResolvedSeries): number[] {
       for (const candidate of [point.open, point.high, point.low, point.close]) {
         if (isFiniteNumber(candidate)) values.push(candidate);
       }
+    } else if (series.style === "band") {
+      for (const candidate of [point.high, point.low]) {
+        if (isFiniteNumber(candidate)) values.push(candidate);
+      }
     }
   }
   if (series.style === "columns") values.push(0);
@@ -300,6 +305,24 @@ function axisPriceReferences(axisSeries: ResolvedSeries[]): Record<string, numbe
   return references;
 }
 
+/**
+ * A one-day chart's previous close joins the axis when it lies within one
+ * session range of the bars, so a quiet session still shows where it opened
+ * from; a far gap leaves the bars their full height.
+ */
+function priorCloseInReach(series: readonly ResolvedSeries[], values: readonly number[]): number[] {
+  const reference = series.find((entry) => isFiniteNumber(entry.priorClose) && entry.points.length > 0)?.priorClose;
+  if (reference === undefined || values.length === 0) return [];
+  let low = Number.POSITIVE_INFINITY;
+  let high = Number.NEGATIVE_INFINITY;
+  for (const value of values) {
+    if (value < low) low = value;
+    if (value > high) high = value;
+  }
+  const span = high - low;
+  return reference >= low - span && reference <= high + span ? [reference] : [];
+}
+
 function buildAxisDomain(
   side: CompositeAxisSide,
   series: ResolvedSeries[],
@@ -308,7 +331,8 @@ function buildAxisDomain(
 ): CompositeAxisDomain | undefined {
   const axisSeries = series.filter((entry) => entry.axis === side);
   if (axisSeries.length === 0) return undefined;
-  const { min, max } = paddedDomain(axisSeries.flatMap(seriesDomainValues), scale);
+  const values = axisSeries.flatMap(seriesDomainValues);
+  const { min, max } = paddedDomain([...values, ...priorCloseInReach(axisSeries, values)], scale);
   const first = axisSeries[0]!;
   return {
     side,
@@ -496,6 +520,30 @@ function attachLastPriceMarker(
   };
 }
 
+/** Marks the previous session's close a one-day chart carries on its price series. */
+function attachPriorClose(panels: CompositePanelScene[], series: readonly ResolvedSeries[]): void {
+  const entry = series.find((candidate) => isFiniteNumber(candidate.priorClose));
+  const panel = entry ? panels.find((candidate) => candidate.id === entry.panelId) : undefined;
+  const domain = entry ? panel?.axes[entry.axis] : undefined;
+  if (!entry || !panel || !domain || !panel.series.some((candidate) => candidate.source.id === entry.id)) return;
+  const yRatio = projectCompositeValue(entry.priorClose!, domain);
+  // Off the axis it marks nothing; the axis follows the session's own bars.
+  if (yRatio === null || yRatio < 0 || yRatio > 1) return;
+  panel.priorClose = { axis: entry.axis, value: entry.priorClose!, yRatio };
+}
+
+/**
+ * The zone intraday market bars read in: the venue's own clock, as the tape
+ * does. Daily and longer bars carry dates, which stay in UTC.
+ */
+function sceneTimeZone(anchor: ResolvedSeries | undefined, series: readonly ResolvedSeries[]): string | undefined {
+  const market = anchor ?? series.find((entry) => entry.observationKind === "market");
+  if (!market || !isIntradaySeries(market)) return undefined;
+  const zone = market.timeBasis?.timeZone
+    ?? (market.listing ? listingTimeZone(market.listing.symbol, market.listing.exchange) : null);
+  return zone && zone !== "UTC" ? zone : undefined;
+}
+
 /**
  * Profiles a volume-profile study over its bars in view and takes its points
  * off the panel, so it draws as a histogram rather than a line or cursor dots.
@@ -754,6 +802,8 @@ export function buildCompositeChartScene(
   });
   panelScenes.forEach(attachVolumeProfile);
   attachLastPriceMarker(panelScenes, usableSeries);
+  attachPriorClose(panelScenes, usableSeries);
+  const timeZone = sceneTimeZone(anchor, timelineSeries);
 
   return {
     width: Math.max(1, Math.floor(options.width)),
@@ -767,6 +817,7 @@ export function buildCompositeChartScene(
     cursorDate,
     cursorXRatio,
     cursorValues: buildCursorValues(panelScenes, cursorDate, { startTime, endTime, timeScale }),
+    ...(timeZone ? { timeZone } : {}),
   };
 }
 

package/src/components/chart/composite/session-shading.ts

@@ -21,7 +21,8 @@ function isRegular(exchange: string, time: number): boolean | null {
   return regular;
 }
 
-function isIntraday(series: ResolvedSeries): boolean {
+/** Whether a series holds intraday bars, by its cadence or its acquired resolution. */
+export function isIntradaySeries(series: ResolvedSeries): boolean {
   const cadence = series.timeBasis?.cadenceMs;
   if (cadence !== undefined) return cadence < DAY_MS;
   return !!series.historyResolution && isIntradayResolution(series.historyResolution);
@@ -39,7 +40,7 @@ export function extendedHoursSpans(
   ratios: readonly number[],
 ): CompositeExtendedHoursSpan[] {
   const exchange = anchor?.timeBasis?.exchange;
-  if (!anchor || !exchange || !isIntraday(anchor) || dates.length === 0) return [];
+  if (!anchor || !exchange || !isIntradaySeries(anchor) || dates.length === 0) return [];
   const edge = (index: number, side: -1 | 1) => {
     const ratio = ratios[index]!;
     // At either end of the plot, mirror the gap to the bar on the other side.

package/src/components/chart/composite/text-renderer.ts

@@ -113,6 +113,46 @@ function renderArea(
   renderLineLike(rows, series, width, height);
 }
 
+/** A band's range as shade between its points' low and high rows, under its line. */
+function renderBand(
+  rows: string[][],
+  series: CompositeProjectedSeries,
+  domain: CompositeAxisDomain,
+  width: number,
+  height: number,
+): void {
+  const edges = series.points.map((projected) => {
+    const { high, low } = projected.point;
+    if (high == null || low == null) return null;
+    const top = valueRow(high, domain, height);
+    const bottom = valueRow(low, domain, height);
+    return top === null || bottom === null
+      ? null
+      : { x: cellPoint(projected, width, height).x, top: Math.min(top, bottom), bottom: Math.max(top, bottom) };
+  });
+  const shade = (x: number, top: number, bottom: number) => {
+    for (let row = Math.round(top); row <= Math.round(bottom); row += 1) {
+      const current = rows[row]?.[x];
+      if (current === " " || current === "·") setCell(rows, x, row, "░");
+    }
+  };
+  for (let index = 0; index < edges.length; index += 1) {
+    const current = edges[index];
+    if (!current) continue;
+    const previous = index > 0 && !series.points[index]?.breakBefore ? edges[index - 1] : null;
+    if (!previous) {
+      shade(current.x, current.top, current.bottom);
+      continue;
+    }
+    const span = Math.max(1, current.x - previous.x);
+    for (let x = previous.x; x <= current.x; x += 1) {
+      const t = (x - previous.x) / span;
+      shade(x, previous.top + (current.top - previous.top) * t, previous.bottom + (current.bottom - previous.bottom) * t);
+    }
+  }
+  renderLineLike(rows, series, width, height);
+}
+
 function renderColumns(
   rows: string[][],
   series: CompositeProjectedSeries,
@@ -221,7 +261,7 @@ export function renderCompositePanelText(
 
   const columnLayout = buildCompositeColumnLayout(panel);
   const orderedSeries = [...panel.series].sort((left, right) => {
-    const layerRank = (style: string) => style === "area" || style === "columns" ? 0 : 1;
+    const layerRank = (style: string) => style === "area" || style === "columns" || style === "band" ? 0 : 1;
     return layerRank(left.source.style) - layerRank(right.source.style);
   });
   for (const series of orderedSeries) {
@@ -234,6 +274,9 @@ export function renderCompositePanelText(
       case "area":
         renderArea(rows, series, domain, plotWidth, height);
         break;
+      case "band":
+        renderBand(rows, series, domain, plotWidth, height);
+        break;
       case "candles":
       case "ohlc":
       case "hlc":
@@ -264,6 +307,14 @@ export function renderCompositePanelText(
       if (current === " " || current === "·") setCell(rows, x, row, "╌");
     }
   }
+  // The previous close, dotted, where the last price has not taken the row.
+  if (panel.priorClose) {
+    const row = clamp(Math.round(panel.priorClose.yRatio * Math.max(height - 1, 0)), 0, Math.max(height - 1, 0));
+    for (let x = 0; x < plotWidth; x += 1) {
+      const current = rows[row]?.[x];
+      if (current === " " || current === "·") setCell(rows, x, row, "┈");
+    }
+  }
 
   if (cursorXRatio !== null) {
     const cursorX = clamp(Math.round(cursorXRatio * Math.max(plotWidth - 1, 0)), 0, Math.max(plotWidth - 1, 0));