@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/fisher.js

@@ -0,0 +1,174 @@
+// 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/fisher.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: `ta.highest` + `ta.lowest`
+// sub-slots over `bar.hl2`; the clamp / atanh / EMA-blend recurrence
+// is inline (no registry helper expresses Fisher's bespoke α=0.66/0.67
+// blend).
+//
+// DIVERGENCE: invinite clamps `x` to ±0.999 before the `atanh` so the
+// transform never diverges. The task spec (§6) overrides this: when
+// `|x| ≥ 1` we emit NaN at `fisher` AND hold the recurrence state
+// (`prevX` / `prevFisher` carry forward unchanged so the next bar
+// continues from the last valid state).
+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.fisher called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const fisherBuf = new Float64RingBuffer(capacity);
+    const triggerBuf = new Float64RingBuffer(capacity);
+    return {
+        result: null,
+        fisherBuf,
+        triggerBuf,
+        fisherSeries: makeSeriesView(fisherBuf),
+        triggerSeries: makeSeriesView(triggerBuf),
+        length,
+        prevX: 0,
+        prevFisher: 0,
+        prevClosedX: 0,
+        prevClosedFisher: 0,
+        barCount: 0,
+    };
+}
+/**
+ * Compute `(fisherValue, triggerValue, nextX, nextFisher)` given the
+ * normalised mid + the basis `(baseX, baseFisher)` snapshot. The
+ * `triggerValue` written is the input `baseFisher` (Fisher's
+ * 1-bar-lagged trigger). NaN at `fisher` propagates as a "no-update"
+ * to `nextX` / `nextFisher` so the recurrence holds.
+ */
+function computeStep(normalised, baseX, baseFisher) {
+    const x = 0.66 * normalised + 0.67 * baseX;
+    // Defensive: normalised ∈ [-0.5, 0.5] means x asymptotes to ±1.0
+    // but never crosses under exact arithmetic. Keep the clamp so a
+    // pathological floating-point overshoot produces NaN rather than
+    // ±Infinity from `ln((1+x)/(1-x))`.
+    /* c8 ignore start */
+    if (Math.abs(x) >= 1) {
+        return {
+            fisherValue: Number.NaN,
+            triggerValue: baseFisher,
+            nextX: baseX,
+            nextFisher: baseFisher,
+        };
+    }
+    /* c8 ignore stop */
+    const fisherValue = 0.5 * Math.log((1 + x) / (1 - x)) + 0.5 * baseFisher;
+    return { fisherValue, triggerValue: baseFisher, nextX: x, nextFisher: fisherValue };
+}
+/**
+ * John Ehlers' Fisher Transform. Normalises the rolling `bar.hl2`
+ * midpoint to `[-0.5, 0.5]` over a `length`-bar window, blends with
+ * the prior `x` (`0.66·norm + 0.67·prevX`), then applies the Fisher
+ * z-transform `0.5·ln((1+x)/(1−x))` with an EMA-style blend against
+ * the prior Fisher. Composes `ta.highest` + `ta.lowest` sub-slots over
+ * `bar.hl2` (`${slotId}/midHigh` + `${slotId}/midLow`). The clamp /
+ * atanh / blend recurrence stays inline (no registry equivalent).
+ *
+ * The `trigger` output is the prior bar's `fisher` value (1-bar lag);
+ * bar 0's `trigger` is NaN. When the recurrence would drive `|x| ≥ 1`
+ * (pathological case), emits NaN at `fisher` and holds the recurrence
+ * state — diverges from invinite's ±0.999 clamp per task spec.
+ *
+ * @formula  mid        = (bar.high + bar.low) / 2 ;
+ *           normalised = flatRange ? 0 : (mid − ll) / (hh − ll) − 0.5
+ *                        where hh = highest(mid, length), ll = lowest(mid, length) ;
+ *           x          = 0.66 · normalised + 0.67 · prevX ;
+ *           NaN at fisher if |x| ≥ 1 (recurrence held) ;
+ *           fisher     = 0.5 · ln((1 + x) / (1 − x)) + 0.5 · prevFisher ;
+ *           trigger[t] = prevFisher (the value of fisher before this close)
+ * @warmup   length (first defined `fisher` at bar `length - 1`; first defined `trigger` at bar `length`)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const f = ta.fisher("slot", 9);
+ *     // plot(f.fisher); plot(f.trigger);
+ */
+export function fisher(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 mid = ctx.stream.bar.hl2;
+    const hhSeries = highest(`${slotId}/midHigh`, mid, length);
+    const llSeries = lowest(`${slotId}/midLow`, mid, length);
+    const hh = hhSeries.current;
+    const ll = llSeries.current;
+    let normalised;
+    if (!Number.isFinite(mid) || !Number.isFinite(hh) || !Number.isFinite(ll)) {
+        normalised = Number.NaN;
+    }
+    else if (hh === ll) {
+        normalised = 0;
+    }
+    else {
+        normalised = (mid - ll) / (hh - ll) - 0.5;
+    }
+    if (ctx.isTick) {
+        // Replay against the prevClosed* snapshot — the closed-side
+        // (prevX, prevFisher) are unchanged by the tick.
+        const step = Number.isFinite(normalised)
+            ? computeStep(normalised, slot.prevClosedX, slot.prevClosedFisher)
+            : {
+                fisherValue: Number.NaN,
+                triggerValue: slot.prevClosedFisher,
+                nextX: slot.prevClosedX,
+                nextFisher: slot.prevClosedFisher,
+            };
+        // First-bar trigger is NaN (no prior fisher) — barCount captures
+        // the closed-side advances. Defensive: ticks always follow at
+        // least one close, so barCount > 0 on this branch.
+        const triggerOut = 
+        /* c8 ignore next */ slot.barCount === 0 ? Number.NaN : step.triggerValue;
+        slot.fisherBuf.replaceHead(step.fisherValue);
+        slot.triggerBuf.replaceHead(triggerOut);
+    }
+    else {
+        // Close-side. Snapshot the closed state BEFORE the update so the
+        // next tick can replay against (prevClosedX, prevClosedFisher).
+        slot.prevClosedX = slot.prevX;
+        slot.prevClosedFisher = slot.prevFisher;
+        const step = Number.isFinite(normalised)
+            ? computeStep(normalised, slot.prevX, slot.prevFisher)
+            : {
+                fisherValue: Number.NaN,
+                triggerValue: slot.prevFisher,
+                nextX: slot.prevX,
+                nextFisher: slot.prevFisher,
+            };
+        const triggerOut = slot.barCount === 0 ? Number.NaN : step.triggerValue;
+        slot.fisherBuf.append(step.fisherValue);
+        slot.triggerBuf.append(triggerOut);
+        slot.prevX = step.nextX;
+        slot.prevFisher = step.nextFisher;
+        slot.barCount += 1;
+    }
+    if (slot.result === null) {
+        slot.result = Object.freeze({
+            fisher: slot.fisherSeries,
+            trigger: slot.triggerSeries,
+        });
+    }
+    return slot.result;
+}
+//# sourceMappingURL=fisher.js.map

package/dist/ta/fisher.js.map

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

package/dist/ta/fixedRangeVolumeProfile.d.ts

@@ -0,0 +1,30 @@
+import type { FixedRangeVolumeProfileOpts, FixedRangeVolumeProfileResult } from "@invinite-org/chartlang-core";
+/**
+ * Fixed-Range Volume Profile — bucketizes volume between two
+ * user-picked time anchors, inclusive on both ends.
+ *
+ * Bars before `opts.from` emit NaN. Bars after `opts.to` reuse the
+ * frozen profile captured at the `to` bar. If `opts.from > opts.to`,
+ * the primitive emits one `fixed-range-inverted` diagnostic per slot
+ * and returns NaN series values.
+ *
+ * @formula  Port of invinite fixed-range-vp: collect candles in the
+ *           fixed `[from, to]` window, bucket volume by price, then
+ *           derive POC / value-area high / value-area low through the
+ *           shared volume-profile pipeline.
+ * @anchors  `opts.from: Time` and `opts.to: Time`, typically supplied
+ *           by two `input.time(..., { pickFromChart: true })` inputs.
+ * @warmup   NaN before `opts.from`; a degenerate `from === to`
+ *           one-bar window can emit on the anchor bar when it has
+ *           finite positive volume.
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { input, plot, ta } from "@invinite-org/chartlang-core";
+ *     // const from = input.time(0, { pickFromChart: true, title: "From" });
+ *     // const to = input.time(0, { pickFromChart: true, title: "To" });
+ *     // const vp = ta.fixedRangeVolumeProfile({ from: from.value, to: to.value });
+ *     // plot(vp.poc, { style: { kind: "horizontal-histogram", buckets: vp.buckets } });
+ */
+export declare function fixedRangeVolumeProfile(slotId: string, opts: FixedRangeVolumeProfileOpts): FixedRangeVolumeProfileResult;
+//# sourceMappingURL=fixedRangeVolumeProfile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixedRangeVolumeProfile.d.ts","sourceRoot":"","sources":["../../src/ta/fixedRangeVolumeProfile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,2BAA2B,EAC3B,6BAA6B,EAChC,MAAM,8BAA8B,CAAC;AA6GtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,2BAA2B,GAClC,6BAA6B,CAkC/B"}

package/dist/ta/fixedRangeVolumeProfile.js

@@ -0,0 +1,141 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// Ported from ../invinite/src/components/trading-chart/indicators/fixed-range-volume-profile.ts
+//   @ 3234c8c0c3f9880d9d1e3a3ee63ebd55ddd535f4.
+// Translated, not transcribed — Series<T> shape, opts.offset, JSDoc.
+// See packages/runtime/src/ta/CLAUDE.md for the port convention.
+import { pushDiagnostic } from "../emit/index.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { commitVolumeProfileSnapshot, createVolumeProfileCore, emitVolumeProfileHistogram, emptyVolumeProfileSnapshot, resolveVolumeProfileSnapshot, volumeProfileConfigFromOpts, } from "./lib/volume-profile/index.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.fixedRangeVolumeProfile called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const core = createVolumeProfileCore(capacity);
+    const slot = {
+        ...core,
+        frozen: null,
+        result: Object.freeze({
+            get buckets() {
+                return slot.buckets;
+            },
+            poc: makeSeriesView(core.pocBuffer),
+            valHigh: makeSeriesView(core.valHighBuffer),
+            valLow: makeSeriesView(core.valLowBuffer),
+        }),
+        shiftedResults: new Map(),
+    };
+    return slot;
+}
+function resultForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.result;
+    let cached = slot.shiftedResults.get(offset);
+    if (cached === undefined) {
+        cached = Object.freeze({
+            get buckets() {
+                return slot.buckets;
+            },
+            poc: makeShiftedSeriesView(slot.pocBuffer, offset),
+            valHigh: makeShiftedSeriesView(slot.valHighBuffer, offset),
+            valLow: makeShiftedSeriesView(slot.valLowBuffer, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+function collectBars(ctx, from, to) {
+    const { ohlcv } = ctx.stream;
+    const bars = [];
+    for (let lookback = ohlcv.close.length - 1; lookback >= 0; lookback -= 1) {
+        const time = ohlcv.time.at(lookback);
+        if (time < from || time > to)
+            continue;
+        bars.push({
+            close: ohlcv.close.at(lookback),
+            high: ohlcv.high.at(lookback),
+            low: ohlcv.low.at(lookback),
+            open: ohlcv.open.at(lookback),
+            time,
+            volume: ohlcv.volume.at(lookback),
+        });
+    }
+    return bars;
+}
+function diagnoseInvertedRange(ctx, slotId) {
+    const key = `fixed-range-inverted|${slotId}`;
+    if (ctx.diagnosedRequestKeys.has(key))
+        return;
+    ctx.diagnosedRequestKeys.add(key);
+    pushDiagnostic(ctx.emissions, {
+        kind: "diagnostic",
+        severity: "warning",
+        code: "fixed-range-inverted",
+        message: "ta.fixedRangeVolumeProfile requires opts.from <= opts.to.",
+        slotId,
+        bar: ctx.barIndex(),
+    });
+}
+/**
+ * Fixed-Range Volume Profile — bucketizes volume between two
+ * user-picked time anchors, inclusive on both ends.
+ *
+ * Bars before `opts.from` emit NaN. Bars after `opts.to` reuse the
+ * frozen profile captured at the `to` bar. If `opts.from > opts.to`,
+ * the primitive emits one `fixed-range-inverted` diagnostic per slot
+ * and returns NaN series values.
+ *
+ * @formula  Port of invinite fixed-range-vp: collect candles in the
+ *           fixed `[from, to]` window, bucket volume by price, then
+ *           derive POC / value-area high / value-area low through the
+ *           shared volume-profile pipeline.
+ * @anchors  `opts.from: Time` and `opts.to: Time`, typically supplied
+ *           by two `input.time(..., { pickFromChart: true })` inputs.
+ * @warmup   NaN before `opts.from`; a degenerate `from === to`
+ *           one-bar window can emit on the anchor bar when it has
+ *           finite positive volume.
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { input, plot, ta } from "@invinite-org/chartlang-core";
+ *     // const from = input.time(0, { pickFromChart: true, title: "From" });
+ *     // const to = input.time(0, { pickFromChart: true, title: "To" });
+ *     // const vp = ta.fixedRangeVolumeProfile({ from: from.value, to: to.value });
+ *     // plot(vp.poc, { style: { kind: "horizontal-histogram", buckets: vp.buckets } });
+ */
+export function fixedRangeVolumeProfile(slotId, 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);
+    }
+    let snapshot = emptyVolumeProfileSnapshot();
+    if (opts.from > opts.to) {
+        diagnoseInvertedRange(ctx, slotId);
+        slot.frozen = null;
+    }
+    else if (ctx.stream.bar.time < opts.from) {
+        slot.frozen = null;
+    }
+    else if (ctx.stream.bar.time > opts.to && slot.frozen !== null) {
+        snapshot = slot.frozen;
+    }
+    else {
+        snapshot = resolveVolumeProfileSnapshot({
+            bars: collectBars(ctx, opts.from, opts.to),
+            bucketColor: opts.bucketColor,
+            config: volumeProfileConfigFromOpts(opts),
+        });
+        if (ctx.stream.bar.time >= opts.to)
+            slot.frozen = snapshot;
+    }
+    commitVolumeProfileSnapshot(slot, ctx.isTick, snapshot);
+    emitVolumeProfileHistogram(ctx, slotId, "Fixed Range Volume Profile", snapshot.poc, snapshot.buckets);
+    return resultForOffset(slot, opts.offset ?? 0);
+}
+//# sourceMappingURL=fixedRangeVolumeProfile.js.map

package/dist/ta/fixedRangeVolumeProfile.js.map

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

package/dist/ta/highest.d.ts

@@ -0,0 +1,21 @@
+import type { HighestOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Rolling maximum of the last `length` source values. NaN inputs are
+ * skipped from the window; the output is NaN until `length` closed
+ * bars have been folded in. Tick-mode replays the head as
+ * `max(closedMaxExcludingHead, tickValue)` so partial-bar values do
+ * not pollute the next close's deque.
+ *
+ * @formula  out[t] = max(source[t − length + 1 .. t])  (NaN slots skipped)
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const upper = ta.highest(bar.high, 20);
+ *     // plot(upper);
+ */
+export declare function highest(slotId: string, source: ScalarOrSeries, length: number, _opts?: HighestOpts): Series<number>;
+//# sourceMappingURL=highest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highest.d.ts","sourceRoot":"","sources":["../../src/ta/highest.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAKxE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA6H5E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,WAAW,GACpB,MAAM,CAAC,MAAM,CAAC,CAchB"}

package/dist/ta/highest.js

@@ -0,0 +1,131 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// No invinite source — semantics per Pine `ta.highest`. See PLAN.md §3.1.
+// Structural choices (callsite-id slot, Series<T> proxy, replaceHead
+// mode) follow chartlang's primitive shape.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.highest called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        sourceWindow: new Float64RingBuffer(length),
+        monoIndices: [],
+        monoValues: [],
+        barCount: 0,
+        closedMaxExcludingHead: Number.NEGATIVE_INFINITY,
+    };
+}
+function recomputeMaxExcludingHead(slot) {
+    // The window holds the last `min(barCount, length)` closed sources;
+    // `sourceWindow.at(0)` is the head bar. Walk the non-head entries
+    // and find the max of the finite ones.
+    let maxV = Number.NEGATIVE_INFINITY;
+    const filled = slot.sourceWindow.length;
+    for (let i = 1; i < filled; i += 1) {
+        const v = slot.sourceWindow.at(i);
+        if (Number.isFinite(v) && v > maxV)
+            maxV = v;
+    }
+    return maxV;
+}
+function closeValue(slot, src) {
+    slot.barCount += 1;
+    const headIndex = slot.barCount - 1;
+    slot.sourceWindow.append(src);
+    // Evict deque front entries that fell out of the trailing window.
+    const oldestAllowed = headIndex - slot.length + 1;
+    while (slot.monoIndices.length > 0 && slot.monoIndices[0] < oldestAllowed) {
+        slot.monoIndices.shift();
+        slot.monoValues.shift();
+    }
+    if (Number.isFinite(src)) {
+        // Maintain monotone-decreasing values from front to back. Pop on
+        // strict `<` keeps equal values in the deque so the window can
+        // tell when multiple bars share the same max.
+        while (slot.monoIndices.length > 0 && slot.monoValues[slot.monoValues.length - 1] < src) {
+            slot.monoIndices.pop();
+            slot.monoValues.pop();
+        }
+        slot.monoIndices.push(headIndex);
+        slot.monoValues.push(src);
+    }
+    // NaN sources are not pushed — NaN slots are skipped from the window
+    // (matches `ta.highest`'s NaN-skip semantics).
+    // Warmup: require at least `length` closed bars before emitting.
+    if (slot.barCount < slot.length) {
+        slot.closedMaxExcludingHead = Number.NEGATIVE_INFINITY;
+        return Number.NaN;
+    }
+    slot.closedMaxExcludingHead = recomputeMaxExcludingHead(slot);
+    if (slot.monoIndices.length === 0) {
+        // All NaN in the window.
+        return Number.NaN;
+    }
+    return slot.monoValues[0];
+}
+function tickValue(slot, src) {
+    // Unwarmed: tick during warmup still NaN.
+    if (slot.barCount < slot.length)
+        return Number.NaN;
+    if (!Number.isFinite(src)) {
+        // NaN tick — treat the head as if its source were NaN; the
+        // window's max excludes the head bar.
+        return slot.closedMaxExcludingHead === Number.NEGATIVE_INFINITY
+            ? Number.NaN
+            : slot.closedMaxExcludingHead;
+    }
+    if (slot.closedMaxExcludingHead === Number.NEGATIVE_INFINITY) {
+        // Window-excluding-head has no finite values (e.g. length === 1
+        // or every other bar was NaN). The tick value is the only
+        // candidate.
+        return src;
+    }
+    return Math.max(slot.closedMaxExcludingHead, src);
+}
+/**
+ * Rolling maximum of the last `length` source values. NaN inputs are
+ * skipped from the window; the output is NaN until `length` closed
+ * bars have been folded in. Tick-mode replays the head as
+ * `max(closedMaxExcludingHead, tickValue)` so partial-bar values do
+ * not pollute the next close's deque.
+ *
+ * @formula  out[t] = max(source[t − length + 1 .. t])  (NaN slots skipped)
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const upper = ta.highest(bar.high, 20);
+ *     // plot(upper);
+ */
+export function highest(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.outBuffer.replaceHead(tickValue(slot, src));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, src));
+    }
+    return slot.series;
+}
+//# sourceMappingURL=highest.js.map

package/dist/ta/highest.js.map

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

package/dist/ta/historicalVolatility.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"historicalVolatility.d.ts","sourceRoot":"","sources":["../../src/ta/historicalVolatility.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAKnE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA4J5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,CAehB"}