@invinite-org/chartlang-runtime 1.0.2

package/dist/streamState.js

@@ -0,0 +1,313 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { Float64RingBuffer } from "./ringBuffer.js";
+import { makeSeriesView } from "./seriesView.js";
+function deriveBarSources(rawBar) {
+    return {
+        hl2: (rawBar.high + rawBar.low) / 2,
+        hlc3: (rawBar.high + rawBar.low + rawBar.close) / 3,
+        ohlc4: (rawBar.open + rawBar.high + rawBar.low + rawBar.close) / 4,
+        hlcc4: (rawBar.high + rawBar.low + rawBar.close + rawBar.close) / 4,
+    };
+}
+const rawBufferKeys = ["time", "open", "high", "low", "close", "volume"];
+function rawBuffers(ohlcv) {
+    return {
+        time: ohlcv.time,
+        open: ohlcv.open,
+        high: ohlcv.high,
+        low: ohlcv.low,
+        close: ohlcv.close,
+        volume: ohlcv.volume,
+    };
+}
+function valueAt(values, index) {
+    const value = values[index];
+    return value === null || value === undefined ? Number.NaN : value;
+}
+function recomputeDerivedBuffers(ohlcv, snapshot) {
+    const { headIndex, filled, buffers } = snapshot;
+    const capacity = ohlcv.hl2.capacity;
+    const derived = {
+        hl2: new Array(capacity),
+        hlc3: new Array(capacity),
+        ohlc4: new Array(capacity),
+        hlcc4: new Array(capacity),
+    };
+    for (let i = 0; i < capacity; i += 1) {
+        const high = valueAt(buffers.high, i);
+        const low = valueAt(buffers.low, i);
+        const open = valueAt(buffers.open, i);
+        const close = valueAt(buffers.close, i);
+        derived.hl2[i] = Number.isNaN(high) || Number.isNaN(low) ? null : (high + low) / 2;
+        derived.hlc3[i] =
+            Number.isNaN(high) || Number.isNaN(low) || Number.isNaN(close)
+                ? null
+                : (high + low + close) / 3;
+        derived.ohlc4[i] =
+            Number.isNaN(open) || Number.isNaN(high) || Number.isNaN(low) || Number.isNaN(close)
+                ? null
+                : (open + high + low + close) / 4;
+        derived.hlcc4[i] =
+            Number.isNaN(high) || Number.isNaN(low) || Number.isNaN(close)
+                ? null
+                : (high + low + close + close) / 4;
+    }
+    ohlcv.hl2.restoreFromSnapshotBuffer({ headIndex, filled, values: derived.hl2 });
+    ohlcv.hlc3.restoreFromSnapshotBuffer({ headIndex, filled, values: derived.hlc3 });
+    ohlcv.ohlc4.restoreFromSnapshotBuffer({ headIndex, filled, values: derived.ohlc4 });
+    ohlcv.hlcc4.restoreFromSnapshotBuffer({ headIndex, filled, values: derived.hlcc4 });
+}
+/**
+ * Construct a fresh `StreamState`. The ring-buffer capacity is the
+ * compiler-emitted `manifest.maxLookback + 1` per PLAN.md §6.6
+ * (caller must enforce `capacity >= 1`). All buffers start empty;
+ * the `BarView` starts with `NaN` prices, `0` time and volume, and the
+ * supplied `symbol` / `interval` constants. `taSlots` is an empty map.
+ *
+ * @since 0.1
+ * @example
+ *     // import { createStreamState } from "@invinite-org/chartlang-runtime";
+ *     // const stream = createStreamState({
+ *     //     interval: "5m",
+ *     //     capacity: 12,
+ *     //     symbol: "BTCUSD",
+ *     // });
+ *     // stream.bar.close;          // NaN
+ *     // stream.ohlcv.close.length; // 0
+ */
+export function createStreamState(args) {
+    const { interval, capacity, symbol } = args;
+    const ohlcv = {
+        time: new Float64RingBuffer(capacity),
+        open: new Float64RingBuffer(capacity),
+        high: new Float64RingBuffer(capacity),
+        low: new Float64RingBuffer(capacity),
+        close: new Float64RingBuffer(capacity),
+        volume: new Float64RingBuffer(capacity),
+        hl2: new Float64RingBuffer(capacity),
+        hlc3: new Float64RingBuffer(capacity),
+        ohlc4: new Float64RingBuffer(capacity),
+        hlcc4: new Float64RingBuffer(capacity),
+    };
+    const bar = {
+        time: 0,
+        open: Number.NaN,
+        high: Number.NaN,
+        low: Number.NaN,
+        close: Number.NaN,
+        volume: 0,
+        hl2: Number.NaN,
+        hlc3: Number.NaN,
+        ohlc4: Number.NaN,
+        hlcc4: Number.NaN,
+        symbol,
+        interval,
+        viewport: Object.freeze({ fromTime: 0, toTime: 0 }),
+    };
+    const seriesViews = {
+        time: makeSeriesView(ohlcv.time),
+        open: makeSeriesView(ohlcv.open),
+        high: makeSeriesView(ohlcv.high),
+        low: makeSeriesView(ohlcv.low),
+        close: makeSeriesView(ohlcv.close),
+        volume: makeSeriesView(ohlcv.volume),
+        hl2: makeSeriesView(ohlcv.hl2),
+        hlc3: makeSeriesView(ohlcv.hlc3),
+        ohlc4: makeSeriesView(ohlcv.ohlc4),
+        hlcc4: makeSeriesView(ohlcv.hlcc4),
+    };
+    const stream = {
+        interval,
+        ohlcv,
+        bar,
+        seriesViews,
+        taSlots: new Map(),
+        serialiseSnapshot() {
+            const close = ohlcv.close.serialiseSnapshotBuffer();
+            const buffers = rawBuffers(ohlcv);
+            return Object.freeze({
+                interval: bar.interval,
+                headIndex: close.headIndex,
+                filled: close.filled,
+                buffers: Object.freeze({
+                    time: buffers.time.serialiseSnapshotBuffer().values,
+                    open: buffers.open.serialiseSnapshotBuffer().values,
+                    high: buffers.high.serialiseSnapshotBuffer().values,
+                    low: buffers.low.serialiseSnapshotBuffer().values,
+                    close: close.values,
+                    volume: buffers.volume.serialiseSnapshotBuffer().values,
+                }),
+            });
+        },
+        restoreFromSnapshot(snapshot) {
+            const buffers = rawBuffers(ohlcv);
+            for (const key of rawBufferKeys) {
+                buffers[key].restoreFromSnapshotBuffer({
+                    headIndex: snapshot.headIndex,
+                    filled: snapshot.filled,
+                    values: snapshot.buffers[key],
+                });
+            }
+            recomputeDerivedBuffers(ohlcv, snapshot);
+            const current = snapshot.headIndex;
+            if (snapshot.filled === 0 || current < 0) {
+                bar.time = 0;
+                bar.open = Number.NaN;
+                bar.high = Number.NaN;
+                bar.low = Number.NaN;
+                bar.close = Number.NaN;
+                bar.volume = 0;
+                bar.hl2 = Number.NaN;
+                bar.hlc3 = Number.NaN;
+                bar.ohlc4 = Number.NaN;
+                bar.hlcc4 = Number.NaN;
+            }
+            else {
+                bar.time = valueAt(snapshot.buffers.time, current);
+                bar.open = valueAt(snapshot.buffers.open, current);
+                bar.high = valueAt(snapshot.buffers.high, current);
+                bar.low = valueAt(snapshot.buffers.low, current);
+                bar.close = valueAt(snapshot.buffers.close, current);
+                bar.volume = valueAt(snapshot.buffers.volume, current);
+                bar.hl2 = (bar.high + bar.low) / 2;
+                bar.hlc3 = (bar.high + bar.low + bar.close) / 3;
+                bar.ohlc4 = (bar.open + bar.high + bar.low + bar.close) / 4;
+                bar.hlcc4 = (bar.high + bar.low + bar.close + bar.close) / 4;
+            }
+            bar.interval = snapshot.interval;
+        },
+    };
+    return stream;
+}
+/**
+ * Append a finalised candle to a stream — extends the OHLCV ring buffers
+ * by one bar and writes every field of the mutable `BarView` (including
+ * `time` / `open`). Used by both the main close path and secondary
+ * stream history.
+ *
+ * @since 0.5
+ * @example
+ *     // appendBarToStream(stream, rawBar);
+ */
+export function appendBarToStream(stream, rawBar) {
+    const values = deriveBarSources(rawBar);
+    const { ohlcv, bar } = stream;
+    ohlcv.time.append(rawBar.time);
+    ohlcv.open.append(rawBar.open);
+    ohlcv.high.append(rawBar.high);
+    ohlcv.low.append(rawBar.low);
+    ohlcv.close.append(rawBar.close);
+    ohlcv.volume.append(rawBar.volume);
+    ohlcv.hl2.append(values.hl2);
+    ohlcv.hlc3.append(values.hlc3);
+    ohlcv.ohlc4.append(values.ohlc4);
+    ohlcv.hlcc4.append(values.hlcc4);
+    bar.time = rawBar.time;
+    bar.open = rawBar.open;
+    bar.high = rawBar.high;
+    bar.low = rawBar.low;
+    bar.close = rawBar.close;
+    bar.volume = rawBar.volume;
+    bar.hl2 = values.hl2;
+    bar.hlc3 = values.hlc3;
+    bar.ohlc4 = values.ohlc4;
+    bar.hlcc4 = values.hlcc4;
+    bar.symbol = rawBar.symbol;
+    bar.interval = rawBar.interval;
+}
+/**
+ * Replace the head of every OHLCV ring buffer in a stream and write
+ * every field of the `BarView`. Used by the secondary-stream replace
+ * path — falls back to {@link appendBarToStream} for the empty-buffer
+ * case so the first secondary bar arrives correctly even when delivered
+ * as a replace.
+ *
+ * @since 0.5
+ * @example
+ *     // replaceStreamHead(stream, rawBar);
+ */
+export function replaceStreamHead(stream, rawBar) {
+    if (stream.ohlcv.close.length === 0) {
+        appendBarToStream(stream, rawBar);
+        return;
+    }
+    const values = deriveBarSources(rawBar);
+    const { ohlcv, bar } = stream;
+    ohlcv.time.replaceHead(rawBar.time);
+    ohlcv.open.replaceHead(rawBar.open);
+    ohlcv.high.replaceHead(rawBar.high);
+    ohlcv.low.replaceHead(rawBar.low);
+    ohlcv.close.replaceHead(rawBar.close);
+    ohlcv.volume.replaceHead(rawBar.volume);
+    ohlcv.hl2.replaceHead(values.hl2);
+    ohlcv.hlc3.replaceHead(values.hlc3);
+    ohlcv.ohlc4.replaceHead(values.ohlc4);
+    ohlcv.hlcc4.replaceHead(values.hlcc4);
+    bar.time = rawBar.time;
+    bar.open = rawBar.open;
+    bar.high = rawBar.high;
+    bar.low = rawBar.low;
+    bar.close = rawBar.close;
+    bar.volume = rawBar.volume;
+    bar.hl2 = values.hl2;
+    bar.hlc3 = values.hlc3;
+    bar.ohlc4 = values.ohlc4;
+    bar.hlcc4 = values.hlcc4;
+    bar.symbol = rawBar.symbol;
+    bar.interval = rawBar.interval;
+}
+/**
+ * Replace the head of the close-side OHLCV ring buffers (close, high,
+ * low, volume, derived sources) for a tick within the in-progress bar.
+ * `time` and `open` are intentionally untouched — see
+ * `packages/runtime/CLAUDE.md` "onBarTick does NOT touch time / open"
+ * invariant. Mirrors the partial `BarView` update.
+ *
+ * @since 0.5
+ * @example
+ *     // replaceTickHead(stream, tickBar);
+ */
+export function replaceTickHead(stream, rawBar) {
+    const values = deriveBarSources(rawBar);
+    const { ohlcv, bar } = stream;
+    ohlcv.close.replaceHead(rawBar.close);
+    ohlcv.high.replaceHead(rawBar.high);
+    ohlcv.low.replaceHead(rawBar.low);
+    ohlcv.volume.replaceHead(rawBar.volume);
+    ohlcv.hl2.replaceHead(values.hl2);
+    ohlcv.hlc3.replaceHead(values.hlc3);
+    ohlcv.ohlc4.replaceHead(values.ohlc4);
+    ohlcv.hlcc4.replaceHead(values.hlcc4);
+    bar.close = rawBar.close;
+    bar.high = rawBar.high;
+    bar.low = rawBar.low;
+    bar.volume = rawBar.volume;
+    bar.hl2 = values.hl2;
+    bar.hlc3 = values.hlc3;
+    bar.ohlc4 = values.ohlc4;
+    bar.hlcc4 = values.hlcc4;
+}
+/**
+ * Refresh the stream's fallback visible range to the latest `limit`
+ * bars ending at the current head.
+ *
+ * @since 0.5
+ * @example
+ *     // updateFallbackViewport(stream);
+ */
+export function updateFallbackViewport(stream, limit = 100) {
+    const length = stream.ohlcv.time.length;
+    if (length === 0) {
+        stream.bar.viewport = Object.freeze({ fromTime: 0, toTime: 0 });
+        return;
+    }
+    const lookback = Math.min(length - 1, Math.max(0, limit - 1));
+    const fromTime = stream.ohlcv.time.at(lookback);
+    const toTime = stream.ohlcv.time.at(0);
+    stream.bar.viewport = Object.freeze({
+        fromTime: Number.isFinite(fromTime) ? fromTime : toTime,
+        toTime,
+    });
+}
+//# sourceMappingURL=streamState.js.map

package/dist/streamState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamState.js","sourceRoot":"","sources":["../src/streamState.ts"],"names":[],"mappings":"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"}

package/dist/ta/adl.d.ts

@@ -0,0 +1,27 @@
+import type { AdlOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Accumulation Distribution Line — cumulative money-flow volume
+ * `Σ CLV · volume`, where CLV is the close location value
+ * `((C − L) − (H − C)) / (H − L)`. Zero-range bars (`high === low`)
+ * contribute 0 (matches invinite's guard); NaN OHLC / volume bars
+ * contribute 0 (carry the accumulator forward without polluting it).
+ *
+ * Renders in its own pane (volume category). No warmup — every slot
+ * finite from bar 0.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `cumAdl` so a partial-bar tick doesn't
+ * pollute the next close's accumulator.
+ *
+ * @formula  adl[t] = adl[t − 1] + ((C[t] − L[t]) − (H[t] − C[t])) / (H[t] − L[t]) · V[t]
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const a = ta.adl();
+ *     // plot(a);
+ */
+export declare function adl(slotId: string, _opts?: AdlOpts): Series<number>;
+//# sourceMappingURL=adl.d.ts.map

package/dist/ta/adl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adl.d.ts","sourceRoot":"","sources":["../../src/ta/adl.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAuDpE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAmBnE"}

package/dist/ta/adl.js

@@ -0,0 +1,92 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Ported from invinite/src/components/trading-chart/indicators/adl.ts
+//   (commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite).
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 for the
+// provenance contract; the math is the reference, the code style is not.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape — NOT invinite's
+// IndicatorPlugin shape.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.adl called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        cumAdl: 0,
+        prevClosedCumAdl: 0,
+    };
+}
+/**
+ * Per-bar Money-Flow Volume: CLV (close location value) `((close − low)
+ * − (high − close)) / (high − low)` multiplied by volume. Returns 0
+ * on a zero-range bar (matches invinite's defensive guard) and 0 on
+ * any NaN OHLC / volume (matches `safeVolume(NaN) === 0`). The
+ * cumulative accumulator stays well-defined across data gaps.
+ */
+function mfvAt(close, high, low, volume) {
+    if (!Number.isFinite(close) ||
+        !Number.isFinite(high) ||
+        !Number.isFinite(low) ||
+        !Number.isFinite(volume)) {
+        return 0;
+    }
+    const range = high - low;
+    if (range === 0)
+        return 0;
+    const clv = (close - low - (high - close)) / range;
+    return clv * volume;
+}
+/**
+ * Accumulation Distribution Line — cumulative money-flow volume
+ * `Σ CLV · volume`, where CLV is the close location value
+ * `((C − L) − (H − C)) / (H − L)`. Zero-range bars (`high === low`)
+ * contribute 0 (matches invinite's guard); NaN OHLC / volume bars
+ * contribute 0 (carry the accumulator forward without polluting it).
+ *
+ * Renders in its own pane (volume category). No warmup — every slot
+ * finite from bar 0.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `cumAdl` so a partial-bar tick doesn't
+ * pollute the next close's accumulator.
+ *
+ * @formula  adl[t] = adl[t − 1] + ((C[t] − L[t]) − (H[t] − C[t])) / (H[t] − L[t]) · V[t]
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const a = ta.adl();
+ *     // plot(a);
+ */
+export function adl(slotId, _opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const { close, high, low, volume } = ctx.stream.bar;
+    const mfv = mfvAt(close, high, low, volume);
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(slot.prevClosedCumAdl + mfv);
+        return slot.series;
+    }
+    slot.prevClosedCumAdl = slot.cumAdl;
+    slot.cumAdl += mfv;
+    slot.outBuffer.append(slot.cumAdl);
+    return slot.series;
+}
+//# sourceMappingURL=adl.js.map

package/dist/ta/adl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adl.js","sourceRoot":"","sources":["../../src/ta/adl.ts"],"names":[],"mappings":"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"}

package/dist/ta/adr.d.ts

@@ -0,0 +1,38 @@
+import type { AdrOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Average Daily Range — SMA of `high − low` across the trailing
+ * `length` completed UTC calendar days. Default `length = 14` per
+ * TradingView. Reads `bar.high` / `bar.low` / `bar.time` directly
+ * (no `source` argument per the absolute-range formula).
+ *
+ * **Calendar-day boundary.** Phase 2 keys "daily" on the UTC midnight
+ * boundary (`Math.floor(time / 86_400_000)`). Bars sharing a day key
+ * are aggregated into a single `(dailyHigh, dailyLow)` pair; the day
+ * range commits to the rolling SMA when the next bar's day key differs.
+ * The in-progress (currently-aggregating) day is NEVER included in the
+ * average. Phase 4 lifts this onto `syminfo.session` so symbols with
+ * non-UTC sessions can override the convention.
+ *
+ * **Tick mode.** Ticks within the in-progress bar do NOT shift the day
+ * boundary (per the runtime invariant that ticks happen inside the
+ * current bar); the emitted value is the cached SMA of the already-
+ * committed days. The next close re-folds the bar into the in-progress
+ * day aggregate.
+ *
+ * **NaN.** Bars with non-finite `high` / `low` / `time` are skipped
+ * (no aggregation, no commit); the output reflects only the previously
+ * committed days.
+ *
+ * @formula  out[t] = mean( (dailyHigh − dailyLow) over the last `length`
+ *           completed UTC days, in price units )
+ * @warmup   length daily bars
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const r = ta.adr({ length: 14 });
+ *     // plot(r);
+ */
+export declare function adr(slotId: string, opts?: AdrOpts): Series<number>;
+//# sourceMappingURL=adr.d.ts.map

package/dist/ta/adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.ts","sourceRoot":"","sources":["../../src/ta/adr.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAoGpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAkBlE"}

package/dist/ta/adr.js

@@ -0,0 +1,143 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Ported from invinite/src/components/trading-chart/indicators/adr.ts
+//   (commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite).
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 for the
+// provenance contract; the math is the reference, the code style is not.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape — NOT invinite's
+// IndicatorPlugin shape. ADR derives from `bar.high`/`bar.low`/
+// `bar.time` directly — no `source` argument per the absolute-range
+// formula. The Phase-2 calendar-day boundary keys on UTC midnight
+// (`floor(time / 86_400_000)`); Phase 4 lifts this onto
+// `syminfo.session`.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+const DEFAULT_LENGTH = 14;
+const MS_PER_DAY = 86_400_000;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.adr called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        completedRanges: new Float64RingBuffer(length),
+        sumRanges: 0,
+        dailyHigh: Number.NaN,
+        dailyLow: Number.NaN,
+        currentDayKey: Number.NaN,
+    };
+}
+function commitDay(slot) {
+    // Defensive: callers gate on `Number.isFinite(currentDayKey)` so by the
+    // time we get here `dailyHigh` / `dailyLow` were set by a prior bar
+    // with finite OHLC. Keep the early return as a safety net.
+    /* c8 ignore next */
+    if (!Number.isFinite(slot.dailyHigh) || !Number.isFinite(slot.dailyLow))
+        return;
+    const range = slot.dailyHigh - slot.dailyLow;
+    if (slot.completedRanges.length === slot.length) {
+        // Evict the oldest range before append.
+        slot.sumRanges -= slot.completedRanges.at(slot.length - 1);
+    }
+    slot.completedRanges.append(range);
+    slot.sumRanges += range;
+}
+function emit(slot) {
+    if (slot.completedRanges.length < slot.length)
+        return Number.NaN;
+    return slot.sumRanges / slot.length;
+}
+function closeStep(slot, high, low, time) {
+    // NaN bars skipped from the daily aggregation per task spec §6.
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(time)) {
+        return emit(slot);
+    }
+    const dayKey = Math.floor(time / MS_PER_DAY);
+    if (Number.isNaN(slot.currentDayKey)) {
+        slot.currentDayKey = dayKey;
+        slot.dailyHigh = high;
+        slot.dailyLow = low;
+        return emit(slot);
+    }
+    if (dayKey !== slot.currentDayKey) {
+        // Rollover: commit the prior in-progress day, then seed the new
+        // day with the current bar's high/low.
+        commitDay(slot);
+        slot.currentDayKey = dayKey;
+        slot.dailyHigh = high;
+        slot.dailyLow = low;
+        return emit(slot);
+    }
+    // Same day: extend the in-progress aggregate.
+    if (high > slot.dailyHigh)
+        slot.dailyHigh = high;
+    if (low < slot.dailyLow)
+        slot.dailyLow = low;
+    return emit(slot);
+}
+/**
+ * Average Daily Range — SMA of `high − low` across the trailing
+ * `length` completed UTC calendar days. Default `length = 14` per
+ * TradingView. Reads `bar.high` / `bar.low` / `bar.time` directly
+ * (no `source` argument per the absolute-range formula).
+ *
+ * **Calendar-day boundary.** Phase 2 keys "daily" on the UTC midnight
+ * boundary (`Math.floor(time / 86_400_000)`). Bars sharing a day key
+ * are aggregated into a single `(dailyHigh, dailyLow)` pair; the day
+ * range commits to the rolling SMA when the next bar's day key differs.
+ * The in-progress (currently-aggregating) day is NEVER included in the
+ * average. Phase 4 lifts this onto `syminfo.session` so symbols with
+ * non-UTC sessions can override the convention.
+ *
+ * **Tick mode.** Ticks within the in-progress bar do NOT shift the day
+ * boundary (per the runtime invariant that ticks happen inside the
+ * current bar); the emitted value is the cached SMA of the already-
+ * committed days. The next close re-folds the bar into the in-progress
+ * day aggregate.
+ *
+ * **NaN.** Bars with non-finite `high` / `low` / `time` are skipped
+ * (no aggregation, no commit); the output reflects only the previously
+ * committed days.
+ *
+ * @formula  out[t] = mean( (dailyHigh − dailyLow) over the last `length`
+ *           completed UTC days, in price units )
+ * @warmup   length daily bars
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const r = ta.adr({ length: 14 });
+ *     // plot(r);
+ */
+export function adr(slotId, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        const length = opts?.length ?? DEFAULT_LENGTH;
+        slot = initSlot(length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const { high, low, time } = ctx.stream.bar;
+    if (ctx.isTick) {
+        // Tick replay does NOT touch the day aggregate or the rolling
+        // sum — those are snapshots of the last close. The output is the
+        // committed SMA (NaN until warm).
+        slot.outBuffer.replaceHead(emit(slot));
+    }
+    else {
+        slot.outBuffer.append(closeStep(slot, high, low, time));
+    }
+    return slot.series;
+}
+//# sourceMappingURL=adr.js.map

package/dist/ta/adr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.js","sourceRoot":"","sources":["../../src/ta/adr.ts"],"names":[],"mappings":"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"}