@invinite-org/chartlang-core 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @invinite-org/chartlang-core
 
+## 1.3.0
+
+### Minor Changes
+
+- e620ba8: Add `bgcolor(color, opts?)` and `barcolor(color, opts?)` — Pine-ergonomic
+  top-level aliases for the `bg-color` / `bar-color` plot styles. One call
+  (`bgcolor(close > open ? "#16a34a" : "#dc2626", { transp: 80 })`) replaces
+  the verbose `plot(NaN, { style: { kind: "bg-color", … } })`. Surfaced in the
+  generated primitive reference and taught in the chartlang-coding skill.
+
+  Deliverable 2 (per-bar dynamic color): `PlotEmission` gains an optional
+  `colorValue: Color | null` channel; the runtime resolves the `bgcolor` /
+  `barcolor` per-bar color into it (omitted on the static `plot` path → wire
+  byte-identical, every pinned `plot-hash` untouched), validates it
+  (non-empty color string or `null`), and dedups it last-write-wins per
+  `(slotId, bar)` like `value`. Adapters prefer `colorValue` over the static
+  `style.color` at render time — this precedence is now the normative
+  adapter-kit contract (`PlotEmission.colorValue` JSDoc) and is implemented in
+  the canvas2d reference renderer (`null` ⇒ paint-nothing gap; omitted ⇒ static
+  fallback). The Pine converter emits the real per-bar dynamic color
+  (`bgcolor(close > open ? "#16a34a" : "#dc2626")`) instead of a static
+  `plot(NaN, …)`, so `bgcolor`/`barcolor` round-trip with per-bar semantics
+  intact.
+
+- 08cba38: Add `time.*` calendar accessors (`time.year/month/dayofmonth/dayofweek/hour/
+minute/second/timestamp`), a `time.timeClose(t, tz?)` bar-close accessor
+  (Pine's `time_close()` = bar start + interval), a `session.isOpen(t, spec, tz?)`
+  helper, and an `input.session` kind. Calendar fields are derived from a `Time`
+  epoch via the host (authors stay sandboxed — `Date`/`Intl` remain banned). v1
+  is UTC + fixed-offset only; exchange-tz/DST is a scoped follow-up. The Pine
+  converter lowers `dayofweek` / `time()` / `time_close()` / `input.session`.
+- 1efb49c: Add multi-symbol support to `request.security`. `request.security({ symbol,
+interval })` now reads a **different instrument** (not just a higher
+  timeframe), e.g. `request.security({ symbol: "AMEX:SPY", interval: "1D" })`.
+  `symbol` is optional (defaults to the chart symbol) and must be a compile-time
+  literal (`input.symbol` / `input.enum` resolved). A new `multiSymbol` adapter
+  capability gates non-chart-symbol requests: a different-symbol request against
+  an adapter declaring `multiSymbol: false` degrades to an all-NaN
+  bar/series with a single deduped `multi-symbol-not-supported` diagnostic,
+  mirroring `multi-timeframe-not-supported` (the symbol gate precedes the
+  timeframe gate, so a both-different request emits only the symbol diagnostic).
+  The Pine converter now lowers `request.security("OTHER", tf, expr)`, and the
+  `chartlang scaffold-adapter` template advertises `multiSymbol`.
+- 1efb49c: Add `state.array<T>(capacity)` — a persistent, bounded FIFO collection. Push
+  many values across bars (`a.push(v)`) into a fixed-capacity ring and read
+  them back by element (`a.get(0)` = newest, `a.last()`, `a.size`,
+  `a.capacity`, `a.clear()`). Bounded literal capacity keeps it
+  serialization-clean. The Pine converter lowers a bounded numeric
+  `var array<…>` Camp B ring to it.
+
+  The compiler guards the capacity: it must be a compile-time numeric literal
+  (a `const` numeric binding is accepted) that is a positive integer within
+  `MAX_STATE_ARRAY_CAPACITY` (100_000). A non-literal capacity errors
+  `state-array-capacity-not-literal`; an out-of-range / non-integer literal
+  errors `state-array-capacity-exceeds-max`.
+
 ## 1.2.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { AlertSeverity, AlertConditionDefinition, AlertConditionDescriptor, Bar, BarSeries, BarViewport, CapabilityId, Color, CompiledScriptBundle, CompiledScriptObject, ComputeContext, ComputeFn, DrawingCounts, InputSchema, IntervalDescriptor, JsonValue, LineStyle, NumberSeriesSlot, PlotLineStyle, PlotOverride, PlotSlotDescriptor, Price, PriceSeries, ScriptManifest, SecurityExpressionDescriptor, Series, Time, Volume, VolumeSeries, } from "./types.js";
+export type { AlertSeverity, AlertConditionDefinition, AlertConditionDescriptor, Bar, BarSeries, BarViewport, CapabilityId, Color, CompiledScriptBundle, CompiledScriptObject, ComputeContext, ComputeFn, DrawingCounts, InputSchema, IntervalDescriptor, JsonValue, LineStyle, NumberSeriesSlot, PlotLineStyle, PlotOverride, PlotSlotDescriptor, Price, PriceSeries, RequestedFeed, ScriptManifest, SecurityExpressionDescriptor, Series, Time, Volume, VolumeSeries, } from "./types.js";
 export { isCompiledScriptBundle } from "./types.js";
 export { intervalToSeconds } from "./interval/intervalToSeconds.js";
 export { defineAlert, defineAlertCondition, defineDrawing, defineIndicator, } from "./define/index.js";
@@ -7,20 +7,22 @@ export { ta } from "./ta/index.js";
 export type { AdlOpts, AdrOpts, AdxOpts, AlmaOpts, AnchoredVolumeProfileOpts, AnchoredVolumeProfileResult, AnchoredVwapOpts, AoOpts, AroonOpts, AroonOscOpts, AroonResult, AtrOpts, BarssinceOpts, BbOpts, BbPercentBOpts, BbResult, BbwOpts, BopOpts, CciOpts, ChandeKrollStopOpts, ChandeKrollStopResult, ChandelierOpts, ChaikinOscOpts, ChandelierResult, ChangeOpts, ChopOpts, CmfOpts, CmoOpts, ConnorsRsiOpts, CoppockOpts, CrossoverOpts, CrossunderOpts, DemaOpts, DmiOpts, DmiResult, DonchianOpts, DonchianResult, DpoOpts, EmaOpts, EomOpts, EnvelopeOpts, EnvelopeResult, FisherOpts, FisherResult, FixedRangeVolumeProfileOpts, FixedRangeVolumeProfileResult, HighestOpts, HighestbarsOpts, HmaOpts, HvOpts, IchimokuOpts, IchimokuResult, KamaOpts, KeltnerOpts, KeltnerResult, KlingerOpts, KlingerResult, KstOpts, KstResult, LowestOpts, LowestbarsOpts, LsmaOpts, MacdOpts, MacdResult, MaRibbonOpts, MaRibbonResult, MassIndexOpts, MaTypeNoVolume, McginleyOpts, MedianOpts, MfiOpts, MomentumOpts, NetVolumeOpts, NviOpts, ObvOpts, PivotsHighLowOpts, PivotsHighLowResult, PivotsStandardOpts, PivotsStandardResult, PivotsStandardSystem, PmoOpts, PmoResult, PpoOpts, PpoResult, PsarOpts, PsarResult, PviOpts, PvoOpts, PvoResult, PvtOpts, RocOpts, RsiOpts, RvgiOpts, RvgiResult, RviOpts, SessionVolumeProfileOpts, SessionVolumeProfileResult, SmaOpts, SmiOpts, SmiResult, SmmaOpts, StdevOpts, StochOpts, StochResult, StochRsiOpts, StochRsiResult, SupertrendOpts, SupertrendResult, TaNamespace, TemaOpts, TrendStrengthIndexOpts, TrixOpts, TrixResult, TsiOpts, TsiResult, UlcerIndexOpts, UltimateOscOpts, ValuewhenOpts, VolOpts, VolatilityStopOpts, VolatilityStopResult, VortexOpts, VortexResult, VisibleRangeVolumeProfileOpts, VisibleRangeVolumeProfileResult, VwapOpts, VwmaOpts, WilliamsFractalOpts, WilliamsFractalResult, WilliamsROpts, WmaOpts, ZigZagOpts, ZigZagResult, } from "./ta/ta.js";
 export type { StatefulPrimitiveEntry } from "./statefulPrimitives.js";
 export { input } from "./input/index.js";
-export type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, InputDescriptor, InputKind, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor, } from "./input/index.js";
+export type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, InputDescriptor, InputKind, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SessionDescriptor, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor, } from "./input/index.js";
 export { state } from "./state/index.js";
-export type { MutableSlot, StateNamespace } from "./state/index.js";
+export type { MutableArraySlot, MutableSlot, StateNamespace } from "./state/index.js";
 export type { RunnerSnapshot, StateSnapshot, StateStoreKey, StreamSnapshot, } from "./state/index.js";
+export { session, time } from "./time-accessors/index.js";
+export type { SessionNamespace, TimeNamespace } from "./time-accessors/index.js";
 export { barstate, syminfo, timeframe } from "./views/index.js";
 export type { BarStateView, SymbolType, SymInfoView, TimeframeView } from "./views/index.js";
-export { request } from "./request/index.js";
+export { feedKey, request } from "./request/index.js";
 export type { RequestLowerTfOpts, RequestNamespace, RequestSecurityOpts, SecurityBar, SecurityExpr, } from "./request/index.js";
 export { runtime } from "./runtime/index.js";
 export type { LogLevel, RuntimeNamespace } from "./runtime/index.js";
 export { color, fromGradient, hsl, rgb, withAlpha } from "./color/index.js";
 export type { GradientStop } from "./color/index.js";
-export { hline, plot } from "./plot/index.js";
-export type { HLineOpts, PlotKind, PlotOpts, PlotOptsStyle } from "./plot/plot.js";
+export { barcolor, bgcolor, hline, plot } from "./plot/index.js";
+export type { BarColorOpts, BgColorOpts, HLineOpts, PlotKind, PlotOpts, PlotOptsStyle, } from "./plot/plot.js";
 export { alert } from "./alert/index.js";
 export type { AlertOpts } from "./alert/alert.js";
 export { STATEFUL_PRIMITIVES, STATEFUL_PRIMITIVES_BY_NAME } from "./statefulPrimitives.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,11 +6,12 @@ export { defineAlert, defineAlertCondition, defineDrawing, defineIndicator, } fr
 export { ta } from "./ta/index.js";
 export { input } from "./input/index.js";
 export { state } from "./state/index.js";
+export { session, time } from "./time-accessors/index.js";
 export { barstate, syminfo, timeframe } from "./views/index.js";
-export { request } from "./request/index.js";
+export { feedKey, request } from "./request/index.js";
 export { runtime } from "./runtime/index.js";
 export { color, fromGradient, hsl, rgb, withAlpha } from "./color/index.js";
-export { hline, plot } from "./plot/index.js";
+export { barcolor, bgcolor, hline, plot } from "./plot/index.js";
 export { alert } from "./alert/index.js";
 export { STATEFUL_PRIMITIVES, STATEFUL_PRIMITIVES_BY_NAME } from "./statefulPrimitives.js";
 export { DRAWING_KINDS, KIND_BUCKET, KIND_CAMELCASE, KIND_KEBABCASE, bucketFor, draw, } from "./draw/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAiC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EACH,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAyInC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAmBzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAQzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EACH,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,SAAS,EACT,IAAI,GACP,MAAM,iBAAiB,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nexport type {\n    AlertSeverity,\n    AlertConditionDefinition,\n    AlertConditionDescriptor,\n    Bar,\n    BarSeries,\n    BarViewport,\n    CapabilityId,\n    Color,\n    CompiledScriptBundle,\n    CompiledScriptObject,\n    ComputeContext,\n    ComputeFn,\n    DrawingCounts,\n    InputSchema,\n    IntervalDescriptor,\n    JsonValue,\n    LineStyle,\n    NumberSeriesSlot,\n    PlotLineStyle,\n    PlotOverride,\n    PlotSlotDescriptor,\n    Price,\n    PriceSeries,\n    ScriptManifest,\n    SecurityExpressionDescriptor,\n    Series,\n    Time,\n    Volume,\n    VolumeSeries,\n} from \"./types.js\";\nexport { isCompiledScriptBundle } from \"./types.js\";\nexport { intervalToSeconds } from \"./interval/intervalToSeconds.js\";\nexport {\n    defineAlert,\n    defineAlertCondition,\n    defineDrawing,\n    defineIndicator,\n} from \"./define/index.js\";\nexport type {\n    DefineAlertConditionOpts,\n    DefineAlertOpts,\n    DefineDrawingOpts,\n    DefineIndicatorOpts,\n    DependencyDeclaration,\n    OutputDeclaration,\n    ScaleAxis,\n    ScriptOverrides,\n    ValueFormat,\n} from \"./define/index.js\";\nexport { ta } from \"./ta/index.js\";\nexport type {\n    AdlOpts,\n    AdrOpts,\n    AdxOpts,\n    AlmaOpts,\n    AnchoredVolumeProfileOpts,\n    AnchoredVolumeProfileResult,\n    AnchoredVwapOpts,\n    AoOpts,\n    AroonOpts,\n    AroonOscOpts,\n    AroonResult,\n    AtrOpts,\n    BarssinceOpts,\n    BbOpts,\n    BbPercentBOpts,\n    BbResult,\n    BbwOpts,\n    BopOpts,\n    CciOpts,\n    ChandeKrollStopOpts,\n    ChandeKrollStopResult,\n    ChandelierOpts,\n    ChaikinOscOpts,\n    ChandelierResult,\n    ChangeOpts,\n    ChopOpts,\n    CmfOpts,\n    CmoOpts,\n    ConnorsRsiOpts,\n    CoppockOpts,\n    CrossoverOpts,\n    CrossunderOpts,\n    DemaOpts,\n    DmiOpts,\n    DmiResult,\n    DonchianOpts,\n    DonchianResult,\n    DpoOpts,\n    EmaOpts,\n    EomOpts,\n    EnvelopeOpts,\n    EnvelopeResult,\n    FisherOpts,\n    FisherResult,\n    FixedRangeVolumeProfileOpts,\n    FixedRangeVolumeProfileResult,\n    HighestOpts,\n    HighestbarsOpts,\n    HmaOpts,\n    HvOpts,\n    IchimokuOpts,\n    IchimokuResult,\n    KamaOpts,\n    KeltnerOpts,\n    KeltnerResult,\n    KlingerOpts,\n    KlingerResult,\n    KstOpts,\n    KstResult,\n    LowestOpts,\n    LowestbarsOpts,\n    LsmaOpts,\n    MacdOpts,\n    MacdResult,\n    MaRibbonOpts,\n    MaRibbonResult,\n    MassIndexOpts,\n    MaTypeNoVolume,\n    McginleyOpts,\n    MedianOpts,\n    MfiOpts,\n    MomentumOpts,\n    NetVolumeOpts,\n    NviOpts,\n    ObvOpts,\n    PivotsHighLowOpts,\n    PivotsHighLowResult,\n    PivotsStandardOpts,\n    PivotsStandardResult,\n    PivotsStandardSystem,\n    PmoOpts,\n    PmoResult,\n    PpoOpts,\n    PpoResult,\n    PsarOpts,\n    PsarResult,\n    PviOpts,\n    PvoOpts,\n    PvoResult,\n    PvtOpts,\n    RocOpts,\n    RsiOpts,\n    RvgiOpts,\n    RvgiResult,\n    RviOpts,\n    SessionVolumeProfileOpts,\n    SessionVolumeProfileResult,\n    SmaOpts,\n    SmiOpts,\n    SmiResult,\n    SmmaOpts,\n    StdevOpts,\n    StochOpts,\n    StochResult,\n    StochRsiOpts,\n    StochRsiResult,\n    SupertrendOpts,\n    SupertrendResult,\n    TaNamespace,\n    TemaOpts,\n    TrendStrengthIndexOpts,\n    TrixOpts,\n    TrixResult,\n    TsiOpts,\n    TsiResult,\n    UlcerIndexOpts,\n    UltimateOscOpts,\n    ValuewhenOpts,\n    VolOpts,\n    VolatilityStopOpts,\n    VolatilityStopResult,\n    VortexOpts,\n    VortexResult,\n    VisibleRangeVolumeProfileOpts,\n    VisibleRangeVolumeProfileResult,\n    VwapOpts,\n    VwmaOpts,\n    WilliamsFractalOpts,\n    WilliamsFractalResult,\n    WilliamsROpts,\n    WmaOpts,\n    ZigZagOpts,\n    ZigZagResult,\n} from \"./ta/ta.js\";\nexport type { StatefulPrimitiveEntry } from \"./statefulPrimitives.js\";\nexport { input } from \"./input/index.js\";\nexport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    InputDescriptor,\n    InputKind,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./input/index.js\";\nexport { state } from \"./state/index.js\";\nexport type { MutableSlot, StateNamespace } from \"./state/index.js\";\nexport type {\n    RunnerSnapshot,\n    StateSnapshot,\n    StateStoreKey,\n    StreamSnapshot,\n} from \"./state/index.js\";\nexport { barstate, syminfo, timeframe } from \"./views/index.js\";\nexport type { BarStateView, SymbolType, SymInfoView, TimeframeView } from \"./views/index.js\";\nexport { request } from \"./request/index.js\";\nexport type {\n    RequestLowerTfOpts,\n    RequestNamespace,\n    RequestSecurityOpts,\n    SecurityBar,\n    SecurityExpr,\n} from \"./request/index.js\";\nexport { runtime } from \"./runtime/index.js\";\nexport type { LogLevel, RuntimeNamespace } from \"./runtime/index.js\";\nexport { color, fromGradient, hsl, rgb, withAlpha } from \"./color/index.js\";\nexport type { GradientStop } from \"./color/index.js\";\nexport { hline, plot } from \"./plot/index.js\";\nexport type { HLineOpts, PlotKind, PlotOpts, PlotOptsStyle } from \"./plot/plot.js\";\nexport { alert } from \"./alert/index.js\";\nexport type { AlertOpts } from \"./alert/alert.js\";\nexport { STATEFUL_PRIMITIVES, STATEFUL_PRIMITIVES_BY_NAME } from \"./statefulPrimitives.js\";\nexport {\n    DRAWING_KINDS,\n    KIND_BUCKET,\n    KIND_CAMELCASE,\n    KIND_KEBABCASE,\n    bucketFor,\n    draw,\n} from \"./draw/index.js\";\nexport type {\n    AbcdPatternState,\n    AnchorHept,\n    AnchorPair,\n    AnchorQuad,\n    AnchorQuint,\n    AnchorTriple,\n    ArcState,\n    ArrowMarkDownState,\n    ArrowMarkUpState,\n    ArrowMarkerOpts,\n    ArrowMarkerState,\n    ArrowOpts,\n    ArrowState,\n    BrushState,\n    BrushStyle,\n    CircleState,\n    CrossLineState,\n    CurveState,\n    CyclicLinesState,\n    CypherPatternState,\n    DisjointChannelState,\n    DoubleCurveState,\n    DrawNamespace,\n    DrawingBucket,\n    DrawingHandle,\n    DrawingKind,\n    DrawingMeta,\n    DrawingState,\n    ElliottCorrectionWaveState,\n    ElliottDoubleComboState,\n    ElliottImpulseWaveState,\n    ElliottTriangleWaveState,\n    ElliottTripleComboState,\n    EllipseState,\n    FibChannelState,\n    FibCirclesState,\n    FibOpts,\n    FibRetracementState,\n    FibSpeedArcsState,\n    FibSpeedFanState,\n    FibSpiralState,\n    FibTimeZoneState,\n    FibTrendExtensionState,\n    FibTrendTimeState,\n    FibWedgeState,\n    FillBetweenState,\n    FillBetweenStyle,\n    FlatTopBottomState,\n    FrameOpts,\n    FrameState,\n    GannBoxState,\n    GannFanState,\n    GannSquareFixedState,\n    GannSquareState,\n    GroupState,\n    HeadAndShouldersState,\n    HighlighterState,\n    HighlighterStyle,\n    HorizontalLineState,\n    HorizontalRayState,\n    LineDrawStyle,\n    LineState,\n    MarkerState,\n    PathOpts,\n    PathState,\n    PenState,\n    PitchfanState,\n    PitchforkState,\n    PolylineState,\n    RectangleState,\n    RegressionTrendOpts,\n    RegressionTrendState,\n    RotatedRectangleState,\n    ShapeStyle,\n    SineLineState,\n    TableCell,\n    TableOpts,\n    TablePosition,\n    TableState,\n    TextOpts,\n    TextState,\n    ThreeDrivesPatternState,\n    TimeCyclesState,\n    TrendAngleState,\n    TrendChannelState,\n    TriangleState,\n    TrianglePatternState,\n    VerticalLineState,\n    WorldPoint,\n    XabcdPatternState,\n    ZOrdered,\n} from \"./draw/index.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAkC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EACH,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAyInC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAoBzC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAQzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQtD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AASjE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EACH,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,SAAS,EACT,IAAI,GACP,MAAM,iBAAiB,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nexport type {\n    AlertSeverity,\n    AlertConditionDefinition,\n    AlertConditionDescriptor,\n    Bar,\n    BarSeries,\n    BarViewport,\n    CapabilityId,\n    Color,\n    CompiledScriptBundle,\n    CompiledScriptObject,\n    ComputeContext,\n    ComputeFn,\n    DrawingCounts,\n    InputSchema,\n    IntervalDescriptor,\n    JsonValue,\n    LineStyle,\n    NumberSeriesSlot,\n    PlotLineStyle,\n    PlotOverride,\n    PlotSlotDescriptor,\n    Price,\n    PriceSeries,\n    RequestedFeed,\n    ScriptManifest,\n    SecurityExpressionDescriptor,\n    Series,\n    Time,\n    Volume,\n    VolumeSeries,\n} from \"./types.js\";\nexport { isCompiledScriptBundle } from \"./types.js\";\nexport { intervalToSeconds } from \"./interval/intervalToSeconds.js\";\nexport {\n    defineAlert,\n    defineAlertCondition,\n    defineDrawing,\n    defineIndicator,\n} from \"./define/index.js\";\nexport type {\n    DefineAlertConditionOpts,\n    DefineAlertOpts,\n    DefineDrawingOpts,\n    DefineIndicatorOpts,\n    DependencyDeclaration,\n    OutputDeclaration,\n    ScaleAxis,\n    ScriptOverrides,\n    ValueFormat,\n} from \"./define/index.js\";\nexport { ta } from \"./ta/index.js\";\nexport type {\n    AdlOpts,\n    AdrOpts,\n    AdxOpts,\n    AlmaOpts,\n    AnchoredVolumeProfileOpts,\n    AnchoredVolumeProfileResult,\n    AnchoredVwapOpts,\n    AoOpts,\n    AroonOpts,\n    AroonOscOpts,\n    AroonResult,\n    AtrOpts,\n    BarssinceOpts,\n    BbOpts,\n    BbPercentBOpts,\n    BbResult,\n    BbwOpts,\n    BopOpts,\n    CciOpts,\n    ChandeKrollStopOpts,\n    ChandeKrollStopResult,\n    ChandelierOpts,\n    ChaikinOscOpts,\n    ChandelierResult,\n    ChangeOpts,\n    ChopOpts,\n    CmfOpts,\n    CmoOpts,\n    ConnorsRsiOpts,\n    CoppockOpts,\n    CrossoverOpts,\n    CrossunderOpts,\n    DemaOpts,\n    DmiOpts,\n    DmiResult,\n    DonchianOpts,\n    DonchianResult,\n    DpoOpts,\n    EmaOpts,\n    EomOpts,\n    EnvelopeOpts,\n    EnvelopeResult,\n    FisherOpts,\n    FisherResult,\n    FixedRangeVolumeProfileOpts,\n    FixedRangeVolumeProfileResult,\n    HighestOpts,\n    HighestbarsOpts,\n    HmaOpts,\n    HvOpts,\n    IchimokuOpts,\n    IchimokuResult,\n    KamaOpts,\n    KeltnerOpts,\n    KeltnerResult,\n    KlingerOpts,\n    KlingerResult,\n    KstOpts,\n    KstResult,\n    LowestOpts,\n    LowestbarsOpts,\n    LsmaOpts,\n    MacdOpts,\n    MacdResult,\n    MaRibbonOpts,\n    MaRibbonResult,\n    MassIndexOpts,\n    MaTypeNoVolume,\n    McginleyOpts,\n    MedianOpts,\n    MfiOpts,\n    MomentumOpts,\n    NetVolumeOpts,\n    NviOpts,\n    ObvOpts,\n    PivotsHighLowOpts,\n    PivotsHighLowResult,\n    PivotsStandardOpts,\n    PivotsStandardResult,\n    PivotsStandardSystem,\n    PmoOpts,\n    PmoResult,\n    PpoOpts,\n    PpoResult,\n    PsarOpts,\n    PsarResult,\n    PviOpts,\n    PvoOpts,\n    PvoResult,\n    PvtOpts,\n    RocOpts,\n    RsiOpts,\n    RvgiOpts,\n    RvgiResult,\n    RviOpts,\n    SessionVolumeProfileOpts,\n    SessionVolumeProfileResult,\n    SmaOpts,\n    SmiOpts,\n    SmiResult,\n    SmmaOpts,\n    StdevOpts,\n    StochOpts,\n    StochResult,\n    StochRsiOpts,\n    StochRsiResult,\n    SupertrendOpts,\n    SupertrendResult,\n    TaNamespace,\n    TemaOpts,\n    TrendStrengthIndexOpts,\n    TrixOpts,\n    TrixResult,\n    TsiOpts,\n    TsiResult,\n    UlcerIndexOpts,\n    UltimateOscOpts,\n    ValuewhenOpts,\n    VolOpts,\n    VolatilityStopOpts,\n    VolatilityStopResult,\n    VortexOpts,\n    VortexResult,\n    VisibleRangeVolumeProfileOpts,\n    VisibleRangeVolumeProfileResult,\n    VwapOpts,\n    VwmaOpts,\n    WilliamsFractalOpts,\n    WilliamsFractalResult,\n    WilliamsROpts,\n    WmaOpts,\n    ZigZagOpts,\n    ZigZagResult,\n} from \"./ta/ta.js\";\nexport type { StatefulPrimitiveEntry } from \"./statefulPrimitives.js\";\nexport { input } from \"./input/index.js\";\nexport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    InputDescriptor,\n    InputKind,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SessionDescriptor,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./input/index.js\";\nexport { state } from \"./state/index.js\";\nexport type { MutableArraySlot, MutableSlot, StateNamespace } from \"./state/index.js\";\nexport type {\n    RunnerSnapshot,\n    StateSnapshot,\n    StateStoreKey,\n    StreamSnapshot,\n} from \"./state/index.js\";\nexport { session, time } from \"./time-accessors/index.js\";\nexport type { SessionNamespace, TimeNamespace } from \"./time-accessors/index.js\";\nexport { barstate, syminfo, timeframe } from \"./views/index.js\";\nexport type { BarStateView, SymbolType, SymInfoView, TimeframeView } from \"./views/index.js\";\nexport { feedKey, request } from \"./request/index.js\";\nexport type {\n    RequestLowerTfOpts,\n    RequestNamespace,\n    RequestSecurityOpts,\n    SecurityBar,\n    SecurityExpr,\n} from \"./request/index.js\";\nexport { runtime } from \"./runtime/index.js\";\nexport type { LogLevel, RuntimeNamespace } from \"./runtime/index.js\";\nexport { color, fromGradient, hsl, rgb, withAlpha } from \"./color/index.js\";\nexport type { GradientStop } from \"./color/index.js\";\nexport { barcolor, bgcolor, hline, plot } from \"./plot/index.js\";\nexport type {\n    BarColorOpts,\n    BgColorOpts,\n    HLineOpts,\n    PlotKind,\n    PlotOpts,\n    PlotOptsStyle,\n} from \"./plot/plot.js\";\nexport { alert } from \"./alert/index.js\";\nexport type { AlertOpts } from \"./alert/alert.js\";\nexport { STATEFUL_PRIMITIVES, STATEFUL_PRIMITIVES_BY_NAME } from \"./statefulPrimitives.js\";\nexport {\n    DRAWING_KINDS,\n    KIND_BUCKET,\n    KIND_CAMELCASE,\n    KIND_KEBABCASE,\n    bucketFor,\n    draw,\n} from \"./draw/index.js\";\nexport type {\n    AbcdPatternState,\n    AnchorHept,\n    AnchorPair,\n    AnchorQuad,\n    AnchorQuint,\n    AnchorTriple,\n    ArcState,\n    ArrowMarkDownState,\n    ArrowMarkUpState,\n    ArrowMarkerOpts,\n    ArrowMarkerState,\n    ArrowOpts,\n    ArrowState,\n    BrushState,\n    BrushStyle,\n    CircleState,\n    CrossLineState,\n    CurveState,\n    CyclicLinesState,\n    CypherPatternState,\n    DisjointChannelState,\n    DoubleCurveState,\n    DrawNamespace,\n    DrawingBucket,\n    DrawingHandle,\n    DrawingKind,\n    DrawingMeta,\n    DrawingState,\n    ElliottCorrectionWaveState,\n    ElliottDoubleComboState,\n    ElliottImpulseWaveState,\n    ElliottTriangleWaveState,\n    ElliottTripleComboState,\n    EllipseState,\n    FibChannelState,\n    FibCirclesState,\n    FibOpts,\n    FibRetracementState,\n    FibSpeedArcsState,\n    FibSpeedFanState,\n    FibSpiralState,\n    FibTimeZoneState,\n    FibTrendExtensionState,\n    FibTrendTimeState,\n    FibWedgeState,\n    FillBetweenState,\n    FillBetweenStyle,\n    FlatTopBottomState,\n    FrameOpts,\n    FrameState,\n    GannBoxState,\n    GannFanState,\n    GannSquareFixedState,\n    GannSquareState,\n    GroupState,\n    HeadAndShouldersState,\n    HighlighterState,\n    HighlighterStyle,\n    HorizontalLineState,\n    HorizontalRayState,\n    LineDrawStyle,\n    LineState,\n    MarkerState,\n    PathOpts,\n    PathState,\n    PenState,\n    PitchfanState,\n    PitchforkState,\n    PolylineState,\n    RectangleState,\n    RegressionTrendOpts,\n    RegressionTrendState,\n    RotatedRectangleState,\n    ShapeStyle,\n    SineLineState,\n    TableCell,\n    TableOpts,\n    TablePosition,\n    TableState,\n    TextOpts,\n    TextState,\n    ThreeDrivesPatternState,\n    TimeCyclesState,\n    TrendAngleState,\n    TrendChannelState,\n    TriangleState,\n    TrianglePatternState,\n    VerticalLineState,\n    WorldPoint,\n    XabcdPatternState,\n    ZOrdered,\n} from \"./draw/index.js\";\n"]}

package/dist/input/index.d.ts

@@ -1,3 +1,3 @@
 export { input } from "./input.js";
-export type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, InputDescriptor, InputKind, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor, } from "./inputDescriptor.js";
+export type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, InputDescriptor, InputKind, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SessionDescriptor, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor, } from "./inputDescriptor.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACjB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACjB,MAAM,sBAAsB,CAAC"}

package/dist/input/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/input/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 { input } from \"./input.js\";\nexport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    InputDescriptor,\n    InputKind,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./inputDescriptor.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/input/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 { input } from \"./input.js\";\nexport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    InputDescriptor,\n    InputKind,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SessionDescriptor,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./inputDescriptor.js\";\n"]}

package/dist/input/input.d.ts

@@ -1,5 +1,5 @@
 import type { Color, Price, Time } from "../types.js";
-import type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor } from "./inputDescriptor.js";
+import type { BoolDescriptor, ColorDescriptor, EnumDescriptor, ExternalSeriesDescriptor, FloatDescriptor, IntDescriptor, IntervalDescriptorInput, PriceDescriptor, Schema, SessionDescriptor, SourceDescriptor, SourceField, StringDescriptor, SymbolDescriptor, TimeDescriptor } from "./inputDescriptor.js";
 /**
  * The `input.*` namespace. Every builder is a compile-time literal: the
  * compiler reads the call expression and serialises the descriptor into
@@ -153,6 +153,20 @@ export declare const input: Readonly<{
     interval(defaultValue: string, opts?: {
         readonly title?: string;
     }): IntervalDescriptorInput;
+    /**
+     * Build a session-window input descriptor (`"HH:MM-HH:MM"`). The value is
+     * a free string in v1 (the grammar is parsed at runtime by
+     * `session.isOpen`), mirroring `input.string`.
+     *
+     * @since 1.5
+     * @stable
+     * @example
+     *     const sess = input.session("0930-1600", { title: "Session" });
+     *     void sess;
+     */
+    session(defaultValue: string, opts?: {
+        readonly title?: string;
+    }): SessionDescriptor;
     /**
      * Build an adapter-supplied external series input descriptor.
      *

package/dist/input/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;OAQG;sBAEe,MAAM,SACb;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,aAAa;IAIhB;;;;;;;;OAQG;wBAEe,MAAM,SACb;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,eAAe;IAIlB;;;;;;;;OAQG;uBACgB,OAAO,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;IAI/E;;;;;;;;OAQG;yBAEe,MAAM,SACb;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,gBAAgB;IAInB;;;;;;;;OAQG;SACE,CAAC,SAAS,MAAM,gBACH,CAAC,WACN,aAAa,CAAC,CAAC,CAAC,SAClB;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,cAAc,CAAC,CAAC,CAAC;IASpB;;;;;;;;OAQG;wBACiB,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAI/E;;;;;;;;OAQG;yBACkB,WAAW,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAIvF;;;;;;;;OAQG;uBAEe,IAAI,SACX;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACrE,cAAc;IAIjB;;;;;;;;OAQG;wBACiB,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAI/E;;;;;;;;OAQG;yBACkB,MAAM,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAIlF;;;;;;;;OAQG;2BACoB,MAAM,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,uBAAuB;IAI3F;;;;;;;;;;;OAWG;mBACY,CAAC,QAAQ;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,wBAAwB,CAAC,CAAC,CAAC;EAQjC,CAAC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK;IACd;;;;;;;;OAQG;sBAEe,MAAM,SACb;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,aAAa;IAIhB;;;;;;;;OAQG;wBAEe,MAAM,SACb;QACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,eAAe;IAIlB;;;;;;;;OAQG;uBACgB,OAAO,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;IAI/E;;;;;;;;OAQG;yBAEe,MAAM,SACb;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,gBAAgB;IAInB;;;;;;;;OAQG;SACE,CAAC,SAAS,MAAM,gBACH,CAAC,WACN,aAAa,CAAC,CAAC,CAAC,SAClB;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,cAAc,CAAC,CAAC,CAAC;IASpB;;;;;;;;OAQG;wBACiB,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAI/E;;;;;;;;OAQG;yBACkB,WAAW,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAIvF;;;;;;;;OAQG;uBAEe,IAAI,SACX;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACrE,cAAc;IAIjB;;;;;;;;OAQG;wBACiB,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAI/E;;;;;;;;OAQG;yBACkB,MAAM,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAIlF;;;;;;;;OAQG;2BACoB,MAAM,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,uBAAuB;IAI3F;;;;;;;;;;OAUG;0BACmB,MAAM,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB;IAIpF;;;;;;;;;;;OAWG;mBACY,CAAC,QAAQ;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,wBAAwB,CAAC,CAAC,CAAC;EAQjC,CAAC"}

package/dist/input/input.js

@@ -150,6 +150,20 @@ export const input = Object.freeze({
     interval(defaultValue, opts) {
         return Object.freeze({ kind: "interval", defaultValue, ...opts });
     },
+    /**
+     * Build a session-window input descriptor (`"HH:MM-HH:MM"`). The value is
+     * a free string in v1 (the grammar is parsed at runtime by
+     * `session.isOpen`), mirroring `input.string`.
+     *
+     * @since 1.5
+     * @stable
+     * @example
+     *     const sess = input.session("0930-1600", { title: "Session" });
+     *     void sess;
+     */
+    session(defaultValue, opts) {
+        return Object.freeze({ kind: "session", defaultValue, ...opts });
+    },
     /**
      * Build an adapter-supplied external series input descriptor.
      *

package/dist/input/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Color, Price, Time } from \"../types.js\";\nimport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./inputDescriptor.js\";\n\n/**\n * The `input.*` namespace. Every builder is a compile-time literal: the\n * compiler reads the call expression and serialises the descriptor into\n * `manifest.inputs`.\n *\n * @since 0.4\n * @stable\n * @example\n *     import { input } from \"@invinite-org/chartlang-core\";\n *     const length = input.int(20, { min: 1, max: 200, title: \"Length\" });\n *     void length;\n */\nexport const input = Object.freeze({\n    /**\n     * Build an integer input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const length = input.int(20, { min: 1, max: 200 });\n     *     void length;\n     */\n    int(\n        defaultValue: number,\n        opts?: {\n            readonly min?: number;\n            readonly max?: number;\n            readonly step?: number;\n            readonly title?: string;\n        },\n    ): IntDescriptor {\n        return Object.freeze({ kind: \"int\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a floating-point input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const multiplier = input.float(2.5, { step: 0.5 });\n     *     void multiplier;\n     */\n    float(\n        defaultValue: number,\n        opts?: {\n            readonly min?: number;\n            readonly max?: number;\n            readonly step?: number;\n            readonly title?: string;\n        },\n    ): FloatDescriptor {\n        return Object.freeze({ kind: \"float\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a boolean input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled = input.bool(true);\n     *     void enabled;\n     */\n    bool(defaultValue: boolean, opts?: { readonly title?: string }): BoolDescriptor {\n        return Object.freeze({ kind: \"bool\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a string input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const symbol = input.string(\"AAPL\");\n     *     void symbol;\n     */\n    string(\n        defaultValue: string,\n        opts?: { readonly title?: string; readonly multiline?: boolean },\n    ): StringDescriptor {\n        return Object.freeze({ kind: \"string\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a string enum input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const mode = input.enum(\"fast\", [\"fast\", \"slow\"]);\n     *     void mode;\n     */\n    enum<T extends string>(\n        defaultValue: T,\n        options: ReadonlyArray<T>,\n        opts?: { readonly title?: string },\n    ): EnumDescriptor<T> {\n        return Object.freeze({\n            kind: \"enum\" as const,\n            defaultValue,\n            options: Object.freeze(options.slice()),\n            ...opts,\n        });\n    },\n\n    /**\n     * Build a color input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const c = input.color(\"#26a69a\");\n     *     void c;\n     */\n    color(defaultValue: Color, opts?: { readonly title?: string }): ColorDescriptor {\n        return Object.freeze({ kind: \"color\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a source-field input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const source = input.source(\"close\");\n     *     void source;\n     */\n    source(defaultValue: SourceField, opts?: { readonly title?: string }): SourceDescriptor {\n        return Object.freeze({ kind: \"source\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a time input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const anchor = input.time(1_700_000_000_000, { pickFromChart: true });\n     *     void anchor;\n     */\n    time(\n        defaultValue: Time,\n        opts?: { readonly title?: string; readonly pickFromChart?: boolean },\n    ): TimeDescriptor {\n        return Object.freeze({ kind: \"time\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a price input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const level = input.price(101.25);\n     *     void level;\n     */\n    price(defaultValue: Price, opts?: { readonly title?: string }): PriceDescriptor {\n        return Object.freeze({ kind: \"price\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a symbol input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const ticker = input.symbol(\"AAPL\");\n     *     void ticker;\n     */\n    symbol(defaultValue: string, opts?: { readonly title?: string }): SymbolDescriptor {\n        return Object.freeze({ kind: \"symbol\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a main-interval input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const interval = input.interval(\"1D\");\n     *     void interval;\n     */\n    interval(defaultValue: string, opts?: { readonly title?: string }): IntervalDescriptorInput {\n        return Object.freeze({ kind: \"interval\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build an adapter-supplied external series input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const earnings = input.externalSeries({\n     *         name: \"earnings\",\n     *         schema: { kind: \"external-series-schema\" },\n     *     });\n     *     void earnings;\n     */\n    externalSeries<T>(args: {\n        readonly name: string;\n        readonly schema: Schema<T>;\n        readonly title?: string;\n    }): ExternalSeriesDescriptor<T> {\n        return Object.freeze({\n            kind: \"external-series\" as const,\n            name: args.name,\n            schema: args.schema,\n            ...(args.title === undefined ? {} : { title: args.title }),\n        });\n    },\n});\n"]}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Color, Price, Time } from \"../types.js\";\nimport type {\n    BoolDescriptor,\n    ColorDescriptor,\n    EnumDescriptor,\n    ExternalSeriesDescriptor,\n    FloatDescriptor,\n    IntDescriptor,\n    IntervalDescriptorInput,\n    PriceDescriptor,\n    Schema,\n    SessionDescriptor,\n    SourceDescriptor,\n    SourceField,\n    StringDescriptor,\n    SymbolDescriptor,\n    TimeDescriptor,\n} from \"./inputDescriptor.js\";\n\n/**\n * The `input.*` namespace. Every builder is a compile-time literal: the\n * compiler reads the call expression and serialises the descriptor into\n * `manifest.inputs`.\n *\n * @since 0.4\n * @stable\n * @example\n *     import { input } from \"@invinite-org/chartlang-core\";\n *     const length = input.int(20, { min: 1, max: 200, title: \"Length\" });\n *     void length;\n */\nexport const input = Object.freeze({\n    /**\n     * Build an integer input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const length = input.int(20, { min: 1, max: 200 });\n     *     void length;\n     */\n    int(\n        defaultValue: number,\n        opts?: {\n            readonly min?: number;\n            readonly max?: number;\n            readonly step?: number;\n            readonly title?: string;\n        },\n    ): IntDescriptor {\n        return Object.freeze({ kind: \"int\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a floating-point input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const multiplier = input.float(2.5, { step: 0.5 });\n     *     void multiplier;\n     */\n    float(\n        defaultValue: number,\n        opts?: {\n            readonly min?: number;\n            readonly max?: number;\n            readonly step?: number;\n            readonly title?: string;\n        },\n    ): FloatDescriptor {\n        return Object.freeze({ kind: \"float\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a boolean input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const enabled = input.bool(true);\n     *     void enabled;\n     */\n    bool(defaultValue: boolean, opts?: { readonly title?: string }): BoolDescriptor {\n        return Object.freeze({ kind: \"bool\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a string input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const symbol = input.string(\"AAPL\");\n     *     void symbol;\n     */\n    string(\n        defaultValue: string,\n        opts?: { readonly title?: string; readonly multiline?: boolean },\n    ): StringDescriptor {\n        return Object.freeze({ kind: \"string\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a string enum input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const mode = input.enum(\"fast\", [\"fast\", \"slow\"]);\n     *     void mode;\n     */\n    enum<T extends string>(\n        defaultValue: T,\n        options: ReadonlyArray<T>,\n        opts?: { readonly title?: string },\n    ): EnumDescriptor<T> {\n        return Object.freeze({\n            kind: \"enum\" as const,\n            defaultValue,\n            options: Object.freeze(options.slice()),\n            ...opts,\n        });\n    },\n\n    /**\n     * Build a color input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const c = input.color(\"#26a69a\");\n     *     void c;\n     */\n    color(defaultValue: Color, opts?: { readonly title?: string }): ColorDescriptor {\n        return Object.freeze({ kind: \"color\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a source-field input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const source = input.source(\"close\");\n     *     void source;\n     */\n    source(defaultValue: SourceField, opts?: { readonly title?: string }): SourceDescriptor {\n        return Object.freeze({ kind: \"source\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a time input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const anchor = input.time(1_700_000_000_000, { pickFromChart: true });\n     *     void anchor;\n     */\n    time(\n        defaultValue: Time,\n        opts?: { readonly title?: string; readonly pickFromChart?: boolean },\n    ): TimeDescriptor {\n        return Object.freeze({ kind: \"time\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a price input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const level = input.price(101.25);\n     *     void level;\n     */\n    price(defaultValue: Price, opts?: { readonly title?: string }): PriceDescriptor {\n        return Object.freeze({ kind: \"price\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a symbol input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const ticker = input.symbol(\"AAPL\");\n     *     void ticker;\n     */\n    symbol(defaultValue: string, opts?: { readonly title?: string }): SymbolDescriptor {\n        return Object.freeze({ kind: \"symbol\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a main-interval input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const interval = input.interval(\"1D\");\n     *     void interval;\n     */\n    interval(defaultValue: string, opts?: { readonly title?: string }): IntervalDescriptorInput {\n        return Object.freeze({ kind: \"interval\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build a session-window input descriptor (`\"HH:MM-HH:MM\"`). The value is\n     * a free string in v1 (the grammar is parsed at runtime by\n     * `session.isOpen`), mirroring `input.string`.\n     *\n     * @since 1.5\n     * @stable\n     * @example\n     *     const sess = input.session(\"0930-1600\", { title: \"Session\" });\n     *     void sess;\n     */\n    session(defaultValue: string, opts?: { readonly title?: string }): SessionDescriptor {\n        return Object.freeze({ kind: \"session\" as const, defaultValue, ...opts });\n    },\n\n    /**\n     * Build an adapter-supplied external series input descriptor.\n     *\n     * @since 0.4\n     * @stable\n     * @example\n     *     const earnings = input.externalSeries({\n     *         name: \"earnings\",\n     *         schema: { kind: \"external-series-schema\" },\n     *     });\n     *     void earnings;\n     */\n    externalSeries<T>(args: {\n        readonly name: string;\n        readonly schema: Schema<T>;\n        readonly title?: string;\n    }): ExternalSeriesDescriptor<T> {\n        return Object.freeze({\n            kind: \"external-series\" as const,\n            name: args.name,\n            schema: args.schema,\n            ...(args.title === undefined ? {} : { title: args.title }),\n        });\n    },\n});\n"]}

package/dist/input/inputDescriptor.d.ts

@@ -9,7 +9,7 @@ import type { Color } from "../types.js";
  *     const k: InputKind = "int";
  *     void k;
  */
-export type InputKind = "int" | "float" | "bool" | "string" | "enum" | "color" | "source" | "time" | "price" | "symbol" | "interval" | "external-series";
+export type InputKind = "int" | "float" | "bool" | "string" | "enum" | "color" | "source" | "time" | "price" | "symbol" | "interval" | "session" | "external-series";
 /**
  * Source-field literal for the pre-computed bar sources the runtime
  * populates per close.
@@ -55,7 +55,7 @@ type NumericInputOpts = Readonly<{
  *     };
  *     void d;
  */
-export type InputDescriptor<T> = IntDescriptor | FloatDescriptor | BoolDescriptor | StringDescriptor | EnumDescriptor<string> | ColorDescriptor | SourceDescriptor | TimeDescriptor | PriceDescriptor | SymbolDescriptor | IntervalDescriptorInput | ExternalSeriesDescriptor<T>;
+export type InputDescriptor<T> = IntDescriptor | FloatDescriptor | BoolDescriptor | StringDescriptor | EnumDescriptor<string> | ColorDescriptor | SourceDescriptor | TimeDescriptor | PriceDescriptor | SymbolDescriptor | IntervalDescriptorInput | SessionDescriptor | ExternalSeriesDescriptor<T>;
 type Common<K extends InputKind, T> = Readonly<{
     kind: K;
     defaultValue: T;
@@ -181,6 +181,19 @@ export type SymbolDescriptor = Common<"symbol", string>;
  *     void d;
  */
 export type IntervalDescriptorInput = Common<"interval", string>;
+/**
+ * Descriptor for `input.session(...)`. The value is an `"HH:MM-HH:MM"`
+ * (or `"HHMM-HHMM"`) session-window spec consumed by `session.isOpen`.
+ * Structurally a constrained string; v1 does not validate the grammar at
+ * compile time.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     const d: SessionDescriptor = { kind: "session", defaultValue: "0930-1600" };
+ *     void d;
+ */
+export type SessionDescriptor = Common<"session", string>;
 /**
  * Descriptor for `input.externalSeries(...)`.
  *

package/dist/input/inputDescriptor.d.ts.map

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

package/dist/input/inputDescriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"inputDescriptor.js","sourceRoot":"","sources":["../../src/input/inputDescriptor.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\nimport type { Color } from \"../types.js\";\n\n/**\n * Wire-tagged discriminator for every `input.*` descriptor. Mirrors the\n * adapter-kit `InputKind` alias; the two live in lockstep.\n *\n * @since 0.4\n * @stable\n * @example\n *     const k: InputKind = \"int\";\n *     void k;\n */\nexport type InputKind =\n    | \"int\"\n    | \"float\"\n    | \"bool\"\n    | \"string\"\n    | \"enum\"\n    | \"color\"\n    | \"source\"\n    | \"time\"\n    | \"price\"\n    | \"symbol\"\n    | \"interval\"\n    | \"external-series\";\n\n/**\n * Source-field literal for the pre-computed bar sources the runtime\n * populates per close.\n *\n * @since 0.4\n * @stable\n * @example\n *     const f: SourceField = \"hlc3\";\n *     void f;\n */\nexport type SourceField = \"open\" | \"high\" | \"low\" | \"close\" | \"hl2\" | \"hlc3\" | \"ohlc4\" | \"hlcc4\";\n\n/**\n * Opaque schema wrapper for `input.externalSeries`. Phase 4 ships the type\n * only; runtime validation lands in Phase 5.\n *\n * @since 0.4\n * @stable\n * @example\n *     const s: Schema<number> = { kind: \"external-series-schema\" };\n *     void s;\n */\nexport type Schema<T> = Readonly<{ kind: \"external-series-schema\"; __brand?: T }>;\n\ntype NumericInputOpts = Readonly<{ min?: number; max?: number; step?: number }>;\n\n/**\n * Typed input descriptor returned by every `input.*` builder. The `kind`\n * discriminator matches {@link InputKind}; remaining fields carry defaults\n * and UI hints.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: InputDescriptor<number> = {\n *         kind: \"int\",\n *         defaultValue: 14,\n *         title: \"Length\",\n *     };\n *     void d;\n */\nexport type InputDescriptor<T> =\n    | IntDescriptor\n    | FloatDescriptor\n    | BoolDescriptor\n    | StringDescriptor\n    | EnumDescriptor<string>\n    | ColorDescriptor\n    | SourceDescriptor\n    | TimeDescriptor\n    | PriceDescriptor\n    | SymbolDescriptor\n    | IntervalDescriptorInput\n    | ExternalSeriesDescriptor<T>;\n\ntype Common<K extends InputKind, T> = Readonly<{\n    kind: K;\n    defaultValue: T;\n    title?: string;\n}>;\n\n/**\n * Descriptor for `input.int(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: IntDescriptor = { kind: \"int\", defaultValue: 20, min: 1 };\n *     void d;\n */\nexport type IntDescriptor = Common<\"int\", number> & NumericInputOpts;\n\n/**\n * Descriptor for `input.float(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: FloatDescriptor = { kind: \"float\", defaultValue: 2.5, step: 0.5 };\n *     void d;\n */\nexport type FloatDescriptor = Common<\"float\", number> & NumericInputOpts;\n\n/**\n * Descriptor for `input.bool(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: BoolDescriptor = { kind: \"bool\", defaultValue: true };\n *     void d;\n */\nexport type BoolDescriptor = Common<\"bool\", boolean>;\n\n/**\n * Descriptor for `input.string(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: StringDescriptor = { kind: \"string\", defaultValue: \"AAPL\" };\n *     void d;\n */\nexport type StringDescriptor = Common<\"string\", string> & Readonly<{ multiline?: boolean }>;\n\n/**\n * Descriptor for `input.enum(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: EnumDescriptor<\"a\" | \"b\"> = {\n *         kind: \"enum\",\n *         defaultValue: \"a\",\n *         options: [\"a\", \"b\"],\n *     };\n *     void d;\n */\nexport type EnumDescriptor<T extends string> = Common<\"enum\", T> &\n    Readonly<{ options: ReadonlyArray<T> }>;\n\n/**\n * Descriptor for `input.color(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: ColorDescriptor = { kind: \"color\", defaultValue: \"#26a69a\" };\n *     void d;\n */\nexport type ColorDescriptor = Common<\"color\", Color>;\n\n/**\n * Descriptor for `input.source(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: SourceDescriptor = { kind: \"source\", defaultValue: \"close\" };\n *     void d;\n */\nexport type SourceDescriptor = Common<\"source\", SourceField>;\n\n/**\n * Descriptor for `input.time(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: TimeDescriptor = { kind: \"time\", defaultValue: 1_700_000_000_000 };\n *     void d;\n */\nexport type TimeDescriptor = Common<\"time\", number> & Readonly<{ pickFromChart?: boolean }>;\n\n/**\n * Descriptor for `input.price(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: PriceDescriptor = { kind: \"price\", defaultValue: 101.25 };\n *     void d;\n */\nexport type PriceDescriptor = Common<\"price\", number>;\n\n/**\n * Descriptor for `input.symbol(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: SymbolDescriptor = { kind: \"symbol\", defaultValue: \"AAPL\" };\n *     void d;\n */\nexport type SymbolDescriptor = Common<\"symbol\", string>;\n\n/**\n * Descriptor for `input.interval(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: IntervalDescriptorInput = { kind: \"interval\", defaultValue: \"1D\" };\n *     void d;\n */\nexport type IntervalDescriptorInput = Common<\"interval\", string>;\n\n/**\n * Descriptor for `input.externalSeries(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: ExternalSeriesDescriptor<number> = {\n *         kind: \"external-series\",\n *         name: \"earnings\",\n *         schema: { kind: \"external-series-schema\" },\n *     };\n *     void d;\n */\nexport type ExternalSeriesDescriptor<T> = Readonly<{\n    kind: \"external-series\";\n    name: string;\n    schema: Schema<T>;\n    title?: string;\n}>;\n"]}
+{"version":3,"file":"inputDescriptor.js","sourceRoot":"","sources":["../../src/input/inputDescriptor.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\nimport type { Color } from \"../types.js\";\n\n/**\n * Wire-tagged discriminator for every `input.*` descriptor. Mirrors the\n * adapter-kit `InputKind` alias; the two live in lockstep.\n *\n * @since 0.4\n * @stable\n * @example\n *     const k: InputKind = \"int\";\n *     void k;\n */\nexport type InputKind =\n    | \"int\"\n    | \"float\"\n    | \"bool\"\n    | \"string\"\n    | \"enum\"\n    | \"color\"\n    | \"source\"\n    | \"time\"\n    | \"price\"\n    | \"symbol\"\n    | \"interval\"\n    | \"session\"\n    | \"external-series\";\n\n/**\n * Source-field literal for the pre-computed bar sources the runtime\n * populates per close.\n *\n * @since 0.4\n * @stable\n * @example\n *     const f: SourceField = \"hlc3\";\n *     void f;\n */\nexport type SourceField = \"open\" | \"high\" | \"low\" | \"close\" | \"hl2\" | \"hlc3\" | \"ohlc4\" | \"hlcc4\";\n\n/**\n * Opaque schema wrapper for `input.externalSeries`. Phase 4 ships the type\n * only; runtime validation lands in Phase 5.\n *\n * @since 0.4\n * @stable\n * @example\n *     const s: Schema<number> = { kind: \"external-series-schema\" };\n *     void s;\n */\nexport type Schema<T> = Readonly<{ kind: \"external-series-schema\"; __brand?: T }>;\n\ntype NumericInputOpts = Readonly<{ min?: number; max?: number; step?: number }>;\n\n/**\n * Typed input descriptor returned by every `input.*` builder. The `kind`\n * discriminator matches {@link InputKind}; remaining fields carry defaults\n * and UI hints.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: InputDescriptor<number> = {\n *         kind: \"int\",\n *         defaultValue: 14,\n *         title: \"Length\",\n *     };\n *     void d;\n */\nexport type InputDescriptor<T> =\n    | IntDescriptor\n    | FloatDescriptor\n    | BoolDescriptor\n    | StringDescriptor\n    | EnumDescriptor<string>\n    | ColorDescriptor\n    | SourceDescriptor\n    | TimeDescriptor\n    | PriceDescriptor\n    | SymbolDescriptor\n    | IntervalDescriptorInput\n    | SessionDescriptor\n    | ExternalSeriesDescriptor<T>;\n\ntype Common<K extends InputKind, T> = Readonly<{\n    kind: K;\n    defaultValue: T;\n    title?: string;\n}>;\n\n/**\n * Descriptor for `input.int(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: IntDescriptor = { kind: \"int\", defaultValue: 20, min: 1 };\n *     void d;\n */\nexport type IntDescriptor = Common<\"int\", number> & NumericInputOpts;\n\n/**\n * Descriptor for `input.float(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: FloatDescriptor = { kind: \"float\", defaultValue: 2.5, step: 0.5 };\n *     void d;\n */\nexport type FloatDescriptor = Common<\"float\", number> & NumericInputOpts;\n\n/**\n * Descriptor for `input.bool(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: BoolDescriptor = { kind: \"bool\", defaultValue: true };\n *     void d;\n */\nexport type BoolDescriptor = Common<\"bool\", boolean>;\n\n/**\n * Descriptor for `input.string(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: StringDescriptor = { kind: \"string\", defaultValue: \"AAPL\" };\n *     void d;\n */\nexport type StringDescriptor = Common<\"string\", string> & Readonly<{ multiline?: boolean }>;\n\n/**\n * Descriptor for `input.enum(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: EnumDescriptor<\"a\" | \"b\"> = {\n *         kind: \"enum\",\n *         defaultValue: \"a\",\n *         options: [\"a\", \"b\"],\n *     };\n *     void d;\n */\nexport type EnumDescriptor<T extends string> = Common<\"enum\", T> &\n    Readonly<{ options: ReadonlyArray<T> }>;\n\n/**\n * Descriptor for `input.color(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: ColorDescriptor = { kind: \"color\", defaultValue: \"#26a69a\" };\n *     void d;\n */\nexport type ColorDescriptor = Common<\"color\", Color>;\n\n/**\n * Descriptor for `input.source(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: SourceDescriptor = { kind: \"source\", defaultValue: \"close\" };\n *     void d;\n */\nexport type SourceDescriptor = Common<\"source\", SourceField>;\n\n/**\n * Descriptor for `input.time(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: TimeDescriptor = { kind: \"time\", defaultValue: 1_700_000_000_000 };\n *     void d;\n */\nexport type TimeDescriptor = Common<\"time\", number> & Readonly<{ pickFromChart?: boolean }>;\n\n/**\n * Descriptor for `input.price(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: PriceDescriptor = { kind: \"price\", defaultValue: 101.25 };\n *     void d;\n */\nexport type PriceDescriptor = Common<\"price\", number>;\n\n/**\n * Descriptor for `input.symbol(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: SymbolDescriptor = { kind: \"symbol\", defaultValue: \"AAPL\" };\n *     void d;\n */\nexport type SymbolDescriptor = Common<\"symbol\", string>;\n\n/**\n * Descriptor for `input.interval(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: IntervalDescriptorInput = { kind: \"interval\", defaultValue: \"1D\" };\n *     void d;\n */\nexport type IntervalDescriptorInput = Common<\"interval\", string>;\n\n/**\n * Descriptor for `input.session(...)`. The value is an `\"HH:MM-HH:MM\"`\n * (or `\"HHMM-HHMM\"`) session-window spec consumed by `session.isOpen`.\n * Structurally a constrained string; v1 does not validate the grammar at\n * compile time.\n *\n * @since 1.5\n * @stable\n * @example\n *     const d: SessionDescriptor = { kind: \"session\", defaultValue: \"0930-1600\" };\n *     void d;\n */\nexport type SessionDescriptor = Common<\"session\", string>;\n\n/**\n * Descriptor for `input.externalSeries(...)`.\n *\n * @since 0.4\n * @stable\n * @example\n *     const d: ExternalSeriesDescriptor<number> = {\n *         kind: \"external-series\",\n *         name: \"earnings\",\n *         schema: { kind: \"external-series-schema\" },\n *     };\n *     void d;\n */\nexport type ExternalSeriesDescriptor<T> = Readonly<{\n    kind: \"external-series\";\n    name: string;\n    schema: Schema<T>;\n    title?: string;\n}>;\n"]}

package/dist/plot/plot.d.ts

@@ -277,6 +277,36 @@ export type HLineOpts = Readonly<{
      */
     pane?: "overlay" | "new" | string;
 }>;
+/**
+ * Styling options accepted by `bgcolor(...)` — the Pine-ergonomic alias for
+ * a `bg-color` pane-background band. `transp` is the 0–100 transparency
+ * (0 opaque … 100 fully transparent), mirroring {@link PlotOptsStyle}'s
+ * `bg-color` arm. `title` labels the slot for host overrides.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     const opts: BgColorOpts = { transp: 80, title: "RSI heat" };
+ *     void opts;
+ */
+export type BgColorOpts = Readonly<{
+    transp?: number;
+    title?: string;
+}>;
+/**
+ * Styling options accepted by `barcolor(...)` — the Pine-ergonomic alias for
+ * a `bar-color` candle/bar tint. The `bar-color` style carries no
+ * transparency, so this bag only labels the slot.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     const opts: BarColorOpts = { title: "trend tint" };
+ *     void opts;
+ */
+export type BarColorOpts = Readonly<{
+    title?: string;
+}>;
 /**
  * Compile-time callable hole for `plot(value, opts?)`. The compiler rewrites
  * every callsite to dispatch to the runtime's `plot` implementation;
@@ -307,4 +337,34 @@ export declare function plot(_value: number | Series<number>, _opts?: PlotOpts):
  *     try { hline(70); } catch {}
  */
 export declare function hline(_price: number, _opts?: HLineOpts): void;
+/**
+ * Paint the pane background for the current bar — the Pine-ergonomic alias
+ * for `plot(NaN, { style: { kind: "bg-color", color, transp } })`. Pass a
+ * `Color` (a CSS / hex string, or a per-bar color expression like
+ * `close > open ? "#16a34a" : "#dc2626"`). Sugar over the existing
+ * `bg-color` plot style — same wire emission, same capability gate.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     // Inside a compiled `compute`:
+ *     //   bgcolor(bar.close > bar.open ? "#16a34a" : "#dc2626", { transp: 80 });
+ *     import { bgcolor } from "@invinite-org/chartlang-core";
+ *     try { bgcolor("#1d4ed8"); } catch {}
+ */
+export declare function bgcolor(_color: Color, _opts?: BgColorOpts): void;
+/**
+ * Tint the candle / bar for the current bar — the Pine-ergonomic alias for
+ * `plot(NaN, { style: { kind: "bar-color", color } })`. Sugar over the
+ * existing `bar-color` plot style.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     // Inside a compiled `compute`:
+ *     //   barcolor(bar.close > bar.open ? "#16a34a" : "#dc2626");
+ *     import { barcolor } from "@invinite-org/chartlang-core";
+ *     try { barcolor("#a855f7"); } catch {}
+ */
+export declare function barcolor(_color: Color, _opts?: BarColorOpts): void;
 //# sourceMappingURL=plot.d.ts.map

package/dist/plot/plot.d.ts.map

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

package/dist/plot/plot.js

@@ -34,4 +34,38 @@ export function plot(_value, _opts) {
 export function hline(_price, _opts) {
     throw new Error("hline called outside compiled runtime");
 }
+/**
+ * Paint the pane background for the current bar — the Pine-ergonomic alias
+ * for `plot(NaN, { style: { kind: "bg-color", color, transp } })`. Pass a
+ * `Color` (a CSS / hex string, or a per-bar color expression like
+ * `close > open ? "#16a34a" : "#dc2626"`). Sugar over the existing
+ * `bg-color` plot style — same wire emission, same capability gate.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     // Inside a compiled `compute`:
+ *     //   bgcolor(bar.close > bar.open ? "#16a34a" : "#dc2626", { transp: 80 });
+ *     import { bgcolor } from "@invinite-org/chartlang-core";
+ *     try { bgcolor("#1d4ed8"); } catch {}
+ */
+export function bgcolor(_color, _opts) {
+    throw new Error("bgcolor called outside compiled runtime");
+}
+/**
+ * Tint the candle / bar for the current bar — the Pine-ergonomic alias for
+ * `plot(NaN, { style: { kind: "bar-color", color } })`. Sugar over the
+ * existing `bar-color` plot style.
+ *
+ * @since 1.4
+ * @stable
+ * @example
+ *     // Inside a compiled `compute`:
+ *     //   barcolor(bar.close > bar.open ? "#16a34a" : "#dc2626");
+ *     import { barcolor } from "@invinite-org/chartlang-core";
+ *     try { barcolor("#a855f7"); } catch {}
+ */
+export function barcolor(_color, _opts) {
+    throw new Error("barcolor called outside compiled runtime");
+}
 //# sourceMappingURL=plot.js.map

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;AAgS/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     * 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 * 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"]}