@yakuzaa/jade-compiler 0.1.1 → 0.1.3

package/dist/linter/linter.js

@@ -0,0 +1,166 @@
+/**
+ * Linter JADE — analisa o AST e reporta problemas de estilo e qualidade.
+ *
+ * Regras implementadas:
+ *   NOME001  Entidade/Classe/Evento/Interface deve ser PascalCase
+ *   NOME002  Função/Serviço deve iniciar com letra minúscula
+ *   NOME003  Valores de enum devem ser UPPER_CASE
+ *   NOME004  Variável deve iniciar com letra minúscula
+ *   VAZIO001 Função com corpo vazio
+ *   VAZIO002 Entidade sem campos
+ *   VAZIO003 Serviço sem métodos nem ouvintes
+ *   PARAM001 Função com mais de 5 parâmetros
+ *   VAR001   Variável declarada sem tipo nem inicializador
+ *   MORT001  Código morto — instrução após retornar
+ */
+export class Linter {
+    warnings = [];
+    lint(program) {
+        this.warnings = [];
+        for (const decl of program.declaracoes) {
+            this.checkDeclaracao(decl);
+        }
+        return this.warnings;
+    }
+    // ── Declarações ──────────────────────────────────────────────────────────
+    checkDeclaracao(node) {
+        switch (node.kind) {
+            case 'Entidade':
+                this.checkEntidade(node);
+                break;
+            case 'Classe':
+                this.checkClasse(node);
+                break;
+            case 'Servico':
+                this.checkServico(node);
+                break;
+            case 'Funcao':
+                this.checkFuncao(node);
+                break;
+            case 'Evento':
+                this.checkEvento(node);
+                break;
+            case 'Interface':
+                this.checkInterface(node);
+                break;
+            case 'Enum':
+                this.checkEnum(node);
+                break;
+            case 'Modulo':
+                for (const d of node.declaracoes)
+                    this.checkDeclaracao(d);
+                break;
+        }
+    }
+    checkEntidade(node) {
+        this.assertPascalCase(node.nome, 'NOME001', 'Entidade', node.line, node.column);
+        if (node.campos.length === 0) {
+            this.warn('VAZIO002', `Entidade '${node.nome}' não tem campos`, node.line, node.column);
+        }
+    }
+    checkClasse(node) {
+        this.assertPascalCase(node.nome, 'NOME001', 'Classe', node.line, node.column);
+        for (const metodo of node.metodos)
+            this.checkFuncao(metodo);
+    }
+    checkServico(node) {
+        this.assertCamelCase(node.nome, 'NOME002', 'Serviço', node.line, node.column);
+        if (node.metodos.length === 0 && node.ouvintes.length === 0) {
+            this.warn('VAZIO003', `Serviço '${node.nome}' não tem métodos nem ouvintes`, node.line, node.column);
+        }
+        for (const metodo of node.metodos)
+            this.checkFuncao(metodo);
+        for (const ouvinte of node.ouvintes)
+            this.checkBloco(ouvinte.corpo);
+    }
+    checkFuncao(node) {
+        this.assertCamelCase(node.nome, 'NOME002', 'Função', node.line, node.column);
+        if (node.parametros.length > 5) {
+            this.warn('PARAM001', `Função '${node.nome}' tem ${node.parametros.length} parâmetros — considere agrupar em uma entidade`, node.line, node.column);
+        }
+        if (node.corpo.instrucoes.length === 0) {
+            this.warn('VAZIO001', `Função '${node.nome}' tem corpo vazio`, node.line, node.column);
+        }
+        this.checkBloco(node.corpo);
+    }
+    checkEvento(node) {
+        this.assertPascalCase(node.nome, 'NOME001', 'Evento', node.line, node.column);
+    }
+    checkInterface(node) {
+        this.assertPascalCase(node.nome, 'NOME001', 'Interface', node.line, node.column);
+    }
+    checkEnum(node) {
+        this.assertPascalCase(node.nome, 'NOME001', 'Enum', node.line, node.column);
+        for (const valor of node.valores) {
+            if (!this.isUpperCase(valor)) {
+                this.warn('NOME003', `Valor de enum '${valor}' deve ser UPPER_CASE (ex: ${valor.toUpperCase()})`, node.line, node.column);
+            }
+        }
+    }
+    // ── Bloco e instruções ───────────────────────────────────────────────────
+    checkBloco(bloco) {
+        const instrucoes = bloco.instrucoes;
+        for (let i = 0; i < instrucoes.length; i++) {
+            const instr = instrucoes[i];
+            this.checkInstrucao(instr);
+            // MORT001 — código morto após retornar
+            if (instr.kind === 'Retorno' && i < instrucoes.length - 1) {
+                const proxima = instrucoes[i + 1];
+                this.warn('MORT001', 'Código morto — instrução após retornar nunca será executada', proxima.line, proxima.column, 'error');
+                break; // não reporta múltiplos por bloco
+            }
+        }
+    }
+    checkInstrucao(node) {
+        switch (node.kind) {
+            case 'Variavel':
+                this.assertCamelCase(node.nome, 'NOME004', 'Variável', node.line, node.column);
+                if (!node.tipo && !node.inicializador) {
+                    this.warn('VAR001', `Variável '${node.nome}' declarada sem tipo nem valor inicial`, node.line, node.column);
+                }
+                break;
+            case 'Condicional':
+                this.checkBloco(node.entao);
+                if (node.senao)
+                    this.checkBloco(node.senao);
+                break;
+            case 'Enquanto':
+                this.checkBloco(node.corpo);
+                break;
+            case 'Para':
+                this.checkBloco(node.corpo);
+                break;
+        }
+    }
+    // ── Helpers de nomenclatura ──────────────────────────────────────────────
+    assertPascalCase(nome, code, tipo, line, col) {
+        if (!this.isPascalCase(nome)) {
+            this.warn(code, `${tipo} '${nome}' deve usar PascalCase (ex: ${this.toPascalCase(nome)})`, line, col);
+        }
+    }
+    assertCamelCase(nome, code, tipo, line, col) {
+        if (!this.isCamelCase(nome)) {
+            this.warn(code, `${tipo} '${nome}' deve iniciar com letra minúscula (ex: ${this.toCamelCase(nome)})`, line, col);
+        }
+    }
+    isPascalCase(nome) {
+        return /^[A-Z][a-zA-Z0-9]*$/.test(nome);
+    }
+    isCamelCase(nome) {
+        return /^[a-z][a-zA-Z0-9]*$/.test(nome);
+    }
+    isUpperCase(nome) {
+        return /^[A-Z][A-Z0-9_]*$/.test(nome);
+    }
+    toPascalCase(nome) {
+        return nome.charAt(0).toUpperCase() + nome.slice(1);
+    }
+    toCamelCase(nome) {
+        return nome.charAt(0).toLowerCase() + nome.slice(1);
+    }
+    // ── Emissão ──────────────────────────────────────────────────────────────
+    warn(code, message, line, column, severity = 'warning') {
+        this.warnings.push({ code, message, line, column, severity });
+    }
+}
+//# sourceMappingURL=linter.js.map

package/dist/linter/linter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../linter/linter.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,MAAM;IACT,QAAQ,GAAkB,EAAE,CAAC;IAErC,IAAI,CAAC,OAAuB;QAC1B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4EAA4E;IAEpE,eAAe,CAAC,IAAsB;QAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU;gBAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAAG,MAAM;YACrD,KAAK,QAAQ;gBAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAK,MAAM;YACrD,KAAK,SAAS;gBAAK,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAAI,MAAM;YACrD,KAAK,QAAQ;gBAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAK,MAAM;YACrD,KAAK,QAAQ;gBAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAK,MAAM;YACrD,KAAK,WAAW;gBAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM;YACrD,KAAK,MAAM;gBAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAAO,MAAM;YACrD,KAAK,QAAQ;gBACX,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW;oBAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM;QACV,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAAoB;QACxC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,IAAI,CAAC,IAAI,kBAAkB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,IAAkB;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9E,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAEO,YAAY,CAAC,IAAmB;QACtC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,IAAI,CAAC,IAAI,gCAAgC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvG,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAEO,WAAW,CAAC,IAAkB;QACpC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CACP,UAAU,EACV,WAAW,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,iDAAiD,EACpG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CACvB,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,IAAI,CAAC,IAAI,mBAAmB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,WAAW,CAAC,IAAkB;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC;IAEO,cAAc,CAAC,IAAqB;QAC1C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnF,CAAC;IAEO,SAAS,CAAC,IAAgB;QAChC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,CACP,SAAS,EACT,kBAAkB,KAAK,8BAA8B,KAAK,CAAC,WAAW,EAAE,GAAG,EAC3E,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CACvB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAEpE,UAAU,CAAC,KAAkB;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAE3B,uCAAuC;YACvC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,CACP,SAAS,EACT,6DAA6D,EAC7D,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAC5B,OAAO,CACR,CAAC;gBACF,MAAM,CAAC,kCAAkC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,IAAqB;QAC1C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU;gBACb,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC/E,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACtC,IAAI,CAAC,IAAI,CACP,QAAQ,EACR,aAAa,IAAI,CAAC,IAAI,wCAAwC,EAC9D,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CACvB,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,IAAI,CAAC,KAAK;oBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5B,MAAM;QACV,CAAC;IACH,CAAC;IAED,4EAA4E;IAEpE,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,GAAW;QAC1F,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CACP,IAAI,EACJ,GAAG,IAAI,KAAK,IAAI,+BAA+B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EACzE,IAAI,EAAE,GAAG,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,GAAW;QACzF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CACP,IAAI,EACJ,GAAG,IAAI,KAAK,IAAI,2CAA2C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EACpF,IAAI,EAAE,GAAG,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,4EAA4E;IAEpE,IAAI,CACV,IAAY,EACZ,OAAe,EACf,IAAY,EACZ,MAAc,EACd,WAAgC,SAAS;QAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/parser/parse_result.d.ts

@@ -3,6 +3,8 @@ export interface ParseError {
     message: string;
     line: number;
     column: number;
+    /** Dica educativa sobre como corrigir o erro */
+    dica?: string;
 }
 export interface ParseResult {
     program: ProgramaNode | null;

package/dist/parser/parse_result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse_result.d.ts","sourceRoot":"","sources":["../../parser/parse_result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"parse_result.d.ts","sourceRoot":"","sources":["../../parser/parse_result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/parser/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../parser/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAG5D,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,KAAK,EAAE;IAI3B,KAAK,IAAI,WAAW;IAkCpB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,iBAAiB;IA2EzB,OAAO,CAAC,UAAU;IA2BlB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,SAAS;IA8DjB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,wBAAwB;IA4GhC,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,aAAa;IA8HrB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,WAAW;CAuBpB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../parser/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AA8G5D,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,KAAK,EAAE;IAI3B,KAAK,IAAI,WAAW;IAgDpB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,iBAAiB;IA2EzB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,SAAS;IA+DjB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,wBAAwB;IA4GhC,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,aAAa;IAkIrB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,WAAW;CAuBpB"}

package/dist/parser/parser.js

@@ -1,4 +1,60 @@
 import { TokenType } from '../lexer/token_type.js';
+/**
+ * Tabela de dicas educativas para erros de sintaxe.
+ * Mapeamento: mensagem de erro → dica de como corrigir.
+ */
+const DICAS_PARSER = {
+    "Esperado nome do módulo": "Dê um nome ao módulo logo após a palavra 'modulo', ex: `modulo estoque`",
+    "Esperado 'fim' para fechar módulo": "Todo bloco 'modulo' precisa terminar com 'fim'",
+    "Esperado nome da classe": "Dê um nome à classe, ex: `classe Funcionario`",
+    "Esperado nome da superclasse": "Informe o nome da classe pai após 'extends', ex: `classe Gerente extends Funcionario`",
+    "Esperado nome da interface": "Informe o nome da interface após 'implements', ex: `classe Produto implements Estocavel`",
+    "Esperado 'fim' para fechar classe": "Todo bloco 'classe' precisa terminar com 'fim'",
+    "Esperado nome da entidade": "Dê um nome à entidade, ex: `entidade Produto`",
+    "Esperado 'fim' para fechar entidade": "Todo bloco 'entidade' precisa terminar com 'fim'",
+    "Esperado nome do serviço": "Dê um nome ao serviço, ex: `servico EstoqueService`",
+    "Esperado 'funcao' ou 'escutar' no serviço": "Dentro de um serviço só pode haver funções (`funcao nome()`) e ouvintes de evento (`escutar NomeEvento`)",
+    "Esperado 'fim' para fechar serviço": "Todo bloco 'servico' precisa terminar com 'fim'",
+    "Esperado nome da função": "Dê um nome à função, ex: `funcao calcularTotal()`",
+    "Esperado '('": "A declaração de função precisa de parênteses, mesmo sem parâmetros: `funcao nome()`",
+    "Esperado ')'": "Feche os parênteses — pode estar faltando ')' após os parâmetros ou argumentos",
+    "Esperado 'fim' para fechar função": "Todo bloco 'funcao' precisa terminar com 'fim'",
+    "Esperado nome do evento": "Dê um nome ao evento, ex: `evento PedidoCriado`",
+    "Esperado 'fim' para fechar evento": "Todo bloco 'evento' precisa terminar com 'fim'",
+    "Esperado nome da regra": "Dê um nome à regra, ex: `regra reposicaoAutomatica`",
+    "Esperado 'quando'": "A regra precisa de uma condição após o nome: `regra nome quando produto.estoque < 10`",
+    "Esperado 'entao'": "Após a condição do 'quando', use 'entao' para definir o que acontece: `quando x > 0 entao`",
+    "Esperado 'fim' para fechar regra": "Todo bloco 'regra' precisa terminar com 'fim'",
+    "Esperado 'funcao' na interface": "Interfaces só podem declarar assinaturas de função: `funcao nome(param: tipo) -> tipo`",
+    "Esperado nome da assinatura": "Dê um nome à assinatura da função na interface, ex: `funcao calcular(x: numero) -> numero`",
+    "Esperado '->'": "Informe o tipo de retorno após '->', ex: `funcao calcular() -> numero`",
+    "Esperado 'fim' para fechar interface": "Todo bloco 'interface' precisa terminar com 'fim'",
+    "Esperado nome do enum": "Dê um nome ao enum, ex: `enum StatusPedido`",
+    "Esperado valor do enum": "Liste os valores do enum, um por linha, em letras maiúsculas, ex: PENDENTE, CONFIRMADO, CANCELADO",
+    "Esperado 'fim' para fechar enum": "Todo bloco 'enum' precisa terminar com 'fim'",
+    "Esperado item importado": "Informe o item do módulo: `importar estoque.Produto`, ou use alias: `importar estoque como est`",
+    "Esperado alias": "Informe o nome alternativo após 'como', ex: `importar estoque como est`",
+    "Esperado nome da tela": "Dê um nome à tela, ex: `tela ListaProdutos \"Produtos\"`",
+    "Esperado título da tela entre aspas": "Informe o título da tela entre aspas logo após o nome: `tela ListaProdutos \"Lista de Produtos\"`",
+    "Esperado 'fim' para fechar tela": "Todo bloco 'tela' precisa terminar com 'fim'",
+    "Esperado tipo do elemento (tabela, formulario, botao, card)": "Use um dos tipos de elemento: tabela, formulario, botao, card, modal ou grafico",
+    "Esperado nome do elemento": "Dê um nome ao elemento da tela, ex: `tabela listagem`",
+    "Esperado nome da propriedade": "Informe o nome da propriedade seguido de ':', ex: `entidade: Produto`",
+    "Esperado ':' após nome da propriedade": "Use ':' para separar nome e valor da propriedade, ex: `titulo: \"Meu Título\"`",
+    "Esperado identificador": "Informe um nome válido (começa com letra, sem espaços)",
+    "Esperado valor para a propriedade": "O valor pode ser texto entre aspas, um identificador ou verdadeiro/falso",
+    "Esperado nome do campo": "O campo precisa de um nome seguido de ':', ex: `nome: texto`",
+    "Esperado ':'": "Use ':' para declarar o tipo do campo, ex: `preco: decimal`",
+    "Esperado '<'": "Especifique o tipo do elemento entre '<' e '>', ex: `lista<texto>` ou `lista<Produto>`",
+    "Esperado '>'": "Feche o tipo genérico com '>', ex: `lista<texto>` ou `mapa<texto, numero>`",
+    "Esperado tipo": "Informe um tipo válido: texto, numero, decimal, booleano, data, hora, id, lista<T> ou mapa<K,V>",
+    "Esperado nome da variável": "Dê um nome à variável, ex: `variavel total: numero` ou `variavel nome = \"João\"`",
+    "Esperado nome do membro após '.'": "Informe o nome do campo ou método após o ponto, ex: `produto.preco`",
+    "Esperado ')' após expressão": "Feche os parênteses da expressão",
+    "Esperado ')' após argumentos": "Feche os parênteses dos argumentos da função",
+    "Esperado nome do membro": "Informe o nome do campo ou método após o ponto",
+    "Esperado ','": "Separe os tipos com vírgula, ex: `mapa<texto, numero>`",
+};
 export class Parser {
     tokens;
     current = 0;
@@ -10,17 +66,33 @@ export class Parser {
         const declaracoes = [];
         while (!this.isAtEnd()) {
             try {
+                const before = this.current;
                 const declaracao = this.parseDeclaracao();
                 if (declaracao) {
                     declaracoes.push(declaracao);
                 }
+                else if (this.current === before) {
+                    // Token não reconhecido como declaração — registra erro e avança para não travar
+                    this.errors.push({
+                        message: `Token inesperado '${this.peek().value}' — esperado início de declaração (modulo, entidade, funcao, servico, etc.)`,
+                        line: this.peek().line,
+                        column: this.peek().column
+                    });
+                    this.advance();
+                }
             }
             catch (error) {
-                this.errors.push({
-                    message: error.message || 'Erro de sintaxe',
-                    line: this.peek().line,
-                    column: this.peek().column
-                });
+                // ParseError thrown by consume/error() already has line, column and dica
+                if (error && typeof error.line === 'number' && typeof error.column === 'number') {
+                    this.errors.push(error);
+                }
+                else {
+                    this.errors.push({
+                        message: error.message || 'Erro de sintaxe',
+                        line: this.peek().line,
+                        column: this.peek().column
+                    });
+                }
                 this.synchronize();
             }
         }
@@ -72,9 +144,15 @@ export class Parser {
         const nome = nomeToken.value;
         const declaracoes = [];
         while (!this.check(TokenType.FIM) && !this.isAtEnd()) {
+            const before = this.current;
             const declaracao = this.parseDeclaracao();
-            if (declaracao)
+            if (declaracao) {
                 declaracoes.push(declaracao);
+            }
+            else if (this.current === before) {
+                // Token não reconhecido dentro do módulo — lança erro para sair do loop
+                throw this.error(`Token inesperado '${this.peek().value}' dentro do módulo`, undefined, "Verifique se uma declaração está incompleta ou se há 'fim' faltando");
+            }
         }
         this.consume(TokenType.FIM, "Esperado 'fim' para fechar módulo");
         return {
@@ -125,7 +203,11 @@ export class Parser {
         const nome = nomeToken.value;
         const campos = [];
         while (!this.check(TokenType.FIM) && !this.isAtEnd()) {
+            const before = this.current;
             campos.push(this.parseCampo());
+            if (this.current === before) {
+                throw this.error(`Token inesperado '${this.peek().value}' na entidade — esperado nome de campo`);
+            }
         }
         this.consume(TokenType.FIM, "Esperado 'fim' para fechar entidade");
         return {
@@ -194,7 +276,11 @@ export class Parser {
         const nome = nomeToken.value;
         const campos = [];
         while (!this.check(TokenType.FIM) && !this.isAtEnd()) {
+            const before = this.current;
             campos.push(this.parseCampo());
+            if (this.current === before) {
+                throw this.error(`Token inesperado '${this.peek().value}' no evento — esperado nome de campo`);
+            }
         }
         this.consume(TokenType.FIM, "Esperado 'fim' para fechar evento");
         return {
@@ -311,10 +397,14 @@ export class Parser {
         const nomeToken = this.consume(TokenType.IDENTIFICADOR, "Esperado nome da tela");
         const nome = nomeToken.value;
         const tituloToken = this.consume(TokenType.LITERAL_TEXTO, "Esperado título da tela entre aspas");
-        const titulo = tituloToken.value;
+        const titulo = tituloToken.value.slice(1, -1);
         const elementos = [];
         while (!this.check(TokenType.FIM) && !this.isAtEnd()) {
+            const before = this.current;
             elementos.push(this.parseTelaElemento());
+            if (this.current === before) {
+                throw this.error(`Token inesperado '${this.peek().value}' na tela — esperado elemento (tabela, formulario, botao, card)`);
+            }
         }
         this.consume(TokenType.FIM, "Esperado 'fim' para fechar tela");
         return {
@@ -354,7 +444,7 @@ export class Parser {
             }
             else if (this.checkAny([
                 TokenType.IDENTIFICADOR,
-                TokenType.TIPO_TEXTO, TokenType.TIPO_NUMERO, TokenType.TIPO_DECIMAL,
+                TokenType.TIPO_TEXTO, TokenType.TIPO_NUMERO, TokenType.TIPO_DECIMAL, TokenType.TIPO_MOEDA,
                 TokenType.TIPO_BOOLEANO, TokenType.TIPO_DATA, TokenType.TIPO_HORA,
                 TokenType.TIPO_ID, TokenType.TIPO_LISTA, TokenType.TIPO_MAPA
             ])) {
@@ -373,7 +463,7 @@ export class Parser {
                     while (this.match(TokenType.VIRGULA)) {
                         lista.push(this.consumeAny([
                             TokenType.IDENTIFICADOR,
-                            TokenType.TIPO_TEXTO, TokenType.TIPO_NUMERO, TokenType.TIPO_DECIMAL,
+                            TokenType.TIPO_TEXTO, TokenType.TIPO_NUMERO, TokenType.TIPO_DECIMAL, TokenType.TIPO_MOEDA,
                             TokenType.TIPO_BOOLEANO, TokenType.TIPO_DATA, TokenType.TIPO_HORA,
                             TokenType.TIPO_ID
                         ], "Esperado identificador").value);
@@ -406,6 +496,7 @@ export class Parser {
             TokenType.TIPO_TEXTO,
             TokenType.TIPO_NUMERO,
             TokenType.TIPO_DECIMAL,
+            TokenType.TIPO_MOEDA,
             TokenType.TIPO_BOOLEANO,
             TokenType.TIPO_DATA,
             TokenType.TIPO_HORA,
@@ -431,6 +522,7 @@ export class Parser {
             TokenType.TIPO_TEXTO,
             TokenType.TIPO_NUMERO,
             TokenType.TIPO_DECIMAL,
+            TokenType.TIPO_MOEDA,
             TokenType.TIPO_BOOLEANO,
             TokenType.TIPO_DATA,
             TokenType.TIPO_HORA,
@@ -481,6 +573,7 @@ export class Parser {
             TokenType.TIPO_TEXTO,
             TokenType.TIPO_NUMERO,
             TokenType.TIPO_DECIMAL,
+            TokenType.TIPO_MOEDA,
             TokenType.TIPO_BOOLEANO,
             TokenType.TIPO_DATA,
             TokenType.TIPO_HORA,
@@ -531,7 +624,7 @@ export class Parser {
                 if (this.isAtEnd()) {
                     break;
                 }
-                throw this.error(`Parser travado: token inesperado ${this.peek().type}='${this.peek().value}'`);
+                throw this.error(`Token inesperado '${this.peek().value}' — verifique se um 'fim' está faltando acima desta linha`, undefined, "Erros desse tipo costumam acontecer quando um bloco (entidade, funcao, servico, se...) não foi fechado com 'fim'");
             }
         }
         return {
@@ -675,18 +768,20 @@ export class Parser {
         }
         // Token consumido mas não reconhecido como instrução válida
         // Volta o token para não perder (usando current--)
-        this.current--;
+        if (this.current > 0)
+            this.current--;
         return null;
     }
     parseRetorno() {
+        const retornarToken = this.previous(); // 'retornar' já consumido por match()
         let valor;
         if (!this.check(TokenType.FIM) && !this.check(TokenType.EOF)) {
             valor = this.parseExpressao();
         }
         return {
             kind: 'Retorno',
-            line: 1,
-            column: 1,
+            line: retornarToken.line,
+            column: retornarToken.column,
             valor
         };
     }
@@ -985,7 +1080,7 @@ export class Parser {
                     const membroToken = this.consumeAny([
                         TokenType.IDENTIFICADOR,
                         TokenType.TIPO_ID, TokenType.TIPO_TEXTO, TokenType.TIPO_NUMERO,
-                        TokenType.TIPO_DECIMAL, TokenType.TIPO_BOOLEANO, TokenType.TIPO_DATA,
+                        TokenType.TIPO_DECIMAL, TokenType.TIPO_MOEDA, TokenType.TIPO_BOOLEANO, TokenType.TIPO_DATA,
                         TokenType.TIPO_HORA, TokenType.TIPO_LISTA, TokenType.TIPO_MAPA, TokenType.TIPO_OBJETO
                     ], "Esperado nome do membro");
                     if (this.match(TokenType.ABRE_PAREN)) {
@@ -1011,7 +1106,7 @@ export class Parser {
                 nome: token.value
             };
         }
-        throw this.error(`Expressão inesperada: ${this.peek().value}`);
+        throw this.error(`Expressão inesperada: '${this.peek().value}'`, undefined, "Use um valor (número, texto, verdadeiro/falso), uma variável, chamada de função ou expressão entre parênteses");
     }
     // ── Utilitários ───────────────────────────────────────────
     peek() {
@@ -1046,27 +1141,28 @@ export class Parser {
         }
         return false;
     }
-    consume(type, message) {
+    consume(type, message, dica) {
         if (this.check(type))
             return this.advance();
-        throw this.error(message);
+        throw this.error(message, undefined, dica);
     }
-    consumeAny(types, message) {
+    consumeAny(types, message, dica) {
         for (const type of types) {
             if (this.check(type))
                 return this.advance();
         }
-        throw this.error(message);
+        throw this.error(message, undefined, dica);
     }
     isAtEnd() {
         return this.peek().type === TokenType.EOF;
     }
-    error(message, token) {
+    error(message, token, dica) {
         const errorToken = token || this.peek();
         return {
             message,
             line: errorToken.line,
-            column: errorToken.column
+            column: errorToken.column,
+            dica: dica ?? DICAS_PARSER[message]
         };
     }
     synchronize() {