@pond-ts/charts 0.41.0 → 0.42.0

package/dist/index.d.ts

@@ -45,13 +45,16 @@ export type { BarChartProps } from './BarChart.js';
 export { Candlestick } from './Candlestick.js';
 export type { CandlestickProps } from './Candlestick.js';
 export type { CandleVariant, ColorBy } from './ohlc.js';
+export { scaleTradingTime } from './tradingTimeScale.js';
+export type { TradingTimeScale, DiscontinuityProvider, } from './tradingTimeScale.js';
 export { Region, Baseline, Marker } from './annotations.js';
 export type { RegionProps, BaselineProps, MarkerProps } from './annotations.js';
 export type { AnnotationKind, CreateSpec } from './context.js';
 export { YAxisIndicator, createLiveValue } from './indicators.js';
 export type { YAxisIndicatorProps, LiveValue } from './indicators.js';
-export { fromTimeSeries, bandFromTimeSeries, boxFromTimeSeries, barsFromTimeSeries, ohlcFromTimeSeries, } from './data.js';
-export type { ChartSeries, BandSeries, BoxSeries, BoxColumns, BarSeries, OhlcSeries, OhlcColumns, } from './data.js';
+export { fromTimeSeries, bandFromTimeSeries, boxFromTimeSeries, barsFromTimeSeries, ohlcFromTimeSeries, stacksFromGroups, stacksFromColumns, stacksFromBins, } from './data.js';
+export type { ChartSeries, BandSeries, BoxSeries, BoxColumns, BarSeries, OhlcSeries, OhlcColumns, StackedBarSeries, BinRecord, StacksFromBinsOptions, } from './data.js';
+export type { Orientation } from './bars.js';
 export type { RadiusEncoding, ColorEncoding } from './encoding.js';
 export type { Curve } from './curve.js';
 export type { GapMode } from './gaps.js';

package/dist/index.js

@@ -30,13 +30,17 @@ export { ScatterChart } from './ScatterChart.js';
 export { BoxPlot } from './BoxPlot.js';
 export { BarChart } from './BarChart.js';
 export { Candlestick } from './Candlestick.js';
+export { scaleTradingTime } from './tradingTimeScale.js';
 // Annotations — user-authored marks in the turquoise register (distinct from the
 // data): a shaded span, a horizontal value line, a vertical x line.
 export { Region, Baseline, Marker } from './annotations.js';
 // Axis indicators — a value pill pinned to an axis edge (the ChartIQ live tag).
 // `createLiveValue` is the high-frequency, isolated-repaint update path.
 export { YAxisIndicator, createLiveValue } from './indicators.js';
-export { fromTimeSeries, bandFromTimeSeries, boxFromTimeSeries, barsFromTimeSeries, ohlcFromTimeSeries, } from './data.js';
+export { fromTimeSeries, bandFromTimeSeries, boxFromTimeSeries, barsFromTimeSeries, ohlcFromTimeSeries, 
+// Stacked / histogram readers — assemble a StackedBarSeries from pond's own
+// aggregation output: a Map of grouped series, a wide series, or byColumn bins.
+stacksFromGroups, stacksFromColumns, stacksFromBins, } from './data.js';
 export { defaultTheme, estelaTheme } from './theme.js';
 // CSS-custom-property → ChartTheme bridge: build a theme from a design system's
 // tokens (`cssVarTheme`), and a hook that re-resolves it on a `data-theme`

package/dist/scatter.d.ts

@@ -44,13 +44,15 @@ export declare function scatterExtent(cs: ChartSeries): [number, number] | null;
  * @param labelAt optional per-point text label; `undefined` ⇒ no labels drawn.
  * @param font    `theme.font` (family + size) for label text.
  * @param selected the container's current selection (or `null`).
- * @param seriesLabel this layer's series identity (`as` ?? column) — the
- *                `label` half of the selection match.
+ * @param seriesId this layer's stable series identity (its `id` prop, or
+ *                `undefined` when the layer isn't selectable) — the series half
+ *                of the selection match. A point lights only when the selection's
+ *                `id` matches, keyed to the sample by its `key`.
  */
 export declare function drawScatter(ctx: CanvasRenderingContext2D, cs: ChartSeries, xScale: Scale, yScale: Scale, style: ScatterStyle, encoding: ResolvedEncoding, keyAt: (i: number) => number, labelAt: ((i: number) => string | undefined) | undefined, font: {
     readonly family: string;
     readonly size: number;
-}, selected: SelectInfo | null, seriesLabel: string): void;
+}, selected: SelectInfo | null, seriesId: string | undefined): void;
 /**
  * Hit-test plot-pixel `(qx, qy)` against the scatter's points — the topmost
  * point whose circle contains the click, or `null`. "Topmost" = the
@@ -59,12 +61,12 @@ export declare function drawScatter(ctx: CanvasRenderingContext2D, cs: ChartSeri
  *
  * A point's hit radius is its drawn radius (data-driven or base) — clicking the
  * visible disc selects it. Distance is compared squared (no `sqrt` in the loop).
- * Returns the point's {@link SelectInfo} with `key = keyAt(i)` (its event
- * `begin`), the encoded fill colour (so the readout swatch matches the mark),
- * and the series `label`.
+ * Returns the point's {@link SelectInfo} with the series `id` (the selection
+ * identity), `key = keyAt(i)` (its event `begin` — click provenance), the encoded
+ * fill colour (so the readout swatch matches the mark), and the display `label`.
  *
  * Pure: takes the same `xScale`/`yScale` the row hands to `draw`, so it
  * unit-tests without a DOM (mirrors the `sampleAt` / `resolveSelection` split).
  */
-export declare function hitTestScatter(cs: ChartSeries, qx: number, qy: number, xScale: Scale, yScale: Scale, encoding: ResolvedEncoding, keyAt: (i: number) => number, seriesLabel: string): SelectInfo | null;
+export declare function hitTestScatter(cs: ChartSeries, qx: number, qy: number, xScale: Scale, yScale: Scale, encoding: ResolvedEncoding, keyAt: (i: number) => number, id: string, seriesLabel: string): SelectInfo | null;
 //# sourceMappingURL=scatter.d.ts.map

package/dist/scatter.js

@@ -109,13 +109,16 @@ export function scatterExtent(cs) {
  * @param labelAt optional per-point text label; `undefined` ⇒ no labels drawn.
  * @param font    `theme.font` (family + size) for label text.
  * @param selected the container's current selection (or `null`).
- * @param seriesLabel this layer's series identity (`as` ?? column) — the
- *                `label` half of the selection match.
+ * @param seriesId this layer's stable series identity (its `id` prop, or
+ *                `undefined` when the layer isn't selectable) — the series half
+ *                of the selection match. A point lights only when the selection's
+ *                `id` matches, keyed to the sample by its `key`.
  */
-export function drawScatter(ctx, cs, xScale, yScale, style, encoding, keyAt, labelAt, font, selected, seriesLabel) {
+export function drawScatter(ctx, cs, xScale, yScale, style, encoding, keyAt, labelAt, font, selected, seriesId) {
     ctx.save();
     // The selection only lights up a point of *this* series; resolve the key once.
-    const selectedKey = selected !== null && selected.label === seriesLabel ? selected.key : null;
+    // A no-id (non-selectable) layer passes `undefined` and never matches.
+    const selectedKey = selected !== null && selected.id === seriesId ? selected.key : null;
     let selPx = 0;
     let selPy = 0;
     let selR = 0;
@@ -183,14 +186,14 @@ const LABEL_GAP = 4;
  *
  * A point's hit radius is its drawn radius (data-driven or base) — clicking the
  * visible disc selects it. Distance is compared squared (no `sqrt` in the loop).
- * Returns the point's {@link SelectInfo} with `key = keyAt(i)` (its event
- * `begin`), the encoded fill colour (so the readout swatch matches the mark),
- * and the series `label`.
+ * Returns the point's {@link SelectInfo} with the series `id` (the selection
+ * identity), `key = keyAt(i)` (its event `begin` — click provenance), the encoded
+ * fill colour (so the readout swatch matches the mark), and the display `label`.
  *
  * Pure: takes the same `xScale`/`yScale` the row hands to `draw`, so it
  * unit-tests without a DOM (mirrors the `sampleAt` / `resolveSelection` split).
  */
-export function hitTestScatter(cs, qx, qy, xScale, yScale, encoding, keyAt, seriesLabel) {
+export function hitTestScatter(cs, qx, qy, xScale, yScale, encoding, keyAt, id, seriesLabel) {
     for (let i = cs.length - 1; i >= 0; i -= 1) {
         if (!isPoint(cs, i))
             continue;
@@ -201,6 +204,7 @@ export function hitTestScatter(cs, qx, qy, xScale, yScale, encoding, keyAt, seri
         const dy = qy - py;
         if (dx * dx + dy * dy <= r * r) {
             return {
+                id,
                 key: keyAt(i),
                 value: cs.y[i],
                 color: encoding.colorAt(i),

package/dist/theme.d.ts

@@ -104,6 +104,13 @@ export interface ChartTheme {
         readonly grid: string;
         /** Gridline dash pattern (px on/off pairs); `[]` for solid. */
         readonly gridDash: readonly number[];
+        /**
+         * Stroke for **session dividers** — the solid verticals a trading-time axis
+         * draws at each collapsed gap (session/day open). Optional; falls back to
+         * {@link grid}. Set it a touch stronger than the gridlines so a session
+         * boundary reads as structural.
+         */
+        readonly sessionDivider?: string;
         /**
          * Typography for the axis **title** — the rotated y-axis unit strip and the
          * x-axis label (distinct from the per-tick `label` colour above). Omit a

package/dist/theme.js

@@ -111,6 +111,7 @@ export const defaultTheme = {
         label: '#64748b',
         grid: '#e2e8f0',
         gridDash: [2, 2],
+        sessionDivider: '#cbd5e1', // slate-300 — a step stronger than the gridlines
     },
     font: {
         family: 'system-ui, -apple-system, sans-serif',

package/dist/tradingTimeScale.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The structural discontinuity-provider surface `scaleTradingTime` consumes to
+ * collapse closed-market time. Charts declares this **shape** itself and never
+ * imports `@pond-ts/financial` — a `TradingCalendar.discontinuities()` provider
+ * satisfies it structurally, so the packages stay decoupled (trading-calendar
+ * RFC §6.1). Domain values are epoch-milliseconds.
+ */
+export interface DiscontinuityProvider {
+    /** A value in a removed gap → its next live instant; a live value unchanged. */
+    clampUp(value: number): number;
+    /** A value in a removed gap → its previous live instant; a live value unchanged. */
+    clampDown(value: number): number;
+    /** Signed live (non-gap) distance from `from` to `to`. */
+    distance(from: number, to: number): number;
+    /** Advance `value` by `amount` live-ms, skipping gaps (inverse of {@link distance}). */
+    offset(value: number, amount: number): number;
+    copy(): DiscontinuityProvider;
+    /**
+     * Optional: the domain positions of collapsed gaps strictly inside `(from,
+     * to)` — session/day opens where closed time was removed. The container draws
+     * a **session divider** at each; a provider that omits it just collapses the
+     * axis silently. (A `TradingCalendar.discontinuities()` provider supplies it.)
+     */
+    boundaries?(from: number, to: number): number[];
+}
+/**
+ * The high-level counterpart to a bare {@link DiscontinuityProvider}: anything
+ * that can *produce* one from an optional `spacing` choice. A
+ * `@pond-ts/financial` `TradingCalendar` satisfies this structurally (its
+ * `discontinuities` accepts a superset of these options), so a consumer can
+ * hand `<ChartContainer calendar={cal} spacing="uniform" />` instead of calling
+ * `cal.discontinuities({ spacing })` themselves — and charts still never imports
+ * the financial package (RFC §6.1). For the full option matrix (a bar `period`,
+ * a scoped `range`) build the provider yourself and pass the low-level
+ * `discontinuities` prop.
+ */
+export interface TradingCalendarLike {
+    discontinuities(options?: {
+        spacing?: 'proportional' | 'uniform';
+    }): DiscontinuityProvider;
+}
+/**
+ * A d3-scale-shaped time scale whose pixel mapping runs through **trading time**
+ * — closed-market gaps (weekends, holidays, overnight, lunch breaks) collapse to
+ * nothing while time stays proportional within each session. Exposes the slice
+ * of the d3 `ScaleTime` surface `@pond-ts/charts` actually uses, so it drops in
+ * wherever the container's `xScale` goes.
+ *
+ * Ticks are **calendar-aware** when the provider enumerates its gaps: `.ticks`
+ * returns the session opens thinned to a calendar grain (week / month / year
+ * starts, whichever fits ~`count`), and `.tickFormat` labels each anchor with a
+ * **date** (`%b %d`) — or the **year** (`%Y`) when ticks are a year apart —
+ * while formatting any other instant (a mid-session tick, the cursor readout)
+ * with the d3 multi-scale default. Without a provider `boundaries` method it
+ * falls back to interior even-spaced time ticks.
+ *
+ * **Out-of-domain behavior.** Within the calendar the scale extrapolates like a
+ * normal scale — a live instant *before* the domain start maps to a negative
+ * pixel (so off-plot marks are still culled). Instants outside the calendar
+ * entirely (before the first session / after the last) have no trading-time
+ * position and **clamp** to the near edge rather than extrapolating into
+ * meaningless space. In practice marks are always in-calendar, so this only
+ * affects data beyond the calendar's absolute extremes.
+ */
+export interface TradingTimeScale {
+    (value: number): number;
+    invert(pixel: number): number;
+    ticks(count?: number): number[];
+    tickFormat(count?: number, specifier?: string): (date: Date) => string;
+    domain(): [number, number];
+    domain(next: readonly [number, number]): TradingTimeScale;
+    range(): [number, number];
+    range(next: readonly [number, number]): TradingTimeScale;
+    copy(): TradingTimeScale;
+}
+/** The calendar grain a run of session opens is bucketed to for axis ticks. */
+type TickGranularity = 'session' | 'week' | 'month' | 'quarter' | 'year';
+/**
+ * Thin an ascending run of **session opens** down to about `count` axis ticks by
+ * **calendar grain** — the trading-terminal habit of labelling week / month /
+ * year starts rather than an arbitrary every-nth session. Picks the finest grain
+ * on the ladder (session → week → month → quarter → year) that yields at most
+ * `count` buckets and returns the first open in each; beyond yearly it decimates
+ * every-nth so the axis never crowds. Exported so the container can draw session
+ * dividers at the same instants the axis labels.
+ */
+export declare function coarsenCalendar(opens: readonly number[], count: number): {
+    ticks: number[];
+    granularity: TickGranularity;
+};
+/**
+ * Build a {@link TradingTimeScale} over the given discontinuity `provider`.
+ * Configure like a d3 scale: `scaleTradingTime(provider).domain([t0, t1]).range([0, width])`.
+ */
+export declare function scaleTradingTime(provider: DiscontinuityProvider): TradingTimeScale;
+export {};
+//# sourceMappingURL=tradingTimeScale.d.ts.map

package/dist/tradingTimeScale.js

@@ -0,0 +1,152 @@
+import { scaleTime } from 'd3-scale';
+/**
+ * The local-time bucket key for `t` at grain `g` — two instants in the same
+ * week / month / quarter / year share a key. Local time (not UTC) so it agrees
+ * with the local `scaleTime` label formatter; the exchange's own time zone is
+ * unknown to the scale (the deferred refinement), and a session open sits well
+ * inside its local day, so runtime-local grouping matches the exchange day in
+ * every ordinary case.
+ */
+function bucketKey(t, g) {
+    if (g === 'session')
+        return t; // every open its own bucket
+    const d = new Date(t);
+    switch (g) {
+        case 'week': {
+            const dow = (d.getDay() + 6) % 7; // 0 = Monday
+            // Local midnight of this week's Monday (Date normalizes a negative date).
+            return new Date(d.getFullYear(), d.getMonth(), d.getDate() - dow).getTime();
+        }
+        case 'month':
+            return d.getFullYear() * 12 + d.getMonth();
+        case 'quarter':
+            return d.getFullYear() * 4 + Math.floor(d.getMonth() / 3);
+        case 'year':
+            return d.getFullYear();
+    }
+}
+/** The first instant of each distinct `g`-bucket in the ascending list `opens`. */
+function firstOfEachBucket(opens, g) {
+    const out = [];
+    let prev;
+    for (const t of opens) {
+        const k = bucketKey(t, g);
+        if (k !== prev) {
+            out.push(t);
+            prev = k;
+        }
+    }
+    return out;
+}
+const COARSENING_LADDER = [
+    'week',
+    'month',
+    'quarter',
+    'year',
+];
+/**
+ * Thin an ascending run of **session opens** down to about `count` axis ticks by
+ * **calendar grain** — the trading-terminal habit of labelling week / month /
+ * year starts rather than an arbitrary every-nth session. Picks the finest grain
+ * on the ladder (session → week → month → quarter → year) that yields at most
+ * `count` buckets and returns the first open in each; beyond yearly it decimates
+ * every-nth so the axis never crowds. Exported so the container can draw session
+ * dividers at the same instants the axis labels.
+ */
+export function coarsenCalendar(opens, count) {
+    if (opens.length <= count)
+        return { ticks: [...opens], granularity: 'session' };
+    for (const g of COARSENING_LADDER) {
+        const ticks = firstOfEachBucket(opens, g);
+        if (ticks.length <= count)
+            return { ticks, granularity: g };
+    }
+    // Coarser than yearly isn't a calendar grain — decimate the year starts.
+    const yearly = firstOfEachBucket(opens, 'year');
+    const step = Math.ceil(yearly.length / count);
+    return {
+        ticks: yearly.filter((_, i) => i % step === 0),
+        granularity: 'year',
+    };
+}
+/**
+ * Build a {@link TradingTimeScale} over the given discontinuity `provider`.
+ * Configure like a d3 scale: `scaleTradingTime(provider).domain([t0, t1]).range([0, width])`.
+ */
+export function scaleTradingTime(provider) {
+    let domain = [0, 1];
+    let range = [0, 1];
+    // A private d3 time scale, kept in sync with the domain, purely for tickFormat.
+    const base = scaleTime();
+    const totalLive = () => provider.distance(domain[0], domain[1]);
+    const scale = ((value) => {
+        const live = totalLive();
+        const span = range[1] - range[0];
+        if (live === 0)
+            return range[0];
+        return range[0] + (provider.distance(domain[0], value) / live) * span;
+    });
+    scale.invert = (pixel) => {
+        const span = range[1] - range[0];
+        const frac = span === 0 ? 0 : (pixel - range[0]) / span;
+        return provider.offset(domain[0], frac * totalLive());
+    };
+    /** The session-open instants in the domain — the first session's open (the
+     *  left edge) plus each collapsed-gap boundary — the axis's date anchors. */
+    const sessionOpens = () => {
+        const bounds = provider.boundaries?.(domain[0], domain[1]) ?? [];
+        return [domain[0], ...bounds];
+    };
+    scale.ticks = (count = 10) => {
+        const live = totalLive();
+        if (live <= 0 || count < 1)
+            return [domain[0]];
+        const opens = sessionOpens();
+        // Calendar-aware: label the session opens (each a new day), thinned to
+        // week / month / year starts by grain rather than an arbitrary every-nth
+        // session — the trading-terminal look.
+        if (opens.length > 1)
+            return coarsenCalendar(opens, count).ticks;
+        // No boundaries (a single session / no calendar): fall back to interior
+        // even-spaced ticks — endpoints excluded so none sits on the plot edge.
+        const out = [];
+        for (let i = 1; i < count; i++) {
+            out.push(provider.offset(domain[0], (i / count) * live));
+        }
+        return out;
+    };
+    scale.tickFormat = (count = 10, specifier) => {
+        if (specifier !== undefined)
+            return base.tickFormat(count, specifier);
+        const opens = sessionOpens();
+        const defFmt = base.tickFormat(count);
+        if (opens.length <= 1)
+            return defFmt; // no calendar → d3 multi-scale default
+        // Anchor label at each coarsened session-open tick: a **date** (`%b %d`), or
+        // the **year** when ticks are a year apart (a plain date would drop the year
+        // the reader needs). Any other instant — a cursor readout — uses the d3
+        // multi-scale default. Same grain as {@link ticks}, so labels and the
+        // dividers drawn at these instants agree.
+        const { ticks, granularity } = coarsenCalendar(opens, count);
+        const anchors = new Set(ticks);
+        const anchorFmt = base.tickFormat(count, granularity === 'year' ? '%Y' : '%b %d');
+        return (d) => (anchors.has(+d) ? anchorFmt(d) : defFmt(d));
+    };
+    function domainFn(next) {
+        if (next === undefined)
+            return [domain[0], domain[1]];
+        domain = [next[0], next[1]];
+        return scale;
+    }
+    scale.domain = domainFn;
+    function rangeFn(next) {
+        if (next === undefined)
+            return [range[0], range[1]];
+        range = [next[0], next[1]];
+        return scale;
+    }
+    scale.range = rangeFn;
+    scale.copy = () => scaleTradingTime(provider.copy()).domain(domain).range(range);
+    return scale;
+}
+//# sourceMappingURL=tradingTimeScale.js.map

package/dist/viewport.d.ts

@@ -17,4 +17,27 @@ export declare function panRange(range: TimeRange, dt: number): [number, number]
  * pivot keeps its fractional position in the window.
  */
 export declare function zoomRange(range: TimeRange, pivot: number, factor: number, minDuration?: number): [number, number];
+/**
+ * The slice of a discontinuity provider the trading-time viewport math needs —
+ * a structural subset of the charts `DiscontinuityProvider` (so `viewport.ts`
+ * stays free of any provider dependency).
+ */
+export interface ViewportDiscontinuity {
+    distance(from: number, to: number): number;
+    offset(value: number, amount: number): number;
+}
+/**
+ * Pan a range on a **trading-time** axis: shift both endpoints by the same
+ * amount of *trading* time, so the pan feels uniform on screen even across
+ * collapsed gaps (a raw-ms shift would jump at each weekend/holiday). `fraction`
+ * is the signed share of the plot width dragged — the caller passes `-dx/plotWidth`
+ * (drag right → reveal earlier data → negative).
+ */
+export declare function panRangeTrading(range: TimeRange, fraction: number, provider: ViewportDiscontinuity): [number, number];
+/**
+ * Zoom a **trading-time** range around `pivot` by `factor` (`< 1` in, `> 1` out),
+ * scaling the *trading* distance from the pivot to each endpoint so the pivot's
+ * on-screen position holds. Floors the visible trading time at `minLive`.
+ */
+export declare function zoomRangeTrading(range: TimeRange, pivot: number, factor: number, provider: ViewportDiscontinuity, minLive?: number): [number, number];
 //# sourceMappingURL=viewport.d.ts.map

package/dist/viewport.js

@@ -27,4 +27,55 @@ export function zoomRange(range, pivot, factor, minDuration = 1) {
     const frac = span > 0 ? (pivot - range[0]) / span : 0.5;
     return [pivot - minDuration * frac, pivot + minDuration * (1 - frac)];
 }
+/**
+ * Pan a range on a **trading-time** axis: shift both endpoints by the same
+ * amount of *trading* time, so the pan feels uniform on screen even across
+ * collapsed gaps (a raw-ms shift would jump at each weekend/holiday). `fraction`
+ * is the signed share of the plot width dragged — the caller passes `-dx/plotWidth`
+ * (drag right → reveal earlier data → negative).
+ */
+export function panRangeTrading(range, fraction, provider) {
+    const span = provider.distance(range[0], range[1]);
+    const shift = fraction * span;
+    // Anchor on the endpoint being pushed toward its boundary and rebuild the
+    // other from the preserved span, so panning into *either* calendar edge stops
+    // (the window holds its trading width) rather than shrinking or collapsing.
+    if (shift <= 0) {
+        const start = provider.offset(range[0], shift);
+        return [start, provider.offset(start, span)];
+    }
+    const end = provider.offset(range[1], shift);
+    return [provider.offset(end, -span), end];
+}
+/**
+ * Zoom a **trading-time** range around `pivot` by `factor` (`< 1` in, `> 1` out),
+ * scaling the *trading* distance from the pivot to each endpoint so the pivot's
+ * on-screen position holds. Floors the visible trading time at `minLive`.
+ */
+export function zoomRangeTrading(range, pivot, factor, provider, minLive = 1) {
+    const left = provider.distance(range[0], pivot); // trading-ms d0 → pivot (≥ 0)
+    const right = provider.distance(pivot, range[1]); // trading-ms pivot → d1 (≥ 0)
+    let nl = left * factor;
+    let nr = right * factor;
+    if (nl + nr < minLive) {
+        const total = left + right;
+        const frac = total > 0 ? left / total : 0.5;
+        nl = minLive * frac;
+        nr = minLive * (1 - frac);
+    }
+    let d0 = provider.offset(pivot, -nl);
+    let d1 = provider.offset(pivot, nr);
+    // If one side clamped at a calendar edge (couldn't extend as far as asked),
+    // give the shortfall to the other side so the visible trading span — and the
+    // `minLive` floor — is preserved. (The pivot's *fraction* can then drift at
+    // the edge: there is no trading time before the first / after the last session
+    // to hold it against.)
+    const shortLeft = nl - provider.distance(d0, pivot);
+    const shortRight = nr - provider.distance(pivot, d1);
+    if (shortLeft > 0)
+        d1 = provider.offset(pivot, nr + shortLeft);
+    else if (shortRight > 0)
+        d0 = provider.offset(pivot, -(nl + shortRight));
+    return [d0, d1];
+}
 //# sourceMappingURL=viewport.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pond-ts/charts",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "private": false,
   "description": "Canvas-rendered, streaming-first time-series charts for pond-ts",
   "license": "MIT",
@@ -38,8 +38,8 @@
     "perf": "PERF_BENCH=1 playwright test perf.spec.ts --workers=1"
   },
   "peerDependencies": {
-    "@pond-ts/react": "^0.41.0",
-    "pond-ts": "^0.41.0",
+    "@pond-ts/react": "^0.42.0",
+    "pond-ts": "^0.42.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {