@invinite-org/chartlang-core 1.1.1 → 1.3.0

package/dist/plot/plot.js.map

@@ -1 +1 @@
-{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/plot/plot.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAiR/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,MAA+B,EAAE,KAAgB;IAClE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,KAAiB;IACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC7D,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 { Color, LineStyle, Series } from \"../types.js\";\n\n/**\n * Rendered-shape discriminator for `plot` emissions reaching the adapter.\n * The full 0.5 inventory is `line`, `step-line`, `horizontal-line`,\n * `histogram`, `area`, `filled-band`, `label`, `marker`,\n * `shape`, `character`, `arrow`, `candle-override`, `bar-override`,\n * `bg-color`, `bar-color`, and `horizontal-histogram`. Every expansion is\n * additive — the `apiVersion: 1` script header stays unchanged.\n *\n * Typical Phase-2 consumers:\n *\n * - `histogram` → volume bars, MACD histogram, momentum-style oscillators.\n * - `area` → filled region under a polyline (BB midline, regression).\n * - `filled-band` → Bollinger / Keltner / Donchian / Ichimoku envelopes.\n * - `label` → text annotations at a world-space anchor (fractal, pivot).\n * - `marker` → discrete glyph (circle / triangle / square / diamond) for\n *   fractals / divergence / supertrend flips.\n *\n * @since 0.1\n * @example\n *     const k: PlotKind = \"line\";\n *     const histogram: PlotKind = \"histogram\";\n *     const shape: PlotKind = \"shape\";\n *     void k; void histogram; void shape;\n */\nexport type PlotKind =\n    | \"line\"\n    | \"step-line\"\n    | \"horizontal-line\"\n    | \"histogram\"\n    | \"area\"\n    | \"filled-band\"\n    | \"label\"\n    | \"marker\"\n    | \"shape\"\n    | \"character\"\n    | \"arrow\"\n    | \"candle-override\"\n    | \"bar-override\"\n    | \"bg-color\"\n    | \"bar-color\"\n    | \"horizontal-histogram\";\n\n/**\n * Marker glyphs shared by Phase 2 `marker` and Phase 5 `shape` plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const shape: PlotGlyphShape = \"circle\";\n *     void shape;\n */\nexport type PlotGlyphShape = \"circle\" | \"triangle-up\" | \"triangle-down\" | \"square\" | \"diamond\";\n\n/**\n * Full glyph inventory for Phase 5 `shape` plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const shape: PlotShapeGlyph = \"flag\";\n *     void shape;\n */\nexport type PlotShapeGlyph = PlotGlyphShape | \"cross\" | \"xcross\" | \"flag\";\n\n/**\n * Vertical anchoring mode for glyph-like Phase 5 plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const location: PlotLocation = \"above\";\n *     void location;\n */\nexport type PlotLocation = \"above\" | \"below\" | \"absolute\";\n\n/**\n * Single row in a Phase 5 horizontal-histogram plot emission.\n *\n * @since 0.5\n * @stable\n * @example\n *     const bucket: HorizontalHistogramBucket = { price: 100, volume: 25 };\n *     void bucket;\n */\nexport type HorizontalHistogramBucket = Readonly<{\n    readonly price: number;\n    readonly volume: number;\n    readonly color?: Color;\n}>;\n\n/**\n * Script-author selectable plot style. The runtime maps this to the\n * adapter-kit's wire `PlotStyle` discriminated union and fills in defaults\n * from sibling {@link PlotOpts} fields (`lineWidth` / `lineStyle`) for\n * line-like styles.\n *\n * `histogram.baseline` defaults to `0` when omitted.\n *\n * @formula  N/A — script-facing style input\n * @since 0.2\n * @stable\n * @example\n *     const lineStyle: PlotOptsStyle = { kind: \"line\" };\n *     const histStyle: PlotOptsStyle = { kind: \"histogram\", baseline: 0 };\n *     void lineStyle; void histStyle;\n */\nexport type PlotOptsStyle =\n    | { readonly kind: \"line\" }\n    | { readonly kind: \"step-line\" }\n    | { readonly kind: \"horizontal-line\" }\n    | { readonly kind: \"histogram\"; readonly baseline?: number }\n    | {\n          readonly kind: \"marker\";\n          readonly shape: PlotGlyphShape;\n          readonly size: number;\n      }\n    /**\n     * Glyph at world-anchor — Pine's `plotshape`. Location selects vertical\n     * anchoring; `size` is in CSS pixels.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"shape\", shape: \"triangle-up\", size: 8, location: \"below\" } });\n     */\n    | {\n          readonly kind: \"shape\";\n          readonly shape: PlotShapeGlyph;\n          readonly size: number;\n          readonly location?: PlotLocation;\n      }\n    /**\n     * Text glyph at world-anchor — Pine's `plotchar`. `char` may be any\n     * non-empty UTF-8 string; `size` is in CSS pixels.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"character\", char: \"▲\", size: 12, location: \"above\" } });\n     */\n    | {\n          readonly kind: \"character\";\n          readonly char: string;\n          readonly size: number;\n          readonly location?: PlotLocation;\n      }\n    /**\n     * Directional marker at world-anchor — Pine's `plotarrow`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.low, { style: { kind: \"arrow\", direction: \"up\", size: 10 } });\n     */\n    | { readonly kind: \"arrow\"; readonly direction: \"up\" | \"down\"; readonly size: number }\n    /**\n     * Candle body color override — Pine's `plotcandle`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"candle-override\", bull: \"#26a69a\", bear: \"#ef5350\" } });\n     */\n    | {\n          readonly kind: \"candle-override\";\n          readonly bull: Color;\n          readonly bear: Color;\n          readonly doji?: Color;\n      }\n    /**\n     * OHLC bar outline override — Pine's `plotbar`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bar-override\", color: \"#f59e0b\" } });\n     */\n    | { readonly kind: \"bar-override\"; readonly color: Color }\n    /**\n     * Pane background color band — Pine's `bgcolor`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bg-color\", color: \"#1d4ed8\", transp: 80 } });\n     */\n    | { readonly kind: \"bg-color\"; readonly color: Color; readonly transp?: number }\n    /**\n     * Main candle/bar tint — Pine's `barcolor`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bar-color\", color: \"#a855f7\" } });\n     */\n    | { readonly kind: \"bar-color\"; readonly color: Color }\n    /**\n     * Right-edge volume-profile bars keyed by price bucket.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"horizontal-histogram\", buckets: [{ price: bar.close, volume: bar.volume }] } });\n     */\n    | {\n          readonly kind: \"horizontal-histogram\";\n          readonly buckets: ReadonlyArray<HorizontalHistogramBucket>;\n      };\n\n/**\n * Styling options accepted by `plot(...)`. `pane: \"overlay\"` (the default) is\n * the only pane the Phase-1 canvas2d adapter renders — `\"new\"` and named\n * panes are reserved for Phase 2+. `style` (Phase 2) lets the script pick\n * a non-line {@link PlotOptsStyle} — defaults to `{ kind: \"line\" }`.\n *\n * @since 0.1\n * @example\n *     const opts: PlotOpts = {\n *         color: \"#3b82f6\",\n *         title: \"EMA(20)\",\n *         lineWidth: 2,\n *         lineStyle: \"solid\",\n *         pane: \"overlay\",\n *         style: { kind: \"line\" },\n *     };\n */\nexport type PlotOpts = Readonly<{\n    color?: Color;\n    title?: string;\n    lineWidth?: number;\n    lineStyle?: LineStyle;\n    pane?: \"overlay\" | \"new\" | string;\n    style?: PlotOptsStyle;\n}>;\n\n/**\n * Styling options accepted by `hline(...)`. `pane` follows the same shape as\n * {@link PlotOpts.pane}: omit to fall back to the script's manifest-resolved\n * default (overlay unless `defineIndicator({ overlay: false })` was declared);\n * `\"overlay\"` pins the line to the price pane; `\"new\"` opens / joins the\n * per-script subpane; named panes route to a shared subpane key.\n *\n * @since 0.1\n * @stable\n * @example\n *     const opts: HLineOpts = {\n *         color: \"#ef4444\",\n *         title: \"RSI 70\",\n *         lineStyle: \"dashed\",\n *         pane: \"new\",\n *     };\n */\nexport type HLineOpts = Readonly<{\n    color?: Color;\n    title?: string;\n    lineWidth?: number;\n    lineStyle?: LineStyle;\n    /**\n     * Routes the horizontal line to a pane. Mirrors {@link PlotOpts.pane}:\n     * omit to fall back to the script's manifest-resolved default,\n     * `\"overlay\"` pins to the price pane, `\"new\"` joins the per-script\n     * subpane, and named keys route to a shared subpane (folded to overlay\n     * with `unsupported-pane` on `subPanes: 0` adapters).\n     *\n     * @since 0.2\n     */\n    pane?: \"overlay\" | \"new\" | string;\n}>;\n\n/**\n * Compile-time callable hole for `plot(value, opts?)`. The compiler rewrites\n * every callsite to dispatch to the runtime's `plot` implementation;\n * calling this outside a compiled runtime throws the sentinel.\n *\n * Accepts `number | Series<number>` — scalars emit a single bar value;\n * series emissions pull from `series.current`.\n *\n * @since 0.1\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   plot(bar.close, { color: \"#3b82f6\" });\n *     import { plot } from \"@invinite-org/chartlang-core\";\n *     try { plot(0); } catch {}\n */\nexport function plot(_value: number | Series<number>, _opts?: PlotOpts): void {\n    throw new Error(\"plot called outside compiled runtime\");\n}\n\n/**\n * Compile-time callable hole for `hline(price, opts?)`. Same semantics as\n * `plot` but pinned to a fixed price across all bars.\n *\n * @since 0.1\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   hline(70, { color: \"#ef4444\" });\n *     import { hline } from \"@invinite-org/chartlang-core\";\n *     try { hline(70); } catch {}\n */\nexport function hline(_price: number, _opts?: HLineOpts): void {\n    throw new Error(\"hline called outside compiled runtime\");\n}\n"]}
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/plot/plot.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAgU/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,MAA+B,EAAE,KAAgB;IAClE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,KAAiB;IACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CAAC,MAAa,EAAE,KAAmB;IACtD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAa,EAAE,KAAoB;IACxD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAChE,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 { Color, LineStyle, Series } from \"../types.js\";\n\n/**\n * Rendered-shape discriminator for `plot` emissions reaching the adapter.\n * The full 0.5 inventory is `line`, `step-line`, `horizontal-line`,\n * `histogram`, `area`, `filled-band`, `label`, `marker`,\n * `shape`, `character`, `arrow`, `candle-override`, `bar-override`,\n * `bg-color`, `bar-color`, and `horizontal-histogram`. Every expansion is\n * additive — the `apiVersion: 1` script header stays unchanged.\n *\n * Typical Phase-2 consumers:\n *\n * - `histogram` → volume bars, MACD histogram, momentum-style oscillators.\n * - `area` → filled region under a polyline (BB midline, regression).\n * - `filled-band` → Bollinger / Keltner / Donchian / Ichimoku envelopes.\n * - `label` → text annotations at a world-space anchor (fractal, pivot).\n * - `marker` → discrete glyph (circle / triangle / square / diamond) for\n *   fractals / divergence / supertrend flips.\n *\n * @since 0.1\n * @example\n *     const k: PlotKind = \"line\";\n *     const histogram: PlotKind = \"histogram\";\n *     const shape: PlotKind = \"shape\";\n *     void k; void histogram; void shape;\n */\nexport type PlotKind =\n    | \"line\"\n    | \"step-line\"\n    | \"horizontal-line\"\n    | \"histogram\"\n    | \"area\"\n    | \"filled-band\"\n    | \"label\"\n    | \"marker\"\n    | \"shape\"\n    | \"character\"\n    | \"arrow\"\n    | \"candle-override\"\n    | \"bar-override\"\n    | \"bg-color\"\n    | \"bar-color\"\n    | \"horizontal-histogram\";\n\n/**\n * Marker glyphs shared by Phase 2 `marker` and Phase 5 `shape` plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const shape: PlotGlyphShape = \"circle\";\n *     void shape;\n */\nexport type PlotGlyphShape = \"circle\" | \"triangle-up\" | \"triangle-down\" | \"square\" | \"diamond\";\n\n/**\n * Full glyph inventory for Phase 5 `shape` plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const shape: PlotShapeGlyph = \"flag\";\n *     void shape;\n */\nexport type PlotShapeGlyph = PlotGlyphShape | \"cross\" | \"xcross\" | \"flag\";\n\n/**\n * Vertical anchoring mode for glyph-like Phase 5 plot styles.\n *\n * @since 0.5\n * @stable\n * @example\n *     const location: PlotLocation = \"above\";\n *     void location;\n */\nexport type PlotLocation = \"above\" | \"below\" | \"absolute\";\n\n/**\n * Single row in a Phase 5 horizontal-histogram plot emission.\n *\n * @since 0.5\n * @stable\n * @example\n *     const bucket: HorizontalHistogramBucket = { price: 100, volume: 25 };\n *     void bucket;\n */\nexport type HorizontalHistogramBucket = Readonly<{\n    readonly price: number;\n    readonly volume: number;\n    readonly color?: Color;\n}>;\n\n/**\n * Script-author selectable plot style. The runtime maps this to the\n * adapter-kit's wire `PlotStyle` discriminated union and fills in defaults\n * from sibling {@link PlotOpts} fields (`lineWidth` / `lineStyle`) for\n * line-like styles.\n *\n * `histogram.baseline` defaults to `0` when omitted.\n *\n * @formula  N/A — script-facing style input\n * @since 0.2\n * @stable\n * @example\n *     const lineStyle: PlotOptsStyle = { kind: \"line\" };\n *     const histStyle: PlotOptsStyle = { kind: \"histogram\", baseline: 0 };\n *     void lineStyle; void histStyle;\n */\nexport type PlotOptsStyle =\n    | { readonly kind: \"line\" }\n    | { readonly kind: \"step-line\" }\n    | { readonly kind: \"horizontal-line\" }\n    | { readonly kind: \"histogram\"; readonly baseline?: number }\n    | {\n          readonly kind: \"marker\";\n          readonly shape: PlotGlyphShape;\n          readonly size: number;\n      }\n    /**\n     * Glyph at world-anchor — Pine's `plotshape`. Location selects vertical\n     * anchoring; `size` is in CSS pixels.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"shape\", shape: \"triangle-up\", size: 8, location: \"below\" } });\n     */\n    | {\n          readonly kind: \"shape\";\n          readonly shape: PlotShapeGlyph;\n          readonly size: number;\n          readonly location?: PlotLocation;\n      }\n    /**\n     * Text glyph at world-anchor — Pine's `plotchar`. `char` may be any\n     * non-empty UTF-8 string; `size` is in CSS pixels.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"character\", char: \"▲\", size: 12, location: \"above\" } });\n     */\n    | {\n          readonly kind: \"character\";\n          readonly char: string;\n          readonly size: number;\n          readonly location?: PlotLocation;\n      }\n    /**\n     * Directional marker at world-anchor — Pine's `plotarrow`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.low, { style: { kind: \"arrow\", direction: \"up\", size: 10 } });\n     */\n    | { readonly kind: \"arrow\"; readonly direction: \"up\" | \"down\"; readonly size: number }\n    /**\n     * Candle body color override — Pine's `plotcandle`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"candle-override\", bull: \"#26a69a\", bear: \"#ef5350\" } });\n     */\n    | {\n          readonly kind: \"candle-override\";\n          readonly bull: Color;\n          readonly bear: Color;\n          readonly doji?: Color;\n      }\n    /**\n     * OHLC bar outline override — Pine's `plotbar`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bar-override\", color: \"#f59e0b\" } });\n     */\n    | { readonly kind: \"bar-override\"; readonly color: Color }\n    /**\n     * Pane background color band — Pine's `bgcolor`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bg-color\", color: \"#1d4ed8\", transp: 80 } });\n     */\n    | { readonly kind: \"bg-color\"; readonly color: Color; readonly transp?: number }\n    /**\n     * Main candle/bar tint — Pine's `barcolor`.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"bar-color\", color: \"#a855f7\" } });\n     */\n    | { readonly kind: \"bar-color\"; readonly color: Color }\n    /**\n     * Right-edge volume-profile bars keyed by price bucket.\n     *\n     * @since 0.5\n     * @stable\n     * @example\n     *     plot(bar.close, { style: { kind: \"horizontal-histogram\", buckets: [{ price: bar.close, volume: bar.volume }] } });\n     */\n    | {\n          readonly kind: \"horizontal-histogram\";\n          readonly buckets: ReadonlyArray<HorizontalHistogramBucket>;\n      };\n\n/**\n * Styling options accepted by `plot(...)`. `pane: \"overlay\"` (the default) is\n * the only pane the Phase-1 canvas2d adapter renders — `\"new\"` and named\n * panes are reserved for Phase 2+. `style` (Phase 2) lets the script pick\n * a non-line {@link PlotOptsStyle} — defaults to `{ kind: \"line\" }`.\n *\n * @since 0.1\n * @example\n *     const opts: PlotOpts = {\n *         color: \"#3b82f6\",\n *         title: \"EMA(20)\",\n *         lineWidth: 2,\n *         lineStyle: \"solid\",\n *         pane: \"overlay\",\n *         style: { kind: \"line\" },\n *     };\n */\nexport type PlotOpts = Readonly<{\n    color?: Color;\n    title?: string;\n    lineWidth?: number;\n    lineStyle?: LineStyle;\n    pane?: \"overlay\" | \"new\" | string;\n    style?: PlotOptsStyle;\n    /**\n     * Presentation-only render-order key (z-index). Default `0`.\n     * Higher `z` renders on top; lower `z` renders behind. Marks with\n     * equal `z` keep the default group order (plots below drawings) and,\n     * within a group, declaration order. `z` may be any finite number —\n     * fractional values (e.g. `1.5`) slot a mark between two layers\n     * without renumbering. It affects **only** stacking: `value`,\n     * alerts, and `state.*` are unaffected.\n     *\n     * @since 1.4\n     * @stable\n     * @example\n     *     plot(ta.sma(bar.close, 50), { z: -1 }); // behind other plots\n     */\n    z?: number;\n}>;\n\n/**\n * Styling options accepted by `hline(...)`. `pane` follows the same shape as\n * {@link PlotOpts.pane}: omit to fall back to the script's manifest-resolved\n * default (overlay unless `defineIndicator({ overlay: false })` was declared);\n * `\"overlay\"` pins the line to the price pane; `\"new\"` opens / joins the\n * per-script subpane; named panes route to a shared subpane key.\n *\n * @since 0.1\n * @stable\n * @example\n *     const opts: HLineOpts = {\n *         color: \"#ef4444\",\n *         title: \"RSI 70\",\n *         lineStyle: \"dashed\",\n *         pane: \"new\",\n *     };\n */\nexport type HLineOpts = Readonly<{\n    color?: Color;\n    title?: string;\n    lineWidth?: number;\n    lineStyle?: LineStyle;\n    /**\n     * Routes the horizontal line to a pane. Mirrors {@link PlotOpts.pane}:\n     * omit to fall back to the script's manifest-resolved default,\n     * `\"overlay\"` pins to the price pane, `\"new\"` joins the per-script\n     * subpane, and named keys route to a shared subpane (folded to overlay\n     * with `unsupported-pane` on `subPanes: 0` adapters).\n     *\n     * @since 0.2\n     */\n    pane?: \"overlay\" | \"new\" | string;\n}>;\n\n/**\n * Styling options accepted by `bgcolor(...)` — the Pine-ergonomic alias for\n * a `bg-color` pane-background band. `transp` is the 0–100 transparency\n * (0 opaque … 100 fully transparent), mirroring {@link PlotOptsStyle}'s\n * `bg-color` arm. `title` labels the slot for host overrides.\n *\n * @since 1.4\n * @stable\n * @example\n *     const opts: BgColorOpts = { transp: 80, title: \"RSI heat\" };\n *     void opts;\n */\nexport type BgColorOpts = Readonly<{\n    transp?: number;\n    title?: string;\n}>;\n\n/**\n * Styling options accepted by `barcolor(...)` — the Pine-ergonomic alias for\n * a `bar-color` candle/bar tint. The `bar-color` style carries no\n * transparency, so this bag only labels the slot.\n *\n * @since 1.4\n * @stable\n * @example\n *     const opts: BarColorOpts = { title: \"trend tint\" };\n *     void opts;\n */\nexport type BarColorOpts = Readonly<{\n    title?: string;\n}>;\n\n/**\n * Compile-time callable hole for `plot(value, opts?)`. The compiler rewrites\n * every callsite to dispatch to the runtime's `plot` implementation;\n * calling this outside a compiled runtime throws the sentinel.\n *\n * Accepts `number | Series<number>` — scalars emit a single bar value;\n * series emissions pull from `series.current`.\n *\n * @since 0.1\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   plot(bar.close, { color: \"#3b82f6\" });\n *     import { plot } from \"@invinite-org/chartlang-core\";\n *     try { plot(0); } catch {}\n */\nexport function plot(_value: number | Series<number>, _opts?: PlotOpts): void {\n    throw new Error(\"plot called outside compiled runtime\");\n}\n\n/**\n * Compile-time callable hole for `hline(price, opts?)`. Same semantics as\n * `plot` but pinned to a fixed price across all bars.\n *\n * @since 0.1\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   hline(70, { color: \"#ef4444\" });\n *     import { hline } from \"@invinite-org/chartlang-core\";\n *     try { hline(70); } catch {}\n */\nexport function hline(_price: number, _opts?: HLineOpts): void {\n    throw new Error(\"hline called outside compiled runtime\");\n}\n\n/**\n * Paint the pane background for the current bar — the Pine-ergonomic alias\n * for `plot(NaN, { style: { kind: \"bg-color\", color, transp } })`. Pass a\n * `Color` (a CSS / hex string, or a per-bar color expression like\n * `close > open ? \"#16a34a\" : \"#dc2626\"`). Sugar over the existing\n * `bg-color` plot style — same wire emission, same capability gate.\n *\n * @since 1.4\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   bgcolor(bar.close > bar.open ? \"#16a34a\" : \"#dc2626\", { transp: 80 });\n *     import { bgcolor } from \"@invinite-org/chartlang-core\";\n *     try { bgcolor(\"#1d4ed8\"); } catch {}\n */\nexport function bgcolor(_color: Color, _opts?: BgColorOpts): void {\n    throw new Error(\"bgcolor called outside compiled runtime\");\n}\n\n/**\n * Tint the candle / bar for the current bar — the Pine-ergonomic alias for\n * `plot(NaN, { style: { kind: \"bar-color\", color } })`. Sugar over the\n * existing `bar-color` plot style.\n *\n * @since 1.4\n * @stable\n * @example\n *     // Inside a compiled `compute`:\n *     //   barcolor(bar.close > bar.open ? \"#16a34a\" : \"#dc2626\");\n *     import { barcolor } from \"@invinite-org/chartlang-core\";\n *     try { barcolor(\"#a855f7\"); } catch {}\n */\nexport function barcolor(_color: Color, _opts?: BarColorOpts): void {\n    throw new Error(\"barcolor called outside compiled runtime\");\n}\n"]}

package/dist/request/feedKey.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Build the composite secondary-feed key from a `(symbol, interval)` pair —
+ * the **single** source of the stream-key format shared by the runtime's
+ * stream/cache maps and the host wire (`CandleEvent.streamKey`). Like a slot
+ * id, this string is load-bearing: producer (adapter/host) and consumer
+ * (runtime) must agree byte-for-byte, so never re-derive it inline.
+ *
+ * An **omitted** symbol (the chart's own symbol / higher-timeframe-only case)
+ * encodes to the bare interval — `feedKey(undefined, "1D") === "1D"` — so the
+ * symbol-omitted wire and every key stay byte-identical to the pre-multi-symbol
+ * baseline. A present symbol encodes as `"<symbol>@<interval>"`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     feedKey(undefined, "1D"); // "1D"  (chart symbol, back-compat)
+ *     feedKey("AMEX:SPY", "1D"); // "AMEX:SPY@1D"
+ */
+export declare function feedKey(symbol: string | undefined, interval: string): string;
+//# sourceMappingURL=feedKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedKey.d.ts","sourceRoot":"","sources":["../../src/request/feedKey.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5E"}

package/dist/request/feedKey.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Build the composite secondary-feed key from a `(symbol, interval)` pair —
+ * the **single** source of the stream-key format shared by the runtime's
+ * stream/cache maps and the host wire (`CandleEvent.streamKey`). Like a slot
+ * id, this string is load-bearing: producer (adapter/host) and consumer
+ * (runtime) must agree byte-for-byte, so never re-derive it inline.
+ *
+ * An **omitted** symbol (the chart's own symbol / higher-timeframe-only case)
+ * encodes to the bare interval — `feedKey(undefined, "1D") === "1D"` — so the
+ * symbol-omitted wire and every key stay byte-identical to the pre-multi-symbol
+ * baseline. A present symbol encodes as `"<symbol>@<interval>"`.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     feedKey(undefined, "1D"); // "1D"  (chart symbol, back-compat)
+ *     feedKey("AMEX:SPY", "1D"); // "AMEX:SPY@1D"
+ */
+export function feedKey(symbol, interval) {
+    // The `@` separator is not a valid character in a chartlang interval
+    // literal (`/^\d+[smhdwM]$/`), so a `"<symbol>@<interval>"` key can never
+    // collide with a bare-interval (chart-symbol) key. An empty/undefined
+    // symbol collapsing to the bare interval is what gives the omitted-symbol
+    // path byte-identical keys + wire to the pre-multi-symbol baseline.
+    return symbol === undefined || symbol === "" ? interval : `${symbol}@${interval}`;
+}
+//# sourceMappingURL=feedKey.js.map

package/dist/request/feedKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedKey.js","sourceRoot":"","sources":["../../src/request/feedKey.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0B,EAAE,QAAgB;IAChE,qEAAqE;IACrE,0EAA0E;IAC1E,sEAAsE;IACtE,0EAA0E;IAC1E,oEAAoE;IACpE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;AACtF,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\n/**\n * Build the composite secondary-feed key from a `(symbol, interval)` pair —\n * the **single** source of the stream-key format shared by the runtime's\n * stream/cache maps and the host wire (`CandleEvent.streamKey`). Like a slot\n * id, this string is load-bearing: producer (adapter/host) and consumer\n * (runtime) must agree byte-for-byte, so never re-derive it inline.\n *\n * An **omitted** symbol (the chart's own symbol / higher-timeframe-only case)\n * encodes to the bare interval — `feedKey(undefined, \"1D\") === \"1D\"` — so the\n * symbol-omitted wire and every key stay byte-identical to the pre-multi-symbol\n * baseline. A present symbol encodes as `\"<symbol>@<interval>\"`.\n *\n * @since 1.3\n * @stable\n * @example\n *     feedKey(undefined, \"1D\"); // \"1D\"  (chart symbol, back-compat)\n *     feedKey(\"AMEX:SPY\", \"1D\"); // \"AMEX:SPY@1D\"\n */\nexport function feedKey(symbol: string | undefined, interval: string): string {\n    // The `@` separator is not a valid character in a chartlang interval\n    // literal (`/^\\d+[smhdwM]$/`), so a `\"<symbol>@<interval>\"` key can never\n    // collide with a bare-interval (chart-symbol) key. An empty/undefined\n    // symbol collapsing to the bare interval is what gives the omitted-symbol\n    // path byte-identical keys + wire to the pre-multi-symbol baseline.\n    return symbol === undefined || symbol === \"\" ? interval : `${symbol}@${interval}`;\n}\n"]}

package/dist/request/index.d.ts

@@ -1,2 +1,4 @@
-export { request, type RequestNamespace, type RequestLowerTfOpts, type RequestSecurityOpts, type SecurityBar, } from "./request.js";
+export { request, type RequestNamespace, type RequestLowerTfOpts, type RequestSecurityOpts, type SecurityBar, type SecurityExpr, } from "./request.js";
+export { feedKey } from "./feedKey.js";
+export type { RequestedFeed } from "../types.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,EACH,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACnB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/request/index.js

@@ -1,4 +1,5 @@
 // Copyright (c) 2026 Invinite. Licensed under the MIT License.
 // See the LICENSE file in the repo root for full license text.
 export { request, } from "./request.js";
+export { feedKey } from "./feedKey.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,EACH,OAAO,GAKV,MAAM,cAAc,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 {\n    request,\n    type RequestNamespace,\n    type RequestLowerTfOpts,\n    type RequestSecurityOpts,\n    type SecurityBar,\n} from \"./request.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,EACH,OAAO,GAMV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,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 {\n    request,\n    type RequestNamespace,\n    type RequestLowerTfOpts,\n    type RequestSecurityOpts,\n    type SecurityBar,\n    type SecurityExpr,\n} from \"./request.js\";\nexport { feedKey } from \"./feedKey.js\";\nexport type { RequestedFeed } from \"../types.js\";\n"]}

package/dist/request/request.d.ts

@@ -9,8 +9,24 @@ import type { Bar, Price, Series, Time, Volume } from "../types.js";
  * @example
  *     const opts: RequestSecurityOpts = { interval: "1D" };
  *     void opts;
+ * @example
+ *     // read a different instrument (requires Capabilities.multiSymbol)
+ *     const spy: RequestSecurityOpts = { symbol: "AMEX:SPY", interval: "1D" };
+ *     void spy;
  */
 export type RequestSecurityOpts = Readonly<{
+    /**
+     * The instrument to read. Omit for the chart's own symbol (the existing
+     * behavior). Must be a compile-time literal — a string literal, an
+     * `input.symbol` default, or an `input.enum` value; the compiler's
+     * literal-only pass rejects a dynamic expression with
+     * `request-security-symbol-not-literal`. A non-chart symbol additionally
+     * requires `Capabilities.multiSymbol`; otherwise the series degrades to
+     * all-NaN.
+     *
+     * @since 1.2
+     */
+    readonly symbol?: string;
     readonly interval: string;
 }>;
 /**
@@ -58,6 +74,94 @@ export type SecurityBar = Readonly<{
     readonly symbol: Series<string>;
     readonly interval: Series<string>;
 }>;
+/**
+ * A higher-timeframe expression callback for {@link RequestNamespace.security}.
+ * Receives the HTF {@link SecurityBar} (OHLCV series on the secondary
+ * stream's own clock) and returns the value to evaluate per HTF bar.
+ * The body may reference only the `bar` parameter, the ambient `ta`
+ * namespace, `inputs`, safe `Math.*` globals, and literal constants —
+ * capturing any other outer binding is a compile error
+ * (`request-security-expr-captures-local`).
+ *
+ * Returning a `Series<number>` (e.g. `(bar) => ta.ema(bar.close, 20)`)
+ * lets `ta.*` accumulate over HTF bars; returning a bare `number`
+ * (e.g. `(bar) => bar.close.current * 2`) samples the scalar once per
+ * HTF bar. Either way the result aligns no-lookahead to the main timeline.
+ *
+ * @since 0.7
+ * @stable
+ * @example
+ *     const trend: SecurityExpr = (bar) => bar.close;
+ *     void trend;
+ */
+export type SecurityExpr = (bar: SecurityBar) => Series<number> | number;
+/**
+ * Read a secondary candle stream at a script-author-fixed **higher**
+ * interval. Two forms:
+ *
+ * - **Data**: `request.security({ interval })` → a `SecurityBar`.
+ *   Every OHLCV field — plus the derived `hl2` / `hlc3` / `ohlc4` /
+ *   `hlcc4` and `symbol` / `interval` — is a `Series<...>` aligned
+ *   no-lookahead to the chart's bars, so a script can read prior secondary
+ *   values such as `weekly.close[5]`.
+ * - **Expression**: `request.security({ interval }, (bar) => …)` →
+ *   `Series<number>`. The callback runs **on the higher-timeframe clock**
+ *   (once per HTF bar), so `ta.*` inside it accumulate over HTF bars; the
+ *   result is aligned no-lookahead down to the main timeline. This is the
+ *   only correct way to get a "weekly EMA(20)" — the data form's series is
+ *   clocked to the main timeline, so `ta.ema(weekly.close, 20)` would
+ *   average 20 *main* bars.
+ *
+ * Both `symbol` and `interval` must be compile-time literals (a string
+ * literal, an `input.symbol` default, or an `input.enum` value); the compiler
+ * walks every call to populate `manifest.requestedFeeds` (and the main-symbol
+ * projection `manifest.requestedIntervals`). `symbol` is **optional** —
+ * omitting it reads the chart's own symbol (the higher-timeframe-only case).
+ * When the adapter does not advertise `Capabilities.multiTimeframe`, the
+ * series degrades to all-NaN rather than erroring; a non-chart `symbol`
+ * additionally requires `Capabilities.multiSymbol` and otherwise degrades to
+ * all-NaN. See the multi-timeframe guide for alignment and interval-format
+ * details.
+ *
+ * @since 0.4
+ * @stable
+ * @example
+ *     // weekly EMA(20) — computed over weekly bars, drawn on the chart
+ *     const trend = request.security({ interval: "1W" }, (bar) => ta.ema(bar.close, 20));
+ *     plot(trend, { title: "Weekly EMA(20)" });
+ * @example
+ *     // data form — aligned weekly close
+ *     const weekly = request.security({ interval: "1W" });
+ *     plot(weekly.close, { title: "Weekly close" });
+ * @example
+ *     // different symbol — a ratio against another instrument (needs multiSymbol)
+ *     const spy = request.security({ symbol: "AMEX:SPY", interval: "1D" });
+ *     const qqq = request.security({ symbol: "NASDAQ:QQQ", interval: "1D" });
+ *     plot(spy.close.current / qqq.close.current, { title: "SPY/QQQ" });
+ */
+declare function security(opts: RequestSecurityOpts): SecurityBar;
+declare function security(opts: RequestSecurityOpts, expr: SecurityExpr): Series<number>;
+/**
+ * Read **lower**-timeframe bars contained by each main-stream bar. The
+ * result is a `Series<ReadonlyArray<Bar>>` — for every main bar, the array
+ * of finer-grained bars that fall inside it (an empty frozen array for
+ * out-of-range or unsupported reads). The requested `interval` must be a
+ * compile-time literal and **strictly lower** than the chart interval; an
+ * equal-or-higher ordering is rejected at compile time with
+ * `lower-tf-not-lower` when statically known. Like `request.security`, it
+ * degrades to empty arrays when the adapter lacks
+ * `Capabilities.multiTimeframe`. See the multi-timeframe guide for the
+ * contained-bar model and interval format.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     // Each main bar carries the array of intrabar 30-second candles.
+ *     const intrabar = request.lowerTf({ interval: "30s" });
+ *     const count = intrabar.current.length;
+ *     void count;
+ */
+declare function lowerTf(_opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>>;
 /**
  * `request.*` namespace for secondary timeframe reads. The compiler walks
  * `request.security(...)` calls to populate `manifest.requestedIntervals`;
@@ -71,26 +175,8 @@ export type SecurityBar = Readonly<{
  *     void ns;
  */
 export declare const request: Readonly<{
-    /**
-     * Read a secondary candle stream at a script-author-fixed interval.
-     *
-     * @since 0.4
-     * @stable
-     * @example
-     *     const fn: typeof request.security = request.security;
-     *     void fn;
-     */
-    security(_opts: RequestSecurityOpts): SecurityBar;
-    /**
-     * Read lower-timeframe bars contained by each main-stream bar.
-     *
-     * @since 0.6
-     * @stable
-     * @example
-     *     const fn: typeof request.lowerTf = request.lowerTf;
-     *     void fn;
-     */
-    lowerTf(_opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>>;
+    security: typeof security;
+    lowerTf: typeof lowerTf;
 }>;
 /**
  * Static type of the `request` namespace. Runtime implementations satisfy
@@ -103,4 +189,5 @@ export declare const request: Readonly<{
  *     void ns;
  */
 export type RequestNamespace = typeof request;
+export {};
 //# sourceMappingURL=request.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC,CAAC;AAMH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;OAQG;oBACa,mBAAmB,GAAG,WAAW;IAGjD;;;;;;;;OAQG;mBACY,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;EAGhE,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,OAAO,CAAC"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAMzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAAC;AAC1D,iBAAS,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAKjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO;;;EAAuC,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,OAAO,CAAC"}

package/dist/request/request.js

@@ -3,6 +3,32 @@
 const sentinel = (name) => {
     throw new Error(`${name} called outside an active script step`);
 };
+function security(_opts, _expr) {
+    return sentinel("request.security");
+}
+/**
+ * Read **lower**-timeframe bars contained by each main-stream bar. The
+ * result is a `Series<ReadonlyArray<Bar>>` — for every main bar, the array
+ * of finer-grained bars that fall inside it (an empty frozen array for
+ * out-of-range or unsupported reads). The requested `interval` must be a
+ * compile-time literal and **strictly lower** than the chart interval; an
+ * equal-or-higher ordering is rejected at compile time with
+ * `lower-tf-not-lower` when statically known. Like `request.security`, it
+ * degrades to empty arrays when the adapter lacks
+ * `Capabilities.multiTimeframe`. See the multi-timeframe guide for the
+ * contained-bar model and interval format.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     // Each main bar carries the array of intrabar 30-second candles.
+ *     const intrabar = request.lowerTf({ interval: "30s" });
+ *     const count = intrabar.current.length;
+ *     void count;
+ */
+function lowerTf(_opts) {
+    return sentinel("request.lowerTf");
+}
 /**
  * `request.*` namespace for secondary timeframe reads. The compiler walks
  * `request.security(...)` calls to populate `manifest.requestedIntervals`;
@@ -15,30 +41,5 @@ const sentinel = (name) => {
  *     const ns: typeof request = request;
  *     void ns;
  */
-export const request = Object.freeze({
-    /**
-     * Read a secondary candle stream at a script-author-fixed interval.
-     *
-     * @since 0.4
-     * @stable
-     * @example
-     *     const fn: typeof request.security = request.security;
-     *     void fn;
-     */
-    security(_opts) {
-        return sentinel("request.security");
-    },
-    /**
-     * Read lower-timeframe bars contained by each main-stream bar.
-     *
-     * @since 0.6
-     * @stable
-     * @example
-     *     const fn: typeof request.lowerTf = request.lowerTf;
-     *     void fn;
-     */
-    lowerTf(_opts) {
-        return sentinel("request.lowerTf");
-    },
-});
+export const request = Object.freeze({ security, lowerTf });
 //# sourceMappingURL=request.js.map

package/dist/request/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAkE/D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAS,EAAE;IACrC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAA0B;QAC/B,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACxC,CAAC;IACD;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAyB;QAC7B,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACJ,CAAC,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 { Bar, Price, Series, Time, Volume } from \"../types.js\";\n\n/**\n * Argument to {@link request.security}. The `interval` must be a string\n * literal or an `input.enum` value; the compiler's literal-only pass rejects\n * dynamic expressions with `request-security-interval-not-literal`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const opts: RequestSecurityOpts = { interval: \"1D\" };\n *     void opts;\n */\nexport type RequestSecurityOpts = Readonly<{\n    readonly interval: string;\n}>;\n\n/**\n * Argument to {@link request.lowerTf}. The `interval` must be strictly lower\n * than the script's main interval; invalid orderings are rejected by the\n * compiler's `lower-tf-not-lower` diagnostic when statically known.\n *\n * @since 0.6\n * @stable\n * @example\n *     const opts: RequestLowerTfOpts = { interval: \"30s\" };\n *     void opts;\n */\nexport type RequestLowerTfOpts = Readonly<{\n    readonly interval: string;\n}>;\n\n/**\n * Secondary-stream bar returned by {@link request.security}. Each field is a\n * `Series<...>` aligned from the runtime's secondary-stream ring buffer to\n * the current main stream, or by the all-NaN fallback when\n * `Capabilities.multiTimeframe` is `false`, the interval is unsupported, or\n * the host fails to register the secondary stream.\n *\n * This is intentionally a series-shaped view rather than the scalar\n * {@link Bar} shape so scripts can read historical secondary values aligned\n * to main bars, such as `daily.close[5]`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const close: SecurityBar[\"close\"] = { current: 1, length: 1 };\n *     void close;\n */\nexport type SecurityBar = Readonly<{\n    readonly time: Series<Time>;\n    readonly open: Series<Price>;\n    readonly high: Series<Price>;\n    readonly low: Series<Price>;\n    readonly close: Series<Price>;\n    readonly volume: Series<Volume>;\n    readonly hl2: Series<Price>;\n    readonly hlc3: Series<Price>;\n    readonly ohlc4: Series<Price>;\n    readonly hlcc4: Series<Price>;\n    readonly symbol: Series<string>;\n    readonly interval: Series<string>;\n}>;\n\nconst sentinel = (name: string): never => {\n    throw new Error(`${name} called outside an active script step`);\n};\n\n/**\n * `request.*` namespace for secondary timeframe reads. The compiler walks\n * `request.security(...)` calls to populate `manifest.requestedIntervals`;\n * the runtime replaces this callable hole with a slot-aware implementation\n * through `ComputeContext.request`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns: typeof request = request;\n *     void ns;\n */\nexport const request = Object.freeze({\n    /**\n     * Read a secondary candle stream at a script-author-fixed interval.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const fn: typeof request.security = request.security;\n     *     void fn;\n     */\n    security(_opts: RequestSecurityOpts): SecurityBar {\n        return sentinel(\"request.security\");\n    },\n    /**\n     * Read lower-timeframe bars contained by each main-stream bar.\n     *\n     * @since 0.6\n     * @stable\n     * @example\n     *     const fn: typeof request.lowerTf = request.lowerTf;\n     *     void fn;\n     */\n    lowerTf(_opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>> {\n        return sentinel(\"request.lowerTf\");\n    },\n});\n\n/**\n * Static type of the `request` namespace. Runtime implementations satisfy\n * this shape structurally when installed on `ComputeContext.request`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns: RequestNamespace = request;\n *     void ns;\n */\nexport type RequestNamespace = typeof request;\n"]}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAwG/D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAS,EAAE;IACrC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;AACpE,CAAC,CAAC;AAgDF,SAAS,QAAQ,CAAC,KAA0B,EAAE,KAAoB;IAC9D,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,OAAO,CAAC,KAAyB;IACtC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,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 { Bar, Price, Series, Time, Volume } from \"../types.js\";\n\n/**\n * Argument to {@link request.security}. The `interval` must be a string\n * literal or an `input.enum` value; the compiler's literal-only pass rejects\n * dynamic expressions with `request-security-interval-not-literal`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const opts: RequestSecurityOpts = { interval: \"1D\" };\n *     void opts;\n * @example\n *     // read a different instrument (requires Capabilities.multiSymbol)\n *     const spy: RequestSecurityOpts = { symbol: \"AMEX:SPY\", interval: \"1D\" };\n *     void spy;\n */\nexport type RequestSecurityOpts = Readonly<{\n    /**\n     * The instrument to read. Omit for the chart's own symbol (the existing\n     * behavior). Must be a compile-time literal — a string literal, an\n     * `input.symbol` default, or an `input.enum` value; the compiler's\n     * literal-only pass rejects a dynamic expression with\n     * `request-security-symbol-not-literal`. A non-chart symbol additionally\n     * requires `Capabilities.multiSymbol`; otherwise the series degrades to\n     * all-NaN.\n     *\n     * @since 1.2\n     */\n    readonly symbol?: string;\n    readonly interval: string;\n}>;\n\n/**\n * Argument to {@link request.lowerTf}. The `interval` must be strictly lower\n * than the script's main interval; invalid orderings are rejected by the\n * compiler's `lower-tf-not-lower` diagnostic when statically known.\n *\n * @since 0.6\n * @stable\n * @example\n *     const opts: RequestLowerTfOpts = { interval: \"30s\" };\n *     void opts;\n */\nexport type RequestLowerTfOpts = Readonly<{\n    readonly interval: string;\n}>;\n\n/**\n * Secondary-stream bar returned by {@link request.security}. Each field is a\n * `Series<...>` aligned from the runtime's secondary-stream ring buffer to\n * the current main stream, or by the all-NaN fallback when\n * `Capabilities.multiTimeframe` is `false`, the interval is unsupported, or\n * the host fails to register the secondary stream.\n *\n * This is intentionally a series-shaped view rather than the scalar\n * {@link Bar} shape so scripts can read historical secondary values aligned\n * to main bars, such as `daily.close[5]`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const close: SecurityBar[\"close\"] = { current: 1, length: 1 };\n *     void close;\n */\nexport type SecurityBar = Readonly<{\n    readonly time: Series<Time>;\n    readonly open: Series<Price>;\n    readonly high: Series<Price>;\n    readonly low: Series<Price>;\n    readonly close: Series<Price>;\n    readonly volume: Series<Volume>;\n    readonly hl2: Series<Price>;\n    readonly hlc3: Series<Price>;\n    readonly ohlc4: Series<Price>;\n    readonly hlcc4: Series<Price>;\n    readonly symbol: Series<string>;\n    readonly interval: Series<string>;\n}>;\n\n/**\n * A higher-timeframe expression callback for {@link RequestNamespace.security}.\n * Receives the HTF {@link SecurityBar} (OHLCV series on the secondary\n * stream's own clock) and returns the value to evaluate per HTF bar.\n * The body may reference only the `bar` parameter, the ambient `ta`\n * namespace, `inputs`, safe `Math.*` globals, and literal constants —\n * capturing any other outer binding is a compile error\n * (`request-security-expr-captures-local`).\n *\n * Returning a `Series<number>` (e.g. `(bar) => ta.ema(bar.close, 20)`)\n * lets `ta.*` accumulate over HTF bars; returning a bare `number`\n * (e.g. `(bar) => bar.close.current * 2`) samples the scalar once per\n * HTF bar. Either way the result aligns no-lookahead to the main timeline.\n *\n * @since 0.7\n * @stable\n * @example\n *     const trend: SecurityExpr = (bar) => bar.close;\n *     void trend;\n */\nexport type SecurityExpr = (bar: SecurityBar) => Series<number> | number;\n\nconst sentinel = (name: string): never => {\n    throw new Error(`${name} called outside an active script step`);\n};\n\n/**\n * Read a secondary candle stream at a script-author-fixed **higher**\n * interval. Two forms:\n *\n * - **Data**: `request.security({ interval })` → a `SecurityBar`.\n *   Every OHLCV field — plus the derived `hl2` / `hlc3` / `ohlc4` /\n *   `hlcc4` and `symbol` / `interval` — is a `Series<...>` aligned\n *   no-lookahead to the chart's bars, so a script can read prior secondary\n *   values such as `weekly.close[5]`.\n * - **Expression**: `request.security({ interval }, (bar) => …)` →\n *   `Series<number>`. The callback runs **on the higher-timeframe clock**\n *   (once per HTF bar), so `ta.*` inside it accumulate over HTF bars; the\n *   result is aligned no-lookahead down to the main timeline. This is the\n *   only correct way to get a \"weekly EMA(20)\" — the data form's series is\n *   clocked to the main timeline, so `ta.ema(weekly.close, 20)` would\n *   average 20 *main* bars.\n *\n * Both `symbol` and `interval` must be compile-time literals (a string\n * literal, an `input.symbol` default, or an `input.enum` value); the compiler\n * walks every call to populate `manifest.requestedFeeds` (and the main-symbol\n * projection `manifest.requestedIntervals`). `symbol` is **optional** —\n * omitting it reads the chart's own symbol (the higher-timeframe-only case).\n * When the adapter does not advertise `Capabilities.multiTimeframe`, the\n * series degrades to all-NaN rather than erroring; a non-chart `symbol`\n * additionally requires `Capabilities.multiSymbol` and otherwise degrades to\n * all-NaN. See the multi-timeframe guide for alignment and interval-format\n * details.\n *\n * @since 0.4\n * @stable\n * @example\n *     // weekly EMA(20) — computed over weekly bars, drawn on the chart\n *     const trend = request.security({ interval: \"1W\" }, (bar) => ta.ema(bar.close, 20));\n *     plot(trend, { title: \"Weekly EMA(20)\" });\n * @example\n *     // data form — aligned weekly close\n *     const weekly = request.security({ interval: \"1W\" });\n *     plot(weekly.close, { title: \"Weekly close\" });\n * @example\n *     // different symbol — a ratio against another instrument (needs multiSymbol)\n *     const spy = request.security({ symbol: \"AMEX:SPY\", interval: \"1D\" });\n *     const qqq = request.security({ symbol: \"NASDAQ:QQQ\", interval: \"1D\" });\n *     plot(spy.close.current / qqq.close.current, { title: \"SPY/QQQ\" });\n */\nfunction security(opts: RequestSecurityOpts): SecurityBar;\nfunction security(opts: RequestSecurityOpts, expr: SecurityExpr): Series<number>;\nfunction security(_opts: RequestSecurityOpts, _expr?: SecurityExpr): SecurityBar | Series<number> {\n    return sentinel(\"request.security\");\n}\n\n/**\n * Read **lower**-timeframe bars contained by each main-stream bar. The\n * result is a `Series<ReadonlyArray<Bar>>` — for every main bar, the array\n * of finer-grained bars that fall inside it (an empty frozen array for\n * out-of-range or unsupported reads). The requested `interval` must be a\n * compile-time literal and **strictly lower** than the chart interval; an\n * equal-or-higher ordering is rejected at compile time with\n * `lower-tf-not-lower` when statically known. Like `request.security`, it\n * degrades to empty arrays when the adapter lacks\n * `Capabilities.multiTimeframe`. See the multi-timeframe guide for the\n * contained-bar model and interval format.\n *\n * @since 0.6\n * @stable\n * @example\n *     // Each main bar carries the array of intrabar 30-second candles.\n *     const intrabar = request.lowerTf({ interval: \"30s\" });\n *     const count = intrabar.current.length;\n *     void count;\n */\nfunction lowerTf(_opts: RequestLowerTfOpts): Series<ReadonlyArray<Bar>> {\n    return sentinel(\"request.lowerTf\");\n}\n\n/**\n * `request.*` namespace for secondary timeframe reads. The compiler walks\n * `request.security(...)` calls to populate `manifest.requestedIntervals`;\n * the runtime replaces this callable hole with a slot-aware implementation\n * through `ComputeContext.request`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns: typeof request = request;\n *     void ns;\n */\nexport const request = Object.freeze({ security, lowerTf });\n\n/**\n * Static type of the `request` namespace. Runtime implementations satisfy\n * this shape structurally when installed on `ComputeContext.request`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const ns: RequestNamespace = request;\n *     void ns;\n */\nexport type RequestNamespace = typeof request;\n"]}

package/dist/state/arraySlot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Script-facing handle on a persistent, bounded **FIFO collection** —
+ * Pine's `var array<…>` with capacity eviction. Unlike {@link MutableSlot}
+ * (one value's history) or a `Series` (bar-indexed history), this is a
+ * **collection** you push many values into: `push` appends (evicting the
+ * oldest once `capacity` is reached), `get(n)` reads the `n`-th element from
+ * the newest (`n = 0`), `last()` is the newest, `size` is the current filled
+ * count, `capacity` is the fixed bound, and `clear()` empties it.
+ *
+ * The collection persists across bars with `state.*` committed/tentative
+ * semantics: pushes during a tick are tentative and discarded if a later
+ * tick replaces the head bar; on bar close they commit. `capacity` is a
+ * required compile-time numeric literal so the store is bounded and
+ * snapshot-clean.
+ *
+ * Out-of-range `get(n)` returns the element type's empty value (`NaN` for
+ * `number`); it never throws. This is **not** number-coercible — there is no
+ * `+a` / `valueOf`; it is a collection, not a value.
+ *
+ * @since 1.3
+ * @stable
+ * @example
+ *     function rollingMean(a: MutableArraySlot<number>, x: number): number {
+ *         a.push(x);
+ *         let sum = 0;
+ *         for (let i = 0; i < a.size; i++) sum += a.get(i);
+ *         return sum / a.size;
+ *     }
+ */
+export type MutableArraySlot<T> = {
+    push(value: T): void;
+    get(n: number): T;
+    last(): T;
+    clear(): void;
+    readonly size: number;
+    readonly capacity: number;
+};
+//# sourceMappingURL=arraySlot.d.ts.map

package/dist/state/arraySlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arraySlot.d.ts","sourceRoot":"","sources":["../../src/state/arraySlot.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAClB,IAAI,IAAI,CAAC,CAAC;IACV,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B,CAAC"}

package/dist/state/arraySlot.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=arraySlot.js.map

package/dist/state/arraySlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arraySlot.js","sourceRoot":"","sources":["../../src/state/arraySlot.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\n/**\n * Script-facing handle on a persistent, bounded **FIFO collection** —\n * Pine's `var array<…>` with capacity eviction. Unlike {@link MutableSlot}\n * (one value's history) or a `Series` (bar-indexed history), this is a\n * **collection** you push many values into: `push` appends (evicting the\n * oldest once `capacity` is reached), `get(n)` reads the `n`-th element from\n * the newest (`n = 0`), `last()` is the newest, `size` is the current filled\n * count, `capacity` is the fixed bound, and `clear()` empties it.\n *\n * The collection persists across bars with `state.*` committed/tentative\n * semantics: pushes during a tick are tentative and discarded if a later\n * tick replaces the head bar; on bar close they commit. `capacity` is a\n * required compile-time numeric literal so the store is bounded and\n * snapshot-clean.\n *\n * Out-of-range `get(n)` returns the element type's empty value (`NaN` for\n * `number`); it never throws. This is **not** number-coercible — there is no\n * `+a` / `valueOf`; it is a collection, not a value.\n *\n * @since 1.3\n * @stable\n * @example\n *     function rollingMean(a: MutableArraySlot<number>, x: number): number {\n *         a.push(x);\n *         let sum = 0;\n *         for (let i = 0; i < a.size; i++) sum += a.get(i);\n *         return sum / a.size;\n *     }\n */\nexport type MutableArraySlot<T> = {\n    push(value: T): void;\n    get(n: number): T;\n    last(): T;\n    clear(): void;\n    readonly size: number;\n    readonly capacity: number;\n};\n"]}

package/dist/state/index.d.ts

@@ -1,5 +1,6 @@
 export { state } from "./state.js";
 export type { StateNamespace } from "./state.js";
+export type { MutableArraySlot } from "./arraySlot.js";
 export type { MutableSlot } from "./mutableSlot.js";
 export type { RunnerSnapshot, StateSnapshot, StateStoreKey, StreamSnapshot, } from "./snapshot.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACjB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACjB,MAAM,eAAe,CAAC"}

package/dist/state/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,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 { state } from \"./state.js\";\nexport type { StateNamespace } from \"./state.js\";\nexport type { MutableSlot } from \"./mutableSlot.js\";\nexport type {\n    RunnerSnapshot,\n    StateSnapshot,\n    StateStoreKey,\n    StreamSnapshot,\n} from \"./snapshot.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,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 { state } from \"./state.js\";\nexport type { StateNamespace } from \"./state.js\";\nexport type { MutableArraySlot } from \"./arraySlot.js\";\nexport type { MutableSlot } from \"./mutableSlot.js\";\nexport type {\n    RunnerSnapshot,\n    StateSnapshot,\n    StateStoreKey,\n    StreamSnapshot,\n} from \"./snapshot.js\";\n"]}

package/dist/state/state.d.ts

@@ -1,3 +1,5 @@
+import type { NumberSeriesSlot } from "../types.js";
+import type { MutableArraySlot } from "./arraySlot.js";
 import type { MutableSlot } from "./mutableSlot.js";
 /**
  * Persistent state slots, Pine `var` semantics. Writes during a tick are
@@ -55,6 +57,40 @@ export declare const state: Readonly<{
      *     void fn;
      */
     string(_init: string): MutableSlot<string>;
+    /**
+     * Allocate or read a persistent **series** slot — a writable, indexable
+     * number history. `s.value = expr` writes the current bar's value;
+     * `s[0]` / `s.current` / `+s` read it back, `s[1]` reads one bar ago.
+     * The allocation bar's pre-write head is seeded with `init`; unwritten later
+     * bars and out-of-range history reads are `NaN`. Unlike `state.float`, the
+     * slot retains a bounded window of prior committed values (sized to the
+     * script's deepest literal `s[n]` lookback).
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const fn: typeof state.series = state.series;
+     *     void fn;
+     */
+    series(_init: number): NumberSeriesSlot;
+    /**
+     * Allocate or read a persistent **bounded collection** slot — a
+     * fixed-capacity FIFO ring you push values into across bars. `a.push(v)`
+     * appends (evicting the oldest once full); `a.get(n)` reads the `n`-th
+     * element from the newest; `a.last()` is the newest; `a.size` is the
+     * filled count; `a.capacity` is the bound; `a.clear()` empties it.
+     * `capacity` must be a compile-time numeric literal (the slot is bounded
+     * so it serializes). Unlike {@link state}.series (one value's bar-indexed
+     * history), this is a collection of many pushed values. v1 supports
+     * `number` element type.
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const fn: typeof state.array = state.array;
+     *     void fn;
+     */
+    array<T>(_capacity: number): MutableArraySlot<T>;
     /**
      * Tick-persistent state slots, Pine `varip` semantics. Writes commit
      * immediately, even during a tick.

package/dist/state/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;OAQG;iBACU,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAIzC;;;;;;;;OAQG;eACQ,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAIvC;;;;;;;;OAQG;gBACS,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAI1C;;;;;;;;OAQG;kBACW,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAI1C;;;;;;;;;OASG;;qBAEc,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;mBAG9B,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;oBAG3B,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;sBAG5B,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;;EAIhD,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,KAAK,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;OAQG;iBACU,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAIzC;;;;;;;;OAQG;eACQ,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAIvC;;;;;;;;OAQG;gBACS,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAI1C;;;;;;;;OAQG;kBACW,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAI1C;;;;;;;;;;;;;;OAcG;kBACW,MAAM,GAAG,gBAAgB;IAIvC;;;;;;;;;;;;;;;;OAgBG;UACG,CAAC,aAAa,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAIhD;;;;;;;;;OASG;;qBAEc,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;mBAG9B,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;oBAG3B,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;sBAG5B,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;;EAIhD,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,KAAK,CAAC"}

package/dist/state/state.js

@@ -67,6 +67,44 @@ export const state = Object.freeze({
     string(_init) {
         return sentinel("state.string");
     },
+    /**
+     * Allocate or read a persistent **series** slot — a writable, indexable
+     * number history. `s.value = expr` writes the current bar's value;
+     * `s[0]` / `s.current` / `+s` read it back, `s[1]` reads one bar ago.
+     * The allocation bar's pre-write head is seeded with `init`; unwritten later
+     * bars and out-of-range history reads are `NaN`. Unlike `state.float`, the
+     * slot retains a bounded window of prior committed values (sized to the
+     * script's deepest literal `s[n]` lookback).
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const fn: typeof state.series = state.series;
+     *     void fn;
+     */
+    series(_init) {
+        return sentinel("state.series");
+    },
+    /**
+     * Allocate or read a persistent **bounded collection** slot — a
+     * fixed-capacity FIFO ring you push values into across bars. `a.push(v)`
+     * appends (evicting the oldest once full); `a.get(n)` reads the `n`-th
+     * element from the newest; `a.last()` is the newest; `a.size` is the
+     * filled count; `a.capacity` is the bound; `a.clear()` empties it.
+     * `capacity` must be a compile-time numeric literal (the slot is bounded
+     * so it serializes). Unlike {@link state}.series (one value's bar-indexed
+     * history), this is a collection of many pushed values. v1 supports
+     * `number` element type.
+     *
+     * @since 1.3
+     * @stable
+     * @example
+     *     const fn: typeof state.array = state.array;
+     *     void fn;
+     */
+    array(_capacity) {
+        return sentinel("state.array");
+    },
     /**
      * Tick-persistent state slots, Pine `varip` semantics. Writes commit
      * immediately, even during a tick.