@forgecharts/sdk 1.1.23 → 1.1.28

package/dist/tscript/parser.js

@@ -0,0 +1,318 @@
+/**
+ * TScript Parser — recursive-descent, produces a typed AST.
+ *
+ * Precedence (low → high):
+ *   ternary   ? :
+ *   or
+ *   and
+ *   not
+ *   comparison  < > <= >= == !=
+ *   addition    + -
+ *   multiply    * / %
+ *   unary       - (prefix)
+ *   primary     literals, identifiers, index [], call()
+ */
+import { Lexer } from './lexer';
+export class Parser {
+    _tokens;
+    _pos = 0;
+    constructor(src) {
+        this._tokens = new Lexer(src).tokenize().filter((t) => t.kind !== 'NEWLINE' || this._isStatementBoundary(t));
+        // Re-filter: keep NEWLINEs as statement separators but collapse runs
+        this._tokens = this._collapseNewlines(new Lexer(src).tokenize());
+    }
+    parse() {
+        const stmts = [];
+        this._skipNewlines();
+        while (!this._check('EOF')) {
+            stmts.push(this._stmt());
+            this._skipNewlines();
+        }
+        return { kind: 'Program', stmts };
+    }
+    // ─── Statements ─────────────────────────────────────────────────────────────
+    _stmt() {
+        // indicator("title")
+        if (this._checkIdent('indicator')) {
+            return this._indicatorDecl();
+        }
+        // assignment: IDENT = expr  (but not IDENT == ...)
+        if (this._check('IDENT') && this._peekKind(1) === 'EQ') {
+            return this._assign();
+        }
+        return this._exprStmt();
+    }
+    _indicatorDecl() {
+        this._consumeIdent('indicator');
+        this._consume('LPAREN', "Expected '(' after 'indicator'");
+        const title = this._consume('STRING', "Expected string title in indicator()").value;
+        this._consume('RPAREN', "Expected ')' after indicator title");
+        this._consumeNewlineOrEOF();
+        return { kind: 'IndicatorDecl', title };
+    }
+    _assign() {
+        const name = this._consume('IDENT', 'Expected identifier').value;
+        this._consume('EQ', "Expected '='");
+        const value = this._expr();
+        this._consumeNewlineOrEOF();
+        return { kind: 'AssignStmt', name, value };
+    }
+    _exprStmt() {
+        const expr = this._expr();
+        this._consumeNewlineOrEOF();
+        return { kind: 'ExprStmt', expr };
+    }
+    // ─── Expressions ────────────────────────────────────────────────────────────
+    _expr() {
+        return this._ternary();
+    }
+    _ternary() {
+        let left = this._or();
+        if (this._match('QMARK')) {
+            const consequent = this._expr();
+            this._consume('COLON', "Expected ':' in ternary expression");
+            const alternate = this._expr();
+            const node = { kind: 'TernaryExpr', condition: left, consequent, alternate };
+            left = node;
+        }
+        return left;
+    }
+    _or() {
+        let left = this._and();
+        while (this._checkIdent('or')) {
+            this._advance();
+            const right = this._and();
+            const node = { kind: 'LogicalExpr', op: 'or', left, right };
+            left = node;
+        }
+        return left;
+    }
+    _and() {
+        let left = this._not();
+        while (this._checkIdent('and')) {
+            this._advance();
+            const right = this._not();
+            const node = { kind: 'LogicalExpr', op: 'and', left, right };
+            left = node;
+        }
+        return left;
+    }
+    _not() {
+        if (this._checkIdent('not')) {
+            this._advance();
+            const operand = this._comparison();
+            const node = { kind: 'UnaryExpr', op: 'not', operand };
+            return node;
+        }
+        return this._comparison();
+    }
+    _comparison() {
+        let left = this._addition();
+        while (true) {
+            if (this._match('LTE')) {
+                left = this._binop('<=', left, this._addition());
+                continue;
+            }
+            if (this._match('GTE')) {
+                left = this._binop('>=', left, this._addition());
+                continue;
+            }
+            if (this._match('EQEQ')) {
+                left = this._binop('==', left, this._addition());
+                continue;
+            }
+            if (this._match('NEQ')) {
+                left = this._binop('!=', left, this._addition());
+                continue;
+            }
+            if (this._match('LT')) {
+                left = this._binop('<', left, this._addition());
+                continue;
+            }
+            if (this._match('GT')) {
+                left = this._binop('>', left, this._addition());
+                continue;
+            }
+            break;
+        }
+        return left;
+    }
+    _addition() {
+        let left = this._multiplication();
+        while (true) {
+            if (this._match('PLUS')) {
+                left = this._binop('+', left, this._multiplication());
+                continue;
+            }
+            if (this._match('MINUS')) {
+                left = this._binop('-', left, this._multiplication());
+                continue;
+            }
+            break;
+        }
+        return left;
+    }
+    _multiplication() {
+        let left = this._unary();
+        while (true) {
+            if (this._match('STAR')) {
+                left = this._binop('*', left, this._unary());
+                continue;
+            }
+            if (this._match('SLASH')) {
+                left = this._binop('/', left, this._unary());
+                continue;
+            }
+            if (this._match('PERCENT')) {
+                left = this._binop('%', left, this._unary());
+                continue;
+            }
+            break;
+        }
+        return left;
+    }
+    _unary() {
+        if (this._match('MINUS')) {
+            const operand = this._unary();
+            const node = { kind: 'UnaryExpr', op: '-', operand };
+            return node;
+        }
+        return this._primary();
+    }
+    _primary() {
+        const tok = this._current();
+        // Number literal
+        if (tok.kind === 'NUMBER') {
+            this._advance();
+            const node = { kind: 'NumberLit', value: parseFloat(tok.value) };
+            return node;
+        }
+        // String literal
+        if (tok.kind === 'STRING') {
+            this._advance();
+            const node = { kind: 'StringLit', value: tok.value };
+            return node;
+        }
+        // Bool literal
+        if (tok.kind === 'BOOL') {
+            this._advance();
+            const node = { kind: 'BoolLit', value: tok.value === 'true' };
+            return node;
+        }
+        // na (special NaN constant)
+        if (tok.kind === 'IDENT' && tok.value === 'na') {
+            this._advance();
+            const node = { kind: 'NumberLit', value: NaN };
+            return node;
+        }
+        // Function call: IDENT '(' args ')'
+        if (tok.kind === 'IDENT' && this._peekKind(1) === 'LPAREN') {
+            return this._callExpr();
+        }
+        // Identifier (and optional series index)
+        if (tok.kind === 'IDENT') {
+            this._advance();
+            let node = { kind: 'Identifier', name: tok.value };
+            // Series index: ident[expr]
+            while (this._check('LBRACKET')) {
+                this._advance();
+                const index = this._expr();
+                this._consume('RBRACKET', "Expected ']'");
+                const indexNode = { kind: 'IndexExpr', series: node, index };
+                node = indexNode;
+            }
+            return node;
+        }
+        // Grouped: '(' expr ')'
+        if (tok.kind === 'LPAREN') {
+            this._advance();
+            const inner = this._expr();
+            this._consume('RPAREN', "Expected ')'");
+            return inner;
+        }
+        throw new SyntaxError(`[TScript] Unexpected token '${tok.value}' (${tok.kind}) at ${tok.line}:${tok.col}`);
+    }
+    _callExpr() {
+        const callee = this._consume('IDENT', 'Expected function name').value;
+        this._consume('LPAREN', "Expected '('");
+        const args = [];
+        if (!this._check('RPAREN')) {
+            args.push(this._expr());
+            while (this._match('COMMA')) {
+                args.push(this._expr());
+            }
+        }
+        this._consume('RPAREN', "Expected ')'");
+        return { kind: 'CallExpr', callee, args };
+    }
+    // ─── Utility helpers ────────────────────────────────────────────────────────
+    _binop(op, left, right) {
+        return { kind: 'BinaryExpr', op, left, right };
+    }
+    _current() {
+        return this._tokens[this._pos];
+    }
+    _advance() {
+        return this._tokens[this._pos++];
+    }
+    _check(kind) {
+        return this._current().kind === kind;
+    }
+    _checkIdent(name) {
+        const t = this._current();
+        return t.kind === 'IDENT' && t.value === name;
+    }
+    _peekKind(offset) {
+        return this._tokens[this._pos + offset]?.kind ?? 'EOF';
+    }
+    _match(kind) {
+        if (this._check(kind)) {
+            this._advance();
+            return true;
+        }
+        return false;
+    }
+    _consume(kind, msg) {
+        if (this._check(kind))
+            return this._advance();
+        const t = this._current();
+        throw new SyntaxError(`[TScript] ${msg} — got '${t.value}' at ${t.line}:${t.col}`);
+    }
+    _consumeIdent(name) {
+        if (this._checkIdent(name))
+            return this._advance();
+        const t = this._current();
+        throw new SyntaxError(`[TScript] Expected '${name}' — got '${t.value}' at ${t.line}:${t.col}`);
+    }
+    _consumeNewlineOrEOF() {
+        // Silently accept NEWLINE or EOF; required at end of every statement.
+        if (this._check('NEWLINE') || this._check('EOF')) {
+            if (this._check('NEWLINE'))
+                this._advance();
+        }
+        // If neither, we just continue (expression statements don't need semicolons)
+    }
+    _skipNewlines() {
+        while (this._check('NEWLINE'))
+            this._advance();
+    }
+    _collapseNewlines(tokens) {
+        const out = [];
+        let lastWasNL = false;
+        for (const t of tokens) {
+            if (t.kind === 'NEWLINE') {
+                if (!lastWasNL)
+                    out.push(t);
+                lastWasNL = true;
+            }
+            else {
+                lastWasNL = false;
+                out.push(t);
+            }
+        }
+        return out;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _isStatementBoundary(_t) { return true; }
+}
+//# sourceMappingURL=parser.js.map

package/dist/tscript/parser.js.map

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

package/dist/tscript/runtime.d.ts

@@ -0,0 +1,123 @@
+/**
+ * TScript Runtime — tree-walking interpreter.
+ *
+ * Execution model
+ * ───────────────
+ * A TScript program is executed once per compiled bar in left-to-right,
+ * top-to-bottom statement order.  The runtime keeps a persistent `Scope`
+ * so that `Series` variables accumulate history across bars.
+ *
+ * Built-in series (available in every script):
+ *   open, high, low, close, volume, hl2, hlc3, ohlc4, bar_index
+ *
+ * Built-in TA functions:
+ *   sma(src, length)   — simple moving average
+ *   ema(src, length)   — exponential moving average
+ *   wma(src, length)   — weighted moving average
+ *   rma(src, length)   — Wilder's (RMA) moving average
+ *   stdev(src, length) — rolling standard deviation
+ *   highest(src, n)    — rolling max over n bars
+ *   lowest(src, n)     — rolling min over n bars
+ *   change(src, n?)    — src - src[n] (default n=1)
+ *   mom(src, length)   — momentum = change(src, length)
+ *   atr(length)        — Average True Range
+ *   crossover(a, b)    — a crosses above b
+ *   crossunder(a, b)   — a crosses below b
+ *   nz(x, y?)          — replace NaN with y (default 0)
+ *   na(x)              — true if x is NaN
+ *   abs(x)             — Math.abs
+ *   max(...)           — Math.max over args
+ *   min(...)           — Math.min over args
+ *   round(x)           — Math.round
+ *   floor(x)           — Math.floor
+ *   ceil(x)            — Math.ceil
+ *   sqrt(x)            — Math.sqrt
+ *   log(x)             — Math.log
+ *   pow(x, y)          — Math.pow
+ *   sign(x)            — Math.sign
+ *
+ * Built-in utility functions:
+ *   input(default, ...)  — returns the default value (params resolved externally)
+ *   plot(value, ...)     — records a value for the current bar
+ *   barssince(cond)      — bars since condition was true
+ */
+import type { OHLCV } from '@forgecharts/types';
+import { Series } from './series';
+import type { IndicatorPoint } from '../core/IndicatorEngine';
+/** A TScript value is a number, boolean, string, or Series. */
+export type TValue = number | boolean | string | Series;
+/** Scope maps variable names to their TScript values. */
+export type Scope = Map<string, TValue>;
+/** Result produced by a single script execution run. */
+export type ScriptResult = {
+    /** Title from indicator("...") declaration. */
+    title: string;
+    /** Collected plot() calls for this run, in declaration order. */
+    plots: IndicatorPoint[][];
+};
+export declare class TScriptRuntime {
+    private readonly _program;
+    private readonly _scope;
+    private readonly _plotSeries;
+    title: string;
+    constructor(src: string);
+    /**
+     * Execute one bar.
+     *
+     * Call this in chronological order for every OHLCV bar.
+     * The runtime updates all built-in series with the bar's OHLCV values,
+     * then re-executes the full program body.
+     *
+     * @returns the current values of all `plot()` series after this bar.
+     */
+    execBar(bar: OHLCV, barIndex: number): void;
+    /**
+     * Run the full bar history and return IndicatorPoint arrays indexed by
+     * plot() call order.
+     *
+     * @param bars   chronologically ordered OHLCV array
+     */
+    run(bars: readonly OHLCV[]): IndicatorPoint[][];
+    /**
+     * Snapshot the current plot series as IndicatorPoint arrays.
+     * Must be called after `run()` or after the last `execBar()`.
+     * @param bars the same bar array passed to run() — used for timestamps.
+     */
+    getPlots(bars: readonly OHLCV[]): IndicatorPoint[][];
+    /** Reset all persistent series state (call on symbol/timeframe change). */
+    reset(): void;
+    private _execStmt;
+    private _execAssign;
+    private _evalExpr;
+    private _evalIdent;
+    private _evalIndex;
+    private _evalBinary;
+    private _evalUnary;
+    private _evalTernary;
+    private _evalLogical;
+    private _plotIdx;
+    private _evalCall;
+    /** Resolve a call argument as a Series (wrapping scalar if needed). */
+    private _argSeries;
+    private _argInt;
+    private _ta_sma;
+    private _ta_ema;
+    private _ta_wma;
+    private _ta_rma;
+    private _ta_stdev;
+    private _ta_rolling;
+    private _ta_change;
+    private _ta_atr;
+    private _ta_crossover;
+    private _ta_crossunder;
+    private _ta_barssince;
+    /** Persistent scalar state for stateful TA functions (EMA, RMA, ATR). */
+    private readonly _internalState;
+    private _getInternalNum;
+    private _setInternal;
+    /** Push a value into a named built-in Series, creating it if needed. */
+    private _pushBuiltin;
+    /** Compute a simple rolling average directly from a Series (no state). */
+    private _smaOfSeries;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/tscript/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/tscript/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D,+DAA+D;AAC/D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,yDAAyD;AACzD,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExC,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,KAAK,EAAG,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,EAAG,cAAc,EAAE,EAAE,CAAC;CAC5B,CAAC;AAoBF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAG7C,KAAK,EAAE,MAAM,CAAY;gBAEb,GAAG,EAAE,MAAM;IAYvB;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqB3C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE;IAQ/C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE;IAapD,2EAA2E;IAC3E,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,SAAS;IA0EjB,uEAAuE;IACvE,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAUrB,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,wEAAwE;IACxE,OAAO,CAAC,YAAY;IASpB,0EAA0E;IAC1E,OAAO,CAAC,YAAY;CAKrB"}