# Delta `0.2.12-pre.002-fix.001` — alignement strict du gabarit desktop commun ## 1. Base requise Ce correctif s'applique exclusivement après : ```text v0.2.11 + 0.2.12-pre.001 + 0.2.12-pre.001-fix.001 + 0.2.12-pre.002 ``` La base opérateur fournie contient déjà plusieurs corrections locales du scaffold `pre.002`; elles sont conservées et servent de source réelle à ce fix. ## 2. Motif du correctif Le scaffold initial était fonctionnel mais encore trop dérivé au lieu d'être une reprise stricte du gabarit desktop KSP. `KSP-APP-008/009/015/019/023/027/028` imposent que Config Desk reste la référence et que les Desks suivants réutilisent les conventions stabilisées sauf justification explicite. L'opérateur avait déjà corrigé plusieurs écarts avant ce delta : ```text @fltsci/tauri-plugin-tracing ajouté à package.json resize-observer-polyfill ajouté à package.json footer commun rétabli dans main.html DOS_Amazigh.ttf rétabli pour le splash splash.scss réaligné sur la police commune ``` Le présent fix poursuit cet alignement au lieu d'écraser ces corrections. ## 3. Version technique Le fix modifie Rust, TypeScript, HTML, SCSS et configuration Tauri réellement consommés au runtime. Conformément à `VER-ID-007/010`, le signal Cargo devient : ```text workspace.package.version = 0.2.12-pre.2.fix.1 ``` Le nouveau Desk synchronise également son `package.json` et son `tauri.conf.json` sur `0.2.12-pre.2.fix.1`. ## 4. Commandes et conventions backend réalignées Le wrapper Tauri temporaire : ```text runtime_status ``` devient : ```text get_runtime_status ``` Il reprend ainsi la convention déjà utilisée par Wallet Desk (`get_runtime_status`) et reste cohérent avec Config Desk (`get_logging_runtime_status`). La méthode interne `AppState::runtime_status` reste inchangée : seul le nom de commande IPC exposé suit le gabarit `get_*`. `configure_commands()` adopte la même présentation progressive que les Desks existants. `configure_setup()` émet désormais l'événement shell via `TRACING_DOMAIN_SHELL`, ce qui supprime les deux warnings `unused import` / `dead_code` observés par l'opérateur sans supprimer une convention déjà utilisée dans Wallet Desk. ## 5. Frontend commun réellement repris `frontend/ts/main.ts` réutilise désormais les invariants du template Config/Wallet : ```text ResizeObserver importé depuis resize-observer-polyfill window.ResizeObserver installé avant le shell SimpleBar getCurrentWindow().label lu au bootstrap navigation installée via helper dédié loadRuntimeStatus() dédié commande get_runtime_status startup data load protégé par try/catch + warning sûr ``` Le package `resize-observer-polyfill` n'est donc plus seulement déclaré : il est réellement consommé par le bundle. Le badge de version propre au scaffold est retiré du header. Comme dans Config/Wallet Desk, le header garde l'identité fonctionnelle et le titre de vue ; la version reste visible dans Diagnostics via le DTO runtime. ## 6. HTML/SASS et splash Le shell réutilise le vocabulaire de classes déjà stabilisé dans Wallet Desk : ```text app-runtime-list app-placeholder app-placeholder i ``` `_app.scss` reprend le socle partagé dans le même ordre et ne conserve que les différences réellement applicatives. Les partials communs suivants restent byte-equivalents hors headers `file/version` avec Config Desk et Wallet Desk : ```text _bootswatch.scss _fontawesome.scss _simplebar.scss _variables.scss main.scss splash.scss ``` Le splash est réaligné sur la forme de titre commune : ```text KSP SOL Prices Desk — Chargement ``` Le fichier `frontend/fonts/README.md` est ajouté pour tracer la même police `DOS_Amazigh.ttf` et la même empreinte SHA-256 que les deux Desks existants. ## 7. Canari anti-dérive du gabarit `tests/desktop_contract.rs` ajoute un canari durable qui vérifie : - dépendances frontend communes présentes ; - consommation réelle de `resize-observer-polyfill` ; - bootstrap via `getCurrentWindow()` ; - commande `get_runtime_status` ; - footer et classes shell communes ; - présence du manifest de font ; - bytes `DOS_Amazigh.ttf` identiques dans les trois Desks ; - corps des six partials SCSS communs identiques entre Config, Wallet et SOL Prices Desk. Le canari ne demande pas que les styles métier `_app.scss` soient identiques : seuls le socle et le vocabulaire du template doivent rester communs, les sélecteurs spécifiques à chaque application restant légitimes. ## 8. Scope fonctionnel inchangé Le fix n'ajoute aucun : ```text MarketPriceService ResolvedOffchainTransportConfig composite cfg.composite.ksp-app-solprices-desk provider DTO refresh row/many/all table prix DataTables plugin dialog/fs/http/shell frontend ``` `pre.003` reste propriétaire du composite Config et du bootstrap Off-chain. ## 9. Retour opérateur acquis sur la base avant fix L'opérateur a exécuté sur `0.2.12-pre.2` : ```text npm i -D PASS / 0 vulnerability cargo fmt --all PASS cargo test -p ksp-app-solprices-desk PASS / 12 unit + 7 integration/public tests cargo tauri dev PASS lancement Vite 1434 + binaire Tauri ``` Les seuls diagnostics Rust visibles étaient : ```text unused import TRACING_DOMAIN_SHELL constant TRACING_DOMAIN_SHELL is never used ``` Ce fix corrige précisément ces warnings en conservant le domaine shell et en l'utilisant comme Wallet Desk. ## 10. Fichiers modifiés ```text Cargo.toml crates/ksp-app-solprices-desk/package.json crates/ksp-app-solprices-desk/tauri.conf.json crates/ksp-app-solprices-desk/frontend/main.html crates/ksp-app-solprices-desk/frontend/splash.html crates/ksp-app-solprices-desk/frontend/sass/_app.scss crates/ksp-app-solprices-desk/frontend/ts/main.ts crates/ksp-app-solprices-desk/src/tauri.rs crates/ksp-app-solprices-desk/tests/desktop_contract.rs docs/plans/019-V0_2_12_SOL_PRICES_DESK_PLAN.md docs/validation/015-V0_2_12_SOL_PRICES_DESK.md ``` ## 11. Fichier ajouté ```text crates/ksp-app-solprices-desk/frontend/fonts/README.md deltas/0.2.12/pre.002-fix.001.md ``` ## 12. Fichiers volontairement inchangés ```text crates/ksp-app-config-desk/** crates/ksp-app-wallet-desk/** deltas/0.2.12/pre.002.md ROADMAP.md CHANGELOG.md prompts/017-V0_2_12_START_PROMPT.md config/** ``` Les deux Desks stables restent la référence ; le correctif réaligne le nouveau Desk sur leur socle commun au lieu de modifier rétroactivement leurs surfaces métier. ## 13. Gate opérateur attendu Après application : ```bash cargo fmt --all python3 scripts/audit_rust_workspace_rules.py python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.2.12 cargo check --workspace cargo clippy --workspace --all-targets cargo test -p ksp-app-solprices-desk cargo test --workspace (cd crates/ksp-app-solprices-desk && cargo tauri dev) ``` Le `cargo tauri dev` doit confirmer le splash/font/footer/styles, Vite `1434/1435`, l'absence de warnings `TRACING_DOMAIN_SHELL` et le chargement de Diagnostics via `get_runtime_status`. Aucun `cargo tauri build` final n'est exigé par ce fix intermédiaire ; les builds de production restent dans le couloir final prévu par le plan.