@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/anchoredVwap.js

@@ -0,0 +1,134 @@
+// 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/anchored-vwap.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";
+const DEFAULT_SOURCE = "hlc3";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.anchoredVwap called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity, anchorTime) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        anchorTime,
+        cumPV: 0,
+        cumV: 0,
+        started: false,
+        prevClosedCumPV: 0,
+        prevClosedCumV: 0,
+        prevClosedStarted: false,
+    };
+}
+function readSource(ctx, source) {
+    switch (source) {
+        case "close":
+            return ctx.stream.bar.close;
+        case "hl2":
+            return ctx.stream.bar.hl2;
+        case "hlc3":
+            return ctx.stream.bar.hlc3;
+        case "ohlc4":
+            return ctx.stream.bar.ohlc4;
+        case "hlcc4":
+            return ctx.stream.bar.hlcc4;
+    }
+}
+/**
+ * Fold one bar against an accumulator. Returns the post-fold tuple.
+ * Bars with `time < anchor` are skipped (the accumulator is unchanged,
+ * `started` stays false). NaN source or non-positive / NaN volume
+ * contributes zero — the accumulator stays well-defined across data
+ * gaps.
+ */
+function fold(inCumPV, inCumV, inStarted, anchorTime, time, src, volume) {
+    if (time < anchorTime) {
+        return { cumPV: inCumPV, cumV: inCumV, started: inStarted };
+    }
+    let cumPV = inCumPV;
+    let cumV = inCumV;
+    if (Number.isFinite(src) && Number.isFinite(volume) && volume > 0) {
+        cumPV += src * volume;
+        cumV += volume;
+    }
+    return { cumPV, cumV, started: true };
+}
+function valueFromCum(started, cumPV, cumV) {
+    if (!started || cumV === 0)
+        return Number.NaN;
+    return cumPV / cumV;
+}
+/**
+ * Anchored Volume-Weighted Average Price — accumulates
+ * `Σ(source · volume) / Σ(volume)` over every bar at or after
+ * `anchorTime` (a UTC millisecond epoch the script author hard-codes
+ * or computes from a literal). Bars with `bar.time < anchorTime` emit
+ * `NaN`; the first bar with `bar.time ≥ anchorTime` starts the
+ * accumulation, which never resets.
+ *
+ * **Sticky anchor.** The anchor is captured on the first call (slot
+ * init) and ignored on subsequent calls — the slot's anchor is
+ * sticky. Re-anchoring requires a new compiler-generated callsite id
+ * (i.e. editing the script). Phase 4's `input.time()` will lift the
+ * anchor to a user input that can change at runtime.
+ *
+ * **NaN handling.** NaN source or non-positive / NaN volume
+ * contributes zero (the average stays well-defined across data gaps).
+ * Bars before `anchorTime` or before any volume has accumulated emit
+ * NaN.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `(cumPV, cumV, started)` tuple so a
+ * partial-bar tick doesn't pollute the next close's accumulator.
+ *
+ * @formula  anchoredVwap[t] = Σ_{u ≥ anchor}(source[u] · volume[u]) / Σ_{u ≥ anchor}(volume[u])
+ * @warmup   0 (NaN until first bar with `bar.time ≥ anchorTime`)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const av = ta.anchoredVwap("slot", 1_700_000_000_000);
+ *     // const head = av.current;
+ */
+export function anchoredVwap(slotId, anchorTime, opts) {
+    const ctx = getCtx();
+    const source = opts?.source ?? DEFAULT_SOURCE;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, anchorTime);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSource(ctx, source);
+    const volume = ctx.stream.bar.volume;
+    const time = ctx.stream.bar.time;
+    if (ctx.isTick) {
+        const next = fold(slot.prevClosedCumPV, slot.prevClosedCumV, slot.prevClosedStarted, slot.anchorTime, time, src, volume);
+        slot.outBuffer.replaceHead(valueFromCum(next.started, next.cumPV, next.cumV));
+        return slot.series;
+    }
+    // Close-side: snapshot the prior-close state, then fold in the new bar.
+    slot.prevClosedCumPV = slot.cumPV;
+    slot.prevClosedCumV = slot.cumV;
+    slot.prevClosedStarted = slot.started;
+    const next = fold(slot.cumPV, slot.cumV, slot.started, slot.anchorTime, time, src, volume);
+    slot.cumPV = next.cumPV;
+    slot.cumV = next.cumV;
+    slot.started = next.started;
+    slot.outBuffer.append(valueFromCum(slot.started, slot.cumPV, slot.cumV));
+    return slot.series;
+}
+//# sourceMappingURL=anchoredVwap.js.map

package/dist/ta/anchoredVwap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchoredVwap.js","sourceRoot":"","sources":["../../src/ta/anchoredVwap.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,yBAAyB;AAIzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,cAAc,GAAuB,MAAM,CAAC;AAqBlD,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,UAAkB;IAClD,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO;QACH,SAAS;QACT,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC;QACzC,UAAU;QACV,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,CAAC;QAClB,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,KAAK;KAC3B,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,GAAmB,EAAE,MAA0B;IAC/D,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,OAAO;YACR,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QAChC,KAAK,KAAK;YACN,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAC9B,KAAK,MAAM;YACP,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,KAAK,OAAO;YACR,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QAChC,KAAK,OAAO;YACR,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;IACpC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,IAAI,CACT,OAAe,EACf,MAAc,EACd,SAAkB,EAClB,UAAkB,EAClB,IAAY,EACZ,GAAW,EACX,MAAc;IAEd,IAAI,IAAI,GAAG,UAAU,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC;QACtB,IAAI,IAAI,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB,EAAE,KAAa,EAAE,IAAY;IAC/D,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAC9C,OAAO,KAAK,GAAG,IAAI,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,YAAY,CACxB,MAAc,EACd,UAAkB,EAClB,IAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,cAAc,CAAC;IAC9C,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAiC,CAAC;IAC1E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7D,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;IAEjC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,IAAI,CACb,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,UAAU,EACf,IAAI,EACJ,GAAG,EACH,MAAM,CACT,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC;IAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC;IAChC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3F,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC5B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/ta/ao.d.ts

@@ -0,0 +1,21 @@
+import type { AoOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Awesome Oscillator — `SMA(hl2, fastLength) − SMA(hl2, slowLength)`.
+ * Sources from `bar.hl2` directly (no `source` arg — matches Pine
+ * `ta.ao()`). Defaults to `fastLength = 5`, `slowLength = 34`.
+ * Composes two `ta.sma` sub-slots (`${slotId}/fastSma`,
+ * `${slotId}/slowSma`); a fix to `sma` flows in for free. Warmup is
+ * `slowLength − 1` bars (the longer SMA dominates).
+ *
+ * @formula  AO[t] = SMA(hl2, fastLength)[t] − SMA(hl2, slowLength)[t]
+ * @warmup   slowLength − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const a = ta.ao("slot");
+ *     // const head = a.current;
+ */
+export declare function ao(slotId: string, opts?: AoOpts): Series<number>;
+//# sourceMappingURL=ao.d.ts.map

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

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

package/dist/ta/ao.js

@@ -0,0 +1,74 @@
+// 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/ao.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";
+import { sma } from "./sma.js";
+const DEFAULT_FAST_LENGTH = 5;
+const DEFAULT_SLOW_LENGTH = 34;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.ao called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity, slotId) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        fastSmaSub: `${slotId}/fastSma`,
+        slowSmaSub: `${slotId}/slowSma`,
+    };
+}
+function combine(fast, slow) {
+    if (!Number.isFinite(fast) || !Number.isFinite(slow))
+        return Number.NaN;
+    return fast - slow;
+}
+/**
+ * Awesome Oscillator — `SMA(hl2, fastLength) − SMA(hl2, slowLength)`.
+ * Sources from `bar.hl2` directly (no `source` arg — matches Pine
+ * `ta.ao()`). Defaults to `fastLength = 5`, `slowLength = 34`.
+ * Composes two `ta.sma` sub-slots (`${slotId}/fastSma`,
+ * `${slotId}/slowSma`); a fix to `sma` flows in for free. Warmup is
+ * `slowLength − 1` bars (the longer SMA dominates).
+ *
+ * @formula  AO[t] = SMA(hl2, fastLength)[t] − SMA(hl2, slowLength)[t]
+ * @warmup   slowLength − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const a = ta.ao("slot");
+ *     // const head = a.current;
+ */
+export function ao(slotId, opts) {
+    const ctx = getCtx();
+    const fastLength = opts?.fastLength ?? DEFAULT_FAST_LENGTH;
+    const slowLength = opts?.slowLength ?? DEFAULT_SLOW_LENGTH;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, slotId);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const hl2 = ctx.stream.bar.hl2;
+    const fastSeries = sma(slot.fastSmaSub, hl2, fastLength);
+    const slowSeries = sma(slot.slowSmaSub, hl2, slowLength);
+    const value = combine(fastSeries.current, slowSeries.current);
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        slot.outBuffer.append(value);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=ao.js.map

package/dist/ta/ao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ao.js","sourceRoot":"","sources":["../../src/ta/ao.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,qEAAqE;AACrE,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;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAS/B,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,MAAc;IAC9C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO;QACH,SAAS;QACT,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC;QACzC,UAAU,EAAE,GAAG,MAAM,UAAU;QAC/B,UAAU,EAAE,GAAG,MAAM,UAAU;KAClC,CAAC;AACN,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IACxE,OAAO,IAAI,GAAG,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,EAAE,CAAC,MAAc,EAAE,IAAa;IAC5C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC3D,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAuB,CAAC;IAChE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9D,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/aroon.d.ts

@@ -0,0 +1,26 @@
+import type { AroonOpts, AroonResult } from "@invinite-org/chartlang-core";
+/**
+ * Aroon — recency-of-extreme oscillator over the trailing `length + 1`
+ * bars. `aroon.up` tracks how recently a new N-bar high was made;
+ * `aroon.down` mirrors with N-bar lows. Both Series ∈ [0, 100] when
+ * defined; NaN until `length` closed bars have been folded in. Reads
+ * `bar.high` / `bar.low` directly from the runtime stream (mirrors
+ * Pine's `ta.aroon(length)` — no source param). Returns a cached
+ * `{ up, down }` record (same identity every bar).
+ *
+ * @formula  barsSinceHigh = age (0..length) of the max high in window ;
+ *           barsSinceLow  = age (0..length) of the min low in window ;
+ *           up   = 100 · (length − barsSinceHigh) / length ;
+ *           down = 100 · (length − barsSinceLow)  / length
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const a = ta.aroon(14);
+ *     // plot(a.up);
+ *     // plot(a.down);
+ */
+export declare function aroon(slotId: string, length: number, _opts?: AroonOpts): AroonResult;
+//# sourceMappingURL=aroon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aroon.d.ts","sourceRoot":"","sources":["../../src/ta/aroon.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA6I3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,CAmBpF"}

package/dist/ta/aroon.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/aroon.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. Aroon reads `bar.high` / `bar.low` directly
+// (mirrors Pine's `ta.aroon(length)` which has no source param) and
+// scans the trailing `length + 1` window per close for the argmax /
+// argmin (matches the invinite reference's `computeAroonSeries` loop).
+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.aroon called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const upBuffer = new Float64RingBuffer(capacity);
+    const downBuffer = new Float64RingBuffer(capacity);
+    return {
+        outputs: Object.freeze({
+            up: makeSeriesView(upBuffer),
+            down: makeSeriesView(downBuffer),
+        }),
+        upBuffer,
+        downBuffer,
+        length,
+        highWindow: new Float64RingBuffer(length + 1),
+        lowWindow: new Float64RingBuffer(length + 1),
+        barCount: 0,
+        lastHighIndex: 0,
+        lastLowIndex: 0,
+    };
+}
+/**
+ * Scan the `length + 1` window for the bars-since-high index. NaN
+ * entries are skipped (cannot win argmax). Tie-break: smallest age
+ * wins (the most-recent extreme — matches invinite's `>` comparison
+ * and TradingView's convention). Returns `-1` if every entry in the
+ * window is NaN.
+ *
+ * `headHigh` is the candidate value for age 0 — passed separately so
+ * tick replay can substitute the tick's head value without mutating
+ * the closed `highWindow`.
+ */
+function scanHighArgmax(window, headHigh, length) {
+    let bestIdx = -1;
+    let bestVal = Number.NEGATIVE_INFINITY;
+    if (Number.isFinite(headHigh)) {
+        bestIdx = 0;
+        bestVal = headHigh;
+    }
+    for (let k = 1; k <= length; k += 1) {
+        const v = window.at(k);
+        if (Number.isFinite(v) && v > bestVal) {
+            bestVal = v;
+            bestIdx = k;
+        }
+    }
+    return bestIdx;
+}
+function scanLowArgmin(window, headLow, length) {
+    let bestIdx = -1;
+    let bestVal = Number.POSITIVE_INFINITY;
+    if (Number.isFinite(headLow)) {
+        bestIdx = 0;
+        bestVal = headLow;
+    }
+    for (let k = 1; k <= length; k += 1) {
+        const v = window.at(k);
+        if (Number.isFinite(v) && v < bestVal) {
+            bestVal = v;
+            bestIdx = k;
+        }
+    }
+    return bestIdx;
+}
+function closeStep(slot, high, low) {
+    slot.barCount += 1;
+    slot.highWindow.append(high);
+    slot.lowWindow.append(low);
+    // Per the invinite reference: warmup is `length` bars; the first
+    // finite output lands at `barCount === length + 1` (the bar at
+    // 0-based index `length`).
+    if (slot.barCount <= slot.length) {
+        return { up: Number.NaN, down: Number.NaN };
+    }
+    const barsSinceHigh = scanHighArgmax(slot.highWindow, slot.highWindow.at(0), slot.length);
+    const barsSinceLow = scanLowArgmin(slot.lowWindow, slot.lowWindow.at(0), slot.length);
+    if (barsSinceHigh === -1 || barsSinceLow === -1) {
+        return { up: Number.NaN, down: Number.NaN };
+    }
+    slot.lastHighIndex = barsSinceHigh;
+    slot.lastLowIndex = barsSinceLow;
+    const up = (100 * (slot.length - barsSinceHigh)) / slot.length;
+    const down = (100 * (slot.length - barsSinceLow)) / slot.length;
+    return { up, down };
+}
+function tickStep(slot, high, low) {
+    if (slot.barCount <= slot.length)
+        return { up: Number.NaN, down: Number.NaN };
+    // Substitute the tick's head values into the scan without mutating
+    // the closed window. The age-0 slot in `highWindow` / `lowWindow`
+    // still holds the most recent CLOSE; we pass `high` / `low` as the
+    // override.
+    const barsSinceHigh = scanHighArgmax(slot.highWindow, high, slot.length);
+    const barsSinceLow = scanLowArgmin(slot.lowWindow, low, slot.length);
+    if (barsSinceHigh === -1 || barsSinceLow === -1) {
+        return { up: Number.NaN, down: Number.NaN };
+    }
+    const up = (100 * (slot.length - barsSinceHigh)) / slot.length;
+    const down = (100 * (slot.length - barsSinceLow)) / slot.length;
+    return { up, down };
+}
+/**
+ * Aroon — recency-of-extreme oscillator over the trailing `length + 1`
+ * bars. `aroon.up` tracks how recently a new N-bar high was made;
+ * `aroon.down` mirrors with N-bar lows. Both Series ∈ [0, 100] when
+ * defined; NaN until `length` closed bars have been folded in. Reads
+ * `bar.high` / `bar.low` directly from the runtime stream (mirrors
+ * Pine's `ta.aroon(length)` — no source param). Returns a cached
+ * `{ up, down }` record (same identity every bar).
+ *
+ * @formula  barsSinceHigh = age (0..length) of the max high in window ;
+ *           barsSinceLow  = age (0..length) of the min low in window ;
+ *           up   = 100 · (length − barsSinceHigh) / length ;
+ *           down = 100 · (length − barsSinceLow)  / length
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const a = ta.aroon(14);
+ *     // plot(a.up);
+ *     // plot(a.down);
+ */
+export function aroon(slotId, 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 high = ctx.stream.bar.high;
+    const low = ctx.stream.bar.low;
+    if (ctx.isTick) {
+        const { up, down } = tickStep(slot, high, low);
+        slot.upBuffer.replaceHead(up);
+        slot.downBuffer.replaceHead(down);
+    }
+    else {
+        const { up, down } = closeStep(slot, high, low);
+        slot.upBuffer.append(up);
+        slot.downBuffer.append(down);
+    }
+    return slot.outputs;
+}
+//# sourceMappingURL=aroon.js.map

package/dist/ta/aroon.js.map

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

package/dist/ta/aroonOsc.d.ts

@@ -0,0 +1,19 @@
+import type { AroonOscOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Aroon Oscillator — `aroon.up − aroon.down`. Bounded in `[-100, 100]`
+ * when defined; NaN through the `length` warmup window. Composes
+ * `ta.aroon` at sub-slot `${slotId}/aroon`, so the math is fed by
+ * the same per-bar window scan and a fix to Aroon flows in for free.
+ *
+ * @formula  osc = aroon.up − aroon.down
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const osc = ta.aroonOsc(14);
+ *     // plot(osc);
+ */
+export declare function aroonOsc(slotId: string, length: number, _opts?: AroonOscOpts): Series<number>;
+//# sourceMappingURL=aroonOsc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aroonOsc.d.ts","sourceRoot":"","sources":["../../src/ta/aroonOsc.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AA4BzE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAqB7F"}

package/dist/ta/aroonOsc.js

@@ -0,0 +1,68 @@
+// 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/aroon-osc.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. AroonOsc composes `ta.aroon` via a sub-slot
+// id `${slotId}/aroon`, so a fix to Aroon flows in for free.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { aroon } from "./aroon.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.aroonOsc called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+    };
+}
+/**
+ * Aroon Oscillator — `aroon.up − aroon.down`. Bounded in `[-100, 100]`
+ * when defined; NaN through the `length` warmup window. Composes
+ * `ta.aroon` at sub-slot `${slotId}/aroon`, so the math is fed by
+ * the same per-bar window scan and a fix to Aroon flows in for free.
+ *
+ * @formula  osc = aroon.up − aroon.down
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const osc = ta.aroonOsc(14);
+ *     // plot(osc);
+ */
+export function aroonOsc(slotId, length, _opts) {
+    const ctx = getCtx();
+    // Compose: aroon(subSlotId, length) — no opts pass-through; aroon's
+    // opts surface differs (it carries `outputs`) and the AroonOsc
+    // surface concerns (`lineStyle`) don't pipe into the math.
+    const r = aroon(`${slotId}/aroon`, length);
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const up = r.up.current;
+    const down = r.down.current;
+    const value = Number.isFinite(up) && Number.isFinite(down) ? up - down : Number.NaN;
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        slot.outBuffer.append(value);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=aroonOsc.js.map

package/dist/ta/aroonOsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aroonOsc.js","sourceRoot":"","sources":["../../src/ta/aroonOsc.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,4EAA4E;AAC5E,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,qEAAqE;AACrE,6DAA6D;AAI7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOnC,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO;QACH,SAAS;QACT,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC;KAC5C,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,MAAc,EAAE,KAAoB;IACzE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,oEAAoE;IACpE,+DAA+D;IAC/D,2DAA2D;IAC3D,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3C,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAA6B,CAAC;IACtE,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,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;IACxB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IACpF,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/atr.d.ts

@@ -0,0 +1,25 @@
+import type { AtrOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Wilder's Average True Range. Sources from `bar.high` / `bar.low` /
+ * `bar.close` directly (no `source` arg — matches Pine). Seeds at bar
+ * `length − 1` as the simple mean of the first `length` TR values;
+ * subsequent slots use the Wilder recurrence with α = 1/length.
+ *
+ * @formula  TR[t] = max(high − low, |high − prevClose|, |low − prevClose|) ;
+ *           seed at bar length − 1 = mean(TR[0 .. length − 1]) ;
+ *           ATR[t] = (ATR[t − 1] · (length − 1) + TR[t]) / length
+ * @warmup   length − 1
+ * @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 a = ta.atr("slot", 14);
+ *     // const head = a.current;
+ *     // const lagged = ta.atr("slot2", 14, { offset: 5 });
+ */
+export declare function atr(slotId: string, length: number, opts?: AtrOpts): Series<number>;
+//# sourceMappingURL=atr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atr.d.ts","sourceRoot":"","sources":["../../src/ta/atr.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAyGpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAclF"}