✏️ Editor#

O núcleo do Codis é o EditorPane - um editor de texto rico construído sobre o widget tk.Text. Esta página descreve todas as funcionalidades disponíveis no editor.

Syntax Highlighting#

O destaque de sintaxe é baseado em expressões regulares compiladas em src/syntax/patterns.py. É importante distinguir dois níveis de suporte a linguagem no Codis:

• Highlight de sintaxe real (LANG_RE, 25 linguagens): JavaScript, TypeScript, Python, HTML, CSS, SCSS, Less, JSON, Markdown, YAML, TOML, INI, SQL, Shell, Rust, Go, C, C++, Java, Makefile, Dockerfile, GraphQL, XML, Vue e Svelte (estas duas últimas só acessíveis trocando a linguagem manualmente, sem detecção automática por extensão).
• Reconhecimento por extensão sem highlight (EXT_LANG, mais 23 linguagens): Kotlin, Swift, C#, F#, VB.NET, Ruby, PHP, Lua, Perl, R, Julia, Haskell, Elixir, Erlang, Scala, Clojure, CoffeeScript, Groovy, HCL/Terraform, Protocol Buffers, Nix, Batch e PowerShell - o Codis identifica corretamente a linguagem (ícone, nome de exibição na barra de status, formatador associado), mas o texto é exibido sem coloração de sintaxe, já que essas linguagens não têm uma entrada em LANG_RE.

No total são 48 linguagens reconhecidas por extensão, das quais 25 têm highlight de sintaxe colorido.

A linguagem é detectada automaticamente pela extensão do arquivo. Para alterar manualmente, clique no nome da linguagem na Barra de Status.

Não confundir com o KDocs, que reconhece 27 linguagens diferentes para fins de parsing de docstring/comentário - uma lista parcialmente distinta da de highlight, já que KDocs e o highlighter de sintaxe são sistemas independentes.

Autocompletar#

O autocomplete combina três fontes:

1. Palavras do arquivo atual - análise lexical do buffer.
2. Keywords da linguagem - lista curada por linguagem (definida em src/constants.py).
3. Símbolos LSP - funções, classes e variáveis do servidor de linguagem ativo.

Configuração:

A lista de autocomplete é navegável por ↑ / ↓ e fechada com Esc. Tab ou Enter confirma a sugestão selecionada.

Snippets#

Snippets são trechos de código reutilizáveis armazenados em ~/.codis/snippets/. O painel de Snippets (Ctrl+Shift+J ou Activity Bar → ✂️) permite gerenciar e inserir snippets.

Ao digitar o prefixo de um snippet e pressionar Tab, o snippet é expandido no cursor. Snippets suportam variáveis ${1}, ${2} para navegação entre campos de edição.

Ver Recursos Avançados → Snippets para detalhes sobre criação.

Fechamento Automático de Pares#

O editor fecha automaticamente os pares:

Pressionar o caractere de fechamento sobre um par existente apenas move o cursor para fora, sem duplicar.

Minimapa#

O minimapa é uma representação em miniatura do código à direita do editor.

• Largura: 110 px (configurável via minimap_width)
• Escala: 1:3 (configurável via minimap_scale)
• Marcadores coloridos de diagnósticos de lint são sobrepostos no minimapa.
• Para ocultar: Exibir → Minimapa ou Ctrl+, → minimap: false.

Numeração de Linhas#

Exibida à esquerda do editor. Pode exibir números absolutos ou relativos (estilo Vim):

• line_numbers: true - exibe números de linha (padrão)
• relative_numbers: true - exibe números relativos ao cursor

Dobramento de Código (Code Folding)#

Regiões de código definidas por indentação ou delimitadores de bloco podem ser dobradas/desdobradas. Clique no triângulo ▸ na margem esquerda ou use Ctrl+Shift+[ / Ctrl+Shift+] (se configurado via plugin).

• code_folding: true - ativa o dobramento (padrão).

Sticky Scroll#

Ao rolar o código, os cabeçalhos de escopo (funções, classes, loops) ficam "colados" no topo do editor até que o bloco inteiro saia da tela.

• sticky_scroll: true - ativa (padrão).

Highlight da Linha Atual#

A linha onde o cursor se encontra recebe um destaque visual diferenciado.

• highlight_current_line: true - ativa (padrão).

Correspondência de Parênteses#

Ao posicionar o cursor próximo a um parêntese, colchete ou chave, o par correspondente é destacado.

• bracket_matching: true - ativa (padrão).
• Para navegar ao par correspondente: Ir → Colchete Correspondente.

Guias de Indentação#

Linhas verticais sutis indicam os níveis de indentação do código.

• indent_guides: true - ativa (padrão).

Renderização de Espaços em Branco#

Controla como espaços e tabs são exibidos:

• render_whitespace: "none" - não exibe (padrão)
• render_whitespace: "boundary" - exibe apenas nos limites de palavras
• render_whitespace: "all" - exibe todos os espaços e tabs

Preview de Cores#

Quando color_preview: true (padrão), o editor exibe uma pequena amostra colorida ao lado de valores de cor no código (ex: #4a9eff, rgb(255, 0, 0)). Clique na amostra para abrir o Color Picker (Ctrl+Shift+C).

Hints Embutidas (Inlay Hints)#

Quando inlay_hints: true, o LSP pode injetar dicas de tipo diretamente no código, exibidas em fonte menor e cor diferente.

Inline Blame (Git Blame)#

Exibe a informação de git blame diretamente no editor:

• inline_blame: false - desativado por padrão
• inline_blame_mode: "cursor" - mostra blame apenas na linha do cursor
• inline_blame_mode: "all" - mostra blame em todas as linhas visíveis

Modo de Sobrescrita#

Pressione Insert para alternar entre inserção (padrão) e sobrescrita (substituição de caracteres à medida que digita).

Modo Somente Leitura#

Via Ferramentas → Modo Somente Leitura, o editor fica em modo read-only - o texto não pode ser editado. Ideal para revisar código sem risco de alterações acidentais.

Formatação de Documento#

Shift+Alt+F ou Executar → Formatar Documento invoca o formatador configurado para a linguagem ativa. A formatação chama a ferramenta CLI diretamente via subprocess (não usa o protocolo LSP):

Apenas essas linguagens têm formatação automática nativa. Go, Rust e demais linguagens não suportadas exibem um diálogo informando que não há formatador disponível para a linguagem - não há integração com gofmt ou rustfmt nesta versão. Se a ferramenta CLI (Prettier, Black ou autopep8) não estiver instalada no PATH, o mesmo diálogo é exibido.

Manipulação de Linhas#

Atalhos de manipulação de linhas disponíveis:

Transformações de Texto#

Via Editar → Transformar:

• Maiúsculas - converte seleção para UPPER CASE
• Minúsculas - converte seleção para lower case
• Title Case - Converte Seleção Para Title Case

Zoom#

O zoom atual é exibido na barra de status e pode ser ajustado clicando nele.

Quebra de Linha#

Exibir → Quebra de Linha alterna entre linha reta e quebra suave (word_wrap). Estado salvo em config.json.

Arquivos Grandes#

Para arquivos acima de 3 MB (configurável via large_file_mb), o Codis ativa um modo simplificado que desativa syntax highlighting e autocomplete para manter a performance.

File Timeline (Histórico de Versões)#

Exibir → Painéis → File Timeline abre o histórico de versões automáticas do arquivo atual. O Codis salva snapshots em ~/.codis/backups/ enquanto o arquivo está aberto, e é possível comparar (via diff) e restaurar qualquer versão anterior com um clique - sem depender do Git. Detalhes completos do mecanismo de snapshot em Backups, Lixeira & Arquivos Compactados.