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

Composants de base et composants composés comme SplitPane, Toolbar et StatusBar

Références

API neutres vis-à-vis du framework pour les thèmes, événements, modèles de rendu et fenêtres

Références

Intégration egui optionnelle et rastérisation texte/SVG

Références

02

Premiers pas

  1. Préparez Rust et just, puis récupérez le dépôt.
  2. 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érences
sh
git clone https://github.com/HiroyukiFuruno/katana-ui-core.git
cd katana-ui-core
just storybook

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

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

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

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

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

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.

DépôtFichier READMEc3e80cb9098c
Références · KUC
Tous les produits