Workspace, tema e componentes
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.
PaneGrid. Os painéis são funções de vista puras; os primitivos interativos vivem em uikit/components/.Duas stacks de UI, um produto#
| Stack | Usada por | Localizaçã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:
- Hierarchy à esquerda.
- Um grupo central com Viewport, Material Generator, Texture Generator, Texture Set, Script e Dryad Nodes.
- Um grupo direito com Inspector, Material, Nature, Water e Terrain.
- 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.
| Token | Valor | Usado em |
|---|---|---|
BACKGROUND | #151515 | Janela e envolvência do viewport |
PANEL | #242424 | Corpo dos painéis e cartões |
PANEL_ALT | #2e2e2e | Linhas alternadas e inputs |
TOOLBAR | #1e1e1e | Barras de tabs, menus e barra de estado |
BORDER | #313131 | Contornos de painéis e campos |
TEXT | #d6d6d6 | Labels e valores primários |
TEXT_MUTED | #8e8e8e | Labels secundários e dicas |
ACCENT | #4a8fe0 | Seleção, foco e ferramentas ativas |
DANGER | #c24f4f | Eliminar, erros e ações destrutivas |
WARNING | #d1a03c | Avisos e estados pendentes |
SUCCESS | #5da56b | Estado 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.