@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/rsi.js

@@ -0,0 +1,166 @@
+// 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/rsi.ts
+//   (commit d2d1043c1b039f66d2f3674526d303d31cf2f1e0, © 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, makeShiftedSeriesView } from "../seriesView.js";
+import { wilderStep } from "./lib/wilderSmoothing.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.rsi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        kind: "ta.rsi",
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        seedGainSum: 0,
+        seedLossSum: 0,
+        diffCount: 0,
+        avgGain: Number.NaN,
+        avgLoss: Number.NaN,
+        prevSrc: Number.NaN,
+        prevClosedSrc: Number.NaN,
+        shiftedViews: new Map(),
+    };
+}
+function viewForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.series;
+    let view = slot.shiftedViews.get(offset);
+    if (view === undefined) {
+        view = makeShiftedSeriesView(slot.outBuffer, offset);
+        slot.shiftedViews.set(offset, view);
+    }
+    return view;
+}
+function rsiFromAvgs(avgGain, avgLoss) {
+    if (avgLoss === 0)
+        return 100;
+    return 100 - 100 / (1 + avgGain / avgLoss);
+}
+function closeValue(slot, src) {
+    if (!Number.isFinite(src)) {
+        // Skip the diff; hold prior values forward.
+        if (Number.isFinite(slot.avgGain) && Number.isFinite(slot.avgLoss)) {
+            return rsiFromAvgs(slot.avgGain, slot.avgLoss);
+        }
+        return Number.NaN;
+    }
+    if (!Number.isFinite(slot.prevSrc)) {
+        slot.prevSrc = src;
+        slot.prevClosedSrc = src;
+        return Number.NaN;
+    }
+    const diff = src - slot.prevSrc;
+    const gain = diff > 0 ? diff : 0;
+    const loss = diff < 0 ? -diff : 0;
+    slot.prevClosedSrc = slot.prevSrc;
+    slot.prevSrc = src;
+    slot.diffCount += 1;
+    if (slot.diffCount < slot.length) {
+        slot.seedGainSum += gain;
+        slot.seedLossSum += loss;
+        return Number.NaN;
+    }
+    if (slot.diffCount === slot.length) {
+        slot.seedGainSum += gain;
+        slot.seedLossSum += loss;
+        slot.avgGain = slot.seedGainSum / slot.length;
+        slot.avgLoss = slot.seedLossSum / slot.length;
+        return rsiFromAvgs(slot.avgGain, slot.avgLoss);
+    }
+    slot.avgGain = wilderStep(slot.avgGain, gain, slot.length);
+    slot.avgLoss = wilderStep(slot.avgLoss, loss, slot.length);
+    return rsiFromAvgs(slot.avgGain, slot.avgLoss);
+}
+function tickValue(slot, src) {
+    if (!Number.isFinite(src) || !Number.isFinite(slot.prevClosedSrc)) {
+        if (Number.isFinite(slot.avgGain) && Number.isFinite(slot.avgLoss)) {
+            return rsiFromAvgs(slot.avgGain, slot.avgLoss);
+        }
+        return Number.NaN;
+    }
+    // Replay the most recent diff using the (frozen) prior closed avgs.
+    // We need pre-update avgs: at close we already overwrote `avgGain` /
+    // `avgLoss`. So we reverse the Wilder step to recover them.
+    if (slot.diffCount < slot.length) {
+        // During seeding: simulate the seed completing with this tick.
+        const diff = src - slot.prevClosedSrc;
+        const gain = diff > 0 ? diff : 0;
+        const loss = diff < 0 ? -diff : 0;
+        const provisionalCount = slot.diffCount + 1;
+        if (provisionalCount < slot.length)
+            return Number.NaN;
+        const provGain = (slot.seedGainSum + gain) / slot.length;
+        const provLoss = (slot.seedLossSum + loss) / slot.length;
+        return rsiFromAvgs(provGain, provLoss);
+    }
+    // Post-warmup: reverse the most recent Wilder step to get the prior-
+    // close avgs, then apply this tick's diff against those.
+    const diffClosed = slot.prevSrc - slot.prevClosedSrc;
+    const closedGain = diffClosed > 0 ? diffClosed : 0;
+    const closedLoss = diffClosed < 0 ? -diffClosed : 0;
+    const priorAvgGain = (slot.avgGain * slot.length - closedGain) / (slot.length - 1);
+    const priorAvgLoss = (slot.avgLoss * slot.length - closedLoss) / (slot.length - 1);
+    const diff = src - slot.prevClosedSrc;
+    const gain = diff > 0 ? diff : 0;
+    const loss = diff < 0 ? -diff : 0;
+    const provGain = wilderStep(priorAvgGain, gain, slot.length);
+    const provLoss = wilderStep(priorAvgLoss, loss, slot.length);
+    return rsiFromAvgs(provGain, provLoss);
+}
+/**
+ * Wilder's Relative Strength Index. Output range `[0, 100]`. First
+ * `length` bars NaN (no diff for bar 0, then a seed window of
+ * `length` diffs). Output is `100 − 100 / (1 + RS)` with
+ * `RS = avgGain / avgLoss`; `avgLoss = 0` → RSI = 100.
+ *
+ * @formula  diff[t] = source[t] − source[t − 1] ;
+ *           seed at bar `length` = simple mean of first `length` diffs ;
+ *           avgGain[t] = (avgGain[t − 1] · (length − 1) + gain[t]) / length ;
+ *           same for avgLoss ;
+ *           RSI = 100 − 100 / (1 + avgGain / avgLoss)
+ * @warmup   length
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts the returned series so `series.current` reads
+ * the value `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const r = ta.rsi("slot", bar.close, 14);
+ *     // const head = r.current;
+ *     // const lagged = ta.rsi("slot2", bar.close, 14, { offset: 5 });
+ */
+export function rsi(slotId, source, length, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(tickValue(slot, src));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, src));
+    }
+    return viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=rsi.js.map

package/dist/ta/rsi.js.map

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

package/dist/ta/rvgi.d.ts

@@ -0,0 +1,27 @@
+import type { RvgiOpts, RvgiResult } from "@invinite-org/chartlang-core";
+/**
+ * Relative Vigor Index (John Ehlers, 2002). Per-bar 4-bar weighted
+ * sum of `(close − open)` (numerator) and `(high − low)` (denominator),
+ * each smoothed via an SMA over `length` bars; `rvgi = numSma /
+ * denSma`. The signal line is a 4-bar `(1, 2, 2, 1) / 6` weighted sum
+ * of the rvgi line. Defaults `length = 10`. Composes 2 `ta.sma`
+ * sub-slots (`${slotId}/numSma`, `${slotId}/denSma`).
+ *
+ * Flat-range bars (denominator SMA = 0) emit NaN at `rvgi`; that NaN
+ * propagates into the signal's 4-bar window.
+ *
+ * @formula  coN = closes[t − N] − opens[t − N] ; hlN = highs[t − N] − lows[t − N] ;
+ *           num = (co0 + 2·co1 + 2·co2 + co3) / 6 ; den = (hl0 + 2·hl1 + 2·hl2 + hl3) / 6 ;
+ *           rvgi   = sma(num, length) / sma(den, length) ; NaN on den === 0 ;
+ *           signal = (rvgi[0] + 2·rvgi[1] + 2·rvgi[2] + rvgi[3]) / 6
+ * @warmup   length + 3 (numerator / denominator defined at bar 3 ; sma defined `length − 1` bars later ; signal needs another 3)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const r = ta.rvgi("slot");
+ *     // plot(r.rvgi); plot(r.signal);
+ */
+export declare function rvgi(slotId: string, opts?: RvgiOpts): RvgiResult;
+//# sourceMappingURL=rvgi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rvgi.d.ts","sourceRoot":"","sources":["../../src/ta/rvgi.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAU,MAAM,8BAA8B,CAAC;AAsEjF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAwDhE"}

package/dist/ta/rvgi.js

@@ -0,0 +1,139 @@
+// 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/rvgi.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. Composition: two `ta.sma` sub-slots
+// (`${slotId}/numSma`, `${slotId}/denSma`) for the numerator /
+// denominator smoothing. The per-bar 4-bar `(1, 2, 2, 1) / 6`
+// weighted sum + the 4-bar signal weighted sum are bespoke (no
+// registry helper exposes that exact weighted window).
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { sma } from "./sma.js";
+const DEFAULT_LENGTH = 10;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.rvgi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const rvgiBuf = new Float64RingBuffer(capacity);
+    const signalBuf = new Float64RingBuffer(capacity);
+    return {
+        result: null,
+        rvgiBuf,
+        signalBuf,
+        rvgiSeries: makeSeriesView(rvgiBuf),
+        signalSeries: makeSeriesView(signalBuf),
+        length,
+        coWindow: new Float64RingBuffer(4),
+        hlWindow: new Float64RingBuffer(4),
+        rvgiWindow: new Float64RingBuffer(4),
+    };
+}
+/**
+ * 4-bar `(1, 2, 2, 1) / 6` weighted sum over a `Float64RingBuffer`
+ * with `at(0)` = head. Returns NaN if the ring isn't full or any
+ * value is non-finite.
+ */
+function weighted4(ring) {
+    if (ring.length < 4)
+        return Number.NaN;
+    const v0 = ring.at(0);
+    const v1 = ring.at(1);
+    const v2 = ring.at(2);
+    const v3 = ring.at(3);
+    if (!Number.isFinite(v0) ||
+        !Number.isFinite(v1) ||
+        !Number.isFinite(v2) ||
+        !Number.isFinite(v3)) {
+        return Number.NaN;
+    }
+    return (v0 + 2 * v1 + 2 * v2 + v3) / 6;
+}
+/**
+ * Relative Vigor Index (John Ehlers, 2002). Per-bar 4-bar weighted
+ * sum of `(close − open)` (numerator) and `(high − low)` (denominator),
+ * each smoothed via an SMA over `length` bars; `rvgi = numSma /
+ * denSma`. The signal line is a 4-bar `(1, 2, 2, 1) / 6` weighted sum
+ * of the rvgi line. Defaults `length = 10`. Composes 2 `ta.sma`
+ * sub-slots (`${slotId}/numSma`, `${slotId}/denSma`).
+ *
+ * Flat-range bars (denominator SMA = 0) emit NaN at `rvgi`; that NaN
+ * propagates into the signal's 4-bar window.
+ *
+ * @formula  coN = closes[t − N] − opens[t − N] ; hlN = highs[t − N] − lows[t − N] ;
+ *           num = (co0 + 2·co1 + 2·co2 + co3) / 6 ; den = (hl0 + 2·hl1 + 2·hl2 + hl3) / 6 ;
+ *           rvgi   = sma(num, length) / sma(den, length) ; NaN on den === 0 ;
+ *           signal = (rvgi[0] + 2·rvgi[1] + 2·rvgi[2] + rvgi[3]) / 6
+ * @warmup   length + 3 (numerator / denominator defined at bar 3 ; sma defined `length − 1` bars later ; signal needs another 3)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const r = ta.rvgi("slot");
+ *     // plot(r.rvgi); plot(r.signal);
+ */
+export function rvgi(slotId, opts) {
+    const ctx = getCtx();
+    const length = opts?.length ?? DEFAULT_LENGTH;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const { open, high, low, close } = ctx.stream.bar;
+    const co = Number.isFinite(close) && Number.isFinite(open) ? close - open : Number.NaN;
+    const hl = Number.isFinite(high) && Number.isFinite(low) ? high - low : Number.NaN;
+    if (ctx.isTick) {
+        slot.coWindow.replaceHead(co);
+        slot.hlWindow.replaceHead(hl);
+    }
+    else {
+        slot.coWindow.append(co);
+        slot.hlWindow.append(hl);
+    }
+    const numerator = weighted4(slot.coWindow);
+    const denominator = weighted4(slot.hlWindow);
+    const numSeries = sma(`${slotId}/numSma`, numerator, length);
+    const denSeries = sma(`${slotId}/denSma`, denominator, length);
+    const numSma = numSeries.current;
+    const denSma = denSeries.current;
+    let rvgiValue;
+    if (!Number.isFinite(numSma) || !Number.isFinite(denSma) || denSma === 0) {
+        rvgiValue = Number.NaN;
+    }
+    else {
+        rvgiValue = numSma / denSma;
+    }
+    if (ctx.isTick) {
+        slot.rvgiWindow.replaceHead(rvgiValue);
+        slot.rvgiBuf.replaceHead(rvgiValue);
+    }
+    else {
+        slot.rvgiWindow.append(rvgiValue);
+        slot.rvgiBuf.append(rvgiValue);
+    }
+    const signalValue = weighted4(slot.rvgiWindow);
+    if (ctx.isTick)
+        slot.signalBuf.replaceHead(signalValue);
+    else
+        slot.signalBuf.append(signalValue);
+    if (slot.result === null) {
+        slot.result = Object.freeze({
+            rvgi: slot.rvgiSeries,
+            signal: slot.signalSeries,
+        });
+    }
+    return slot.result;
+}
+//# sourceMappingURL=rvgi.js.map

package/dist/ta/rvgi.js.map

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

package/dist/ta/rvi.d.ts

@@ -0,0 +1,31 @@
+import type { RviOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Relative Volatility Index — sub-pane oscillator bounded `[0, 100]`.
+ * Like RSI but uses rolling stddev of the source instead of absolute
+ * close changes for the magnitude, EMA-smoothed per TradingView's
+ * `ta.rvi` reference. Composes `ta.ema` via two sub-slots
+ * (`${slotId}/upEma`, `${slotId}/downEma`) — a fix to EMA's
+ * recurrence flows in for free. NaN when either EMA arm is NaN or
+ * when both arms are zero (zero-denominator).
+ *
+ * @formula  sigma[t]  = stddev(source[t − length + 1..= t]) ;
+ *           upRaw[t]  = source[t] > source[t − 1] ? sigma[t] : 0 ;
+ *           downRaw[t] = source[t] < source[t − 1] ? sigma[t] : 0 ;
+ *           upEma     = EMA(length)(upRaw) ;
+ *           downEma   = EMA(length)(downRaw) ;
+ *           rvi[t]    = 100 · upEma[t] / (upEma[t] + downEma[t])
+ * @warmup   2 · length − 1
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts the returned series so `series.current` reads
+ * the value `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const r = ta.rvi(bar.close, 10);
+ *     // plot(r);
+ */
+export declare function rvi(slotId: string, source: ScalarOrSeries, length: number, opts?: RviOpts): Series<number>;
+//# sourceMappingURL=rvi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rvi.d.ts","sourceRoot":"","sources":["../../src/ta/rvi.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAMpE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA8H5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,CAAC,CAoChB"}

package/dist/ta/rvi.js

@@ -0,0 +1,195 @@
+// 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/rvi.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. The up/down EMA arms compose `ta.ema` via
+// sub-slots `${slotId}/upEma` / `${slotId}/downEma` so the EMA
+// recurrence + warmup semantics flow in by reference.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { ema } from "./ema.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.rvi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        sigmaWindow: new Float64RingBuffer(length),
+        sumX: 0,
+        sumX2: 0,
+        prevSrc: Number.NaN,
+        shiftedViews: new Map(),
+    };
+}
+function viewForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.series;
+    let view = slot.shiftedViews.get(offset);
+    if (view === undefined) {
+        view = makeShiftedSeriesView(slot.outBuffer, offset);
+        slot.shiftedViews.set(offset, view);
+    }
+    return view;
+}
+function windowStdDev(n, sumX, sumX2) {
+    const mean = sumX / n;
+    const variance = sumX2 / n - mean * mean;
+    return Math.sqrt(Math.max(0, variance));
+}
+/** Fold a new source value into the sigma-window running sums. */
+function appendToSigmaWindow(slot, src) {
+    if (slot.sigmaWindow.length < slot.sigmaWindow.capacity) {
+        slot.sigmaWindow.append(src);
+        if (Number.isFinite(src)) {
+            slot.sumX += src;
+            slot.sumX2 += src * src;
+        }
+        else {
+            slot.sumX = Number.NaN;
+            slot.sumX2 = Number.NaN;
+        }
+        if (slot.sigmaWindow.length < slot.sigmaWindow.capacity)
+            return Number.NaN;
+        if (!Number.isFinite(slot.sumX))
+            return Number.NaN;
+        return windowStdDev(slot.sigmaWindow.length, slot.sumX, slot.sumX2);
+    }
+    const outgoing = slot.sigmaWindow.at(slot.sigmaWindow.length - 1);
+    slot.sigmaWindow.append(src);
+    if (!Number.isFinite(src)) {
+        slot.sumX = Number.NaN;
+        slot.sumX2 = Number.NaN;
+        return Number.NaN;
+    }
+    if (!Number.isFinite(slot.sumX) || !Number.isFinite(outgoing)) {
+        // A previous NaN poisoned the running sums; rebuild from the
+        // live window (NaN values short-circuit the result to NaN).
+        let sumX = 0;
+        let sumX2 = 0;
+        for (let i = 0; i < slot.sigmaWindow.length; i += 1) {
+            const v = slot.sigmaWindow.at(i);
+            if (!Number.isFinite(v)) {
+                slot.sumX = Number.NaN;
+                slot.sumX2 = Number.NaN;
+                return Number.NaN;
+            }
+            sumX += v;
+            sumX2 += v * v;
+        }
+        slot.sumX = sumX;
+        slot.sumX2 = sumX2;
+    }
+    else {
+        slot.sumX = slot.sumX - outgoing + src;
+        slot.sumX2 = slot.sumX2 - outgoing * outgoing + src * src;
+    }
+    return windowStdDev(slot.sigmaWindow.length, slot.sumX, slot.sumX2);
+}
+/** Sigma at the tick boundary against the closed sigma-window state. */
+function tickSigma(slot, src) {
+    if (slot.sigmaWindow.length < slot.sigmaWindow.capacity)
+        return Number.NaN;
+    if (!Number.isFinite(src))
+        return Number.NaN;
+    const oldestInHead = slot.sigmaWindow.at(0);
+    const sumX = slot.sumX - oldestInHead + src;
+    const sumX2 = slot.sumX2 - oldestInHead * oldestInHead + src * src;
+    return windowStdDev(slot.sigmaWindow.length, sumX, sumX2);
+}
+function classify(sigma, diff) {
+    if (!Number.isFinite(sigma) || !Number.isFinite(diff)) {
+        return { up: Number.NaN, down: Number.NaN };
+    }
+    return {
+        up: diff > 0 ? sigma : 0,
+        down: diff < 0 ? sigma : 0,
+    };
+}
+function rviValue(upEma, downEma) {
+    if (!Number.isFinite(upEma) || !Number.isFinite(downEma))
+        return Number.NaN;
+    const total = upEma + downEma;
+    if (total === 0)
+        return Number.NaN;
+    return (100 * upEma) / total;
+}
+/**
+ * Relative Volatility Index — sub-pane oscillator bounded `[0, 100]`.
+ * Like RSI but uses rolling stddev of the source instead of absolute
+ * close changes for the magnitude, EMA-smoothed per TradingView's
+ * `ta.rvi` reference. Composes `ta.ema` via two sub-slots
+ * (`${slotId}/upEma`, `${slotId}/downEma`) — a fix to EMA's
+ * recurrence flows in for free. NaN when either EMA arm is NaN or
+ * when both arms are zero (zero-denominator).
+ *
+ * @formula  sigma[t]  = stddev(source[t − length + 1..= t]) ;
+ *           upRaw[t]  = source[t] > source[t − 1] ? sigma[t] : 0 ;
+ *           downRaw[t] = source[t] < source[t − 1] ? sigma[t] : 0 ;
+ *           upEma     = EMA(length)(upRaw) ;
+ *           downEma   = EMA(length)(downRaw) ;
+ *           rvi[t]    = 100 · upEma[t] / (upEma[t] + downEma[t])
+ * @warmup   2 · length − 1
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts the returned series so `series.current` reads
+ * the value `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const r = ta.rvi(bar.close, 10);
+ *     // plot(r);
+ */
+export function rvi(slotId, source, length, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    if (ctx.isTick) {
+        const sigma = tickSigma(slot, src);
+        const diff = src - slot.prevSrc;
+        const { up, down } = classify(sigma, diff);
+        // Still drive the sub-slot EMAs so their tick-mode head stays
+        // consistent with the closed state on a subsequent close.
+        const upSeries = ema(`${slotId}/upEma`, up, slot.length);
+        const downSeries = ema(`${slotId}/downEma`, down, slot.length);
+        // NaN source short-circuits to NaN output regardless of how the
+        // EMA arms forward-fill internally — RVI is undefined when the
+        // current sample isn't measurable.
+        const value = Number.isFinite(src)
+            ? rviValue(upSeries.current, downSeries.current)
+            : Number.NaN;
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        const sigma = appendToSigmaWindow(slot, src);
+        const diff = src - slot.prevSrc;
+        const { up, down } = classify(sigma, diff);
+        const upSeries = ema(`${slotId}/upEma`, up, slot.length);
+        const downSeries = ema(`${slotId}/downEma`, down, slot.length);
+        const value = Number.isFinite(src)
+            ? rviValue(upSeries.current, downSeries.current)
+            : Number.NaN;
+        slot.outBuffer.append(value);
+        slot.prevSrc = src;
+    }
+    return viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=rvi.js.map

package/dist/ta/rvi.js.map

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

package/dist/ta/sessionVolumeProfile.d.ts

@@ -0,0 +1,23 @@
+import type { SessionVolumeProfileOpts, SessionVolumeProfileResult } from "@invinite-org/chartlang-core";
+/**
+ * Session Volume Profile — bucketizes the current session's volume
+ * by price, resetting when `bar.time` crosses the active session
+ * boundary.
+ *
+ * @formula  Port of invinite session-vp: find the current session
+ *           window, bucket volume by price, then derive POC / value-
+ *           area high / value-area low via the shared volume-profile
+ *           pipeline.
+ * @anchors  `syminfo.session` descriptor, or `opts.sessionStart`
+ *           override when provided.
+ * @warmup   NaN until a session window has positive volume; missing
+ *           `syminfo.session` falls back to UTC-day boundaries.
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { plot, ta } from "@invinite-org/chartlang-core";
+ *     // const vp = ta.sessionVolumeProfile({ rowSize: 24 });
+ *     // plot(vp.poc, { style: { kind: "horizontal-histogram", buckets: vp.buckets } });
+ */
+export declare function sessionVolumeProfile(slotId: string, opts?: SessionVolumeProfileOpts): SessionVolumeProfileResult;
+//# sourceMappingURL=sessionVolumeProfile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionVolumeProfile.d.ts","sourceRoot":"","sources":["../../src/ta/sessionVolumeProfile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,wBAAwB,EACxB,0BAA0B,EAC7B,MAAM,8BAA8B,CAAC;AAwJtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,wBAAwB,GAChC,0BAA0B,CAwB5B"}