Files
khadhroony-solana-project/deltas/0.1.4/pre.006-fix.001.md
2026-08-16 12:21:28 +02:00

134 lines
4.8 KiB
Markdown

<!-- file: deltas/0.1.4/pre.006-fix.001.md -->
<!-- version: 1 -->
# `0.1.4-pre.006-fix.001` — Police du splash et configuration Sass Vite 8
## 1. Motif du fix
`pre.006` a correctement introduit le bootstrap Config/Logging, `AppState`, le premier contrat TS-RS et l'inventaire de la police historique du splash, mais deux détails frontend doivent être corrigés avant `pre.007` :
- `frontend/sass/splash.scss` documentait implicitement la future utilisation de `DOS_Amazigh.ttf` sans encore déclarer la police ni l'appliquer au titre ;
- `vite.config.ts` conservait `api: "modern"` dans `css.preprocessorOptions.scss`, option qui n'appartient plus au contrat Sass exposé par Vite 8 et que les types TypeScript refusent.
Le correctif ne modifie pas le périmètre fonctionnel du bootstrap `pre.006`.
## 2. Base validée
La base `0.1.4-pre.6` a été validée localement avec :
```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
```
Le lancement desktop a confirmé Vite sur `1430` puis le démarrage du binaire Tauri. Le fallback Logging de réparation a également été observé lorsque la configuration Logging gérée n'était pas disponible.
## 3. Version technique
Le fix touche du SCSS et la configuration frontend réellement consommée par Vite. Le signal Cargo devient donc :
```text
workspace.package.version = "0.1.4-pre.6.fix.1"
```
La version applicative frontend/Tauri reste `0.1.4` selon la politique KSP actuelle.
## 4. Police `Dos Amazigh` réellement activée
`frontend/sass/splash.scss` reprend désormais le contrat de police du gabarit bot3 :
```scss
@font-face {
font-family: "Dos Amazigh";
src: url("../fonts/DOS_Amazigh.ttf") format("truetype");
font-weight: normal;
font-style: normal;
font-display: swap;
}
```
Le titre du splash utilise explicitement :
```scss
#app-name {
font-family: "Dos Amazigh", sans-serif;
}
```
La géométrie, les transitions et le lifecycle final du splash restent volontairement réservés à `pre.008`.
Le fichier binaire `DOS_Amazigh.ttf` n'est pas ajouté par ce delta : l'opérateur l'a déjà repris localement depuis le gabarit bot3 sous :
```text
crates/ksp-app-config-desk/frontend/fonts/DOS_Amazigh.ttf
```
Le manifeste `frontend/fonts/README.md` reste la référence de provenance et d'empreinte.
## 5. Sass/Vite 8
Vite 7 a supprimé le support de l'ancienne API Sass et impose désormais l'API moderne. En conséquence, l'ancien sélecteur explicite :
```ts
api: "modern",
```
n'est plus nécessaire et n'est plus accepté par les types actuels de `SassPreprocessorOptions`.
`vite.config.ts` le supprime simplement. Les options utiles restent présentes :
```text
quietDeps
silenceDeprecations
verbose
NodePackageImporter
```
Aucun retour vers une API Sass legacy n'est introduit.
## 6. Documentation synchronisée
`README.md`, `USAGE.md`, `TODO.md` et le manifeste `frontend/fonts/README.md` ne présentent plus l'activation de `Dos Amazigh` comme une tâche future : la police du titre est maintenant active, tandis que seul le lifecycle/fini visuel reste dans la tranche splash dédiée.
## 7. Fichiers modifiés
| Fichier | Action |
|--------------------------------------------------------|--------:|
| `Cargo.toml` | modifié |
| `crates/ksp-app-config-desk/frontend/sass/splash.scss` | modifié |
| `crates/ksp-app-config-desk/vite.config.ts` | modifié |
| `crates/ksp-app-config-desk/frontend/fonts/README.md` | modifié |
| `crates/ksp-app-config-desk/README.md` | modifié |
| `crates/ksp-app-config-desk/USAGE.md` | modifié |
| `crates/ksp-app-config-desk/TODO.md` | modifié |
| `deltas/0.1.4/pre.006-fix.001.md` | ajouté |
## 8. 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 tauri dev -c crates/ksp-app-config-desk/tauri.conf.json
```
Le test desktop doit confirmer :
- absence de l'erreur TypeScript `SassPreprocessorOptions` sur `api` ;
- compilation SCSS avec `DOS_Amazigh.ttf` présent sous `frontend/fonts/` ;
- rendu du titre `KSP` avec `Dos Amazigh` ;
- maintien du lancement Vite/Tauri et du bootstrap backend introduit en `pre.006`.
## 9. Suite
Après validation de ce fix, la tranche suivante reste `pre.007` : bridge `frontend_log.ts` refondu depuis bot3, commande `emit_frontend_log` centralisée dans `tauri.rs`, targets KSP contrôlés et émission finale exclusivement via `ksp-logging-lib`.