Base y herramientas
KatanA UI Core
Base de UI Rust independiente de un framework específico. Reúne contratos de estado, eventos, temas y renderizado de componentes, con capas de conexión seleccionables.
Desarrolladores Rust que construyen componentes reutilizables o la base visual de una aplicación
01
Funciones implementadas
02
Primeros pasos
- Prepare Rust y just, y obtenga el repositorio.
- Pruebe los componentes con just storybook y active solo las funciones necesarias al integrarlos.
Prepare Rust y las herramientas de desarrollo necesarias y consulte el README enlazado para conocer los requisitos antes de integrar. Los ejemplos son puntos de entrada y no garantizan el funcionamiento en todos los entornos.
Fuentesgit clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook01 / KUC
Casos de uso
Construir pantallas con componentes UI neutrales
KUC es una base Rust, no una pantalla completa: combina atoms, molecules, layout, state, event y render model. El host elige SplitPane o Toolbar y conserva la composición de pantalla y la conexión al framework.
Activar solo las capas de render necesarias
El core predeterminado es framework-neutral; añada egui, text-raster, svg-raster o raster-host por feature. Mantenga el contrato común y seleccione UI input, raster de texto/SVG y render de UI-tree según la composición del host.
02 / KUC
Flujo de entrada a salida
Introducir componentes y configuración
El host crea SplitPane y configura axis, ratio_percent, min/max_percent, handle_width_px, resize_mode y nodos hijos. Los valores se encadenan como builder y cada componente conserva su state ID.
Convertir la interacción en contrato
Aplique resize pointer/keyboard, cambio de ratio, reset y clamp como UiAction. SplitPane corrige la proporción al rango permitido y convierte el resultado en callback log e interaction state.
Entregarlo al render model
Los componentes se convierten en UiNode y forman un render model con axis, ratio, handle, resize mode y estado común. raster-host puede conectarlo con Canvas, TextRenderer y UI-tree renderer; windowing y shell siguen siendo responsabilidad del host.
03 / KUC
APIs y CLI principales
SplitPaneAxis — Dirección de división- Representa Horizontal y Vertical y determina la dirección de división. Es un contrato de layout que se transforma en axis del render model, no solo una etiqueta.
SplitPaneResizeMode — Modos de entrada- Representa PointerOnly, KeyboardOnly, PointerAndKeyboard y Disabled. En Disabled el handle no recibe focus y el host puede limitar explícitamente la vía de entrada.
Configuración de ratio y clamp- ratio_percent es la proporción actual; min_percent y max_percent son el rango permitido; reset_percent es el valor de retorno. La entrada se aplica con clamp y una solicitud fuera de rango no se dibuja sin corregir.
Contrato público de raster-host- La feature raster-host publica Canvas, TextRenderer, UiTreeCanvasRenderer y UiTreeInteractionSurface. Agrupa render e hit/interaction, pero el uso core sin la feature no exige dependencias adicionales.
04 / KUC
Entender con un ejemplo
Aplicar el contrato de interacción de SplitPane
Construya un SplitPane horizontal al 50 %, limítelo entre 20 % y 80 %, cámbielo al 64 % con UiAction y aplique después resize de teclado y reset. El host convierte los eventos de su framework en UiAction e incorpora el callback log a su propio 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
Integración y límites
Preparar Rust workspace y features
Añada katana-ui-core como dependencia y comience con la feature predeterminada para uso framework-neutral. Active Cargo feature de egui o raster host solo cuando la aplicación necesite esas dependencias.
El host posee shell y verificación
No es una aplicación completa con AppShell ni plantillas de página. Incluso usando egui o raster host, el host construye la pantalla y gestiona ventanas; Storybook es entorno de desarrollo y hay que verificar input, layout y render en el host real.
Fuentes
Presentación basada en los repositorios públicos disponibles en el momento de la investigación. La implementación y los pasos se pueden comprobar en el commit fijado del enlace.