🎨 Temas#

O Codis possui um sistema de temas completo com suporte a modos claro e escuro, além de suporte a temas criados por plugins.

Temas Built-in#

21 temas inclusos, todos definidos em src/theme/base.py. O nome exibido no menu Exibir → Tema é exatamente o nome interno (sem rebranding) - a tabela abaixo só capitaliza para leitura.

Além desses, o modo K-UI aplica uma camada visual holográfica adicional sobre qualquer um dos 21 temas - ver Tema K-UI mais abaixo.

O tema padrão é fluent_dark.

Como Trocar de Tema#

Existem quatro formas de trocar de tema:

1. Menu: Exibir → Tema - lista todos os temas disponíveis.
2. Activity Bar: clique no ícone 🎨 na parte inferior da Activity Bar - avança para o próximo tema.
3. Configurações: Ctrl+, → campo theme.
4. Paleta de Comandos: Ctrl+Shift+P → "Toggle Theme".

Modos de Aplicação#

Ao trocar de tema, um diálogo pergunta qual modo aplicar:

• Modo Rápido - repinta todos os widgets sem reconstruir a UI. Mais rápido, mas alguns elementos podem ficar com cores ligeiramente inconsistentes.
• Modo Completo - destrói e reconstrói toda a interface preservando o estado (workspace e arquivos abertos). Garante consistência total de cores.

Pré-visualização antes de aplicar#

O Seletor de Temas (Exibir → Tema → Abrir Seletor de Temas...) abre um painel dedicado de pré-visualização (src/ui/theme_preview_panel.py) antes de aplicar qualquer tema definitivamente:

• Grade de cartões com todos os temas disponíveis, mostrando nome e um ícone indicando se é dark ou light
• Preview ao vivo: cada cartão mostra uma miniatura realista de como ficariam o editor, a sidebar, a tab bar e a barra de status com aquele tema - sem precisar aplicá-lo antes para ver
• Filtro por nome e por polaridade (mostrar apenas dark, apenas light, ou todos)
• Navegação totalmente por teclado: setas para mover entre cartões, Enter para confirmar, Escape para cancelar
• Ao confirmar, ainda é perguntado se a aplicação deve ser Completa ou Rápida (ver seção anterior)

Estrutura de um Tema#

Um tema é um @dataclass Theme definido em src/theme/base.py. Os atributos são organizados por grupos:

Grupo: Janela Principal#

Grupo: Editor#

O texto principal do editor usa fg (não existe um editor_fg separado no dataclass Theme, apesar de mencionado no docstring interno de base.py - trata-se de uma referência desatualizada no comentário do código-fonte).

Grupo: Sidebar e Activity Bar#

Grupo: Abas#

Grupo: Painéis e Flutuantes#

Grupo: Seleção e Inputs#

Grupo: Botões#

Grupo: Scrollbar#

Grupo: Diagnósticos#

Grupo: Syntax Highlighting#

Criando um Tema Customizado#

Método 1: Via Plugin#

A forma mais flexível é criar um plugin que registre o tema:

# meu_plugin.py
from src.plugins.api import PluginAPI, PluginManifest
from src.theme.base import Theme

MANIFEST = PluginManifest(name="meu-tema", version="1.0.0")

def activate(api: PluginAPI) -> None:
    meu_tema = Theme(
        name="meu_tema",
        dark=True,
        bg="#1a1a2e",
        fg="#e0e0e0",
        fg_muted="#888888",
        editor_bg="#16213e",
        cursor="#00d4ff",
        sidebar_bg="#0f3460",
        activity_bg="#0a2540",
        tabbar_bg="#1a1a2e",
        tab_act_bg="#0f3460",
        tab_act_fg="#ffffff",
        tab_in_fg="#aaaaaa",
        panel_bg="#0f0f1a",
        floating_bg="#1a1a2e",
        sel_bg="#0f3460",
        sel_fg="#ffffff",
        input_bg="#0f1f35",
        border="#2d3f6e",
        btn_bg="#1e2d4a",
        btn_hover="#2d3f6e",
        btn_fg="#e0e0e0",
        btn_primary="#00d4ff",
        btn_primary_fg="#000000",
        scroll_bg="#0f1f35",
        scroll_thumb="#2d3f6e",
        ok_fg="#00ff88",
        warn_fg="#ffaa00",
        err_fg="#ff4444",
        t_keyword="#00d4ff",
        t_string="#00ff88",
        t_comment="#555577",
        t_number="#ff8855",
        t_func="#88aaff",
        t_type="#ffdd44",
        t_operator="#cc88ff",
        t_decorator="#ff88cc",
    )
    api.register_theme(meu_tema)

Sobre ~/.codis/themes/#

Esse diretório é criado automaticamente na inicialização do Codis (junto com plugins/, snippets/ etc.), mas não é escaneado nem carregado automaticamente nesta versão - não há nenhum loader de tema que leia arquivos .py soltos dessa pasta. O Método 1 acima (via plugin) é a única forma funcional e suportada de registrar temas customizados.

Compatibilidade HiDPI (Windows)#

No Windows, o Codis aplica automaticamente:

• SetProcessDpiAwareness(1) via ctypes.windll.shcore
• tk scaling 1.5
• Coloração da barra de título nativa (DwmSetWindowAttribute) para combinar com o tema ativo (Windows 11)

Nenhuma configuração manual é necessária.

Tema K-UI#

O tema kui é especial - ele é registrado dinamicamente ao ativar o K-UI. Não é um tema no sentido tradicional: a K-UI renderiza sua própria paleta de cores independente (_pal()), com void escuro (#020209 escuro / #0d0d2b claro), texto luminoso e efeitos visuais que ignoram propositalmente as cores do bg para criar a estética cósmica.

Ver K-UI para detalhes.