Base e ferramentas
KatanA UI Core
Base de UI Rust independente de um framework específico. Reúne contratos de estado, eventos, temas e renderização de componentes, com camadas de conexão selecionáveis.
Desenvolvedores Rust que constroem componentes reutilizáveis ou a base visual de um aplicativo
01
Funções implementadas
02
Primeiros passos
- Prepare Rust e just e obtenha o repositório.
- Experimente os componentes com just storybook e ative apenas as funções necessárias na integração.
Prepare Rust e as ferramentas de desenvolvimento necessárias e consulte o README indicado para os requisitos antes da integração. Os exemplos são pontos de entrada e não garantem funcionamento em todos os ambientes.
Fontesgit clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook01 / KUC
Casos de uso
Montar telas com componentes UI neutros
KUC é uma base Rust, não uma tela de aplicação pronta: combina atoms, molecules, layout, state, event e render model. O host escolhe SplitPane e Toolbar e cuida da composição da tela e da conexão com o framework.
Ativar somente a camada de render necessária
O core é framework-neutral por padrão; egui, text-raster, svg-raster e raster-host podem ser adicionados por feature. O host escolhe UI input, raster de texto/SVG e UI-tree drawing sem quebrar o contrato comum.
02 / KUC
Fluxo da entrada à saída
Informar componentes e configuração
O host cria SplitPane e define axis, ratio_percent, min/max_percent, handle_width_px, resize_mode e child nodes. Valores podem ser encadeados como builder, e cada componente mantém seu state ID.
Transformar interação em contrato
Aplique resize por pointer ou keyboard, mudança de ratio, reset e clamp como UiAction. SplitPane corrige a proporção para o intervalo e converte o resultado em callback log e interaction state.
Entregar ao render model
Os componentes viram UiNode e render model com axis, proporção, handle, resize mode e estado comum. Canvas, TextRenderer e UI-tree renderer do raster-host podem ser conectados, mas windowing e shell continuam sob responsabilidade do host.
03 / KUC
APIs e CLI principais
SplitPaneAxis — Direção da divisão- Representa Horizontal e Vertical e define a direção da divisão. Não é apenas um rótulo: vira axis no contrato de layout do render model.
SplitPaneResizeMode — Modos de entrada- Representa PointerOnly, KeyboardOnly, PointerAndKeyboard e Disabled. Em Disabled, o handle não recebe foco, limitando explicitamente a rota de input do host.
Configuração de proporção e clamp- ratio_percent é a proporção atual; min_percent e max_percent formam o intervalo permitido; reset_percent é o valor de retorno. Entradas são clampadas e pedidos fora do intervalo não são desenhados literalmente.
Contrato público do raster-host- A feature raster-host expõe Canvas, TextRenderer, UiTreeCanvasRenderer e UiTreeInteractionSurface. Ela reúne render e hit/interaction, mas usuários do core sem a feature não recebem dependências adicionais.
04 / KUC
Entenda com um exemplo
Integrar o contrato de interação do SplitPane
Crie SplitPane horizontal a 50%, aplique clamp entre 20 e 80% e use UiAction para mudar a 64%, fazer keyboard resize e reset. O host transforma eventos do framework em UiAction e incorpora o callback log ao próprio estado.
use katana_ui_core::component::ComponentAction;
use katana_ui_core::interaction::UiAction;
use katana_ui_core::layout::{SplitPane, SplitPaneAxis, SplitPaneResizeSource, SplitPaneResizeMode};
fn main() {
let mut split = SplitPane::new()
.axis(SplitPaneAxis::Horizontal)
.ratio_percent(50)
.min_percent(20)
.max_percent(80)
.resize_mode(SplitPaneResizeMode::PointerAndKeyboard);
let target = split.state_id().clone();
let _ = split.apply_action(&UiAction::split_pane_set_ratio(target.clone(), 64));
let _ = split.apply_action(&UiAction::split_pane_resize_by(
target.clone(),
4,
SplitPaneResizeSource::Keyboard,
));
let _ = split.apply_action(&UiAction::split_pane_reset_ratio(target));
println!("ratio={}", split.ratio_percent_value());
}05 / KUC
Integração e limites
Preparar workspace Rust e features
Adicione katana-ui-core à dependência e comece com o default feature para uso framework-neutral. Ative Cargo features de egui ou raster host somente quando precisar e leve suas dependências à aplicação.
Deixar shell e validação com o host
KUC não é uma aplicação pronta com AppShell ou page templates. Mesmo usando egui ou raster host, o host monta a tela e gerencia janelas. Storybook é ambiente de desenvolvimento; confirme input, layout e render no host real.
Fontes
Apresentação baseada nos repositórios públicos disponíveis no momento da pesquisa. A implementação e os passos podem ser conferidos no commit fixado do link.