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
02
Per iniziare
- Prepara Rust e just e ottieni il repository.
- 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.
Fontigit clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook01 / 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
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.
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.
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.
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.