@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/historicalVolatility.js

@@ -0,0 +1,199 @@
+// 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/historical-volatility.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. The rolling log-returns window is folded
+// incrementally per bar (one append per close, one head-replace per
+// tick) rather than invinite's full-array recompute. The Phase-1
+// `lib/rollingStddev` helper is the full-recompute reference the
+// property test asserts against.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_ANNUALISATION_FACTOR = 365;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.historicalVolatility called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, annualisationFactor, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        annualisationFactor,
+        logReturnsWindow: new Float64RingBuffer(length),
+        sumX: 0,
+        sumX2: 0,
+        prevSrc: Number.NaN,
+        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 logReturn(prev, cur) {
+    if (!Number.isFinite(prev) || !Number.isFinite(cur) || prev <= 0 || cur <= 0) {
+        return Number.NaN;
+    }
+    return Math.log(cur / prev);
+}
+function windowStdDev(window, sumX, sumX2) {
+    const n = window.length;
+    // Defensive: callers gate on `length === capacity` so n > 0 here.
+    /* c8 ignore next */
+    if (n <= 0)
+        return Number.NaN;
+    const mean = sumX / n;
+    const variance = sumX2 / n - mean * mean;
+    return Math.sqrt(Math.max(0, variance));
+}
+/**
+ * Recompute the window-sums by walking the buffer. Called when a NaN
+ * has been folded into the running sums (which would otherwise poison
+ * every subsequent recompute) — restores the running invariant from
+ * the live window contents. O(length) but only runs when needed.
+ */
+function recomputeSums(slot) {
+    let sumX = 0;
+    let sumX2 = 0;
+    let anyNaN = false;
+    for (let i = 0; i < slot.logReturnsWindow.length; i += 1) {
+        const v = slot.logReturnsWindow.at(slot.logReturnsWindow.length - 1 - i);
+        if (!Number.isFinite(v)) {
+            anyNaN = true;
+            break;
+        }
+        sumX += v;
+        sumX2 += v * v;
+    }
+    if (anyNaN) {
+        slot.sumX = Number.NaN;
+        slot.sumX2 = Number.NaN;
+    }
+    else {
+        slot.sumX = sumX;
+        slot.sumX2 = sumX2;
+    }
+}
+function closeValue(slot, src) {
+    const lr = logReturn(slot.prevSrc, src);
+    if (slot.logReturnsWindow.length < slot.logReturnsWindow.capacity) {
+        slot.logReturnsWindow.append(lr);
+        if (Number.isFinite(lr)) {
+            slot.sumX += lr;
+            slot.sumX2 += lr * lr;
+        }
+        else {
+            slot.sumX = Number.NaN;
+            slot.sumX2 = Number.NaN;
+        }
+        slot.prevSrc = src;
+        return Number.NaN;
+    }
+    const outgoing = slot.logReturnsWindow.at(slot.logReturnsWindow.length - 1);
+    slot.logReturnsWindow.append(lr);
+    if (!Number.isFinite(lr)) {
+        slot.sumX = Number.NaN;
+        slot.sumX2 = Number.NaN;
+    }
+    else if (!Number.isFinite(slot.sumX) ||
+        /* c8 ignore next */
+        !Number.isFinite(outgoing)) {
+        // A previous NaN poisoned the running sums; rebuild from the
+        // live window. NaN inside short-circuits to NaN. The
+        // `!Number.isFinite(outgoing)` half of the OR is defensive —
+        // outgoing comes from the live window head and is only NaN
+        // when a NaN was previously appended, which also poisoned
+        // `sumX` (covered by the first half of the OR).
+        recomputeSums(slot);
+    }
+    else {
+        slot.sumX = slot.sumX - outgoing + lr;
+        slot.sumX2 = slot.sumX2 - outgoing * outgoing + lr * lr;
+    }
+    slot.prevSrc = src;
+    if (!Number.isFinite(slot.sumX))
+        return Number.NaN;
+    const sd = windowStdDev(slot.logReturnsWindow, slot.sumX, slot.sumX2);
+    return sd * Math.sqrt(slot.annualisationFactor) * 100;
+}
+function tickValue(slot, src) {
+    if (slot.logReturnsWindow.length < slot.logReturnsWindow.capacity)
+        return Number.NaN;
+    const lr = logReturn(slot.prevSrc, src);
+    if (!Number.isFinite(lr) || !Number.isFinite(slot.sumX))
+        return Number.NaN;
+    const oldestInHead = slot.logReturnsWindow.at(0);
+    // Defensive: the close-side advance appends a finite lr (otherwise
+    // sumX is poisoned and we returned at the guard above). The window
+    // head can only be NaN if a prior NaN was appended, which is
+    // already covered by the sumX guard.
+    /* c8 ignore next */
+    if (!Number.isFinite(oldestInHead))
+        return Number.NaN;
+    const sumX = slot.sumX - oldestInHead + lr;
+    const sumX2 = slot.sumX2 - oldestInHead * oldestInHead + lr * lr;
+    const n = slot.logReturnsWindow.length;
+    const mean = sumX / n;
+    const variance = sumX2 / n - mean * mean;
+    return Math.sqrt(Math.max(0, variance)) * Math.sqrt(slot.annualisationFactor) * 100;
+}
+/**
+ * Historical Volatility — sub-pane line. Standard deviation of log
+ * returns annualised + percent-scaled. Use `annualisationFactor: 365`
+ * for crypto / 24-7 series (the default), `252` for trading-day
+ * equity series. NaN through warmup (`[0, length − 1]`) — the first
+ * log return lands at bar 1 and the window needs `length` of them.
+ * NaN inputs (≤ 0 or non-finite source) yield NaN log-returns; any
+ * NaN inside the window short-circuits the output to NaN.
+ *
+ * @formula  lr[t]  = ln(src[t] / src[t − 1]) ;
+ *           hv[t]  = stddev(lr[t − length + 1..= t]) · sqrt(annualisationFactor) · 100
+ * @warmup   length
+ * @anchors  annualisationFactor
+ * @since 0.2
+ * @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-core";
+ *     // const hv = ta.historicalVolatility(bar.close, 10);
+ *     // plot(hv);
+ */
+export function historicalVolatility(slotId, source, length, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        const annualisationFactor = opts?.annualisationFactor ?? DEFAULT_ANNUALISATION_FACTOR;
+        slot = initSlot(length, annualisationFactor, 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 viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=historicalVolatility.js.map

package/dist/ta/historicalVolatility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historicalVolatility.js","sourceRoot":"","sources":["../../src/ta/historicalVolatility.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,wFAAwF;AACxF,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,kEAAkE;AAClE,oEAAoE;AACpE,iEAAiE;AACjE,iEAAiE;AACjE,iCAAiC;AAIjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAuB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAgBzC,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,mBAA2B,EAAE,QAAgB;IAC3E,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO;QACH,SAAS;QACT,MAAM,EAAE,cAAc,CAAS,SAAS,CAAC;QACzC,MAAM;QACN,mBAAmB;QACnB,gBAAgB,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAC/C,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,MAAM,CAAC,GAAG;QACnB,YAAY,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAAc;IAC/C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrC,IAAI,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,qBAAqB,CAAS,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,MAAyB,EAAE,IAAY,EAAE,KAAa;IACxE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,kEAAkE;IAClE,oBAAoB;IACpB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM;QACV,CAAC;QACD,IAAI,IAAI,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC;IAC5B,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,GAAW;IACzC,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAChE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,OAAO,MAAM,CAAC,GAAG,CAAC;IACtB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC;IAC5B,CAAC;SAAM,IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3B,oBAAoB;QACpB,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC5B,CAAC;QACC,6DAA6D;QAC7D,qDAAqD;QACrD,6DAA6D;QAC7D,2DAA2D;QAC3D,0DAA0D;QAC1D,gDAAgD;QAChD,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,GAAG,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,GAAG,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;IACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IACnD,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,GAAW;IACxC,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IACrF,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,mEAAmE;IACnE,mEAAmE;IACnE,6DAA6D;IAC7D,qCAAqC;IACrC,oBAAoB;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,YAAY,GAAG,YAAY,GAAG,EAAE,GAAG,EAAE,CAAC;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,oBAAoB,CAChC,MAAc,EACd,MAAsB,EACtB,MAAc,EACd,IAAa;IAEb,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAuB,CAAC;IAChE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,mBAAmB,GAAG,IAAI,EAAE,mBAAmB,IAAI,4BAA4B,CAAC;QACtF,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/ta/hma.d.ts

@@ -0,0 +1,28 @@
+import type { HmaOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Hull moving average — `WMA(2·WMA(src, N/2) − WMA(src, N), sqrt(N))`.
+ * Composes three WMA sub-slots derived from the parent slot id
+ * (`${slotId}/half`, `${slotId}/full`, `${slotId}/final`). The intermediate
+ * `diff = 2·halfWMA − fullWMA` is a scalar passed into the final WMA;
+ * no separate primitive owns the diff stream. Warmup is the full chain:
+ * `length + ceil(sqrt(length)) − 2`. Tick-mode propagates through every
+ * sub-slot's replace-head branch.
+ *
+ * @formula  halfLen = floor(length / 2) ;
+ *           sqrtLen = round(sqrt(length)) ;
+ *           half   = WMA(source, halfLen) ;
+ *           full   = WMA(source, length) ;
+ *           diff   = 2 · half − full ;
+ *           out    = WMA(diff, sqrtLen)
+ * @warmup   length + ceil(sqrt(length)) − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const h = ta.hma(bar.close, 21);
+ *     // plot(h);
+ */
+export declare function hma(slotId: string, source: ScalarOrSeries, length: number, _opts?: HmaOpts): Series<number>;
+//# sourceMappingURL=hma.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hma.d.ts","sourceRoot":"","sources":["../../src/ta/hma.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAe5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,GAAG,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,CAAC,CAkBhB"}

package/dist/ta/hma.js

@@ -0,0 +1,64 @@
+// 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/hma.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. The HMA primitive composes three WMA sub-
+// slots derived from the parent slot id.
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+import { wma } from "./wma.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.hma called outside an active script step");
+    }
+    return ctx;
+}
+/**
+ * Hull moving average — `WMA(2·WMA(src, N/2) − WMA(src, N), sqrt(N))`.
+ * Composes three WMA sub-slots derived from the parent slot id
+ * (`${slotId}/half`, `${slotId}/full`, `${slotId}/final`). The intermediate
+ * `diff = 2·halfWMA − fullWMA` is a scalar passed into the final WMA;
+ * no separate primitive owns the diff stream. Warmup is the full chain:
+ * `length + ceil(sqrt(length)) − 2`. Tick-mode propagates through every
+ * sub-slot's replace-head branch.
+ *
+ * @formula  halfLen = floor(length / 2) ;
+ *           sqrtLen = round(sqrt(length)) ;
+ *           half   = WMA(source, halfLen) ;
+ *           full   = WMA(source, length) ;
+ *           diff   = 2 · half − full ;
+ *           out    = WMA(diff, sqrtLen)
+ * @warmup   length + ceil(sqrt(length)) − 2
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const h = ta.hma(bar.close, 21);
+ *     // plot(h);
+ */
+export function hma(slotId, source, length, _opts) {
+    const ctx = getCtx();
+    const halfLen = Math.max(1, Math.floor(length / 2));
+    const sqrtLen = Math.max(1, Math.round(Math.sqrt(length)));
+    const src = readSourceValue(source);
+    const halfSeries = wma(`${slotId}/half`, src, halfLen);
+    const fullSeries = wma(`${slotId}/full`, src, length);
+    const ha = halfSeries.current;
+    const fa = fullSeries.current;
+    const diff = Number.isFinite(ha) && Number.isFinite(fa) ? 2 * ha - fa : Number.NaN;
+    const finalSeries = wma(`${slotId}/final`, diff, sqrtLen);
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = { series: finalSeries };
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=hma.js.map

package/dist/ta/hma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hma.js","sourceRoot":"","sources":["../../src/ta/hma.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,0DAA0D;AAC1D,yEAAyE;AACzE,qEAAqE;AACrE,4DAA4D;AAC5D,mEAAmE;AACnE,yCAAyC;AAIzC,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAuB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAM/B,SAAS,MAAM;IACX,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,GAAG,CACf,MAAc,EACd,MAAsB,EACtB,MAAc,EACd,KAAe;IAEf,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9B,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9B,MAAM,IAAI,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;IACnF,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,MAAM,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1D,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAwB,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,IAAI,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/ta/ichimoku.d.ts

@@ -0,0 +1,42 @@
+import type { IchimokuOpts, IchimokuResult } from "@invinite-org/chartlang-core";
+/**
+ * Ichimoku Cloud — five-line trend / cloud overlay. Composes six
+ * `ta.highest` / `ta.lowest` sub-slots (Tenkan high+low, Kijun
+ * high+low, Senkou B high+low) — the same composition seam
+ * `ta.donchian` uses — so a fix to either rolling-extreme primitive
+ * flows in for free. Forward-displaced Senkou A / Senkou B and
+ * backward-displaced Chikou are produced via per-slot delay ring
+ * buffers of capacity `displacement + 1`.
+ *
+ * `chikou.current` returns `close[t − displacement]` (the close from
+ * `displacement` bars ago, plotted at today's position — the
+ * lagging-span semantic). Renderer-side, the script author may
+ * choose to draw it at the visually-offset position; the runtime
+ * exposes the backward-shifted value so script-author conditionals
+ * (cross / alert) see meaningful data.
+ *
+ * @formula  tenkan[t]  = (highest(high, conversionLength) + lowest(low, conversionLength)) / 2 ;
+ *           kijun[t]   = (highest(high, baseLength)       + lowest(low, baseLength))       / 2 ;
+ *           senkouARaw = (tenkan + kijun) / 2 ;
+ *           senkouBRaw = (highest(high, leadingSpanBLength) + lowest(low, leadingSpanBLength)) / 2 ;
+ *           senkouA[t] = senkouARaw[t − displacement] ;
+ *           senkouB[t] = senkouBRaw[t − displacement] ;
+ *           chikou[t]  = close[t − displacement]
+ * @anchors  displacement, conversionLength, baseLength, leadingSpanBLength
+ * @warmup   max(conversionLength, baseLength, leadingSpanBLength) + displacement − 1
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts all five outputs in lockstep (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const i = ta.ichimoku("slot");
+ *     // plot(i.tenkan);
+ *     // plot(i.kijun);
+ *     // plot(i.senkouA);
+ *     // plot(i.senkouB);
+ *     // plot(i.chikou);
+ */
+export declare function ichimoku(slotId: string, opts?: IchimokuOpts): IchimokuResult;
+//# sourceMappingURL=ichimoku.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ichimoku.d.ts","sourceRoot":"","sources":["../../src/ta/ichimoku.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAqHjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,cAAc,CA8D5E"}

package/dist/ta/ichimoku.js

@@ -0,0 +1,188 @@
+// 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/ichimoku.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. Ichimoku composes six `ta.highest` / `ta.lowest`
+// sub-slots (one pair each for Tenkan / Kijun / Senkou B) — the same
+// composition seam `donchian.ts` uses — so a fix to highest/lowest
+// flows in for free. The forward-displaced Senkou A / Senkou B and
+// backward-displaced Chikou are produced via per-slot delay ring
+// buffers of capacity `displacement + 1`.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { highest } from "./highest.js";
+import { lowest } from "./lowest.js";
+const DEFAULT_CONVERSION_LENGTH = 9;
+const DEFAULT_BASE_LENGTH = 26;
+const DEFAULT_LEADING_SPAN_B_LENGTH = 52;
+const DEFAULT_DISPLACEMENT = 26;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.ichimoku called outside an active script step");
+    }
+    return ctx;
+}
+function midpoint(hi, lo) {
+    if (!Number.isFinite(hi) || !Number.isFinite(lo))
+        return Number.NaN;
+    return (hi + lo) / 2;
+}
+function spanAverage(a, b) {
+    if (!Number.isFinite(a) || !Number.isFinite(b))
+        return Number.NaN;
+    return (a + b) / 2;
+}
+function delayedValue(delay, displacement) {
+    if (delay.length <= displacement)
+        return Number.NaN;
+    return delay.at(displacement);
+}
+function initSlot(capacity, conversionLength, baseLength, leadingSpanBLength, displacement) {
+    const tenkanBuffer = new Float64RingBuffer(capacity);
+    const kijunBuffer = new Float64RingBuffer(capacity);
+    const senkouABuffer = new Float64RingBuffer(capacity);
+    const senkouBBuffer = new Float64RingBuffer(capacity);
+    const chikouBuffer = new Float64RingBuffer(capacity);
+    // The delay ring buffers need only `displacement + 1` slots — at
+    // each close we append the new raw value; `at(displacement)`
+    // returns the value from `displacement` closes ago.
+    const delayCap = displacement + 1;
+    return {
+        outputs: Object.freeze({
+            tenkan: makeSeriesView(tenkanBuffer),
+            kijun: makeSeriesView(kijunBuffer),
+            senkouA: makeSeriesView(senkouABuffer),
+            senkouB: makeSeriesView(senkouBBuffer),
+            chikou: makeSeriesView(chikouBuffer),
+        }),
+        tenkanBuffer,
+        kijunBuffer,
+        senkouABuffer,
+        senkouBBuffer,
+        chikouBuffer,
+        conversionLength,
+        baseLength,
+        leadingSpanBLength,
+        displacement,
+        senkouADelay: new Float64RingBuffer(delayCap),
+        senkouBDelay: new Float64RingBuffer(delayCap),
+        closeDelay: new Float64RingBuffer(delayCap),
+        shiftedResults: new Map(),
+    };
+}
+function resultForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.outputs;
+    let cached = slot.shiftedResults.get(offset);
+    if (cached === undefined) {
+        cached = Object.freeze({
+            tenkan: makeShiftedSeriesView(slot.tenkanBuffer, offset),
+            kijun: makeShiftedSeriesView(slot.kijunBuffer, offset),
+            senkouA: makeShiftedSeriesView(slot.senkouABuffer, offset),
+            senkouB: makeShiftedSeriesView(slot.senkouBBuffer, offset),
+            chikou: makeShiftedSeriesView(slot.chikouBuffer, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+/**
+ * Ichimoku Cloud — five-line trend / cloud overlay. Composes six
+ * `ta.highest` / `ta.lowest` sub-slots (Tenkan high+low, Kijun
+ * high+low, Senkou B high+low) — the same composition seam
+ * `ta.donchian` uses — so a fix to either rolling-extreme primitive
+ * flows in for free. Forward-displaced Senkou A / Senkou B and
+ * backward-displaced Chikou are produced via per-slot delay ring
+ * buffers of capacity `displacement + 1`.
+ *
+ * `chikou.current` returns `close[t − displacement]` (the close from
+ * `displacement` bars ago, plotted at today's position — the
+ * lagging-span semantic). Renderer-side, the script author may
+ * choose to draw it at the visually-offset position; the runtime
+ * exposes the backward-shifted value so script-author conditionals
+ * (cross / alert) see meaningful data.
+ *
+ * @formula  tenkan[t]  = (highest(high, conversionLength) + lowest(low, conversionLength)) / 2 ;
+ *           kijun[t]   = (highest(high, baseLength)       + lowest(low, baseLength))       / 2 ;
+ *           senkouARaw = (tenkan + kijun) / 2 ;
+ *           senkouBRaw = (highest(high, leadingSpanBLength) + lowest(low, leadingSpanBLength)) / 2 ;
+ *           senkouA[t] = senkouARaw[t − displacement] ;
+ *           senkouB[t] = senkouBRaw[t − displacement] ;
+ *           chikou[t]  = close[t − displacement]
+ * @anchors  displacement, conversionLength, baseLength, leadingSpanBLength
+ * @warmup   max(conversionLength, baseLength, leadingSpanBLength) + displacement − 1
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts all five outputs in lockstep (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const i = ta.ichimoku("slot");
+ *     // plot(i.tenkan);
+ *     // plot(i.kijun);
+ *     // plot(i.senkouA);
+ *     // plot(i.senkouB);
+ *     // plot(i.chikou);
+ */
+export function ichimoku(slotId, opts) {
+    const ctx = getCtx();
+    const conversionLength = opts?.conversionLength ?? DEFAULT_CONVERSION_LENGTH;
+    const baseLength = opts?.baseLength ?? DEFAULT_BASE_LENGTH;
+    const leadingSpanBLength = opts?.leadingSpanBLength ?? DEFAULT_LEADING_SPAN_B_LENGTH;
+    const displacement = opts?.displacement ?? DEFAULT_DISPLACEMENT;
+    const offset = opts?.offset ?? 0;
+    const bar = ctx.stream.bar;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, conversionLength, baseLength, leadingSpanBLength, displacement);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    // Compose: rolling extremes via the registered ta.highest /
+    // ta.lowest sub-slots. Each composed call advances the sub-slot on
+    // the same close (or replaces its head on the same tick).
+    const tenkanHi = highest(`${slotId}/tenkanHigh`, bar.high, conversionLength).current;
+    const tenkanLo = lowest(`${slotId}/tenkanLow`, bar.low, conversionLength).current;
+    const kijunHi = highest(`${slotId}/kijunHigh`, bar.high, baseLength).current;
+    const kijunLo = lowest(`${slotId}/kijunLow`, bar.low, baseLength).current;
+    const senkouBHi = highest(`${slotId}/senkouBHigh`, bar.high, leadingSpanBLength).current;
+    const senkouBLo = lowest(`${slotId}/senkouBLow`, bar.low, leadingSpanBLength).current;
+    const tenkan = midpoint(tenkanHi, tenkanLo);
+    const kijun = midpoint(kijunHi, kijunLo);
+    const senkouBRaw = midpoint(senkouBHi, senkouBLo);
+    const senkouARaw = spanAverage(tenkan, kijun);
+    if (ctx.isTick) {
+        // Replace the head of the delay buffers with the tick's
+        // updated raw values. `at(displacement)` then returns the
+        // SAME value as before (the displacement-shifted slot is not
+        // affected by the head's value), so the displaced output
+        // heads are stable on tick.
+        slot.senkouADelay.replaceHead(senkouARaw);
+        slot.senkouBDelay.replaceHead(senkouBRaw);
+        slot.closeDelay.replaceHead(bar.close);
+        slot.tenkanBuffer.replaceHead(tenkan);
+        slot.kijunBuffer.replaceHead(kijun);
+        slot.senkouABuffer.replaceHead(delayedValue(slot.senkouADelay, displacement));
+        slot.senkouBBuffer.replaceHead(delayedValue(slot.senkouBDelay, displacement));
+        slot.chikouBuffer.replaceHead(delayedValue(slot.closeDelay, displacement));
+    }
+    else {
+        slot.senkouADelay.append(senkouARaw);
+        slot.senkouBDelay.append(senkouBRaw);
+        slot.closeDelay.append(bar.close);
+        slot.tenkanBuffer.append(tenkan);
+        slot.kijunBuffer.append(kijun);
+        slot.senkouABuffer.append(delayedValue(slot.senkouADelay, displacement));
+        slot.senkouBBuffer.append(delayedValue(slot.senkouBDelay, displacement));
+        slot.chikouBuffer.append(delayedValue(slot.closeDelay, displacement));
+    }
+    return resultForOffset(slot, offset);
+}
+//# sourceMappingURL=ichimoku.js.map

package/dist/ta/ichimoku.js.map

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

package/dist/ta/index.d.ts

@@ -0,0 +1,5 @@
+export { TA_REGISTRY, ta } from "./registry.js";
+export type { RuntimeTaNamespace } from "./registry.js";
+export { maRibbonOutputKeys } from "./maRibbon.js";
+export type { ScalarOrSeries } from "./lib/sourceValue.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ta/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/ta/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { TA_REGISTRY, ta } from "./registry.js";
+export { maRibbonOutputKeys } from "./maRibbon.js";
+//# sourceMappingURL=index.js.map

package/dist/ta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ta/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/ta/kama.d.ts

@@ -0,0 +1,35 @@
+import type { KamaOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * 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 declare function kama(slotId: string, source: ScalarOrSeries, opts?: KamaOpts): Series<number>;
+//# sourceMappingURL=kama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kama.d.ts","sourceRoot":"","sources":["../../src/ta/kama.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAKrE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAyF5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CA0B5F"}