Base / outil
KatanA UI Core
Une base UI Rust indépendante d'un framework particulier, avec des contrats pour l'état des composants, les événements, les thèmes et le rendu, ainsi que des couches d'intégration sélectionnables.
Développeurs Rust qui construisent des composants UI réutilisables et des bases d'affichage
01
Capacités implémentées
API neutres vis-à-vis du framework pour les thèmes, événements, modèles de rendu et fenêtres
RéférencesIntégration egui optionnelle et rastérisation texte/SVG
Références02
Premiers pas
- Préparez Rust et just, puis récupérez le dépôt.
- Essayez les composants avec just storybook et activez uniquement les fonctionnalités nécessaires à l'intégration.
Préparez Rust et les outils de développement nécessaires, puis consultez le README lié pour les prérequis avant l'installation. Les exemples indiquent un point de départ et ne garantissent pas le fonctionnement dans tous les environnements.
Référencesgit clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook01 / KUC
Cas d'utilisation
Composer des écrans avec des composants neutres
KUC est une base Rust qui combine atoms, molecules, layout, state, events et render model ; ce n'est pas un écran applicatif terminé. Le host choisit SplitPane ou Toolbar et garde sa composition d'écran et son intégration framework.
Activer seulement la couche de rendu nécessaire
Le core par défaut reste framework-neutral ; egui, text-raster, svg-raster et raster-host s'activent séparément par feature Cargo. Les contrats communs restent stables tandis que le host choisit ses couches d'entrée, de rasterisation ou de rendu UI-tree.
02 / KUC
Flux entrée-sortie
Configurer un composant
Le host crée SplitPane et configure axis, ratio_percent, min_percent, max_percent, handle_width_px, resize_mode et les enfants par builder chainé. Chaque composant conserve aussi son state ID.
Appliquer les contrats d'interaction
Traduisez resize pointer/keyboard, changement de ratio, reset et clamp en UiAction. SplitPane borne le ratio demandé et produit callback log et interaction state.
Produire un render model
Les composants deviennent des UiNode contenant axis, ratio, handle, resize mode et état commun. raster-host peut relier ce modèle à Canvas, TextRenderer ou UI-tree renderer ; windowing et shell restent au host.
03 / KUC
API et CLI principales
SplitPaneAxis — Direction du partage- Horizontal et Vertical définissent la direction du split et deviennent le champ axis du render model de layout : ce n'est pas un simple libellé.
SplitPaneResizeMode — Modes de saisie- PointerOnly, KeyboardOnly, PointerAndKeyboard et Disabled limitent les routes d'entrée autorisées. Disabled rend aussi le handle non focusable.
Ratio et clamp- ratio_percent est le ratio courant, min_percent et max_percent sa plage, reset_percent la valeur de reset. Les entrées hors plage sont clampées avant rendu.
Contrat raster-host- La feature raster-host expose Canvas, TextRenderer, UiTreeCanvasRenderer et UiTreeInteractionSurface pour combiner rendu et hit/interaction. Le core sans cette feature n'ajoute pas ces dépendances.
04 / KUC
Comprendre par un exemple
Appliquer et réinitialiser le ratio d'un SplitPane
Le code crée un SplitPane horizontal à 50 %, le limite entre 20 et 80 %, puis applique UiAction pour passer à 64 %, effectuer un redimensionnement clavier et réinitialiser le ratio. Le host traduit ses événements UI en UiAction et récupère le résultat dans son propre état.
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
Intégration et limites
Préparer workspace et features
Ajoutez katana-ui-core à votre workspace Cargo et commencez avec ses features framework-neutral par défaut. Activez les features Cargo egui ou raster-host uniquement si l'application en a besoin, afin de ne pas imposer leurs dépendances au core seul.
Garder shell et vérification au host
KUC ne fournit ni AppShell, ni templates de page, ni écran complet. Même avec egui ou raster-host, le host assemble écrans et fenêtres et vérifie son application hors de Storybook.
Références
Cette présentation repose sur les dépôts publics au moment de l'examen. Vérifiez l'implémentation et l'utilisation dans les commits figés liés.