Linguagens em Português para Visual Studio Code e derivados

Essa extensão visa melhorar a produtividade de projetos escritos usando as linguagens da Design Líquido:

Essa extensão também oferece suporte parcial a outras linguagens que são dialetos de Delégua:

Instalação

Você pode instalar pesquisando nas extensões do Visual Studio Code ou por este link (Windows e Mac), ou ainda por este outro link (Linux, VSCodium, etc).

Editores suportados:

📦 Como Usar

Na Web:

Acesse vscode.dev ou github.dev
Instale a extensão "Design Líquido - Linguagens em Português"
Abra ou crie arquivos .delegua, .visualg, .mapler, etc.

No Desktop:

Abra o VS Code
Vá em Extensões (Ctrl+Shift+X)
Busque por "Design Líquido"
Clique em Instalar

Funcionalidades

Sintaxe colorida para todas as linguagens suportadas
Formatação automática para Delégua, Pituguês, Mapler, VisuAlg, Potigol e Portugol Studio
Análise semântica para Delégua, Pituguês, BIRL, Mapler, VisuAlg, Portugol Studio, Potigol e delprops
Trechos de código (snippets) para Delégua (incluindo rotas Líquido), Pituguês, VisuAlg, Portugol Studio e LinConEs
Completude de código (IntelliSense) para Delégua, Pituguês, FolEs, LMHT, VisuAlg, Portugol Studio, delprops e arquivos de teste Delégua
13 comandos de tradução entre Delégua, JavaScript, Python, Ruby, Elixir, AssemblyScript, CSS↔FolEs, HTML↔LMHT, SQL↔LinConEs e VisuAlg
Suporte a depuração para Delégua, Pituguês, Mapler, VisuAlg, Portugol Studio e Potigol
Ícones para arquivos .delegua, .egua, .pitugues, .foles, .lincones, .lmht, .birl, .delprops, .alg (VisuAlg), .por (Portugol Studio), .poti/.potigol (Potigol), .mapler (Mapler)

⚙️ Estilizador (apenas Delégua)

O Estilizador é uma ferramenta que aplica regras para melhorar a qualidade e consistência do código Delégua durante a formatação. Diferente de formatadores que apenas ajustam a apresentação visual, o Estilizador modifica a árvore sintática para aplicar convenções e boas práticas.

Configurações Disponíveis

Você pode configurar o Estilizador acessando as configurações do VS Code (Ctrl + ,) e buscando por "delegua estilizador", ou editando diretamente o arquivo settings.json:

Habilitar/Desabilitar o Estilizador

{
  "delegua.estilizador.habilitado": true
}

Valor padrão: true Descrição: Controle mestre para habilitar ou desabilitar o Estilizador durante a formatação de código.

Fortalecimento de Tipos

{
  "delegua.estilizador.fortalecerTipos.habilitado": false
}

Valor padrão: false Descrição: Converte declarações com tipo qualquer para tipos inferidos automaticamente.

Exemplos:

var x = 5 → var x: número = 5
var nome = "João" → var nome: texto = "João"
constante PI = 3.14 → constante PI: número = 3.14

Explicitação de Tipos de Parâmetros

{
  "delegua.estilizador.explicitarTiposParametros.habilitado": false
}

Valor padrão: false Descrição: Materializa : qualquer em parâmetros de função e método que não tenham anotação explícita.

Exemplo:

funcao calcularPerimetro(altura, largura) → funcao calcularPerimetro(altura: qualquer, largura: qualquer)

Convenção de Nomenclatura

{
  "delegua.estilizador.convencaoNomenclatura.habilitado": false,
  "delegua.estilizador.convencaoNomenclatura.variaveis": "caixaCamelo",
  "delegua.estilizador.convencaoNomenclatura.constantes": "CAIXA_ALTA",
  "delegua.estilizador.convencaoNomenclatura.funcoes": "caixaCamelo"
}

Valor padrão: false (desabilitado) Descrição: Aplica convenções de nomenclatura para identificadores no código.

Opções para Variáveis e Funções:

caixaCamelo (camelCase): minhaVariavel, minhaFuncao
caixa_cobra (snake_case): minha_variavel, minha_funcao
CaixaPascal (PascalCase): MinhaVariavel, MinhaFuncao

Opções para Constantes:

CAIXA_ALTA (UPPER_CASE): MINHA_CONSTANTE
caixaCamelo (camelCase): minhaConstante

Exemplo de Configuração Completa

{
  "delegua.estilizador.habilitado": true,
  "delegua.estilizador.fortalecerTipos.habilitado": true,
  "delegua.estilizador.explicitarTiposParametros.habilitado": false,
  "delegua.estilizador.convencaoNomenclatura.habilitado": true,
  "delegua.estilizador.convencaoNomenclatura.variaveis": "caixaCamelo",
  "delegua.estilizador.convencaoNomenclatura.constantes": "CAIXA_ALTA",
  "delegua.estilizador.convencaoNomenclatura.funcoes": "caixaCamelo"
}

Como Usar

Configure as opções desejadas nas configurações do VS Code
Abra um arquivo .delegua
Formate o documento usando:
- Shift + Alt + F (Windows/Linux)
- Shift + Option + F (Mac)
- Ou clique com o botão direito e selecione "Formatar Documento"

O Estilizador aplicará automaticamente as regras configuradas durante a formatação.

Tradução entre linguagens

Essa extensão oferece 13 comandos de tradução entre linguagens. Pressione Ctrl + Shift + p (Cmd + Shift + p no Mac) e digite "tradução" para acessá-los.

Traduções disponíveis

Origem	Destino
CSS	FolEs
FolEs	CSS
HTML	LMHT
LMHT	HTML
SQL	LinConEs
LinConEs	SQL
VisuAlg	Delégua
JavaScript	Delégua
Delégua	JavaScript, Python, Ruby, Elixir, AssemblyScript

Compilação para arquiteturas de processador (x64, ARM, RISC-V) e WebAssembly não é mais oferecida por esta extensão. Use os pacotes autocontidos delegua-x64, delegua-arm, delegua-risc-v e delegua-wasm pela linha de comando.

Suporte ao Framework Líquido

Esta extensão oferece suporte completo ao Framework Líquido, um framework web em português para desenvolvimento de APIs e aplicações web:

6 comandos no palete de comandos: Iniciar servidor de desenvolvimento, Novo projeto, Gerar código, Documentação OpenAPI, Inicializar banco de dados, Rodar testes
12 snippets de rotas (rotaGet, rotaPost, rotaPut, rotaDelete, etc.) em arquivos Delégua
Arquivos .delprops com sintaxe colorida, validação de configuração, autocompletar e documentação contextual para todas as propriedades liquido.*
Detecção de contexto de rotas: análise semântica especial para arquivos dentro de rotas/, injetando variáveis liquido, requisicao, resposta e lincones no escopo
Task provider para executar comandos Líquido diretamente do terminal do VS Code

Depuração

As linguagens que podem ser depuradas por esta extensão são:

Para depurar seu código, siga os passos de qualquer um dos vídeos abaixo:

O resultado da execução aparecerá no painel "Entrada e Saída", que fica juntamente com o console de depuração e o terminal.

🌐 Versão Web (vscode.dev)

Esta extensão está disponível tanto na versão desktop quanto na versão web do VS Code (vscode.dev e github.dev).

✅ Recursos Disponíveis na Web

Destaque de sintaxe para todas as linguagens suportadas
Análise de código em tempo real com diagnósticos de erros e avisos
IntelliSense com sugestões de código inteligentes
Documentação contextual ao passar o mouse sobre símbolos
Formatação automática para Delégua, Pituguês, Mapler, VisuAlg, Potigol e Portugol Studio
Painel de Entrada e Saída interativo
Suporte a depuração para todas as linguagens
Criação de arquivos Pituguês diretamente do navegador

💡 Dica: Para acesso completo a todos os recursos, instale a extensão na versão desktop do VS Code.

Design Líquido - Linguagens em Português

Design Líquido