@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/tsi.js

@@ -0,0 +1,127 @@
+// 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/tsi.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.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+import { ema } from "./ema.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+const DEFAULT_FIRST = 25;
+const DEFAULT_SECOND = 13;
+const DEFAULT_SIGNAL = 13;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.tsi called outside an active script step");
+    }
+    return ctx;
+}
+function resultForOffset(slot, offset) {
+    if (offset === 0)
+        return slot.result;
+    let cached = slot.shiftedResults.get(offset);
+    if (cached === undefined) {
+        cached = Object.freeze({
+            tsi: makeShiftedSeriesView(slot.tsiBuf, offset),
+            signal: makeShiftedSeriesView(slot.signalBuf, offset),
+        });
+        slot.shiftedResults.set(offset, cached);
+    }
+    return cached;
+}
+function tsiValue(num, den) {
+    if (!Number.isFinite(num) || !Number.isFinite(den) || den === 0)
+        return Number.NaN;
+    return (100 * num) / den;
+}
+/**
+ * True Strength Index (William Blau). Double-EMA-smoothed ratio of
+ * one-bar price changes vs their absolute values, scaled ×100. Per
+ * TradingView's published formula:
+ *
+ *   `mom    = source[t] − source[t-1]`
+ *   `absMom = |mom|`
+ *   `ema1   = EMA(firstSmoothing)(mom)`
+ *   `ema2   = EMA(secondSmoothing)(ema1)`
+ *   `absEma1 = EMA(firstSmoothing)(absMom)`
+ *   `absEma2 = EMA(secondSmoothing)(absEma1)`
+ *   `tsi    = 100 × ema2 / absEma2`
+ *   `signal = EMA(signalLength)(tsi)`
+ *
+ * Bounded `[-100, 100]` by construction (when defined). Flat-input
+ * windows where `absEma2` collapses to zero emit NaN at `tsi` (and
+ * propagate to `signal`). Defaults `(firstSmoothing, secondSmoothing,
+ * signalLength) = (25, 13, 13)`.
+ *
+ * Note: Pine's `ta.tsi()` returns the raw `ema2 / absEma2` ratio
+ * (no ×100). chartlang follows TradingView's published TSI study
+ * (×100); for the raw ratio, divide by 100.
+ *
+ * @formula  see above
+ * @warmup   firstSmoothing + secondSmoothing + signalLength − 3
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const t = ta.tsi("slot", bar.close);
+ *     // plot(t.tsi); plot(t.signal);
+ */
+export function tsi(slotId, source, opts) {
+    const ctx = getCtx();
+    const firstSmoothing = opts?.firstSmoothing ?? DEFAULT_FIRST;
+    const secondSmoothing = opts?.secondSmoothing ?? DEFAULT_SECOND;
+    const signalLength = opts?.signalLength ?? DEFAULT_SIGNAL;
+    const offset = opts?.offset ?? 0;
+    const signalSlotId = `${slotId}/signal`;
+    const isTick = ctx.isTick;
+    const src = readSourceValue(source);
+    let slot = ctx.stream.taSlots.get(slotId);
+    // The `?? Number.NaN` fallbacks below are defensive: the runner
+    // always close-side advances before tick, so `slot` exists by the
+    // time `isTick` is true; on close-side the first-bar `slot` is
+    // still undefined and we want NaN momentum (no prior bar).
+    const prevForDiff = isTick
+        ? /* c8 ignore next */ (slot?.prevClosedSrc ?? Number.NaN)
+        : (slot?.prevSrc ?? Number.NaN);
+    const mom = Number.isFinite(src) && Number.isFinite(prevForDiff) ? src - prevForDiff : Number.NaN;
+    const absMom = Number.isFinite(mom) ? Math.abs(mom) : Number.NaN;
+    const momEma1 = ema(`${slotId}/momEma1`, mom, firstSmoothing).current;
+    const momEma2 = ema(`${slotId}/momEma2`, momEma1, secondSmoothing).current;
+    const absEma1 = ema(`${slotId}/absMomEma1`, absMom, firstSmoothing).current;
+    const absEma2 = ema(`${slotId}/absMomEma2`, absEma1, secondSmoothing).current;
+    const tsiOut = tsiValue(momEma2, absEma2);
+    const signalSeries = ema(signalSlotId, tsiOut, signalLength);
+    if (slot === undefined) {
+        const tsiBuf = new Float64RingBuffer(ctx.stream.ohlcv.close.capacity);
+        const emaSlot = ctx.stream.taSlots.get(signalSlotId);
+        slot = {
+            result: Object.freeze({
+                tsi: makeSeriesView(tsiBuf),
+                signal: signalSeries,
+            }),
+            tsiBuf,
+            signalBuf: emaSlot.outBuffer,
+            shiftedResults: new Map(),
+            prevSrc: src,
+            prevClosedSrc: Number.NaN,
+        };
+        ctx.stream.taSlots.set(slotId, slot);
+        slot.tsiBuf.append(tsiOut);
+        return resultForOffset(slot, offset);
+    }
+    if (isTick) {
+        slot.tsiBuf.replaceHead(tsiOut);
+    }
+    else {
+        slot.tsiBuf.append(tsiOut);
+        slot.prevClosedSrc = slot.prevSrc;
+        slot.prevSrc = src;
+    }
+    return resultForOffset(slot, offset);
+}
+//# sourceMappingURL=tsi.js.map

package/dist/ta/tsi.js.map

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

package/dist/ta/ulcerIndex.d.ts

@@ -0,0 +1,34 @@
+import type { Series, UlcerIndexOpts } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Ulcer Index — drawdown-based volatility. The trailing-window RMS of
+ * `drawdown_pct[t] = 100 · (source[t] − highest(source, length)[t]) /
+ * highest(source, length)[t]`. Composes `ta.highest` via the sub-slot
+ * id `${slotId}/highest` so a fix to `highest` flows through. Always
+ * non-negative.
+ *
+ * NaN sources (or zero rolling-max) emit NaN and do NOT advance the
+ * window — the next bar's drawdown is computed against the still-valid
+ * prior state.
+ *
+ * **Warmup ramp.** The first defined output lands at bar `length − 1`
+ * (when `highest(source, length)` first emits). Up to bar `2·(length −
+ * 1)` the window is partially populated and the RMS divides by the
+ * actual `window.length`; from bar `2·(length − 1)` onward the window
+ * is fully warm and the RMS uses the full `length` denominator. This
+ * matches the task spec's `length − 1` warmup pin.
+ *
+ * @formula  highVal[t] = max(source[t − length + 1 .. t]) ;
+ *           dd[t] = 100 · (source[t] − highVal[t]) / highVal[t] ;
+ *           out[t] = sqrt(mean(dd^2 over the last `length` finite bars))
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const ui = ta.ulcerIndex(bar.close, 14);
+ *     // plot(ui);
+ */
+export declare function ulcerIndex(slotId: string, source: ScalarOrSeries, length: number, _opts?: UlcerIndexOpts): Series<number>;
+//# sourceMappingURL=ulcerIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ulcerIndex.d.ts","sourceRoot":"","sources":["../../src/ta/ulcerIndex.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAM3E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAyE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,cAAc,GACvB,MAAM,CAAC,MAAM,CAAC,CAkBhB"}

package/dist/ta/ulcerIndex.js

@@ -0,0 +1,120 @@
+// 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/ulcer-index.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. Composes `ta.highest` via the sub-slot id
+// `${slotId}/highest` so a fix to `highest` flows through.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+import { highest } from "./highest.js";
+import { readSourceValue } from "./lib/sourceValue.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.ulcerIndex called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(slotId, length, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        length,
+        highestSub: `${slotId}/highest`,
+        drawdownSqWindow: new Float64RingBuffer(length),
+        sumDrawdownSq: 0,
+    };
+}
+function drawdownSquared(src, maxSrc) {
+    if (!Number.isFinite(src) || !Number.isFinite(maxSrc) || maxSrc === 0) {
+        return Number.NaN;
+    }
+    const dd = (100 * (src - maxSrc)) / maxSrc;
+    return dd * dd;
+}
+function closeValue(slot, src, maxSrc) {
+    const ddSq = drawdownSquared(src, maxSrc);
+    if (!Number.isFinite(ddSq)) {
+        // Per task spec §6 (NaN handling): NaN source → NaN output.
+        // Do NOT advance the window — preserves the previous closed
+        // state for the next bar to consume.
+        return Number.NaN;
+    }
+    if (slot.drawdownSqWindow.length === slot.length) {
+        // Window full: evict the oldest before append.
+        slot.sumDrawdownSq -= slot.drawdownSqWindow.at(slot.length - 1);
+    }
+    slot.drawdownSqWindow.append(ddSq);
+    slot.sumDrawdownSq += ddSq;
+    return Math.sqrt(slot.sumDrawdownSq / slot.drawdownSqWindow.length);
+}
+function tickValue(slot, src, maxSrc) {
+    if (slot.drawdownSqWindow.length === 0)
+        return Number.NaN;
+    const ddSq = drawdownSquared(src, maxSrc);
+    if (!Number.isFinite(ddSq))
+        return Number.NaN;
+    // Substitute the tick's ddSq for the head slot's ddSq without
+    // mutating the closed window. Hypothetical sum = sum − head + tick.
+    const headSq = slot.drawdownSqWindow.at(0);
+    const hypSum = slot.sumDrawdownSq - headSq + ddSq;
+    return Math.sqrt(hypSum / slot.drawdownSqWindow.length);
+}
+/**
+ * Ulcer Index — drawdown-based volatility. The trailing-window RMS of
+ * `drawdown_pct[t] = 100 · (source[t] − highest(source, length)[t]) /
+ * highest(source, length)[t]`. Composes `ta.highest` via the sub-slot
+ * id `${slotId}/highest` so a fix to `highest` flows through. Always
+ * non-negative.
+ *
+ * NaN sources (or zero rolling-max) emit NaN and do NOT advance the
+ * window — the next bar's drawdown is computed against the still-valid
+ * prior state.
+ *
+ * **Warmup ramp.** The first defined output lands at bar `length − 1`
+ * (when `highest(source, length)` first emits). Up to bar `2·(length −
+ * 1)` the window is partially populated and the RMS divides by the
+ * actual `window.length`; from bar `2·(length − 1)` onward the window
+ * is fully warm and the RMS uses the full `length` denominator. This
+ * matches the task spec's `length − 1` warmup pin.
+ *
+ * @formula  highVal[t] = max(source[t − length + 1 .. t]) ;
+ *           dd[t] = 100 · (source[t] − highVal[t]) / highVal[t] ;
+ *           out[t] = sqrt(mean(dd^2 over the last `length` finite bars))
+ * @warmup   length − 1
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const ui = ta.ulcerIndex(bar.close, 14);
+ *     // plot(ui);
+ */
+export function ulcerIndex(slotId, source, length, _opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(slotId, length, ctx.stream.ohlcv.close.capacity);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const src = readSourceValue(source);
+    // Compose: `highest` respects `ctx.isTick`. The sub-slot id is
+    // stable per parent slot id.
+    const maxSeries = highest(slot.highestSub, source, length);
+    const maxSrc = maxSeries.current;
+    if (ctx.isTick) {
+        slot.outBuffer.replaceHead(tickValue(slot, src, maxSrc));
+    }
+    else {
+        slot.outBuffer.append(closeValue(slot, src, maxSrc));
+    }
+    return slot.series;
+}
+//# sourceMappingURL=ulcerIndex.js.map

package/dist/ta/ulcerIndex.js.map

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

package/dist/ta/ultimateOsc.d.ts

@@ -0,0 +1,27 @@
+import type { Series, UltimateOscOpts } from "@invinite-org/chartlang-core";
+/**
+ * Larry Williams' Ultimate Oscillator. Sources from `bar.high` /
+ * `bar.low` / `bar.close` directly (no `source` arg — matches Pine).
+ * Weighted average of three buying-pressure / true-range ratios over
+ * `shortLength` / `mediumLength` / `longLength` windows (defaults
+ * `7` / `14` / `28`). Output bounded `[0, 100]` (or `NaN`).
+ *
+ * Zero-TR window (flat-line input over the long window) emits `NaN`.
+ * The registry records `yDomain: { kind: "fixed", min: 0, max: 100 }`
+ * via `TA_REGISTRY_METADATA`.
+ *
+ * @formula  bp = close − min(low, prevClose) ;
+ *           tr = max(high, prevClose) − min(low, prevClose) ;
+ *           avgN = Σ bp[t − N + 1 .. t] / Σ tr[t − N + 1 .. t] ;
+ *           uo = 100 · (4 · avgShort + 2 · avgMedium + avgLong) / 7
+ * @warmup   longLength
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const u = ta.ultimateOsc("slot");
+ *     // plot(u);
+ */
+export declare function ultimateOsc(slotId: string, opts?: UltimateOscOpts): Series<number>;
+//# sourceMappingURL=ultimateOsc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ultimateOsc.d.ts","sourceRoot":"","sources":["../../src/ta/ultimateOsc.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAgN5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAiBlF"}

package/dist/ta/ultimateOsc.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/ultimate-osc.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. Ultimate Oscillator derives from
+// `bar.high` / `bar.low` / `bar.close` directly (no `source` arg).
+// Three pairs of (buying-pressure, true-range) ring buffers + running
+// sums — one pair per (shortLength | mediumLength | longLength)
+// window. Zero-TR-window emits `NaN`.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+const DEFAULT_SHORT_LENGTH = 7;
+const DEFAULT_MEDIUM_LENGTH = 14;
+const DEFAULT_LONG_LENGTH = 28;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.ultimateOsc called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(shortLength, mediumLength, longLength, capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        shortLength,
+        mediumLength,
+        longLength,
+        bpShort: new Float64RingBuffer(shortLength),
+        bpMedium: new Float64RingBuffer(mediumLength),
+        bpLong: new Float64RingBuffer(longLength),
+        trShort: new Float64RingBuffer(shortLength),
+        trMedium: new Float64RingBuffer(mediumLength),
+        trLong: new Float64RingBuffer(longLength),
+        sumBpShort: 0,
+        sumBpMedium: 0,
+        sumBpLong: 0,
+        sumTrShort: 0,
+        sumTrMedium: 0,
+        sumTrLong: 0,
+        barCount: 0,
+        prevClose: Number.NaN,
+        prevPrevClose: Number.NaN,
+        headBpShort: 0,
+        headBpMedium: 0,
+        headBpLong: 0,
+        headTrShort: 0,
+        headTrMedium: 0,
+        headTrLong: 0,
+    };
+}
+function computeBpTr(high, low, close, prevClose) {
+    // First bar (no prevClose) — invinite seeds bp = tr = 0 so the
+    // running sums kick off at zero. We mirror that.
+    if (!Number.isFinite(prevClose))
+        return [0, 0];
+    const trueLow = Math.min(low, prevClose);
+    const trueHigh = Math.max(high, prevClose);
+    return [close - trueLow, trueHigh - trueLow];
+}
+function pushToWindow(ring, sum, incoming, capacity) {
+    let outgoing = 0;
+    if (ring.length >= capacity) {
+        outgoing = ring.at(capacity - 1);
+    }
+    ring.append(incoming);
+    return { newSum: sum + incoming - outgoing, outgoing };
+}
+function uoFromSums(sumBpShort, sumTrShort, sumBpMedium, sumTrMedium, sumBpLong, sumTrLong) {
+    if (sumTrShort === 0 || sumTrMedium === 0 || sumTrLong === 0)
+        return Number.NaN;
+    const avgShort = sumBpShort / sumTrShort;
+    const avgMedium = sumBpMedium / sumTrMedium;
+    const avgLong = sumBpLong / sumTrLong;
+    return (100 * (4 * avgShort + 2 * avgMedium + avgLong)) / 7;
+}
+function closeValue(slot, high, low, close) {
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(close)) {
+        // Hold prior — do not advance window state; emit NaN if unwarmed.
+        /* c8 ignore next */
+        if (slot.barCount < slot.longLength)
+            return Number.NaN;
+        return uoFromSums(slot.sumBpShort, slot.sumTrShort, slot.sumBpMedium, slot.sumTrMedium, slot.sumBpLong, slot.sumTrLong);
+    }
+    const [bp, tr] = computeBpTr(high, low, close, slot.prevClose);
+    const short = pushToWindow(slot.bpShort, slot.sumBpShort, bp, slot.shortLength);
+    slot.sumBpShort = short.newSum;
+    const medium = pushToWindow(slot.bpMedium, slot.sumBpMedium, bp, slot.mediumLength);
+    slot.sumBpMedium = medium.newSum;
+    const long = pushToWindow(slot.bpLong, slot.sumBpLong, bp, slot.longLength);
+    slot.sumBpLong = long.newSum;
+    const trShort = pushToWindow(slot.trShort, slot.sumTrShort, tr, slot.shortLength);
+    slot.sumTrShort = trShort.newSum;
+    const trMedium = pushToWindow(slot.trMedium, slot.sumTrMedium, tr, slot.mediumLength);
+    slot.sumTrMedium = trMedium.newSum;
+    const trLong = pushToWindow(slot.trLong, slot.sumTrLong, tr, slot.longLength);
+    slot.sumTrLong = trLong.newSum;
+    slot.prevPrevClose = slot.prevClose;
+    slot.prevClose = close;
+    slot.barCount += 1;
+    // Capture the new head's bp/tr per window for tick-mode replay.
+    slot.headBpShort = bp;
+    slot.headBpMedium = bp;
+    slot.headBpLong = bp;
+    slot.headTrShort = tr;
+    slot.headTrMedium = tr;
+    slot.headTrLong = tr;
+    if (slot.barCount < slot.longLength)
+        return Number.NaN;
+    return uoFromSums(slot.sumBpShort, slot.sumTrShort, slot.sumBpMedium, slot.sumTrMedium, slot.sumBpLong, slot.sumTrLong);
+}
+function tickValue(slot, high, low, close) {
+    if (slot.barCount < slot.longLength)
+        return Number.NaN;
+    if (!Number.isFinite(high) || !Number.isFinite(low) || !Number.isFinite(close)) {
+        return uoFromSums(slot.sumBpShort, slot.sumTrShort, slot.sumBpMedium, slot.sumTrMedium, slot.sumBpLong, slot.sumTrLong);
+    }
+    // The head bar's bp/tr were computed against prevPrevClose (the
+    // close two bars ago). Replaying the head with the tick uses the
+    // same prevPrevClose baseline.
+    const [tickBp, tickTr] = computeBpTr(high, low, close, slot.prevPrevClose);
+    return uoFromSums(slot.sumBpShort - slot.headBpShort + tickBp, slot.sumTrShort - slot.headTrShort + tickTr, slot.sumBpMedium - slot.headBpMedium + tickBp, slot.sumTrMedium - slot.headTrMedium + tickTr, slot.sumBpLong - slot.headBpLong + tickBp, slot.sumTrLong - slot.headTrLong + tickTr);
+}
+/**
+ * Larry Williams' Ultimate Oscillator. Sources from `bar.high` /
+ * `bar.low` / `bar.close` directly (no `source` arg — matches Pine).
+ * Weighted average of three buying-pressure / true-range ratios over
+ * `shortLength` / `mediumLength` / `longLength` windows (defaults
+ * `7` / `14` / `28`). Output bounded `[0, 100]` (or `NaN`).
+ *
+ * Zero-TR window (flat-line input over the long window) emits `NaN`.
+ * The registry records `yDomain: { kind: "fixed", min: 0, max: 100 }`
+ * via `TA_REGISTRY_METADATA`.
+ *
+ * @formula  bp = close − min(low, prevClose) ;
+ *           tr = max(high, prevClose) − min(low, prevClose) ;
+ *           avgN = Σ bp[t − N + 1 .. t] / Σ tr[t − N + 1 .. t] ;
+ *           uo = 100 · (4 · avgShort + 2 · avgMedium + avgLong) / 7
+ * @warmup   longLength
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-runtime";
+ *     // const u = ta.ultimateOsc("slot");
+ *     // plot(u);
+ */
+export function ultimateOsc(slotId, opts) {
+    const ctx = getCtx();
+    const shortLength = opts?.shortLength ?? DEFAULT_SHORT_LENGTH;
+    const mediumLength = opts?.mediumLength ?? DEFAULT_MEDIUM_LENGTH;
+    const longLength = opts?.longLength ?? DEFAULT_LONG_LENGTH;
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        slot = initSlot(shortLength, mediumLength, longLength, 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 slot.series;
+}
+//# sourceMappingURL=ultimateOsc.js.map

package/dist/ta/ultimateOsc.js.map

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

package/dist/ta/valuewhen.d.ts

@@ -0,0 +1,27 @@
+import type { Series, ValuewhenOpts } from "@invinite-org/chartlang-core";
+import { type ScalarOrSeries } from "./lib/sourceValue.js";
+/**
+ * Source value at the bar of the n-th most recent `condition === true`.
+ * `occurrence === 0` returns the value at the most recent match;
+ * `occurrence === 1` the second most recent; etc. NaN until
+ * `occurrence + 1` matches have been seen.
+ *
+ * NaN-source at the matching bar produces NaN in the ring entry, which
+ * surfaces as NaN once that entry is the one emitted. Matches NaN-source
+ * semantics in Pine.
+ *
+ * @formula  out[t] = source[bar of n-th most recent condition true],
+ *           NaN until `occurrence + 1` matches
+ * @warmup   bar of the `occurrence + 1`-th match (data-dependent)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const fast = ta.sma(bar.close, 10);
+ *     // const slow = ta.sma(bar.close, 30);
+ *     // const onCross = ta.valuewhen(ta.crossover(fast, slow), bar.close);
+ *     // plot(onCross);
+ */
+export declare function valuewhen(slotId: string, condition: Series<boolean>, source: ScalarOrSeries, occurrence?: number, opts?: ValuewhenOpts): Series<number>;
+//# sourceMappingURL=valuewhen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valuewhen.d.ts","sourceRoot":"","sources":["../../src/ta/valuewhen.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAK1E,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAqF5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAC1B,MAAM,EAAE,cAAc,EACtB,UAAU,SAAI,EACd,IAAI,GAAE,aAAkB,GACzB,MAAM,CAAC,MAAM,CAAC,CAqBhB"}