@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/kama.js

@@ -0,0 +1,141 @@
+// 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/kama.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";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_LENGTH = 10;
+const DEFAULT_FAST = 2;
+const DEFAULT_SLOW = 30;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.kama called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, fastLength, slowLength, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        fastAlpha: 2 / (fastLength + 1),
+        slowAlpha: 2 / (slowLength + 1),
+        sourceWindow: new Float64RingBuffer(length + 1),
+        prevKama: Number.NaN,
+        prevClosedKama: Number.NaN,
+    };
+}
+/**
+ * Compute the next KAMA value given the slot's current window state,
+ * `headSrc` (the source value to evaluate at age 0 — may be the
+ * just-appended close or a tick replacement), and `prev` (the prior
+ * KAMA — either `prevClosedKama` on close or `prevClosedKama` on
+ * tick; tick recomputes from the closed prior). Returns NaN until the
+ * window holds `length + 1` finite samples.
+ */
+function computeKama(slot, headSrc, prev) {
+    if (slot.sourceWindow.length < slot.length + 1)
+        return Number.NaN;
+    if (!Number.isFinite(headSrc))
+        return prev;
+    const oldest = slot.sourceWindow.at(slot.length);
+    if (!Number.isFinite(oldest))
+        return prev;
+    const change = Math.abs(headSrc - oldest);
+    let volatility = 0;
+    // Per-bar absolute diffs across the trailing `length` pairs:
+    // |w[0] − w[1]| + |w[1] − w[2]| + … + |w[length-1] − w[length]|
+    // with w[0] substituted by `headSrc` so tick replays work
+    // without mutating the closed window.
+    {
+        const next = headSrc;
+        const prior = slot.sourceWindow.at(1);
+        if (!Number.isFinite(prior))
+            return prev;
+        volatility += Math.abs(next - prior);
+    }
+    for (let j = 1; j < slot.length; j += 1) {
+        const next = slot.sourceWindow.at(j);
+        const prior = slot.sourceWindow.at(j + 1);
+        if (!Number.isFinite(next) || !Number.isFinite(prior))
+            return prev;
+        volatility += Math.abs(next - prior);
+    }
+    const er = volatility > 0 ? change / volatility : 0;
+    const sc = (er * (slot.fastAlpha - slot.slowAlpha) + slot.slowAlpha) ** 2;
+    // Seed at the warmup boundary with the source value itself
+    // (matches invinite's convention + standard Pine `ta.kama`).
+    if (!Number.isFinite(prev))
+        return headSrc;
+    return prev + sc * (headSrc - prev);
+}
+/**
+ * Kaufman's Adaptive Moving Average — an EMA-like recurrence whose
+ * smoothing constant adapts to market efficiency. The "efficiency
+ * ratio" is the directional change over the last `length` bars
+ * divided by the total path-length over the same window; high
+ * efficiency (trending) → smoothing approaches `fastAlpha`,
+ * low efficiency (chop) → smoothing approaches `slowAlpha`.
+ * Defaults: `length = 10`, `fastLength = 2`, `slowLength = 30`.
+ *
+ * NaN handling: mid-stream NaN source → KAMA carries the prior value
+ * forward (matches the EMA / SMMA recurrence convention). Zero-
+ * volatility window → `er = 0`, smoothing degenerates to `slowAlpha²`
+ * but no change occurs because `src − prev` is itself 0 in the
+ * constant-source regime.
+ *
+ * @formula  fastAlpha = 2 / (fastLength + 1) ;
+ *           slowAlpha = 2 / (slowLength + 1) ;
+ *           change   = |src[t] − src[t − length]| ;
+ *           vol      = Σ_{j=0..length-1} |src[t − j] − src[t − j − 1]| ;
+ *           er       = vol > 0 ? change / vol : 0 ;
+ *           sc       = (er · (fastAlpha − slowAlpha) + slowAlpha)² ;
+ *           KAMA[t]  = KAMA[t − 1] + sc · (src[t] − KAMA[t − 1])
+ * @warmup   length
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const k = ta.kama(bar.close, { length: 10, fastLength: 2, slowLength: 30 });
+ *     // plot(k);
+ */
+export function kama(slotId, source, opts) {
+    const ctx = getCtx();
+    const length = opts?.length ?? DEFAULT_LENGTH;
+    const fastLength = opts?.fastLength ?? DEFAULT_FAST;
+    const slowLength = opts?.slowLength ?? DEFAULT_SLOW;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, fastLength, slowLength, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    if (ctx.isTick) {
+        // Tick replays the head off the existing closed window with
+        // `src` substituted at age 0; `prevClosedKama` is the recurrence
+        // anchor (the prior CLOSED bar's KAMA).
+        const value = computeKama(slot, src, slot.prevClosedKama);
+        slot.prevKama = Number.isFinite(value) ? value : slot.prevClosedKama;
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        slot.sourceWindow.append(src);
+        const value = computeKama(slot, src, slot.prevClosedKama);
+        slot.prevClosedKama = Number.isFinite(value) ? value : slot.prevClosedKama;
+        slot.prevKama = slot.prevClosedKama;
+        slot.outBuffer.append(value);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=kama.js.map

package/dist/ta/kama.js.map

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

package/dist/ta/keltner.d.ts

@@ -0,0 +1,31 @@
+import type { KeltnerOpts, KeltnerResult } from "@invinite-org/chartlang-core";
+/**
+ * Keltner Channels — overlay volatility envelope. Middle band is an
+ * `maType` MA of `bar.close` over `length`; upper / lower bands sit
+ * `multiplier · ATR(length)` above / below the middle. Defaults
+ * `length = 20`, `multiplier = 2`, `maType = "ema"` (Linda Raschke /
+ * TradingView canonical form — Chester Keltner's original used a
+ * different "typical range" formulation; every modern reference
+ * defaults to EMA + Wilder ATR). Composes the registered MA primitive
+ * via sub-slot `${slotId}/<maType>` and `ta.atr` via sub-slot
+ * `${slotId}/atr` — fixes to either flow in for free. Returns a
+ * cached `{ upper, middle, lower }` record (same identity every bar).
+ * NaN across all outputs while the trailing window is unwarmed.
+ *
+ * @formula  middle = MA(close, length, maType) ;
+ *           upper  = middle + multiplier · atr(length) ;
+ *           lower  = middle − multiplier · atr(length)
+ * @warmup   length
+ * @anchors  maType
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const k = ta.keltner({ length: 20, multiplier: 2 });
+ *     // plot(k.upper);
+ *     // plot(k.middle);
+ *     // plot(k.lower);
+ */
+export declare function keltner(slotId: string, opts?: KeltnerOpts): KeltnerResult;
+//# sourceMappingURL=keltner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keltner.d.ts","sourceRoot":"","sources":["../../src/ta/keltner.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EAGhB,MAAM,8BAA8B,CAAC;AAkEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAuCzE"}

package/dist/ta/keltner.js

@@ -0,0 +1,125 @@
+// 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/keltner.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. Keltner composes the registered MA primitive
+// (sma / ema / wma / smma) via sub-slot `${slotId}/<maType>` over
+// `bar.close` for the middle band, and `ta.atr` via sub-slot
+// `${slotId}/atr` for the band offset — so fixes to either flow in
+// for free (mirrors maRibbon / donchian composition convention).
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { atr } from "./atr.js";
+import { ema } from "./ema.js";
+import { sma } from "./sma.js";
+import { smma } from "./smma.js";
+import { wma } from "./wma.js";
+const DEFAULT_LENGTH = 20;
+const DEFAULT_MULTIPLIER = 2;
+const DEFAULT_MA_TYPE = "ema";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.keltner called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, multiplier, maType, capacity) {
+    return {
+        upperBuffer: new Float64RingBuffer(capacity),
+        lowerBuffer: new Float64RingBuffer(capacity),
+        length,
+        multiplier,
+        maType,
+        outputs: null,
+    };
+}
+function dispatchMa(maType, subSlotId, source, length) {
+    switch (maType) {
+        case "sma":
+            return sma(subSlotId, source, length);
+        case "ema":
+            return ema(subSlotId, source, length);
+        case "wma":
+            return wma(subSlotId, source, length);
+        case "smma":
+            return smma(subSlotId, source, length);
+    }
+}
+/**
+ * Keltner Channels — overlay volatility envelope. Middle band is an
+ * `maType` MA of `bar.close` over `length`; upper / lower bands sit
+ * `multiplier · ATR(length)` above / below the middle. Defaults
+ * `length = 20`, `multiplier = 2`, `maType = "ema"` (Linda Raschke /
+ * TradingView canonical form — Chester Keltner's original used a
+ * different "typical range" formulation; every modern reference
+ * defaults to EMA + Wilder ATR). Composes the registered MA primitive
+ * via sub-slot `${slotId}/<maType>` and `ta.atr` via sub-slot
+ * `${slotId}/atr` — fixes to either flow in for free. Returns a
+ * cached `{ upper, middle, lower }` record (same identity every bar).
+ * NaN across all outputs while the trailing window is unwarmed.
+ *
+ * @formula  middle = MA(close, length, maType) ;
+ *           upper  = middle + multiplier · atr(length) ;
+ *           lower  = middle − multiplier · atr(length)
+ * @warmup   length
+ * @anchors  maType
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const k = ta.keltner({ length: 20, multiplier: 2 });
+ *     // plot(k.upper);
+ *     // plot(k.middle);
+ *     // plot(k.lower);
+ */
+export function keltner(slotId, opts) {
+    const ctx = getCtx();
+    const length = opts?.length ?? DEFAULT_LENGTH;
+    const multiplier = opts?.multiplier ?? DEFAULT_MULTIPLIER;
+    const maType = opts?.maType ?? DEFAULT_MA_TYPE;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, multiplier, maType, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const close = ctx.stream.bar.close;
+    const middleSeries = dispatchMa(slot.maType, `${slotId}/${slot.maType}`, close, slot.length);
+    const atrSeries = atr(`${slotId}/atr`, slot.length);
+    if (slot.outputs === null) {
+        slot.outputs = Object.freeze({
+            upper: makeSeriesView(slot.upperBuffer),
+            middle: middleSeries,
+            lower: makeSeriesView(slot.lowerBuffer),
+        });
+    }
+    const mid = middleSeries.current;
+    const atrValue = atrSeries.current;
+    let upperValue;
+    let lowerValue;
+    if (Number.isFinite(mid) && Number.isFinite(atrValue)) {
+        upperValue = mid + slot.multiplier * atrValue;
+        lowerValue = mid - slot.multiplier * atrValue;
+    }
+    else {
+        upperValue = Number.NaN;
+        lowerValue = Number.NaN;
+    }
+    if (ctx.isTick) {
+        slot.upperBuffer.replaceHead(upperValue);
+        slot.lowerBuffer.replaceHead(lowerValue);
+    }
+    else {
+        slot.upperBuffer.append(upperValue);
+        slot.lowerBuffer.append(lowerValue);
+    }
+    return slot.outputs;
+}
+//# sourceMappingURL=keltner.js.map

package/dist/ta/keltner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keltner.js","sourceRoot":"","sources":["../../src/ta/keltner.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,0EAA0E;AAC1E,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,sEAAsE;AACtE,kEAAkE;AAClE,6DAA6D;AAC7D,mEAAmE;AACnE,iEAAiE;AASjE,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,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,eAAe,GAAmB,KAAK,CAAC;AAW9C,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CACb,MAAc,EACd,UAAkB,EAClB,MAAsB,EACtB,QAAgB;IAEhB,OAAO;QACH,WAAW,EAAE,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAC5C,WAAW,EAAE,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAC5C,MAAM;QACN,UAAU;QACV,MAAM;QACN,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CACf,MAAsB,EACtB,SAAiB,EACjB,MAAc,EACd,MAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,KAAK;YACN,OAAO,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,KAAK,KAAK;YACN,OAAO,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,KAAK,KAAK;YACN,OAAO,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,KAAK,MAAM;YACP,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAkB;IACtD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,cAAc,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,kBAAkB,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,eAAe,CAAC;IAC/C,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAA4B,CAAC;IACrE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7E,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,KAAK,CAAC;IACnC,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,MAAM,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,cAAc,CAAS,IAAI,CAAC,WAAW,CAAC;YAC/C,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,cAAc,CAAS,IAAI,CAAC,WAAW,CAAC;SAClD,CAAC,CAAC;IACP,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC;IACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;IACnC,IAAI,UAAkB,CAAC;IACvB,IAAI,UAAkB,CAAC;IACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,UAAU,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC9C,UAAU,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;IAClD,CAAC;SAAM,CAAC;QACJ,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC;QACxB,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/ta/klinger.d.ts

@@ -0,0 +1,32 @@
+import type { KlingerOpts, KlingerResult } from "@invinite-org/chartlang-core";
+/**
+ * Klinger Volume Oscillator. Per-bar Volume Force accumulator drives
+ * the difference of two EMAs (`fastLength` / `slowLength`); the
+ * signal line is a third EMA over the Klinger line. Defaults
+ * `(34, 55, 13)`. Composes 3 `ta.ema` sub-slots (`${slotId}/fastEma`,
+ * `${slotId}/slowEma`, `${slotId}/signalEma`). The user-facing
+ * `signal` Series IS the signalEma sub-slot's own Series view.
+ *
+ * Zero-volume bars emit `vf = 0` (no contribution); this matches
+ * invinite's `safeVolume`-style shape and the task spec's "no VF
+ * update" wording — zero-VF still flows into the EMAs, it just adds
+ * zero. The first bar emits `vf = 0` (seed only — no prior HLC to
+ * difference against).
+ *
+ * @formula  hlc[t] = high + low + close ;
+ *           trend  = hlc > prevHlc ? +1 : hlc < prevHlc ? −1 : prevTrend ;
+ *           dm     = high − low ; cm = trend === prevTrend ? prevCm + dm : prevDm + dm ;
+ *           vf     = cm ≠ 0 ? volume · |2·(dm/cm − 1)| · trend · 100 : 0 ;
+ *           klinger = ema(vf, fastLength) − ema(vf, slowLength) ;
+ *           signal  = ema(klinger, signalLength)
+ * @warmup   slowLength + signalLength − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const k = ta.klinger("slot");
+ *     // plot(k.klinger); plot(k.signal);
+ */
+export declare function klinger(slotId: string, opts?: KlingerOpts): KlingerResult;
+//# sourceMappingURL=klinger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"klinger.d.ts","sourceRoot":"","sources":["../../src/ta/klinger.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAU,MAAM,8BAA8B,CAAC;AAsGvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAsEzE"}

package/dist/ta/klinger.js

@@ -0,0 +1,165 @@
+// 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/klinger.ts
+//   (commit 078f41fe2569d659d5aba726da8bcb5d3e2ced02, © Invinite).
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 for the
+// provenance contract; the math is the reference, the code style is not.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape — NOT invinite's
+// IndicatorPlugin shape. Composition: three `ta.ema` sub-slots
+// (`${slotId}/fastEma`, `${slotId}/slowEma`, `${slotId}/signalEma`).
+// The Volume Force accumulator (trend / cm / dm) is bespoke
+// per-primitive state — no registry helper expresses VF.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { ema } from "./ema.js";
+const DEFAULT_FAST_LENGTH = 34;
+const DEFAULT_SLOW_LENGTH = 55;
+const DEFAULT_SIGNAL_LENGTH = 13;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.klinger called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const klingerBuf = new Float64RingBuffer(capacity);
+    return {
+        result: null,
+        klingerBuf,
+        klingerSeries: makeSeriesView(klingerBuf),
+        prevHlc: Number.NaN,
+        prevTrend: 0,
+        prevCm: 0,
+        prevDm: 0,
+        prevClosedHlc: Number.NaN,
+        prevClosedTrend: 0,
+        prevClosedCm: 0,
+        prevClosedDm: 0,
+        barCount: 0,
+    };
+}
+/**
+ * Volume Force given the bar OHLCV + the prior bar's (hlc, trend, cm,
+ * dm) snapshot. Returns the new (vf, trend, cm, dm) tuple.
+ *
+ * `vf = volume · |2 · (dm / cm − 1)| · trend · 100` when `cm` is
+ * finite and non-zero; else `vf = 0`. NaN price inputs hold the prior
+ * state forward (vf = 0).
+ */
+function computeVf(high, low, close, volume, baseHlc, baseTrend, baseCm, baseDm) {
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(close)) {
+        return { vf: 0, hlc: baseHlc, trend: baseTrend, cm: baseCm, dm: baseDm };
+    }
+    const hlc = high + low + close;
+    const dm = high - low;
+    let trend;
+    if (!Number.isFinite(baseHlc)) {
+        // First bar — no prior HLC. Seed trend = 0 (matches invinite's
+        // initialisation: `prevTrend = 0`), emit vf = 0, propagate
+        // baseDm = dm (subsequent bar's cm starts from this dm).
+        return { vf: 0, hlc, trend: 0, cm: 0, dm };
+    }
+    if (hlc > baseHlc)
+        trend = 1;
+    else if (hlc < baseHlc)
+        trend = -1;
+    else
+        trend = baseTrend;
+    const cm = trend === baseTrend ? baseCm + dm : baseDm + dm;
+    // Defensive: volume / vf-finite guards. Outer call site has already
+    // checked high / low / close are finite; volume can still be NaN on
+    // some exchanges, but the runtime feeds a finite default elsewhere.
+    /* c8 ignore next */
+    const volumeFinite = Number.isFinite(volume) ? volume : 0;
+    let vf = 0;
+    if (cm !== 0 && Number.isFinite(cm)) {
+        vf = volumeFinite * Math.abs(2 * (dm / cm - 1)) * trend * 100;
+        /* c8 ignore next */
+        if (!Number.isFinite(vf))
+            vf = 0;
+    }
+    return { vf, hlc, trend, cm, dm };
+}
+/**
+ * Klinger Volume Oscillator. Per-bar Volume Force accumulator drives
+ * the difference of two EMAs (`fastLength` / `slowLength`); the
+ * signal line is a third EMA over the Klinger line. Defaults
+ * `(34, 55, 13)`. Composes 3 `ta.ema` sub-slots (`${slotId}/fastEma`,
+ * `${slotId}/slowEma`, `${slotId}/signalEma`). The user-facing
+ * `signal` Series IS the signalEma sub-slot's own Series view.
+ *
+ * Zero-volume bars emit `vf = 0` (no contribution); this matches
+ * invinite's `safeVolume`-style shape and the task spec's "no VF
+ * update" wording — zero-VF still flows into the EMAs, it just adds
+ * zero. The first bar emits `vf = 0` (seed only — no prior HLC to
+ * difference against).
+ *
+ * @formula  hlc[t] = high + low + close ;
+ *           trend  = hlc > prevHlc ? +1 : hlc < prevHlc ? −1 : prevTrend ;
+ *           dm     = high − low ; cm = trend === prevTrend ? prevCm + dm : prevDm + dm ;
+ *           vf     = cm ≠ 0 ? volume · |2·(dm/cm − 1)| · trend · 100 : 0 ;
+ *           klinger = ema(vf, fastLength) − ema(vf, slowLength) ;
+ *           signal  = ema(klinger, signalLength)
+ * @warmup   slowLength + signalLength − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const k = ta.klinger("slot");
+ *     // plot(k.klinger); plot(k.signal);
+ */
+export function klinger(slotId, opts) {
+    const ctx = getCtx();
+    const fastLength = opts?.fastLength ?? DEFAULT_FAST_LENGTH;
+    const slowLength = opts?.slowLength ?? DEFAULT_SLOW_LENGTH;
+    const signalLength = opts?.signalLength ?? DEFAULT_SIGNAL_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 { high, low, close, volume } = ctx.stream.bar;
+    let vf;
+    if (ctx.isTick) {
+        // Replay the head's VF against the prior-close snapshot.
+        const step = computeVf(high, low, close, volume, slot.prevClosedHlc, slot.prevClosedTrend, slot.prevClosedCm, slot.prevClosedDm);
+        vf = step.vf;
+    }
+    else {
+        // Close-side. Snapshot prior-close BEFORE folding in.
+        slot.prevClosedHlc = slot.prevHlc;
+        slot.prevClosedTrend = slot.prevTrend;
+        slot.prevClosedCm = slot.prevCm;
+        slot.prevClosedDm = slot.prevDm;
+        const step = computeVf(high, low, close, volume, slot.prevHlc, slot.prevTrend, slot.prevCm, slot.prevDm);
+        vf = step.vf;
+        slot.prevHlc = step.hlc;
+        slot.prevTrend = step.trend;
+        slot.prevCm = step.cm;
+        slot.prevDm = step.dm;
+        slot.barCount += 1;
+    }
+    const fastSeries = ema(`${slotId}/fastEma`, vf, fastLength);
+    const slowSeries = ema(`${slotId}/slowEma`, vf, slowLength);
+    const fa = fastSeries.current;
+    const sa = slowSeries.current;
+    const klingerValue = Number.isFinite(fa) && Number.isFinite(sa) ? fa - sa : Number.NaN;
+    if (ctx.isTick)
+        slot.klingerBuf.replaceHead(klingerValue);
+    else
+        slot.klingerBuf.append(klingerValue);
+    const signalSeries = ema(`${slotId}/signalEma`, klingerValue, signalLength);
+    if (slot.result === null) {
+        slot.result = Object.freeze({
+            klinger: slot.klingerSeries,
+            signal: signalSeries,
+        });
+    }
+    return slot.result;
+}
+//# sourceMappingURL=klinger.js.map

package/dist/ta/klinger.js.map

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

package/dist/ta/kst.d.ts

@@ -0,0 +1,31 @@
+import type { KstOpts, KstResult } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Know Sure Thing (Martin Pring, 1992). Weighted sum of four SMA-
+ * smoothed percentage rate-of-change series plus an SMA signal line.
+ * Defaults `(10, 15, 20, 30, 10, 10, 10, 15, 9)` match Pring's
+ * canonical settings. Composes 4 `ta.sma` sub-slots
+ * (`${slotId}/r1Sma` .. `${slotId}/r4Sma`) for the smoothing layer
+ * plus one `ta.sma` sub-slot (`${slotId}/signalSma`) for the signal
+ * line. The percentage-ROC math is inline (mirrors `ta.coppock` —
+ * `ta.change` emits absolute deltas, not percentages).
+ *
+ * The user-facing `signal` Series IS the signalSma sub-slot's own
+ * Series view (no extra output buffer on the parent slot). The
+ * `kst` Series wraps the parent's own `kstBuf` ring. Result identity
+ * is captured on the first call and returned by reference thereafter.
+ *
+ * @formula  rN[t] = sma(pctRoc(source[t], source[t − rocNLength]), rocNSmooth) for N in 1..4 ;
+ *           kst[t] = r1 + 2·r2 + 3·r3 + 4·r4 ; NaN if any rN NaN ;
+ *           signal = sma(kst, signalLength)
+ * @warmup   max_N(rocNLength + rocNSmooth) + signalLength − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const k = ta.kst("slot", bar.close);
+ *     // plot(k.kst); plot(k.signal);
+ */
+export declare function kst(slotId: string, source: ScalarOrSeries, opts?: KstOpts): KstResult;
+//# sourceMappingURL=kst.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kst.d.ts","sourceRoot":"","sources":["../../src/ta/kst.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAU,MAAM,8BAA8B,CAAC;AAM/E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA+C5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAyErF"}