🖥️ Interface#

O Codis segue um layout inspirado em editores modernos, composto por cinco regiões principais.

Layout Geral#

┌──────────────────────────────────────────────────────────────┐
│  Menu Bar (Arquivo · Editar · Seleção · Exibir · ...)          │
├────┬────────────┬─────────────────────────────────────────────┤
│    │            │  Tab Bar                                    │
│    │            ├─────────────────────────────────────────────┤
│  A │  Sidebar   │  Breadcrumb                                 │
│  c │  (Explorer │  ─────────────────────────────────────────  │
│  t │   Git      │                                             │
│  i │   Busca    │          Área do Editor                     │
│  v │   IA       │                                             │
│  i │   etc.)    │                                             │
│  t │            ├─────────────────────────────────────────────┤
│  y │            │  Painel Inferior (Terminal · Output · ...)    │
│  B │            │                                             │
│  a ├────────────┴─────────────────────────────────────────────┤
│  r │            Barra de Status                               │
└────┴─────────────────────────────────────────────────────────┘

Activity Bar (Barra de Atividades)#

A barra vertical de 48 px à esquerda é fixa e contém os ícones de navegação principal.

A Activity Bar é composta por itens estáticos (lista fixa em ITEMS_TOP/ITEMS_BOTTOM) e itens dinâmicos, adicionados via add_plugin_item() durante a inicialização. A maior parte dos itens fica oculta por padrão - o usuário ativa via clique direito na barra (personalização).

Itens estáticos (ITEMS_TOP)#

* Com o foco no editor de código, Ctrl+Shift+N é capturado primeiro pelo Sticky Note Gutter.

Itens estáticos (ITEMS_BOTTOM)#

Itens dinâmicos (registrados via add_plugin_item())#

Clicar no mesmo ícone que está ativo fecha a sidebar. O ícone de Tema (Th) na parte inferior alterna para o próximo tema ciclicamente.

Plugins podem registrar novos itens na Activity Bar via api.add_sidebar_panel() (não register_panel() - veja Plugins).

Sidebar#

A sidebar (painel lateral) exibe o conteúdo correspondente ao item selecionado na Activity Bar.

Redimensionamento: arraste o divisor entre a sidebar e a área do editor.

Ocultação rápida: clique no botão flutuante ◀ / ▶ que aparece na borda esquerda da área do editor, ou pressione Ctrl+B (se configurado via plugin).

Explorer#

Exibe a árvore de arquivos do workspace. Suporta:

• Ícones por tipo de arquivo
• Indicadores de status Git (modificado, novo, ignorado)
• Menu de contexto (clicar com botão direito): renomear, excluir, novo arquivo/pasta
• Duplo clique para abrir; clique simples para pré-visualizar (peek)

Se nenhum workspace estiver aberto, um placeholder com botão Abrir Pasta é exibido no lugar da árvore.

Busca em Arquivos#

Pesquisa de texto completo em todos os arquivos do workspace. Suporta:

• Filtros de inclusão/exclusão de paths (*.py, !node_modules)
• Resultado clicável que abre o arquivo na linha correspondente
• Respeita .gitignore quando respect_ignore_files = true

Source Control (Git)#

Ver Git.

Assistente de IA#

Ver Assistente de IA.

Área do Editor#

A região central contém:

1. Tab Bar - abas de arquivos abertos, com indicador ● para arquivos modificados.
2. Breadcrumb - caminho completo do arquivo em camadas clicáveis. Pode ser ocultado via Exibir → Breadcrumbs. A breadcrumb é limpa automaticamente ao fechar a última aba aberta, não exibindo o caminho do arquivo fechado.
3. Search Bar - barra de busca/substituição flutuante, ativada por Ctrl+F ou Ctrl+H.
4. Container do Editor - onde os EditorPanes são exibidos.

Múltiplas Abas#

• Ctrl+Tab - próxima aba
• Ctrl+Shift+Tab - aba anterior
• Ctrl+W - fechar aba ativa
• Ao fechar uma aba com modificações, o Codis pergunta se deseja salvar.

Split Editor#

Use Exibir → Split Editor (ou o comando na Paleta de Comandos) para abrir o mesmo arquivo em uma segunda aba lado a lado. Cada aba mantém seu próprio estado de cursor e scroll.

Painel Inferior#

O painel inferior (bottom panel) contém oito abas:

Abrir/fechar: botão flutuante ▲ / ▼ no canto inferior direito, ou Ctrl+` para o Terminal, ou Ctrl+Shift+Q para o SQL Studio.

No modo K-UI, cada aba pode ser "despluggada" (⊞) para uma janela flutuante independente. Clique com o botão direito em qualquer aba para ver a opção.

Barra de Status#

A barra de status inferior exibe (da esquerda para a direita):

Notificações temporárias aparecem no centro da barra de status (ex: "Arquivo salvo", "Lint em execução"). Clicar na área de notificação abre um popup com o histórico de notificações recentes da sessão.

Botões de Alternância Flutuantes#

Dois pequenos botões flutuantes ficam sempre visíveis sobre a interface:

• ▶ / ◀ - na borda esquerda da área do editor, alterna a sidebar.
• ▲ / ▼ - no canto inferior direito (acima da barra de status), alterna o painel inferior.

Barra de Menus#

A barra de menus contém os seguintes menus:

Navegação por Teclado nos Menus#

Os dropdowns da barra de menus suportam navegação completa por teclado:

Os dropdowns também fecham automaticamente quando a janela principal é minimizada.

Paleta de Comandos#

Pressione Ctrl+Shift+P para abrir a Paleta de Comandos - um campo de busca fuzzy que lista todos os comandos disponíveis (incluindo os de plugins). A paleta exibe o atalho de teclado associado a cada comando.

Ctrl+P abre a Abertura Rápida de Arquivos, uma versão da paleta focada em arquivos recentes.