@invinite-org/chartlang-runtime 1.0.2

package/dist/ta/zigZag.js

@@ -0,0 +1,296 @@
+// 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/zig-zag.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 chartlang port is **streaming**: the
+// output `value` Series carries the most-recently-confirmed pivot
+// price (held constant between confirmations), whereas invinite's
+// batch `compute` linearly interpolates pivot→pivot and supports
+// `extendToLastBar` retro-painting. The append-only Series model
+// cannot rewrite older slots, so the streaming output is the closest
+// representable surface — useful as a "trailing reference level".
+import { Float64RingBuffer } from "../ringBuffer.js";
+import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
+import { makeSeriesView } from "../seriesView.js";
+const DEFAULT_DEVIATION = 5;
+const DEFAULT_DEPTH = 10;
+const TREND_UP = 1;
+const TREND_DOWN = -1;
+const TREND_UNKNOWN = 0;
+function getCtx() {
+    const ctx = ACTIVE_RUNTIME_CONTEXT.current;
+    if (ctx === null) {
+        throw new Error("ta.zigZag called outside an active script step");
+    }
+    return ctx;
+}
+function initSlot(capacity, deviation, depth) {
+    const valueBuffer = new Float64RingBuffer(capacity);
+    const directionBuffer = new Float64RingBuffer(capacity);
+    return {
+        outputs: Object.freeze({
+            value: makeSeriesView(valueBuffer),
+            direction: makeSeriesView(directionBuffer),
+        }),
+        valueBuffer,
+        directionBuffer,
+        deviation,
+        depth,
+        barCount: 0,
+        direction: TREND_UNKNOWN,
+        lastPivotPrice: Number.NaN,
+        lastPivotIndex: -1,
+        peakSinceLastPivot: Number.NaN,
+        peakIndex: -1,
+        prevClosedBarCount: 0,
+        prevClosedDirection: TREND_UNKNOWN,
+        prevClosedLastPivotPrice: Number.NaN,
+        prevClosedLastPivotIndex: -1,
+        prevClosedPeakSinceLastPivot: Number.NaN,
+        prevClosedPeakIndex: -1,
+    };
+}
+function snapshot(slot) {
+    slot.prevClosedBarCount = slot.barCount;
+    slot.prevClosedDirection = slot.direction;
+    slot.prevClosedLastPivotPrice = slot.lastPivotPrice;
+    slot.prevClosedLastPivotIndex = slot.lastPivotIndex;
+    slot.prevClosedPeakSinceLastPivot = slot.peakSinceLastPivot;
+    slot.prevClosedPeakIndex = slot.peakIndex;
+}
+/**
+ * One step of the streaming ZigZag state machine. Returns the new
+ * `(value, direction, lastPivotPrice, lastPivotIndex,
+ * peakSinceLastPivot, peakIndex, direction)` state given the prior
+ * state and this bar's `(close, barIndex)`. Used by both close-side
+ * (which mutates the slot) and tick-side (which reads the snapshot,
+ * does NOT mutate the slot).
+ */
+function recurrenceStep(close, barIndex, deviation, depth, prevDirection, prevLastPivotPrice, prevLastPivotIndex, prevPeakSinceLastPivot, prevPeakIndex) {
+    const pctChangeVsPivot = ((close - prevLastPivotPrice) / prevLastPivotPrice) * 100;
+    const barsSincePivot = barIndex - prevLastPivotIndex;
+    if (prevDirection === TREND_UNKNOWN) {
+        // Pre-first-pivot: commit when |pct| crosses deviation AND
+        // depth bars have elapsed since bar 0.
+        if (Math.abs(pctChangeVsPivot) >= deviation &&
+            barsSincePivot >= depth &&
+            prevLastPivotPrice !== 0) {
+            const newDirection = pctChangeVsPivot > 0 ? TREND_UP : TREND_DOWN;
+            return {
+                value: close,
+                direction: newDirection,
+                nextDirection: newDirection,
+                nextLastPivotPrice: close,
+                nextLastPivotIndex: barIndex,
+                nextPeakSinceLastPivot: close,
+                nextPeakIndex: barIndex,
+            };
+        }
+        return {
+            value: Number.NaN,
+            direction: Number.NaN,
+            nextDirection: TREND_UNKNOWN,
+            nextLastPivotPrice: prevLastPivotPrice,
+            nextLastPivotIndex: prevLastPivotIndex,
+            nextPeakSinceLastPivot: prevPeakSinceLastPivot,
+            nextPeakIndex: prevPeakIndex,
+        };
+    }
+    if (prevDirection === TREND_UP) {
+        // Trending up: update running peak when price makes new high.
+        if (close > prevPeakSinceLastPivot) {
+            return {
+                value: prevLastPivotPrice,
+                direction: TREND_UP,
+                nextDirection: TREND_UP,
+                nextLastPivotPrice: prevLastPivotPrice,
+                nextLastPivotIndex: prevLastPivotIndex,
+                nextPeakSinceLastPivot: close,
+                nextPeakIndex: barIndex,
+            };
+        }
+        // Reversal candidate: price dropped by `deviation %` from the
+        // running peak AND `depth` bars have elapsed since the peak.
+        // Reaching the up-trend branch requires a prior up-commit
+        // which set lastPivotPrice (and thus peak) from a finite,
+        // non-zero close — so peak > 0 here.
+        const pctDropFromPeak = ((prevPeakSinceLastPivot - close) / prevPeakSinceLastPivot) * 100;
+        const barsSincePeak = barIndex - prevPeakIndex;
+        if (pctDropFromPeak >= deviation && barsSincePeak >= depth) {
+            // Confirm the running peak as the new pivot; flip
+            // direction. The new lastPivot is the peak (NOT the
+            // current close).
+            return {
+                value: prevPeakSinceLastPivot,
+                direction: TREND_DOWN,
+                nextDirection: TREND_DOWN,
+                nextLastPivotPrice: prevPeakSinceLastPivot,
+                nextLastPivotIndex: prevPeakIndex,
+                nextPeakSinceLastPivot: close,
+                nextPeakIndex: barIndex,
+            };
+        }
+        // No new peak, no reversal — hold the current pivot.
+        return {
+            value: prevLastPivotPrice,
+            direction: TREND_UP,
+            nextDirection: TREND_UP,
+            nextLastPivotPrice: prevLastPivotPrice,
+            nextLastPivotIndex: prevLastPivotIndex,
+            nextPeakSinceLastPivot: prevPeakSinceLastPivot,
+            nextPeakIndex: prevPeakIndex,
+        };
+    }
+    // prevDirection === TREND_DOWN.
+    if (close < prevPeakSinceLastPivot) {
+        return {
+            value: prevLastPivotPrice,
+            direction: TREND_DOWN,
+            nextDirection: TREND_DOWN,
+            nextLastPivotPrice: prevLastPivotPrice,
+            nextLastPivotIndex: prevLastPivotIndex,
+            nextPeakSinceLastPivot: close,
+            nextPeakIndex: barIndex,
+        };
+    }
+    // Down-trend reach: a prior down-flip OR commit-down set the
+    // trough's source to a finite close. The trough CAN be 0 (commit-
+    // up at 0 then flip-down at 0); the previous close was 0 so the
+    // pctRise calc would divide by zero. Guard.
+    const pctRiseFromTrough = prevPeakSinceLastPivot !== 0
+        ? ((close - prevPeakSinceLastPivot) / prevPeakSinceLastPivot) * 100
+        : 0;
+    const barsSinceTrough = barIndex - prevPeakIndex;
+    if (pctRiseFromTrough >= deviation && barsSinceTrough >= depth) {
+        return {
+            value: prevPeakSinceLastPivot,
+            direction: TREND_UP,
+            nextDirection: TREND_UP,
+            nextLastPivotPrice: prevPeakSinceLastPivot,
+            nextLastPivotIndex: prevPeakIndex,
+            nextPeakSinceLastPivot: close,
+            nextPeakIndex: barIndex,
+        };
+    }
+    return {
+        value: prevLastPivotPrice,
+        direction: TREND_DOWN,
+        nextDirection: TREND_DOWN,
+        nextLastPivotPrice: prevLastPivotPrice,
+        nextLastPivotIndex: prevLastPivotIndex,
+        nextPeakSinceLastPivot: prevPeakSinceLastPivot,
+        nextPeakIndex: prevPeakIndex,
+    };
+}
+function closeStep(slot, close, barIndex) {
+    if (!Number.isFinite(close)) {
+        // NaN close: freeze state. Snapshot is unchanged (covers tick
+        // replay on the same NaN bar). Emit NaN/NaN.
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    snapshot(slot);
+    if (slot.barCount === 0) {
+        // Seed bar — bar 0 is the candidate pivot, direction unknown.
+        slot.barCount = 1;
+        slot.lastPivotPrice = close;
+        slot.lastPivotIndex = 0;
+        slot.peakSinceLastPivot = close;
+        slot.peakIndex = 0;
+        slot.direction = TREND_UNKNOWN;
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    const step = recurrenceStep(close, barIndex, slot.deviation, slot.depth, slot.direction, slot.lastPivotPrice, slot.lastPivotIndex, slot.peakSinceLastPivot, slot.peakIndex);
+    slot.barCount += 1;
+    slot.direction = step.nextDirection;
+    slot.lastPivotPrice = step.nextLastPivotPrice;
+    slot.lastPivotIndex = step.nextLastPivotIndex;
+    slot.peakSinceLastPivot = step.nextPeakSinceLastPivot;
+    slot.peakIndex = step.nextPeakIndex;
+    return { value: step.value, direction: step.direction };
+}
+function tickStep(slot, close, barIndex) {
+    if (!Number.isFinite(close)) {
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    if (slot.prevClosedBarCount === 0) {
+        // The current bar is the first closed bar — its tick replay
+        // is the seed itself (NaN, NaN).
+        return { value: Number.NaN, direction: Number.NaN };
+    }
+    const step = recurrenceStep(close, barIndex, slot.deviation, slot.depth, slot.prevClosedDirection, slot.prevClosedLastPivotPrice, slot.prevClosedLastPivotIndex, slot.prevClosedPeakSinceLastPivot, slot.prevClosedPeakIndex);
+    return { value: step.value, direction: step.direction };
+}
+/**
+ * ZigZag — streaming swing-pivot detector. Walks the close series
+ * tracking a running candidate pivot; confirms a new pivot when the
+ * price has reversed by at least `deviation %` from the candidate
+ * AND `depth` bars have elapsed. The output `value` Series carries
+ * the price of the most-recently-confirmed pivot (held constant
+ * between confirmations); `direction` is `+1` (uptrend), `-1`
+ * (downtrend), or NaN before the first confirmation. Returns a
+ * cached `{ value, direction }` record (same identity every bar).
+ *
+ * Streaming adaptation of invinite's batch ZigZag: invinite paints
+ * a linearly-interpolated polyline between confirmed pivots and
+ * supports `extendToLastBar` retro-painting from the last confirmed
+ * pivot to the right edge. The append-only Series model cannot
+ * rewrite older slots, so the streaming output is the closest
+ * representable surface (a "trailing reference level" Pine authors
+ * would use as a stop). Defaults: `deviation = 5`, `depth = 10`.
+ *
+ * NaN close → NaN outputs and freezes the state machine. Tick-mode
+ * replays the head from the snapshot captured at the start of the
+ * current bar (mirrors PSAR / Supertrend).
+ *
+ * @formula  Confirm pivot when |Δ%| ≥ deviation AND barsSince ≥ depth :
+ *           up-trend: running peak updates on new highs ; flip on
+ *           |drop from peak| ≥ deviation ; flip-direction emits the
+ *           peak (the just-confirmed top) as `value`, sets new
+ *           `direction = −1`. Down-trend symmetric.
+ * @warmup   input-dependent (NaN until first confirmed pivot)
+ * @anchors  deviation, depth
+ * @since 0.2
+ * @stable
+ *
+ * @example
+ *     // import { ta } from "@invinite-org/chartlang-core";
+ *     // const z = ta.zigZag({ deviation: 5 });
+ *     // plot(z.value);
+ */
+export function zigZag(slotId, opts) {
+    const ctx = getCtx();
+    let slot = ctx.stream.taSlots.get(slotId);
+    if (slot === undefined) {
+        const deviation = opts?.deviation ?? DEFAULT_DEVIATION;
+        const depth = opts?.depth ?? DEFAULT_DEPTH;
+        slot = initSlot(ctx.stream.ohlcv.close.capacity, deviation, depth);
+        ctx.stream.taSlots.set(slotId, slot);
+    }
+    const close = ctx.stream.bar.close;
+    if (ctx.isTick) {
+        // Tick replay uses the snapshot's barCount as the current-bar
+        // index (the close-side incremented barCount AFTER taking the
+        // snapshot, so the snapshot's barCount equals the index of
+        // THIS bar).
+        const barIndexForStep = slot.prevClosedBarCount;
+        const { value, direction } = tickStep(slot, close, barIndexForStep);
+        slot.valueBuffer.replaceHead(value);
+        slot.directionBuffer.replaceHead(direction);
+    }
+    else {
+        // Close-side uses slot.barCount (pre-increment in this close)
+        // — the bar's 0-based index. Snapshot/seed branch handles
+        // barCount === 0 explicitly.
+        const barIndexForStep = slot.barCount;
+        const { value, direction } = closeStep(slot, close, barIndexForStep);
+        slot.valueBuffer.append(value);
+        slot.directionBuffer.append(direction);
+    }
+    return slot.outputs;
+}
+//# sourceMappingURL=zigZag.js.map

package/dist/ta/zigZag.js.map

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

package/dist/views/barstateView.d.ts

@@ -0,0 +1,44 @@
+import type { BarStateView } from "@invinite-org/chartlang-core";
+/**
+ * Candle-event kind used to derive the per-step `barstate.*` snapshot.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const kind: EventKind = "close";
+ *     void kind;
+ */
+export type EventKind = "history" | "close" | "tick";
+/**
+ * Inputs needed to build a `barstate.*` runtime view.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const inputs: BarStateInputs = {
+ *         eventKind: "history",
+ *         barIndex: 0,
+ *         isLastBar: false,
+ *     };
+ *     void inputs;
+ */
+export type BarStateInputs = Readonly<{
+    eventKind: EventKind;
+    barIndex: number;
+    isLastBar: boolean;
+}>;
+/**
+ * Build a frozen `barstate.*` view for the current script step.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view = makeBarStateView({
+ *         eventKind: "tick",
+ *         barIndex: 5,
+ *         isLastBar: true,
+ *     });
+ *     void view.isrealtime;
+ */
+export declare function makeBarStateView(inputs: BarStateInputs): BarStateView;
+//# sourceMappingURL=barstateView.d.ts.map

package/dist/views/barstateView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barstateView.d.ts","sourceRoot":"","sources":["../../src/views/barstateView.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAUrE"}

package/dist/views/barstateView.js

@@ -0,0 +1,27 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Build a frozen `barstate.*` view for the current script step.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view = makeBarStateView({
+ *         eventKind: "tick",
+ *         barIndex: 5,
+ *         isLastBar: true,
+ *     });
+ *     void view.isrealtime;
+ */
+export function makeBarStateView(inputs) {
+    const { eventKind, barIndex, isLastBar } = inputs;
+    return Object.freeze({
+        isfirst: barIndex === 0,
+        islast: isLastBar,
+        isnew: eventKind === "history" || eventKind === "close",
+        ishistory: eventKind === "history",
+        isrealtime: eventKind === "tick",
+        isconfirmed: eventKind === "close",
+    });
+}
+//# sourceMappingURL=barstateView.js.map

package/dist/views/barstateView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barstateView.js","sourceRoot":"","sources":["../../src/views/barstateView.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAkC/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACnD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,OAAO,EAAE,QAAQ,KAAK,CAAC;QACvB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,OAAO;QACvD,SAAS,EAAE,SAAS,KAAK,SAAS;QAClC,UAAU,EAAE,SAAS,KAAK,MAAM;QAChC,WAAW,EAAE,SAAS,KAAK,OAAO;KACrC,CAAC,CAAC;AACP,CAAC"}

package/dist/views/index.d.ts

@@ -0,0 +1,37 @@
+import type { BarStateView, SymInfoView, TimeframeView } from "@invinite-org/chartlang-core";
+export { refreshRuntimeViews } from "./refreshRuntimeViews.js";
+/**
+ * Mutable runtime view container. Each field is replaced with a fresh
+ * frozen snapshot as the runner advances.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const views: RuntimeViews = createRuntimeViews();
+ *     views.barstate = views.barstate;
+ */
+export type RuntimeViews = {
+    barstate: BarStateView;
+    syminfo: SymInfoView;
+    timeframe: TimeframeView;
+};
+/**
+ * Build the default runtime view container for a script mount.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const views = createRuntimeViews({
+ *         syminfo: makeSymInfoView({ ticker: "DEMO" }, new Set(["ticker"])),
+ *     });
+ *     void views.syminfo.ticker;
+ */
+export declare function createRuntimeViews(opts?: {
+    readonly syminfo?: SymInfoView;
+}): RuntimeViews;
+export { makeBarStateView } from "./barstateView.js";
+export { makeSymInfoView } from "./symInfoView.js";
+export { makeTimeframeView } from "./timeframeView.js";
+export type { BarStateInputs, EventKind } from "./barstateView.js";
+export type { AdapterSymInfo } from "./symInfoView.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,GAAG,YAAY,CAM9F;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/views/index.js

@@ -0,0 +1,28 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { makeBarStateView } from "./barstateView.js";
+export { refreshRuntimeViews } from "./refreshRuntimeViews.js";
+import { makeSymInfoView } from "./symInfoView.js";
+import { makeTimeframeView } from "./timeframeView.js";
+/**
+ * Build the default runtime view container for a script mount.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const views = createRuntimeViews({
+ *         syminfo: makeSymInfoView({ ticker: "DEMO" }, new Set(["ticker"])),
+ *     });
+ *     void views.syminfo.ticker;
+ */
+export function createRuntimeViews(opts = {}) {
+    return {
+        barstate: makeBarStateView({ eventKind: "history", barIndex: 0, isLastBar: false }),
+        syminfo: opts.syminfo ?? makeSymInfoView({}, new Set()),
+        timeframe: makeTimeframeView("", undefined),
+    };
+}
+export { makeBarStateView } from "./barstateView.js";
+export { makeSymInfoView } from "./symInfoView.js";
+export { makeTimeframeView } from "./timeframeView.js";
+//# sourceMappingURL=index.js.map

package/dist/views/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAkBvD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA2C,EAAE;IAC5E,OAAO;QACH,QAAQ,EAAE,gBAAgB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACnF,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC;QACvD,SAAS,EAAE,iBAAiB,CAAC,EAAE,EAAE,SAAS,CAAC;KAC9C,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/views/refreshRuntimeViews.d.ts

@@ -0,0 +1,15 @@
+import type { RunnerState } from "../createScriptRunner.js";
+import { type EventKind } from "./barstateView.js";
+/**
+ * Refresh per-step runtime views after the mutable bar view has been updated
+ * and before `compute` runs.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     // refreshRuntimeViews(state, "close");
+ *     const fn: typeof refreshRuntimeViews = refreshRuntimeViews;
+ *     void fn;
+ */
+export declare function refreshRuntimeViews(state: RunnerState, eventKind: EventKind): void;
+//# sourceMappingURL=refreshRuntimeViews.d.ts.map

package/dist/views/refreshRuntimeViews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refreshRuntimeViews.d.ts","sourceRoot":"","sources":["../../src/views/refreshRuntimeViews.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAUrE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAYlF"}

package/dist/views/refreshRuntimeViews.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { makeBarStateView } from "./barstateView.js";
+import { makeTimeframeView } from "./timeframeView.js";
+function findDescriptor(intervals, interval) {
+    return intervals.find((candidate) => candidate.value === interval);
+}
+/**
+ * Refresh per-step runtime views after the mutable bar view has been updated
+ * and before `compute` runs.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     // refreshRuntimeViews(state, "close");
+ *     const fn: typeof refreshRuntimeViews = refreshRuntimeViews;
+ *     void fn;
+ */
+export function refreshRuntimeViews(state, eventKind) {
+    const { runtimeContext } = state;
+    const interval = runtimeContext.stream.bar.interval;
+    runtimeContext.views.barstate = makeBarStateView({
+        eventKind,
+        barIndex: runtimeContext.barIndex(),
+        isLastBar: eventKind !== "history",
+    });
+    runtimeContext.views.timeframe = makeTimeframeView(interval, findDescriptor(runtimeContext.capabilities.intervals, interval));
+}
+//# sourceMappingURL=refreshRuntimeViews.js.map

package/dist/views/refreshRuntimeViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refreshRuntimeViews.js","sourceRoot":"","sources":["../../src/views/refreshRuntimeViews.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,SAAS,cAAc,CACnB,SAA4C,EAC5C,QAAgB;IAEhB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB,EAAE,SAAoB;IACxE,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACpD,cAAc,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;QAC7C,SAAS;QACT,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;QACnC,SAAS,EAAE,SAAS,KAAK,SAAS;KACrC,CAAC,CAAC;IACH,cAAc,CAAC,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAC9C,QAAQ,EACR,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAClE,CAAC;AACN,CAAC"}

package/dist/views/symInfoView.d.ts

@@ -0,0 +1,42 @@
+import type { JsonValue, SymInfoView, SymbolType } from "@invinite-org/chartlang-core";
+/**
+ * Adapter-supplied per-mount symbol metadata payload.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const info: AdapterSymInfo = {
+ *         ticker: "DEMO",
+ *         type: "equity",
+ *         mintick: 0.01,
+ *     };
+ *     void info;
+ */
+export type AdapterSymInfo = Readonly<{
+    ticker?: string;
+    type?: SymbolType;
+    mintick?: number;
+    currency?: string;
+    basecurrency?: string;
+    exchange?: string;
+    timezone?: string;
+    session?: string;
+    meta?: Readonly<Record<string, JsonValue>>;
+}>;
+/**
+ * Build a frozen `syminfo.*` view from adapter metadata and enabled fields.
+ *
+ * Fields not present in `enabled` evaluate to their empty sentinel:
+ * `""`, `Number.NaN`, `"custom"`, or `{}`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view = makeSymInfoView(
+ *         { ticker: "DEMO", mintick: 0.01 },
+ *         new Set(["ticker", "mintick"]),
+ *     );
+ *     void view.ticker;
+ */
+export declare function makeSymInfoView(payload: AdapterSymInfo, enabled: ReadonlySet<string>): SymInfoView;
+//# sourceMappingURL=symInfoView.d.ts.map

package/dist/views/symInfoView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symInfoView.d.ts","sourceRoot":"","sources":["../../src/views/symInfoView.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEvF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9C,CAAC,CAAC;AAIH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,WAAW,CAYb"}

package/dist/views/symInfoView.js

@@ -0,0 +1,32 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+const EMPTY_META = Object.freeze({});
+/**
+ * Build a frozen `syminfo.*` view from adapter metadata and enabled fields.
+ *
+ * Fields not present in `enabled` evaluate to their empty sentinel:
+ * `""`, `Number.NaN`, `"custom"`, or `{}`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view = makeSymInfoView(
+ *         { ticker: "DEMO", mintick: 0.01 },
+ *         new Set(["ticker", "mintick"]),
+ *     );
+ *     void view.ticker;
+ */
+export function makeSymInfoView(payload, enabled) {
+    return Object.freeze({
+        ticker: enabled.has("ticker") ? (payload.ticker ?? "") : "",
+        type: enabled.has("type") ? (payload.type ?? "custom") : "custom",
+        mintick: enabled.has("mintick") ? (payload.mintick ?? Number.NaN) : Number.NaN,
+        currency: enabled.has("currency") ? (payload.currency ?? "") : "",
+        basecurrency: enabled.has("basecurrency") ? (payload.basecurrency ?? "") : "",
+        exchange: enabled.has("exchange") ? (payload.exchange ?? "") : "",
+        timezone: enabled.has("timezone") ? (payload.timezone ?? "") : "",
+        session: enabled.has("session") ? (payload.session ?? "") : "",
+        meta: enabled.has("meta") ? Object.freeze({ ...(payload.meta ?? {}) }) : EMPTY_META,
+    });
+}
+//# sourceMappingURL=symInfoView.js.map

package/dist/views/symInfoView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symInfoView.js","sourceRoot":"","sources":["../../src/views/symInfoView.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA6B/D,MAAM,UAAU,GAAwC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC3B,OAAuB,EACvB,OAA4B;IAE5B,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QAC3D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;QACjE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG;QAC9E,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACjE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QAC7E,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACjE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACjE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU;KACtF,CAAC,CAAC;AACP,CAAC"}

package/dist/views/timeframeView.d.ts

@@ -0,0 +1,17 @@
+import type { IntervalDescriptor, TimeframeView } from "@invinite-org/chartlang-core";
+/**
+ * Build a frozen `timeframe.*` view from the current bar interval and
+ * adapter interval descriptor.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view = makeTimeframeView("5m", {
+ *         value: "5m",
+ *         label: "5 minutes",
+ *         group: "minute",
+ *     });
+ *     void view.inSeconds;
+ */
+export declare function makeTimeframeView(interval: string, descriptor: IntervalDescriptor | undefined): TimeframeView;
+//# sourceMappingURL=timeframeView.d.ts.map

package/dist/views/timeframeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeframeView.d.ts","sourceRoot":"","sources":["../../src/views/timeframeView.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAqBtF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAAG,SAAS,GAC3C,aAAa,CAef"}