@designliquido/delegua 1.15.4 → 1.15.5

package/umd/delegua.js

@@ -503,6 +503,10 @@ class AnalisadorSemantico extends analisador_semantico_base_1.AnalisadorSemantic
                         }
                     }
                 }
+                else if (declaracao.inicializador instanceof construtos_1.Chamada) {
+                    // Chamadas de método/função podem retornar vetores.
+                    // A validação detalhada é feita em tempo de execução.
+                }
                 else {
                     this.erro(declaracao.simbolo, `Atribuição inválida para '${declaracao.simbolo.lexema}': é esperado um vetor de elementos.`);
                 }
@@ -796,6 +800,29 @@ class AnalisadorSemantico extends analisador_semantico_base_1.AnalisadorSemantic
         // Verifica a condição
         return this.verificarCondicao(declaracao.condicaoEnquanto);
     }
+    async visitarDeclaracaoPara(declaracao) {
+        if (Array.isArray(declaracao.inicializador)) {
+            for (const inicializador of declaracao.inicializador) {
+                await inicializador.aceitar(this);
+            }
+        }
+        else if (declaracao.inicializador) {
+            await declaracao.inicializador.aceitar(this);
+        }
+        // O laço precisa visitar condição/incremento/corpo para registrar usos de variáveis.
+        if (declaracao.condicao) {
+            this.marcarVariaveisUsadasEmExpressao(declaracao.condicao);
+            await this.verificarCondicao(declaracao.condicao);
+        }
+        if (declaracao.incrementar) {
+            this.marcarVariaveisUsadasEmExpressao(declaracao.incrementar);
+            this.verificarExpressao(declaracao.incrementar);
+        }
+        for (const declaracaoCorpo of declaracao.corpo.declaracoes) {
+            await declaracaoCorpo.aceitar(this);
+        }
+        return Promise.resolve();
+    }
     visitarDeclaracaoParaCada(declaracao) {
         // Marca o vetor/dicionário como usado
         this.marcarVariaveisUsadasEmExpressao(declaracao.vetorOuDicionario);
@@ -1058,10 +1085,11 @@ class AnalisadorSemantico extends analisador_semantico_base_1.AnalisadorSemantic
             case construtos_1.Variavel:
                 let entidadeChamadaVariavel = chamada.entidadeChamada;
                 const nomeFuncao = entidadeChamadaVariavel.simbolo.lexema;
-                // Lista de funções built-in que não precisam ser declaradas
-                const funcoesBuiltIn = [
+                // Lista de funções embutidas que não precisam ser declaradas
+                const funcoesEmbutidas = [
                     'inteiro',
                     'real',
+                    'numero',
                     'número',
                     'texto',
                     'leia',
@@ -1070,8 +1098,8 @@ class AnalisadorSemantico extends analisador_semantico_base_1.AnalisadorSemantic
                 ];
                 // Classes/construtores geralmente começam com letra maiúscula
                 const pareceSerClasse = nomeFuncao[0] === nomeFuncao[0].toUpperCase();
-                // Só verifica se a função existe se não for built-in e não parecer ser classe
-                if (!funcoesBuiltIn.includes(nomeFuncao) &&
+                // Só verifica se a função existe se não for embutidas e não parecer ser classe
+                if (!funcoesEmbutidas.includes(nomeFuncao) &&
                     !pareceSerClasse &&
                     !this.funcoes[nomeFuncao] &&
                     !this.gerenciadorEscopos.buscar(nomeFuncao)) {
@@ -2318,7 +2346,10 @@ class AvaliadorSintatico extends avaliador_sintatico_base_1.AvaliadorSintaticoBa
             case delegua_2.default.TEXTO:
                 const simboloNumeroTexto = this.avancarEDevolverAnterior();
                 const tipoInferido = (0, inferenciador_1.inferirTipoVariavel)(simboloNumeroTexto.literal);
-                return new construtos_1.Literal(this.hashArquivo, Number(simboloNumeroTexto.linha), simboloNumeroTexto.literal, tipoInferido);
+                const delimitadorTexto = simboloNumeroTexto.tipo === delegua_2.default.TEXTO
+                    ? simboloNumeroTexto.delimitadorTexto
+                    : undefined;
+                return new construtos_1.Literal(this.hashArquivo, Number(simboloNumeroTexto.linha), simboloNumeroTexto.literal, tipoInferido, delimitadorTexto);
             case delegua_2.default.PARA:
                 const simboloPara = this.avancarEDevolverAnterior();
                 return await this.paraComoConstruto(simboloPara);
@@ -8316,7 +8347,7 @@ class AvaliadorSintaticoPrisma extends avaliador_sintatico_base_1.AvaliadorSinta
     inicializarPilhaEscopos() {
         this.pilhaEscopos = new pilha_escopos_1.PilhaEscopos();
         this.pilhaEscopos.empilhar(new informacao_escopo_1.InformacaoEscopo());
-        // Registrar funções nativas (built-ins) do Prisma no escopo do parser
+        // Registrar funções nativas (embutidos) do Prisma no escopo do parser
         // para evitar erros de variável não definida durante análise semântica
         this.pilhaEscopos.definirInformacoesVariavel('tipo', new informacao_elemento_sintatico_1.InformacaoElementoSintatico('tipo', 'função', true, [
             new informacao_elemento_sintatico_1.InformacaoElementoSintatico('valor', 'qualquer'),
@@ -13369,11 +13400,12 @@ exports.ListaCompreensao = ListaCompreensao;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Literal = void 0;
 class Literal {
-    constructor(hashArquivo, linha, valor, tipo = 'qualquer') {
+    constructor(hashArquivo, linha, valor, tipo = 'qualquer', delimitadorTexto) {
         this.linha = linha;
         this.hashArquivo = hashArquivo;
         this.valor = valor;
         this.tipo = tipo;
+        this.delimitadorTexto = delimitadorTexto;
     }
     async aceitar(visitante) {
         return await visitante.visitarExpressaoLiteral(this);
@@ -14999,6 +15031,7 @@ exports.Var = Var;
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EstilizadorDelegua = void 0;
+const formatadores_1 = require("../formatadores");
 /**
  * Estilizador de código para Delégua.
  * Aplica transformações no AST para enforcar convenções e melhorar qualidade do código.
@@ -15225,10 +15258,18 @@ class EstilizadorDelegua {
         this.modoValidacao = false;
         return violacoesEncontradas;
     }
+    estilizarEFormatar(declaracoes, opcoesFormatacao = {}) {
+        var _a;
+        const declaracoesEstilizadas = this.estilizar(declaracoes);
+        const formatador = new formatadores_1.FormatadorDelegua(opcoesFormatacao.quebraLinha || '\n', (_a = opcoesFormatacao.tamanhoIndentacao) !== null && _a !== void 0 ? _a : 4, {
+            delimitadorTexto: opcoesFormatacao.delimitadorTexto,
+        });
+        return formatador.formatar(declaracoesEstilizadas);
+    }
 }
 exports.EstilizadorDelegua = EstilizadorDelegua;
 
-},{}],125:[function(require,module,exports){
+},{"../formatadores":134}],125:[function(require,module,exports){
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -15642,13 +15683,23 @@ const delegua_1 = __importDefault(require("../tipos-de-simbolos/delegua"));
  * Normalmente usado por IDEs, mas pode ser usado por linha de comando ou programaticamente.
  */
 class FormatadorDelegua {
-    constructor(quebraLinha, tamanhoIndentacao = 4) {
+    constructor(quebraLinha, tamanhoIndentacao = 4, opcoes = {}) {
         this.quebraLinha = quebraLinha;
         this.tamanhoIndentacao = tamanhoIndentacao;
         this.indentacaoAtual = 0;
         this.codigoFormatado = '';
         this.devePularLinha = true;
         this.deveIndentar = true;
+        this.delimitadorTexto = opcoes.delimitadorTexto || 'aspas-simples';
+    }
+    obterDelimitadorTexto(expressao) {
+        if (this.delimitadorTexto === 'aspas-duplas') {
+            return '"';
+        }
+        if (this.delimitadorTexto === 'preservar' && expressao.delimitadorTexto) {
+            return expressao.delimitadorTexto;
+        }
+        return "'";
     }
     /* istanbul ignore next */
     visitarExpressaoTuplaN(expressao) {
@@ -15688,7 +15739,7 @@ class FormatadorDelegua {
     }
     visitarDeclaracaoComentario(declaracao) {
         if (declaracao.multilinha) {
-            this.codigoFormatado += `${' '.repeat(this.indentacaoAtual)}/* `;
+            this.codigoFormatado += `${' '.repeat(this.indentacaoAtual)}/*${this.quebraLinha}`;
             for (let linhaConteudo of declaracao.conteudo) {
                 this.codigoFormatado += `${' '.repeat(this.indentacaoAtual)}  ${linhaConteudo.replace(/\s+/g, ' ')}${this.quebraLinha}`;
             }
@@ -16147,13 +16198,19 @@ class FormatadorDelegua {
     }
     visitarExpressaoLiteral(expressao) {
         if (typeof expressao.valor === 'string') {
-            const valorStr = expressao.valor
+            const delimitador = this.obterDelimitadorTexto(expressao);
+            let valorTexto = expressao.valor
                 .replace(/\\/g, '\\\\')
                 .replace(/\r/g, '\\r')
                 .replace(/\n/g, '\\n')
-                .replace(/\t/g, '\\t')
-                .replace(/'/g, "\\'");
-            this.codigoFormatado += `'${valorStr}'`;
+                .replace(/\t/g, '\\t');
+            if (delimitador === "'") {
+                valorTexto = valorTexto.replace(/'/g, "\\'");
+            }
+            else {
+                valorTexto = valorTexto.replace(/"/g, '\\"');
+            }
+            this.codigoFormatado += `${delimitador}${valorTexto}${delimitador}`;
             return;
         }
         if (['logico', 'lógico'].includes(expressao.tipo)) {
@@ -16271,6 +16328,9 @@ class FormatadorDelegua {
             case declaracoes_1.Classe:
                 this.visitarDeclaracaoClasse(declaracaoOuConstruto);
                 break;
+            case declaracoes_1.Comentario:
+                this.visitarDeclaracaoComentario(declaracaoOuConstruto);
+                break;
             case declaracoes_1.Continua:
                 this.visitarExpressaoContinua(declaracaoOuConstruto);
                 break;
@@ -17173,7 +17233,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./avaliador-sintatico-interface"), exports);
 __exportStar(require("./componente-modulo-classe-interface"), exports);
 __exportStar(require("./componente-modulo-funcao-interface"), exports);
-__exportStar(require("./estilizador-comum-interface"), exports);
+__exportStar(require("./estilizador/estilizador-interface"), exports);
 __exportStar(require("./formatador-comum-interface"), exports);
 __exportStar(require("./interpretador-com-depuracao-interface"), exports);
 __exportStar(require("./interpretador-interface"), exports);
@@ -17194,7 +17254,7 @@ __exportStar(require("./construtos"), exports);
 __exportStar(require("./erros"), exports);
 __exportStar(require("./retornos"), exports);
 
-},{"./avaliador-sintatico-interface":139,"./componente-modulo-classe-interface":140,"./componente-modulo-funcao-interface":141,"./construtos":142,"./erros":146,"./estilizador-comum-interface":147,"./formatador-comum-interface":148,"./interpretador-com-depuracao-interface":150,"./interpretador-interface":151,"./lexador-interface":152,"./modulo-interface":153,"./parametro-interface":154,"./pilha-interface":155,"./primitiva-interface":156,"./resolvedor-interface":157,"./resultado-parcial-interpretador-interface":158,"./retornos":159,"./retornos/retorno-execucao-interface":162,"./simbolo-interface":165,"./tradutor-interface":166,"./variavel-interface":167,"./visitante-comum-interface":168,"./visitante-delegua-interface":169}],150:[function(require,module,exports){
+},{"./avaliador-sintatico-interface":139,"./componente-modulo-classe-interface":140,"./componente-modulo-funcao-interface":141,"./construtos":142,"./erros":146,"./estilizador/estilizador-interface":147,"./formatador-comum-interface":148,"./interpretador-com-depuracao-interface":150,"./interpretador-interface":151,"./lexador-interface":152,"./modulo-interface":153,"./parametro-interface":154,"./pilha-interface":155,"./primitiva-interface":156,"./resolvedor-interface":157,"./resultado-parcial-interpretador-interface":158,"./retornos":159,"./retornos/retorno-execucao-interface":162,"./simbolo-interface":165,"./tradutor-interface":166,"./variavel-interface":167,"./visitante-comum-interface":168,"./visitante-delegua-interface":169}],150:[function(require,module,exports){
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 
@@ -26131,6 +26191,8 @@ class Lexador {
             if (caractere === delimitador) {
                 this.avancar();
                 this.adicionarSimbolo(delegua_1.default.TEXTO, valor);
+                const ultimoSimbolo = this.simbolos[this.simbolos.length - 1];
+                ultimoSimbolo.delimitadorTexto = delimitador;
                 return;
             }
             if (caractere === '\0' && this.eUltimaLinha()) {
@@ -26739,11 +26801,11 @@ function obterMapaLexemaParaParadigma() {
  */
 function obterFormaAlternativa(lexema, paradigmaAlvo) {
     var _a, _b;
-    const lexemaLower = lexema.toLowerCase();
+    const lexemaMinusculo = lexema.toLowerCase();
     // Encontra o grupo que contém este lexema
     for (const grupo of exports.gruposPalavrasParadigma) {
-        const temImperativo = (_a = grupo.imperativo) === null || _a === void 0 ? void 0 : _a.some((p) => p === lexemaLower);
-        const temInfinitivo = (_b = grupo.infinitivo) === null || _b === void 0 ? void 0 : _b.some((p) => p === lexemaLower);
+        const temImperativo = (_a = grupo.imperativo) === null || _a === void 0 ? void 0 : _a.some((p) => p === lexemaMinusculo);
+        const temInfinitivo = (_b = grupo.infinitivo) === null || _b === void 0 ? void 0 : _b.some((p) => p === lexemaMinusculo);
         if (temImperativo || temInfinitivo) {
             // Retorna a primeira forma do paradigma alvo
             if (paradigmaAlvo === 'imperativo' && grupo.imperativo && grupo.imperativo.length > 0) {
@@ -27337,7 +27399,7 @@ exports.palavrasReservadasMicroGramatica = {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Simbolo = void 0;
 class Simbolo {
-    constructor(tipo, lexema, literal, linha, hashArquivo, colunaInicio = 0, colunaFim = 0) {
+    constructor(tipo, lexema, literal, linha, hashArquivo, colunaInicio = 0, colunaFim = 0, delimitadorTexto) {
         this.tipo = tipo;
         this.lexema = lexema;
         this.literal = literal;
@@ -27345,6 +27407,7 @@ class Simbolo {
         this.hashArquivo = hashArquivo;
         this.colunaInicio = colunaInicio;
         this.colunaFim = colunaFim;
+        this.delimitadorTexto = delimitadorTexto;
     }
     paraTexto() {
         return this.tipo + ' ' + this.lexema + ' ' + this.literal;
@@ -43475,7 +43538,7 @@ class TradutorAssemblyScript {
     }
     traduzirDeclaracaoTendoComo(declaracaoTendoComo) {
         // TendoComo is a resource management pattern (like try-with-resources in Java)
-        // AssemblyScript doesn't have built-in support, so we'll just treat it as a scope
+        // AssemblyScript doesn't have embutidos support, so we'll just treat it as a scope
         let resultado = `// tendo ${declaracaoTendoComo.simboloVariavel.lexema} como recurso\n`;
         resultado += ' '.repeat(this.indentacao);
         resultado += `let ${declaracaoTendoComo.simboloVariavel.lexema} = `;
@@ -44824,7 +44887,7 @@ class TradutorElixir {
         return Promise.resolve(`${objeto}.${metodo}`);
     }
     /**
-     * Mapeia métodos built-in de Delégua para Elixir
+     * Mapeia métodos embutidos de Delégua para Elixir
      */
     mapearMetodoBuiltIn(metodo, objeto, argumentos) {
         switch (metodo) {
@@ -44956,7 +45019,7 @@ class TradutorElixir {
             const acessoMetodo = expressao.entidadeChamada;
             const objeto = await acessoMetodo.objeto.aceitar(this);
             const metodo = this.converterIdentificador(acessoMetodo.nomeMetodo);
-            // Mapear métodos built-in
+            // Mapear métodos embutidos
             const metodoMapeado = this.mapearMetodoBuiltIn(metodo, objeto, argumentos);
             if (metodoMapeado) {
                 return Promise.resolve(metodoMapeado);
@@ -44968,7 +45031,7 @@ class TradutorElixir {
             const acesso = expressao.entidadeChamada;
             const objeto = await acesso.objeto.aceitar(this);
             const simbolo = this.converterIdentificador(acesso.simbolo.lexema);
-            // Mapear métodos built-in
+            // Mapear métodos embutidos
             const metodoMapeado = this.mapearMetodoBuiltIn(simbolo, objeto, argumentos);
             if (metodoMapeado) {
                 return Promise.resolve(metodoMapeado);

package/interfaces/estilizador-comum-interface.d.ts

@@ -1,85 +0,0 @@
-import { Declaracao } from '../declaracoes/declaracao';
-import { Construto } from '../construtos';
-/**
- * Define uma regra de transformação/estilização de código.
- */
-export interface RegraEstilizacao {
-    /**
-     * Nome da regra para identificação e logs.
-     */
-    nome: string;
-    /**
-     * Descrição do que a regra faz.
-     */
-    descricao: string;
-    /**
-     * Aplica a regra em uma declaração.
-     * @param declaracao A declaração a ser verificada/transformada.
-     * @returns A declaração (modificada ou não).
-     */
-    aplicarEmDeclaracao?(declaracao: Declaracao): Declaracao;
-    /**
-     * Aplica a regra em um construto.
-     * @param construto O construto a ser verificado/transformado.
-     * @returns O construto (modificado ou não).
-     */
-    aplicarEmConstruto?(construto: Construto): Construto;
-}
-/**
- * Interface base para estilizadores de código.
- * Um estilizador aplica transformações no AST para enforcar convenções e melhorar a qualidade do código.
- */
-export interface EstilizadorComumInterface {
-    /**
-     * Regras de estilização ativas.
-     */
-    regras: RegraEstilizacao[];
-    /**
-     * Adiciona uma regra de estilização.
-     * @param regra A regra a ser adicionada.
-     */
-    adicionarRegra(regra: RegraEstilizacao): void;
-    /**
-     * Remove uma regra de estilização pelo nome.
-     * @param nomeRegra O nome da regra a ser removida.
-     */
-    removerRegra(nomeRegra: string): void;
-    /**
-     * Aplica as regras de estilização em um conjunto de declarações.
-     * @param declaracoes As declarações a serem estilizadas.
-     * @returns As declarações estilizadas (modificadas ou não).
-     */
-    estilizar(declaracoes: Declaracao[]): Declaracao[];
-    /**
-     * Valida se o código atende todas as regras sem aplicar transformações.
-     * @param declaracoes As declarações a serem validadas.
-     * @returns Array de violações encontradas.
-     */
-    validar(declaracoes: Declaracao[]): ViolacaoEstilo[];
-}
-/**
- * Representa uma violação de estilo encontrada.
- */
-export interface ViolacaoEstilo {
-    /**
-     * Nome da regra violada.
-     */
-    regra: string;
-    /**
-     * Mensagem descritiva da violação.
-     */
-    mensagem: string;
-    /**
-     * Linha onde a violação ocorreu.
-     */
-    linha: number;
-    /**
-     * Hash do arquivo onde a violação ocorreu.
-     */
-    hashArquivo: number;
-    /**
-     * Severidade da violação.
-     */
-    severidade: 'erro' | 'aviso' | 'informacao';
-}
-//# sourceMappingURL=estilizador-comum-interface.d.ts.map

package/interfaces/estilizador-comum-interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"estilizador-comum-interface.d.ts","sourceRoot":"","sources":["../../fontes/interfaces/estilizador-comum-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;IAEzD;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE9C;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IAEnD;;;;OAIG;IACH,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;CAC/C"}

package/interfaces/estilizador-comum-interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"estilizador-comum-interface.js","sourceRoot":"","sources":["../../fontes/interfaces/estilizador-comum-interface.ts"],"names":[],"mappings":""}