Caffeine

Workspace, tema e componentes

Stable Doppio Verificado em: Fonte: uikit/theme.rs

Como o workspace Rust do Doppio é composto: o layout PaneGrid, o kit de componentes Iced, os tokens visuais, e onde o kit legado C++ ainda se aplica.

Workspace do Doppio com hierarchy, viewport, inspector e painéis de assets em baixo
O editor é uma janela dividida por um PaneGrid. Os painéis são funções de vista puras; os primitivos interativos vivem em uikit/components/.

Duas stacks de UI, um produto#

StackUsada porLocalização
Rust / Iced O editor Doppio ativo: docking, hierarchy, viewport, inspector, assets, console e geradores. doppio/crates/ui/
C++ / ImGui UIKit O runtime autónomo, plugins legados e painéis do Doppio C++ arquivado. include/caffeine/ui/

As stacks partilham vocabulário visual, não código. Não descreva o editor Rust como usando Caffeine::UIKit; o kit C++ só é carregado pelo runtime e pelos plugins.

Janela → painel → componente#

Camada Localização Regra
Janela windows/main.rs Detém App, mensagens, subscrições e o PaneGrid.
Painel uikit/panels/*.rs view(...) -> Element pura; nunca chama text_input, checkbox, slider ou button diretamente.
Componente uikit/components/*.rs Primitivos reutilizáveis: botões, campos, cartões, tabs, menus, tree view, gizmo, viewport surface, node canvas.

Os painéis compõem componentes. scripts/check-rust-ui.sh rejeita widgets crus em uikit/panels/, o que mantém foco, hover, estados disabled e tema consistentes.

Layout e docking#

O PaneGrid padrão é construído a partir de quatro regiões:

  1. Hierarchy à esquerda.
  2. Um grupo central com Viewport, Material Generator, Texture Generator, Texture Set, Script e Dryad Nodes.
  3. Um grupo direito com Inspector, Material, Nature, Water e Terrain.
  4. Um grupo inferior com Assets e Console.

Arraste um separador pelo cabeçalho para mostrar os guias de docking: o centro adiciona ao painel de destino, uma aresta divide o painel. Os botões maximizam e restauram. Os presets estão no menu View:

Preset Atalho Resultado
Default Layout Ctrl+1 Hierarchy à esquerda, ferramentas ao centro/direita, Assets + Console em baixo
Viewport Layout Ctrl+2 Dá a maior parte da janela ao viewport

O layout Rust é estado de sessão; não é escrito em workspace.json. O Caffeine::Workspace legado em ImGui continua a persistir ~/.config/caffeine/ui/workspace.json para o runtime e hosts de plugins.

Tokens do tema#

doppio/crates/ui/src/uikit/theme.rs é a única fonte de cores, bordas e espaçamento. Os painéis não devem fixar cores.

TokenValorUsado em
BACKGROUND#151515Janela e envolvência do viewport
PANEL#242424Corpo dos painéis e cartões
PANEL_ALT#2e2e2eLinhas alternadas e inputs
TOOLBAR#1e1e1eBarras de tabs, menus e barra de estado
BORDER#313131Contornos de painéis e campos
TEXT#d6d6d6Labels e valores primários
TEXT_MUTED#8e8e8eLabels secundários e dicas
ACCENT#4a8fe0Seleção, foco e ferramentas ativas
DANGER#c24f4fEliminar, erros e ações destrutivas
WARNING#d1a03cAvisos e estados pendentes
SUCCESS#5da56bEstado gravado e verificações bem-sucedidas

As barras de identidade dos geradores usam a paleta de ícones: ciano para Material, laranja para Texture e Terrain, verde para Nature, azul-ciano para Water.

Ids de widgets estáveis#

Cada widget interativo tem um UiId hierárquico (editor.menu.scene, inspector.entity.name, hierarchy.list.entity_row.3) e uma entrada em uikit::id::CATALOG com tipo e descrição. O catálogo alimenta:

  • o targeting headless e as capturas anotadas;
  • a referência de UI gerada;
  • as ações dos agentes e as legendas em doppio/docs/ui-captions.json.

Adicione um id e uma entrada no catálogo com cada widget novo.

Kit C++ legado (runtime e plugins)#

include/caffeine/ui/ ainda fornece Theme, Widgets, Icons, PanelRegistry e Workspace para caffeine-runtime e plugins C++. É ImGui em modo imediato, não Iced. Os painéis de plugins usam caffeine/plugin/PluginUI.hpp e os mesmos ids do PanelRegistry; o layout é persistido pelo Workspace em ~/.config/caffeine/ui/workspace.json.

Nota. O editor C++ arquivado em doppio-archived/ também usava este kit. É código de referência congelado e não faz parte do editor ativo.