inteligencia editor

🧠 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.

Ação	Atalho
Adicionar cursor no ponto clicado	Alt+Click
Adicionar cursor acima/abaixo	Ctrl+Alt+↑ / Ctrl+Alt+↓
Selecionar próxima ocorrência da palavra sob o cursor	Ctrl+D
Selecionar todas as ocorrências	Ctrl+Shift+L
Cancelar todos os cursores extras	Escape

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ção	Atalho
Expandir seleção (palavra → expressão → linha → bloco → função → arquivo)	Alt+Shift+→ ou Ctrl+Shift+A
Contrair para o nível anterior	Alt+Shift+←

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.

Gatilho	O que detecta
Arquivo grande	Contagem de linhas acima do limite configurado
Complexidade	Funções/classes aninhadas profundamente
Convenção de nome	Variáveis com nome genérico (x, tmp, data...)
Dados sensíveis	Padrões que sugerem senhas/tokens em texto literal
Linhas longas	Excesso de linhas acima de 100 caracteres
Funções grandes	Funções com número excessivo de linhas
Imports duplicados	Imports repetidos no topo do arquivo
TODO acumulado	Volume alto de comentários TODO/FIXME
Trailing whitespace	Excesso de espaço em branco ao final de linhas
Encoding especial	Caracteres invisíveis/incomuns no arquivo

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.

Faixa	Classificação	Cor
1–5	Simples	Verde
6–10	Moderada	Amarelo
11–15	Alta	Laranja
16+	Muito alta	Vermelho

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:

Modo	Comportamento
pseudo	Detecta as sequências e aplica destaque visual colorido, sinalizando onde uma ligatura apareceria - funciona com qualquer fonte
native	Delega às ligaturas reais da fonte (requer fonte com suporte a ligaturas, ex. Fira Code, JetBrains Mono)
both	Aplica o destaque pseudo depois de ativar as ligaturas nativas da fonte
off	Nenhuma substituição visual

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.