121 lines
4.3 KiB
Markdown
121 lines
4.3 KiB
Markdown
<!-- file: deltas/0.1.4/pre.008-fix.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# `0.1.4-pre.008-fix.001` — Contextes splash numériques et réexports de labels inutiles
|
|
|
|
## 1. Motif du fix
|
|
|
|
`pre.008` a introduit le lifecycle réel `splash -> main`, les modules `tw_splash` / `tw_main` et la validation des timings du splash, mais la première validation locale a révélé deux défauts Rust bloquants ou bruyants :
|
|
|
|
- `Error::with_context()` reçoit deux bornes numériques (`u64` et `u32`) alors que son contrat exige une valeur convertible en `String`, ce qui provoque deux erreurs `E0277` dans `splash.rs` ;
|
|
- `lib.rs` réexporte `WINDOW_LABEL_MAIN` et `WINDOW_LABEL_SPLASH` alors que ces constantes ne sont utilisées qu'à l'intérieur de leurs modules propriétaires, ce qui provoque deux warnings `unused_imports`.
|
|
|
|
Le correctif ne modifie ni la séquence fonctionnelle du splash, ni les labels de fenêtres, ni les contrats frontend introduits en `pre.008`.
|
|
|
|
## 2. Version technique
|
|
|
|
Le fix touche du Rust compilé. Le signal Cargo devient :
|
|
|
|
```text
|
|
workspace.package.version = "0.1.4-pre.8.fix.1"
|
|
```
|
|
|
|
La version applicative frontend/Tauri reste `0.1.4` selon la politique KSP actuelle.
|
|
|
|
## 3. Contextes d'erreur numériques
|
|
|
|
Le contrat Core est :
|
|
|
|
```rust
|
|
pub fn with_context(mut self, key: &'static str, value: impl Into<String>) -> Self
|
|
```
|
|
|
|
Les bornes applicatives du splash ne peuvent donc pas être passées directement comme entiers.
|
|
|
|
Les deux branches deviennent explicitement :
|
|
|
|
```rust
|
|
.with_context("maximum_ms", maximum.to_string())
|
|
```
|
|
|
|
Cela concerne :
|
|
|
|
- `parse_u64_setting()` pour `KSP_DESK_SPLASH_MINIMUM_MS` ;
|
|
- `parse_u32_setting()` pour `KSP_DESK_SPLASH_FADE_MS`.
|
|
|
|
Aucune modification de `ksp-core-lib::Error` n'est nécessaire : la représentation textuelle du contexte reste le contrat commun voulu par Core.
|
|
|
|
## 4. Ownership des labels de fenêtre
|
|
|
|
L'audit des usages confirme :
|
|
|
|
```text
|
|
tw_main::WINDOW_LABEL_MAIN
|
|
-> utilisé uniquement dans tw_main.rs
|
|
|
|
tw_splash::WINDOW_LABEL_SPLASH
|
|
-> utilisé uniquement dans tw_splash.rs
|
|
```
|
|
|
|
Les deux lignes suivantes sont donc supprimées de `lib.rs` :
|
|
|
|
```rust
|
|
pub(crate) use self::tw_main::WINDOW_LABEL_MAIN;
|
|
pub(crate) use self::tw_splash::WINDOW_LABEL_SPLASH;
|
|
```
|
|
|
|
Il serait artificiel de modifier `tw_main.rs` / `tw_splash.rs` pour consommer `crate::WINDOW_LABEL_*` uniquement afin de rendre ces réexports utilisés. Chaque module conserve légitimement la propriété et l'usage direct de son label.
|
|
|
|
Les réexports réellement utilisés restent inchangés :
|
|
|
|
```rust
|
|
pub(crate) use self::tw_main::show_and_focus as show_main_window;
|
|
pub(crate) use self::tw_splash::frontend_ready as splash_frontend_ready_service;
|
|
```
|
|
|
|
## 5. Test renforcé
|
|
|
|
Le test unitaire `splash_duration_parser_rejects_invalid_or_unbounded_values` couvre désormais explicitement les deux types de bornes :
|
|
|
|
```text
|
|
u64 -> maximum_ms = "60000"
|
|
u32 -> maximum_ms = "10000"
|
|
```
|
|
|
|
Il vérifie que les erreurs bornées conservent bien ces valeurs dans `Error::context()` sous forme textuelle.
|
|
|
|
## 6. Fichiers modifiés
|
|
|
|
| Fichier | Action |
|
|
| ------------------------------------------------------ | ------: |
|
|
| `Cargo.toml` | modifié |
|
|
| `crates/ksp-app-config-desk/src/lib.rs` | modifié |
|
|
| `crates/ksp-app-config-desk/src/splash.rs` | modifié |
|
|
| `crates/ksp-app-config-desk/unit_tests/splash.rs` | modifié |
|
|
| `deltas/0.1.4/pre.008-fix.001.md` | ajouté |
|
|
|
|
## 7. Validations demandées
|
|
|
|
Depuis la racine du workspace :
|
|
|
|
```bash
|
|
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 -c crates/ksp-app-config-desk/tauri.conf.json
|
|
```
|
|
|
|
Les validations doivent confirmer :
|
|
|
|
- disparition des deux erreurs `E0277` sur `maximum_ms` ;
|
|
- absence des warnings `unused import` pour `WINDOW_LABEL_MAIN` / `WINDOW_LABEL_SPLASH` ;
|
|
- maintien des tests du lifecycle splash ;
|
|
- transition réelle `splash -> main` toujours fonctionnelle.
|
|
|
|
## 8. Suite
|
|
|
|
Après validation de ce fix, la suite reste celle de `pre.008` : `pre.009` doit introduire la surface Documents + diagnostics sans réouvrir le lifecycle de fenêtres, sauf défaut runtime découvert pendant la validation desktop.
|