@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/netVolume.js

@@ -0,0 +1,118 @@
+// 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/net-volume.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 math is identical to `ta.obv`; both
+// primitives exist in invinite under their own names, so the
+// chartlang surface mirrors the public API for naming parity. See
+// `obv.ts` for the canonical commentary on `fold`, snapshot fields,
+// and NaN handling — this file repeats the shape verbatim under its
+// own slot type so each primitive has its own per-callsite state.
+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.netVolume called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        shiftedViews: new Map(),
+        cumNetVol: 0,
+        prevClose: Number.NaN,
+        prevClosedCumNetVol: 0,
+        prevClosedPrevClose: Number.NaN,
+    };
+}
+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 signOfDelta(delta) {
+    if (delta > 0)
+        return 1;
+    if (delta < 0)
+        return -1;
+    return 0;
+}
+function fold(inCum, inPrevClose, close, volume) {
+    if (!Number.isFinite(close)) {
+        return { cum: inCum, prevClose: inPrevClose };
+    }
+    if (!Number.isFinite(inPrevClose)) {
+        return { cum: inCum, prevClose: close };
+    }
+    if (!Number.isFinite(volume)) {
+        return { cum: inCum, prevClose: close };
+    }
+    const direction = signOfDelta(close - inPrevClose);
+    return { cum: inCum + direction * volume, prevClose: close };
+}
+/**
+ * Net Volume — cumulative `sign(close − prevClose) · volume`. **The
+ * math is identical to `ta.obv`** (both primitives ship in invinite
+ * under their own names; chartlang mirrors the public surface for
+ * naming parity). Prefer `ta.obv` when writing new scripts — this
+ * primitive exists to satisfy translation of Pine / invinite
+ * indicators that call `netVolume()` directly. The cross-equivalence
+ * is property-tested (`netVolume.property.test.ts`).
+ *
+ * First bar emits `0` (no prior close to difference against — Pine
+ * convention). NaN volume carries the accumulator forward without an
+ * update; NaN close holds `prevClose` at its prior value.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `(cumNetVol, prevClose)` tuple.
+ *
+ * @formula  netVolume[t] = netVolume[t − 1] + sign(close[t] − close[t − 1]) · volume[t]
+ * @warmup   1 (needs a prior close to compute the delta; bar 0 emits 0)
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts the returned series (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const nv = ta.netVolume();
+ *     // plot(nv);
+ */
+export function netVolume(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);
+    }
+    const offset = opts?.offset ?? 0;
+    const { close, volume } = ctx.stream.bar;
+    if (ctx.isTick) {
+        const next = fold(slot.prevClosedCumNetVol, slot.prevClosedPrevClose, close, volume);
+        slot.outBuffer.replaceHead(next.cum);
+        return viewForOffset(slot, offset);
+    }
+    slot.prevClosedCumNetVol = slot.cumNetVol;
+    slot.prevClosedPrevClose = slot.prevClose;
+    const next = fold(slot.cumNetVol, slot.prevClose, close, volume);
+    slot.cumNetVol = next.cum;
+    slot.prevClose = next.prevClose;
+    slot.outBuffer.append(slot.cumNetVol);
+    return viewForOffset(slot, offset);
+}
+//# sourceMappingURL=netVolume.js.map

package/dist/ta/netVolume.js.map

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

package/dist/ta/nvi.d.ts

@@ -0,0 +1,35 @@
+import type { NviOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * Negative Volume Index — cumulative percentage-change in close on
+ * bars whose volume is strictly LOWER than the prior bar's; bars with
+ * equal-or-higher volume carry the prior NVI value unchanged. Seeded
+ * at 1000 (anchor — see `SEED_VALUE`); the property tests pin the
+ * seed at bar 0.
+ *
+ * NaN volume is treated as 0 (matches invinite's `safeVolume` shape) —
+ * a NaN-volume bar is "lower" than any positive-volume bar, so the
+ * comparison is exercised. NaN close carries every accumulator field
+ * forward without advancing — the next finite close differences
+ * against the last finite one.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `(value, prevClose, prevVolume)` tuple.
+ *
+ * @formula  nvi[0] = 1000 ;
+ *           nvi[t] = (volume[t] < volume[t − 1] && prevClose != 0)
+ *                  ? nvi[t − 1] · (1 + (close[t] − close[t − 1]) / close[t − 1])
+ *                  : nvi[t − 1]
+ * @warmup   1 (bar 0 emits the 1000 seed)
+ * @anchors  seedValue
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts the returned series (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const n = ta.nvi();
+ *     // plot(n);
+ */
+export declare function nvi(slotId: string, opts?: NviOpts): Series<number>;
+//# sourceMappingURL=nvi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nvi.d.ts","sourceRoot":"","sources":["../../src/ta/nvi.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAoGpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CA+BlE"}

package/dist/ta/nvi.js

@@ -0,0 +1,140 @@
+// 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/nvi.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 runtime emits the RAW NVI line only;
+// invinite's optional smoothing block is left to the script author
+// (`ta.ema(ta.nvi(), 255)` etc.). The mirror primitive `ta.pvi`
+// re-uses this file's `nviLikeFold` shape with a flipped predicate.
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView, makeShiftedSeriesView } from "../seriesView.js";
+/**
+ * Anchored seed value at bar 0 (and after any bar where the
+ * accumulator has been carried-forward through NaN inputs).
+ *
+ * @anchors seedValue
+ */
+const SEED_VALUE = 1000;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.nvi called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        shiftedViews: new Map(),
+        value: SEED_VALUE,
+        prevClose: Number.NaN,
+        prevVolume: Number.NaN,
+        prevClosedValue: SEED_VALUE,
+        prevClosedPrevClose: Number.NaN,
+        prevClosedPrevVolume: Number.NaN,
+    };
+}
+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 safeVol(volume) {
+    return Number.isFinite(volume) ? volume : 0;
+}
+/**
+ * Fold the bar's `(close, volume)` into the prior NVI state. NaN close
+ * carries every field forward (don't advance `prevClose` — the next
+ * finite close differences against the last finite one). NaN volume
+ * is treated as 0 (matches invinite's `safeVolume` shape). The
+ * comparison runs `currV < prevV` (NVI) and only updates when the
+ * comparison holds AND `prevClose !== 0`.
+ */
+function fold(inValue, inPrevClose, inPrevVolume, close, volume) {
+    if (!Number.isFinite(close)) {
+        return { value: inValue, prevClose: inPrevClose, prevVolume: inPrevVolume };
+    }
+    const v = safeVol(volume);
+    if (!Number.isFinite(inPrevClose)) {
+        // First defined close — seed `prevClose` + `prevVolume`,
+        // leave `value` at its 1000 seed.
+        return { value: inValue, prevClose: close, prevVolume: v };
+    }
+    const pv = safeVol(inPrevVolume);
+    const shouldUpdate = v < pv;
+    if (!shouldUpdate || inPrevClose === 0) {
+        return { value: inValue, prevClose: close, prevVolume: v };
+    }
+    const next = inValue * (1 + (close - inPrevClose) / inPrevClose);
+    return { value: next, prevClose: close, prevVolume: v };
+}
+/**
+ * Negative Volume Index — cumulative percentage-change in close on
+ * bars whose volume is strictly LOWER than the prior bar's; bars with
+ * equal-or-higher volume carry the prior NVI value unchanged. Seeded
+ * at 1000 (anchor — see `SEED_VALUE`); the property tests pin the
+ * seed at bar 0.
+ *
+ * NaN volume is treated as 0 (matches invinite's `safeVolume` shape) —
+ * a NaN-volume bar is "lower" than any positive-volume bar, so the
+ * comparison is exercised. NaN close carries every accumulator field
+ * forward without advancing — the next finite close differences
+ * against the last finite one.
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close `(value, prevClose, prevVolume)` tuple.
+ *
+ * @formula  nvi[0] = 1000 ;
+ *           nvi[t] = (volume[t] < volume[t − 1] && prevClose != 0)
+ *                  ? nvi[t − 1] · (1 + (close[t] − close[t − 1]) / close[t − 1])
+ *                  : nvi[t − 1]
+ * @warmup   1 (bar 0 emits the 1000 seed)
+ * @anchors  seedValue
+ * @since 0.2
+ * @stable
+ *
+ * `opts.offset` shifts the returned series (PLAN.md §9.1).
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const n = ta.nvi();
+ *     // plot(n);
+ */
+export function nvi(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);
+    }
+    const offset = opts?.offset ?? 0;
+    const { close, volume } = ctx.stream.bar;
+    if (ctx.isTick) {
+        const next = fold(slot.prevClosedValue, slot.prevClosedPrevClose, slot.prevClosedPrevVolume, close, volume);
+        slot.outBuffer.replaceHead(next.value);
+        return viewForOffset(slot, offset);
+    }
+    slot.prevClosedValue = slot.value;
+    slot.prevClosedPrevClose = slot.prevClose;
+    slot.prevClosedPrevVolume = slot.prevVolume;
+    const next = fold(slot.value, slot.prevClose, slot.prevVolume, close, volume);
+    slot.value = next.value;
+    slot.prevClose = next.prevClose;
+    slot.prevVolume = next.prevVolume;
+    slot.outBuffer.append(slot.value);
+    return viewForOffset(slot, offset);
+}
+//# sourceMappingURL=nvi.js.map

package/dist/ta/nvi.js.map

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

package/dist/ta/nz.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Replace `NaN` with a fallback. Returns `value` unchanged when it
+ * is not `NaN`; otherwise returns `replacement` (defaults to `0`).
+ * Stateless — does not allocate a slot, does not consult the active
+ * runtime context.
+ *
+ * @formula  Number.isNaN(value) ? (replacement ?? 0) : value
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const safe = ta.nz(ta.change(bar.close).current, 0);
+ */
+export declare function nz(value: number, replacement?: number): number;
+//# sourceMappingURL=nz.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nz.d.ts","sourceRoot":"","sources":["../../src/ta/nz.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/ta/nz.js

@@ -0,0 +1,25 @@
+// 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.nz`. See PLAN.md §3.1.
+/**
+ * Replace `NaN` with a fallback. Returns `value` unchanged when it
+ * is not `NaN`; otherwise returns `replacement` (defaults to `0`).
+ * Stateless — does not allocate a slot, does not consult the active
+ * runtime context.
+ *
+ * @formula  Number.isNaN(value) ? (replacement ?? 0) : value
+ * @warmup   0
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const safe = ta.nz(ta.change(bar.close).current, 0);
+ */
+export function nz(value, replacement) {
+    if (Number.isNaN(value))
+        return replacement ?? 0;
+    return value;
+}
+//# sourceMappingURL=nz.js.map

package/dist/ta/nz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nz.js","sourceRoot":"","sources":["../../src/ta/nz.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,qEAAqE;AAErE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,EAAE,CAAC,KAAa,EAAE,WAAoB;IAClD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,IAAI,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/ta/obv.d.ts

@@ -0,0 +1,25 @@
+import type { ObvOpts, Series } from "@invinite-org/chartlang-core";
+/**
+ * On-Balance Volume — cumulative volume signed by close-vs-prev-close
+ * direction. Renders in its own pane (volume category). Flat closes
+ * (delta = 0) contribute nothing; NaN volume carries the accumulator
+ * forward without an update (matches invinite's `safeVolume`-style
+ * defensive shape). The first bar emits `0` (no prior close to
+ * difference against — Pine convention).
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close (cumObv, prevClose) tuple so a partial-
+ * bar tick doesn't pollute the next close's accumulator.
+ *
+ * @formula  obv[t] = obv[t − 1] + sign(close[t] − close[t − 1]) · volume[t]
+ * @warmup   1 (needs a prior close to compute the delta; bar 0 emits 0)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const o = ta.obv();
+ *     // plot(o);
+ */
+export declare function obv(slotId: string, _opts?: ObvOpts): Series<number>;
+//# sourceMappingURL=obv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"obv.d.ts","sourceRoot":"","sources":["../../src/ta/obv.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AA2EpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAuBnE"}

package/dist/ta/obv.js

@@ -0,0 +1,109 @@
+// 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/obv.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 runtime emits the RAW OBV cumulative
+// only; invinite's optional smoothing block is left to the script
+// author (`ta.ema(ta.obv(), n)` etc.).
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.obv called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity) {
+    const outBuffer = new Float64RingBuffer(capacity);
+    return {
+        outBuffer,
+        series: makeSeriesView(outBuffer),
+        cumObv: 0,
+        prevClose: Number.NaN,
+        prevClosedCumObv: 0,
+        prevClosedPrevClose: Number.NaN,
+    };
+}
+function signOfDelta(delta) {
+    if (delta > 0)
+        return 1;
+    if (delta < 0)
+        return -1;
+    return 0;
+}
+/**
+ * Compute the (cumObv, prevClose) accumulator state AFTER folding the
+ * given bar into the prior (inCumObv, inPrevClose) state. NaN close or
+ * NaN volume carries the accumulator forward unchanged (matches
+ * invinite's `safeVolume(NaN) === 0` shape under the `prevClose === NaN`
+ * first-bar guard).
+ */
+function fold(inCumObv, inPrevClose, close, volume) {
+    if (!Number.isFinite(close)) {
+        return { cumObv: inCumObv, prevClose: inPrevClose };
+    }
+    if (!Number.isFinite(inPrevClose)) {
+        // First bar with a defined close — seed `prevClose`, leave
+        // `cumObv` at its zero seed.
+        return { cumObv: inCumObv, prevClose: close };
+    }
+    if (!Number.isFinite(volume)) {
+        // NaN volume → contribute nothing this bar, but advance
+        // `prevClose` so the next delta is well-defined.
+        return { cumObv: inCumObv, prevClose: close };
+    }
+    const direction = signOfDelta(close - inPrevClose);
+    return { cumObv: inCumObv + direction * volume, prevClose: close };
+}
+/**
+ * On-Balance Volume — cumulative volume signed by close-vs-prev-close
+ * direction. Renders in its own pane (volume category). Flat closes
+ * (delta = 0) contribute nothing; NaN volume carries the accumulator
+ * forward without an update (matches invinite's `safeVolume`-style
+ * defensive shape). The first bar emits `0` (no prior close to
+ * difference against — Pine convention).
+ *
+ * **Tick mode.** Replays the head bar's contribution against a
+ * snapshot of the prior-close (cumObv, prevClose) tuple so a partial-
+ * bar tick doesn't pollute the next close's accumulator.
+ *
+ * @formula  obv[t] = obv[t − 1] + sign(close[t] − close[t − 1]) · volume[t]
+ * @warmup   1 (needs a prior close to compute the delta; bar 0 emits 0)
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta, plot } from "@invinite-org/chartlang-core";
+ *     // const o = ta.obv();
+ *     // plot(o);
+ */
+export function obv(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);
+    }
+    const { close, volume } = ctx.stream.bar;
+    if (ctx.isTick) {
+        const next = fold(slot.prevClosedCumObv, slot.prevClosedPrevClose, close, volume);
+        slot.outBuffer.replaceHead(next.cumObv);
+        return slot.series;
+    }
+    // Close-side: snapshot the prior-close state, then fold in.
+    slot.prevClosedCumObv = slot.cumObv;
+    slot.prevClosedPrevClose = slot.prevClose;
+    const next = fold(slot.cumObv, slot.prevClose, close, volume);
+    slot.cumObv = next.cumObv;
+    slot.prevClose = next.prevClose;
+    slot.outBuffer.append(slot.cumObv);
+    return slot.series;
+}
+//# sourceMappingURL=obv.js.map

package/dist/ta/obv.js.map

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

package/dist/ta/persistence.d.ts

@@ -0,0 +1,40 @@
+import type { JsonValue } from "@invinite-org/chartlang-core";
+import type { StreamState } from "../streamState.js";
+/**
+ * Return whether a snapshot slot key belongs to the TA persistence namespace.
+ *
+ * @since 0.5
+ * @internal
+ * @stable
+ * @formula  key.startsWith("ta:")
+ * @example
+ *     isTaSlotSnapshotKey("ta:slot#0"); // true
+ */
+export declare function isTaSlotSnapshotKey(key: string): boolean;
+/**
+ * Serialise supported `ta.*` runtime slots into JSON-clean snapshot entries.
+ *
+ * @since 0.5
+ * @internal
+ * @stable
+ * @formula  snapshot[`ta:${slotId}`] = serialise(slot) for supported TA slots
+ * @example
+ *     // const entries = serialiseTaSlots(stream);
+ *     const entries = {};
+ *     void entries;
+ */
+export declare function serialiseTaSlots(stream: StreamState): Readonly<Record<string, JsonValue>>;
+/**
+ * Restore supported `ta.*` runtime slots from namespaced snapshot entries.
+ *
+ * @since 0.5
+ * @internal
+ * @stable
+ * @formula  stream.taSlots[slotId] = restore(snapshot[`ta:${slotId}`])
+ * @example
+ *     // restoreTaSlots(stream, snapshot.slots);
+ *     const restored = true;
+ *     void restored;
+ */
+export declare function restoreTaSlots(stream: StreamState, slots: Readonly<Record<string, unknown>>): void;
+//# sourceMappingURL=persistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/ta/persistence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,8BAA8B,CAAC;AAItE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkTrD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CASzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,IAAI,CASN"}