diff --git a/Cargo.toml b/Cargo.toml index ff214d5..29f254a 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,12 +1,12 @@ # file: Cargo.toml -# version: 66 +# version: 67 [workspace] resolver = "3" members = ["crates/ksp-app-config-desk", "crates/ksp-config-lib", "crates/ksp-core-lib", "crates/ksp-logging-lib"] [workspace.package] -version = "0.1.4-pre.4.fix.1" +version = "0.1.4-pre.5" edition = "2024" license = "MIT" repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project" @@ -25,6 +25,7 @@ tracing-appender = { version = "^0.2", default-features = false } tokio = { version = "^1.53", default-features = false, features = ["rt", "rt-multi-thread", "macros"] } tauri = { version = "^2.11" } tauri-build = { version = "^2.6" } +tauri-plugin-tracing = { version = "^0.3" } [workspace.lints.rust] missing_docs = "warn" diff --git a/crates/ksp-app-config-desk/Cargo.toml b/crates/ksp-app-config-desk/Cargo.toml index 822576c..c8ea492 100644 --- a/crates/ksp-app-config-desk/Cargo.toml +++ b/crates/ksp-app-config-desk/Cargo.toml @@ -1,5 +1,5 @@ # file: crates/ksp-app-config-desk/Cargo.toml -# version: 1 +# version: 2 [package] name = "ksp-app-config-desk" @@ -25,6 +25,7 @@ tauri-build.workspace = true fs2.workspace = true ksp-core-lib = { path = "../ksp-core-lib" } tauri.workspace = true +tauri-plugin-tracing.workspace = true [lints] workspace = true diff --git a/crates/ksp-app-config-desk/README.md b/crates/ksp-app-config-desk/README.md index 755c5d4..ea32d60 100644 --- a/crates/ksp-app-config-desk/README.md +++ b/crates/ksp-app-config-desk/README.md @@ -1,5 +1,5 @@ - + # `ksp-app-config-desk` @@ -15,41 +15,71 @@ bin : ksp-app-config-desk ## Responsabilités -L'application restera une couche d'interface/composition. Les responsabilités de parsing, validation, profils, environnement, `.env`, secrets et persistence restent dans `ksp-config-lib`; le runtime Logging restera possédé par `ksp-logging-lib`. +L'application reste une couche d'interface/composition. Les responsabilités de parsing, validation, profils, environnement, `.env`, secrets et persistence restent dans `ksp-config-lib`; le runtime Logging restera possédé par `ksp-logging-lib`. -La première tranche de squelette établit uniquement : +Le gabarit desktop actif fournit maintenant : -- le membre workspace Rust ; -- le couple `lib` + `bin` ; - le verrou single-instance ; -- l'assemblage Tauri minimal dans `src/tauri.rs` ; +- l'assemblage Tauri centralisé dans `src/tauri.rs` ; - les fenêtres `splash` et `main` ; -- les capabilities initiales ; -- l'icône de référence reprise du gabarit desktop éprouvé ; -- le port de développement réservé `1430`, avec `1431` réservé au HMR Vite ; -- le répertoire frontend cible `frontend/`, dont `frontend/ts/` et `frontend/ts/bindings/`. +- le frontend Vanilla TypeScript + Vite sous `frontend/` ; +- SCSS, Bootstrap et Font Awesome ; +- SimpleBar + `resize-observer-polyfill` pour le scrolling du shell ; +- `tauri-plugin-tracing` côté Rust et `@fltsci/tauri-plugin-tracing` côté frontend ; +- les ports dédiés `1430` pour Vite HTTP et `1431` pour le WebSocket de développement ; +- la destination frontend externe commune à Tauri et Vite. -Le frontend Vite/TypeScript/SCSS et les dépendances npm sont introduits dans la tranche suivante. Tant que cette tranche n'est pas appliquée, `cargo tauri dev` n'est pas un scénario de validation attendu de ce squelette. +Le bridge de logging frontend KSP à target explicite n'est pas encore introduit : il appartient à une tranche dédiée afin de passer par `ksp-logging-lib` et de ne pas figer le target vide du bridge JS générique comme contrat KSP. + +## Layout frontend + +```text +frontend/ +├── imgs/ +├── sass/ +│ ├── _app.scss +│ ├── _bootswatch.scss +│ ├── _fontawesome.scss +│ ├── _simplebar.scss +│ ├── _variables.scss +│ ├── main.scss +│ └── splash.scss +├── ts/ +│ ├── main.ts +│ └── splash.ts +├── main.html +└── splash.html +``` + +Les futurs bindings TS-RS seront générés sous : + +```text +frontend/ts/bindings/ksp_app_config_desk/... +``` + +Le répertoire de bindings n'est pas créé artificiellement avant le premier DTO réel. ## Artefacts frontend -Les artefacts frontend construits ne doivent pas être versionnés. `tauri.conf.json` fixe dès maintenant la destination contractuelle : +Les artefacts frontend construits ne sont pas versionnés. `tauri.conf.json` fixe : ```text ../../builds/khadhroony-solana-project/ksp-app-config-desk/dist ``` -`vite.config.ts` utilisera la même destination lors de son introduction. - -Les commandes npm servent uniquement à installer/mettre à jour les dépendances. Le cycle normal de développement/build de l'application passe par Tauri, qui déclenche les scripts frontend déclarés dans sa configuration. +`vite.config.ts` résout cette même destination depuis la racine de la crate, ce qui maintient `dist` hors du workspace source et l'aligne avec la stratégie `.cargo/config.toml` pour les artefacts Rust. ## Ports desktop -KSP réserve des couples de ports distincts par application desk. `ksp-app-config-desk`, première application, utilise : +`ksp-app-config-desk` utilise : ```text Vite HTTP : 1430 -Vite HMR : 1431 +Vite WS : 1431 ``` -Les applications desk suivantes incrémentent le couple de deux ports afin de pouvoir fonctionner simultanément sans collision. +Le port HTTP est strict. Les futures applications desk utilisent les couples suivants `1432/1433`, `1434/1435`, etc. + +## Dépendances frontend + +Les dépendances frontend sont déclarées comme dépendances de développement car elles sont bundlées dans l'application desktop. Les commandes npm directes sont réservées à leur installation/mise à jour. Le cycle normal de développement et de build passe par Tauri, qui déclenche les scripts `dev` et `build`. diff --git a/crates/ksp-app-config-desk/TODO.md b/crates/ksp-app-config-desk/TODO.md index bceb0f6..24c07fc 100644 --- a/crates/ksp-app-config-desk/TODO.md +++ b/crates/ksp-app-config-desk/TODO.md @@ -1,16 +1,16 @@ - + # TODO `ksp-app-config-desk` -Les éléments suivants appartiennent aux prochaines tranches de `0.1.4` : +Le gabarit frontend de base est maintenant en place : Vite/TypeScript/SCSS, Bootstrap, Font Awesome, SimpleBar, resize observer, plugin tracing et ports dédiés. + +Les prochaines tranches doivent encore : -- ajouter le gabarit frontend Vite/TypeScript/SCSS sous `frontend/` ; -- ajouter `package.json`, `tsconfig.json` et `vite.config.ts` ; -- réserver strictement `1430` pour Vite et `1431` pour HMR ; -- introduire SimpleBar, `resize-observer-polyfill`, Bootstrap et Font Awesome selon le gabarit retenu ; -- intégrer `tauri-plugin-tracing` et `@fltsci/tauri-plugin-tracing` ; - introduire les DTO TS-RS au premier contrat Tauri réel, avec bindings générés sous `frontend/ts/bindings/` ; -- introduire `AppState`, Config et l'ownership de `LoggingGuard` ; +- introduire `AppState`, `ksp-config-lib`, `ksp-logging-lib` et l'ownership durable de `LoggingGuard` ; +- reprendre/refondre `frontend_log.ts` depuis bot3 avec targets KSP whitelistés et émission via `ksp-logging-lib` ; +- finaliser le lifecycle splash configurable sans temporisation environnementale codée en dur ; - développer les panneaux Documents, Profils, Environnement/`.env`, Secrets et Logging ; +- introduire DataTables au premier tableau qui exige tri, filtrage, sélection ou checkbox ; - démontrer le hot reload Logging et le panneau de test de routage. diff --git a/crates/ksp-app-config-desk/USAGE.md b/crates/ksp-app-config-desk/USAGE.md index 949beb3..b6526e5 100644 --- a/crates/ksp-app-config-desk/USAGE.md +++ b/crates/ksp-app-config-desk/USAGE.md @@ -1,34 +1,81 @@ - + # Utilisation de `ksp-app-config-desk` ## État actuel -La tranche `0.1.4-pre.004` introduit le squelette Rust/Tauri uniquement. Les fenêtres frontend ne deviennent exécutables qu'après l'ajout du gabarit Vite/TypeScript prévu par la tranche suivante. +Le gabarit Rust/Tauri et le frontend Vite/TypeScript/SCSS sont maintenant présents. Les panneaux métier Config restent volontairement absents à ce stade. -## Entrée binaire +La fenêtre `splash` est la fenêtre visible au démarrage. La fenêtre `main` est déjà construite et bundlée, mais son lifecycle d'affichage est finalisé dans la tranche splash/shell dédiée afin de ne pas introduire une temporisation codée en dur. -Le binaire `ksp-app-config-desk` : +## Première installation des dépendances frontend -1. acquiert un verrou single-instance dans le répertoire temporaire du système ; -2. collecte les arguments de processus sans lire directement de variable `KSP_*`/`KSPB_*` ; -3. appelle `ksp_app_config_desk_lib::run()` ; -4. convertit explicitement le résultat en `ExitCode`. +Depuis : -Les arguments Config `--cfgpath`, `--schemapath` et `--filemap` seront consommés par les APIs `ksp-config-lib` dans la tranche de bootstrap applicatif prévue plus loin ; le binaire ne doit pas en réimplémenter le parsing. +```text +crates/ksp-app-config-desk +``` -## Fenêtres réservées +installer les dépendances déclarées avec la commande de gestion prévue par le projet : -Deux fenêtres sont déjà déclarées dans `tauri.conf.json` : +```bash +npm i -D +``` -- `splash` : lifecycle de démarrage commun ; -- `main` : shell de management Config. +Les lockfiles frontend restent ignorés et ne sont pas versionnés. -Leur contenu HTML/TypeScript est ajouté avec le gabarit frontend. +## Développement normal -## Développement frontend +Le frontend n'est pas lancé directement avec npm. Depuis la crate ou avec le package explicitement sélectionné selon l'environnement Cargo/Tauri, utiliser le cycle Tauri habituel : -Le cycle normal utilisera `cargo tauri dev`. Tauri déclenchera alors `npm run dev` via `beforeDevCommand` et chargera le serveur Vite sur le port `1430`. +```bash +cargo tauri dev +``` -Les commandes npm directes sont réservées à la gestion des dépendances (`npm i -D ...` selon la politique du projet), et non au lancement quotidien de l'application. +Tauri exécute alors le hook : + +```text +npm run dev +``` + +Vite écoute strictement sur : + +```text +HTTP : 1430 +WS : 1431 +``` + +Si le port HTTP est déjà occupé, le démarrage doit échouer au lieu de sélectionner silencieusement un autre port. + +## Build frontend + +Le build de l'application passe également par Tauri. `beforeBuildCommand` déclenche : + +```text +npm run build +``` + +Vite construit les pages `main.html` et `splash.html` vers : + +```text +../../builds/khadhroony-solana-project/ksp-app-config-desk/dist +``` + +Cette destination est résolue depuis la racine de la crate dans `vite.config.ts` et correspond au `frontendDist` de `tauri.conf.json`. + +## Tracing desktop + +`tauri-plugin-tracing` est enregistré côté Rust et la capability contient `tracing:default`. Le package frontend associé est installé avec le gabarit. + +Cette tranche n'utilise pas encore le bridge JavaScript pour émettre les logs KSP applicatifs : `frontend_log.ts`, les targets KSP whitelistés et la commande `emit_frontend_log` sont introduits dans la tranche dédiée après initialisation de `ksp-logging-lib`. + +## Bindings TS-RS + +Le layout cible est : + +```text +frontend/ts/bindings/ksp_app_config_desk/... +``` + +Les bindings sont générés au premier DTO Tauri réel ; aucune structure factice n'est ajoutée uniquement pour créer le répertoire. diff --git a/crates/ksp-app-config-desk/capabilities/default.json b/crates/ksp-app-config-desk/capabilities/default.json index ba19e03..8ac7790 100644 --- a/crates/ksp-app-config-desk/capabilities/default.json +++ b/crates/ksp-app-config-desk/capabilities/default.json @@ -7,6 +7,7 @@ "main" ], "permissions": [ - "core:default" + "core:default", + "tracing:default" ] -} +} \ No newline at end of file diff --git a/crates/ksp-app-config-desk/frontend/imgs/logo.png b/crates/ksp-app-config-desk/frontend/imgs/logo.png new file mode 100644 index 0000000..94e89ca Binary files /dev/null and b/crates/ksp-app-config-desk/frontend/imgs/logo.png differ diff --git a/crates/ksp-app-config-desk/frontend/imgs/splash.png b/crates/ksp-app-config-desk/frontend/imgs/splash.png new file mode 100644 index 0000000..a27d1eb Binary files /dev/null and b/crates/ksp-app-config-desk/frontend/imgs/splash.png differ diff --git a/crates/ksp-app-config-desk/frontend/main.html b/crates/ksp-app-config-desk/frontend/main.html new file mode 100644 index 0000000..a2ab63d --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/main.html @@ -0,0 +1,53 @@ + + + + + + + + + + + KSP Config Desk + + + +
+ +
+ +
+
+
+
+
+

Configuration KSP

+

+ Le shell desktop est prêt. Les panneaux Documents, Profils, Environnement et Logging seront ajoutés dans les prereleases suivantes. +

+
+ + Initialisation du frontend... +
+
+
+
+
+
+ + + + + + diff --git a/crates/ksp-app-config-desk/frontend/sass/_app.scss b/crates/ksp-app-config-desk/frontend/sass/_app.scss new file mode 100644 index 0000000..d8c29ac --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/_app.scss @@ -0,0 +1,60 @@ +// file: crates/ksp-app-config-desk/frontend/sass/_app.scss +// version: 1 + +$app-header-height: 72px; +$app-footer-height: 42px; + +html, +body { + width: 100%; + height: 100%; +} + +body { + margin: 0; + overflow: hidden; + background: $gray-100; +} + +.app-header { + position: fixed; + inset: 0 0 auto; + height: $app-header-height; + z-index: 1020; + border-bottom: 2px solid rgba($primary, 0.3); +} + +.app-footer { + position: fixed; + inset: auto 0 0; + height: $app-footer-height; + z-index: 1020; + border-top: 2px solid rgba($primary, 0.3); +} + +.app-main { + position: relative; + height: calc(100vh - $app-header-height - $app-footer-height); + margin-top: $app-header-height; + margin-bottom: $app-footer-height; + overflow: hidden; +} + +.app-scrollable { + height: 100%; + max-height: 100%; +} + +.app-logo { + display: block; + width: auto; + height: 42px; +} + +.app-shell-card { + max-width: 980px; +} + +.app-shell-status { + font-family: var(--bs-font-monospace); +} diff --git a/crates/ksp-app-config-desk/frontend/sass/_bootswatch.scss b/crates/ksp-app-config-desk/frontend/sass/_bootswatch.scss new file mode 100644 index 0000000..9559dfb --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/_bootswatch.scss @@ -0,0 +1,160 @@ +// file: crates/ksp-app-config-desk/frontend/sass/_bootswatch.scss +// version: 1 + +// Pulse 5.3.8 +// Bootswatch + + +// Variables + +// Buttons + +.btn { + + &:focus, + &:active, + &:active:focus, + &.active:focus { + outline: none; + } + + &-secondary { + color: $gray-900; + background-color: $white; + border-color: #ccc; + + &:hover { + color: $gray-900; + background-color: $gray-300; + border-color: $gray-500; + } + + &.disabled { + color: tint-color($gray-900, 5%); + background-color: $white; + border-color: tint-color(#ccc, 5%); + } + } + + &-warning { + color: $white; + } + + &-primary:focus { + box-shadow: 0 0 5px tint-color($primary, 10%); + } + + &-secondary:focus { + box-shadow: 0 0 5px $gray-400; + } + + &-success:focus { + box-shadow: 0 0 5px tint-color($success, 10%); + } + + &-info:focus { + box-shadow: 0 0 5px tint-color($info, 10%); + } + + &-warning:focus { + box-shadow: 0 0 5px tint-color($warning, 10%); + } + + &-danger:focus { + box-shadow: 0 0 5px tint-color($danger, 10%); + } + + &.disabled:focus { + box-shadow: none; + } +} + +// Tables + +.table .thead-dark th { + background-color: $secondary; + border-color: $table-border-color; +} + +.table-primary, +.table-secondary, +.table-success, +.table-warning, +.table-danger, +.table-info, +.table-light { + --#{$prefix}table-color: #{$body-color}; +} + +// Forms + +.form-control:focus { + box-shadow: 0 0 5px rgba(100, 65, 164, .4); +} + +// Navs + +.nav-tabs { + + .nav-link, + .nav-link.active { + border-width: 0 0 1px; + } + + .nav-link:hover, + .nav-link.active, + .nav-link.active:hover, + .nav-link.active:focus { + border-bottom: 1px solid $primary; + } + + .nav-item+.nav-item { + margin-left: 0; + } +} + +.breadcrumb { + &-item.active { + color: $gray-700; + } +} + +// Indicators + +.badge { + &.bg-light { + color: $dark; + } +} + +// Progress bars + +.progress { + height: 8px; +} + +// Containers + +.list-group { + &-item { + color: rgba(255, 255, 255, .8); + + &.active, + &:hover, + &:focus { + color: $white; + } + + &.active { + font-weight: 700; + + &:hover { + background-color: $list-group-hover-bg; + } + } + + &.disabled:hover { + color: $list-group-disabled-color; + } + } +} \ No newline at end of file diff --git a/crates/ksp-app-config-desk/frontend/sass/_fontawesome.scss b/crates/ksp-app-config-desk/frontend/sass/_fontawesome.scss new file mode 100644 index 0000000..853e949 --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/_fontawesome.scss @@ -0,0 +1,19 @@ +// file: crates/ksp-app-config-desk/frontend/sass/_fontawesome.scss +// version: 1 + +//@use '@fortawesome/fontawesome-free/scss/variables' with ( +// // customizing $font-path - make sure it points to where your webfonts are stored in your project +// $font-path: '../webfonts', +//); +@use '@fortawesome/fontawesome-free/scss/variables' with ( + // use fonts from @fortawesome/fontawesome-free + $font-path: '@fortawesome/fontawesome-free/webfonts', +); +// load Font Awesome core +@use '@fortawesome/fontawesome-free/scss/fontawesome'; + +// load and make available Font Awesome helpers (mixins, functions, and variables) +@use '@fortawesome/fontawesome-free/scss/fa' as fa; +@use '@fortawesome/fontawesome-free/scss/brands' as fa-brands; +@use '@fortawesome/fontawesome-free/scss/regular' as fa-regular; +@use '@fortawesome/fontawesome-free/scss/solid' as fa-solid; \ No newline at end of file diff --git a/crates/ksp-app-config-desk/frontend/sass/_simplebar.scss b/crates/ksp-app-config-desk/frontend/sass/_simplebar.scss new file mode 100644 index 0000000..ee29ebb --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/_simplebar.scss @@ -0,0 +1,248 @@ +// file: crates/ksp-app-config-desk/frontend/sass/_simplebar.scss +// version: 1 + +/* Rtl support */ +[data-simplebar] { + position: relative; + flex-direction: column; + flex-wrap: wrap; + justify-content: flex-start; + align-content: flex-start; + align-items: flex-start; +} + +.simplebar-wrapper { + overflow: hidden; + width: inherit; + height: inherit; + max-width: inherit; + max-height: inherit; +} + +.simplebar-mask { + direction: inherit; + position: absolute; + overflow: hidden; + padding: 0; + margin: 0; + left: 0; + top: 0; + bottom: 0; + right: 0; + width: auto !important; + height: auto !important; +// z-index: 0; + inset: 0; +} + +.simplebar-offset { + direction: inherit !important; + box-sizing: inherit !important; + resize: none !important; + position: absolute; + top: 0; + left: 0; + bottom: 0; + right: 0; + padding: 0; + margin: 0; + -webkit-overflow-scrolling: touch; + inset: 0; +} + +.simplebar-content-wrapper { + direction: inherit; + box-sizing: border-box !important; + position: relative; + display: block; + height: 100%; + width: auto; + max-width: 100%; + max-height: 100%; + overflow: auto; + scrollbar-width: none; + -ms-overflow-style: none; + + &::-webkit-scrollbar { + display: none; + width: 0; + height: 0; + } +} + +.simplebar-hide-scrollbar { + &::-webkit-scrollbar { + display: none; + width: 0; + height: 0; + } + + position: fixed; + left: 0; + visibility: hidden; + overflow-y: scroll; + scrollbar-width: none; + -ms-overflow-style: none; +} + +.simplebar-content { + &:before { + content: ' '; + display: table; + } + + &:after { + content: ' '; + display: table; + } +} + +.simplebar-placeholder { + max-height: 100%; + max-width: 100%; + width: 100%; + pointer-events: none; +} + +.simplebar-height-auto-observer-wrapper { + box-sizing: inherit !important; + height: 100%; + width: 100%; + max-width: 1px; + position: relative; + float: left; + max-height: 1px; + overflow: hidden; +// z-index: -1; + padding: 0; + margin: 0; + pointer-events: none; + flex-grow: inherit; + flex-shrink: 0; + flex-basis: 0; +} + +.simplebar-height-auto-observer { + box-sizing: inherit; + display: block; + opacity: 0; + position: absolute; + top: 0; + left: 0; + height: 1000%; + width: 1000%; + min-height: 1px; + min-width: 1px; + overflow: hidden; + pointer-events: none; +// z-index: -1; +} + +.simplebar-track { +// z-index: 1; + position: absolute; + right: 0; + bottom: 0; + pointer-events: none; + overflow: hidden; +} + +[data-simplebar].simplebar-dragging { + pointer-events: none; + -webkit-touch-callout: none; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; + + .simplebar-content { + pointer-events: none; + -webkit-touch-callout: none; + -webkit-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; + } + + .simplebar-track { + pointer-events: all; + } +} + +.simplebar-scrollbar { + position: absolute; + left: 0; + right: 0; + min-height: 10px; + + + &:before { + position: absolute; + content: ''; + background: black; + border-radius: 7px; + left: 2px; + right: 2px; + opacity: 0; + transition: opacity 0.2s 0.5s linear; + top: 2px; + bottom: 2px; + } +} + +.simplebar-scrollbar.simplebar-visible { + &:before { + opacity: 0.5; + transition-delay: 0s; + transition-duration: 0s; + } +} + +.simplebar-track.simplebar-vertical { + top: 0; + width: 11px; +} + +.simplebar-track.simplebar-horizontal { + left: 0; + height: 11px; + + .simplebar-scrollbar { + right: auto; + left: 0; + top: 0; + bottom: 0; + min-height: 0; + min-width: 10px; + width: auto; + } +} + +[data-simplebar-direction='rtl'] { + .simplebar-track.simplebar-vertical { + right: auto; + left: 0; + } +} + +.simplebar-dummy-scrollbar-size { + direction: rtl; + position: fixed; + opacity: 0; + visibility: hidden; + height: 500px; + width: 500px; + overflow-y: hidden; + overflow-x: scroll; + -ms-overflow-style: scrollbar !important; + + >div { + width: 200%; + height: 200%; + margin: 10px 0; + } +} + +.simplebar-hover { + cursor: pointer; +} \ No newline at end of file diff --git a/crates/ksp-app-config-desk/frontend/sass/_variables.scss b/crates/ksp-app-config-desk/frontend/sass/_variables.scss new file mode 100644 index 0000000..2fcc115 --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/_variables.scss @@ -0,0 +1,95 @@ +// file: crates/ksp-app-config-desk/frontend/sass/_variables.scss +// version: 1 + +// Pulse 5.3.8 +// Bootswatch + +$theme: "pulse" !default; + +// +// Color system +// + +$white: #fff !default; +$gray-100: #fafafa !default; +$gray-200: #f9f8fc !default; +$gray-300: #ededed !default; +$gray-400: #cbc8d0 !default; +$gray-500: #adb5bd !default; +$gray-600: #868e96 !default; +$gray-700: #444 !default; +$gray-800: #343a40 !default; +$gray-900: #17141f !default; +$black: #000 !default; + +$blue: #007bff !default; +$indigo: #6610f2 !default; +$purple: #593196 !default; +$pink: #e83e8c !default; +$red: #fc3939 !default; +$orange: #fd7e14 !default; +$yellow: #efa31d !default; +$green: #13b955 !default; +$teal: #20c997 !default; +$cyan: #009cdc !default; + +$primary: $purple !default; +$secondary: #a991d4 !default; +$success: $green !default; +$info: $cyan !default; +$warning: $yellow !default; +$danger: $red !default; +$light: $gray-200 !default; +$dark: $gray-900 !default; + +$min-contrast-ratio: 2.1 !default; + +// Options + +$enable-rounded: false !default; + +// Body + +$body-color: $gray-700 !default; + +// Links + +$link-hover-color: $primary !default; + +// Tables + +$table-color: initial !default; + +$table-border-color: rgba(0, 0, 0, .05) !default; + +// Forms + +$input-focus-border-color: $primary !default; + +// Dropdowns + +$dropdown-link-hover-color: $white !default; +$dropdown-link-hover-bg: $primary !default; + +// Navs + +$nav-tabs-border-color: $gray-300 !default; +$nav-tabs-link-hover-border-color: $primary !default; + +// Navbar + +$navbar-padding-y: 1.2rem !default; + +// Progress bars + +$progress-bg: $gray-300 !default; +$progress-bar-bg: $primary !default; + +// List group + +$list-group-bg: $gray-900 !default; +$list-group-border-color: transparent !default; +$list-group-hover-bg: lighten($list-group-bg, 10%) !default; +$list-group-active-color: $white !default; +$list-group-active-bg: $list-group-bg !default; +$list-group-disabled-color: lighten($list-group-bg, 30%) !default; \ No newline at end of file diff --git a/crates/ksp-app-config-desk/frontend/sass/main.scss b/crates/ksp-app-config-desk/frontend/sass/main.scss new file mode 100644 index 0000000..ee68dde --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/main.scss @@ -0,0 +1,10 @@ +// file: crates/ksp-app-config-desk/frontend/sass/main.scss +// version: 1 + +@import "bootstrap/scss/functions"; +@import "variables"; +@import "fontawesome"; +@import "simplebar"; +@import "bootstrap/scss/bootstrap"; +@import "bootswatch"; +@import "app"; diff --git a/crates/ksp-app-config-desk/frontend/sass/splash.scss b/crates/ksp-app-config-desk/frontend/sass/splash.scss new file mode 100644 index 0000000..a88fb2c --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/sass/splash.scss @@ -0,0 +1,57 @@ +// file: crates/ksp-app-config-desk/frontend/sass/splash.scss +// version: 1 + +body { + display: flex; + width: 100vw; + height: 100vh; + margin: 0; + padding: 0; + overflow: hidden; + align-items: center; + justify-content: center; + background: transparent; + font-family: Arial, sans-serif; +} + +#splash-container { + position: relative; + width: 960px; + height: 637px; + opacity: 1; +} + +#splash-image { + position: absolute; + inset: 0; + width: 100%; + height: 100%; + z-index: 1; +} + +#app-name { + position: absolute; + top: 50%; + left: 50%; + z-index: 2; + transform: translate(-50%, -50%); + color: #fff; + font-family: "Arial Black", Arial, sans-serif; + font-size: 76px; + font-weight: bold; + text-align: center; + text-shadow: 0 0 10px rgba(0, 0, 0, 0.5); +} + +#splash-status { + position: absolute; + right: 1rem; + bottom: 1rem; + left: 1rem; + z-index: 3; + padding: 0.55rem 0.75rem; + color: #fff; + background: rgba(0, 0, 0, 0.35); + font-family: monospace; + font-size: 0.82rem; +} diff --git a/crates/ksp-app-config-desk/frontend/splash.html b/crates/ksp-app-config-desk/frontend/splash.html new file mode 100644 index 0000000..2c4df7d --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/splash.html @@ -0,0 +1,22 @@ + + + + + + + + + + KSP Config Desk — Chargement + + + +
+ Chargement de KSP Config Desk +
KSP
+
Chargement du shell frontend...
+
+ + + + diff --git a/crates/ksp-app-config-desk/frontend/ts/main.ts b/crates/ksp-app-config-desk/frontend/ts/main.ts new file mode 100644 index 0000000..6289077 --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/ts/main.ts @@ -0,0 +1,16 @@ +// file: crates/ksp-app-config-desk/frontend/ts/main.ts +// version: 1 + +import "bootstrap"; +import ResizeObserver from "resize-observer-polyfill"; +import "simplebar"; +import { getCurrentWindow } from "@tauri-apps/api/window"; + +(window as Window & typeof globalThis & { ResizeObserver?: typeof ResizeObserver }).ResizeObserver = ResizeObserver; + +document.addEventListener("DOMContentLoaded", () => { + const status = document.querySelector("#shellStatus"); + if (status) { + status.textContent = `Frontend chargé dans la fenêtre '${getCurrentWindow().label}'.`; + } +}); diff --git a/crates/ksp-app-config-desk/frontend/ts/splash.ts b/crates/ksp-app-config-desk/frontend/ts/splash.ts new file mode 100644 index 0000000..fc93f43 --- /dev/null +++ b/crates/ksp-app-config-desk/frontend/ts/splash.ts @@ -0,0 +1,11 @@ +// file: crates/ksp-app-config-desk/frontend/ts/splash.ts +// version: 1 + +import { getCurrentWindow } from "@tauri-apps/api/window"; + +document.addEventListener("DOMContentLoaded", () => { + const status = document.querySelector("#splash-status"); + if (status) { + status.textContent = `Frontend chargé dans la fenêtre '${getCurrentWindow().label}'. Lifecycle complet prévu en pre.008.`; + } +}); diff --git a/crates/ksp-app-config-desk/package.json b/crates/ksp-app-config-desk/package.json new file mode 100644 index 0000000..fb895b1 --- /dev/null +++ b/crates/ksp-app-config-desk/package.json @@ -0,0 +1,22 @@ +{ + "name": "ksp-app-config-desk", + "private": true, + "version": "0.1.4", + "type": "module", + "scripts": { + "dev": "vite", + "build": "tsc && vite build" + }, + "devDependencies": { + "@fltsci/tauri-plugin-tracing": "^0.3", + "@fortawesome/fontawesome-free": "^7.3", + "@tauri-apps/api": "^2.11", + "@types/node": "^26.1", + "bootstrap": "^5.3", + "resize-observer-polyfill": "^1.5", + "sass-embedded": "^1.102", + "simplebar": "^6.3", + "typescript": "^7.0", + "vite": "^8.2" + } +} \ No newline at end of file diff --git a/crates/ksp-app-config-desk/src/main.rs b/crates/ksp-app-config-desk/src/main.rs index c0a5279..5b73e51 100644 --- a/crates/ksp-app-config-desk/src/main.rs +++ b/crates/ksp-app-config-desk/src/main.rs @@ -1,5 +1,5 @@ // file: crates/ksp-app-config-desk/src/main.rs -// version: 1 +// version: 2 //! Binary entry point for the KSP configuration desktop application. @@ -13,7 +13,7 @@ use fs2::FileExt; // rust-rules: trait-import fn main() -> std::process::ExitCode { let mut lock_path = std::env::temp_dir(); lock_path.push("com_sasedev_ksp_app_config_desk.lock"); - let lock_file = match std::fs::OpenOptions::new().read(true).write(true).create(true).open(&lock_path) { + let lock_file = match std::fs::OpenOptions::new().read(true).write(true).create(true).truncate(false).open(&lock_path) { std::result::Result::Ok(file) => file, std::result::Result::Err(error) => { eprintln!("cannot create application lock '{}': {error}", lock_path.display()); diff --git a/crates/ksp-app-config-desk/src/tauri.rs b/crates/ksp-app-config-desk/src/tauri.rs index 99b933e..67fb512 100644 --- a/crates/ksp-app-config-desk/src/tauri.rs +++ b/crates/ksp-app-config-desk/src/tauri.rs @@ -1,5 +1,5 @@ // file: crates/ksp-app-config-desk/src/tauri.rs -// version: 1 +// version: 2 //! Tauri runtime assembly for the KSP configuration desktop application. @@ -9,6 +9,7 @@ use tauri::Manager; // rust-rules: trait-import #[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run(_arguments: &[std::ffi::OsString]) -> ksp_core_lib::Result<()> { let mut builder = tauri::Builder::default(); + builder = configure_plugins(builder); builder = configure_setup(builder); let run_result = builder.run(tauri::generate_context!()); return match run_result { @@ -20,6 +21,11 @@ pub fn run(_arguments: &[std::ffi::OsString]) -> ksp_core_lib::Result<()> { }; } +fn configure_plugins(builder: tauri::Builder) -> tauri::Builder { + let tracing_plugin = tauri_plugin_tracing::Builder::new().build::(); + return builder.plugin(tracing_plugin); +} + fn configure_setup(builder: tauri::Builder) -> tauri::Builder { return builder.setup(|app| { if app.get_webview_window("splash").is_none() { diff --git a/crates/ksp-app-config-desk/tsconfig.json b/crates/ksp-app-config-desk/tsconfig.json new file mode 100644 index 0000000..a08dd8c --- /dev/null +++ b/crates/ksp-app-config-desk/tsconfig.json @@ -0,0 +1,31 @@ +{ + "compilerOptions": { + "target": "ES2022", + "useDefineForClassFields": true, + "module": "ESNext", + "lib": [ + "ES2022", + "DOM", + "DOM.Iterable" + ], + "skipLibCheck": true, + "moduleResolution": "bundler", + "allowImportingTsExtensions": true, + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "strict": true, + "noUnusedLocals": true, + "noUnusedParameters": true, + "noFallthroughCasesInSwitch": true, + "allowSyntheticDefaultImports": true, + "types": [ + "vite/client", + "node" + ] + }, + "include": [ + "frontend", + "vite.config.ts" + ] +} \ No newline at end of file diff --git a/crates/ksp-app-config-desk/vite.config.ts b/crates/ksp-app-config-desk/vite.config.ts new file mode 100644 index 0000000..0892cd8 --- /dev/null +++ b/crates/ksp-app-config-desk/vite.config.ts @@ -0,0 +1,73 @@ +// file: crates/ksp-app-config-desk/vite.config.ts +// version: 1 + +import { NodePackageImporter } from "sass-embedded"; +import { fileURLToPath } from "node:url"; +import { resolve } from "node:path"; +import { defineConfig, normalizePath } from "vite"; + +const appRoot = fileURLToPath(new URL(".", import.meta.url)); +const frontendRoot = normalizePath(resolve(appRoot, "frontend")); +const frontendDist = normalizePath(resolve(appRoot, "../../builds/khadhroony-solana-project/ksp-app-config-desk/dist")); +const devHost = process.env.TAURI_DEV_HOST; + +export default defineConfig({ + clearScreen: false, + root: frontendRoot, + publicDir: false, + input: { + main: normalizePath(resolve(frontendRoot, "main.html")), + splash: normalizePath(resolve(frontendRoot, "splash.html")), + }, + build: { + outDir: frontendDist, + emptyOutDir: true, + minify: true, + sourcemap: false, + cssCodeSplit: true, + rolldownOptions: { + output: { + entryFileNames: "js/[name]-[hash].js", + chunkFileNames: "js/chunks/[name]-[hash].js", + assetFileNames: assetInfo => { + const originalName = assetInfo.names[0] ?? ""; + const extension = originalName.substring(originalName.lastIndexOf(".") + 1).toLowerCase(); + if (extension === "css") { + return "css/[name]-[hash][extname]"; + } + if (["eot", "otf", "ttf", "woff", "woff2"].includes(extension)) { + return "fonts/[name]-[hash][extname]"; + } + if (["png", "jpg", "jpeg", "gif", "svg", "webp", "ico"].includes(extension)) { + return "imgs/[name][extname]"; + } + return "otherassets/[name][extname]"; + }, + }, + }, + }, + css: { + preprocessorOptions: { + scss: { + quietDeps: true, + silenceDeprecations: ["import", "color-functions", "global-builtin"], + verbose: false, + api: "modern", + importers: [new NodePackageImporter()], + }, + }, + }, + server: { + port: 1430, + strictPort: true, + host: devHost || false, + ws: { + protocol: "ws", + host: devHost || "localhost", + port: 1431, + }, + watch: { + ignored: ["**/src/**"], + }, + }, +}); diff --git a/deltas/0.1.4/pre.005.md b/deltas/0.1.4/pre.005.md new file mode 100644 index 0000000..ebb5f5a --- /dev/null +++ b/deltas/0.1.4/pre.005.md @@ -0,0 +1,348 @@ + + + +# Delta 0.1.4-pre.005 — gabarit frontend Vite/TypeScript/SCSS et tracing Tauri + +## Base requise + +```text +0.1.4-pre.004-fix.001 +workspace.package.version = "0.1.4-pre.4.fix.1" +``` + +`pre.004-fix.001` est considéré comme validé et commité. Les validations locales fournies avant cette tranche ont réussi : `cargo fmt --all`, `cargo check --workspace`, `cargo clippy --workspace --all-targets`, `cargo test -p ksp-app-config-desk` et `cargo tree -p ksp-app-config-desk`. + +## Objectif + +Rendre le squelette Tauri créé en `pre.004` réellement équipé de son gabarit frontend sans encore ouvrir les surfaces métier Config. + +Cette tranche introduit : + +- `package.json` ; +- `vite.config.ts` et `tsconfig.json` ; +- `frontend/main.html` et `frontend/splash.html` ; +- TypeScript minimal pour les deux fenêtres ; +- SCSS/Bootstrap/Font Awesome ; +- SimpleBar et `resize-observer-polyfill` ; +- les assets visuels de référence issus du gabarit bot3 ; +- `tauri-plugin-tracing` côté Rust ; +- `@fltsci/tauri-plugin-tracing` côté frontend ; +- la permission Tauri `tracing:default` ; +- Vite HTTP strict sur `1430` et WebSocket de développement sur `1431` ; +- la destination de build frontend externe demandée. + +`AppState`, Config, Logging, le bridge `frontend_log.ts` KSP et le lifecycle splash configurable restent hors scope de cette tranche. + +## Version Cargo + +`workspace.package.version` passe de : + +```text +0.1.4-pre.4.fix.1 +``` + +à : + +```text +0.1.4-pre.5 +``` + +L'identifiant documentaire de livraison est : + +```text +0.1.4-pre.005 +``` + +## 1. Dépendance Rust tracing Tauri + +Le workspace ajoute : + +```toml +tauri-plugin-tracing = { version = "^0.3" } +``` + +La version actuelle auditée est `0.3.4`. + +`ksp-app-config-desk` consomme la dépendance avec : + +```toml +tauri-plugin-tracing.workspace = true +``` + +`tauri.rs` conserve un builder progressif : + +```text +Builder::default + -> configure_plugins + -> configure_setup + -> run +``` + +`configure_plugins()` construit le plugin avec `tauri_plugin_tracing::Builder::new()` puis l'ajoute au builder. Aucun `with_default_subscriber()` n'est appelé : cette tranche ne crée donc pas de second runtime tracing et ne prend pas l'ownership réservé à `ksp-logging-lib`. + +`tauri-plugin-log` n'est pas ajouté. + +## 2. Capability tracing + +`capabilities/default.json` contient désormais : + +```text +core:default +tracing:default +``` + +La permission tracing entre dans le même delta que le plugin, conformément à la décision prise après `pre.004`. + +## 3. Dépendances frontend + +Les générations actuelles ont été revérifiées avant rédaction du manifest : + +| Dépendance | Version actuelle auditée | Contrainte déclarée | +| ---------------------------------- | -----------------------: | ------------------: | +| `@fltsci/tauri-plugin-tracing` | `0.3.4` | `^0.3` | +| `@fortawesome/fontawesome-free` | `7.3.1` | `^7.3` | +| `@tauri-apps/api` | `2.11.1` | `^2.11` | +| `@types/node` | `26.1.2` | `^26.1` | +| `bootstrap` | `5.3.8` | `^5.3` | +| `resize-observer-polyfill` | `1.5.1` | `^1.5` | +| `sass-embedded` | `1.102.0` | `^1.102` | +| `simplebar` | `6.3.3` | `^6.3` | +| `typescript` | `7.0.2` | `^7.0` | +| `vite` | `8.2.0` | `^8.2` | + +Ces dépendances sont placées sous `devDependencies`, conformément à l'usage `npm i -D` retenu pour les applications desk : elles participent au build du bundle desktop et ne constituent pas un runtime Node déployé séparément. + +`@tauri-apps/cli` n'est pas ajouté : le workflow retenu utilise la CLI Cargo/Tauri et npm uniquement pour la gestion des dépendances et pour les scripts internes appelés par Tauri. + +Le lockfile npm reste ignoré. + +## 4. Politique npm + +`package.json` ne fournit que les scripts utilisés par Tauri : + +```text +dev -> vite +build -> tsc && vite build +``` + +Première installation après application du delta : + +```bash +cd crates/ksp-app-config-desk +npm i -D +``` + +Le cycle normal reste ensuite : + +```bash +cargo tauri dev +``` + +ou le build Tauri correspondant. Il n'est pas demandé de lancer directement `npm run dev` ou `npm run build` dans le workflow utilisateur. + +L'environnement de préparation a tenté l'installation npm afin de vérifier le workflow, mais l'accès registry du sandbox a expiré avant téléchargement. Aucun `node_modules` ni `package-lock.json` n'est livré. Les versions ci-dessus ont donc été vérifiées depuis les registres/sources officielles, et l'installation effective doit être faite sur le poste de développement. + +## 5. Vite 8 actualisé + +Le gabarit bot3 utilisait encore `build.rollupOptions` et la configuration historique `server.hmr`. Avec Vite 8, le nouveau gabarit utilise : + +```text +build.rolldownOptions +server.ws +``` + +afin de ne pas introduire dès la première application KSP des options désormais dépréciées. + +Le serveur est configuré ainsi : + +| Usage | Port | Politique | +| ------------------------ | ---: | --------- | +| Vite HTTP | 1430 | strict | +| WebSocket dev/HMR | 1431 | dédié | + +`strictPort = true` interdit le basculement silencieux du serveur HTTP vers un autre port. + +## 6. Destination frontend hors workspace source + +`tauri.conf.json` possédait déjà : + +```text +../../builds/khadhroony-solana-project/ksp-app-config-desk/dist +``` + +`vite.config.ts` part maintenant de la racine de la crate puis résout **le même chemin contractuel** : + +```text +../../builds/khadhroony-solana-project/ksp-app-config-desk/dist +``` + +Le `root` Vite reste `frontend/`, mais l'utilisation d'un path absolu résolu depuis la crate évite que `build.outDir` ne soit accidentellement interprété relativement à `frontend/`. + +Cette disposition place le `dist` à côté de la hiérarchie d'artefacts Rust définie par `.cargo/config.toml`, et non dans le workspace source. + +## 7. Layout frontend + +Le gabarit concret est : + +```text +frontend/ +├── imgs/ +│ ├── logo.png +│ └── splash.png +├── sass/ +│ ├── _app.scss +│ ├── _bootswatch.scss +│ ├── _fontawesome.scss +│ ├── _simplebar.scss +│ ├── _variables.scss +│ ├── main.scss +│ └── splash.scss +├── ts/ +│ ├── main.ts +│ └── splash.ts +├── main.html +└── splash.html +``` + +Les assets, le thème Pulse, les bases SimpleBar, le splash et l'iconographie reprennent/refondent le gabarit audité de khadhroony-bot3. + +Le shell `main` ne charge aucun `README.md` et aucun `PRESENTATION.md` n'est créé. + +## 8. SimpleBar et resize observer + +Le frontend importe : + +```text +resize-observer-polyfill +simplebar +``` + +et installe le `ResizeObserver` de compatibilité sur `window` avant l'utilisation effective du shell scrollable. + +La zone principale utilise `data-simplebar`, ce qui conserve le scrolling visuel du gabarit au lieu de retomber sur la scrollbar WebKitGTK native. + +## 9. TypeScript et API Tauri + +`main.ts` et `splash.ts` utilisent `getCurrentWindow()` depuis `@tauri-apps/api/window` afin de valider que les scripts sont bien exécutés dans leur fenêtre Tauri respective. + +Aucune commande métier n'est encore invoquée. + +Les futurs bindings TS-RS restent destinés à : + +```text +frontend/ts/bindings/ksp_app_config_desk/... +``` + +`ts-rs` n'est toujours pas ajouté artificiellement : il entrera en `pre.006` avec les premiers DTO réels de bootstrap/state. + +## 10. Frontend tracing : intégration sans faux contrat KSP + +Le package officiel associé `@fltsci/tauri-plugin-tracing` est présent avec le plugin Rust, mais cette tranche n'appelle pas encore directement ses helpers `trace/debug/info/...` comme façade applicative KSP. + +Cette décision évite de faire du target vide actuellement utilisé par le bridge générique un contrat de routage KSP. La tranche `pre.007` introduira le bridge `frontend_log.ts` repris/refondu depuis bot3 avec : + +- targets KSP whitelistés ; +- commande centralisée dans `tauri.rs` ; +- émission finale via `ksp-logging-lib` ; +- intégration des fonctionnalités console du plugin uniquement lorsqu'elles restent compatibles avec cette ownership. + +## 11. Splash/main à ce stade + +Les deux pages sont maintenant bundlables. + +La fenêtre `splash` reste la fenêtre visible au démarrage et `main` reste initialement invisible comme déclaré depuis `pre.004`. Cette tranche **ne code pas une temporisation splash temporaire** uniquement pour montrer `main` : le lifecycle réel et configurable reste réservé à `pre.008`. + +Le premier `cargo tauri dev` doit donc au minimum prouver : + +- lancement du serveur Vite sur `1430` ; +- WebSocket de développement réservé `1431` ; +- chargement de `splash.html` dans la WebView ; +- styles/assets visibles ; +- absence d'erreur de capability pour le plugin tracing. + +## 12. Fichiers modifiés + +| Fichier | Version précédente | Nouvelle version | +| -------------------------------------------------------------- | ------------------: | ---------------: | +| `Cargo.toml` | 66 | 67 | +| `crates/ksp-app-config-desk/Cargo.toml` | 1 | 2 | +| `crates/ksp-app-config-desk/src/tauri.rs` | 1 | 2 | +| `crates/ksp-app-config-desk/capabilities/default.json` | n/a | n/a | +| `crates/ksp-app-config-desk/README.md` | 1 | 2 | +| `crates/ksp-app-config-desk/USAGE.md` | 1 | 2 | +| `crates/ksp-app-config-desk/TODO.md` | 1 | 2 | + +## 13. Fichiers ajoutés + +```text +crates/ksp-app-config-desk/package.json +crates/ksp-app-config-desk/tsconfig.json +crates/ksp-app-config-desk/vite.config.ts +crates/ksp-app-config-desk/frontend/main.html +crates/ksp-app-config-desk/frontend/splash.html +crates/ksp-app-config-desk/frontend/ts/main.ts +crates/ksp-app-config-desk/frontend/ts/splash.ts +crates/ksp-app-config-desk/frontend/sass/_app.scss +crates/ksp-app-config-desk/frontend/sass/_bootswatch.scss +crates/ksp-app-config-desk/frontend/sass/_fontawesome.scss +crates/ksp-app-config-desk/frontend/sass/_simplebar.scss +crates/ksp-app-config-desk/frontend/sass/_variables.scss +crates/ksp-app-config-desk/frontend/sass/main.scss +crates/ksp-app-config-desk/frontend/sass/splash.scss +crates/ksp-app-config-desk/frontend/imgs/logo.png +crates/ksp-app-config-desk/frontend/imgs/splash.png +deltas/0.1.4/pre.005.md +``` + +## 14. Fichiers supprimés + +Aucun. + +## 15. Contrôles exécutés pendant la préparation + +- comparaison du scope avec `pre.004-fix.001` ; +- parsing TOML du workspace et de la crate ; +- parsing JSON de `package.json`, `tsconfig.json`, `tauri.conf.json` et de la capability ; +- vérification de `workspace.package.version = "0.1.4-pre.5"` ; +- vérification de l'absence de `tauri-plugin-log` ; +- vérification de `tracing:default` dans la capability ; +- vérification de `1430` strict et `1431` dédié dans Vite ; +- vérification que le `frontendDist` Tauri et le `frontendDist` résolu par Vite désignent le même répertoire physique ; +- vérification des headers `file:` / `version:` sur les nouveaux fichiers texte KSP concernés ; +- vérification de la limite 160 colonnes sur le Rust modifié ; +- tentative de `npm i -D`, interrompue par timeout réseau du sandbox avant installation. + +Le sandbox de préparation ne fournit pas Cargo. L'installation npm effective et les validations runtime sont donc à exécuter localement. + +## 16. Validation locale demandée + +Après application du delta : + +```bash +cd crates/ksp-app-config-desk +npm i -D +cd ../.. + +cargo fmt --all +cargo check --workspace +cargo clippy --workspace --all-targets +cargo test -p ksp-app-config-desk +cargo test -p ksp-config-lib +cargo tree -p ksp-app-config-desk +cargo tauri dev -p ksp-app-config-desk +``` + +Si la syntaxe locale de la CLI Tauri installée ne prend pas `-p`, lancer la commande depuis `crates/ksp-app-config-desk` avec la forme habituelle du poste de développement. Le point important est que Tauri, et non une commande `npm run dev` lancée manuellement, pilote le serveur frontend. + +À l'écran, le splash doit charger le visuel KSP et afficher son statut frontend. Le passage automatique vers `main` n'est pas encore attendu avant `pre.008`. + +## 17. Suite + +Après validation/commit de `pre.005`, `pre.006` introduira le bootstrap backend et `AppState` : + +- arguments -> `ConfigBootstrapOptions` / registre / management ; +- première utilisation réelle de `ksp-config-lib` ; +- initialisation de `ksp-logging-lib` ; +- ownership durable de `LoggingGuard` ; +- fallback sûr si Logging Config est invalide ; +- premiers DTO applicatifs et bindings TS-RS réels.