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

Componentes básicos e compostos como SplitPane, Toolbar e StatusBar

Fontes

API neutra de temas, eventos, modelo de renderização e janelas

Fontes

Conexão opcional com egui e rasterização de texto e SVG

Fontes

02

Primeiros passos

  1. Prepare Rust e just e obtenha o repositório.
  2. 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.

Fontes
sh
git clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook

01 / 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

  1. 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.

  2. 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.

  3. 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.

rust
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.

RepositórioLeia-mec3e80cb9098c
Fontes · KUC
Todos os produtos