@forgecharts/sdk 1.1.23 → 1.1.28

package/src/pine/pine-ast.ts

@@ -1,163 +0,0 @@
-/**
- * Pine Script AST types — subset understood by the ForgeCharts Pine compat layer.
- *
- * Supported Pine v5 constructs:
- *   indicator(title, overlay?, ...)
- *   input(defval, title?, ...)  /  input.int()  /  input.float()  /  input.bool()  /  input.source()
- *   ta.sma()  ta.ema()  ta.wma()  ta.rma()  ta.rsi()  ta.macd()
- *   ta.stdev()  ta.highest()  ta.lowest()  ta.change()  ta.mom()  ta.atr()
- *   ta.crossover()  ta.crossunder()  ta.barssince()
- *   math.abs()  math.max()  math.min()  math.round()  math.floor()  math.ceil()
- *   math.sqrt()  math.log()  math.pow()  math.sign()
- *   plot()  plotshape()
- *   nz()  na()
- *   if / else blocks
- *   var declarations
- *   ternary  a ? b : c
- */
-
-// ─── Locations ────────────────────────────────────────────────────────────────
-
-export type Loc = { line: number; col: number };
-
-// ─── Literals ─────────────────────────────────────────────────────────────────
-
-export type PineNumberLit = { kind: 'PineNumberLit'; value: number; loc: Loc };
-export type PineStringLit = { kind: 'PineStringLit'; value: string; loc: Loc };
-export type PineBoolLit   = { kind: 'PineBoolLit';   value: boolean; loc: Loc };
-export type PineColorLit  = { kind: 'PineColorLit';  value: string; loc: Loc };  // e.g. color.red
-export type PineNa        = { kind: 'PineNa'; loc: Loc };
-
-// ─── Expressions ──────────────────────────────────────────────────────────────
-
-export type PineIdent = {
-  kind: 'PineIdent';
-  name: string;
-  loc:  Loc;
-};
-
-/** Namespaced call: ta.sma(src, len) or math.abs(x) */
-export type PineNsCall = {
-  kind:      'PineNsCall';
-  namespace: string;   // 'ta' | 'math' | 'input' | 'color' | etc.
-  fn:        string;
-  args:      PineExpr[];
-  namedArgs: Map<string, PineExpr>;
-  loc:       Loc;
-};
-
-/** Plain function call: sma(src, len), indicator(...), plot(...) */
-export type PineCall = {
-  kind:      'PineCall';
-  fn:        string;
-  args:      PineExpr[];
-  namedArgs: Map<string, PineExpr>;
-  loc:       Loc;
-};
-
-export type PineIndex = {
-  kind:   'PineIndex';
-  series: PineExpr;
-  index:  PineExpr;
-  loc:    Loc;
-};
-
-export type PineBinary = {
-  kind:  'PineBinary';
-  op:    '+' | '-' | '*' | '/' | '%' | '<' | '>' | '<=' | '>=' | '==' | '!=' | 'and' | 'or';
-  left:  PineExpr;
-  right: PineExpr;
-  loc:   Loc;
-};
-
-export type PineUnary = {
-  kind:    'PineUnary';
-  op:      '-' | 'not';
-  operand: PineExpr;
-  loc:     Loc;
-};
-
-export type PineTernary = {
-  kind:       'PineTernary';
-  condition:  PineExpr;
-  consequent: PineExpr;
-  alternate:  PineExpr;
-  loc:        Loc;
-};
-
-/** Member access: color.red, bar_index, etc. — resolved at transpile time */
-export type PineMember = {
-  kind:   'PineMember';
-  object: string;
-  prop:   string;
-  loc:    Loc;
-};
-
-export type PineExpr =
-  | PineNumberLit
-  | PineStringLit
-  | PineBoolLit
-  | PineColorLit
-  | PineNa
-  | PineIdent
-  | PineNsCall
-  | PineCall
-  | PineIndex
-  | PineBinary
-  | PineUnary
-  | PineTernary
-  | PineMember;
-
-// ─── Statements ───────────────────────────────────────────────────────────────
-
-export type PineIndicatorDecl = {
-  kind:    'PineIndicatorDecl';
-  args:    PineExpr[];
-  namedArgs: Map<string, PineExpr>;
-  loc:     Loc;
-};
-
-/** var / varip declaration */
-export type PineVarDecl = {
-  kind:      'PineVarDecl';
-  modifier:  'var' | 'varip';
-  name:      string;
-  typeHint?: string;
-  value:     PineExpr;
-  loc:       Loc;
-};
-
-export type PineAssign = {
-  kind:  'PineAssign';
-  name:  string;
-  op:    '=' | ':=';
-  value: PineExpr;
-  loc:   Loc;
-};
-
-export type PineExprStmt = {
-  kind: 'PineExprStmt';
-  expr: PineExpr;
-  loc:  Loc;
-};
-
-export type PineIf = {
-  kind:       'PineIf';
-  condition:  PineExpr;
-  then:       PineStmt[];
-  else_:      PineStmt[];
-  loc:        Loc;
-};
-
-export type PineStmt =
-  | PineIndicatorDecl
-  | PineVarDecl
-  | PineAssign
-  | PineExprStmt
-  | PineIf;
-
-export type PineProgram = {
-  kind:    'PineProgram';
-  version: number;   // extracted from //@version=5
-  stmts:   PineStmt[];
-};

package/src/pine/pine-lexer.ts

@@ -1,265 +0,0 @@
-/**
- * Pine Script Lexer — tokenises a Pine v5 source string.
- *
- * Differences vs TScript lexer:
- *  - `//@version=N` comment is parsed for the version number
- *  - `color.red`, `ta.sma`, `math.abs` — namespace.member chains
- *  - `:=` reassignment operator
- *  - Indentation-based block structure (INDENT / DEDENT tokens)
- *  - `var` / `varip` keywords
- *  - `=>` (function body arrow, for single-line user functions — recognised
- *    but not fully transpiled; emits an diagnostic)
- */
-
-export type PineTok =
-  | 'NUMBER' | 'STRING' | 'BOOL' | 'COLOR'
-  | 'IDENT'
-  | 'PLUS' | 'MINUS' | 'STAR' | 'SLASH' | 'PERCENT'
-  | 'LT' | 'GT' | 'LTE' | 'GTE' | 'EQEQ' | 'NEQ'
-  | 'QMARK' | 'COLON' | 'ARROW'   // ?: =>
-  | 'ASSIGN' | 'REASSIGN'          // = :=
-  | 'DOT'
-  | 'LPAREN' | 'RPAREN' | 'LBRACKET' | 'RBRACKET'
-  | 'COMMA'
-  | 'INDENT' | 'DEDENT' | 'NEWLINE'
-  | 'EOF';
-
-export type PineToken = {
-  kind:  PineTok;
-  value: string;
-  line:  number;
-  col:   number;
-};
-
-export class PineLexer {
-  private _src:    string;
-  private _pos:    number = 0;
-  private _line:   number = 1;
-  private _col:    number = 1;
-
-  /** Version extracted from `//@version=N` */
-  version = 5;
-
-  constructor(src: string) {
-    this._src = src.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-  }
-
-  tokenize(): PineToken[] {
-    // First pass: raw tokens (with raw NEWLINEs and spaces preserved)
-    const raw = this._rawTokenize();
-    // Second pass: inject INDENT / DEDENT for indented blocks
-    return this._injectIndents(raw);
-  }
-
-  // ─── Raw tokenisation ────────────────────────────────────────────────────────
-
-  private _rawTokenize(): PineToken[] {
-    const tokens: PineToken[] = [];
-
-    while (this._pos < this._src.length) {
-      const ch = this._src[this._pos]!;
-
-      // Handle newline
-      if (ch === '\n') {
-        tokens.push(this._make('NEWLINE', '\n'));
-        this._pos++; this._line++; this._col = 1;
-        continue;
-      }
-
-      // Skip horizontal whitespace (not newlines — needed for indent tracking)
-      if (ch === ' ' || ch === '\t') {
-        this._pos++; this._col++;
-        continue;
-      }
-
-      // Line comment
-      if (ch === '/' && this._peek(1) === '/') {
-        // Check for version annotation
-        const commentStart = this._pos;
-        while (this._pos < this._src.length && this._src[this._pos] !== '\n') {
-          this._pos++; this._col++;
-        }
-        const comment = this._src.slice(commentStart, this._pos);
-        const vMatch = comment.match(/\/\/@version\s*=\s*(\d+)/);
-        if (vMatch) this.version = parseInt(vMatch[1]!, 10);
-        continue;
-      }
-
-      // Numbers
-      if ((ch >= '0' && ch <= '9') || (ch === '.' && this._isDigit(this._peek(1)))) {
-        tokens.push(this._readNumber());
-        continue;
-      }
-
-      // Strings
-      if (ch === '"' || ch === "'") {
-        tokens.push(this._readString(ch));
-        continue;
-      }
-
-      // Identifiers / keywords
-      if (this._isAlpha(ch)) {
-        const tok = this._readIdent();
-        tokens.push(tok);
-        continue;
-      }
-
-      // Two-char operators
-      const two = this._src.slice(this._pos, this._pos + 2);
-      if (two === '<=') { tokens.push(this._make('LTE',      two)); this._adv(2); continue; }
-      if (two === '>=') { tokens.push(this._make('GTE',      two)); this._adv(2); continue; }
-      if (two === '==') { tokens.push(this._make('EQEQ',     two)); this._adv(2); continue; }
-      if (two === '!=') { tokens.push(this._make('NEQ',      two)); this._adv(2); continue; }
-      if (two === ':=') { tokens.push(this._make('REASSIGN', two)); this._adv(2); continue; }
-      if (two === '=>') { tokens.push(this._make('ARROW',    two)); this._adv(2); continue; }
-
-      // Single-char operators
-      const singleOps: Record<string, PineTok> = {
-        '+': 'PLUS', '-': 'MINUS', '*': 'STAR', '/': 'SLASH', '%': 'PERCENT',
-        '<': 'LT',   '>': 'GT',
-        '?': 'QMARK', ':': 'COLON',
-        '(': 'LPAREN', ')': 'RPAREN', '[': 'LBRACKET', ']': 'RBRACKET',
-        ',': 'COMMA', '.': 'DOT',
-        '=': 'ASSIGN',
-      };
-      if (ch in singleOps) {
-        tokens.push(this._make(singleOps[ch]!, ch));
-        this._pos++; this._col++;
-        continue;
-      }
-
-      throw new SyntaxError(`[Pine] Unexpected character '${ch}' at ${this._line}:${this._col}`);
-    }
-
-    tokens.push(this._make('EOF', ''));
-    return tokens;
-  }
-
-  // ─── Indent/Dedent injection ─────────────────────────────────────────────────
-
-  private _injectIndents(raw: PineToken[]): PineToken[] {
-    const out: PineToken[] = [];
-    const indentStack: number[] = [0];
-    let i = 0;
-
-    while (i < raw.length) {
-      const tok = raw[i]!;
-
-      if (tok.kind !== 'NEWLINE') {
-        out.push(tok);
-        i++;
-        continue;
-      }
-
-      // After a NEWLINE, measure the indentation of the next non-empty line
-      out.push(tok);   // keep the NEWLINE token
-      i++;
-
-      // Count leading spaces of the next real line
-      let spaces = 0;
-      let j = i;
-      while (j < raw.length && (raw[j]!.kind === 'NEWLINE')) {
-        // blank line — skip
-        out.push(raw[j]!);
-        j++;
-      }
-      i = j;
-
-      if (i >= raw.length || raw[i]!.kind === 'EOF') break;
-
-      // Compute indent width from the column of the next token
-      const nextTok = raw[i]!;
-      spaces = nextTok.col - 1;  // col is 1-based
-
-      const currentIndent = indentStack[indentStack.length - 1]!;
-
-      if (spaces > currentIndent) {
-        indentStack.push(spaces);
-        out.push({ kind: 'INDENT', value: '', line: nextTok.line, col: 1 });
-      } else {
-        while (spaces < indentStack[indentStack.length - 1]!) {
-          indentStack.pop();
-          out.push({ kind: 'DEDENT', value: '', line: nextTok.line, col: 1 });
-        }
-      }
-    }
-
-    // Close any remaining open indents
-    while (indentStack.length > 1) {
-      indentStack.pop();
-      out.push({ kind: 'DEDENT', value: '', line: 0, col: 0 });
-    }
-
-    out.push({ kind: 'EOF', value: '', line: this._line, col: this._col });
-    return out;
-  }
-
-  // ─── Helpers ─────────────────────────────────────────────────────────────────
-
-  private _make(kind: PineTok, value: string): PineToken {
-    return { kind, value, line: this._line, col: this._col };
-  }
-
-  private _peek(offset: number): string {
-    return this._src[this._pos + offset] ?? '';
-  }
-
-  private _adv(n = 1): void {
-    this._pos  += n;
-    this._col  += n;
-  }
-
-  private _isDigit(ch: string): boolean {
-    return ch >= '0' && ch <= '9';
-  }
-
-  private _isAlpha(ch: string): boolean {
-    return (ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_';
-  }
-
-  private _isAlphaNum(ch: string): boolean {
-    return this._isAlpha(ch) || this._isDigit(ch);
-  }
-
-  private _readNumber(): PineToken {
-    const start = this._pos;
-    const startCol = this._col;
-    while (this._pos < this._src.length) {
-      const c = this._src[this._pos]!;
-      if (this._isDigit(c) || c === '.') { this._pos++; this._col++; }
-      else break;
-    }
-    return { kind: 'NUMBER', value: this._src.slice(start, this._pos), line: this._line, col: startCol };
-  }
-
-  private _readString(quote: string): PineToken {
-    const startCol = this._col;
-    this._pos++; this._col++;
-    let result = '';
-    while (this._pos < this._src.length && this._src[this._pos] !== quote) {
-      if (this._src[this._pos] === '\\') {
-        this._pos++; this._col++;
-        const esc = this._src[this._pos] ?? '';
-        result += esc === 'n' ? '\n' : esc === 't' ? '\t' : esc;
-      } else {
-        result += this._src[this._pos];
-      }
-      this._pos++; this._col++;
-    }
-    this._pos++; this._col++;
-    return { kind: 'STRING', value: result, line: this._line, col: startCol };
-  }
-
-  private _readIdent(): PineToken {
-    const start = this._pos;
-    const startCol = this._col;
-    while (this._pos < this._src.length && this._isAlphaNum(this._src[this._pos]!)) {
-      this._pos++; this._col++;
-    }
-    const name = this._src.slice(start, this._pos);
-    if (name === 'true' || name === 'false') {
-      return { kind: 'BOOL', value: name, line: this._line, col: startCol };
-    }
-    return { kind: 'IDENT', value: name, line: this._line, col: startCol };
-  }
-}