@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/valuewhen.js

@@ -0,0 +1,115 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// No invinite source — semantics per Pine `ta.valuewhen`. See PLAN.md §3.1.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.valuewhen called outside an active script step");
+    }
+    return ctx;
+}
+function readBoolean(condition) {
+    return condition.current;
+}
+function initSlot(occurrence, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    const ringCapacity = occurrence + 1;
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        shiftedSeries: new Map(),
+        occurrence,
+        capacity: ringCapacity,
+        ring: [],
+        matchCount: 0,
+        prevRing: [],
+        prevMatchCount: 0,
+    };
+}
+function emitFromState(occurrence, ring, matchCount) {
+    if (matchCount < occurrence + 1)
+        return Number.NaN;
+    // The ring is oldest-first within its capacity (occurrence + 1).
+    // The `occurrence`-th most recent match is the OLDEST entry in a
+    // full ring — i.e. ring[0].
+    return ring[0];
+}
+function closeValue(slot, src, fired) {
+    slot.prevRing = slot.ring.slice();
+    slot.prevMatchCount = slot.matchCount;
+    if (fired) {
+        slot.ring.push(src);
+        if (slot.ring.length > slot.capacity)
+            slot.ring.shift();
+        slot.matchCount += 1;
+    }
+    return emitFromState(slot.occurrence, slot.ring, slot.matchCount);
+}
+function tickValue(slot, src, fired) {
+    // Replay against the snapshot taken before the most recent close.
+    const ring = slot.prevRing.slice();
+    let count = slot.prevMatchCount;
+    if (fired) {
+        ring.push(src);
+        if (ring.length > slot.capacity)
+            ring.shift();
+        count += 1;
+    }
+    return emitFromState(slot.occurrence, ring, count);
+}
+/**
+ * Source value at the bar of the n-th most recent `condition === true`.
+ * `occurrence === 0` returns the value at the most recent match;
+ * `occurrence === 1` the second most recent; etc. NaN until
+ * `occurrence + 1` matches have been seen.
+ *
+ * NaN-source at the matching bar produces NaN in the ring entry, which
+ * surfaces as NaN once that entry is the one emitted. Matches NaN-source
+ * semantics in Pine.
+ *
+ * @formula  out[t] = source[bar of n-th most recent condition true],
+ *           NaN until `occurrence + 1` matches
+ * @warmup   bar of the `occurrence + 1`-th match (data-dependent)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const fast = ta.sma(bar.close, 10);
+ *     // const slow = ta.sma(bar.close, 30);
+ *     // const onCross = ta.valuewhen(ta.crossover(fast, slow), bar.close);
+ *     // plot(onCross);
+ */
+export function valuewhen(slotId, condition, source, occurrence = 0, opts = {}) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(occurrence, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const fired = readBoolean(condition);
+    const src = readSourceValue(source);
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(tickValue(slot, src, fired));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, src, fired));
+    }
+    const offset = opts.offset ?? 0;
+    if (offset === 0)
+        return slot.series;
+    const shifted = slot.shiftedSeries.get(offset);
+    if (shifted !== undefined)
+        return shifted;
+    const next = makeShiftedSeriesView(slot.outBuffer, offset);
+    slot.shiftedSeries.set(offset, next);
+    return next;
+}
+//# sourceMappingURL=valuewhen.js.map

package/dist/ta/valuewhen.js.map

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

package/dist/ta/visibleRangeVolumeProfile.d.ts

@@ -0,0 +1,26 @@
+import type { VisibleRangeVolumeProfileOpts, VisibleRangeVolumeProfileResult } from "@invinite-org/chartlang-core";
+/**
+ * Visible-Range Volume Profile — buckets the current visible range's
+ * volume by price, emits a `horizontal-histogram`, and returns cached
+ * POC / VAH / VAL series.
+ *
+ * The Phase 5 OSS runtime supplies the visible range through
+ * `bar.viewport`, populated as the latest 100 bars ending at the
+ * current head. Real chart viewport injection is deferred to adapter
+ * integrations in Phase 6.
+ *
+ * @formula  Port of invinite visible-range-vp: slice visible candles,
+ *           bucket volume by price, then derive POC / value-area high /
+ *           value-area low via the shared volume-profile pipeline.
+ * @anchors  Visible range = `(bar.viewport.fromTime, bar.viewport.toTime)`.
+ * @warmup   First 2 bars for non-degenerate bucketization; constant-price
+ *           positive-volume input emits a one-bucket fallback.
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const vp = ta.visibleRangeVolumeProfile({ rowSize: 24 });
+ *     // plot(vp.poc, { title: "VRVP POC" });
+ */
+export declare function visibleRangeVolumeProfile(slotId: string, opts?: VisibleRangeVolumeProfileOpts): VisibleRangeVolumeProfileResult;
+//# sourceMappingURL=visibleRangeVolumeProfile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visibleRangeVolumeProfile.d.ts","sourceRoot":"","sources":["../../src/ta/visibleRangeVolumeProfile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,6BAA6B,EAC7B,+BAA+B,EAClC,MAAM,8BAA8B,CAAC;AAuFtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,6BAA6B,GACrC,+BAA+B,CAsBjC"}

package/dist/ta/visibleRangeVolumeProfile.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// Ported from ../invinite/src/components/trading-chart/indicators/visible-range-volume-profile.ts
+//   @ 3234c8c0c3f9880d9d1e3a3ee63ebd55ddd535f4.
+// Translated, not transcribed — Series<T> shape, opts.offset, JSDoc.
+// See packages/runtime/src/ta/CLAUDE.md for the port convention.
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { commitVolumeProfileSnapshot, createVolumeProfileCore, emitVolumeProfileHistogram, resolveVolumeProfileSnapshot, volumeProfileConfigFromOpts, } from "./lib/volume-profile/index.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.visibleRangeVolumeProfile called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const core = createVolumeProfileCore(capacity);
+    const slot = {
+        ...core,
+        result: Object.freeze({
+            get buckets() {
+                return slot.buckets;
+            },
+            poc: makeSeriesView(core.pocBuffer),
+            valHigh: makeSeriesView(core.valHighBuffer),
+            valLow: makeSeriesView(core.valLowBuffer),
+        }),
+        shiftedResults: new Map(),
+    };
+    return slot;
+}
+function resultForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.result;
+    let cached = slot.shiftedResults.get(offset);
+    if (cached === undefined) {
+        cached = Object.freeze({
+            get buckets() {
+                return slot.buckets;
+            },
+            poc: makeShiftedSeriesView(slot.pocBuffer, offset),
+            valHigh: makeShiftedSeriesView(slot.valHighBuffer, offset),
+            valLow: makeShiftedSeriesView(slot.valLowBuffer, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+function collectBars(ctx) {
+    const { ohlcv } = ctx.stream;
+    const { fromTime, toTime } = ctx.stream.bar.viewport;
+    const bars = [];
+    for (let lookback = ohlcv.close.length - 1; lookback >= 0; lookback -= 1) {
+        const time = ohlcv.time.at(lookback);
+        if (time < fromTime || time > toTime)
+            continue;
+        bars.push({
+            close: ohlcv.close.at(lookback),
+            high: ohlcv.high.at(lookback),
+            low: ohlcv.low.at(lookback),
+            open: ohlcv.open.at(lookback),
+            time,
+            volume: ohlcv.volume.at(lookback),
+        });
+    }
+    return bars;
+}
+/**
+ * Visible-Range Volume Profile — buckets the current visible range's
+ * volume by price, emits a `horizontal-histogram`, and returns cached
+ * POC / VAH / VAL series.
+ *
+ * The Phase 5 OSS runtime supplies the visible range through
+ * `bar.viewport`, populated as the latest 100 bars ending at the
+ * current head. Real chart viewport injection is deferred to adapter
+ * integrations in Phase 6.
+ *
+ * @formula  Port of invinite visible-range-vp: slice visible candles,
+ *           bucket volume by price, then derive POC / value-area high /
+ *           value-area low via the shared volume-profile pipeline.
+ * @anchors  Visible range = `(bar.viewport.fromTime, bar.viewport.toTime)`.
+ * @warmup   First 2 bars for non-degenerate bucketization; constant-price
+ *           positive-volume input emits a one-bucket fallback.
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const vp = ta.visibleRangeVolumeProfile({ rowSize: 24 });
+ *     // plot(vp.poc, { title: "VRVP POC" });
+ */
+export function visibleRangeVolumeProfile(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 snapshot = resolveVolumeProfileSnapshot({
+        bars: collectBars(ctx),
+        bucketColor: opts?.bucketColor,
+        config: volumeProfileConfigFromOpts(opts ?? {}),
+    });
+    commitVolumeProfileSnapshot(slot, ctx.isTick, snapshot);
+    emitVolumeProfileHistogram(ctx, slotId, "Visible Range Volume Profile", snapshot.poc, snapshot.buckets);
+    return resultForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=visibleRangeVolumeProfile.js.map

package/dist/ta/visibleRangeVolumeProfile.js.map

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

package/dist/ta/vol.d.ts

@@ -0,0 +1,23 @@
+import type { Series, VolOpts } from "@invinite-org/chartlang-core";
+/**
+ * Volume passthrough — emits `bar.volume` as a `Series<number>` so
+ * script authors can compose it like any other primitive (e.g. plot
+ * as a histogram). Stateless math; the slot exists purely to back
+ * the cached `Series<T>` Proxy + the per-callsite output buffer the
+ * compiler-injected slot id keys.
+ *
+ * Tick-mode reads the live `bar.volume`, replacing the head — volume
+ * can change mid-bar in real time.
+ *
+ * @formula  out[t] = bar.volume[t]
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-runtime";
+ *     // const v = ta.vol("slot");
+ *     // plot(v, { style: { kind: "histogram", baseline: 0 } });
+ */
+export declare function vol(slotId: string, _opts?: VolOpts): Series<number>;
+//# sourceMappingURL=vol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vol.d.ts","sourceRoot":"","sources":["../../src/ta/vol.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAwBpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAcnE"}

package/dist/ta/vol.js

@@ -0,0 +1,58 @@
+// 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/vol.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.
+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.vol called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return { outBuffer, series: makeSeriesView(outBuffer) };
+}
+/**
+ * Volume passthrough — emits `bar.volume` as a `Series<number>` so
+ * script authors can compose it like any other primitive (e.g. plot
+ * as a histogram). Stateless math; the slot exists purely to back
+ * the cached `Series<T>` Proxy + the per-callsite output buffer the
+ * compiler-injected slot id keys.
+ *
+ * Tick-mode reads the live `bar.volume`, replacing the head — volume
+ * can change mid-bar in real time.
+ *
+ * @formula  out[t] = bar.volume[t]
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-runtime";
+ *     // const v = ta.vol("slot");
+ *     // plot(v, { style: { kind: "histogram", baseline: 0 } });
+ */
+export function vol(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 value = ctx.stream.bar.volume;
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        slot.outBuffer.append(value);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=vol.js.map

package/dist/ta/vol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vol.js","sourceRoot":"","sources":["../../src/ta/vol.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AAIzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAe;IAC/C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAwB,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;IACpC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/ta/volatilityStop.d.ts

@@ -0,0 +1,36 @@
+import type { VolatilityStopOpts, VolatilityStopResult } from "@invinite-org/chartlang-core";
+/**
+ * Volatility Stop — PSAR-like trend-following stop driven by ATR
+ * instead of acceleration factors. Trend up: `stop[i] = max(prevStop,
+ * src − multiplier · atr)`; flip to down when `src < stop[i]`, reset
+ * to `src + multiplier · atr`. Trend down symmetric. Reads
+ * `bar.close` as source (Pine `ta.vstop` convention — invinite's
+ * `source` opt is omitted; a `source` opt could land in a follow-up).
+ * Composes Phase-1 `ta.atr` at sub-slot `${slotId}/atr`. Returns a
+ * cached `{ value, direction }` record (same identity every bar).
+ *
+ * `direction` is `+1` (uptrend → stop is BELOW price), `-1`
+ * (downtrend → stop is ABOVE price), NaN during warmup or NaN-
+ * suspension. Warmup is `length` (ATR's warmup) — the FIRST warm bar
+ * emits NaN (need a prior close to decide direction); the SECOND
+ * warm bar seeds direction from `src[i] vs src[i-1]`.
+ *
+ * NaN ATR or NaN src → NaN outputs; local state freezes so the next
+ * finite bar resumes from the prior closed state. Tick-mode replays
+ * the recurrence from the snapshot captured at the start of the
+ * current bar (mirrors PSAR / Supertrend).
+ *
+ * @formula  up   : value = max(prevStop, src − multiplier · atr) ; flip to down on src < value ;
+ *           down : value = min(prevStop, src + multiplier · atr) ; flip to up   on src > value
+ * @warmup   length
+ * @anchors  length, multiplier
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const v = ta.volatilityStop({ length: 20, multiplier: 2 });
+ *     // plot(v.value);
+ */
+export declare function volatilityStop(slotId: string, opts?: VolatilityStopOpts): VolatilityStopResult;
+//# sourceMappingURL=volatilityStop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"volatilityStop.d.ts","sourceRoot":"","sources":["../../src/ta/volatilityStop.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AA2L7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAsB9F"}

package/dist/ta/volatilityStop.js

@@ -0,0 +1,203 @@
+// 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/volatility-stop.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. Volatility Stop composes Phase-1 `ta.atr` at
+// sub-slot `${slotId}/atr` (mirrors Supertrend); the source is
+// hard-coded to `bar.close` (Pine `ta.vstop` convention; invinite's
+// `source` field is deliberately dropped). The recurrence runs
+// incrementally one bar at a time; tick-mode replays the recurrence
+// from a per-bar snapshot of the state at the start of the current
+// bar so a partial-bar tick doesn't pollute the next close's flip
+// detection.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { atr } from "./atr.js";
+const DEFAULT_LENGTH = 20;
+const DEFAULT_MULTIPLIER = 2;
+const TREND_UP = 1;
+const TREND_DOWN = -1;
+const TREND_UNKNOWN = 0;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.volatilityStop called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity, length, multiplier) {
+    const valueBuffer = new Float64RingBuffer(capacity);
+    const directionBuffer = new Float64RingBuffer(capacity);
+    return {
+        outputs: Object.freeze({
+            value: makeSeriesView(valueBuffer),
+            direction: makeSeriesView(directionBuffer),
+        }),
+        valueBuffer,
+        directionBuffer,
+        length,
+        multiplier,
+        warmBarCount: 0,
+        direction: TREND_UNKNOWN,
+        prevStop: Number.NaN,
+        prevSrc: Number.NaN,
+        prevClosedWarmBarCount: 0,
+        prevClosedDirection: TREND_UNKNOWN,
+        prevClosedPrevStop: Number.NaN,
+        prevClosedPrevSrc: Number.NaN,
+    };
+}
+function snapshot(slot) {
+    slot.prevClosedWarmBarCount = slot.warmBarCount;
+    slot.prevClosedDirection = slot.direction;
+    slot.prevClosedPrevStop = slot.prevStop;
+    slot.prevClosedPrevSrc = slot.prevSrc;
+}
+/**
+ * One step of the Volatility Stop recurrence given the prior CLOSED-
+ * bar snapshot. Returns the new `(value, direction)` for this bar.
+ * Used by both close-side (which mutates the slot) and tick-side
+ * (which reads the snapshot, does NOT mutate the slot).
+ */
+function recurrenceStep(src, atrValue, multiplier, prevDirection, prevStop, prevSrc) {
+    if (prevDirection === TREND_UNKNOWN) {
+        // Second warm bar — decide initial direction from src[i] vs
+        // src[i-1]. Initial stop seeds from the deviation band.
+        const newDirection = src >= prevSrc ? TREND_UP : TREND_DOWN;
+        const stop = newDirection === TREND_UP ? src - multiplier * atrValue : src + multiplier * atrValue;
+        return {
+            value: stop,
+            direction: newDirection,
+            nextDirection: newDirection,
+            nextStop: stop,
+        };
+    }
+    if (prevDirection === TREND_UP) {
+        let next = src - multiplier * atrValue;
+        if (next < prevStop)
+            next = prevStop;
+        if (src < next) {
+            next = src + multiplier * atrValue;
+            return {
+                value: next,
+                direction: TREND_DOWN,
+                nextDirection: TREND_DOWN,
+                nextStop: next,
+            };
+        }
+        return { value: next, direction: TREND_UP, nextDirection: TREND_UP, nextStop: next };
+    }
+    // prevDirection === TREND_DOWN.
+    let next = src + multiplier * atrValue;
+    if (next > prevStop)
+        next = prevStop;
+    if (src > next) {
+        next = src - multiplier * atrValue;
+        return {
+            value: next,
+            direction: TREND_UP,
+            nextDirection: TREND_UP,
+            nextStop: next,
+        };
+    }
+    return { value: next, direction: TREND_DOWN, nextDirection: TREND_DOWN, nextStop: next };
+}
+function closeStep(slot, src, atrValue) {
+    // NaN suspends state: don't advance live fields. Snapshot stays
+    // pinned to the prior bar's state.
+    if (!Number.isFinite(src) || !Number.isFinite(atrValue)) {
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    snapshot(slot);
+    if (slot.warmBarCount === 0) {
+        // First warm bar — can't decide direction yet (need a prior
+        // src to compare). Seed `prevSrc` and emit NaN.
+        slot.warmBarCount = 1;
+        slot.prevSrc = src;
+        slot.direction = TREND_UNKNOWN;
+        slot.prevStop = Number.NaN;
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    const step = recurrenceStep(src, atrValue, slot.multiplier, slot.direction, slot.prevStop, slot.prevSrc);
+    slot.warmBarCount += 1;
+    slot.direction = step.nextDirection;
+    slot.prevStop = step.nextStop;
+    slot.prevSrc = src;
+    return { value: step.value, direction: step.direction };
+}
+function tickStep(slot, src, atrValue) {
+    if (!Number.isFinite(src) || !Number.isFinite(atrValue)) {
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    if (slot.prevClosedWarmBarCount === 0) {
+        // The current bar is the first warm bar — its tick replay is
+        // the seed (NaN, NaN — direction undecided).
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    const step = recurrenceStep(src, atrValue, slot.multiplier, slot.prevClosedDirection, slot.prevClosedPrevStop, slot.prevClosedPrevSrc);
+    return { value: step.value, direction: step.direction };
+}
+/**
+ * Volatility Stop — PSAR-like trend-following stop driven by ATR
+ * instead of acceleration factors. Trend up: `stop[i] = max(prevStop,
+ * src − multiplier · atr)`; flip to down when `src < stop[i]`, reset
+ * to `src + multiplier · atr`. Trend down symmetric. Reads
+ * `bar.close` as source (Pine `ta.vstop` convention — invinite's
+ * `source` opt is omitted; a `source` opt could land in a follow-up).
+ * Composes Phase-1 `ta.atr` at sub-slot `${slotId}/atr`. Returns a
+ * cached `{ value, direction }` record (same identity every bar).
+ *
+ * `direction` is `+1` (uptrend → stop is BELOW price), `-1`
+ * (downtrend → stop is ABOVE price), NaN during warmup or NaN-
+ * suspension. Warmup is `length` (ATR's warmup) — the FIRST warm bar
+ * emits NaN (need a prior close to decide direction); the SECOND
+ * warm bar seeds direction from `src[i] vs src[i-1]`.
+ *
+ * NaN ATR or NaN src → NaN outputs; local state freezes so the next
+ * finite bar resumes from the prior closed state. Tick-mode replays
+ * the recurrence from the snapshot captured at the start of the
+ * current bar (mirrors PSAR / Supertrend).
+ *
+ * @formula  up   : value = max(prevStop, src − multiplier · atr) ; flip to down on src < value ;
+ *           down : value = min(prevStop, src + multiplier · atr) ; flip to up   on src > value
+ * @warmup   length
+ * @anchors  length, multiplier
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const v = ta.volatilityStop({ length: 20, multiplier: 2 });
+ *     // plot(v.value);
+ */
+export function volatilityStop(slotId, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        const length = opts?.length ?? DEFAULT_LENGTH;
+        const multiplier = opts?.multiplier ?? DEFAULT_MULTIPLIER;
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, length, multiplier);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const atrSeries = atr(`${slotId}/atr`, slot.length);
+    const src = ctx.stream.bar.close;
+    const atrValue = atrSeries.current;
+    if (ctx.isTick) {
+        const { value, direction } = tickStep(slot, src, atrValue);
+        slot.valueBuffer.replaceHead(value);
+        slot.directionBuffer.replaceHead(direction);
+    }
+    else {
+        const { value, direction } = closeStep(slot, src, atrValue);
+        slot.valueBuffer.append(value);
+        slot.directionBuffer.append(direction);
+    }
+    return slot.outputs;
+}
+//# sourceMappingURL=volatilityStop.js.map

package/dist/ta/volatilityStop.js.map

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

package/dist/ta/vortex.d.ts

@@ -0,0 +1,30 @@
+import type { VortexOpts, VortexResult } from "@invinite-org/chartlang-core";
+/**
+ * Vortex Indicator (Botes & Siepman, 2010) — paired `+VI` / `−VI`
+ * trend-direction lines. Reads `bar.high` / `bar.low` / `bar.close`
+ * directly (mirrors Pine's `ta.vortex(length)` — no source param).
+ * Maintains rolling running-sum windows over the per-bar `vmPlus`,
+ * `vmMinus`, and TR series for O(1) per-bar updates. Returns a cached
+ * `{ plus, minus }` record (same identity every bar).
+ *
+ * @formula  TR[t]      = max(high − low, |high − prevClose|, |low − prevClose|) ;
+ *           vmPlus[t]  = |high[t] − low[t-1]| ;
+ *           vmMinus[t] = |low[t]  − high[t-1]| ;
+ *           plus[t]    = Σ(vmPlus, length)  / Σ(TR, length) ;
+ *           minus[t]   = Σ(vmMinus, length) / Σ(TR, length) ;
+ *           NaN when Σ(TR, length) === 0 (degenerate flat window).
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts both series in lockstep (PLAN.md §9.1) —
+ * `series.current` on each output returns the value `offset` bars ago.
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const v = ta.vortex("slot", 14);
+ *     // plot(v.plus);
+ *     // plot(v.minus);
+ */
+export declare function vortex(slotId: string, length: number, opts?: VortexOpts): VortexResult;
+//# sourceMappingURL=vortex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vortex.d.ts","sourceRoot":"","sources":["../../src/ta/vortex.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA4M7E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAkBtF"}