Base e strumenti

KatanA UI Core

Base UI Rust indipendente da uno specifico framework. Riunisce contratti di stato, eventi, temi e rendering dei componenti, con livelli di connessione selezionabili.

Sviluppatori Rust che costruiscono componenti riutilizzabili o la base visiva di un'app

01

Funzioni implementate

Componenti base e composti come SplitPane, Toolbar e StatusBar

Fonti

API neutra per temi, eventi, modello di rendering e finestre

Fonti

Connessione opzionale a egui e rasterizzazione di testo e SVG

Fonti

02

Per iniziare

  1. Prepara Rust e just e ottieni il repository.
  2. Prova i componenti con just storybook e abilita solo le funzioni necessarie nell'integrazione.

Prepara Rust e gli strumenti di sviluppo necessari e consulta il README collegato per i requisiti prima dell'integrazione. Gli esempi sono punti di partenza e non garantiscono il funzionamento in ogni ambiente.

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

01 / KUC

Casi d'uso

Comporre una schermata con componenti UI neutrali

KUC non è una schermata applicativa completa, ma una base Rust che combina atoms, molecules, layout, state, event e render model. L’host sceglie SplitPane o Toolbar e gestisce la composizione specifica e il collegamento al framework.

Abilitare solo il layer di rendering necessario

Il core predefinito è framework-neutral; egui, text-raster, svg-raster e raster-host si aggiungono per feature. Mantieni il contratto comune scegliendo UI input, raster di testo/SVG e rendering UI-tree secondo la configurazione dell’host.

02 / KUC

Flusso da input a output

  1. Inserire componenti e configurazione

    L’host crea SplitPane e imposta axis, ratio_percent, min/max_percent, handle_width_px, resize_mode e i nodi figli. I valori possono essere concatenati come builder e ogni componente conserva il proprio state ID.

  2. Rendere contrattuale l’interazione

    Applica come UiAction resize pointer o keyboard, modifica ratio, reset e clamp. SplitPane corregge il rapporto nell’intervallo e converte il risultato in callback log e interaction state.

  3. Passare al render model

    I componenti diventano UiNode e formano un render model con axis, rapporto, handle, resize mode e stato condiviso. Latest HEAD può collegarlo a Canvas, TextRenderer e UI-tree renderer di raster-host; windowing e shell applicativi restano responsabilità dell’host.

03 / KUC

API e CLI principali

SplitPaneAxis — Direzione della divisione
Rappresenta Horizontal e Vertical e determina la direzione della divisione. Non è una semplice label: diventa il contratto axis del render model.
SplitPaneResizeMode — Modalità di input
Rappresenta PointerOnly, KeyboardOnly, PointerAndKeyboard e Disabled. Con Disabled l’handle non è focusable e il percorso di input dell’host è limitato esplicitamente.
Impostazioni ratio e clamp
ratio_percent è il rapporto corrente, min_percent e max_percent sono i limiti consentiti e reset_percent il valore di ritorno. L’input viene sottoposto a clamp e una richiesta fuori intervallo non viene disegnata così com’è.
Contratto pubblico raster-host
La feature raster-host pubblica Canvas, TextRenderer, UiTreeCanvasRenderer e UiTreeInteractionSurface. Riunisce rendering e hit/interaction, ma chi usa il core senza feature non riceve dipendenze aggiuntive.

04 / KUC

Capire con un esempio

Integrare il contratto di interazione di SplitPane

Crea SplitPane orizzontale al 50%, applica clamp 20–80%, cambialo al 64% con UiAction e poi applica keyboard resize e reset. L’host traduce gli eventi del framework UI in UiAction e incorpora il callback log nel proprio state.

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

Integrazione e limiti

Preparare workspace Rust e feature

Aggiungi katana-ui-core come dipendenza e, per un uso framework-neutral, inizia con la feature default. Abilita Cargo feature solo quando servono egui o raster host, portando nell’app le dipendenze specifiche.

Lasciare shell e verifica all’host

Non è un’app completa con AppShell o page template. Anche usando il layer egui o raster host, l’host costruisce composizione e window management. Storybook è un ambiente di verifica per sviluppo: controlla input, layout e rendering anche nell’host reale.

Fonti

Presentazione basata sui repository pubblici disponibili al momento della ricerca. Implementazione e procedure sono verificabili nel commit fissato del link.

Archivio del codiceLeggimic3e80cb9098c
Fonti · KUC
Tutti i prodotti