@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/atr.js

@@ -0,0 +1,132 @@
+// 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/atr.ts
+//   plus lib/tr-series.ts
+//   (commit d2d1043c1b039f66d2f3674526d303d31cf2f1e0, © 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. ATR derives from `bar.high`/`bar.low`/
+// `bar.close` directly — no `source` argument per Pine.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { wilderStep } from "./lib/wilderSmoothing.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.atr called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        seedTrSum: 0,
+        trCount: 0,
+        atr: Number.NaN,
+        prevClose: Number.NaN,
+        prevPrevClose: Number.NaN,
+        prevClosedAtr: 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 trueRange(high, low, prevClose) {
+    if (!Number.isFinite(prevClose))
+        return high - low;
+    return Math.max(high - low, Math.abs(high - prevClose), Math.abs(low - prevClose));
+}
+function closeValue(slot, high, low, close) {
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(close)) {
+        if (Number.isFinite(slot.atr))
+            return slot.atr;
+        return Number.NaN;
+    }
+    const tr = trueRange(high, low, slot.prevClose);
+    slot.prevPrevClose = slot.prevClose;
+    slot.prevClose = close;
+    slot.trCount += 1;
+    if (slot.trCount < slot.length) {
+        slot.seedTrSum += tr;
+        return Number.NaN;
+    }
+    if (slot.trCount === slot.length) {
+        slot.seedTrSum += tr;
+        slot.atr = slot.seedTrSum / slot.length;
+        slot.prevClosedAtr = slot.atr;
+        return slot.atr;
+    }
+    slot.prevClosedAtr = slot.atr;
+    slot.atr = wilderStep(slot.atr, tr, slot.length);
+    return slot.atr;
+}
+function tickValue(slot, high, low, close) {
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(close)) {
+        return Number.isFinite(slot.atr) ? slot.atr : Number.NaN;
+    }
+    if (slot.trCount < slot.length)
+        return Number.NaN;
+    // Tick TR uses the **bar before the current bar**'s close — frozen
+    // by the prior close-side advance as `prevPrevClose`.
+    const tr = trueRange(high, low, slot.prevPrevClose);
+    if (slot.trCount === slot.length) {
+        // We just seeded on the current close; tick replays the same seed
+        // (the seed window is fixed once the bar closes).
+        return slot.atr;
+    }
+    return wilderStep(slot.prevClosedAtr, tr, slot.length);
+}
+/**
+ * Wilder's Average True Range. Sources from `bar.high` / `bar.low` /
+ * `bar.close` directly (no `source` arg — matches Pine). Seeds at bar
+ * `length − 1` as the simple mean of the first `length` TR values;
+ * subsequent slots use the Wilder recurrence with α = 1/length.
+ *
+ * @formula  TR[t] = max(high − low, |high − prevClose|, |low − prevClose|) ;
+ *           seed at bar length − 1 = mean(TR[0 .. length − 1]) ;
+ *           ATR[t] = (ATR[t − 1] · (length − 1) + TR[t]) / length
+ * @warmup   length − 1
+ * @since 0.1
+ * @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-runtime";
+ *     // const a = ta.atr("slot", 14);
+ *     // const head = a.current;
+ *     // const lagged = ta.atr("slot2", 14, { offset: 5 });
+ */
+export function atr(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) {
+        slot.outBuffer.replaceHead(tickValue(slot, bar.high, bar.low, bar.close));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, bar.high, bar.low, bar.close));
+    }
+    return viewForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=atr.js.map

package/dist/ta/atr.js.map

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

package/dist/ta/barssince.d.ts

@@ -0,0 +1,21 @@
+import type { BarssinceOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Number of bars since `condition === true` last fired. `0` at the
+ * matching bar, `1` the next bar, etc. NaN until the first ever match.
+ * NaN-condition values are treated as `false` — they do NOT reset the
+ * counter.
+ *
+ * @formula  out[t] = 0 if condition[t]; out[t − 1] + 1 if seenTrue; NaN otherwise
+ * @warmup   data-dependent — NaN until the first `condition === true`
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const fast = ta.ema(bar.close, 12);
+ *     // const slow = ta.ema(bar.close, 26);
+ *     // const sinceCross = ta.barssince(ta.crossover(fast, slow));
+ *     // plot(sinceCross);
+ */
+export declare function barssince(slotId: string, condition: Series<boolean>, opts?: BarssinceOpts): Series<number>;
+//# sourceMappingURL=barssince.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"barssince.d.ts","sourceRoot":"","sources":["../../src/ta/barssince.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAiE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAC1B,IAAI,GAAE,aAAkB,GACzB,MAAM,CAAC,MAAM,CAAC,CAoBhB"}

package/dist/ta/barssince.js

@@ -0,0 +1,96 @@
+// 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.barssince`. 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, makeShiftedSeriesView } from "../seriesView.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.barssince called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        shiftedSeries: new Map(),
+        sinceTrue: 0,
+        seenTrue: false,
+        prevSinceTrue: 0,
+        prevSeenTrue: false,
+    };
+}
+function closeValue(slot, fired) {
+    slot.prevSinceTrue = slot.sinceTrue;
+    slot.prevSeenTrue = slot.seenTrue;
+    if (fired) {
+        slot.sinceTrue = 0;
+        slot.seenTrue = true;
+    }
+    else if (slot.seenTrue) {
+        slot.sinceTrue += 1;
+    }
+    return slot.seenTrue ? slot.sinceTrue : Number.NaN;
+}
+function tickValue(slot, fired) {
+    // Replay against pre-close snapshot.
+    let sinceTrue = slot.prevSinceTrue;
+    let seenTrue = slot.prevSeenTrue;
+    if (fired) {
+        sinceTrue = 0;
+        seenTrue = true;
+    }
+    else if (seenTrue) {
+        sinceTrue += 1;
+    }
+    return seenTrue ? sinceTrue : Number.NaN;
+}
+/**
+ * Number of bars since `condition === true` last fired. `0` at the
+ * matching bar, `1` the next bar, etc. NaN until the first ever match.
+ * NaN-condition values are treated as `false` — they do NOT reset the
+ * counter.
+ *
+ * @formula  out[t] = 0 if condition[t]; out[t − 1] + 1 if seenTrue; NaN otherwise
+ * @warmup   data-dependent — NaN until the first `condition === true`
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const fast = ta.ema(bar.close, 12);
+ *     // const slow = ta.ema(bar.close, 26);
+ *     // const sinceCross = ta.barssince(ta.crossover(fast, slow));
+ *     // plot(sinceCross);
+ */
+export function barssince(slotId, condition, 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 fired = condition.current === true;
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(tickValue(slot, fired));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, fired));
+    }
+    const offset = opts.offset ?? 0;
+    if (offset === 0)
+        return slot.series;
+    const shifted = slot.shiftedSeries.get(offset);
+    if (shifted !== undefined)
+        return shifted;
+    const next = makeShiftedSeriesView(slot.outBuffer, offset);
+    slot.shiftedSeries.set(offset, next);
+    return next;
+}
+//# sourceMappingURL=barssince.js.map

package/dist/ta/barssince.js.map

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

package/dist/ta/bb.d.ts

@@ -0,0 +1,28 @@
+import type { BbOpts, BbResult } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Bollinger Bands — `multiplier × σ` envelope around an SMA(length)
+ * middle band. Default `multiplier = 2` per Pine. Returns a cached
+ * `{ upper, middle, lower }` record (same identity every bar) backed
+ * by three `Series<number>` Proxies. The middle band is the
+ * underlying SMA primitive's output (identity-shared).
+ *
+ * @formula  middle = sma(source, length) ;
+ *           σ      = stdev(source, length, { biased: true }) ;
+ *           upper  = middle + multiplier · σ ;
+ *           lower  = middle − multiplier · σ
+ * @warmup   length − 1
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts all three bands in lockstep (PLAN.md §9.1) —
+ * `series.current` on each band returns the value `offset` bars ago.
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const bands = ta.bb("slot", bar.close, 20, { multiplier: 2 });
+ *     // const u = bands.upper.current;
+ *     // const lagged = ta.bb("slot2", bar.close, 20, { offset: 5 });
+ */
+export declare function bb(slotId: string, source: ScalarOrSeries, length: number, opts?: BbOpts): BbResult;
+//# sourceMappingURL=bb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bb.d.ts","sourceRoot":"","sources":["../../src/ta/bb.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAU,MAAM,8BAA8B,CAAC;AAM7E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AA8D5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,EAAE,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACd,QAAQ,CA4CV"}

package/dist/ta/bb.js

@@ -0,0 +1,123 @@
+// 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/bb.ts
+//   (commit d2d1043c1b039f66d2f3674526d303d31cf2f1e0, © 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. BB is composed from `sma` + `stdev` via
+// sub-slot ids so a fix to either primitive flows in for free.
+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";
+import { stdev } from "./stdev.js";
+const DEFAULT_MULTIPLIER = 2;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.bb called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity, middle, middleBuf) {
+    const upper = new Float64RingBuffer(capacity);
+    const lower = new Float64RingBuffer(capacity);
+    const upperView = makeSeriesView(upper);
+    const lowerView = makeSeriesView(lower);
+    return {
+        result: Object.freeze({ upper: upperView, middle, lower: lowerView }),
+        upper,
+        middle,
+        lower,
+        middleBuf,
+        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({
+            upper: makeShiftedSeriesView(slot.upper, offset),
+            middle: makeShiftedSeriesView(slot.middleBuf, offset),
+            lower: makeShiftedSeriesView(slot.lower, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+/**
+ * Bollinger Bands — `multiplier × σ` envelope around an SMA(length)
+ * middle band. Default `multiplier = 2` per Pine. Returns a cached
+ * `{ upper, middle, lower }` record (same identity every bar) backed
+ * by three `Series<number>` Proxies. The middle band is the
+ * underlying SMA primitive's output (identity-shared).
+ *
+ * @formula  middle = sma(source, length) ;
+ *           σ      = stdev(source, length, { biased: true }) ;
+ *           upper  = middle + multiplier · σ ;
+ *           lower  = middle − multiplier · σ
+ * @warmup   length − 1
+ * @since 0.1
+ * @stable
+ *
+ * `opts.offset` shifts all three bands in lockstep (PLAN.md §9.1) —
+ * `series.current` on each band returns the value `offset` bars ago.
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const bands = ta.bb("slot", bar.close, 20, { multiplier: 2 });
+ *     // const u = bands.upper.current;
+ *     // const lagged = ta.bb("slot2", bar.close, 20, { offset: 5 });
+ */
+export function bb(slotId, source, length, opts) {
+    const ctx = getCtx();
+    const multiplier = opts?.multiplier ?? DEFAULT_MULTIPLIER;
+    const src = readSourceValue(source);
+    const middleSlotId = `${slotId}/sma`;
+    const stdevSlotId = `${slotId}/stdev`;
+    // Compose: sma updates the middle band; stdev updates a separate
+    // rolling-sigma series. Both primitives respect ctx.isTick. The
+    // un-shifted middle (no offset) drives the per-bar math; the
+    // shifted middle for non-zero offset is composed lazily in
+    // `resultForOffset` to keep the close-path tight.
+    const middleSeries = sma(middleSlotId, src, length);
+    // BB's invinite math uses population sigma (denominator length); we
+    // pass `biased: true` so the helper matches.
+    const sigmaSeries = stdev(stdevSlotId, src, length, { biased: true });
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        // Capture the SMA sub-slot's output ring buffer so future
+        // shifted-view lookups don't need to re-enter `sma()`.
+        const smaSlot = ctx.stream.taSlots.get(middleSlotId);
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, middleSeries, smaSlot.outBuffer);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const mid = middleSeries.current;
+    const sigma = sigmaSeries.current;
+    let upperValue;
+    let lowerValue;
+    if (Number.isFinite(mid) && Number.isFinite(sigma)) {
+        upperValue = mid + multiplier * sigma;
+        lowerValue = mid - multiplier * sigma;
+    }
+    else {
+        upperValue = Number.NaN;
+        lowerValue = Number.NaN;
+    }
+    if (ctx.isTick) {
+        slot.upper.replaceHead(upperValue);
+        slot.lower.replaceHead(lowerValue);
+    }
+    else {
+        slot.upper.append(upperValue);
+        slot.lower.append(lowerValue);
+    }
+    return resultForOffset(slot, opts?.offset ?? 0);
+}
+//# sourceMappingURL=bb.js.map

package/dist/ta/bb.js.map

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

package/dist/ta/bbPercentB.d.ts

@@ -0,0 +1,23 @@
+import type { BbPercentBOpts, Series } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Bollinger %B — sub-pane oscillator measuring price position
+ * relative to the Bollinger Band envelope. `0` sits on the lower
+ * band, `1` on the upper; excursions past either signal a volatility
+ * breakout. Composes `ta.bb` via sub-slot `${slotId}/bb` — a fix to
+ * the BB envelope math flows in for free. NaN when the band collapses
+ * (`upper === lower`) or during warmup.
+ *
+ * @formula  bands  = bb(source, length, { multiplier }) ;
+ *           pct    = (source − bands.lower) / (bands.upper − bands.lower)
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const pct = ta.bbPercentB(bar.close, 20, { multiplier: 2 });
+ *     // plot(pct);
+ */
+export declare function bbPercentB(slotId: string, source: ScalarOrSeries, length: number, opts?: BbPercentBOpts): Series<number>;
+//# sourceMappingURL=bbPercentB.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bbPercentB.d.ts","sourceRoot":"","sources":["../../src/ta/bbPercentB.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAMrF,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAwC5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,cAAc,GACtB,MAAM,CAAC,MAAM,CAAC,CAkBhB"}

package/dist/ta/bbPercentB.js

@@ -0,0 +1,84 @@
+// 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/bb-percent-b.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. %B is composed from `ta.bb` via a sub-slot
+// (`${slotId}/bb`) so a fix to the BB envelope math flows in for free.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { bb } from "./bb.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_MULTIPLIER = 2;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.bbPercentB called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(length, multiplier, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        multiplier,
+        bbSub: null,
+    };
+}
+function percentBValue(src, upper, lower) {
+    if (!Number.isFinite(src) || !Number.isFinite(upper) || !Number.isFinite(lower)) {
+        return Number.NaN;
+    }
+    const denom = upper - lower;
+    if (denom === 0)
+        return Number.NaN;
+    return (src - lower) / denom;
+}
+/**
+ * Bollinger %B — sub-pane oscillator measuring price position
+ * relative to the Bollinger Band envelope. `0` sits on the lower
+ * band, `1` on the upper; excursions past either signal a volatility
+ * breakout. Composes `ta.bb` via sub-slot `${slotId}/bb` — a fix to
+ * the BB envelope math flows in for free. NaN when the band collapses
+ * (`upper === lower`) or during warmup.
+ *
+ * @formula  bands  = bb(source, length, { multiplier }) ;
+ *           pct    = (source − bands.lower) / (bands.upper − bands.lower)
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const pct = ta.bbPercentB(bar.close, 20, { multiplier: 2 });
+ *     // plot(pct);
+ */
+export function bbPercentB(slotId, source, length, opts) {
+    const ctx = getCtx();
+    const multiplier = opts?.multiplier ?? DEFAULT_MULTIPLIER;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(length, multiplier, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    const bands = bb(`${slotId}/bb`, source, length, { multiplier });
+    if (slot.bbSub === null)
+        slot.bbSub = bands;
+    const value = percentBValue(src, bands.upper.current, bands.lower.current);
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(value);
+    }
+    else {
+        slot.outBuffer.append(value);
+    }
+    return slot.series;
+}
+//# sourceMappingURL=bbPercentB.js.map

package/dist/ta/bbPercentB.js.map

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

package/dist/ta/bbw.d.ts

@@ -0,0 +1,23 @@
+import type { BbwOpts, Series } from "@invinite-org/chartlang-core";
+import type { ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Bollinger BandWidth — sub-pane volatility line. Compresses
+ * ("squeezes") before breakouts. Composes `ta.bb` via sub-slot
+ * `${slotId}/bb` — a fix to the BB envelope flows in for free.
+ * Emits the raw ratio `(upper − lower) / middle`; multiply by 100
+ * in the script for TradingView-parity display. NaN when the SMA
+ * middle is zero or during warmup.
+ *
+ * @formula  bands = bb(source, length, { multiplier }) ;
+ *           bbw   = (bands.upper − bands.lower) / bands.middle
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const width = ta.bbw(bar.close, 20, { multiplier: 2 });
+ *     // plot(width);
+ */
+export declare function bbw(slotId: string, source: ScalarOrSeries, length: number, opts?: BbwOpts): Series<number>;
+//# sourceMappingURL=bbw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bbw.d.ts","sourceRoot":"","sources":["../../src/ta/bbw.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAM9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA2C3D;;;;;;;;;;;;;;;;;;GAkBG;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,CAiBhB"}