Bem-vindo ao NeuroScript® v0.2.2

NeuroScript® é a linguagem proprietária do Futura Broker para criação de indicadores técnicos sob medida. Ela entrega uma sintaxe inspirada no Pine Script v6 com execução determinística bar-by-bar, controle estrito de recursos e integração nativa com o Trade Room.

Status da Versão Atual

• Versão: 0.2.2
• Data: 2025-10-30
• Cobertura prioritária: ~80% das features essenciais do Pine Script v6
• Funções stdlib: 79 funções estáveis (math, ta, plot, input, tempo, cores) + arrays em estágio beta
• Integração oficial: NeuroScriptExecutor + primitives (NeuroLine, NeuroFill, NeuroHLine)

Entregas concluídas

• Pipeline completo: lexer, parser e AST type-safe com análise semântica
• Runtime: interpreter com contexto persistente, buffers circulares, suporte a var e controle de erros
• Biblioteca padrão: indicadores de tendência/volatilidade, helpers de série, namespace de cores e inputs configuráveis
• Editor Monaco: autocomplete contextual, hover docs, diagnósticos e temas customizados
• Chart primitives: linhas, fills e horizontais com suporte a panes separados (overlay=false)
• Performance: execução estável em 1000+ candles (~5 ms/barra) com footprint médio de 2–3 MB/script

Compatibilidade com Pine Script v6

O foco é entregar a experiência principal de indicadores:

• Declarações indicator() e strategy() (em progresso) com metadados completos
• Tipagem forte, operadores aritméticos/lógicos e ternário
• Funções padrão (ta.*, math.*, color.*, input.*) compatíveis com os casos de uso mais comuns
• Suporte a arrays numéricos em beta (APIs array.new, array.set, array.get, array.push, array.pop, array.max, array.min, array.size)
• Execução bar-by-bar com acesso histórico via buffers (series[offset])

Importante — Recursos ainda não liberados em produção: camada de segurança (sandbox) e backend neuroscript-api. Ambos são bloqueadores para rollout público e estão priorizados na trilha v1.0.

Funcionalidades principais

Sintaxe familiar e intuitiva

// Simple Moving Average
indicator("SMA 20", overlay=true)

length = input.int(20, "Period")
sma = ta.sma(close, length)
plot(sma, "SMA", color=color.blue, linewidth=2)

return sma

Standard Library (79 funções estáveis + arrays beta)

• Math (19): abs, ceil, floor, round, max, min, sqrt, pow, exp, log, sin, cos, tan, acos, asin, atan, atan2, sign, log10
• TA Moving Averages (6): sma, ema, wma, rma, vwma, hma
• TA Oscillators (6): rsi, macd, stoch, cci, mfi, wpr
• TA Volatility (5): tr, atr, stdev, bb, bbw
• TA Trend (4): adx, aroon, sar, supertrend
• TA Volume (2): obv, vwap
• TA Helpers (8): highest, lowest, crossover, crossunder, pivothigh, pivotlow, change, nz
• Plot (3): plot, fill, hline
• Input (6): int, float, bool, string, source, color
• Time/Bar (11): bar_index, time, year, month, day, hour, minute, second, dayofweek, dayofmonth, barstate
• Color (6): new, rgb, from_gradient + 17 constantes (aqua, black, blue, green, red, etc)
• Arrays (8) (beta): new, set, get, push, pop, max, min, size — limitados a tipos numéricos neste release

Operadores suportados

• Aritméticos: +, -, *, /, %
• Comparação: ==, !=, >, <, >=, <=
• Lógicos: and, or, not
• Assignment: =, +=, -=, *=, /=
• Ternário: ? :

Execução bar-by-bar

O NeuroScript utiliza o mesmo modelo de execução do Pine Script: cada barra é processada sequencialmente, permitindo acesso ao histórico de valores através de séries temporais.

IDE completo com Monaco Editor

• IntelliSense com autocomplete inteligente
• Syntax highlighting otimizado
• Hover documentation em tempo real
• Error diagnostics instantâneos
• Temas dark/light disponíveis

Requisitos e filosofia

Nosso objetivo é manter o NeuroScript® acessível e fácil de entender para o maior público possível. Embora seja uma linguagem especializada e não evolua para uma linguagem de propósito geral, estamos constantemente aprimorando suas capacidades dentro do escopo de análise técnica.

Como cada script utiliza recursos computacionais, aplicamos limites justos para garantir performance consistente para todos os usuários:

• Timeout: 5s por execução de barra
• Memory limit: ~2-3MB por script
• Performance: 10ms por barra em scripts típicos

Esses limites são estabelecidos para compartilhar recursos de forma equitativa e garantir que a plataforma funcione sem problemas para toda a comunidade.

Primeiros passos

1. Guia rápido

Guia Rápido - Aprenda o básico da linguagem em 10 minutos

2. Referência da linguagem

Linguagem - Sintaxe, tipos, operadores e modelo de execução

3. Standard Library

Conceitos - Referência completa de 79 funções estáveis + APIs beta

4. Exemplos práticos

Exemplos - 15 scripts prontos para usar: SMA, EMA crossover, RSI, MACD, Bollinger Bands, etc

Executar no Futura Broker

Performance

• Compilação: ~10-20ms
• Execução por barra: ~5ms
• Total (1000 barras): ~5s
• Memória: ~2-3MB por script
• Rendering: 60fps constantes

Roadmap para v1.0 (Production-Ready)