🧠 Inteligência do Editor#

Esta página documenta os recursos de produtividade do editor que vão além do realce de sintaxe básico: edição multi-cursor, dicas inteligentes, ferramentas de foco visual e os dois recursos exclusivos do Codis - Code Rhythm e Edit Heatmap, que não existem em nenhum outro editor mainstream.

Para Syntax Highlighting, Autocomplete, Snippets, Minimap, Code Folding e demais fundamentos, ver Editor.

🖊️ Multi-Cursor (src/editor/multi_cursor.py)#

Edição simultânea em múltiplos pontos do texto, no estilo VS Code / Sublime Text / JetBrains.

Importante: Ctrl+D tem dois comportamentos diferentes dependendo do estado do Multi-Cursor. Com o Multi-Cursor inativo (estado padrão), Ctrl+D duplica a linha atual (veja Editor). Assim que o Multi-Cursor é ativado, o mesmo atalho passa a selecionar a próxima ocorrência da palavra - o handler do Multi-Cursor intercepta o evento antes do handler de duplicar linha.

Internamente, cada cursor extra mantém sua própria "âncora" (um índice do Tk armazenado como tag). Ao digitar ou apagar texto, a ação é replicada em todos os cursores ativos simultaneamente. Os cursores extras são desenhados como marcas coloridas diretamente no widget Text, e um indicador na barra de status (MultiCursorStatusIndicator) mostra quantos cursores estão ativos no momento.

Pode ser ligado/desligado via Ferramentas → Workspace & Editor → Multi-Cursor ou Ctrl+Alt+M.

No código-fonte existem dois binds tecnicamente distintos: <Control-Alt-m> (minúsculo) para o toggle do Multi-Cursor e <Control-Alt-M> (maiúsculo, ou seja, com Shift também pressionado) para abrir o Gerenciador de Processos. Tkinter trata essas sequências como eventos diferentes, mas a forma como o sistema operacional gera maiúscula/minúscula com Alt pressionado pode variar entre plataformas e layouts de teclado. Se Ctrl+Alt+M abrir o Gerenciador de Processos em vez de alternar o Multi-Cursor (ou vice-versa), use o menu Ferramentas → Workspace & Editor → Multi-Cursor como alternativa confiável.

🔭 Smart Selection (src/editor/smart_selection.py)#

Expansão e contração de seleção semântica, equivalente ao "Expand/Shrink Selection" do VS Code.

A expansão é feita por análise de tokens e delimitadores no texto puro - não depende de AST, então funciona em qualquer linguagem, mesmo sem suporte LSP. A contração restaura exatamente a seleção anterior à última expansão (não recalcula do zero).

🎯 Focus Block (src/editor/focus_block.py)#

Escurece (dim) todas as linhas que não fazem parte do bloco estrutural atual sob o cursor - função, método, classe ou bloco de alto nível - guiando o olhar para o que está sendo editado agora.

• Detecta automaticamente o bloco via indentação + AST
• Aplica uma tag de "esmaecimento" nas linhas fora do bloco
• Atualiza em tempo real conforme o cursor se move
• Compatível com o syntax highlighting normal - sobrepõe a cor sem quebrar a renderização existente

Ativar/desativar: Ferramentas → Modo Foco (não confundir com o Focus Mode de tela cheia - Focus Block é um esmaecimento de linhas, não um modo de janela).

💡 Smart Tips (src/editor/smart_tips.py)#

Dicas contextuais não intrusivas, baseadas em gatilhos automáticos que analisam o arquivo conforme você edita. Aparecem como balões flutuantes no canto inferior direito, com fade-in e auto-dismiss.

Cada dica pode ser dispensada manualmente ou desabilitada globalmente em Configurações.

🔢 Complexity Lens (src/editor/complexity_lens.py)#

Badge flutuante no canto superior direito do editor mostrando, em tempo real, a complexidade ciclomática (McCabe) da função sob o cursor.

A análise é feita via AST, com debounce de 300ms após cada movimento de cursor - nunca bloqueia a interface. Disponível apenas para Python (a análise depende de AST nativa da linguagem).

💬 Sticky Note Gutter (src/editor/sticky_note_gutter.py)#

Permite anexar notas de texto livre a linhas específicas do código, exibidas como ícones 💬 no gutter (barra de números de linha).

• Passar o mouse sobre o ícone mostra a nota em um tooltip rico
• Clicar no ícone abre um popup de edição multiline
• Ctrl+Shift+N adiciona/edita a nota na linha atual - com o cursor dentro do editor de código, este atalho é capturado pelo Sticky Note Gutter antes de chegar ao Scratchpad (veja nota abaixo)
• Notas são persistidas por arquivo (chave sticky_notes na configuração)
• Podem ser exportadas como comentários inline (# NOTE: ...)
• Se linhas forem inseridas/removidas, a nota "acompanha" a linha original corretamente

Colisão de atalho: Ctrl+Shift+N também está vinculado à abertura do Scratchpad. Como o bind do Sticky Note está no próprio widget de texto do editor (mais específico) e retorna "break", ele intercepta o evento primeiro - então, com o foco dentro do editor de código, Ctrl+Shift+N sempre abre o Sticky Note, não o Scratchpad. Para abrir o Scratchpad, use o menu ou a Activity Bar diretamente.

✨ Ligatures (src/editor/ligatures.py)#

Sistema de ligaturas tipográficas para sequências comuns de código (->, !=, >=, etc.), com três modos:

Importante: o texto bruto em ASCII é sempre preservado - é salvo e copiado normalmente, independentemente do modo visual escolhido. O processamento opera apenas nas linhas visíveis, para impacto mínimo de performance.

🌡️ Edit Heatmap - recurso exclusivo do Codis (src/editor/heatmap.py)#

Funcionalidade que não existe em nenhum outro editor mainstream.

Rastreia quantas vezes cada linha foi editada durante a sessão atual e exibe um gradiente de calor no gutter - azul frio (poucas edições) até vermelho quente (muitas edições).

Para que serve#

• Identificar linhas problemáticas que exigem refatoração constante
• Localizar hot spots de complexidade onde bugs tendem a se concentrar
• Revelar padrões de edição que indicam dívida técnica acumulada

Como funciona#

O EditHeatmap escuta o EventBus (eventos editor.change com payload de linha) e acumula contagens por linha durante a sessão. O gutter consulta get_line_color() para colorir cada linha proporcionalmente à intensidade de edição.

🎵 Code Rhythm - recurso exclusivo do Codis (src/editor/rhythm.py)#

Funcionalidade que não existe em nenhum outro editor mainstream.

Analisa o ritmo de digitação do desenvolvedor em tempo real e expõe estatísticas de produtividade:

• WPM (palavras por minuto) de código
• Detector de "flow state": identifica quando a digitação está regular e sem longas pausas, sinalizando estado de fluxo
• Mapa de padrões de pausa - onde o desenvolvedor hesita mais
• Detecção de sequências de edições repetitivas (sinal de refatoração em loop)
• Estimativa de tempo restante para terminar o arquivo, baseada no ritmo atual

O CodeRhythm recebe eventos de tecla via record_keystroke() e expõe as métricas calculadas via metrics(), integradas à barra de status e ao EventBus interno.