@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/connorsRsi.js

@@ -0,0 +1,207 @@
+// 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/connors-rsi.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. Composition: Phase-1
+// `ta.rsi` on the raw source (sub-slot `${slotId}/rsi`) + a second
+// `ta.rsi` on the signed-streak scalar (sub-slot
+// `${slotId}/streakRsi`) — no private RSI math duplication. The
+// signed-streak helper + the rolling percent-rank live inline in this
+// file per task spec §3 ("not factored to lib until a second consumer
+// appears").
+//
+// DEVIATION from invinite: invinite's reference requires all three
+// components (RSI, streak-RSI, percent-rank) finite for the CRSI line
+// to be defined; on any NaN it propagates. The task spec §6 overrides
+// to "sub-component NaN → component skipped in the average". We follow
+// the spec — fully-NaN inputs still emit NaN, but a partially-warm
+// state yields a partial average. This is a tighter alignment with
+// the Pine `ta.connorsRsi` semantic where streak-RSI warmup doesn't
+// gate the rsi-on-close component.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { rsi } from "./rsi.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_RSI_LENGTH = 3;
+const DEFAULT_STREAK_LENGTH = 2;
+const DEFAULT_ROC_LENGTH = 100;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.connorsRsi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(rsiLength, streakLength, rocLength, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        rsiLength,
+        streakLength,
+        rocLength,
+        streakSign: 0,
+        streakRun: 0,
+        prevClosedStreakSign: 0,
+        prevClosedStreakRun: 0,
+        prevClosedSrc: Number.NaN,
+        // rocWindow capacity = rocLength + 1: room for the current
+        // bar's ROC at `at(0)` plus the trailing `rocLength` values
+        // we percent-rank against.
+        rocWindow: new Float64RingBuffer(rocLength + 1),
+        barCount: 0,
+        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 stepStreak(prevSign, prevRun, diff) {
+    if (!Number.isFinite(diff) || diff === 0) {
+        return { sign: 0, run: 0 };
+    }
+    if (diff > 0) {
+        return { sign: 1, run: prevSign === 1 ? prevRun + 1 : 1 };
+    }
+    return { sign: -1, run: prevSign === -1 ? prevRun + 1 : 1 };
+}
+function streakScalar(sign, run) {
+    if (sign === 0)
+        return 0;
+    return sign * run;
+}
+function pctChange(curr, prev) {
+    if (!Number.isFinite(curr) || !Number.isFinite(prev) || prev === 0)
+        return Number.NaN;
+    return (100 * (curr - prev)) / prev;
+}
+/**
+ * Rolling percent rank of the head ROC value (`rocWindow.at(0)`)
+ * within the trailing `rocLength` ROC values (exclusive of the head).
+ * Returns 50 on an empty window (matches invinite). NaN target → NaN.
+ */
+function percentRankHead(slot) {
+    const target = slot.rocWindow.at(0);
+    if (!Number.isFinite(target))
+        return Number.NaN;
+    const windowSize = slot.rocWindow.length - 1;
+    // Defensive: percentRankHead is only called after the ROC window has
+    // at least two entries (post-warmup), so windowSize >= 1 here.
+    /* c8 ignore next */
+    if (windowSize <= 0)
+        return 50;
+    const upper = Math.min(windowSize, slot.rocLength);
+    let countBelow = 0;
+    let validCount = 0;
+    for (let j = 1; j <= upper; j += 1) {
+        const v = slot.rocWindow.at(j);
+        if (!Number.isFinite(v))
+            continue;
+        validCount += 1;
+        if (v < target)
+            countBelow += 1;
+    }
+    return validCount === 0 ? 50 : (100 * countBelow) / validCount;
+}
+function blendCrsi(rsiHead, streakRsiHead, pctRank) {
+    let sum = 0;
+    let count = 0;
+    if (Number.isFinite(rsiHead)) {
+        sum += rsiHead;
+        count += 1;
+    }
+    if (Number.isFinite(streakRsiHead)) {
+        sum += streakRsiHead;
+        count += 1;
+    }
+    if (Number.isFinite(pctRank)) {
+        sum += pctRank;
+        count += 1;
+    }
+    return count === 0 ? Number.NaN : sum / count;
+}
+/**
+ * Connors RSI — three-component blend of `RSI(source, rsiLength)`,
+ * `RSI(streak, streakLength)`, and `PercentRank(ROC(source, 1),
+ * rocLength)` averaged into a single line bounded `[0, 100]`. The
+ * registry records `yDomain: { kind: "fixed", min: 0, max: 100 }` in
+ * `TA_REGISTRY_METADATA`. Composes Phase-1 `ta.rsi` for both RSI
+ * components (no private RSI math). Defaults `(3, 2, 100)` matches
+ * Larry Connors' original spec.
+ *
+ * @formula  diff       = source[t] − source[t − 1] ;
+ *           streak[t]  = signed run-length of consecutive same-sign diffs ;
+ *           rsiClose   = rsi(source, rsiLength) ;
+ *           rsiStreak  = rsi(streak, streakLength) ;
+ *           roc1       = 100 · diff / source[t − 1] ;
+ *           pctRank    = 100 · #(roc1[i] < roc1[t]) / validWindowCount
+ *                        over i in [t − rocLength, t − 1] ;
+ *           crsi       = (rsiClose + rsiStreak + pctRank) / 3 ;
+ *           components that are NaN are skipped — count adjusts
+ * @warmup   max(rsiLength, streakLength, rocLength) + 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.connorsRsi("slot", bar.close);
+ *     // plot(c);
+ */
+export function connorsRsi(slotId, source, opts) {
+    const ctx = getCtx();
+    const rsiLength = opts?.rsiLength ?? DEFAULT_RSI_LENGTH;
+    const streakLength = opts?.streakLength ?? DEFAULT_STREAK_LENGTH;
+    const rocLength = opts?.rocLength ?? DEFAULT_ROC_LENGTH;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(rsiLength, streakLength, rocLength, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    if (ctx.isTick) {
+        // Tick replay: use the SNAPSHOT (prevClosed*) state — do NOT
+        // mutate `streakSign` / `streakRun` / `prevClosedSrc` /
+        // `barCount` / advance rocWindow.
+        const diff = pctChange(src, slot.prevClosedSrc);
+        const { sign, run } = stepStreak(slot.prevClosedStreakSign, slot.prevClosedStreakRun, 
+        /* c8 ignore next */
+        Number.isFinite(slot.prevClosedSrc) ? src - slot.prevClosedSrc : Number.NaN);
+        const roc = diff;
+        slot.rocWindow.replaceHead(roc);
+        const rsiHead = rsi(`${slotId}/rsi`, src, rsiLength).current;
+        const streakRsiHead = rsi(`${slotId}/streakRsi`, streakScalar(sign, run), streakLength).current;
+        const pr = percentRankHead(slot);
+        slot.outBuffer.replaceHead(blendCrsi(rsiHead, streakRsiHead, pr));
+    }
+    else {
+        const diff = Number.isFinite(slot.prevClosedSrc) ? src - slot.prevClosedSrc : Number.NaN;
+        const { sign, run } = stepStreak(slot.streakSign, slot.streakRun, diff);
+        const roc = pctChange(src, slot.prevClosedSrc);
+        slot.rocWindow.append(roc);
+        const rsiHead = rsi(`${slotId}/rsi`, src, rsiLength).current;
+        const streakRsiHead = rsi(`${slotId}/streakRsi`, streakScalar(sign, run), streakLength).current;
+        const pr = percentRankHead(slot);
+        slot.outBuffer.append(blendCrsi(rsiHead, streakRsiHead, pr));
+        // Advance close-side state.
+        slot.prevClosedStreakSign = slot.streakSign;
+        slot.prevClosedStreakRun = slot.streakRun;
+        slot.streakSign = sign;
+        slot.streakRun = run;
+        slot.prevClosedSrc = src;
+        slot.barCount += 1;
+    }
+    return viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=connorsRsi.js.map

package/dist/ta/connorsRsi.js.map

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

package/dist/ta/coppock.d.ts

@@ -0,0 +1,25 @@
+import type { CoppockOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Coppock Curve — long-term momentum indicator (Edwin Coppock, 1962).
+ * `WMA(ROC(source, roc1Length) + ROC(source, roc2Length), wmaLength)`
+ * where ROC is the percentage rate-of-change. Defaults `(11, 14, 10)`
+ * matches Coppock's original monthly-equities formulation. Unbounded;
+ * zero crossings are the canonical signal (positive → bullish).
+ *
+ * @formula  roc1 = 100 · (source[t] − source[t − roc1Length]) / source[t − roc1Length] ;
+ *           roc2 = 100 · (source[t] − source[t − roc2Length]) / source[t − roc2Length] ;
+ *           sum  = roc1 + roc2 ;
+ *           coppock = (Σ sum[t − N + 1 + i] · (i + 1)) / (N(N + 1) / 2)
+ *                     for i in 0..N − 1, N = wmaLength
+ * @warmup   max(roc1Length, roc2Length) + wmaLength − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.coppock("slot", bar.close);
+ *     // plot(c);
+ */
+export declare function coppock(slotId: string, source: ScalarOrSeries, opts?: CoppockOpts): Series<number>;
+//# sourceMappingURL=coppock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coppock.d.ts","sourceRoot":"","sources":["../../src/ta/coppock.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAKxE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA6G5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,WAAW,GACnB,MAAM,CAAC,MAAM,CAAC,CAiBhB"}

package/dist/ta/coppock.js

@@ -0,0 +1,151 @@
+// 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/coppock.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.
+//
+// DEVIATION from the task spec's "composes `ta.change`" hint:
+// `ta.change` emits ABSOLUTE deltas, while Coppock's ROC is a
+// PERCENTAGE rate-of-change (`100 · (src − src[n]) / src[n]`). We
+// compute the percentage ROCs inline against our own sourceWindow
+// rather than composing `ta.change`. The WMA math mirrors
+// `lib/wmaFloat64` (linear weights `(N, N − 1, …, 1)`, denominator
+// `N(N + 1) / 2`); we inline the WMA over a per-close `sumWindow`
+// rather than allocating a `Float64Array` per close to feed
+// `wmaFloat64`.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_ROC1_LENGTH = 11;
+const DEFAULT_ROC2_LENGTH = 14;
+const DEFAULT_WMA_LENGTH = 10;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.coppock called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(roc1Length, roc2Length, wmaLength, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    const lookbackCapacity = Math.max(roc1Length, roc2Length) + 1;
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        roc1Length,
+        roc2Length,
+        wmaLength,
+        sourceWindow: new Float64RingBuffer(lookbackCapacity),
+        sumWindow: new Float64RingBuffer(wmaLength),
+        barCount: 0,
+    };
+}
+/**
+ * Percentage rate-of-change against a lookback value. Returns NaN on
+ * a NaN / zero divisor (matching invinite's `prev === 0` guard).
+ */
+function pctRoc(current, lookback) {
+    if (!Number.isFinite(lookback) || lookback === 0 || !Number.isFinite(current)) {
+        return Number.NaN;
+    }
+    return (100 * (current - lookback)) / lookback;
+}
+/**
+ * Inline linear-weighted moving average over the `sumWindow` ring.
+ * `at(0)` is the most recent value (weight `wmaLength`); `at(wmaLength − 1)`
+ * is the oldest (weight `1`). Returns NaN if the window is not full
+ * or any slot is non-finite.
+ */
+function wmaOverSumWindow(slot) {
+    if (slot.sumWindow.length < slot.wmaLength)
+        return Number.NaN;
+    const denom = (slot.wmaLength * (slot.wmaLength + 1)) / 2;
+    let acc = 0;
+    for (let i = 0; i < slot.wmaLength; i += 1) {
+        const v = slot.sumWindow.at(i);
+        if (!Number.isFinite(v))
+            return Number.NaN;
+        acc += v * (slot.wmaLength - i);
+    }
+    return acc / denom;
+}
+function computeRocSum(slot, src) {
+    // sourceWindow.at(roc1Length) is the bar `roc1Length` ago RELATIVE
+    // TO the just-appended head (`at(0)` is `src`). Same for roc2.
+    if (slot.sourceWindow.length <= slot.roc1Length)
+        return Number.NaN;
+    if (slot.sourceWindow.length <= slot.roc2Length)
+        return Number.NaN;
+    const lookback1 = slot.sourceWindow.at(slot.roc1Length);
+    const lookback2 = slot.sourceWindow.at(slot.roc2Length);
+    const roc1 = pctRoc(src, lookback1);
+    const roc2 = pctRoc(src, lookback2);
+    if (!Number.isFinite(roc1) || !Number.isFinite(roc2))
+        return Number.NaN;
+    return roc1 + roc2;
+}
+function closeValue(slot, src) {
+    slot.sourceWindow.append(src);
+    slot.barCount += 1;
+    const sum = computeRocSum(slot, src);
+    slot.sumWindow.append(sum);
+    return wmaOverSumWindow(slot);
+}
+function tickValue(slot, src) {
+    if (slot.sourceWindow.length === 0)
+        return Number.NaN;
+    // Substitute the head of `sourceWindow` with the tick `src`. The
+    // lookback bars (`at(roc1Length)` / `at(roc2Length)`) are
+    // pre-close and unaffected by the tick.
+    slot.sourceWindow.replaceHead(src);
+    const sum = computeRocSum(slot, src);
+    slot.sumWindow.replaceHead(sum);
+    return wmaOverSumWindow(slot);
+}
+/**
+ * Coppock Curve — long-term momentum indicator (Edwin Coppock, 1962).
+ * `WMA(ROC(source, roc1Length) + ROC(source, roc2Length), wmaLength)`
+ * where ROC is the percentage rate-of-change. Defaults `(11, 14, 10)`
+ * matches Coppock's original monthly-equities formulation. Unbounded;
+ * zero crossings are the canonical signal (positive → bullish).
+ *
+ * @formula  roc1 = 100 · (source[t] − source[t − roc1Length]) / source[t − roc1Length] ;
+ *           roc2 = 100 · (source[t] − source[t − roc2Length]) / source[t − roc2Length] ;
+ *           sum  = roc1 + roc2 ;
+ *           coppock = (Σ sum[t − N + 1 + i] · (i + 1)) / (N(N + 1) / 2)
+ *                     for i in 0..N − 1, N = wmaLength
+ * @warmup   max(roc1Length, roc2Length) + wmaLength − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.coppock("slot", bar.close);
+ *     // plot(c);
+ */
+export function coppock(slotId, source, opts) {
+    const ctx = getCtx();
+    const roc1Length = opts?.roc1Length ?? DEFAULT_ROC1_LENGTH;
+    const roc2Length = opts?.roc2Length ?? DEFAULT_ROC2_LENGTH;
+    const wmaLength = opts?.wmaLength ?? DEFAULT_WMA_LENGTH;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(roc1Length, roc2Length, wmaLength, 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 slot.series;
+}
+//# sourceMappingURL=coppock.js.map

package/dist/ta/coppock.js.map

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

package/dist/ta/crossover.d.ts

@@ -0,0 +1,29 @@
+import type { CrossoverOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * `true` exactly at the bar where `a` crosses above `b`: `a.current >
+ * b.current && a.prev <= b.prev`. `b` may be a scalar (treated as a
+ * constant series). NaN inputs yield `false` — Pine semantics for
+ * Boolean series (NaN doesn't bubble through booleans).
+ *
+ * The slot keeps a 2-slot history of both `a` and `b` so scalar
+ * sources work without the caller wrapping them. Tick-mode replays
+ * the head with the prior closed-bar's `(a, b)` pair so a partial-
+ * bar value doesn't seed the next close's comparison.
+ *
+ * @formula  out[t] = a[t] > b[t] && a[t − 1] ≤ b[t − 1] (else false)
+ * @warmup   1 (need a prior bar)
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts the boolean series so `series.current` returns
+ * the crossover detection `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.crossover("slot", fastEma, slowEma);
+ *     // if (c.current) { ... }
+ *     // const lagged = ta.crossover("slot2", fastEma, slowEma, { offset: 1 });
+ */
+export declare function crossover(slotId: string, a: ScalarOrSeries, b: ScalarOrSeries, opts?: CrossoverOpts): Series<boolean>;
+//# sourceMappingURL=crossover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crossover.d.ts","sourceRoot":"","sources":["../../src/ta/crossover.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAK1E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA4D5E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,cAAc,EACjB,CAAC,EAAE,cAAc,EACjB,IAAI,CAAC,EAAE,aAAa,GACrB,MAAM,CAAC,OAAO,CAAC,CA+BjB"}

package/dist/ta/crossover.js

@@ -0,0 +1,108 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// No invinite source — Phase-1 new code, semantics per Pine
+// `ta.crossover` / `ta.crossunder`. See PLAN.md §3.1.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape.
+import { RingBuffer } 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.crossover called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        prevA: Number.NaN,
+        prevB: Number.NaN,
+        currA: Number.NaN,
+        currB: Number.NaN,
+        initialised: false,
+        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 detect(prevA, prevB, currA, currB) {
+    if (!Number.isFinite(prevA) ||
+        !Number.isFinite(prevB) ||
+        !Number.isFinite(currA) ||
+        !Number.isFinite(currB)) {
+        return false;
+    }
+    return currA > currB && prevA <= prevB;
+}
+/**
+ * `true` exactly at the bar where `a` crosses above `b`: `a.current >
+ * b.current && a.prev <= b.prev`. `b` may be a scalar (treated as a
+ * constant series). NaN inputs yield `false` — Pine semantics for
+ * Boolean series (NaN doesn't bubble through booleans).
+ *
+ * The slot keeps a 2-slot history of both `a` and `b` so scalar
+ * sources work without the caller wrapping them. Tick-mode replays
+ * the head with the prior closed-bar's `(a, b)` pair so a partial-
+ * bar value doesn't seed the next close's comparison.
+ *
+ * @formula  out[t] = a[t] > b[t] && a[t − 1] ≤ b[t − 1] (else false)
+ * @warmup   1 (need a prior bar)
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts the boolean series so `series.current` returns
+ * the crossover detection `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.crossover("slot", fastEma, slowEma);
+ *     // if (c.current) { ... }
+ *     // const lagged = ta.crossover("slot2", fastEma, slowEma, { offset: 1 });
+ */
+export function crossover(slotId, a, b, 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 aValue = readSourceValue(a);
+    const bValue = readSourceValue(b);
+    const offset = opts?.offset ?? 0;
+    if (ctx.isTick) {
+        const out = detect(slot.prevA, slot.prevB, aValue, bValue);
+        slot.outBuffer.replaceHead(out);
+        return viewForOffset(slot, offset);
+    }
+    if (!slot.initialised) {
+        slot.initialised = true;
+        slot.prevA = aValue;
+        slot.prevB = bValue;
+        slot.currA = aValue;
+        slot.currB = bValue;
+        slot.outBuffer.append(false);
+        return viewForOffset(slot, offset);
+    }
+    // Standard close-side advance: prev becomes currA/B, currA/B become the new sample.
+    slot.prevA = slot.currA;
+    slot.prevB = slot.currB;
+    slot.currA = aValue;
+    slot.currB = bValue;
+    slot.outBuffer.append(detect(slot.prevA, slot.prevB, slot.currA, slot.currB));
+    return viewForOffset(slot, offset);
+}
+//# sourceMappingURL=crossover.js.map

package/dist/ta/crossover.js.map

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

package/dist/ta/crossunder.d.ts

@@ -0,0 +1,23 @@
+import type { CrossunderOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * `true` exactly at the bar where `a` crosses below `b`: `a.current <
+ * b.current && a.prev >= b.prev`. Mirror of {@link crossover}; NaN
+ * inputs yield `false`.
+ *
+ * @formula  out[t] = a[t] < b[t] && a[t − 1] ≥ b[t − 1] (else false)
+ * @warmup   1
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts the boolean series so `series.current` returns
+ * the crossunder detection `offset` bars ago (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const c = ta.crossunder("slot", fastEma, slowEma);
+ *     // if (c.current) { ... }
+ *     // const lagged = ta.crossunder("slot2", fastEma, slowEma, { offset: 1 });
+ */
+export declare function crossunder(slotId: string, a: ScalarOrSeries, b: ScalarOrSeries, opts?: CrossunderOpts): Series<boolean>;
+//# sourceMappingURL=crossunder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crossunder.d.ts","sourceRoot":"","sources":["../../src/ta/crossunder.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAK3E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA0D5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,cAAc,EACjB,CAAC,EAAE,cAAc,EACjB,IAAI,CAAC,EAAE,cAAc,GACtB,MAAM,CAAC,OAAO,CAAC,CA8BjB"}