pinets 0.3.0 → 0.6.1

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

@@ -1,21 +1,45 @@
-import { Input } from '@pinets/namespaces/input/input.index';
-import PineMath from '@pinets/namespaces/math/math.index';
-import { PineRequest } from '@pinets/namespaces/request/request.index';
-import TechnicalAnalysis from '@pinets/namespaces/ta/ta.index';
+import { IProvider, ISymbolInfo } from './marketData/IProvider';
 import { PineArray } from './namespaces/array/array.index';
-import { IProvider } from './marketData/IProvider';
+import { PineMap } from './namespaces/map/map.index';
+import { PineMatrix } from './namespaces/matrix/matrix.index';
+import { Barstate } from './namespaces/Barstate';
+import { Input } from './namespaces/input/input.index';
+import PineMath from './namespaces/math/math.index';
+import { PineRequest } from './namespaces/request/request.index';
+import TechnicalAnalysis from './namespaces/ta/ta.index';
+import { Series } from './Series';
+import { Log } from './namespaces/Log';
+import { Str } from './namespaces/Str';
+import { Timeframe } from './namespaces/Timeframe';
 export declare class Context {
     data: any;
     cache: any;
     taState: any;
+    isSecondaryContext: boolean;
     NA: any;
-    math: PineMath;
-    ta: TechnicalAnalysis;
-    input: Input;
-    request: PineRequest;
-    array: PineArray;
-    core: any;
     lang: any;
+    pine: {
+        input: Input;
+        ta: TechnicalAnalysis;
+        math: PineMath;
+        request: PineRequest;
+        array: PineArray;
+        map: PineMap;
+        matrix: PineMatrix;
+        na: () => any;
+        plotchar: (...args: any[]) => any;
+        color: any;
+        plot: (...args: any[]) => any;
+        nz: (...args: any[]) => any;
+        bar_index: number;
+        syminfo: ISymbolInfo;
+        barstate: Barstate;
+        log: Log;
+        str: Str;
+        timeframe: Timeframe;
+        [key: string]: any;
+    };
+    private static _deprecationWarningsShown;
     idx: number;
     params: any;
     const: any;
@@ -30,8 +54,9 @@ export declare class Context {
     limit: number;
     sDate: number;
     eDate: number;
+    fullContext: Context;
     pineTSCode: Function | String;
-    constructor({ marketData, source, tickerId, timeframe, limit, sDate, eDate, }: {
+    constructor({ marketData, source, tickerId, timeframe, limit, sDate, eDate, fullContext, }: {
         marketData: any;
         source: IProvider | any[];
         tickerId?: string;
@@ -39,25 +64,34 @@ export declare class Context {
         limit?: number;
         sDate?: number;
         eDate?: number;
+        fullContext?: Context;
     });
     /**
      * this function is used to initialize the target variable with the source array
      * this array will represent a time series and its values will be shifted at runtime in order to mimic Pine script behavior
      * @param trg - the target variable name : used internally to maintain the series in the execution context
-     * @param src - the source data, can be an array or a single value
+     * @param src - the source data, can be Series, array, or a single value
      * @param idx - the index of the source array, used to get a sub-series of the source data
-     * @returns the target array
+     * @returns Series object
      */
-    init(trg: any, src: any, idx?: number): any;
+    init(trg: any, src: any, idx?: number): Series;
+    /**
+     * Initializes a 'var' variable.
+     * - First bar: uses the initial value.
+     * - Subsequent bars: maintains the previous value (state).
+     * @param trg - The target variable
+     * @param src - The source initializer value
+     * @returns Series object
+     */
+    initVar(trg: any, src: any): Series;
     /**
      * this function is used to set the floating point precision of a number
      * by default it is set to 10 decimals which is the same as pine script
      * @param n - the number to be precision
      * @param decimals - the number of decimals to precision to
-
      * @returns the precision number
      */
-    precision(n: number, decimals?: number): number;
+    precision(value: number, decimals?: number): number;
     /**
      * This function is used to apply special transformation to internal PineTS parameters and handle them as time-series
      * @param source - the source data, can be an array or a single value
@@ -78,5 +112,33 @@ export declare class Context {
      * @param value - The value to set
      */
     set(target: any, value: any): void;
+    /**
+     * @deprecated Use context.pine.math instead. This will be removed in a future version.
+     */
+    get math(): PineMath;
+    /**
+     * @deprecated Use context.pine.ta instead. This will be removed in a future version.
+     */
+    get ta(): TechnicalAnalysis;
+    /**
+     * @deprecated Use context.pine.input instead. This will be removed in a future version.
+     */
+    get input(): Input;
+    /**
+     * @deprecated Use context.pine.request instead. This will be removed in a future version.
+     */
+    get request(): PineRequest;
+    /**
+     * @deprecated Use context.pine.array instead. This will be removed in a future version.
+     */
+    get array(): PineArray;
+    /**
+     * @deprecated Use context.pine.* (e.g., context.pine.na, context.pine.plot) instead. This will be removed in a future version.
+     */
+    get core(): any;
+    /**
+     * Shows a deprecation warning once per property access pattern
+     */
+    private _showDeprecationWarning;
 }
 export default Context;

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

@@ -1,5 +1,8 @@
+import { IProvider } from './marketData/IProvider';
 import { Context } from './Context.class';
-import { IProvider } from '@pinets/marketData/IProvider';
+/**
+ * This class is a wrapper for the Pine Script language, it allows to run Pine Script code in a JavaScript environment
+ */
 export declare class PineTS {
     private source;
     private tickerId?;
@@ -16,13 +19,22 @@ export declare class PineTS {
     hl2: any;
     hlc3: any;
     ohlc4: any;
+    hlcc4: any;
     openTime: any;
     closeTime: any;
     private _readyPromise;
     private _ready;
+    private _debugSettings;
     private _transpiledCode;
     get transpiledCode(): Function | String;
+    private _isSecondaryContext;
+    markAsSecondary(): void;
+    private _syminfo;
     constructor(source: IProvider | any[], tickerId?: string, timeframe?: string, limit?: number, sDate?: number, eDate?: number);
+    setDebugSettings({ ln, debug }: {
+        ln: boolean;
+        debug: boolean;
+    }): void;
     private loadMarketData;
     ready(): Promise<any>;
     /**

package/dist/types/marketData/Binance/BinanceProvider.class.d.ts

@@ -1,4 +1,4 @@
-import { IProvider } from '@pinets/marketData/IProvider';
+import { IProvider, ISymbolInfo } from '@pinets/marketData/IProvider';
 export declare class BinanceProvider implements IProvider {
     private cacheManager;
     constructor();
@@ -8,4 +8,5 @@ export declare class BinanceProvider implements IProvider {
      * Determines if pagination is needed based on the parameters
      */
     private shouldPaginate;
+    getSymbolInfo(tickerId: string): Promise<ISymbolInfo>;
 }

package/dist/types/marketData/IProvider.d.ts

@@ -1,3 +1,46 @@
+export type ISymbolInfo = {
+    current_contract: string;
+    description: string;
+    isin: string;
+    main_tickerid: string;
+    prefix: string;
+    root: string;
+    ticker: string;
+    tickerid: string;
+    type: string;
+    basecurrency: string;
+    country: string;
+    currency: string;
+    timezone: string;
+    employees: number;
+    industry: string;
+    sector: string;
+    shareholders: number;
+    shares_outstanding_float: number;
+    shares_outstanding_total: number;
+    expiration_date: number;
+    session: string;
+    volumetype: string;
+    mincontract: number;
+    minmove: number;
+    mintick: number;
+    pointvalue: number;
+    pricescale: number;
+    recommendations_buy: number;
+    recommendations_buy_strong: number;
+    recommendations_date: number;
+    recommendations_hold: number;
+    recommendations_sell: number;
+    recommendations_sell_strong: number;
+    recommendations_total: number;
+    target_price_average: number;
+    target_price_date: number;
+    target_price_estimates: number;
+    target_price_high: number;
+    target_price_low: number;
+    target_price_median: number;
+};
 export interface IProvider {
     getMarketData(tickerId: string, timeframe: string, limit?: number, sDate?: number, eDate?: number): Promise<any>;
+    getSymbolInfo(tickerId: string): Promise<ISymbolInfo>;
 }

package/dist/types/marketData/Mock/MockProvider.class.d.ts

@@ -1,4 +1,4 @@
-import { IProvider } from '@pinets/marketData/IProvider';
+import { IProvider, ISymbolInfo } from '@pinets/marketData/IProvider';
 interface Kline {
     openTime: number;
     open: number;
@@ -32,6 +32,7 @@ interface Kline {
  */
 export declare class MockProvider implements IProvider {
     private dataCache;
+    private exchangeInfoCache;
     private readonly dataDirectory;
     constructor(dataDirectory?: string);
     /**
@@ -65,6 +66,17 @@ export declare class MockProvider implements IProvider {
      * @returns Promise<Kline[]> - Array of candle data
      */
     getMarketData(tickerId: string, timeframe: string, limit?: number, sDate?: number, eDate?: number): Promise<Kline[]>;
+    /**
+     * Loads exchange info from JSON file
+     */
+    private loadExchangeInfo;
+    /**
+     * Implements IProvider.getSymbolInfo
+     *
+     * @param tickerId - Symbol name (e.g., 'BTCUSDT' or 'BTCUSDT.P')
+     * @returns Promise<ISymbolInfo> - Symbol information
+     */
+    getSymbolInfo(tickerId: string): Promise<ISymbolInfo>;
     /**
      * Clears the data cache
      */

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

@@ -0,0 +1,13 @@
+export declare class Barstate {
+    private context;
+    private _live;
+    constructor(context: any);
+    setLive(): void;
+    get isnew(): boolean;
+    get islast(): boolean;
+    get isfirst(): boolean;
+    get ishistory(): boolean;
+    get isrealtime(): boolean;
+    get isconfirmed(): boolean;
+    get islastconfirmedhistory(): boolean;
+}

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

@@ -12,12 +12,28 @@ export declare class Core {
         black: string;
         gray: string;
         blue: string;
+        yellow: string;
+        orange: string;
+        purple: string;
+        pink: string;
+        brown: string;
+        teal: string;
+        cyan: string;
+        navy: string;
+        indigo: string;
+        violet: string;
+        magenta: string;
+        rose: string;
+        gold: string;
+        silver: string;
+        bronze: string;
     };
     constructor(context: any);
     private extractPlotOptions;
     indicator(title: string, shorttitle?: string, options?: IndicatorOptions): void;
     plotchar(series: number[], title: string, options: PlotCharOptions): void;
     plot(series: any, title: string, options: PlotOptions): void;
+    get bar_index(): any;
     na(series: any): boolean;
     nz(series: any, replacement?: number): any;
 }

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

@@ -0,0 +1,10 @@
+import { Context } from '..';
+export declare class Log {
+    private context;
+    constructor(context: Context);
+    private logFormat;
+    param(source: any, index?: number, name?: string): any;
+    warning(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+}

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

@@ -0,0 +1,23 @@
+import { Context } from '..';
+export declare class Str {
+    private context;
+    constructor(context: Context);
+    param(source: any, index?: number, name?: string): any;
+    tostring(value: any): string;
+    tonumber(value: any): number;
+    lower(value: string): string;
+    upper(value: string): string;
+    trim(value: string): string;
+    repeat(source: string, repeat: number, separator?: string): string;
+    replace_all(source: string, target: string, replacement: string): string;
+    replace(source: string, target: string, replacement: string, occurrence?: number): string;
+    contains(source: string, target: string): boolean;
+    endswith(source: string, target: string): boolean;
+    startswith(source: string, target: string): boolean;
+    pos(source: string, target: string): number;
+    length(source: string): number;
+    match(source: string, pattern: string): RegExpMatchArray;
+    split(source: string, separator: string): string[][];
+    substring(source: string, begin_pos: number, end_pos: number): string;
+    format(message: string, ...args: any[]): string;
+}

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

@@ -0,0 +1,17 @@
+export declare class Timeframe {
+    private context;
+    constructor(context: any);
+    param(source: any, index?: number, name?: string): any;
+    get main_period(): any;
+    get period(): any;
+    get multiplier(): number;
+    get isdwm(): boolean;
+    get isdaily(): boolean;
+    get isweekly(): boolean;
+    get ismonthly(): boolean;
+    get isseconds(): boolean;
+    get isminutes(): boolean;
+    get isintraday(): boolean;
+    from_seconds(seconds: number): string | number;
+    in_seconds(timeframe: string): number;
+}

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

@@ -0,0 +1,86 @@
+export declare enum order {
+    ascending = 1,
+    descending = 0
+}
+export declare enum currency {
+    AED = "AED",
+    ARS = "ARS",
+    AUD = "AUD",
+    BDT = "BDT",
+    BHD = "BHD",
+    BRL = "BRL",
+    BTC = "BTC",
+    CAD = "CAD",
+    CHF = "CHF",
+    CLP = "CLP",
+    CNY = "CNY",
+    COP = "COP",
+    CZK = "CZK",
+    DKK = "DKK",
+    EGP = "EGP",
+    ETH = "ETH",
+    EUR = "EUR",
+    GBP = "GBP",
+    HKD = "HKD",
+    HUF = "HUF",
+    IDR = "IDR",
+    ILS = "ILS",
+    INR = "INR",
+    ISK = "ISK",
+    JPY = "JPY",
+    KES = "KES",
+    KRW = "KRW",
+    KWD = "KWD",
+    LKR = "LKR",
+    MAD = "MAD",
+    MXN = "MXN",
+    MYR = "MYR",
+    NGN = "NGN",
+    NOK = "NOK",
+    NONE = "NONE",
+    NZD = "NZD",
+    PEN = "PEN",
+    PHP = "PHP",
+    PKR = "PKR",
+    PLN = "PLN",
+    QAR = "QAR",
+    RON = "RON",
+    RSD = "RSD",
+    RUB = "RUB",
+    SAR = "SAR",
+    SEK = "SEK",
+    SGD = "SGD",
+    THB = "THB",
+    TND = "TND",
+    TRY = "TRY",
+    TWD = "TWD",
+    USD = "USD",
+    USDT = "USDT",
+    VES = "VES",
+    VND = "VND",
+    ZAR = "ZAR"
+}
+export declare enum dayofweek {
+    sunday = 1,
+    monday = 2,
+    tuesday = 3,
+    wednesday = 4,
+    thursday = 5,
+    friday = 6,
+    saturday = 7
+}
+export declare enum display {
+    all = "all",
+    data_window = "data_window",
+    none = "none",
+    pane = "pane",
+    pine_screener = "pine_screener",
+    price_scale = "price_scale",
+    status_line = "status_line"
+}
+declare const types: {
+    order: typeof order;
+    currency: typeof currency;
+    dayofweek: typeof dayofweek;
+};
+export default types;

package/dist/types/namespaces/array/PineArrayObject.d.ts

@@ -1,5 +1,106 @@
+export declare enum PineArrayType {
+    any = "",
+    box = "box",
+    bool = "bool",
+    color = "color",
+    float = "float",
+    int = "int",
+    label = "label",
+    line = "line",
+    linefill = "linefill",
+    string = "string",
+    table = "table"
+}
 export declare class PineArrayObject {
     array: any;
-    constructor(array: any);
+    type: PineArrayType;
+    context: any;
+    private _abs;
+    private _avg;
+    private _binary_search;
+    private _binary_search_leftmost;
+    private _binary_search_rightmost;
+    private _clear;
+    private _concat;
+    private _copy;
+    private _covariance;
+    private _every;
+    private _fill;
+    private _first;
+    private _get;
+    private _includes;
+    private _indexof;
+    private _insert;
+    private _join;
+    private _last;
+    private _lastindexof;
+    private _max;
+    private _median;
+    private _min;
+    private _mode;
+    private _percentile_linear_interpolation;
+    private _percentile_nearest_rank;
+    private _percentrank;
+    private _pop;
+    private _push;
+    private _range;
+    private _remove;
+    private _reverse;
+    private _set;
+    private _shift;
+    private _size;
+    private _slice;
+    private _some;
+    private _sort;
+    private _sort_indices;
+    private _standardize;
+    private _stdev;
+    private _sum;
+    private _unshift;
+    private _variance;
+    constructor(array: any, type: PineArrayType, context: any);
     toString(): string;
+    abs(...args: any[]): any;
+    avg(...args: any[]): any;
+    binary_search(...args: any[]): any;
+    binary_search_leftmost(...args: any[]): any;
+    binary_search_rightmost(...args: any[]): any;
+    clear(...args: any[]): any;
+    concat(...args: any[]): any;
+    copy(...args: any[]): any;
+    covariance(...args: any[]): any;
+    every(...args: any[]): any;
+    fill(...args: any[]): any;
+    first(...args: any[]): any;
+    get(...args: any[]): any;
+    includes(...args: any[]): any;
+    indexof(...args: any[]): any;
+    insert(...args: any[]): any;
+    join(...args: any[]): any;
+    last(...args: any[]): any;
+    lastindexof(...args: any[]): any;
+    max(...args: any[]): any;
+    median(...args: any[]): any;
+    min(...args: any[]): any;
+    mode(...args: any[]): any;
+    percentile_linear_interpolation(...args: any[]): any;
+    percentile_nearest_rank(...args: any[]): any;
+    percentrank(...args: any[]): any;
+    pop(...args: any[]): any;
+    push(...args: any[]): any;
+    range(...args: any[]): any;
+    remove(...args: any[]): any;
+    reverse(...args: any[]): any;
+    set(...args: any[]): any;
+    shift(...args: any[]): any;
+    size(...args: any[]): any;
+    slice(...args: any[]): any;
+    some(...args: any[]): any;
+    sort(...args: any[]): any;
+    sort_indices(...args: any[]): any;
+    standardize(...args: any[]): any;
+    stdev(...args: any[]): any;
+    sum(...args: any[]): any;
+    unshift(...args: any[]): any;
+    variance(...args: any[]): any;
 }