Skip to content

VS Code ​

A extensão do VS Code é um cliente para o servidor compartilhado tyrus lsp. Ela deve parecer uma experiência nativa de linguagem mantendo regras semânticas no compilador e no Language Server.

Instalar e abrir ​

Faça build ou instale a extensão a partir de editors/vscode, depois abra um projeto que contém arquivos .tyr.

Instale a extensão Tyrus publicada no Marketplace do VS Code.

shell
cd editors/vscode
npm run package
code --install-extension tyrus-language-support-*.vsix

A extensão se seleciona automaticamente como formatter padrão para arquivos .tyr e habilita a formatação ao salvar. Esses defaults não adicionam entradas ao settings.json, e configurações explícitas do usuário ou workspace têm precedência. Abra Settings com Ctrl+, e pesquise tyrus, ou pesquise @ext:tyrus.tyr-language-support para mostrar apenas as configurações da extensão.

O logotipo do tyrus identifica a extensão na tela Extensions, e arquivos .tyr expõem o ícone da linguagem tyrus no Explorer. Um tema de ícones de arquivo de terceiros pode substituir intencionalmente ícones fornecidos pelas linguagens pela própria arte.

Inteligência compartilhada

VS Code, Neovim, Zed e IntelliJ/WebStorm devem receber os mesmos diagnósticos e code intelligence de tyrus lsp.

Diagnósticos ​

Diagnósticos do compilador e do linter aparecem como squiggles no editor e no painel Problems. Por padrão, a extensão também adiciona um fundo translúcido à linha inteira: vermelho para erros e amarelo para warnings. O squiggle e seu range preciso de origem permanecem visíveis.

Defina tyrus.diagnostics.highlightWholeLine como false no settings.json para desativar o fundo da linha inteira sem alterar os diagnósticos. Como alternativa, pressione Ctrl+,, pesquise tyrus, localize Tyrus › Diagnostics: Highlight Whole Line e desmarque a caixa.

error

tyrus
const maxUsers: u32 = "100"; 
let retries: i32 = 3; 

print(retries); // 3

Feedback esperado no editor:

OrigemSeveridadeExemplo
CompiladorErrorexpected i32, found string
LinterWarningretries is never reassigned
Schema de formatter/lint configError ou warningChaves desconhecidas ou inválidas em tyrus-fmt.json e tyrus-lint.json.

Completion ​

Completion inclui símbolos locais, símbolos importados, exports de módulos nativos, keywords, tipos primitivos, validator decorators, campos de objeto, chaves de opção de rota como handler, response, params e config, chaves aninhadas de rate limit como max, timeWindow e globalMax, e membros de arrays, strings, Regex, HttpRouter e HttpStatus. Hover em uma opção de rota explica seu valor esperado e sua finalidade.

tyrus
import { HttpStatus } from "tyrus:http";

reply.status(HttpStatus.); 

Hover e Signature Help ​

Hover mostra tipos inferidos, assinaturas de imports nativos, campos de interface, documentação de validators e diagnósticos. Signature help mostra nomes de parâmetros e o argumento ativo durante o preenchimento de uma chamada.

tyrus
import { readFileSync, type FsError } from "tyrus:fs";

const main = (): void => {
    match (readFileSync("README.md")) {
        Ok(contents) => print(contents);
        Err(error) => printError(error.code);
    }
};
Exemplo de hover
text
readFileSync: (path: string) => Result<string, FsError>

Inlay hints ​

O Language Server fornece inlay hints de nomes de parâmetros e tipos inferidos.

tyrus
const names = ["Ada", "Grace"];
sendEmail("[email protected]", "Welcome");

Hints esperados:

text
const names: string[] = ["Ada", "Grace"];
sendEmail(to: "[email protected]", subject: "Welcome");

Quick Fixes ​

Quick Fixes ficam disponíveis quando a edição é determinística.

diff
- let retries: i32 = 3;
+ const retries: i32 = 3;

Exemplos incluem importar um símbolo ausente, remover imports não usados, aplicar prefer-const e tomar emprestado um valor que seria movido.

Code Lenses de Quick Fix ​

Quando um diagnóstico em .tyr oferece pelo menos um Quick Fix determinístico, o Language Server também o expõe como um code lens acima da linha com o problema. O lens mostra exatamente o título do Quick Fix (por exemplo, Change let to const), e clicar nele aplica a edição imediatamente, sem abrir o menu de Quick Fix. Quando um diagnóstico tem mais de uma correção, cada correção ganha o próprio lens ao lado dos outros. Os Quick Fixes de arquivos .env continuam disponíveis somente pela lâmpada.

O Quick Fix normal continua funcionando pela lâmpada e pelos comandos padrão do editor; os lenses apenas adicionam um ponto de entrada mais próximo do código.

Defina tyrus.codeLens.quickFixes.enable como false no settings.json para esconder os code lenses de Quick Fix sem alterar os próprios Quick Fixes. A mudança nesta configuração vale depois de recarregar a janela.

Semantic highlighting ​

Semantic tokens melhoram a coloração de símbolos, tipos primitivos, tipos nativos, interfaces, type aliases, keywords, literal keywords e palavras reservadas para recursos futuros da linguagem.

Highlighting não é validação semântica

Cores de sintaxe ajudam a leitura, mas diagnósticos do compilador e do linter são a fonte de verdade para correção.