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

Componentes básicos y compuestos como SplitPane, Toolbar y StatusBar

Fuentes

API neutral de temas, eventos, modelo de renderizado y ventanas

Fuentes

Conexión opcional con egui y rasterización de texto y SVG

Fuentes

02

Primeros pasos

  1. Prepare Rust y just, y obtenga el repositorio.
  2. 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.

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

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

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

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

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

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

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.

RepositorioLéamec3e80cb9098c
Fuentes · KUC
Todos los productos