@invinite-org/chartlang-runtime

experimental

Execution engine, Series ring buffers, primitive implementations, state slots, views, inputs, request fallback, and emission buffering.

Install

pnpm add @invinite-org/chartlang-runtime

Public surface

• createScriptRunner({ compiled, capabilities, stateStore?, symInfo?, inputOverrides? }) -> ScriptRunner with onHistory, onBarClose, onBarTick, drain, and dispose.
• Data structures: RingBuffer<T>, Float64RingBuffer, makeSeriesView(buf), createStreamState(...).
• State: inMemoryStateStore() plus runtime state.* slots with committed/tentative semantics; state.tick.* commits immediately during ticks.
• Views: per-step barstate, timeframe, and per-mount syminfo snapshots are wired into ComputeContext.
• Inputs: manifest input descriptors resolve through adapter/host overrides before compute({ inputs }) runs.
• Request: request.security({ interval }) returns a cached all-NaN SecurityBar when multi-timeframe support is unavailable and emits deduped capability diagnostics.
• Emissions: plot, hline, alert, draw, drawing handles, budget checks, and validation-backed diagnostic drops.
• Context: ACTIVE_RUNTIME_CONTEXT is set only around script steps.
• Composition (Phase 7): createScriptRunner accepts a CompiledScriptBundle in addition to a single CompiledScriptObject. Mounts one DepRunner per private dep and one SiblingRunner per drawn export; runs deps then siblings then primary each bar; filters emissions per export-status (private dep visuals dropped, sibling visuals forwarded with export:<name>/ slot-id prefix). Dep halts drop the primary's bar.
• Internal subpath @invinite-org/chartlang-runtime/internal: exports __chartlang_depOutput for compiler-emitted bundles. Not a script-author surface.

Minimum-viable API call

import { createScriptRunner, inMemoryStateStore } from "@invinite-org/chartlang-runtime";

const runner = createScriptRunner({
    compiled,
    capabilities,
    stateStore: inMemoryStateStore(),
});

await runner.onHistory(bars);
const emissions = runner.drain();

Docs

See docs/spec/semantics.md.

License

MIT