JLScript Language

Suporte oficial da linguagem JLScript para o Visual Studio Code.

A extensão JLScript Language integra o JLScript ao VS Code e reúne, em um só lugar, recursos para escrever, executar, navegar e desenvolver projetos .jls com uma experiência mais confortável.

Escreva em português ou inglês, consulte a linguagem enquanto programa e execute seus arquivos sem sair do editor. Esta versão acompanha o JLScript 3.2.0.

JLScript: código que fala a sua língua.

✨ Destaques

• Realce de sintaxe e tokens semânticos para arquivos .jls.
• Suporte às palavras-chave em português e inglês.
• IntelliSense contextual, respeitando imports, aliases e escopos.
• Documentação ao passar o mouse e ajuda dos parâmetros de funções.
• Navegação para definições e renomeação de símbolos.
• Snippets para estruturas da linguagem e bibliotecas oficiais.
• Diagnósticos no editor e na execução.
• Execução normal e assistida pela JLS AI.
• Entrada interativa de texto, sem precisar escrever no painel Output.

A extensão acompanha o crescimento do ecossistema JLScript. Bibliotecas que acessam serviços externos podem exigir dependências, autenticação ou dispositivos; a extensão não substitui esses requisitos.

🚀 Primeiro programa

Instale o runtime JLScript e confirme a versão no terminal:

jls --version

Crie um arquivo chamado ola.jls e escreva:

mostrar("Olá, JLScript!")

Clique em Executar JLS, no canto superior do editor, ou pressione Ctrl+\. O resultado aparece em Output → JLScript.

Também é possível executar pelo terminal:

jls run ola.jls

Em inglês, a mesma saída pode ser escrita assim:

show("Hello, JLScript!")

🧩 Sintaxe

O JLScript utiliza uma sintaxe simples, legível e familiar. Os exemplos abaixo mostram as formas em português e inglês disponíveis na linguagem.

Variáveis

va nome = "Lucas"
va idade = 20

Também é possível utilizar let:

let nome = "Lucas"

A declaração exige = entre o nome e o valor.

Condições

Em português:

va idade = 20

se (idade >= 18) {
    mostrar("Maior de idade")
} senao {
    mostrar("Menor de idade")
}

Em inglês:

let age = 20

if (age >= 18) {
    show("Adult")
} else {
    show("Minor")
}

Funções

func soma(a, b) {
    retorne a + b
}

mostrar(soma(10, 5))

Resultado: 15. Em inglês, use return:

func add(a, b) {
    return a + b
}

show(add(10, 5))

Separe os argumentos com vírgula: soma(10, 5) passa dois valores. soma(10+5) passa somente um e deixa o segundo parâmetro obrigatório ausente.

Repetições

Em português:

para (va i = 0; i < 5; i++) {
    mostrar(i)
}

Em inglês:

for (let i = 0; i < 5; i++) {
    show(i)
}

📦 Módulos e bibliotecas

O JLScript possui um sistema de módulos próprio. Importe as bibliotecas antes de utilizar seus recursos:

import #api
import #json
import #database

Também é possível utilizar aliases:

import #database como db

Ou a forma em inglês:

import #database as db

As sugestões respeitam o nome importado. Depois do import, digite db. para consultar os membros disponíveis e passe o mouse sobre eles para ver a documentação.

💡 Execução e produtividade no VS Code

Os botões de execução aparecem somente quando o arquivo ativo é JLScript. O arquivo é salvo antes de executar. Uma nova execução normal encerra a anterior.

Parar execução JLS não fecha o terminal JLSAI. Nesse terminal, use Ctrl+C para interromper uma execução e exit para encerrar a sessão.

Entrada de texto

O painel Output é somente leitura. No modo normal, a extensão abre uma caixa de entrada no topo do VS Code: digite a resposta e pressione Enter; Esc cancela a entrada e interrompe a execução.

va nome = chat("Qual é seu nome: ")
mostrar(nome)
mostrar("Bem-vindo, " + nome)

chat guarda a solicitação. O primeiro mostrar solicita e guarda a resposta; os próximos reutilizam o texto. Para ler uma resposta imediatamente, use ler:

va nome = ler("Qual é seu nome: ")
mostrar(nome)

Em Executar com JLS AI, responda diretamente no terminal JLSAI. Se a permissão de execução estiver em ask, confirme com s ou y. Enter sozinho não autoriza, e a confirmação vale apenas para aquela execução.

Atalhos

Os quatro primeiros atalhos são registrados pela extensão e ficam ativos em arquivos JLScript. Os demais são atalhos padrão do VS Code. Todos podem ser personalizados em Arquivo → Preferências → Atalhos de Teclado.

🛠️ Comandos do JLScript

Comandos disponíveis no runtime JLScript 3.2.0:

Use jls <comando> --help para consultar as opções da versão instalada. Compilar um executável nativo pode exigir ferramentas adicionais; instalar a extensão não instala essas ferramentas.

📁 Arquivos JLScript

Arquivos da linguagem utilizam a extensão .jls, por exemplo:

app.jls
server.jls
main.jls
teste.jls

A página da extensão usa o emblema JL oficial com fundo escuro. Os arquivos .jls usam o emblema JL transparente no Explorer e nas abas do VS Code, com o mesmo asset declarado para temas claros e escuros.

Temas de ícones de terceiros podem substituir os ícones de linguagem. O ícone mostrado na ficha do Marketplace acompanha a versão publicada da extensão.

⚙️ Requisitos e configuração

Para executar programas, tenha o runtime/CLI JLScript instalado. A extensão fornece os recursos do editor; não inclui o compilador nativo.

Verifique seu ambiente:

jls doctor

Se o executável estiver em uma pasta personalizada, informe o caminho completo de jls.exe em JLScript: Compiler Path (jlscript.compilerPath).

Execute apenas código confiável. As permissões da JLS AI não funcionam como sandbox para os programas JLScript executados.

Problemas comuns

• Não encontrou o runtime: confirme jls --version e jlscript.compilerPath.
• Não consegue digitar no Output: use a caixa de entrada, ou o terminal no modo JLSAI.
• JL013: confira os argumentos obrigatórios e as vírgulas da chamada.
• Botões ausentes: salve o arquivo como .jls e confirme o modo de linguagem JLScript.
• Atualização local não carregou: salve seus arquivos e use Developer: Reload Window.

🤖 JLS AI

O ecossistema inclui a JLS AI, voltada à assistência ao desenvolvimento com a linguagem e suas ferramentas. Executar com JLS AI abre uma sessão de terminal persistente para executar arquivos e consultar a assistência.

Use jls config para configurar idioma, cache, tema e permissões. Serviços ou recursos específicos podem exigir configuração adicional.

🖥️ JLShell

O JLShell faz parte do ecossistema e fornece acesso às ferramentas de linha de comando. Ele acompanha tarefas de execução, build, testes, formatação, análise e manutenção de projetos.

🔄 Atualizações e status

O JLScript e suas ferramentas continuam em desenvolvimento. As atualizações podem incluir melhorias nos snippets, realce de sintaxe, bibliotecas, navegação, integração com o runtime e compatibilidade.

As funcionalidades disponíveis dependem da versão instalada e dos requisitos de cada biblioteca. Mantenha o runtime e a extensão compatíveis entre si.

🌐 Links oficiais

• Site oficial
• Documentação
• GitHub da documentação
• Guia no DEV Community

Desenvolvimento da extensão

Na pasta vscode-extension, utilize npm run compile, npm run lint, npm test e npm run package. O VSIX é criado em dist/; empacotar localmente não publica no Marketplace.

O logo e o ícone dos arquivos são distribuídos no VSIX, sem depender de imagens hospedadas no repositório privado.

Criado para tornar a programação mais simples de ler, escrever e aprender, sem impedir que o projeto cresça junto com quem programa.

JLScript — código que fala a sua língua.