@invinite-org/chartlang-core 1.0.1

package/dist/types.d.ts

@@ -0,0 +1,464 @@
+import type { ScaleAxis, ValueFormat } from "./define/overrides.js";
+import type { DrawNamespace } from "./draw/draw.js";
+import type { InputDescriptor } from "./input/inputDescriptor.js";
+import type { RequestNamespace } from "./request/index.js";
+import type { RuntimeNamespace } from "./runtime/index.js";
+import type { StateNamespace } from "./state/state.js";
+import type { TaNamespace } from "./ta/ta.js";
+import type { BarStateView, SymInfoView, TimeframeView } from "./views/index.js";
+/**
+ * UTC milliseconds since epoch — the only time representation the runtime
+ * speaks. Display-side timezones are the adapter's responsibility.
+ *
+ * @since 0.1
+ * @example
+ *     const t: Time = 1_700_000_000_000;
+ */
+export type Time = number;
+/**
+ * A price quote in the symbol's quote currency, finite or NaN. NaN marks an
+ * unwarmed series slot.
+ *
+ * @since 0.1
+ * @example
+ *     const last: Price = 42.31;
+ */
+export type Price = number;
+/**
+ * Traded volume for the bar, in the symbol's native unit (shares, contracts,
+ * coins, …).
+ *
+ * @since 0.1
+ * @example
+ *     const v: Volume = 1_250_000;
+ */
+export type Volume = number;
+/**
+ * Visible chart range in UTC milliseconds. Phase 5's OSS runtime
+ * supplies a fallback range spanning the latest 100 bars ending at the
+ * current head; adapters with a real viewport can replace this view in
+ * later phases.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const viewport: BarViewport = {
+ *         fromTime: 1_700_000_000_000,
+ *         toTime: 1_700_006_000_000,
+ *     };
+ */
+export type BarViewport = Readonly<{
+    readonly fromTime: Time;
+    readonly toTime: Time;
+}>;
+/**
+ * The OHLCV record the runtime hands to `compute` for the current bar. Every
+ * field is `readonly`; scripts must not mutate it.
+ *
+ * Phase 2 surfaces the four pre-computed derived sources (`hl2` / `hlc3` /
+ * `ohlc4` / `hlcc4`) the runtime's `BarView`
+ * (`packages/runtime/src/streamState.ts`) already populates on every close.
+ * Script authors can write `ta.cci(bar.hlc3, 20)` directly — matching Pine's
+ * canonical `bar.hlc3` / `bar.ohlc4` access pattern — without re-computing
+ * the derived source per lookup.
+ *
+ * @since 0.1
+ * @example
+ *     function tick(bar: Bar): void {
+ *         console.log(bar.close, bar.symbol, bar.interval);
+ *         // Phase 2 — Pine-style derived sources:
+ *         console.log(bar.hl2, bar.hlc3, bar.ohlc4, bar.hlcc4);
+ *         // Phase 5 — visible-range fallback:
+ *         console.log(bar.viewport.fromTime, bar.viewport.toTime);
+ *     }
+ */
+export type Bar = {
+    readonly time: Time;
+    readonly open: Price;
+    readonly high: Price;
+    readonly low: Price;
+    readonly close: Price;
+    readonly volume: Volume;
+    readonly symbol: string;
+    readonly interval: string;
+    /** `(high + low) / 2`. @since 0.2 */
+    readonly hl2: Price;
+    /** `(high + low + close) / 3`. @since 0.2 */
+    readonly hlc3: Price;
+    /** `(open + high + low + close) / 4`. @since 0.2 */
+    readonly ohlc4: Price;
+    /** `(high + low + close + close) / 4` (Pine's `hlcc4`). @since 0.2 */
+    readonly hlcc4: Price;
+    /** Visible-range fallback used by viewport-aware primitives. @since 0.5 */
+    readonly viewport?: BarViewport;
+};
+/**
+ * Read-only view over a ring-buffered history of values. `current` is bar 0,
+ * numeric indices look back N bars. The runtime owns the storage; scripts see
+ * only this shape.
+ *
+ * @since 0.1
+ * @example
+ *     function delta(close: Series<number>): number {
+ *         return close.current - close[1];
+ *     }
+ */
+export type Series<T> = {
+    readonly current: T;
+    readonly [n: number]: T;
+    readonly length: number;
+};
+/**
+ * CSS color string — `"#rrggbb"`, `"rgb(...)"`, `"hsl(...)"`, etc. Adapters
+ * round-trip the string verbatim.
+ *
+ * @since 0.1
+ * @example
+ *     const blue: Color = "#3b82f6";
+ */
+export type Color = string;
+/**
+ * Stroke style for `plot` and `hline` lines. Adapters that cannot render a
+ * style fall back to `"solid"` and emit `"line-style-unsupported"`.
+ *
+ * @since 0.1
+ * @example
+ *     const ls: LineStyle = "dashed";
+ */
+export type LineStyle = "solid" | "dashed" | "dotted";
+/**
+ * The rendered shape an adapter requests for a `plot` emission. Maps to
+ * `Capabilities.plotKinds`.
+ *
+ * @since 0.1
+ * @example
+ *     const k: PlotLineStyle = "step";
+ */
+export type PlotLineStyle = "line" | "step" | "dashed" | "circles" | "cross";
+/**
+ * Alert severity used by `alert(...)` and downstream alert channels. Defaults
+ * to `"info"` when callers omit `opts.severity`.
+ *
+ * @since 0.1
+ * @example
+ *     const sev: AlertSeverity = "warning";
+ */
+export type AlertSeverity = "info" | "warning" | "critical";
+/**
+ * Adapter-declared timeframe entry surfaced in the script-settings UI. The
+ * optional `intervalSeconds` override lets exotic intervals declare their
+ * effective duration without extending the standard parser grammar.
+ *
+ * @since 0.1
+ * @example
+ *     const d: IntervalDescriptor = {
+ *         value: "1D",
+ *         label: "1 day",
+ *         group: "Days",
+ *     };
+ */
+export type IntervalDescriptor = {
+    readonly value: string;
+    readonly label: string;
+    readonly group: string;
+    /**
+     * Optional positive finite second-count override used by interval
+     * ordering helpers before parsing `value`.
+     *
+     * @since 0.6
+     * @stable
+     */
+    readonly intervalSeconds?: number;
+};
+/**
+ * Script-author-declared input schema attached to `defineIndicator` /
+ * `defineAlert` / `defineDrawing`. Each key carries an `InputDescriptor<T>`
+ * returned by an `input.*` builder. The compiler serialises this schema into
+ * `manifest.inputs`; the runtime resolves user overrides against defaults.
+ *
+ * @since 0.1 — widened in 0.4 from opaque `Readonly<Record<string, unknown>>`
+ *   to the typed `InputDescriptor<unknown>` shape returned by `input.*`
+ *   builders. Existing scripts stay source-compatible because the previous
+ *   opaque record subsumes the new typed shape.
+ * @example
+ *     import { input } from "@invinite-org/chartlang-core";
+ *     const inputs: InputSchema = { length: input.int(20) };
+ *     void inputs;
+ */
+export type InputSchema = Readonly<Record<string, InputDescriptor<unknown>>>;
+/**
+ * Discriminator for the Phase-1 adapter capability subset the script-side
+ * surface references. The full `Capabilities` type lives in
+ * `@invinite-org/chartlang-adapter-kit` (Task 4); only the id strings appear
+ * here.
+ *
+ * @since 0.1
+ * @example
+ *     const caps: ReadonlyArray<CapabilityId> = ["indicators", "alerts"];
+ */
+export type CapabilityId = "indicators" | "drawings" | "alerts" | "alertConditions";
+/**
+ * Per-script drawing-emission budget. Excess `draw.*` calls drop with
+ * `drawing-budget-exceeded` once a bucket is full. Mirrors Pine's
+ * `max_*_count` family. The runtime enforces
+ * `min(scriptManifest.maxDrawings, adapter.capabilities.maxDrawingsPerScript)`
+ * per bucket per PLAN.md §10 / §4.1.
+ *
+ * Canonical declaration lives here in core so both
+ * `ScriptManifest.maxDrawings?` and the adapter-kit re-export pin the
+ * same shape — preserving the adapter-kit → core dependency direction.
+ *
+ * @since 0.3
+ * @stable
+ * @example
+ *     const c: DrawingCounts = {
+ *         lines: 50, labels: 50, boxes: 50, polylines: 50, other: 50,
+ *     };
+ *     void c;
+ */
+export type DrawingCounts = {
+    readonly lines: number;
+    readonly labels: number;
+    readonly boxes: number;
+    readonly polylines: number;
+    readonly other: number;
+};
+/**
+ * The metadata sidecar the compiler emits next to a compiled script. The
+ * runtime reads this to size ring buffers, gate against adapter capabilities,
+ * and pick secondary candle streams.
+ *
+ * @since 0.1
+ * @example
+ *     const m: ScriptManifest = {
+ *         apiVersion: 1,
+ *         kind: "indicator",
+ *         name: "demo",
+ *         inputs: {},
+ *         capabilities: ["indicators"],
+ *         requestedIntervals: [],
+ *         userPickableInterval: false,
+ *         seriesCapacities: {},
+ *         maxLookback: 0,
+ *         shortName: "demo",
+ *         format: "compact",
+ *     };
+ */
+export type ScriptManifest = {
+    readonly apiVersion: 1;
+    readonly kind: "indicator" | "drawing" | "alert" | "alertCondition";
+    readonly name: string;
+    readonly inputs: InputSchema;
+    readonly capabilities: ReadonlyArray<CapabilityId>;
+    readonly requestedIntervals: ReadonlyArray<string>;
+    readonly userPickableInterval: boolean;
+    readonly seriesCapacities: Readonly<Record<string, number>>;
+    readonly maxLookback: number;
+    /**
+     * Per-bucket cap on `draw.*` emissions the script intends to
+     * produce per bar. The runtime enforces
+     * `min(this, adapter.capabilities.maxDrawingsPerScript)` per
+     * bucket. Omit to default to the adapter's cap.
+     *
+     * @since 0.3
+     */
+    readonly maxDrawings?: DrawingCounts;
+    /**
+     * Max bars of historical lookback the script declares it needs.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["maxBarsBack"] = 100;
+     *     void v;
+     */
+    readonly maxBarsBack?: number;
+    /**
+     * Value-formatting hint for axis labels + cursor read-out.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["format"] = "price";
+     *     void v;
+     */
+    readonly format?: ValueFormat;
+    /**
+     * Decimal precision the adapter renders the script at.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["precision"] = 2;
+     *     void v;
+     */
+    readonly precision?: number;
+    /**
+     * Scale-axis binding requested by the script.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["scale"] = "right";
+     *     void v;
+     */
+    readonly scale?: ScaleAxis;
+    /**
+     * Compact display label for legend chips.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["shortName"] = "EMA";
+     *     void v;
+     */
+    readonly shortName?: string;
+    /**
+     * Static set of intervals the script requires the target adapter to ship
+     * in `Capabilities.intervals`. The compiler unions this with the static
+     * set extracted from `request.security` calls in Task 8. `input.interval`
+     * is user-pickable and does not contribute to this author-declared hard
+     * requirement set.
+     *
+     * @since 0.4
+     * @example
+     *     const v: ScriptManifest["requiresIntervals"] = ["1D"];
+     *     void v;
+     */
+    readonly requiresIntervals?: ReadonlyArray<string>;
+    /**
+     * Static list of user-wireable alert conditions declared by
+     * `defineAlertCondition({ conditions })`.
+     *
+     * @since 0.5
+     * @stable
+     * @example
+     *     const defs: ScriptManifest["alertConditions"] = [
+     *         { id: "up", title: "Up", description: "Close > EMA", defaultMessage: "{{ticker}} up" },
+     *     ];
+     *     void defs;
+     */
+    readonly alertConditions?: ReadonlyArray<AlertConditionDefinition>;
+};
+/**
+ * Per-condition descriptor authored under
+ * `DefineAlertConditionOpts.conditions`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const d: AlertConditionDescriptor = {
+ *         title: "Up",
+ *         description: "Close crossed up",
+ *         defaultMessage: "{{ticker}} crossed up",
+ *     };
+ *     void d;
+ */
+export type AlertConditionDescriptor = Readonly<{
+    title: string;
+    description: string;
+    defaultMessage: string;
+}>;
+/**
+ * Manifest-ready alert-condition descriptor with the author map key
+ * normalised into `id`.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     const d: AlertConditionDefinition = {
+ *         id: "up",
+ *         title: "Up",
+ *         description: "Close crossed up",
+ *         defaultMessage: "{{ticker}} crossed up",
+ *     };
+ *     void d;
+ */
+export type AlertConditionDefinition = AlertConditionDescriptor & Readonly<{
+    id: string;
+}>;
+/**
+ * The argument the runtime hands a script's `compute` function each bar. The
+ * `ta` / `plot` / `hline` / `alert` slots are the runtime's implementations,
+ * not the compile-time callable holes from `@invinite-org/chartlang-core`.
+ *
+ * @since 0.1
+ * @example
+ *     const fn: ComputeFn = ({ bar, plot }) => { plot(bar.close); };
+ */
+export type ComputeContext = {
+    readonly bar: Bar;
+    readonly inputs: Readonly<Record<string, unknown>>;
+    readonly ta: TaNamespace;
+    readonly plot: typeof import("./plot/plot.js").plot;
+    readonly hline: typeof import("./plot/plot.js").hline;
+    readonly alert: typeof import("./alert/alert.js").alert;
+    /** Pine `var` / `varip` state slots. @since 0.4 */
+    readonly state: StateNamespace;
+    /** Bar-state view derived for the active step. @since 0.4 */
+    readonly barstate: BarStateView;
+    /** Symbol metadata view for the active script mount. @since 0.4 */
+    readonly syminfo: SymInfoView;
+    /** Timeframe helper view derived for the active step. @since 0.4 */
+    readonly timeframe: TimeframeView;
+    /** Secondary timeframe request namespace. @since 0.4 */
+    readonly request: RequestNamespace;
+    /** Runtime logging and fatal halt namespace. @since 0.5 */
+    readonly runtime: RuntimeNamespace;
+    /**
+     * Signal a named condition declared by `defineAlertCondition`. Present
+     * only for scripts whose manifest kind is `"alertCondition"`.
+     *
+     * @since 0.5
+     * @stable
+     * @example
+     *     const fn: NonNullable<ComputeContext["signal"]> = (id, fired) => {
+     *         void id;
+     *         void fired;
+     *     };
+     *     void fn;
+     */
+    readonly signal?: (conditionId: string, fired: boolean) => void;
+    /**
+     * Imperative drawing namespace. Each method returns a
+     * {@link DrawingHandle} the script can `update(...)` or
+     * `remove()` within the same `compute` run, and across bars.
+     * The Phase-3 runtime impl lives in
+     * `@invinite-org/chartlang-runtime/emit/draw`. @since 0.3
+     */
+    readonly draw: DrawNamespace;
+};
+/**
+ * The per-bar compute function a script exports via `defineIndicator` /
+ * `defineAlert`. Pure with respect to its arguments — no `this`, no closures
+ * over host state.
+ *
+ * @since 0.1
+ * @example
+ *     const fn: ComputeFn = (ctx) => { ctx.plot(ctx.bar.close); };
+ */
+export type ComputeFn = (ctx: ComputeContext) => void;
+/**
+ * The frozen object the `defineIndicator` / `defineAlert` constructors return.
+ * The compiler rewrites `manifest` fields at build time; the runtime invokes
+ * `compute` per bar.
+ *
+ * @since 0.1
+ * @example
+ *     const cs: CompiledScriptObject = defineIndicator({
+ *         name: "demo",
+ *         apiVersion: 1,
+ *         compute: () => {},
+ *     });
+ */
+export type CompiledScriptObject = {
+    readonly manifest: ScriptManifest;
+    readonly compute: ComputeFn;
+};
+/**
+ * JSON-compatible payload type for `alert(...).meta` and other places the
+ * runtime serialises script-supplied data across worker / host boundaries.
+ *
+ * @since 0.1
+ * @example
+ *     const meta: JsonValue = { reason: "crossover", strength: 0.42 };
+ */
+export type JsonValue = null | boolean | number | string | ReadonlyArray<JsonValue> | {
+    readonly [k: string]: JsonValue;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D"}

package/dist/views/barstate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Bar-state view. Mirrors Pine's `barstate.*`; all fields are derived per
+ * step from runtime event type and bar-index bookkeeping.
+ *
+ * The exported module-scope value is only the default fallback. Runtime
+ * implementations supply per-step snapshots through `ComputeContext`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view: BarStateView = barstate;
+ *     void view;
+ */
+export type BarStateView = {
+    /** True on the first historical bar of this script mount. */
+    readonly isfirst: boolean;
+    /** True on the most recent bar, live or replay. */
+    readonly islast: boolean;
+    /** True if a new bar opened on this step; false on ticks within a bar. */
+    readonly isnew: boolean;
+    /** True if the runtime is in the historical-replay phase. */
+    readonly ishistory: boolean;
+    /** True if the runtime is processing a realtime feed. */
+    readonly isrealtime: boolean;
+    /** True if this step is a `kind: "close"` event; false on ticks. */
+    readonly isconfirmed: boolean;
+};
+/**
+ * Module-scope `barstate` fallback. Outside a script step, every field is
+ * `false`; the runtime supplies the active per-step snapshot on
+ * `ComputeContext.barstate`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     import { barstate } from "@invinite-org/chartlang-core";
+ *     void barstate;
+ */
+export declare const barstate: BarStateView;
+//# sourceMappingURL=barstate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"barstate.d.ts","sourceRoot":"","sources":["../../src/views/barstate.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,EAAE,YAOrB,CAAC"}

package/dist/views/barstate.js

@@ -0,0 +1,22 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Module-scope `barstate` fallback. Outside a script step, every field is
+ * `false`; the runtime supplies the active per-step snapshot on
+ * `ComputeContext.barstate`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     import { barstate } from "@invinite-org/chartlang-core";
+ *     void barstate;
+ */
+export const barstate = Object.freeze({
+    isfirst: false,
+    islast: false,
+    isnew: false,
+    ishistory: false,
+    isrealtime: false,
+    isconfirmed: false,
+});
+//# sourceMappingURL=barstate.js.map

package/dist/views/barstate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barstate.js","sourceRoot":"","sources":["../../src/views/barstate.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA8B/D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiB,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;CACrB,CAAC,CAAC"}

package/dist/views/index.d.ts

@@ -0,0 +1,4 @@
+export { barstate, type BarStateView } from "./barstate.js";
+export { syminfo, type SymbolType, type SymInfoView } from "./syminfo.js";
+export { timeframe, type TimeframeView } from "./timeframe.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":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/views/index.js

@@ -0,0 +1,4 @@
+export { barstate } from "./barstate.js";
+export { syminfo } from "./syminfo.js";
+export { timeframe } from "./timeframe.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,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAqC,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAsB,MAAM,gBAAgB,CAAC"}

package/dist/views/syminfo.d.ts

@@ -0,0 +1,46 @@
+import type { JsonValue } from "../types.js";
+/**
+ * Symbol-type union. Adapters that cannot map a symbol to a canonical type
+ * return `"custom"`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const t: SymbolType = "equity";
+ *     void t;
+ */
+export type SymbolType = "equity" | "futures" | "forex" | "crypto" | "index" | "fund" | "bond" | "commodity" | "custom";
+/**
+ * Symbol-metadata view. Fields not populated by the adapter evaluate to
+ * their empty sentinel: `""`, `NaN`, or `{}`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     const view: SymInfoView = syminfo;
+ *     void view;
+ */
+export type SymInfoView = {
+    readonly ticker: string;
+    readonly type: SymbolType;
+    readonly mintick: number;
+    readonly currency: string;
+    readonly basecurrency: string;
+    readonly exchange: string;
+    readonly timezone: string;
+    readonly session: string;
+    readonly meta: Readonly<Record<string, JsonValue>>;
+};
+/**
+ * Module-scope `syminfo` fallback. Outside a script step, every field
+ * evaluates to its empty sentinel; the runtime supplies the active per-mount
+ * snapshot on `ComputeContext.syminfo`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     import { syminfo } from "@invinite-org/chartlang-core";
+ *     void syminfo;
+ */
+export declare const syminfo: SymInfoView;
+//# sourceMappingURL=syminfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syminfo.d.ts","sourceRoot":"","sources":["../../src/views/syminfo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAChB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,QAAQ,CAAC;AAEf;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,EAAE,WAUpB,CAAC"}

package/dist/views/syminfo.js

@@ -0,0 +1,25 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Module-scope `syminfo` fallback. Outside a script step, every field
+ * evaluates to its empty sentinel; the runtime supplies the active per-mount
+ * snapshot on `ComputeContext.syminfo`.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     import { syminfo } from "@invinite-org/chartlang-core";
+ *     void syminfo;
+ */
+export const syminfo = Object.freeze({
+    ticker: "",
+    type: "custom",
+    mintick: Number.NaN,
+    currency: "",
+    basecurrency: "",
+    exchange: "",
+    timezone: "",
+    session: "",
+    meta: Object.freeze({}),
+});
+//# sourceMappingURL=syminfo.js.map

package/dist/views/syminfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syminfo.js","sourceRoot":"","sources":["../../src/views/syminfo.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AA+C/D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAgB,MAAM,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,MAAM,CAAC,GAAG;IACnB,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;CAC1B,CAAC,CAAC"}