pinets 0.9.6 → 0.9.8

package/dist/types/Context.class.d.ts

@@ -16,11 +16,35 @@ export declare class Context {
     dataVersion: number;
     __maxLoops: number;
     NA: any;
+    /** Runtime warnings (OOB access, etc.) — non-blocking, script continues. */
+    warnings: {
+        message: string;
+        method?: string;
+        bar: number;
+    }[];
+    /** Alert events emitted by alert() and alertcondition() calls. */
+    alerts: {
+        type: string;
+        id: string;
+        message: string;
+        title?: string;
+        freq?: string;
+        bar_index: number;
+        time: number;
+    }[];
+    /** Alert mode: 'realtime' = only fire on live bars (TV behavior), 'all' = fire on every bar (backtest). */
+    _alertMode: 'realtime' | 'all';
+    /** Monotonically increasing counter, incremented each time a bar starts executing.
+     *  Used by alertcondition/AlertHelper to detect re-execution of the same bar. */
+    _execTick: number;
+    /** Emit a runtime warning. The script continues execution (returns na/no-op). */
+    warn(message: string, method?: string): void;
     lang: any;
     length: number;
-    /** References to drawing helpers for streaming rollback */
+    /** References to drawing helpers for streaming rollback and plot sync */
     _drawingHelpers: {
         rollbackFromBar(barIdx: number): void;
+        syncToPlot?(): void;
     }[];
     pine: {
         [key: string]: any;

package/dist/types/PineTS.class.d.ts

@@ -48,6 +48,15 @@ export declare class PineTS {
      * @param maxLoops Maximum iterations per loop (default: 500000)
      */
     setMaxLoops(maxLoops: number): void;
+    private _alertMode;
+    /**
+     * Set alert mode.
+     * - 'realtime' (default): alerts only fire on the last (realtime) bar,
+     *   matching TradingView behavior.
+     * - 'all': alerts fire on every bar, useful for backtesting alert strategies.
+     * @param mode Alert firing mode
+     */
+    setAlertMode(mode: 'realtime' | 'all'): void;
     constructor(source: IProvider | any[], tickerId?: string, timeframe?: string, limit?: number, sDate?: number, eDate?: number);
     setDebugSettings({ ln, debug }: {
         ln: boolean;
@@ -82,7 +91,7 @@ export declare class PineTS {
         live?: boolean;
         interval?: number;
     }): {
-        on: (event: 'data' | 'error', callback: Function) => void;
+        on: (event: 'data' | 'error' | 'warning' | 'alert', callback: Function) => void;
         stop: () => void;
     };
     /**

package/dist/types/namespaces/Core.d.ts

@@ -11,6 +11,41 @@ export declare class NAHelper {
     param(source: any, index?: number): any;
     any(series: any): boolean;
 }
+/**
+ * Alert frequency constants (Pine Script alert.freq_* enum values).
+ */
+export declare const ALERT_FREQ: {
+    freq_all: string;
+    freq_once_per_bar: string;
+    freq_once_per_bar_close: string;
+};
+/**
+ * AlertHelper implements the dual-use `alert` identifier.
+ * - `alert(msg, freq)` → `alert.any(msg, freq, {__callsiteId})` — fires an alert event
+ * - `alert.freq_once_per_bar` → frequency constant
+ *
+ * Each `alert()` call site gets a stable ID (`alert_0`, `alert_1`, ...)
+ * injected by the transpiler at compile time via `__callsiteId`. This ensures
+ * per-callsite frequency gating works correctly even when live bars are
+ * re-executed or when alert() calls are inside conditional branches.
+ */
+export declare class AlertHelper {
+    private context;
+    /**
+     * Per-callsite, per-bar frequency gating.
+     * Key: `${callsiteId}:${barIdx}`, tracks which (callsite, bar) pairs have fired.
+     */
+    private _firedKeys;
+    /** Fallback counter for PineTS-syntax (non-transpiled) calls without __callsiteId. */
+    private _fallbackCounter;
+    private _fallbackLastExecTick;
+    constructor(context: any);
+    get freq_all(): string;
+    get freq_once_per_bar(): string;
+    get freq_once_per_bar_close(): string;
+    param(source: any, _index?: number, _id?: string): any;
+    any(message: any, freq?: any, opts?: any): void;
+}
 export declare class Core {
     private context;
     constructor(context: any);
@@ -20,8 +55,11 @@ export declare class Core {
     na(series: any): boolean;
     nz(series: any, replacement?: number): any;
     fixnan(series: any): any;
-    alertcondition(condition: any, title: any, message: any): void;
-    alert(...args: any[]): void;
+    private _acCounter;
+    private _acLastExecTick;
+    /** Per-callsite, per-bar dedup for alertcondition (prevents duplicate fires on live re-execution). */
+    private _acFiredKeys;
+    alertcondition(condition: any, title?: any, message?: any): void;
     error(...args: any[]): void;
     max_bars_back(series?: any, length?: any): void;
     /**

package/dist/types/namespaces/box/BoxHelper.d.ts

@@ -6,7 +6,7 @@ export declare class BoxHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     private _resolvePoint;
     private _resolve;
     /**

package/dist/types/namespaces/box/BoxObject.d.ts

@@ -52,5 +52,6 @@ export declare class BoxObject {
     get_top(): number;
     get_bottom(): number;
     delete(): void;
+    toPlotData(): any;
     copy(): BoxObject;
 }

package/dist/types/namespaces/label/LabelHelper.d.ts

@@ -6,7 +6,7 @@ export declare class LabelHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     /**
      * Resolve a value that may be a Series, a bound function, or a plain scalar.
      * Pine Script variables (inputs, chart properties) can be stored as Series

package/dist/types/namespaces/line/LineHelper.d.ts

@@ -6,7 +6,7 @@ export declare class LineHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     private _resolvePoint;
     /**
      * Resolve a value that may be a Series, a bound function, or a plain scalar.

package/dist/types/namespaces/linefill/LinefillHelper.d.ts

@@ -6,7 +6,7 @@ export declare class LinefillHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     /**
      * Resolve a value that may be a Series, a bound function, or a plain scalar.
      */

package/dist/types/namespaces/linefill/LinefillObject.d.ts

@@ -13,4 +13,5 @@ export declare class LinefillObject {
     get_line2(): LineObject;
     set_color(color: any): void;
     delete(): void;
+    toPlotData(): any;
 }

package/dist/types/namespaces/matrix/methods/mult.d.ts

@@ -1,4 +1,4 @@
 import { PineMatrixObject } from '../PineMatrixObject';
 import { Context } from '../../../Context.class';
 import { PineArrayObject } from '../../array/PineArrayObject';
-export declare function mult(context: Context): (id: PineMatrixObject, id2: PineMatrixObject | number | PineArrayObject) => PineMatrixObject;
+export declare function mult(context: Context): (id: PineMatrixObject, id2: PineMatrixObject | number | PineArrayObject) => PineArrayObject | PineMatrixObject;

package/dist/types/namespaces/polyline/PolylineHelper.d.ts

@@ -5,7 +5,7 @@ export declare class PolylineHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     /**
      * Resolve a value that may be a Series, a bound function, or a plain scalar.
      */

package/dist/types/namespaces/polyline/PolylineObject.d.ts

@@ -16,4 +16,5 @@ export declare class PolylineObject {
     _createdAtBar: number;
     constructor(points: ChartPointObject[], curved?: boolean, closed?: boolean, xloc?: string, line_color?: string, fill_color?: string, line_style?: string, line_width?: number, force_overlay?: boolean);
     delete(): void;
+    toPlotData(): any;
 }

package/dist/types/namespaces/table/TableHelper.d.ts

@@ -5,7 +5,7 @@ export declare class TableHelper {
     constructor(context: any);
     param(source: any, index?: number, name?: string): any;
     private _ensurePlotsEntry;
-    private _syncToPlot;
+    syncToPlot(): void;
     private _resolve;
     new(...args: any[]): TableObject;
     any(...args: any[]): TableObject;
@@ -30,6 +30,11 @@ export declare class TableHelper {
     set_frame_color(table_id: any, frame_color: any): void;
     set_frame_width(table_id: any, frame_width: any): void;
     get all(): TableObject[];
+    /**
+     * Remove all tables created at or after the given bar index.
+     * Called during streaming rollback.
+     */
+    rollbackFromBar(barIdx: number): void;
     private _setCellProp;
     private _resolveText;
 }

package/dist/types/namespaces/table/TableObject.d.ts

@@ -36,6 +36,7 @@ export declare class TableObject {
     private _helper;
     constructor(position?: string, columns?: number, rows?: number, bgcolor?: string, frame_color?: string, frame_width?: number, border_color?: string, border_width?: number, force_overlay?: boolean);
     delete(): void;
+    toPlotData(): any;
     setCell(column: number, row: number, props: Partial<TableCell>): void;
     getCell(column: number, row: number): TableCell | null;
     clearCell(column: number, row: number): void;

package/dist/types/transpiler/analysis/ScopeManager.d.ts

@@ -15,6 +15,7 @@ export declare class ScopeManager {
     private taCallIdCounter;
     private userCallIdCounter;
     private plotCallIdCounter;
+    private alertCallIdCounter;
     private loopGuardCounter;
     private hoistingStack;
     private suppressHoisting;
@@ -26,6 +27,7 @@ export declare class ScopeManager {
     getNextTACallId(): any;
     getNextUserCallId(): any;
     getNextPlotCallId(): any;
+    getNextAlertCallId(): any;
     getNextLoopGuardName(): string;
     constructor();
     pushScope(type: string): void;

package/dist/types/transpiler/pineToJS/codegen.d.ts

@@ -15,6 +15,39 @@ export declare class CodeGenerator {
     });
     generate(ast: any): string;
     private preProcessAST;
+    /**
+     * Scan the program body for variable declarations and assignments whose
+     * names collide with Pine namespace/built-in names (e.g., `fill`, `size`,
+     * `color`, `line`). Rename them with a `_$N` suffix so they don't shadow
+     * the namespace destructured from `$.pine`.
+     *
+     * Only renames **user variables** — function parameters are handled
+     * separately in generateFunctionDeclaration().
+     *
+     * Renaming rules:
+     * - Variable declaration target (let fill = ...) → renamed
+     * - Assignment target (fill := ...) → renamed
+     * - Bare identifier read (return fill) → renamed
+     * - Call callee (fill(...)) → NOT renamed (namespace call)
+     * - MemberExpression object (size.tiny) → NOT renamed (namespace access)
+     * - MemberExpression property (array.size) → NOT renamed (method name)
+     * - Object property key ({size: ...}) → NOT renamed (named arg key)
+     */
+    private renameConflictingVariables;
+    /**
+     * Walk the AST and collect variable declarations / assignment targets
+     * whose names conflict with CONFLICTING_NAMES.
+     */
+    private collectConflictingVarNames;
+    /**
+     * Context-aware variable reference renaming.
+     * Renames Identifiers that are user-variable references, but skips:
+     * - CallExpression callees (namespace function calls)
+     * - MemberExpression objects with non-computed property (namespace.member)
+     * - MemberExpression non-computed properties (obj.namespace)
+     * - Object property keys ({namespace: value})
+     */
+    private renameVariableRefsInAST;
     private collectFunctionParams;
     writeSourceComment(startLine: any, endLine?: any): void;
     write(str: any): void;

package/dist/types/transpiler/pineToJS/parser.d.ts

@@ -4,6 +4,7 @@ export declare class Parser {
     private tokens;
     private pos;
     private functionNames;
+    private noLineContinuation;
     constructor(tokens: Token[]);
     peek(offset?: number): Token;
     advance(): Token;

package/dist/types/transpiler/settings.d.ts

@@ -2,6 +2,7 @@ export declare const KNOWN_NAMESPACES: string[];
 export declare const NAMESPACES_LIKE: string[];
 export declare const ASYNC_METHODS: string[];
 export declare const FACTORY_METHODS: string[];
+export declare const NAMESPACE_COLLISION_NAMES: Set<string>;
 export declare const CONTEXT_DATA_VARS: string[];
 export declare const CONTEXT_PINE_VARS: string[];
 export declare const CONTEXT_CORE_VARS: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pinets",
-    "version": "0.9.6",
+    "version": "0.9.8",
     "description": "Run Pine Script anywhere. PineTS is an open-source transpiler and runtime that brings Pine Script logic to Node.js and the browser with 1:1 syntax compatibility. Reliably write, port, and run indicators or strategies on your own infrastructure.",
     "keywords": [
         "Pine Script",

package/dist/types/NaProxy.d.ts

@@ -1,19 +0,0 @@
-/**
- * NaProxy: A proxy object that represents `na` for UDT (User-Defined Type) values.
- *
- * In Pine Script, accessing a property on `na` returns `na`, and calling a method on
- * `na` returns `na`. In JavaScript, NaN doesn't support property access, so we use
- * this proxy as a stand-in.
- *
- * Behavior:
- * - Any property access returns the proxy itself (chaining: proxy.bx.get_top → proxy)
- * - Called as a function, returns proxy (proxy() → proxy, for chaining: proxy.method().field)
- * - valueOf() returns NaN (arithmetic: proxy + 5 → NaN)
- * - na.any(proxy) → true
- */
-/** Symbol used to identify NaProxy objects */
-export declare const NA_MARKER: unique symbol;
-/** Singleton NaProxy instance */
-export declare const NA_PROXY: any;
-/** Check if a value is a NaProxy */
-export declare function isNaProxy(val: any): boolean;

package/dist/types/TimeSeries.class.d.ts

@@ -1,49 +0,0 @@
-import Context from '../Context.class';
-/**
- * A lightweight wrapper around arrays to provide Pine Script-like "series" access behavior.
- * Pine Script series are indexed relative to the current bar:
- * - series[0] is the current value
- * - series[1] is the previous value
- *
- * This class maps this reversed, relative indexing to the underlying chronological array
- * using the Context's current index.
- */
-export declare class TimeSeries<T = any> {
-    private readonly _data;
-    private readonly _ctx;
-    constructor(_data: T[], _ctx: Context);
-    /**
-     * Get the value at the specified offset from the current bar.
-     * @param offset The lookback offset (0 = current, 1 = previous, etc.)
-     */
-    get(offset: number): T;
-    /**
-     * Set the value at the specified offset from the current bar.
-     * Usually used for setting current value (offset 0).
-     */
-    set(offset: number, value: T): T;
-    /**
-     * Get the length of the series *so far* (up to current index)
-     * Note: This mimics the behavior where future data isn't "visible" yet
-     */
-    get length(): number;
-    /**
-     * Returns the underlying raw data array.
-     * Useful for performance-critical bulk operations that understand the indexing.
-     */
-    get data(): T[];
-    /**
-     * Creates a copy of the visible series as a reversed array (Pine Script standard format for bulk ops).
-     * Warning: This is O(N) and should be used sparingly.
-     */
-    toArray(): T[];
-    /**
-     * Push a value to the underlying array.
-     * Used when constructing user-defined series dynamically.
-     */
-    push(value: T): number;
-    /**
-     * Update the underlying array reference (e.g. for re-assignment)
-     */
-    replaceData(newData: T[]): void;
-}

package/dist/types/TimeSeries.d.ts

@@ -1,15 +0,0 @@
-export interface IContext {
-    idx: number;
-    NA: any;
-}
-export declare class TimeSeries<T = any> {
-    private _data;
-    private context;
-    constructor(context: IContext, data?: T[]);
-    get(offset: number): T;
-    set(value: T, offset?: number): void;
-    push(value: T): void;
-    pop(): T | undefined;
-    get data(): T[];
-    get length(): number;
-}

package/dist/types/namespaces/Input.d.ts

@@ -1,24 +0,0 @@
-type InputOptions = {
-    title?: string;
-    group?: string;
-} | any;
-export declare class Input {
-    private context;
-    constructor(context: any);
-    param(source: any, index?: number): any[];
-    any(value: any, { title, group }?: InputOptions): any;
-    int(value: number, { title, group }?: InputOptions): any;
-    float(value: number, { title, group }?: InputOptions): any;
-    bool(value: boolean, { title, group }?: InputOptions): any;
-    string(value: string, { title, group }?: InputOptions): any;
-    timeframe(value: string, { title, group }?: InputOptions): any;
-    time(value: number, { title, group }?: InputOptions): any;
-    price(value: number, { title, group }?: InputOptions): any;
-    session(value: string, { title, group }?: InputOptions): any;
-    source(value: any, { title, group }?: InputOptions): any;
-    symbol(value: string, { title, group }?: InputOptions): any;
-    text_area(value: string, { title, group }?: InputOptions): any;
-    enum(value: string, { title, group }?: InputOptions): any;
-    color(value: string, { title, group }?: InputOptions): any;
-}
-export default Input;

package/dist/types/namespaces/PineArray.d.ts

@@ -1,62 +0,0 @@
-declare class PineArrayObject {
-    array: any;
-    constructor(array: any);
-}
-/**
- * This class implements an array port of PineScript's array functions.
- */
-export declare class PineArray {
-    private context;
-    private _cache;
-    constructor(context: any);
-    param(source: any, index?: number): any;
-    /**
-     * This function simulates PineScript's array.get() function
-     * @param id - the array object to get the value from
-     * @param index - the index of the value to get
-     * @returns the value at the given index
-     */
-    get(id: PineArrayObject, index: number): any;
-    set(id: PineArrayObject, index: number, value: any): void;
-    push(id: PineArrayObject, value: any): void;
-    sum(id: PineArrayObject): number;
-    avg(id: PineArrayObject): number;
-    min(id: PineArrayObject, nth?: number): number;
-    max(id: PineArrayObject, nth?: number): number;
-    size(id: PineArrayObject): number;
-    new_bool(size: number, initial_value?: boolean): PineArrayObject;
-    new_float(size: number, initial_value?: number): PineArrayObject;
-    new_int(size: number, initial_value?: number): PineArrayObject;
-    new_string(size: number, initial_value?: string): PineArrayObject;
-    new<T>(size: number, initial_value: T): PineArrayObject;
-    slice(id: PineArrayObject, start: number, end?: number): PineArrayObject;
-    reverse(id: PineArrayObject): void;
-    includes(id: PineArrayObject, value: any): boolean;
-    indexof(id: PineArrayObject, value: any): number;
-    lastindexof(id: PineArrayObject, value: any): number;
-    stdev(id: PineArrayObject, biased?: boolean): number;
-    variance(id: PineArrayObject, biased?: boolean): number;
-    covariance(arr1: PineArrayObject, arr2: PineArrayObject, biased?: boolean): number;
-    first(id: PineArrayObject): any;
-    last(id: PineArrayObject): any;
-    clear(id: PineArrayObject): void;
-    join(id: PineArrayObject, separator?: string): string;
-    /** Array Manipulation Functions */
-    abs(id: PineArrayObject): PineArrayObject;
-    concat(id: PineArrayObject, other: PineArrayObject): PineArrayObject;
-    copy(id: PineArrayObject): PineArrayObject;
-    every(id: PineArrayObject, callback: (val: any) => boolean): boolean;
-    fill(id: PineArrayObject, value: any, start?: number, end?: number): void;
-    from(source: any[]): PineArrayObject;
-    insert(id: PineArrayObject, index: number, value: any): void;
-    pop(id: PineArrayObject): any;
-    range(id: PineArrayObject): number;
-    remove(id: PineArrayObject, index: number): any;
-    shift(id: PineArrayObject): any;
-    sort(id: PineArrayObject, order?: 'asc' | 'desc'): void;
-    sort_indices(id: PineArrayObject, comparator?: (a: any, b: any) => number): PineArrayObject;
-    standardize(id: PineArrayObject): PineArrayObject;
-    unshift(id: PineArrayObject, value: any): void;
-    some(id: PineArrayObject, callback: (val: any) => boolean): boolean;
-}
-export {};

package/dist/types/namespaces/PineMath.d.ts

@@ -1,28 +0,0 @@
-export declare class PineMath {
-    private context;
-    private _cache;
-    constructor(context: any);
-    param(source: any, index: any, name?: string): any;
-    __eq(a: number, b: number): boolean;
-    abs(source: number[]): number;
-    pow(source: number[], power: number[]): number;
-    sqrt(source: number[]): number;
-    log(source: number[]): number;
-    ln(source: number[]): number;
-    exp(source: number[]): number;
-    floor(source: number[]): number;
-    ceil(source: number[]): number;
-    round(source: number[]): number;
-    random(): number;
-    max(...source: number[]): number;
-    min(...source: number[]): number;
-    sum(source: number[], length: number): number;
-    sin(source: number[]): number;
-    cos(source: number[]): number;
-    tan(source: number[]): number;
-    acos(source: number[]): number;
-    asin(source: number[]): number;
-    atan(source: number[]): number;
-    avg(...sources: number[][]): number;
-}
-export default PineMath;

package/dist/types/namespaces/PineRequest.d.ts

@@ -1,8 +0,0 @@
-export declare class PineRequest {
-    private context;
-    private _cache;
-    constructor(context: any);
-    param(source: any, index: any, name?: string): any[];
-    security(symbol: any, timeframe: any, expression: any, gaps?: boolean, lookahead?: boolean, ignore_invalid_symbol?: boolean, currency?: any, calc_bars_count?: any): Promise<any>;
-    private _findSecContextIdx;
-}

package/dist/types/namespaces/Plot.helper.d.ts

@@ -1,16 +0,0 @@
-export declare class PlotHelper {
-    private context;
-    constructor(context: any);
-    private extractPlotOptions;
-    plotchar(series: number[], title: string, options: PlotCharOptions): void;
-    plot(...args: any[]): void;
-}
-export declare class HlineHelper {
-    private context;
-    constructor(context: any);
-    get style_dashed(): string;
-    get style_solid(): string;
-    get style_dotted(): string;
-    param(source: any, index?: number, name?: string): any;
-    any(price: any, title: any, color: any, linestyle: any, linewidth: any, editable: any, display: any): any;
-}

package/dist/types/namespaces/TechnicalAnalysis.d.ts

@@ -1,30 +0,0 @@
-export declare class TechnicalAnalysis {
-    private context;
-    constructor(context: any);
-    get tr(): any;
-    param(source: any, index: any, name?: string): any;
-    ema(source: any, _period: any, _callId?: any): any;
-    sma(source: any, _period: any, _callId?: any): any;
-    vwma(source: any, _period: any, _callId?: any): any;
-    wma(source: any, _period: any, _callId?: any): any;
-    hma(source: any, _period: any, _callId?: any): any;
-    rma(source: any, _period: any, _callId?: any): any;
-    change(source: any, _length?: number, _callId?: any): any;
-    rsi(source: any, _period: any, _callId?: any): any;
-    atr(_period: any, _callId?: any): any;
-    mom(source: any, _length: any, _callId?: any): any;
-    roc(source: any, _length: any, _callId?: any): any;
-    dev(source: any, _length: any, _callId?: any): any;
-    variance(source: any, _length: any, _callId?: any): any;
-    highest(source: any, _length: any, _callId?: any): any;
-    lowest(source: any, _length: any, _callId?: any): any;
-    median(source: any, _length: any, _callId?: any): any;
-    stdev(source: any, _length: any, _bias?: boolean, _callId?: any): any;
-    linreg(source: any, _length: any, _offset: any, _callId?: any): any;
-    supertrend(_factor: any, _atrPeriod: any, _callId?: any): any[][];
-    crossover(source1: any, source2: any): boolean;
-    crossunder(source1: any, source2: any): boolean;
-    pivothigh(source: any, _leftbars: any, _rightbars: any): any;
-    pivotlow(source: any, _leftbars: any, _rightbars: any): any;
-}
-export default TechnicalAnalysis;

package/dist/types/namespaces/request/types/barmerge.type.d.ts

@@ -1,7 +0,0 @@
-declare const barmerge: {
-    gaps_on: string;
-    gaps_off: string;
-    lookahead_on: string;
-    lookahead_off: string;
-};
-export default barmerge;