@designliquido/delegua-node 0.7.0 → 0.9.0

package/README.md

@@ -1,80 +1,80 @@
-# delegua-node
-
-Versão de Delégua com suporte a importação de pacotes pelo ecossistema do Node.js.
-
-## Motivação
-
-Em versões anteriores, o suporte ao ecossistema Node vinha embutido no pacote do núcleo da linguagem. Isso virou um problema quando tentamos importar o pacote numa aplicação com [Webpack](https://webpack.js.org/). 
-
-Como o Webpack tenta ler todas as referências de todos os módulos recursivamente, independente se estamos importando um módulo ou vários, há problemas quando tentamos importar `node:child_process` na parte de navegador de internet e as aplicações falham.
-
-### Implicações
-
-Se sua aplicação:
-
-- Precisa suportar importações, seja de outros fontes, seja de bibliotecas NPM
-- Pode executar no ambiente Node.js
-
-Ela pode, então, usar este pacote. Caso contrário, o uso apenas do núcleo da linguagem é uma escolha melhor.
-
-## Instalação
-
-Se quiser instalar no seu computador,
-[você deve ter antes o Node.js instalado em seu ambiente](https://dicasdejavascript.com.br/instalacao-do-nodejs-e-npm-no-windows-passo-a-passo).
-
-Com o Node.js instalado, execute o seguinte comando em um _prompt_ de comando (Terminal, PowerShell ou `cmd` no Windows, Terminal ou `sh` em Mac e Linux):
-
-```
-npm install -g delegua
-```
-
-### Usando como LAIR (Leia-Avalie-Imprima-Repita) em console
-
-Feita a instalação no seu ambiente, execute o seguinte comando:
-
-```
-delegua
-```
-
-Você terá um interpretador Delégua que avalia expressões linha a linha.
-
-Um exemplo de uso é como uma calculadora:
-
-```js
-delegua> 2 + 2
-4
-
-delegua> 2 * 3
-6
-
-delegua> 2 ** 10
-1024
-```
-
-Para finalizar a execução do interpretador LAIR Delégua, use o atalho <key>Ctrl</key> + <key>C</key> (todos os sistemas operacionais).
-
-#### Dialetos que suportam o modo LAIR
-
-- Delégua
-- Égua Clássico
-- EguaP
-
-### Executando arquivos
-
-É possível usar o interpretador com outros dialetos, como Égua.
-
-```
-delegua --dialeto egua
-```
-
-[Veja aqui todos os dialetos suportados](https://github.com/DesignLiquido/delegua/wiki/Dialetos).
-
-Se não quiser instalar as bibliotecas que acompanham Delégua, apenas [o núcleo da linguagem](https://github.com/DesignLiquido/delegua) pode ser instalado:
-
-```
-npm install -g @designliquido/delegua
-```
-
-## Tradução para outras linguagens
-
-Delégua traduz para JavaScript e vice-versa. [Mais informações aqui](https://github.com/DesignLiquido/delegua/wiki/Tradu%C3%A7%C3%A3o-para-outras-linguagens). 
+# delegua-node
+
+Versão de Delégua com suporte a importação de pacotes pelo ecossistema do Node.js.
+
+## Motivação
+
+Em versões anteriores, o suporte ao ecossistema Node vinha embutido no pacote do núcleo da linguagem. Isso virou um problema quando tentamos importar o pacote numa aplicação com [Webpack](https://webpack.js.org/). 
+
+Como o Webpack tenta ler todas as referências de todos os módulos recursivamente, independente se estamos importando um módulo ou vários, há problemas quando tentamos importar `node:child_process` na parte de navegador de internet e as aplicações falham.
+
+### Implicações
+
+Se sua aplicação:
+
+- Precisa suportar importações, seja de outros fontes, seja de bibliotecas NPM
+- Pode executar no ambiente Node.js
+
+Ela pode, então, usar este pacote. Caso contrário, o uso apenas do núcleo da linguagem é uma escolha melhor.
+
+## Instalação
+
+Se quiser instalar no seu computador,
+[você deve ter antes o Node.js instalado em seu ambiente](https://dicasdejavascript.com.br/instalacao-do-nodejs-e-npm-no-windows-passo-a-passo).
+
+Com o Node.js instalado, execute o seguinte comando em um _prompt_ de comando (Terminal, PowerShell ou `cmd` no Windows, Terminal ou `sh` em Mac e Linux):
+
+```
+npm install -g delegua
+```
+
+### Usando como LAIR (Leia-Avalie-Imprima-Repita) em console
+
+Feita a instalação no seu ambiente, execute o seguinte comando:
+
+```
+delegua
+```
+
+Você terá um interpretador Delégua que avalia expressões linha a linha.
+
+Um exemplo de uso é como uma calculadora:
+
+```js
+delegua> 2 + 2
+4
+
+delegua> 2 * 3
+6
+
+delegua> 2 ** 10
+1024
+```
+
+Para finalizar a execução do interpretador LAIR Delégua, use o atalho <key>Ctrl</key> + <key>C</key> (todos os sistemas operacionais).
+
+#### Dialetos que suportam o modo LAIR
+
+- Delégua
+- Égua Clássico
+- EguaP
+
+### Executando arquivos
+
+É possível usar o interpretador com outros dialetos, como Égua.
+
+```
+delegua --dialeto egua
+```
+
+[Veja aqui todos os dialetos suportados](https://github.com/DesignLiquido/delegua/wiki/Dialetos).
+
+Se não quiser instalar as bibliotecas que acompanham Delégua, apenas [o núcleo da linguagem](https://github.com/DesignLiquido/delegua) pode ser instalado:
+
+```
+npm install -g @designliquido/delegua
+```
+
+## Tradução para outras linguagens
+
+Delégua traduz para JavaScript e vice-versa. [Mais informações aqui](https://github.com/DesignLiquido/delegua/wiki/Tradu%C3%A7%C3%A3o-para-outras-linguagens). 

package/bin/delegua

@@ -1,3 +1,3 @@
-#! /usr/bin/env node
-
+#! /usr/bin/env node
+
 require('../execucao.js');

package/bin/package.json

@@ -1,36 +1,36 @@
-{
-    "name": "@designliquido/delegua-node",
-    "version": "0.6.0",
-    "description": "Linguagem Delégua com capacidades para ecossistema Node.js.",
-    "scripts": {
-        "empacotar": "rimraf ./dist && tsc && copyfiles -V ./bin/delegua ./bin/delegua.cmd ./dist && copyfiles -V ./package.json ./dist/bin && copyfiles -V ./README.md ./dist",
-        "testes-unitarios": "jest --coverage",
-        "testes:egua": "./bin/delegua-ts exemplos/dialetos/egua-classico/testes.egua",
-        "testes:delegua:bhaskara": "./bin/delegua-ts exemplos/dialetos/egua-classico/bhaskara.egua",
-        "testes:delegua:fibonacci": "./bin/delegua-ts exemplos/dialetos/egua-classico/fibonacci.egua",
-        "testes:egua-classico": "./bin/delegua-ts --dialeto egua exemplos/dialetos/egua-classico/testes.egua",
-        "testes:servidor-depuracao": "ts-node ./fontes/depuracao/servidor-depuracao.ts"
-    },
-    "dependencies": {
-        "@designliquido/delegua": "^0.14.7",
-        "chalk": "4.1.2",
-        "commander": "^9.4.1"
-    },
-    "devDependencies": {
-        "@designliquido/delegua-estatistica": "^0.0.5",
-        "@designliquido/delegua-fisica": "^0.0.2",
-        "@designliquido/delegua-json": "^0.0.0",
-        "@designliquido/delegua-matematica": "^0.2.0",
-        "@designliquido/delegua-tempo": "^0.0.1",
-        "@types/estree": "^1.0.0",
-        "@types/jest": "^29.4.0",
-        "@types/node": "^18.11.19",
-        "copyfiles": "^2.4.1",
-        "jest": "^29.4.1",
-        "release-it": "^15.6.0",
-        "rimraf": "^4.1.2",
-        "ts-jest": "^29.0.5",
-        "ts-node": "^10.9.1",
-        "typescript": "^4.9.5"
-    }
-}
+{
+    "name": "@designliquido/delegua-node",
+    "version": "0.8.0",
+    "description": "Linguagem Delégua com capacidades para ecossistema Node.js.",
+    "scripts": {
+        "empacotar": "rimraf ./dist && tsc && copyfiles -V ./bin/delegua ./bin/delegua.cmd ./dist && copyfiles -V ./package.json ./dist/bin && copyfiles -V ./README.md ./dist",
+        "testes-unitarios": "jest --coverage",
+        "testes:egua": "./bin/delegua-ts exemplos/dialetos/egua-classico/testes.egua",
+        "testes:delegua:bhaskara": "./bin/delegua-ts exemplos/dialetos/egua-classico/bhaskara.egua",
+        "testes:delegua:fibonacci": "./bin/delegua-ts exemplos/dialetos/egua-classico/fibonacci.egua",
+        "testes:egua-classico": "./bin/delegua-ts --dialeto egua exemplos/dialetos/egua-classico/testes.egua",
+        "testes:servidor-depuracao": "ts-node ./fontes/depuracao/servidor-depuracao.ts"
+    },
+    "dependencies": {
+        "@designliquido/delegua": "^0.15.0",
+        "chalk": "4.1.2",
+        "commander": "^9.4.1"
+    },
+    "devDependencies": {
+        "@designliquido/delegua-estatistica": "^0.0.5",
+        "@designliquido/delegua-fisica": "^0.0.2",
+        "@designliquido/delegua-json": "^0.0.0",
+        "@designliquido/delegua-matematica": "^0.2.0",
+        "@designliquido/delegua-tempo": "^0.0.1",
+        "@types/estree": "^1.0.0",
+        "@types/jest": "^29.4.0",
+        "@types/node": "^18.11.19",
+        "copyfiles": "^2.4.1",
+        "jest": "^29.4.1",
+        "release-it": "^15.6.0",
+        "rimraf": "^4.1.2",
+        "ts-jest": "^29.0.5",
+        "ts-node": "^10.9.1",
+        "typescript": "^4.9.5"
+    }
+}

package/execucao.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/execucao.js

@@ -1,43 +1,43 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const delegua_1 = require("./fontes/delegua");
-const commander_1 = require("commander");
-const principal = () => {
-    const analisadorArgumentos = new commander_1.Command();
-    let codigoOuNomeArquivo;
-    analisadorArgumentos
-        .option('-c, --codigo <codigo>', 'Código a ser avaliado.', '')
-        .option('-d, --dialeto <dialeto>', 'Dialeto a ser usado. Padrão: delegua.', 'delegua')
-        .option('-D, --depurador', 'Habilita o depurador, permitindo depuração em um ambiente como o VSCode. Sempre desabilitada em modo LAIR.', false)
-        .option('-p, --performance', 'Visualizar indicadores de performance. Desabilitado por padrão.', false)
-        .option('-s, --saida', 'Gera arquivo de saida ao traduzir arquivo.', false)
-        .option('-t, --traduzir <linguagem>', 'Traduz o código do arquivo passado como parâmetro.')
-        .argument('[arquivos...]', 'Nomes dos arquivos (opcional)')
-        .action((argumentos) => {
-        if (argumentos.length > 0) {
-            codigoOuNomeArquivo = argumentos[0];
-        }
-    });
-    analisadorArgumentos.parse();
-    const opcoes = analisadorArgumentos.opts();
-    const delegua = new delegua_1.Delegua(opcoes.dialeto, opcoes.performance, codigoOuNomeArquivo ? opcoes.depurador : false, opcoes.traduzir);
-    if (opcoes.codigo) {
-        delegua.executarCodigoComoArgumento(opcoes.codigo || codigoOuNomeArquivo);
-    }
-    else {
-        if (codigoOuNomeArquivo) {
-            if (opcoes.traduzir) {
-                const extensaoSaida = opcoes.traduzir;
-                delegua.traduzirArquivo(codigoOuNomeArquivo, opcoes.saida, extensaoSaida);
-            }
-            else {
-                delegua.carregarArquivo(codigoOuNomeArquivo);
-            }
-        }
-        else {
-            delegua.iniciarLairDelegua();
-        }
-    }
-};
-principal();
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const delegua_1 = require("./fontes/delegua");
+const commander_1 = require("commander");
+const principal = () => {
+    const analisadorArgumentos = new commander_1.Command();
+    let codigoOuNomeArquivo;
+    analisadorArgumentos
+        .option('-c, --codigo <codigo>', 'Código a ser avaliado.', '')
+        .option('-d, --dialeto <dialeto>', 'Dialeto a ser usado. Padrão: delegua.', 'delegua')
+        .option('-D, --depurador', 'Habilita o depurador, permitindo depuração em um ambiente como o VSCode. Sempre desabilitada em modo LAIR.', false)
+        .option('-p, --performance', 'Visualizar indicadores de performance. Desabilitado por padrão.', false)
+        .option('-s, --saida', 'Gera arquivo de saida ao traduzir arquivo.', false)
+        .option('-t, --traduzir <linguagem>', 'Traduz o código do arquivo passado como parâmetro.')
+        .argument('[arquivos...]', 'Nomes dos arquivos (opcional)')
+        .action((argumentos) => {
+        if (argumentos.length > 0) {
+            codigoOuNomeArquivo = argumentos[0];
+        }
+    });
+    analisadorArgumentos.parse();
+    const opcoes = analisadorArgumentos.opts();
+    const delegua = new delegua_1.Delegua(opcoes.dialeto, opcoes.performance, codigoOuNomeArquivo ? opcoes.depurador : false, opcoes.traduzir);
+    if (opcoes.codigo) {
+        delegua.executarCodigoComoArgumento(opcoes.codigo || codigoOuNomeArquivo);
+    }
+    else {
+        if (codigoOuNomeArquivo) {
+            if (opcoes.traduzir) {
+                const extensaoSaida = opcoes.traduzir;
+                delegua.traduzirArquivo(codigoOuNomeArquivo, opcoes.saida, extensaoSaida);
+            }
+            else {
+                delegua.carregarArquivo(codigoOuNomeArquivo);
+            }
+        }
+        else {
+            delegua.iniciarLairDelegua();
+        }
+    }
+};
+principal();
 //# sourceMappingURL=execucao.js.map

package/fontes/delegua.d.ts

@@ -1,86 +1,86 @@
-import { AvaliadorSintaticoInterface, InterpretadorInterface, LexadorInterface, RetornoExecucaoInterface, SimboloInterface } from '@designliquido/delegua/fontes/interfaces';
-import { RetornoImportador } from './importador';
-import { TradutorJavaScript, TradutorReversoJavaScript } from '@designliquido/delegua/fontes/tradutores';
-import { ServidorDepuracao } from './depuracao';
-import { DeleguaInterface, ImportadorInterface } from './interfaces';
-/**
- * O núcleo da linguagem.
- *
- * Responsável por avaliar a entrada fornecida, entender o código e executá-lo.
- */
-export declare class Delegua implements DeleguaInterface {
-    dialeto: string;
-    dialetos: {
-        [identificador: string]: string;
-    };
-    arquivosAbertos: {
-        [identificador: string]: string;
-    };
-    conteudoArquivosAbertos: {
-        [identificador: string]: string[];
-    };
-    interpretador: InterpretadorInterface;
-    lexador: LexadorInterface;
-    avaliadorSintatico: AvaliadorSintaticoInterface;
-    importador: ImportadorInterface;
-    tradutorJavaScript: TradutorJavaScript;
-    tradutorReversoJavascript: TradutorReversoJavaScript;
-    funcaoDeRetorno: Function;
-    modoDepuracao: boolean;
-    servidorDepuracao: ServidorDepuracao;
-    constructor(dialeto?: string, performance?: boolean, depurador?: boolean, traduzir?: any, funcaoDeRetorno?: Function);
-    versao(): string;
-    /**
-     * LAIR (Leia-Avalie-Imprima-Repita) é o modo em que Delégua executa em modo console,
-     * ou seja, esperando como entrada linhas de código fornecidas pelo usuário.
-     */
-    iniciarLairDelegua(): void;
-    /**
-     * Executa uma linha. Usado pelo modo LAIR e pelo servidor de depuração, quando recebe um comando 'avaliar'.
-     * @param linha A linha a ser avaliada.
-     * @returns O resultado da execução, com os retornos e respectivos erros, se houverem.
-     */
-    executarUmaLinha(linha: string): Promise<RetornoExecucaoInterface>;
-    /**
-     * Instancia um servidor de depuração, normalmente recebendo requisições na porta 7777.
-     */
-    iniciarDepuracao(): void;
-    /**
-     * Pede ao servidor de depuração que finalize a execução.
-     * Se não for feito, o servidor de depuração mantém um _stream_ aberto e nunca finaliza.
-     * Mais informações: https://stackoverflow.com/a/47456805/1314276
-     */
-    finalizarDepuracao(): void;
-    /**
-     * Verifica erros nas etapas de lexação e avaliação sintática.
-     * @param retornoImportador Um objeto que implementa a interface RetornoImportador.
-     * @returns Verdadeiro se há erros. Falso caso contrário.
-     */
-    afericaoErros(retornoImportador: RetornoImportador): boolean;
-    /**
-     * Realiza a tradução do arquivo passado como parâmetro no comando de execução.
-     * @param caminhoRelativoArquivo O caminho do arquivo.
-     * @param gerarArquivoSaida Se o resultado da tradução deve ser escrito em arquivo.
-     *                          Se verdadeiro, os arquivos de saída são escritos no mesmo diretório
-     *                          do arquivo passado no primeiro parâmetro.
-     */
-    traduzirArquivo(caminhoRelativoArquivo: string, gerarArquivoSaida: boolean, extensaoArquivoSaida: string): any;
-    executarCodigoComoArgumento(codigo: string): Promise<void>;
-    /**
-     * Execução por arquivo.
-     * @param caminhoRelativoArquivo O caminho no sistema operacional do arquivo a ser aberto.
-     */
-    carregarArquivo(caminhoRelativoArquivo: string): Promise<any>;
-    /**
-     * A execução do código de fato.
-     * @param retornoImportador Dados retornados do Importador, como o retorno do Lexador, do Avaliador
-     *                          Sintático e respectivos erros.
-     * @param manterAmbiente Indicação se ambiente deve ser mantido ou não. Normalmente verdadeiro
-     *                       para LAIR, falso para execução por arquivo.
-     * @returns Um objeto com o resultado da execução.
-     */
-    executar(retornoImportador: RetornoImportador, manterAmbiente?: boolean): Promise<RetornoExecucaoInterface>;
-    reportar(linha: number, onde: any, mensagem: string): void;
-    erro(simbolo: SimboloInterface, mensagemDeErro: string): void;
-    erroEmTempoDeExecucao(erro: any): void;
-}
+import { AvaliadorSintaticoInterface, InterpretadorInterface, LexadorInterface, RetornoExecucaoInterface, SimboloInterface } from '@designliquido/delegua/fontes/interfaces';
+import { RetornoImportador } from './importador';
+import { TradutorJavaScript, TradutorReversoJavaScript } from '@designliquido/delegua/fontes/tradutores';
+import { ServidorDepuracao } from './depuracao';
+import { DeleguaInterface, ImportadorInterface } from './interfaces';
+/**
+ * O núcleo da linguagem.
+ *
+ * Responsável por avaliar a entrada fornecida, entender o código e executá-lo.
+ */
+export declare class Delegua implements DeleguaInterface {
+    dialeto: string;
+    dialetos: {
+        [identificador: string]: string;
+    };
+    arquivosAbertos: {
+        [identificador: string]: string;
+    };
+    conteudoArquivosAbertos: {
+        [identificador: string]: string[];
+    };
+    interpretador: InterpretadorInterface;
+    lexador: LexadorInterface;
+    avaliadorSintatico: AvaliadorSintaticoInterface;
+    importador: ImportadorInterface;
+    tradutorJavaScript: TradutorJavaScript;
+    tradutorReversoJavascript: TradutorReversoJavaScript;
+    funcaoDeRetorno: Function;
+    modoDepuracao: boolean;
+    servidorDepuracao: ServidorDepuracao;
+    constructor(dialeto?: string, performance?: boolean, depurador?: boolean, traduzir?: any, funcaoDeRetorno?: Function);
+    versao(): string;
+    /**
+     * LAIR (Leia-Avalie-Imprima-Repita) é o modo em que Delégua executa em modo console,
+     * ou seja, esperando como entrada linhas de código fornecidas pelo usuário.
+     */
+    iniciarLairDelegua(): void;
+    /**
+     * Executa uma linha. Usado pelo modo LAIR e pelo servidor de depuração, quando recebe um comando 'avaliar'.
+     * @param linha A linha a ser avaliada.
+     * @returns O resultado da execução, com os retornos e respectivos erros, se houverem.
+     */
+    executarUmaLinha(linha: string): Promise<RetornoExecucaoInterface>;
+    /**
+     * Instancia um servidor de depuração, normalmente recebendo requisições na porta 7777.
+     */
+    iniciarDepuracao(): void;
+    /**
+     * Pede ao servidor de depuração que finalize a execução.
+     * Se não for feito, o servidor de depuração mantém um _stream_ aberto e nunca finaliza.
+     * Mais informações: https://stackoverflow.com/a/47456805/1314276
+     */
+    finalizarDepuracao(): void;
+    /**
+     * Verifica erros nas etapas de lexação e avaliação sintática.
+     * @param retornoImportador Um objeto que implementa a interface RetornoImportador.
+     * @returns Verdadeiro se há erros. Falso caso contrário.
+     */
+    afericaoErros(retornoImportador: RetornoImportador): boolean;
+    /**
+     * Realiza a tradução do arquivo passado como parâmetro no comando de execução.
+     * @param caminhoRelativoArquivo O caminho do arquivo.
+     * @param gerarArquivoSaida Se o resultado da tradução deve ser escrito em arquivo.
+     *                          Se verdadeiro, os arquivos de saída são escritos no mesmo diretório
+     *                          do arquivo passado no primeiro parâmetro.
+     */
+    traduzirArquivo(caminhoRelativoArquivo: string, gerarArquivoSaida: boolean, extensaoArquivoSaida: string): any;
+    executarCodigoComoArgumento(codigo: string): Promise<void>;
+    /**
+     * Execução por arquivo.
+     * @param caminhoRelativoArquivo O caminho no sistema operacional do arquivo a ser aberto.
+     */
+    carregarArquivo(caminhoRelativoArquivo: string): Promise<any>;
+    /**
+     * A execução do código de fato.
+     * @param retornoImportador Dados retornados do Importador, como o retorno do Lexador, do Avaliador
+     *                          Sintático e respectivos erros.
+     * @param manterAmbiente Indicação se ambiente deve ser mantido ou não. Normalmente verdadeiro
+     *                       para LAIR, falso para execução por arquivo.
+     * @returns Um objeto com o resultado da execução.
+     */
+    executar(retornoImportador: RetornoImportador, manterAmbiente?: boolean): Promise<RetornoExecucaoInterface>;
+    reportar(linha: number, onde: any, mensagem: string): void;
+    erro(simbolo: SimboloInterface, mensagemDeErro: string): void;
+    erroEmTempoDeExecucao(erro: any): void;
+}