@invinite-org/chartlang-runtime 1.1.1 → 1.3.0

package/dist/persistentStateStore.runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistentStateStore.runtime.js","sourceRoot":"","sources":["../src/persistentStateStore.runtime.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    JsonValue,\n    RunnerSnapshot,\n    StateSnapshot,\n    StreamSnapshot,\n} from \"@invinite-org/chartlang-core\";\n\nimport type { RunnerState } from \"./createScriptRunner.js\";\nimport { pushDiagnostic } from \"./emit/index.js\";\nimport { validateSnapshot } from \"./persistentStateStore.validate.js\";\nimport type { RuntimeContext } from \"./runtimeContext.js\";\nimport { restoreStateSlots, serialiseStateSlots } from \"./state/index.js\";\nimport { isTaSlotSnapshotKey, restoreTaSlots, serialiseTaSlots } from \"./ta/persistence.js\";\n\n/**\n * Default PLAN §6.9 write cadence for persistent snapshots.\n *\n * @since 0.5\n * @internal\n * @example\n *     const stale = Date.now() - PERSISTENCE_INTERVAL_MS;\n *     void stale;\n */\nexport const PERSISTENCE_INTERVAL_MS = 60_000;\n\nfunction firstStreamKey(snapshot: StateSnapshot): string | null {\n    const entries = Object.entries(snapshot.streams);\n    const first = entries[0];\n    return first === undefined ? null : first[0];\n}\n\nfunction captureStreams(state: RunnerState): Readonly<Record<string, StreamSnapshot>> {\n    const main = state.mainStream.serialiseSnapshot();\n    const streams: Record<string, StreamSnapshot> = {\n        [main.interval === \"\" ? \"main\" : main.interval]: main,\n    };\n    for (const [key, stream] of state.runtimeContext.secondaryStreams) {\n        streams[key] = stream.serialiseSnapshot();\n    }\n    return Object.freeze(streams);\n}\n\nfunction primarySectionSlots(state: RunnerState): Readonly<Record<string, JsonValue>> {\n    return Object.freeze({\n        ...serialiseStateSlots(state.runtimeContext),\n        ...serialiseTaSlots(state.mainStream),\n    } as Record<string, JsonValue>);\n}\n\nfunction runnerSection(ctx: RuntimeContext): RunnerSnapshot {\n    return Object.freeze({\n        slots: Object.freeze({ ...serialiseStateSlots(ctx) } as Record<string, JsonValue>),\n    });\n}\n\nfunction captureSiblings(state: RunnerState): Readonly<Record<string, RunnerSnapshot>> | undefined {\n    if (state.siblingRunners.length === 0) return undefined;\n    const out: Record<string, RunnerSnapshot> = {};\n    for (const sibling of state.siblingRunners) {\n        out[sibling.exportName] = runnerSection(sibling.state.runtimeContext);\n    }\n    return Object.freeze(out);\n}\n\nfunction captureDependencies(\n    state: RunnerState,\n): Readonly<Record<string, RunnerSnapshot>> | undefined {\n    if (state.depRunners.length === 0) return undefined;\n    const out: Record<string, RunnerSnapshot> = {};\n    for (const dep of state.depRunners) {\n        out[dep.localId] = runnerSection(dep.state.runtimeContext);\n    }\n    return Object.freeze(out);\n}\n\n/**\n * Capture the runner's current stream + per-runner state-slot snapshot.\n *\n * Returns the structured shape carrying `primary.slots`, optional\n * `siblings[exportName].slots`, and optional `dependencies[localId].slots`.\n * TA slots live in `primary.slots` because the bundle's deps and siblings\n * share the primary's `mainStream` (Task-4 invariant).\n *\n * @since 0.5 — widened to per-runner sections in 0.7.\n * @internal\n * @example\n *     // const snapshot = captureStateSnapshot(state, Date.now());\n *     const captured = true;\n *     void captured;\n */\nexport function captureStateSnapshot(state: RunnerState, savedAt: number): StateSnapshot | null {\n    const streams = captureStreams(state);\n    const siblings = captureSiblings(state);\n    const dependencies = captureDependencies(state);\n    const candidate: StateSnapshot = {\n        lastBarTime: state.mainStream.bar.time,\n        streams,\n        savedAt,\n        snapshotVersion: 1,\n        primary: { slots: primarySectionSlots(state) },\n        ...(siblings === undefined ? {} : { siblings }),\n        ...(dependencies === undefined ? {} : { dependencies }),\n    };\n    if (!validateSnapshot(candidate)) return null;\n    return candidate;\n}\n\n// Phase-1 mounts have `bar.interval === \"\"` until the first bar lands; in that\n// window the snapshot is keyed by whatever captureStreams used (\"main\" or the\n// explicit interval). Fall back to the snapshot's first-entered stream so warm\n// restart still finds the buffer.\nfunction resolveMainStreamSnapshot(\n    snapshot: StateSnapshot,\n    mainInterval: string,\n): StreamSnapshot | undefined {\n    const direct = mainInterval === \"\" ? undefined : snapshot.streams[mainInterval];\n    if (direct !== undefined) return direct;\n    const fallback = firstStreamKey(snapshot);\n    return fallback === null ? undefined : snapshot.streams[fallback];\n}\n\nfunction nonTaSlots(slots: Readonly<Record<string, JsonValue>>): Record<string, unknown> {\n    const out: Record<string, unknown> = {};\n    for (const [slotKey, value] of Object.entries(slots)) {\n        if (!isTaSlotSnapshotKey(slotKey)) {\n            out[slotKey] = value;\n        }\n    }\n    return out;\n}\n\nfunction pushMalformedSection(state: RunnerState, message: string): void {\n    pushDiagnostic(state.emissions, {\n        kind: \"diagnostic\",\n        severity: \"warning\",\n        code: \"state-snapshot-malformed\",\n        message,\n        slotId: null,\n        bar: state.barIndex,\n    });\n}\n\nfunction restoreSiblingSections(\n    state: RunnerState,\n    siblings: Readonly<Record<string, RunnerSnapshot>>,\n): void {\n    const lookup = new Map(state.siblingRunners.map((sib) => [sib.exportName, sib]));\n    for (const [exportName, section] of Object.entries(siblings)) {\n        const sibling = lookup.get(exportName);\n        if (sibling === undefined) {\n            pushMalformedSection(\n                state,\n                `persistent state snapshot referenced unknown sibling \"${exportName}\"`,\n            );\n            continue;\n        }\n        restoreStateSlots(sibling.state.runtimeContext, section.slots);\n    }\n}\n\nfunction restoreDependencySections(\n    state: RunnerState,\n    dependencies: Readonly<Record<string, RunnerSnapshot>>,\n): void {\n    const lookup = new Map(state.depRunners.map((dep) => [dep.localId, dep]));\n    for (const [localId, section] of Object.entries(dependencies)) {\n        const dep = lookup.get(localId);\n        if (dep === undefined) {\n            pushMalformedSection(\n                state,\n                `persistent state snapshot referenced unknown dependency \"${localId}\"`,\n            );\n            continue;\n        }\n        restoreStateSlots(dep.state.runtimeContext, section.slots);\n    }\n}\n\n/**\n * Restore a validated snapshot into the runner's stream + slot stores.\n *\n * Walks every per-runner section: `primary.slots` rehydrates the\n * primary's `state.*` slots (and TA slots on the shared mainStream);\n * `siblings[exportName].slots` and `dependencies[localId].slots`\n * rehydrate each matching sub-runner. Snapshot sections whose id is not\n * declared by the current bundle are skipped with a\n * `state-snapshot-malformed` diagnostic.\n *\n * Legacy flat-shape snapshots (pre-0.7) restore into the primary only.\n *\n * @since 0.5 — widened to per-runner sections in 0.7.\n * @internal\n * @example\n *     // restoreStateSnapshot(state, snapshot);\n *     const restored = true;\n *     void restored;\n */\nexport function restoreStateSnapshot(state: RunnerState, snapshot: StateSnapshot): void {\n    const stream = resolveMainStreamSnapshot(snapshot, state.mainStream.bar.interval);\n    if (stream !== undefined) {\n        state.mainStream.restoreFromSnapshot(stream);\n        state.barIndex = Math.max(state.barIndex, stream.filled);\n    }\n    for (const [secondaryKey, secondary] of state.runtimeContext.secondaryStreams) {\n        const secondarySnapshot = snapshot.streams[secondaryKey];\n        if (secondarySnapshot !== undefined) {\n            secondary.restoreFromSnapshot(secondarySnapshot);\n        }\n    }\n\n    const primarySlots = primarySlotsOf(snapshot);\n    restoreTaSlots(state.mainStream, primarySlots);\n    restoreStateSlots(state.runtimeContext, nonTaSlots(primarySlots));\n\n    if (snapshot.siblings !== undefined) {\n        restoreSiblingSections(state, snapshot.siblings);\n    }\n    if (snapshot.dependencies !== undefined) {\n        restoreDependencySections(state, snapshot.dependencies);\n    }\n}\n\n/**\n * Resolve the primary runner's slot map from either the structured shape\n * (`snapshot.primary.slots`) or the legacy flat shape (`snapshot.slots`).\n * The validator accepts both but the strict `StateSnapshot` type only\n * mirrors the structured shape; the dual shape is read through this\n * legacy-aware view. {@link validateSnapshot} guarantees at least one of\n * the two shapes is present so we never fall through.\n *\n * @internal\n */\ntype LegacySnapshotView = Readonly<{\n    readonly primary?: RunnerSnapshot;\n    readonly slots?: Readonly<Record<string, JsonValue>>;\n}>;\n\nconst EMPTY_SLOTS: Readonly<Record<string, JsonValue>> = Object.freeze({});\n\nfunction primarySlotsOf(snapshot: StateSnapshot): Readonly<Record<string, JsonValue>> {\n    const view = snapshot as LegacySnapshotView;\n    if (view.primary !== undefined) return view.primary.slots;\n    /* c8 ignore next 2 — validateSnapshot guarantees one of primary/slots is present. */\n    if (view.slots === undefined) return EMPTY_SLOTS;\n    return view.slots;\n}\n\n/**\n * Save one snapshot and convert malformed/save failures into diagnostics.\n *\n * @since 0.5\n * @internal\n * @example\n *     // await saveStateSnapshot(state, Date.now());\n *     const saved = true;\n *     void saved;\n */\nexport async function saveStateSnapshot(state: RunnerState, savedAt: number): Promise<boolean> {\n    const store = state.runtimeContext.persistentStateStore;\n    if (store === undefined) return false;\n    const snapshot = captureStateSnapshot(state, savedAt);\n    if (snapshot === null) {\n        pushDiagnostic(state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"warning\",\n            code: \"state-snapshot-malformed\",\n            message: \"persistent state snapshot was not JSON-clean\",\n            slotId: null,\n            bar: state.barIndex,\n        });\n        return false;\n    }\n    try {\n        await store.save(snapshot);\n        state.runtimeContext.lastPersistTime = savedAt;\n        return true;\n    } catch (err) {\n        pushDiagnostic(state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"warning\",\n            code: \"state-snapshot-save-failed\",\n            message: err instanceof Error ? err.message : String(err),\n            slotId: null,\n            bar: state.barIndex,\n        });\n        return false;\n    }\n}\n\n/**\n * Save when the configured PLAN §6.9 wall-clock cadence is stale.\n *\n * @since 0.5\n * @internal\n * @example\n *     // await maybeSaveStateSnapshot(state, Date.now(), 60_000);\n *     const maybe = true;\n *     void maybe;\n */\nexport async function maybeSaveStateSnapshot(\n    state: RunnerState,\n    savedAt: number,\n    intervalMs: number,\n): Promise<void> {\n    if (state.runtimeContext.persistentStateStore === undefined) return;\n    if (savedAt - state.runtimeContext.lastPersistTime >= intervalMs) {\n        await saveStateSnapshot(state, savedAt);\n    }\n}\n"]}
+{"version":3,"file":"persistentStateStore.runtime.js","sourceRoot":"","sources":["../src/persistentStateStore.runtime.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    JsonValue,\n    RunnerSnapshot,\n    StateSnapshot,\n    StreamSnapshot,\n} from \"@invinite-org/chartlang-core\";\n\nimport type { RunnerState } from \"./createScriptRunner.js\";\nimport { pushDiagnostic } from \"./emit/index.js\";\nimport { validateSnapshot } from \"./persistentStateStore.validate.js\";\nimport type { RuntimeContext } from \"./runtimeContext.js\";\nimport {\n    isArraySlotSnapshotKey,\n    isSeriesSlotSnapshotKey,\n    restoreArraySlots,\n    restoreSeriesSlots,\n    restoreStateSlots,\n    serialiseArraySlots,\n    serialiseSeriesSlots,\n    serialiseStateSlots,\n} from \"./state/index.js\";\nimport { isTaSlotSnapshotKey, restoreTaSlots, serialiseTaSlots } from \"./ta/persistence.js\";\n\n/**\n * Default PLAN §6.9 write cadence for persistent snapshots.\n *\n * @since 0.5\n * @internal\n * @example\n *     const stale = Date.now() - PERSISTENCE_INTERVAL_MS;\n *     void stale;\n */\nexport const PERSISTENCE_INTERVAL_MS = 60_000;\n\nfunction firstStreamKey(snapshot: StateSnapshot): string | null {\n    const entries = Object.entries(snapshot.streams);\n    const first = entries[0];\n    return first === undefined ? null : first[0];\n}\n\nfunction captureStreams(state: RunnerState): Readonly<Record<string, StreamSnapshot>> {\n    const main = state.mainStream.serialiseSnapshot();\n    const streams: Record<string, StreamSnapshot> = {\n        [main.interval === \"\" ? \"main\" : main.interval]: main,\n    };\n    for (const [key, stream] of state.runtimeContext.secondaryStreams) {\n        streams[key] = stream.serialiseSnapshot();\n    }\n    return Object.freeze(streams);\n}\n\nfunction primarySectionSlots(state: RunnerState): Readonly<Record<string, JsonValue>> {\n    return Object.freeze({\n        ...serialiseStateSlots(state.runtimeContext),\n        ...serialiseSeriesSlots(state.runtimeContext),\n        ...serialiseArraySlots(state.runtimeContext),\n        ...serialiseTaSlots(state.mainStream),\n    } as Record<string, JsonValue>);\n}\n\nfunction runnerSection(ctx: RuntimeContext): RunnerSnapshot {\n    return Object.freeze({\n        slots: Object.freeze({\n            ...serialiseStateSlots(ctx),\n            ...serialiseSeriesSlots(ctx),\n            ...serialiseArraySlots(ctx),\n        } as Record<string, JsonValue>),\n    });\n}\n\nfunction captureSiblings(state: RunnerState): Readonly<Record<string, RunnerSnapshot>> | undefined {\n    if (state.siblingRunners.length === 0) return undefined;\n    const out: Record<string, RunnerSnapshot> = {};\n    for (const sibling of state.siblingRunners) {\n        out[sibling.exportName] = runnerSection(sibling.state.runtimeContext);\n    }\n    return Object.freeze(out);\n}\n\nfunction captureDependencies(\n    state: RunnerState,\n): Readonly<Record<string, RunnerSnapshot>> | undefined {\n    if (state.depRunners.length === 0) return undefined;\n    const out: Record<string, RunnerSnapshot> = {};\n    for (const dep of state.depRunners) {\n        out[dep.localId] = runnerSection(dep.state.runtimeContext);\n    }\n    return Object.freeze(out);\n}\n\n/**\n * Capture the runner's current stream + per-runner state-slot snapshot.\n *\n * Returns the structured shape carrying `primary.slots`, optional\n * `siblings[exportName].slots`, and optional `dependencies[localId].slots`.\n * TA slots live in `primary.slots` because the bundle's deps and siblings\n * share the primary's `mainStream` (Task-4 invariant).\n *\n * @since 0.5 — widened to per-runner sections in 0.7.\n * @internal\n * @example\n *     // const snapshot = captureStateSnapshot(state, Date.now());\n *     const captured = true;\n *     void captured;\n */\nexport function captureStateSnapshot(state: RunnerState, savedAt: number): StateSnapshot | null {\n    const streams = captureStreams(state);\n    const siblings = captureSiblings(state);\n    const dependencies = captureDependencies(state);\n    const candidate: StateSnapshot = {\n        lastBarTime: state.mainStream.bar.time,\n        streams,\n        savedAt,\n        snapshotVersion: 1,\n        primary: { slots: primarySectionSlots(state) },\n        ...(siblings === undefined ? {} : { siblings }),\n        ...(dependencies === undefined ? {} : { dependencies }),\n    };\n    if (!validateSnapshot(candidate)) return null;\n    return candidate;\n}\n\n// Phase-1 mounts have `bar.interval === \"\"` until the first bar lands; in that\n// window the snapshot is keyed by whatever captureStreams used (\"main\" or the\n// explicit interval). Fall back to the snapshot's first-entered stream so warm\n// restart still finds the buffer.\nfunction resolveMainStreamSnapshot(\n    snapshot: StateSnapshot,\n    mainInterval: string,\n): StreamSnapshot | undefined {\n    const direct = mainInterval === \"\" ? undefined : snapshot.streams[mainInterval];\n    if (direct !== undefined) return direct;\n    const fallback = firstStreamKey(snapshot);\n    return fallback === null ? undefined : snapshot.streams[fallback];\n}\n\n// Scalar `state.*` keys only — strip `ta:` (restored onto the stream),\n// `:series` (restored into `ctx.seriesSlots`), and `:array` (restored into\n// `ctx.arraySlots`) so the scalar slot store receives none of them.\nfunction scalarStateSlots(slots: Readonly<Record<string, unknown>>): Record<string, unknown> {\n    const out: Record<string, unknown> = {};\n    for (const [slotKey, value] of Object.entries(slots)) {\n        if (\n            !isTaSlotSnapshotKey(slotKey) &&\n            !isSeriesSlotSnapshotKey(slotKey) &&\n            !isArraySlotSnapshotKey(slotKey)\n        ) {\n            out[slotKey] = value;\n        }\n    }\n    return out;\n}\n\n// Restore a runner's scalar `state.*` slots and `state.series` slots from\n// one merged `slots` record. Series rings are sized to the runner's current\n// ring capacity (the close buffer's capacity).\nfunction restoreRunnerSlots(\n    ctx: RuntimeContext,\n    slots: Readonly<Record<string, unknown>>,\n    capacity: number,\n): void {\n    restoreStateSlots(ctx, scalarStateSlots(slots));\n    restoreSeriesSlots(ctx, slots, capacity);\n    restoreArraySlots(ctx, slots);\n}\n\nfunction pushMalformedSection(state: RunnerState, message: string): void {\n    pushDiagnostic(state.emissions, {\n        kind: \"diagnostic\",\n        severity: \"warning\",\n        code: \"state-snapshot-malformed\",\n        message,\n        slotId: null,\n        bar: state.barIndex,\n    });\n}\n\nfunction restoreSiblingSections(\n    state: RunnerState,\n    siblings: Readonly<Record<string, RunnerSnapshot>>,\n): void {\n    const lookup = new Map(state.siblingRunners.map((sib) => [sib.exportName, sib]));\n    for (const [exportName, section] of Object.entries(siblings)) {\n        const sibling = lookup.get(exportName);\n        if (sibling === undefined) {\n            pushMalformedSection(\n                state,\n                `persistent state snapshot referenced unknown sibling \"${exportName}\"`,\n            );\n            continue;\n        }\n        restoreRunnerSlots(\n            sibling.state.runtimeContext,\n            section.slots,\n            state.mainStream.ohlcv.close.capacity,\n        );\n    }\n}\n\nfunction restoreDependencySections(\n    state: RunnerState,\n    dependencies: Readonly<Record<string, RunnerSnapshot>>,\n): void {\n    const lookup = new Map(state.depRunners.map((dep) => [dep.localId, dep]));\n    for (const [localId, section] of Object.entries(dependencies)) {\n        const dep = lookup.get(localId);\n        if (dep === undefined) {\n            pushMalformedSection(\n                state,\n                `persistent state snapshot referenced unknown dependency \"${localId}\"`,\n            );\n            continue;\n        }\n        restoreRunnerSlots(\n            dep.state.runtimeContext,\n            section.slots,\n            state.mainStream.ohlcv.close.capacity,\n        );\n    }\n}\n\n/**\n * Restore a validated snapshot into the runner's stream + slot stores.\n *\n * Walks every per-runner section: `primary.slots` rehydrates the\n * primary's `state.*` slots (and TA slots on the shared mainStream);\n * `siblings[exportName].slots` and `dependencies[localId].slots`\n * rehydrate each matching sub-runner. Snapshot sections whose id is not\n * declared by the current bundle are skipped with a\n * `state-snapshot-malformed` diagnostic.\n *\n * Legacy flat-shape snapshots (pre-0.7) restore into the primary only.\n *\n * @since 0.5 — widened to per-runner sections in 0.7.\n * @internal\n * @example\n *     // restoreStateSnapshot(state, snapshot);\n *     const restored = true;\n *     void restored;\n */\nexport function restoreStateSnapshot(state: RunnerState, snapshot: StateSnapshot): void {\n    const stream = resolveMainStreamSnapshot(snapshot, state.mainStream.bar.interval);\n    if (stream !== undefined) {\n        state.mainStream.restoreFromSnapshot(stream);\n        state.barIndex = Math.max(state.barIndex, stream.filled);\n    }\n    for (const [secondaryKey, secondary] of state.runtimeContext.secondaryStreams) {\n        const secondarySnapshot = snapshot.streams[secondaryKey];\n        if (secondarySnapshot !== undefined) {\n            secondary.restoreFromSnapshot(secondarySnapshot);\n        }\n    }\n\n    const primarySlots = primarySlotsOf(snapshot);\n    restoreTaSlots(state.mainStream, primarySlots);\n    restoreRunnerSlots(state.runtimeContext, primarySlots, state.mainStream.ohlcv.close.capacity);\n\n    if (snapshot.siblings !== undefined) {\n        restoreSiblingSections(state, snapshot.siblings);\n    }\n    if (snapshot.dependencies !== undefined) {\n        restoreDependencySections(state, snapshot.dependencies);\n    }\n}\n\n/**\n * Resolve the primary runner's slot map from either the structured shape\n * (`snapshot.primary.slots`) or the legacy flat shape (`snapshot.slots`).\n * The validator accepts both but the strict `StateSnapshot` type only\n * mirrors the structured shape; the dual shape is read through this\n * legacy-aware view. {@link validateSnapshot} guarantees at least one of\n * the two shapes is present so we never fall through.\n *\n * @internal\n */\ntype LegacySnapshotView = Readonly<{\n    readonly primary?: RunnerSnapshot;\n    readonly slots?: Readonly<Record<string, JsonValue>>;\n}>;\n\nconst EMPTY_SLOTS: Readonly<Record<string, JsonValue>> = Object.freeze({});\n\nfunction primarySlotsOf(snapshot: StateSnapshot): Readonly<Record<string, JsonValue>> {\n    const view = snapshot as LegacySnapshotView;\n    if (view.primary !== undefined) return view.primary.slots;\n    /* c8 ignore next 2 — validateSnapshot guarantees one of primary/slots is present. */\n    if (view.slots === undefined) return EMPTY_SLOTS;\n    return view.slots;\n}\n\n/**\n * Save one snapshot and convert malformed/save failures into diagnostics.\n *\n * @since 0.5\n * @internal\n * @example\n *     // await saveStateSnapshot(state, Date.now());\n *     const saved = true;\n *     void saved;\n */\nexport async function saveStateSnapshot(state: RunnerState, savedAt: number): Promise<boolean> {\n    const store = state.runtimeContext.persistentStateStore;\n    if (store === undefined) return false;\n    const snapshot = captureStateSnapshot(state, savedAt);\n    if (snapshot === null) {\n        pushDiagnostic(state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"warning\",\n            code: \"state-snapshot-malformed\",\n            message: \"persistent state snapshot was not JSON-clean\",\n            slotId: null,\n            bar: state.barIndex,\n        });\n        return false;\n    }\n    try {\n        await store.save(snapshot);\n        state.runtimeContext.lastPersistTime = savedAt;\n        return true;\n    } catch (err) {\n        pushDiagnostic(state.emissions, {\n            kind: \"diagnostic\",\n            severity: \"warning\",\n            code: \"state-snapshot-save-failed\",\n            message: err instanceof Error ? err.message : String(err),\n            slotId: null,\n            bar: state.barIndex,\n        });\n        return false;\n    }\n}\n\n/**\n * Save when the configured PLAN §6.9 wall-clock cadence is stale.\n *\n * @since 0.5\n * @internal\n * @example\n *     // await maybeSaveStateSnapshot(state, Date.now(), 60_000);\n *     const maybe = true;\n *     void maybe;\n */\nexport async function maybeSaveStateSnapshot(\n    state: RunnerState,\n    savedAt: number,\n    intervalMs: number,\n): Promise<void> {\n    if (state.runtimeContext.persistentStateStore === undefined) return;\n    if (savedAt - state.runtimeContext.lastPersistTime >= intervalMs) {\n        await saveStateSnapshot(state, savedAt);\n    }\n}\n"]}

package/dist/primitives.d.ts

@@ -19,5 +19,5 @@ import type { TaNamespace } from "@invinite-org/chartlang-core";
  *     // type S = typeof ta;
  */
 export declare const ta: TaNamespace;
-export { alert, draw, hline, plot } from "./emit/index.js";
+export { alert, barcolor, bgcolor, draw, hline, plot } from "./emit/index.js";
 //# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,EAAE,EAAE,WAAmD,CAAC;AAErE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,EAAE,EAAE,WAAmD,CAAC;AAErE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/primitives.js

@@ -21,5 +21,11 @@ import { TA_REGISTRY } from "./ta/index.js";
  *     // type S = typeof ta;
  */
 export const ta = TA_REGISTRY;
-export { alert, draw, hline, plot } from "./emit/index.js";
+export { alert, barcolor, bgcolor, draw, hline, plot } from "./emit/index.js";
+// `time` and `session` are the real UTC/fixed-offset calendar namespaces, built
+// per-mount by `buildComputeContext.ts` via `buildTimeNamespace(ctx)` /
+// `buildSessionNamespace(ctx)` — neither can be a module-level constant like
+// `ta` because both close over the mount's `ctx` (default tz from
+// `syminfo.timezone` + the shared `tz-dst-unsupported` dedup). The core
+// `session` sentinel hole is no longer re-exported here.
 //# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,EAAE,GAAgB,WAAqC,CAAC;AAErE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { TaNamespace } from \"@invinite-org/chartlang-core\";\n\nimport { TA_REGISTRY } from \"./ta/index.js\";\n\n/**\n * The runtime's `ta` namespace as the compiled script sees it. Task 6's\n * `createScriptRunner` puts this on the `ComputeContext` it hands the\n * compiled script; Task 7 swapped the body from a throw-stub to the\n * real {@link TA_REGISTRY} (`./ta/registry`). Identity is preserved\n * across the swap — `buildComputeContext.ts` still imports `ta` from\n * here and the runner contract from Task 6 stays untouched.\n *\n * The runtime impls take a compiler-injected `slotId` as their first\n * argument; the compiler erases the extra arg at the type boundary so\n * `ComputeContext.ta: TaNamespace` (script-facing) and the bundled call\n * `ta.ema(\"slot-id\", src, length)` are structurally compatible at\n * runtime.\n *\n * @since 0.1\n * @example\n *     // import { ta } from \"@invinite-org/chartlang-runtime\";\n *     // type S = typeof ta;\n */\nexport const ta: TaNamespace = TA_REGISTRY as unknown as TaNamespace;\n\nexport { alert, draw, hline, plot } from \"./emit/index.js\";\n"]}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,EAAE,GAAgB,WAAqC,CAAC;AAErE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC9E,gFAAgF;AAChF,wEAAwE;AACxE,6EAA6E;AAC7E,kEAAkE;AAClE,wEAAwE;AACxE,yDAAyD","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { TaNamespace } from \"@invinite-org/chartlang-core\";\n\nimport { TA_REGISTRY } from \"./ta/index.js\";\n\n/**\n * The runtime's `ta` namespace as the compiled script sees it. Task 6's\n * `createScriptRunner` puts this on the `ComputeContext` it hands the\n * compiled script; Task 7 swapped the body from a throw-stub to the\n * real {@link TA_REGISTRY} (`./ta/registry`). Identity is preserved\n * across the swap — `buildComputeContext.ts` still imports `ta` from\n * here and the runner contract from Task 6 stays untouched.\n *\n * The runtime impls take a compiler-injected `slotId` as their first\n * argument; the compiler erases the extra arg at the type boundary so\n * `ComputeContext.ta: TaNamespace` (script-facing) and the bundled call\n * `ta.ema(\"slot-id\", src, length)` are structurally compatible at\n * runtime.\n *\n * @since 0.1\n * @example\n *     // import { ta } from \"@invinite-org/chartlang-runtime\";\n *     // type S = typeof ta;\n */\nexport const ta: TaNamespace = TA_REGISTRY as unknown as TaNamespace;\n\nexport { alert, barcolor, bgcolor, draw, hline, plot } from \"./emit/index.js\";\n// `time` and `session` are the real UTC/fixed-offset calendar namespaces, built\n// per-mount by `buildComputeContext.ts` via `buildTimeNamespace(ctx)` /\n// `buildSessionNamespace(ctx)` — neither can be a module-level constant like\n// `ta` because both close over the mount's `ctx` (default tz from\n// `syminfo.timezone` + the shared `tz-dst-unsupported` dedup). The core\n// `session` sentinel hole is no longer re-exported here.\n"]}

package/dist/request/index.d.ts

@@ -1,4 +1,5 @@
 export { buildRequestNamespace } from "./requestNamespace.js";
 export { makeLowerTfSeries } from "./lowerTf.js";
-export { makeNanSecurityBar, makeSecurityBar } from "./security.js";
+export { makeNanSecurityBar, makeSecurityBar, makeSecurityExprSeries } from "./security.js";
+export { type SecurityExprRegistry, type SecurityExprRunner, ascendingValues, buildSecurityExprRunners, captureAndCatchUp, createSecurityExprRunner, driveSecurityExpressions, } from "./securityExprRunner.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GAC3B,MAAM,yBAAyB,CAAC"}

package/dist/request/index.js

@@ -2,5 +2,6 @@
 // See the LICENSE file in the repo root for full license text.
 export { buildRequestNamespace } from "./requestNamespace.js";
 export { makeLowerTfSeries } from "./lowerTf.js";
-export { makeNanSecurityBar, makeSecurityBar } from "./security.js";
+export { makeNanSecurityBar, makeSecurityBar, makeSecurityExprSeries } from "./security.js";
+export { ascendingValues, buildSecurityExprRunners, captureAndCatchUp, createSecurityExprRunner, driveSecurityExpressions, } from "./securityExprRunner.js";
 //# sourceMappingURL=index.js.map

package/dist/request/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nexport { buildRequestNamespace } from \"./requestNamespace.js\";\nexport { makeLowerTfSeries } from \"./lowerTf.js\";\nexport { makeNanSecurityBar, makeSecurityBar } from \"./security.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,EAGH,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GAC3B,MAAM,yBAAyB,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nexport { buildRequestNamespace } from \"./requestNamespace.js\";\nexport { makeLowerTfSeries } from \"./lowerTf.js\";\nexport { makeNanSecurityBar, makeSecurityBar, makeSecurityExprSeries } from \"./security.js\";\nexport {\n    type SecurityExprRegistry,\n    type SecurityExprRunner,\n    ascendingValues,\n    buildSecurityExprRunners,\n    captureAndCatchUp,\n    createSecurityExprRunner,\n    driveSecurityExpressions,\n} from \"./securityExprRunner.js\";\n"]}

package/dist/request/lowerTf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lowerTf.d.ts","sourceRoot":"","sources":["../../src/request/lowerTf.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA+D3D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACjB,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAwB5B"}
+{"version":3,"file":"lowerTf.d.ts","sourceRoot":"","sources":["../../src/request/lowerTf.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqE3D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACjB,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAwB5B"}

package/dist/request/lowerTf.js

@@ -16,6 +16,12 @@ function bucketAt(ctx, slotId, interval, age) {
     if (!known) {
         return fallback(ctx, slotId, interval, "unsupported-interval", `Requested interval "${interval}" is not in Capabilities.intervals`);
     }
+    // `request.lowerTf` is chart-symbol-only (per-feed symbol is a deferred
+    // follow-up), so the bare interval IS the feed key — `feedKey(undefined,
+    // interval) === interval`. Keying the (feed-keyed) `secondaryStreams` map
+    // and the cache below by the bare interval is therefore byte-identical to
+    // routing through `feedKey`; if `lowerTf` ever gains a symbol, switch both
+    // sites to `feedKey(symbol, interval)` so they cannot silently mis-key.
     const secondary = ctx.secondaryStreams.get(interval);
     if (secondary === undefined) {
         return fallback(ctx, slotId, interval, "unknown-secondary-stream", `Requested interval "${interval}" has no registered secondary stream`);

package/dist/request/lowerTf.js.map

@@ -1 +1 @@
-{"version":3,"file":"lowerTf.js","sourceRoot":"","sources":["../../src/request/lowerTf.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Bar, Series } from \"@invinite-org/chartlang-core\";\n\nimport type { RuntimeContext } from \"../runtimeContext.js\";\nimport { getOrBucket } from \"./bucketLtfBarsCache.js\";\nimport { pushOnce } from \"./pushOnce.js\";\nimport { ascendingBarsFor } from \"./streamBars.js\";\n\nconst EMPTY_BUCKET: ReadonlyArray<Bar> = Object.freeze([]);\n\nfunction fallback(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n    code: \"unsupported-interval\" | \"multi-timeframe-not-supported\" | \"unknown-secondary-stream\",\n    message: string,\n): ReadonlyArray<Bar> {\n    pushOnce(ctx, code, slotId, interval, \"lowerTf\", message);\n    return EMPTY_BUCKET;\n}\n\nfunction bucketAt(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n    age: number,\n): ReadonlyArray<Bar> {\n    if (!ctx.capabilities.multiTimeframe) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"multi-timeframe-not-supported\",\n            \"Adapter declares multiTimeframe: false; request.lowerTf returns empty buckets\",\n        );\n    }\n\n    const known = ctx.capabilities.intervals.some((descriptor) => descriptor.value === interval);\n    if (!known) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"unsupported-interval\",\n            `Requested interval \"${interval}\" is not in Capabilities.intervals`,\n        );\n    }\n\n    const secondary = ctx.secondaryStreams.get(interval);\n    if (secondary === undefined) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"unknown-secondary-stream\",\n            `Requested interval \"${interval}\" has no registered secondary stream`,\n        );\n    }\n\n    const mainBars = ascendingBarsFor(ctx, ctx.stream);\n    const ltfBars = ascendingBarsFor(ctx, secondary);\n    const buckets = getOrBucket(mainBars, ltfBars);\n    const index = buckets.length - 1 - age;\n    return buckets[index] ?? EMPTY_BUCKET;\n}\n\n/**\n * Return a stable series view of lower-timeframe buckets for a callsite.\n *\n * @since 0.6\n * @stable\n * @example\n *     // const series = makeLowerTfSeries(ctx, \"slot#0\", \"30s\");\n *     const requested = \"30s\";\n *     void requested;\n */\nexport function makeLowerTfSeries(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n): Series<ReadonlyArray<Bar>> {\n    const cacheKey = `${slotId}|${interval}`;\n    const existing = ctx.requestLowerTfViews.get(cacheKey);\n    if (existing !== undefined) return existing;\n\n    const target = {\n        get current() {\n            return bucketAt(ctx, slotId, interval, 0);\n        },\n        get length() {\n            return ctx.stream.ohlcv.close.length;\n        },\n    };\n    const view = new Proxy(Object.freeze(target), {\n        get(obj, prop, receiver) {\n            if (typeof prop === \"string\") {\n                const n = Number(prop);\n                if (Number.isInteger(n) && n >= 0) return bucketAt(ctx, slotId, interval, n);\n            }\n            return Reflect.get(obj, prop, receiver);\n        },\n    }) as Series<ReadonlyArray<Bar>>;\n    ctx.requestLowerTfViews.set(cacheKey, view);\n    return view;\n}\n"]}
+{"version":3,"file":"lowerTf.js","sourceRoot":"","sources":["../../src/request/lowerTf.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Bar, Series } from \"@invinite-org/chartlang-core\";\n\nimport type { RuntimeContext } from \"../runtimeContext.js\";\nimport { getOrBucket } from \"./bucketLtfBarsCache.js\";\nimport { pushOnce } from \"./pushOnce.js\";\nimport { ascendingBarsFor } from \"./streamBars.js\";\n\nconst EMPTY_BUCKET: ReadonlyArray<Bar> = Object.freeze([]);\n\nfunction fallback(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n    code: \"unsupported-interval\" | \"multi-timeframe-not-supported\" | \"unknown-secondary-stream\",\n    message: string,\n): ReadonlyArray<Bar> {\n    pushOnce(ctx, code, slotId, interval, \"lowerTf\", message);\n    return EMPTY_BUCKET;\n}\n\nfunction bucketAt(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n    age: number,\n): ReadonlyArray<Bar> {\n    if (!ctx.capabilities.multiTimeframe) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"multi-timeframe-not-supported\",\n            \"Adapter declares multiTimeframe: false; request.lowerTf returns empty buckets\",\n        );\n    }\n\n    const known = ctx.capabilities.intervals.some((descriptor) => descriptor.value === interval);\n    if (!known) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"unsupported-interval\",\n            `Requested interval \"${interval}\" is not in Capabilities.intervals`,\n        );\n    }\n\n    // `request.lowerTf` is chart-symbol-only (per-feed symbol is a deferred\n    // follow-up), so the bare interval IS the feed key — `feedKey(undefined,\n    // interval) === interval`. Keying the (feed-keyed) `secondaryStreams` map\n    // and the cache below by the bare interval is therefore byte-identical to\n    // routing through `feedKey`; if `lowerTf` ever gains a symbol, switch both\n    // sites to `feedKey(symbol, interval)` so they cannot silently mis-key.\n    const secondary = ctx.secondaryStreams.get(interval);\n    if (secondary === undefined) {\n        return fallback(\n            ctx,\n            slotId,\n            interval,\n            \"unknown-secondary-stream\",\n            `Requested interval \"${interval}\" has no registered secondary stream`,\n        );\n    }\n\n    const mainBars = ascendingBarsFor(ctx, ctx.stream);\n    const ltfBars = ascendingBarsFor(ctx, secondary);\n    const buckets = getOrBucket(mainBars, ltfBars);\n    const index = buckets.length - 1 - age;\n    return buckets[index] ?? EMPTY_BUCKET;\n}\n\n/**\n * Return a stable series view of lower-timeframe buckets for a callsite.\n *\n * @since 0.6\n * @stable\n * @example\n *     // const series = makeLowerTfSeries(ctx, \"slot#0\", \"30s\");\n *     const requested = \"30s\";\n *     void requested;\n */\nexport function makeLowerTfSeries(\n    ctx: RuntimeContext,\n    slotId: string,\n    interval: string,\n): Series<ReadonlyArray<Bar>> {\n    const cacheKey = `${slotId}|${interval}`;\n    const existing = ctx.requestLowerTfViews.get(cacheKey);\n    if (existing !== undefined) return existing;\n\n    const target = {\n        get current() {\n            return bucketAt(ctx, slotId, interval, 0);\n        },\n        get length() {\n            return ctx.stream.ohlcv.close.length;\n        },\n    };\n    const view = new Proxy(Object.freeze(target), {\n        get(obj, prop, receiver) {\n            if (typeof prop === \"string\") {\n                const n = Number(prop);\n                if (Number.isInteger(n) && n >= 0) return bucketAt(ctx, slotId, interval, n);\n            }\n            return Reflect.get(obj, prop, receiver);\n        },\n    }) as Series<ReadonlyArray<Bar>>;\n    ctx.requestLowerTfViews.set(cacheKey, view);\n    return view;\n}\n"]}

package/dist/request/requestNamespace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestNamespace.d.ts","sourceRoot":"","sources":["../../src/request/requestNamespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGR,gBAAgB,EAInB,MAAM,8BAA8B,CAAC;AAwBtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAGxD"}
+{"version":3,"file":"requestNamespace.d.ts","sourceRoot":"","sources":["../../src/request/requestNamespace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGR,gBAAgB,EAKnB,MAAM,8BAA8B,CAAC;AAuDtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAGxD"}

package/dist/request/requestNamespace.js

@@ -1,8 +1,10 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { feedKey } from "@invinite-org/chartlang-core";
 import { ACTIVE_RUNTIME_CONTEXT } from "../runtimeContext.js";
 import { makeLowerTfSeries } from "./lowerTf.js";
-import { makeSecurityBar } from "./security.js";
+import { makeSecurityBar, makeSecurityExprSeries } from "./security.js";
+import { captureAndCatchUp } from "./securityExprRunner.js";
 function getCtx(name) {
     const ctx = ACTIVE_RUNTIME_CONTEXT.current;
     if (ctx === null) {
@@ -10,9 +12,34 @@ function getCtx(name) {
     }
     return ctx;
 }
-function security(slotId, opts) {
+// Resolve a requested symbol to the value the secondary stream is keyed under.
+// An omitted symbol — or the chart's own ticker passed explicitly — collapses
+// to `undefined` so `feedKey` produces the bare interval, hitting the same
+// stream as the omitted-symbol form (no duplicate) and staying byte-identical
+// to the pre-multi-symbol baseline. Only a *different* symbol survives as the
+// `"<symbol>@<interval>"` feed.
+function resolveSymbol(ctx, symbol) {
+    return symbol === undefined || symbol === ctx.chartSymbol ? undefined : symbol;
+}
+// Dispatch off the runner registry (not `expr !== undefined`) so compiled
+// output stays robust if the emitted call shape changes: a slotId the compiler
+// recorded in `manifest.securityExpressions` is always an expression unit.
+function security(slotId, opts, expr) {
     const ctx = getCtx("request.security");
-    return makeSecurityBar(ctx, slotId, opts.interval);
+    const symbol = resolveSymbol(ctx, opts.symbol);
+    const feed = feedKey(symbol, opts.interval);
+    const runner = ctx.securityExprRunners?.get(slotId);
+    if (runner === undefined) {
+        return makeSecurityBar(ctx, slotId, symbol, opts.interval);
+    }
+    if (expr !== undefined) {
+        const secondary = ctx.secondaryStreams.get(feed);
+        if (secondary !== undefined)
+            captureAndCatchUp(runner, expr, secondary);
+    }
+    // `resolveSymbol` collapses an omitted / chart-symbol request to `undefined`,
+    // so a defined `symbol` is always a DIFFERENT symbol (the `multiSymbol` gate).
+    return makeSecurityExprSeries(ctx, runner, feed, symbol !== undefined);
 }
 function lowerTf(slotId, opts) {
     const ctx = getCtx("request.lowerTf");

package/dist/request/requestNamespace.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestNamespace.js","sourceRoot":"","sources":["../../src/request/requestNamespace.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAW/D,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,SAAS,MAAM,CAAC,IAAY;IACxB,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,IAAyB;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACvC,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,IAAwB;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB;IACjC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,OAAO,EAAiC,CAAC;AAC7C,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    Bar,\n    RequestLowerTfOpts,\n    RequestNamespace,\n    RequestSecurityOpts,\n    SecurityBar,\n    Series,\n} from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../runtimeContext.js\";\nimport { makeLowerTfSeries } from \"./lowerTf.js\";\nimport { makeSecurityBar } from \"./security.js\";\n\nfunction getCtx(name: string): RuntimeContext {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) {\n        throw new Error(`${name} called outside an active script step`);\n    }\n    return ctx;\n}\n\nfunction security(slotId: string, opts: RequestSecurityOpts): SecurityBar {\n    const ctx = getCtx(\"request.security\");\n    return makeSecurityBar(ctx, slotId, opts.interval);\n}\n\nfunction lowerTf(slotId: string, opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>> {\n    const ctx = getCtx(\"request.lowerTf\");\n    return makeLowerTfSeries(ctx, slotId, opts.interval);\n}\n\n/**\n * Build the runtime `request` namespace installed on `ComputeContext`.\n *\n * The implementation accepts the compiler-injected `slotId` as its first\n * parameter even though the public core type is script-facing\n * `request.security(opts)`. This mirrors the existing slot-aware `state.*`\n * runtime namespace.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns = buildRequestNamespace();\n *     void ns.security;\n */\nexport function buildRequestNamespace(): RequestNamespace {\n    const ns = Object.freeze({ security, lowerTf });\n    return ns as unknown as RequestNamespace;\n}\n"]}
+{"version":3,"file":"requestNamespace.js","sourceRoot":"","sources":["../../src/request/requestNamespace.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAW/D,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAuB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,SAAS,MAAM,CAAC,IAAY;IACxB,MAAM,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,gCAAgC;AAChC,SAAS,aAAa,CAAC,GAAmB,EAAE,MAA0B;IAClE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACnF,CAAC;AAED,0EAA0E;AAC1E,+EAA+E;AAC/E,2EAA2E;AAC3E,SAAS,QAAQ,CACb,MAAc,EACd,IAAyB,EACzB,IAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,SAAS;YAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IACD,8EAA8E;IAC9E,+EAA+E;IAC/E,OAAO,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,IAAwB;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB;IACjC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,OAAO,EAAiC,CAAC;AAC7C,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type {\n    Bar,\n    RequestLowerTfOpts,\n    RequestNamespace,\n    RequestSecurityOpts,\n    SecurityBar,\n    SecurityExpr,\n    Series,\n} from \"@invinite-org/chartlang-core\";\nimport { feedKey } from \"@invinite-org/chartlang-core\";\n\nimport { ACTIVE_RUNTIME_CONTEXT, type RuntimeContext } from \"../runtimeContext.js\";\nimport { makeLowerTfSeries } from \"./lowerTf.js\";\nimport { makeSecurityBar, makeSecurityExprSeries } from \"./security.js\";\nimport { captureAndCatchUp } from \"./securityExprRunner.js\";\n\nfunction getCtx(name: string): RuntimeContext {\n    const ctx = ACTIVE_RUNTIME_CONTEXT.current;\n    if (ctx === null) {\n        throw new Error(`${name} called outside an active script step`);\n    }\n    return ctx;\n}\n\n// Resolve a requested symbol to the value the secondary stream is keyed under.\n// An omitted symbol — or the chart's own ticker passed explicitly — collapses\n// to `undefined` so `feedKey` produces the bare interval, hitting the same\n// stream as the omitted-symbol form (no duplicate) and staying byte-identical\n// to the pre-multi-symbol baseline. Only a *different* symbol survives as the\n// `\"<symbol>@<interval>\"` feed.\nfunction resolveSymbol(ctx: RuntimeContext, symbol: string | undefined): string | undefined {\n    return symbol === undefined || symbol === ctx.chartSymbol ? undefined : symbol;\n}\n\n// Dispatch off the runner registry (not `expr !== undefined`) so compiled\n// output stays robust if the emitted call shape changes: a slotId the compiler\n// recorded in `manifest.securityExpressions` is always an expression unit.\nfunction security(\n    slotId: string,\n    opts: RequestSecurityOpts,\n    expr?: SecurityExpr,\n): SecurityBar | Series<number> {\n    const ctx = getCtx(\"request.security\");\n    const symbol = resolveSymbol(ctx, opts.symbol);\n    const feed = feedKey(symbol, opts.interval);\n    const runner = ctx.securityExprRunners?.get(slotId);\n    if (runner === undefined) {\n        return makeSecurityBar(ctx, slotId, symbol, opts.interval);\n    }\n    if (expr !== undefined) {\n        const secondary = ctx.secondaryStreams.get(feed);\n        if (secondary !== undefined) captureAndCatchUp(runner, expr, secondary);\n    }\n    // `resolveSymbol` collapses an omitted / chart-symbol request to `undefined`,\n    // so a defined `symbol` is always a DIFFERENT symbol (the `multiSymbol` gate).\n    return makeSecurityExprSeries(ctx, runner, feed, symbol !== undefined);\n}\n\nfunction lowerTf(slotId: string, opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>> {\n    const ctx = getCtx(\"request.lowerTf\");\n    return makeLowerTfSeries(ctx, slotId, opts.interval);\n}\n\n/**\n * Build the runtime `request` namespace installed on `ComputeContext`.\n *\n * The implementation accepts the compiler-injected `slotId` as its first\n * parameter even though the public core type is script-facing\n * `request.security(opts)`. This mirrors the existing slot-aware `state.*`\n * runtime namespace.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns = buildRequestNamespace();\n *     void ns.security;\n */\nexport function buildRequestNamespace(): RequestNamespace {\n    const ns = Object.freeze({ security, lowerTf });\n    return ns as unknown as RequestNamespace;\n}\n"]}

package/dist/request/security.d.ts

@@ -1,5 +1,6 @@
-import type { SecurityBar } from "@invinite-org/chartlang-core";
+import type { SecurityBar, Series } from "@invinite-org/chartlang-core";
 import type { RuntimeContext } from "../runtimeContext.js";
+import { type SecurityExprRunner } from "./securityExprRunner.js";
 /**
  * Build the all-NaN `SecurityBar` fallback for unsupported MTF paths.
  *
@@ -12,14 +13,49 @@ import type { RuntimeContext } from "../runtimeContext.js";
  */
 export declare function makeNanSecurityBar(): SecurityBar;
 /**
- * Return the runtime `request.security` bar for a callsite and interval.
+ * Return the runtime `request.security` bar for a callsite and `(symbol,
+ * interval)` feed. `symbol` is already chart-symbol resolved + collapsed by the
+ * caller (`undefined` ⇒ the chart's own symbol), so the composite
+ * {@link feedKey} collapses to the bare interval for the chart-symbol path —
+ * keeping the cache key, secondary-stream lookup, and diagnostics
+ * byte-identical to the pre-multi-symbol baseline.
+ *
+ * A non-`undefined` `symbol` is therefore always a DIFFERENT symbol: the gate
+ * order is symbol (`multiSymbol`) → timeframe (`multiTimeframe`) →
+ * `unsupported-interval` → `unknown-secondary-stream`, so a request that is
+ * both a different symbol AND a different interval against `multiSymbol: false`
+ * trips `multi-symbol-not-supported` first (one diagnostic, not both).
  *
  * @since 0.5
  * @stable
  * @example
- *     // const bar = makeSecurityBar(ctx, "slot#0", "1D");
+ *     // const bar = makeSecurityBar(ctx, "slot#0", undefined, "1D");
  *     const requested = "1D";
  *     void requested;
  */
-export declare function makeSecurityBar(ctx: RuntimeContext, slotId: string, interval: string): SecurityBar;
+export declare function makeSecurityBar(ctx: RuntimeContext, slotId: string, symbol: string | undefined, interval: string): SecurityBar;
+/**
+ * Return the main-aligned output series for an HTF expression callsite. The
+ * runner's `output` buffer holds one sampled value per HTF bar; this aligns it
+ * no-lookahead to the main timeline against the real secondary stream's
+ * timestamps (so `output[i]` pairs with secondary ascending bar `i`). Reuses
+ * the OHLCV alignment kernel via {@link getOrAlign}. Capability / interval /
+ * stream fallbacks return an all-NaN series and push a deduped diagnostic,
+ * matching {@link makeSecurityBar}. The returned Proxy identity is cached per
+ * `slotId|feedKey` for the bar. `feed` is the composite key the caller built
+ * from the resolved `(symbol, interval)`; `runner.interval` is the bare
+ * interval used for the capability check and diagnostic text.
+ *
+ * `isDifferentSymbol` (`true` when the resolved symbol differs from the chart
+ * symbol) gates the all-NaN `multi-symbol-not-supported` fallback BEFORE the
+ * timeframe gate, mirroring {@link makeSecurityBar}'s order exactly.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const trend = makeSecurityExprSeries(ctx, runner, "1W", false);
+ *     const requested = "1W";
+ *     void requested;
+ */
+export declare function makeSecurityExprSeries(ctx: RuntimeContext, runner: SecurityExprRunner, feed: string, isDifferentSymbol: boolean): Series<number>;
 //# sourceMappingURL=security.d.ts.map

package/dist/request/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/request/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmC3D;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAiBhD;AA4HD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACjB,WAAW,CA2Cb"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/request/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,yBAAyB,CAAC;AAgCnF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAiBhD;AAmID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,GACjB,WAAW,CAyDb;AAgDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,OAAO,GAC3B,MAAM,CAAC,MAAM,CAAC,CAkChB"}

package/dist/request/security.js

@@ -1,8 +1,10 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
+import { feedKey } from "@invinite-org/chartlang-core";
 import { getOrAlign } from "./alignHtfSeriesCache.js";
 import { pushOnce } from "./pushOnce.js";
-import { ascendingBarsFor } from "./streamBars.js";
+import { ascendingValues } from "./securityExprRunner.js";
+import { ascendingBarsFor, makeConstantStringSeries } from "./streamBars.js";
 const NUMERIC_SOURCE_KEYS = Object.freeze([
     "time",
     "open",
@@ -54,11 +56,11 @@ function seriesAscending(stream, sourceKey) {
     }
     return values;
 }
-function alignmentKey(slotId, interval, sourceKey) {
-    return `${slotId}|${interval}|${sourceKey}`;
+function alignmentKey(slotId, feed, sourceKey) {
+    return `${slotId}|${feed}|${sourceKey}`;
 }
-function alignedSeries(ctx, slotId, interval, sourceKey, secondary) {
-    const key = alignmentKey(slotId, interval, sourceKey);
+function alignedSeries(ctx, slotId, feed, sourceKey, secondary) {
+    const key = alignmentKey(slotId, feed, sourceKey);
     const existing = ctx.requestSecurityAlignments.get(key);
     if (existing !== undefined)
         return existing;
@@ -68,10 +70,17 @@ function alignedSeries(ctx, slotId, interval, sourceKey, secondary) {
     ctx.requestSecurityAlignments.set(key, aligned);
     return aligned;
 }
-function makeAlignedNumberSeries(ctx, slotId, interval, sourceKey, secondary) {
+/**
+ * Wrap a producer of the latest main-aligned array in the head-relative
+ * `Series<number>` Proxy shape. `current` / `[n]` re-run `produce` (cheap —
+ * `getOrAlign` memoises per bar) and read from the tail; `length` is the main
+ * stream's bar count. Shared by the OHLCV `SecurityBar` fields and the
+ * expression-output series so both walk the identical no-lookahead alignment.
+ */
+function makeAlignedSeriesProxy(ctx, produce) {
     const target = {
         get current() {
-            const aligned = alignedSeries(ctx, slotId, interval, sourceKey, secondary);
+            const aligned = produce();
             const value = aligned[aligned.length - 1];
             return value === undefined ? Number.NaN : value;
         },
@@ -84,7 +93,7 @@ function makeAlignedNumberSeries(ctx, slotId, interval, sourceKey, secondary) {
             if (typeof prop === "string") {
                 const n = Number(prop);
                 if (Number.isInteger(n) && n >= 0) {
-                    const aligned = alignedSeries(ctx, slotId, interval, sourceKey, secondary);
+                    const aligned = produce();
                     const value = aligned[aligned.length - 1 - n];
                     return value === undefined ? Number.NaN : value;
                 }
@@ -93,30 +102,13 @@ function makeAlignedNumberSeries(ctx, slotId, interval, sourceKey, secondary) {
         },
     });
 }
-function makeConstantStringSeries(value) {
-    const target = {
-        get current() {
-            return value;
-        },
-        get length() {
-            return 0;
-        },
-    };
-    return new Proxy(Object.freeze(target), {
-        get(obj, prop, receiver) {
-            if (typeof prop === "string") {
-                const n = Number(prop);
-                if (Number.isInteger(n) && n >= 0)
-                    return value;
-            }
-            return Reflect.get(obj, prop, receiver);
-        },
-    });
+function makeAlignedNumberSeries(ctx, slotId, feed, sourceKey, secondary) {
+    return makeAlignedSeriesProxy(ctx, () => alignedSeries(ctx, slotId, feed, sourceKey, secondary));
 }
-function makeLiveSecurityBar(ctx, slotId, interval, secondary) {
+function makeLiveSecurityBar(ctx, slotId, feed, interval, secondary) {
     const numeric = new Map();
     for (const key of NUMERIC_SOURCE_KEYS) {
-        numeric.set(key, makeAlignedNumberSeries(ctx, slotId, interval, key, secondary));
+        numeric.set(key, makeAlignedNumberSeries(ctx, slotId, feed, key, secondary));
     }
     return Object.freeze({
         time: numeric.get("time") ?? makeSeries(Number.NaN),
@@ -133,40 +125,122 @@ function makeLiveSecurityBar(ctx, slotId, interval, secondary) {
         interval: makeConstantStringSeries(interval),
     });
 }
-function fallbackNaN(ctx, cacheKey, slotId, interval, code, message) {
-    pushOnce(ctx, code, slotId, interval, "security", message);
+// The adapter does not advertise `multiSymbol`, so a `request.security` for a
+// symbol other than the chart's own degrades to all-NaN — mirroring the
+// `multiTimeframe` fallback message exactly, only naming the symbol gate.
+const MULTI_SYMBOL_MSG = "Adapter declares multiSymbol: false; request.security for a different symbol returns NaN";
+function fallbackNaN(ctx, cacheKey, slotId, feed, code, message) {
+    pushOnce(ctx, code, slotId, feed, "security", message);
     const bar = makeNanSecurityBar();
     ctx.requestSecurityBars.set(cacheKey, bar);
     return bar;
 }
 /**
- * Return the runtime `request.security` bar for a callsite and interval.
+ * Return the runtime `request.security` bar for a callsite and `(symbol,
+ * interval)` feed. `symbol` is already chart-symbol resolved + collapsed by the
+ * caller (`undefined` ⇒ the chart's own symbol), so the composite
+ * {@link feedKey} collapses to the bare interval for the chart-symbol path —
+ * keeping the cache key, secondary-stream lookup, and diagnostics
+ * byte-identical to the pre-multi-symbol baseline.
+ *
+ * A non-`undefined` `symbol` is therefore always a DIFFERENT symbol: the gate
+ * order is symbol (`multiSymbol`) → timeframe (`multiTimeframe`) →
+ * `unsupported-interval` → `unknown-secondary-stream`, so a request that is
+ * both a different symbol AND a different interval against `multiSymbol: false`
+ * trips `multi-symbol-not-supported` first (one diagnostic, not both).
  *
  * @since 0.5
  * @stable
  * @example
- *     // const bar = makeSecurityBar(ctx, "slot#0", "1D");
+ *     // const bar = makeSecurityBar(ctx, "slot#0", undefined, "1D");
  *     const requested = "1D";
  *     void requested;
  */
-export function makeSecurityBar(ctx, slotId, interval) {
-    const cacheKey = `${slotId}|${interval}`;
+export function makeSecurityBar(ctx, slotId, symbol, interval) {
+    const feed = feedKey(symbol, interval);
+    const cacheKey = `${slotId}|${feed}`;
     const existing = ctx.requestSecurityBars.get(cacheKey);
     if (existing !== undefined)
         return existing;
+    // Symbol gate precedes the timeframe gate: a different symbol is a strictly
+    // larger ask than a higher timeframe of the chart's own symbol.
+    if (symbol !== undefined && !ctx.capabilities.multiSymbol) {
+        return fallbackNaN(ctx, cacheKey, slotId, feed, "multi-symbol-not-supported", MULTI_SYMBOL_MSG);
+    }
     if (!ctx.capabilities.multiTimeframe) {
-        return fallbackNaN(ctx, cacheKey, slotId, interval, "multi-timeframe-not-supported", "Adapter declares multiTimeframe: false; request.security returns NaN");
+        return fallbackNaN(ctx, cacheKey, slotId, feed, "multi-timeframe-not-supported", "Adapter declares multiTimeframe: false; request.security returns NaN");
     }
     const known = ctx.capabilities.intervals.some((descriptor) => descriptor.value === interval);
     if (!known) {
-        return fallbackNaN(ctx, cacheKey, slotId, interval, "unsupported-interval", `Requested interval "${interval}" is not in Capabilities.intervals`);
+        return fallbackNaN(ctx, cacheKey, slotId, feed, "unsupported-interval", `Requested interval "${interval}" is not in Capabilities.intervals`);
     }
-    const secondary = ctx.secondaryStreams.get(interval);
+    const secondary = ctx.secondaryStreams.get(feed);
     if (secondary === undefined) {
-        return fallbackNaN(ctx, cacheKey, slotId, interval, "unknown-secondary-stream", `Requested interval "${interval}" has no registered secondary stream`);
+        return fallbackNaN(ctx, cacheKey, slotId, feed, "unknown-secondary-stream", `Requested interval "${interval}" has no registered secondary stream`);
     }
-    const bar = makeLiveSecurityBar(ctx, slotId, interval, secondary);
+    const bar = makeLiveSecurityBar(ctx, slotId, feed, interval, secondary);
     ctx.requestSecurityBars.set(cacheKey, bar);
     return bar;
 }
+function makeNanNumberSeries() {
+    return makeSeries(Number.NaN);
+}
+function resolveSecondaryOrDiagnose(ctx, slotId, feed, interval) {
+    if (!ctx.capabilities.multiTimeframe) {
+        pushOnce(ctx, "multi-timeframe-not-supported", slotId, feed, "security", "Adapter declares multiTimeframe: false; request.security returns NaN");
+        return undefined;
+    }
+    if (!ctx.capabilities.intervals.some((descriptor) => descriptor.value === interval)) {
+        pushOnce(ctx, "unsupported-interval", slotId, feed, "security", `Requested interval "${interval}" is not in Capabilities.intervals`);
+        return undefined;
+    }
+    const secondary = ctx.secondaryStreams.get(feed);
+    if (secondary === undefined) {
+        pushOnce(ctx, "unknown-secondary-stream", slotId, feed, "security", `Requested interval "${interval}" has no registered secondary stream`);
+    }
+    return secondary;
+}
+/**
+ * Return the main-aligned output series for an HTF expression callsite. The
+ * runner's `output` buffer holds one sampled value per HTF bar; this aligns it
+ * no-lookahead to the main timeline against the real secondary stream's
+ * timestamps (so `output[i]` pairs with secondary ascending bar `i`). Reuses
+ * the OHLCV alignment kernel via {@link getOrAlign}. Capability / interval /
+ * stream fallbacks return an all-NaN series and push a deduped diagnostic,
+ * matching {@link makeSecurityBar}. The returned Proxy identity is cached per
+ * `slotId|feedKey` for the bar. `feed` is the composite key the caller built
+ * from the resolved `(symbol, interval)`; `runner.interval` is the bare
+ * interval used for the capability check and diagnostic text.
+ *
+ * `isDifferentSymbol` (`true` when the resolved symbol differs from the chart
+ * symbol) gates the all-NaN `multi-symbol-not-supported` fallback BEFORE the
+ * timeframe gate, mirroring {@link makeSecurityBar}'s order exactly.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     // const trend = makeSecurityExprSeries(ctx, runner, "1W", false);
+ *     const requested = "1W";
+ *     void requested;
+ */
+export function makeSecurityExprSeries(ctx, runner, feed, isDifferentSymbol) {
+    const cacheKey = `${runner.slotId}|${feed}`;
+    const cache = ctx.requestSecurityExprSeries;
+    const existing = cache?.get(cacheKey);
+    if (existing !== undefined)
+        return existing;
+    // Symbol gate precedes the timeframe gate, matching `makeSecurityBar`.
+    if (isDifferentSymbol && !ctx.capabilities.multiSymbol) {
+        pushOnce(ctx, "multi-symbol-not-supported", runner.slotId, feed, "security", MULTI_SYMBOL_MSG);
+        const nan = makeNanNumberSeries();
+        cache?.set(cacheKey, nan);
+        return nan;
+    }
+    const secondary = resolveSecondaryOrDiagnose(ctx, runner.slotId, feed, runner.interval);
+    const series = secondary === undefined
+        ? makeNanNumberSeries()
+        : makeAlignedSeriesProxy(ctx, () => getOrAlign(ascendingBarsFor(ctx, secondary), ascendingValues(runner.output), ascendingBarsFor(ctx, ctx.stream)));
+    cache?.set(cacheKey, series);
+    return series;
+}
 //# sourceMappingURL=security.js.map