@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/crossunder.js

@@ -0,0 +1,101 @@
+// 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.crossunder 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 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 function crossunder(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);
+    }
+    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=crossunder.js.map

package/dist/ta/crossunder.js.map

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

package/dist/ta/dema.d.ts

@@ -0,0 +1,25 @@
+import type { DemaOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Double Exponential Moving Average — `DEMA = 2·EMA(src) − EMA(EMA(src))`.
+ * Composes two EMA sub-slots derived from the parent slot id
+ * (`${slotId}/ema1`, `${slotId}/ema2`). The outer EMA reads the inner
+ * EMA's `.current` scalar each bar; the parent slot allocates its own
+ * `outBuffer + series` because the output is a linear combination of
+ * the two sub-slots (not equal to either). Mirrors the MACD / HMA
+ * sub-slot pattern.
+ *
+ * @formula  ema1 = EMA(source, length) ;
+ *           ema2 = EMA(ema1, length) ;
+ *           out  = 2 · ema1 − ema2
+ * @warmup   2 · length − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const d = ta.dema(bar.close, 20);
+ *     // plot(d);
+ */
+export declare function dema(slotId: string, source: ScalarOrSeries, length: number, _opts?: DemaOpts): Series<number>;
+//# sourceMappingURL=dema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dema.d.ts","sourceRoot":"","sources":["../../src/ta/dema.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAMrE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAyB5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,QAAQ,GACjB,MAAM,CAAC,MAAM,CAAC,CAiBhB"}

package/dist/ta/dema.js

@@ -0,0 +1,72 @@
+// 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/dema.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. DEMA composes two EMA sub-slots derived from
+// the parent slot id.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } 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.dema called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+    };
+}
+/**
+ * Double Exponential Moving Average — `DEMA = 2·EMA(src) − EMA(EMA(src))`.
+ * Composes two EMA sub-slots derived from the parent slot id
+ * (`${slotId}/ema1`, `${slotId}/ema2`). The outer EMA reads the inner
+ * EMA's `.current` scalar each bar; the parent slot allocates its own
+ * `outBuffer + series` because the output is a linear combination of
+ * the two sub-slots (not equal to either). Mirrors the MACD / HMA
+ * sub-slot pattern.
+ *
+ * @formula  ema1 = EMA(source, length) ;
+ *           ema2 = EMA(ema1, length) ;
+ *           out  = 2 · ema1 − ema2
+ * @warmup   2 · length − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const d = ta.dema(bar.close, 20);
+ *     // plot(d);
+ */
+export function dema(slotId, source, length, _opts) {
+    const ctx = getCtx();
+    const src = readSourceValue(source);
+    const ema1Series = ema(`${slotId}/ema1`, src, length);
+    const e1 = ema1Series.current;
+    const ema2Series = ema(`${slotId}/ema2`, e1, length);
+    const e2 = ema2Series.current;
+    const value = Number.isFinite(e1) && Number.isFinite(e2) ? 2 * e1 - e2 : Number.NaN;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    if (ctx.isTick)
+        slot.outBuffer.replaceHead(value);
+    else
+        slot.outBuffer.append(value);
+    return slot.series;
+}
+//# sourceMappingURL=dema.js.map

package/dist/ta/dema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dema.js","sourceRoot":"","sources":["../../src/ta/dema.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,uEAAuE;AACvE,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,sEAAsE;AACtE,sBAAsB;AAItB,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;AAC/B,OAAO,EAAuB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQ5E,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,QAAgB;IAC9C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO;QACH,SAAS;QACT,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC;QACzC,MAAM;KACT,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,IAAI,CAChB,MAAc,EACd,MAAsB,EACtB,MAAc,EACd,KAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAEpF,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAyB,CAAC;IAClE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,GAAG,CAAC,MAAM;QAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;;QAC7C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/ta/dmi.d.ts

@@ -0,0 +1,36 @@
+import type { DmiOpts, DmiResult } from "@invinite-org/chartlang-core";
+/**
+ * Wilder's Directional Movement Index — `+DI` / `−DI` pair derived
+ * from the Wilder-smoothed `+DM` / `−DM` over the smoothed True
+ * Range. Reads `bar.high` / `bar.low` / `bar.close` directly
+ * (mirrors Pine's `ta.dmi(length)` — no source param). Both series
+ * ∈ [0, 100] when defined; NaN until `length` closed bars have
+ * folded into the seed window. The first defined value lands at
+ * bar index `length` (counted zero-based — matches the
+ * full-recompute reference in `lib/wilderDirectional.ts`).
+ *
+ * @formula  TR[t]     = max(high − low, |high − prevClose|, |low − prevClose|) ;
+ *           upMove    = high[t] − high[t−1] ; downMove = low[t−1] − low[t] ;
+ *           +DM       = upMove   > downMove && upMove   > 0 ? upMove   : 0 ;
+ *           −DM       = downMove > upMove   && downMove > 0 ? downMove : 0 ;
+ *           seed at bar `length` = simple sum over the seed window ;
+ *           smoothed via wilderStep(α = 1/length) thereafter ;
+ *           +DI       = 100 · smoothed+DM / smoothedTR ;
+ *           −DI       = 100 · smoothed−DM / smoothedTR ;
+ *           DI falls back to 0 when smoothedTR is 0 (matches invinite).
+ * @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 d = ta.dmi("slot", 14);
+ *     // plot(d.plusDi);
+ *     // plot(d.minusDi);
+ */
+export declare function dmi(slotId: string, length: number, opts?: DmiOpts): DmiResult;
+//# sourceMappingURL=dmi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dmi.d.ts","sourceRoot":"","sources":["../../src/ta/dmi.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA8DvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAuB7E"}

package/dist/ta/dmi.js

@@ -0,0 +1,107 @@
+// 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/dmi.ts
+//   plus lib/wilder-directional.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. DMI reads `bar.high` / `bar.low` / `bar.close`
+// directly (mirrors Pine's `ta.dmi(length)` which has no source param)
+// and runs the Wilder +DM / -DM / TR smoothing incrementally via
+// `wilderStep` (the same per-step recurrence the reference
+// `lib/wilderDirectional.ts` uses internally).
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { advanceDirectionalClose, initDirectionalState, tickDirectional, } from "./lib/directionalState.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.dmi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const plusDiBuffer = new Float64RingBuffer(capacity);
+    const minusDiBuffer = new Float64RingBuffer(capacity);
+    return {
+        result: Object.freeze({
+            plusDi: makeSeriesView(plusDiBuffer),
+            minusDi: makeSeriesView(minusDiBuffer),
+        }),
+        plusDiBuffer,
+        minusDiBuffer,
+        dirState: initDirectionalState(length),
+        shiftedResults: new Map(),
+    };
+}
+function resultForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.result;
+    let cached = slot.shiftedResults.get(offset);
+    if (cached === undefined) {
+        cached = Object.freeze({
+            plusDi: makeShiftedSeriesView(slot.plusDiBuffer, offset),
+            minusDi: makeShiftedSeriesView(slot.minusDiBuffer, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+/**
+ * Wilder's Directional Movement Index — `+DI` / `−DI` pair derived
+ * from the Wilder-smoothed `+DM` / `−DM` over the smoothed True
+ * Range. Reads `bar.high` / `bar.low` / `bar.close` directly
+ * (mirrors Pine's `ta.dmi(length)` — no source param). Both series
+ * ∈ [0, 100] when defined; NaN until `length` closed bars have
+ * folded into the seed window. The first defined value lands at
+ * bar index `length` (counted zero-based — matches the
+ * full-recompute reference in `lib/wilderDirectional.ts`).
+ *
+ * @formula  TR[t]     = max(high − low, |high − prevClose|, |low − prevClose|) ;
+ *           upMove    = high[t] − high[t−1] ; downMove = low[t−1] − low[t] ;
+ *           +DM       = upMove   > downMove && upMove   > 0 ? upMove   : 0 ;
+ *           −DM       = downMove > upMove   && downMove > 0 ? downMove : 0 ;
+ *           seed at bar `length` = simple sum over the seed window ;
+ *           smoothed via wilderStep(α = 1/length) thereafter ;
+ *           +DI       = 100 · smoothed+DM / smoothedTR ;
+ *           −DI       = 100 · smoothed−DM / smoothedTR ;
+ *           DI falls back to 0 when smoothedTR is 0 (matches invinite).
+ * @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 d = ta.dmi("slot", 14);
+ *     // plot(d.plusDi);
+ *     // plot(d.minusDi);
+ */
+export function dmi(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 bar = ctx.stream.bar;
+    if (ctx.isTick) {
+        const { plusDi, minusDi } = tickDirectional(slot.dirState, bar.high, bar.low, bar.close);
+        slot.plusDiBuffer.replaceHead(plusDi);
+        slot.minusDiBuffer.replaceHead(minusDi);
+    }
+    else {
+        const { plusDi, minusDi } = advanceDirectionalClose(slot.dirState, bar.high, bar.low, bar.close);
+        slot.plusDiBuffer.append(plusDi);
+        slot.minusDiBuffer.append(minusDi);
+    }
+    return resultForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=dmi.js.map

package/dist/ta/dmi.js.map

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

package/dist/ta/donchian.d.ts

@@ -0,0 +1,29 @@
+import type { DonchianOpts, DonchianResult } from "@invinite-org/chartlang-core";
+/**
+ * Donchian Channels — overlay volatility indicator. Highest high and
+ * lowest low over a fixed `length`-bar window form the upper / lower
+ * band; their midpoint is the centerline. Reads `bar.high` /
+ * `bar.low` directly (no source param, mirrors Pine). Composes the
+ * registered `ta.highest` / `ta.lowest` primitives via sub-slots
+ * `${slotId}/highest` and `${slotId}/lowest` — the math equivalent of
+ * `lib/donchianMid` but routed through the slot-aware registry so a
+ * fix to either primitive flows in for free. Returns a cached
+ * `{ upper, middle, lower }` record (same identity every bar). NaN
+ * across all outputs while the trailing window is fully unwarmed.
+ *
+ * @formula  upper  = highest(bar.high, length) ;
+ *           lower  = lowest(bar.low, length) ;
+ *           middle = (upper + lower) / 2
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const d = ta.donchian(20);
+ *     // plot(d.upper);
+ *     // plot(d.middle);
+ *     // plot(d.lower);
+ */
+export declare function donchian(slotId: string, length: number, _opts?: DonchianOpts): DonchianResult;
+//# sourceMappingURL=donchian.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"donchian.d.ts","sourceRoot":"","sources":["../../src/ta/donchian.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAmCjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,cAAc,CAuB7F"}

package/dist/ta/donchian.js

@@ -0,0 +1,93 @@
+// 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/donchian.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. Reads `bar.high` / `bar.low` directly (no
+// source param, mirrors Pine's `ta.highest` / `ta.lowest` over the
+// `high` / `low` series). Composes the registered `ta.highest` /
+// `ta.lowest` primitives via sub-slots `${slotId}/highest` and
+// `${slotId}/lowest` — the math equivalent of `lib/donchianMid`
+// (used by `ta.ichimoku` in its full-recompute path) but routed
+// through the slot-aware registry so a fix to either primitive
+// flows in for free.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { highest } from "./highest.js";
+import { lowest } from "./lowest.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.donchian called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    return {
+        middleBuffer: new Float64RingBuffer(capacity),
+        length,
+        outputs: null,
+    };
+}
+function middleValue(upper, lower) {
+    if (!Number.isFinite(upper) || !Number.isFinite(lower))
+        return Number.NaN;
+    return (upper + lower) / 2;
+}
+/**
+ * Donchian Channels — overlay volatility indicator. Highest high and
+ * lowest low over a fixed `length`-bar window form the upper / lower
+ * band; their midpoint is the centerline. Reads `bar.high` /
+ * `bar.low` directly (no source param, mirrors Pine). Composes the
+ * registered `ta.highest` / `ta.lowest` primitives via sub-slots
+ * `${slotId}/highest` and `${slotId}/lowest` — the math equivalent of
+ * `lib/donchianMid` but routed through the slot-aware registry so a
+ * fix to either primitive flows in for free. Returns a cached
+ * `{ upper, middle, lower }` record (same identity every bar). NaN
+ * across all outputs while the trailing window is fully unwarmed.
+ *
+ * @formula  upper  = highest(bar.high, length) ;
+ *           lower  = lowest(bar.low, length) ;
+ *           middle = (upper + lower) / 2
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const d = ta.donchian(20);
+ *     // plot(d.upper);
+ *     // plot(d.middle);
+ *     // plot(d.lower);
+ */
+export function donchian(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 upperSeries = highest(`${slotId}/highest`, ctx.stream.bar.high, length);
+    const lowerSeries = lowest(`${slotId}/lowest`, ctx.stream.bar.low, length);
+    if (slot.outputs === null) {
+        slot.outputs = Object.freeze({
+            upper: upperSeries,
+            middle: makeSeriesView(slot.middleBuffer),
+            lower: lowerSeries,
+        });
+    }
+    const value = middleValue(upperSeries.current, lowerSeries.current);
+    if (ctx.isTick) {
+        slot.middleBuffer.replaceHead(value);
+    }
+    else {
+        slot.middleBuffer.append(value);
+    }
+    return slot.outputs;
+}
+//# sourceMappingURL=donchian.js.map

package/dist/ta/donchian.js.map

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

package/dist/ta/dpo.d.ts

@@ -0,0 +1,25 @@
+import type { DpoOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Detrended Price Oscillator — strips the SMA trend out of price so
+ * the remaining oscillator visualises the short-cycle component.
+ * Non-centered (default) mode: `dpo[i] = source[i − displacement]
+ * − sma[i]` with `displacement = floor(length / 2) + 1`. Composes
+ * `ta.sma(${slotId}/sma, src, length)`; a per-slot source window
+ * carries the trailing `displacement + 1` bars so the
+ * `source[i − displacement]` lookback is O(1) per close.
+ *
+ * @formula  displacement = floor(length / 2) + 1 ;
+ *           sma[i]        = mean(source[i − length + 1 ..= i]) ;
+ *           dpo[i]        = source[i − displacement] − sma[i]
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const d = ta.dpo("slot", bar.close, 21);
+ *     // const head = d.current;
+ */
+export declare function dpo(slotId: string, source: ScalarOrSeries, length: number, opts?: DpoOpts): Series<number>;
+//# sourceMappingURL=dpo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dpo.d.ts","sourceRoot":"","sources":["../../src/ta/dpo.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAMpE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAuD5E;;;;;;;;;;;;;;;;;;;;GAoBG;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,CAmBhB"}

package/dist/ta/dpo.js

@@ -0,0 +1,111 @@
+// 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/dpo.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: `ta.sma`
+// over the source via a sub-slot (`${slotId}/sma`); a per-slot
+// `sourceWindow` Float64RingBuffer carries the trailing
+// `displacement + 1` source values for the `src[t − displacement]`
+// lookback.
+//
+// DEVIATION from invinite: only the non-centered (default) render
+// mode is shipped. Invinite's `centered: true` mode emits
+// `dpo[i] = src[i] - sma[i + displacement]`, which depends on the
+// future SMA; chartlang's append-only ring-buffer contract can't
+// backfill earlier emissions when the future SMA confirms, so we'd
+// have to emit centered as NaN at the head until the future SMA
+// lands — the visual would diverge from invinite. The non-centered
+// mode is the TradingView "shifts back to the right to match current
+// price" default, which is what most authors want.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { sma } from "./sma.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.dpo called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const displacement = Math.floor(length / 2) + 1;
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        displacement,
+        sourceWindow: new Float64RingBuffer(displacement + 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 computeDpo(slot, smaCurrent) {
+    if (slot.sourceWindow.length <= slot.displacement)
+        return Number.NaN;
+    if (!Number.isFinite(smaCurrent))
+        return Number.NaN;
+    const shifted = slot.sourceWindow.at(slot.displacement);
+    if (!Number.isFinite(shifted))
+        return Number.NaN;
+    return shifted - smaCurrent;
+}
+/**
+ * Detrended Price Oscillator — strips the SMA trend out of price so
+ * the remaining oscillator visualises the short-cycle component.
+ * Non-centered (default) mode: `dpo[i] = source[i − displacement]
+ * − sma[i]` with `displacement = floor(length / 2) + 1`. Composes
+ * `ta.sma(${slotId}/sma, src, length)`; a per-slot source window
+ * carries the trailing `displacement + 1` bars so the
+ * `source[i − displacement]` lookback is O(1) per close.
+ *
+ * @formula  displacement = floor(length / 2) + 1 ;
+ *           sma[i]        = mean(source[i − length + 1 ..= i]) ;
+ *           dpo[i]        = source[i − displacement] − sma[i]
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const d = ta.dpo("slot", bar.close, 21);
+ *     // const head = d.current;
+ */
+export function dpo(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.sourceWindow.replaceHead(src);
+        const smaSeries = sma(`${slotId}/sma`, src, length);
+        slot.outBuffer.replaceHead(computeDpo(slot, smaSeries.current));
+    }
+    else {
+        slot.sourceWindow.append(src);
+        slot.barCount += 1;
+        const smaSeries = sma(`${slotId}/sma`, src, length);
+        slot.outBuffer.append(computeDpo(slot, smaSeries.current));
+    }
+    return viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=dpo.js.map

package/dist/ta/dpo.js.map

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