diff --git a/.csharpierignore b/.csharpierignore deleted file mode 100644 index 1d688b3..0000000 --- a/.csharpierignore +++ /dev/null @@ -1,9 +0,0 @@ -bin/ -obj/ -build/ -src/terminal/clink-profile/ -*.csproj -*.xaml -*.props -*.targets -*.xml diff --git a/.csharpierrc.json b/.csharpierrc.json deleted file mode 100644 index 13ce24b..0000000 --- a/.csharpierrc.json +++ /dev/null @@ -1 +0,0 @@ -{"printWidth": 120} diff --git a/.editorconfig b/.editorconfig index f71df3c..987fe28 100644 --- a/.editorconfig +++ b/.editorconfig @@ -1,33 +1,31 @@ -# EditorConfig: https://editorconfig.org -# Line endings are deliberately not set: the index stores LF, and Windows checkouts may convert (core.autocrlf). root = true [*] charset = utf-8 -insert_final_newline = true -trim_trailing_whitespace = true -# Advisory only: many existing files exceed it. -max_line_length = 120 - -[*.md] -trim_trailing_whitespace = false - -[*.{cs,py,ps1,qml,cpp,h}] +end_of_line = lf indent_style = space indent_size = 4 +max_line_length = 140 -[*.{csproj,props,targets,xml,xaml,json,yml,yaml,iss}] +[*.cs] indent_style = space -indent_size = 2 +indent_size = 4 +max_line_length = 140 +csharp_new_line_before_open_brace = all +csharp_new_line_before_else = true +csharp_new_line_before_catch = true +csharp_new_line_before_finally = true +csharp_new_line_before_members_in_object_initializers = true +csharp_new_line_before_members_in_anonymous_types = true +csharp_new_line_between_query_expression_clauses = true +csharp_preserve_single_line_statements = false +csharp_preserve_single_line_blocks = false +csharp_space_around_binary_operators = before_and_after +csharp_indent_case_contents = true +csharp_indent_switch_labels = true -# C# analyzers: suggestions only, nothing here may break a build. -[*.cs] -dotnet_analyzer_diagnostic.severity = suggestion -dotnet_style_qualification_for_field = false:suggestion -csharp_style_var_elsewhere = true:suggestion -dotnet_analyzer_diagnostic.category-Reliability.severity = suggestion -dotnet_diagnostic.CA2000.severity = suggestion -dotnet_diagnostic.CA1816.severity = suggestion -dotnet_diagnostic.CA2012.severity = suggestion -dotnet_diagnostic.CA2016.severity = suggestion -dotnet_diagnostic.CA1849.severity = suggestion +[*.{py,pyi}] +indent_size = 4 + +[*.qml] +indent_size = 4 diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..0c3799b --- /dev/null +++ b/.gitattributes @@ -0,0 +1,14 @@ +* text=auto +*.cs text eol=lf +*.qml text eol=lf +*.py text eol=lf +*.ps1 text eol=lf +*.json text eol=lf +*.md text eol=lf +*.cmd text eol=crlf +*.bat text eol=crlf +*.iss text eol=crlf +*.ico binary +*.png binary +*.dll binary +*.exe binary diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml deleted file mode 100644 index 0933b55..0000000 --- a/.github/workflows/build.yml +++ /dev/null @@ -1,38 +0,0 @@ -name: build - -on: - push: - branches: [main] - pull_request: - -jobs: - build: - runs-on: windows-latest - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-dotnet@v4 - with: - dotnet-version: 10.0.x - - uses: ilammy/msvc-dev-cmd@v1 - with: - arch: x64 - - name: Build native components - shell: pwsh - run: ./tools/build-native.ps1 - - name: Build src projects - shell: pwsh - run: | - foreach ($p in 'src/backend/Panneaux.Glass.csproj','src/files/Winlestia.Files.csproj','src/cli/winlestia.csproj') { - dotnet build $p -c Release --nologo - if ($LASTEXITCODE -ne 0) { throw "Build failed: $p" } - } - - name: Run pure-logic tests - shell: pwsh - run: | - $tests = 'AppCatalogueWatch','AppNameNormalizer','AtomicFile','AudioBars','AutostartPolicy','BrightnessPolicy','CliCommands','DesktopReassert','FileSearch','FilesHandler','FilesPinMigration','FilesPreloadPolicy','FramePolicy','MediaIdentity','SecurityHardening','SocialPolicy','StoreRecovery','StringsTable','WifiPolicy' - $failed = @() - foreach ($t in $tests) { - dotnet run --project "tests/$t/$t.csproj" -c Release --nologo - if ($LASTEXITCODE -ne 0) { $failed += $t } - } - if ($failed.Count -gt 0) { throw "Failed: $($failed -join ', ')" } diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..ed80bb5 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,165 @@ +name: CI + +on: + push: + pull_request: + +jobs: + # Style : longueur de ligne (.editorconfig, 140) et espaces blancs. Les fins de ligne sont verifiees telles que + # commitees : autocrlf est donc desactive avant le checkout. + lint: + runs-on: windows-latest + steps: + - name: Checkout sans conversion de fins de ligne + shell: pwsh + run: git config --global core.autocrlf false + - uses: actions/checkout@v4 + - uses: actions/setup-dotnet@v4 + with: + dotnet-version: 8.0.x + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + + - name: Longueur de ligne (140) + shell: pwsh + run: | + python tools/check_line_length.py + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + + - name: dotnet format whitespace + shell: pwsh + run: | + foreach ($p in 'src/backend/Panneaux.Glass.csproj', 'src/files/Winlestia.Files.csproj', 'src/cli/winlestia.csproj') { + dotnet format whitespace $p --verify-no-changes + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + } + + build-and-test: + runs-on: windows-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-dotnet@v4 + with: + dotnet-version: 8.0.x + + - uses: ilammy/msvc-dev-cmd@v1 + with: + arch: x64 + + # Composants natifs MSVC (ProcessAudio.dll...) compilés AVANT .NET : le csproj copie ProcessAudio.dll dans la sortie. + - name: Composants natifs + shell: pwsh + run: ./tools/build-native.ps1 + + - name: Build + shell: pwsh + run: | + foreach ($p in 'src/backend/Panneaux.Glass.csproj', 'src/files/Winlestia.Files.csproj', 'src/cli/winlestia.csproj') { + dotnet restore $p --locked-mode + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + dotnet build $p -c Release --no-restore + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + } + + # Tests xUnit (tests/Winlestia.Tests). La categorie Desktop (Audio, Explorateur, icones de dossiers, tiling, + # bureaux virtuels, interop native, plein ecran) touche au bureau : elle reste locale. + - name: Tests .NET (avec couverture) + shell: pwsh + run: | + dotnet restore tests/Winlestia.Tests --locked-mode + dotnet test tests/Winlestia.Tests -c Release --no-restore --filter "Category!=Desktop" ` + --collect:"XPlat Code Coverage" --settings tests/coverage.runsettings --results-directory TestResults + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + + # Resume de couverture + plancher. Valeur mesuree le 2026-11-09 : 17,61 % des lignes (backend compile dans les tests, + # beaucoup de code WPF/shell non testable sans bureau). Plancher = valeur arrondie a l'entier inferieur ; a relever + # quand la couverture monte. + - name: Resume de couverture + shell: pwsh + run: | + $floor = 17 + $file = Get-ChildItem TestResults -Recurse -Filter coverage.cobertura.xml | Select-Object -First 1 + if (-not $file) { throw 'coverage.cobertura.xml introuvable.' } + $root = ([xml](Get-Content $file.FullName -Raw)).coverage + $pct = [math]::Round([double]$root.'line-rate' * 100, 2) + $line = "Couverture des lignes : $pct % ($($root.'lines-covered')/$($root.'lines-valid')), plancher $floor %" + Write-Host $line + Add-Content $env:GITHUB_STEP_SUMMARY "### Couverture`n$line" + if ($pct -lt $floor) { throw "Couverture sous le plancher ($pct < $floor)." } + + - uses: actions/upload-artifact@v4 + with: + name: coverage + path: TestResults/**/coverage.cobertura.xml + + # Verifications statiques sans execution : syntaxe des scripts PowerShell (installateur, outils) et compilation Python. + - name: Syntaxe PowerShell (installer, tests) + shell: pwsh + run: | + $bad = 0 + foreach ($f in Get-ChildItem installer, tests/FilesHarness -Recurse -Filter *.ps1) { + $errors = $null + [void][System.Management.Automation.Language.Parser]::ParseFile($f.FullName, [ref]$null, [ref]$errors) + foreach ($e in $errors) { Write-Host "$($f.FullName): $($e.Message)"; $bad++ } + } + if ($bad -gt 0) { exit 1 } + + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + + - name: Tests Python + shell: pwsh + run: | + python -m pip install -r src/frontend/requirements.txt pytest jsonschema + pytest -q + + - name: Compilation Python (compileall) + shell: pwsh + run: | + python -m compileall -q src/frontend src/terminal tools tests conftest.py + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + + # Test de fumee de l'installateur : fabrique le setup avec installer/build.ps1 -CI (composants natifs MSVC compiles + # par tools/build-native.ps1). L'artefact prouve que la chaine payload + Inno Setup passe ; + # il n'est jamais une release. + installer-smoke: + needs: build-and-test + runs-on: windows-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-dotnet@v4 + with: + dotnet-version: 8.0.x + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + + - uses: ilammy/msvc-dev-cmd@v1 + with: + arch: x64 + + - name: Composants natifs + shell: pwsh + run: ./tools/build-native.ps1 + + - name: Inno Setup 6 + shell: pwsh + run: | + $iscc = "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe" + if (-not (Test-Path $iscc)) { + choco install innosetup --no-progress -y + if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE } + } + if (-not (Test-Path $iscc)) { throw 'ISCC.exe introuvable apres installation.' } + + - name: Fabrication du setup + shell: pwsh + run: ./installer/build.ps1 -CI + + - uses: actions/upload-artifact@v4 + with: + name: winlestia-setup-smoke + path: build/out/Winlestia-Setup-*.exe + if-no-files-found: error diff --git a/.gitignore b/.gitignore index 025cab7..fcb3695 100644 --- a/.gitignore +++ b/.gitignore @@ -40,14 +40,9 @@ catalog-workspace* # Sorties de build de vérification buildverify-*/ clink_errorlevel_*.txt - -# Artefacts generated by the verification/benchmark switches and by dotnet build (outputs, never inputs) -src/backend/performance-*.json -src/backend/verification*.json -src/backend/audio-mixer-verification.json -src/backend/motion-*.json -src/backend/preuve-secours.json -src/backend/taskbar-state.json -src/backend/taskbar-session.json -src/backend/Panneaux.Glass.deps.json -src/backend/Panneaux.Glass.runtimeconfig.json +.freebuff/ +buildverify-fullscreen/ +TestResults/ +*.bak-* +src/frontend/trace-open +!docs/winjets/examples/*.zip diff --git a/CHANGELOG.md b/CHANGELOG.md index cbe8260..ab729b9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,31 +1,124 @@ # Changelog -Earlier releases are described in `docs/RELEASE-*.md`. Release notes for each version are also published on the GitHub Releases page. +Format inspiré de [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/). Les notes de chaque version sont aussi publiées sur la page GitHub Releases. Les entrées 0.9.0 et antérieures sont conservées dans la langue où elles ont été écrites. -## 0.9.1 - 2026-11-04 +## 1.0.0 — 2026-11-18 -Changes since 0.9.0. +Première version stable, après la 0.9.2. L'installateur n'est pas signé : SmartScreen affiche un avertissement. Choisir « Informations complémentaires » puis « Exécuter quand même » (vérifier le SHA-256 publié avec la version). -### Fixed +### Nouveautés -- **Media panel and visualiser** (#1): readable browser names, track information re-read on change, playback position advances while the dashboard is visible, visualiser follows the playing browser and its child processes. -- **Social rail** (#2): the dashboard moves aside by the width the rail covers and scales its panes. On a very small screen width the rail can still overlay it. The dashboard reopens on the last tab used (session only). -- **User data** is written atomically; a corrupt preferences file is kept as `.corrupt.bak` and settings are restored from `.bak`. -- Bookmarks only open `http` and `https` addresses. +- Winjets : widgets de bureau décrits par un paquet JSON (format `winjet/1`), placés derrière les fenêtres, sans exécution de code de paquet ; import depuis Réglages > Winjets. +- Dix Winjets inclus, qui remplacent le pack PC Widgets : Calendrier, Horloge, Lecteur, Système, Marchés (Yahoo Finance), Stockage, Fichiers, Notes, Agenda (lien ICS) et Météo ; la Batterie reste incluse. +- Winjets : verre « liquid glass v2 » (remplissage fumé, reflet, liseré diagonal, flou selon la taille de la carte). +- Winjets : curseur de transparence par widget, édition par double-clic avec grille et aimantation (Alt pour désactiver). +- Format `winjet/1` étendu : blocs `media`, `visualizer` et `note`, sources `market` et `calendar`, flux `system.*`, `weather.*` et `files.*`, actions `media.*`, `open`, `openDrive` et `locate`. +- Documentation créateur : `docs/winjets/FORMAT-v1.md`, `docs/winjets/MON-PREMIER-WINJET.md`, schémas JSON, gabarit et exemple. +- Centre de contrôle redessiné : pages Wi-Fi, Bluetooth, sortie audio et microphones dans le panneau, mélangeur par application, connexion et déconnexion d'un appareil Bluetooth appairé. +- Dock : largeur qui suit le nombre d'icônes, avec défilement à la molette au-delà de l'écran. +- Dock : indicateur de batterie des périphériques (Bluetooth et XInput), désactivé par défaut (`peripheralBattery`). +- Dock : disposition barre ou tiroir (`dockLayout`) et bascules rapides Wi-Fi, Bluetooth, mode avion, micro et maintien éveillé (`quickToggle`). +- Vue d'ensemble (Win+Alt+Tab, ou Win+Alt+V) : vignettes en direct des fenêtres ouvertes, navigation au clavier, filtre par lettres. +- Pilule en haut de l'écran : lecture en cours avec spectre, changement de piste, volume, luminosité et micro ; réglage « Pilule ». +- Paroles synchronisées du morceau en cours (lrclib.net, cache local), réglage « Paroles ». +- Écran de verrouillage (Ctrl+Alt+L) : mot de passe PBKDF2, verrouillage après inactivité, touches système bloquées. +- Dictée vocale par appui (maintenir AltGr), désactivée par défaut. +- Fenêtre « Applications » du dock : liste en direct avec processeur et mémoire, arrêt en deux clics. +- Rail social (bord droit) : notifications de Discord, Instagram, Snapchat, WhatsApp et Telegram ; historique séparé par jour, ligne retirable, fusion des lignes « N nouveaux messages ». +- Température du processeur via un service de capteurs administrateur facultatif (pilote PawnIO). +- Menu d'alimentation : entrée « Désinstaller Winlestia », avec choix de garder ou d'envoyer à la Corbeille les réglages ; script de repli `installer/Uninstall-Winlestia.ps1`. -### Changed +### Améliorations + +- Palette de commandes : ouverture plus rapide (y compris la première après le démarrage), onde de choc à l'ouverture (réglage `shockwave`), Ctrl+F2 la referme. +- Ouverture des panneaux plus rapide ; première ouverture du Centre de contrôle moins saccadée. +- Fonds d'écran : révélation en cercle, puis glissement des couleurs du shell vers la nouvelle palette. +- Winjets : déplacement et redimensionnement plus fluides, position écrite une seule fois au relâchement. +- Winlestia Fichiers : gestionnaire de fichiers redessiné. +- « Effets allégés » devient « Mode léger » ; « Barre Windows » et « Quitter Winlestia » passent dans le menu d'alimentation. +- Le panneau « Commandes rapides » devient « Centre de contrôle ». +- Dépendances Python verrouillées par hachage (`--require-hashes`) ; intégration continue complétée (longueur de ligne, `dotnet format`, test de fumée de l'installateur). +- Hôte PC Widgets externe retiré ; Espace de travail (Workspace) retiré ; historique du portage condensé dans `docs/history/caelestia-windows.md`. + +### Corrections + +- Docks : une fenêtre « toujours visible » d'une autre application ne reste plus coincée entre le fond en verre du dock et ses icônes ; outil de diagnostic `tools/zorder_probe.py`. +- Dock : les épingles des applications du Microsoft Store (MSIX) sont enregistrées par AUMID et survivent aux mises à jour et aux redémarrages ; les épingles existantes sont migrées. +- Météo : la ville n'est plus Londres par défaut ; sans ville, la position Windows est utilisée. +- Winlestia Fichiers : plantage au démarrage corrigé (`System.IO.Pipelines 10.0` introuvable) ; un plantage ne rouvre plus d'Explorateur vide. +- Gestionnaire de dossiers : le verbe n'est plus ré-enregistré au démarrage tant qu'un plantage de Fichiers n'a pas été effacé. +- Winjets : couleurs de la barre d'édition, de la grille et des poignées issues de la palette. + +### Installation + +- Nouvel installeur WPF `WinlestiaSetup.exe` (fr, en, es, de) : choix des fonctions, mise à jour, modification et désinstallation ; modes `--dry-run` et `--screenshots`. Construction : `installer/build-setup.ps1`. `Winlestia.iss` est conservé. +- Désinstallation propre : la barre des tâches est rétablie avant tout, les réglages et données sont gardés ou envoyés à la Corbeille au choix. +- Binaires non signés : SmartScreen avertit. « Informations complémentaires » puis « Exécuter quand même ». + +## [0.9.2] - 2026-11-06 + +### Ajouts + +- Éditeur de palette dans les réglages (couleurs personnalisées). +- Page « Raccourcis clavier » : liste de tous les raccourcis globaux ; les raccourcis configurables peuvent être réaffectés (combinaisons réservées par Windows ou en conflit refusées avec explication, changement échoué annulé). Les raccourcis fixes indiquent la raison. +- Win+Alt+S ouvre les Réglages (réaffectable). Autres accès : menu de la zone de notification, `winlestia panel settings`. +- Icônes dans le dock pour les applications empaquetées. +- Mise à jour en direct du catalogue d'applications. +- Dock, panneau des signets et panneau social masquables séparément. Masquer le dock quand il remplace la barre des tâches rend la barre Windows. -- All projects target .NET 10; the installer stays self-contained. -- Interface text moved to `Views/Strings.cs` (French, English, Spanish; Spanish partial, English fallback). Language order: `Caelestia/language.json`, system culture, English. -- Code quality: no line over 500 characters, backend split into 12 namespaces, formatters and analyzers added, generated artefacts untracked. +### Modifications -### Installer +- Réglages redessinés en huit pages (Apparence, Interface, Docks et panneaux, Raccourcis clavier, Média et audio, Apps/signets/liens, Fichiers et Windows, Général), avec recherche et colonne de navigation. Textes traduits en anglais et en espagnol. +- Le terminal suit le mode du thème (clair ou sombre). +- Gestionnaire de fichiers redessiné. +- « Ajouter un site web » retiré. +- L'instantané des réglages contient le dossier de données et la version. +- `WINLESTIA_DATA_DIR` est aussi pris en compte par le frontend (langue, météo, miniatures, journaux) et par le cache et les lancements récents du backend. +- L'installateur vérifie l'empreinte du Python téléchargé. -- The setup wizard is in English by default and detects the Windows display language (French and Spanish kept). -- The Caelestia licence and notices are installed with the application. -- Still not code-signed; code signing is being looked into. +### Corrections -## 0.9.0 - 2026-10-31 +- Dictée vocale : Whisper.net revient sur .NET 8. +- Flèches affichées comme des cases vides dans la liste des raccourcis de mosaïque. +- Un raccourci non enregistré au démarrage était signalé « inchangé » ; l'enregistrement est retenté et le résultat réel affiché. +- Un raccourci Réglages identique à une autre combinaison est remplacé au chargement par la première libre parmi Win+Alt+S, Ctrl+Alt+F10, Ctrl+Alt+F11. +- Dock, signets et panneau social n'étaient plus masqués avant l'arrivée du premier instantané des réglages. + +### Interne + +- Source unique de la version : `Directory.Build.props`. +- CI : build, tests xUnit et pytest. +- Tests regroupés dans `tests/Winlestia.Tests` (xUnit) et pytest. +- Blocs `catch` vides classés : helper `Safe` et journalisation. +- Auto-tests du gestionnaire de fichiers exclus des builds Release. +- Logique pure du bail de barre des tâches extraite (`TaskbarLeasePolicy`) et testée (bail, repli « toujours visible », décision du gardien). +- Tests xUnit ajoutés (calculatrice, maths de couleur et palettes, options de lancement, mode silencieux, trame du tube de Fichiers, validation de cibles) ; helper `TempDir` à la place des nettoyages `catch { }`. +- CI : couverture coverlet avec résumé et plancher, syntaxe PowerShell de l'installateur, `compileall` Python. +- L'installateur refuse de se compiler sans `AppVersion` (plus de version par défaut codée en dur). +- Plans et journaux d'avancement terminés retirés de `docs/` (le texte de la release reste dans `docs/release-notes-0.9.2.md`, qui résume ce qui précède sans le reprendre). +- Code reformaté (`.editorconfig`, dotnet format, ruff, qmlformat), sans changement de comportement. +- Backend découpé en dossiers ; `frontend.py` découpé. +- Dépendances épinglées (fichiers de verrouillage, `global.json`). + +## [0.9.1] - 2026-11-04 + +### Corrections + +- Panneau média et visualiseur (#1) : navigateurs affichés sous un nom lisible, informations de piste relues au changement, position de lecture mise à jour tant que le tableau de bord est visible, visualiseur calé sur le navigateur qui joue (processus enfants compris). +- Rail social (#2) : le tableau de bord se décale de la largeur couverte par le rail et adapte ses volets ; sur une très petite largeur logique, le surplus passe par-dessus. +- Le tableau de bord rouvre sur le dernier onglet utilisé (durée de la session). +- Données utilisateur écrites de façon atomique (préférences, historique du presse-papiers, compteurs sociaux, éléments récents, bail de la barre des tâches, exclusions de la mosaïque, fichiers d'apparence d'Explorer, langue, fonds masqués, ville météo). +- Préférences : un fichier corrompu est conservé en `.corrupt.bak` et les réglages sont restaurés depuis `.bak` ; les valeurs par défaut ne servent que si les deux échouent. Une erreur de lecture transitoire est retentée une fois. +- Les signets n'ouvrent que des adresses `http` et `https`. Le XML de la tâche est écrit dans un dossier privé. + +### Modifications + +- Installateur en anglais par défaut, avec détection de la langue d'affichage de Windows ; français et espagnol conservés. +- Licence et notices de Caelestia installées avec l'application. +- Projet passé à .NET 10. +- Qualité du code : aucune ligne de plus de 500 caractères ; backend réparti en 12 espaces de noms ; textes français retirés du code (chaînes d'interface dans `Views/Strings.cs` en français, anglais et espagnol, journaux en anglais) ; normaliseur de noms d'applications à table de règles ordonnée ; CSharpier et ruff format ; `.editorconfig` et analyseurs ajoutés. + +## [0.9.0] - 2026-10-31 Changes since 0.8.0. @@ -73,3 +166,189 @@ Changes since 0.8.0. - Upgrading no longer aborts while the shell is running. - The dashboard now shows the display name chosen at install (it used to show the Windows account name). - Interface strings completed in English and Spanish; the dashboard calendar follows the app language. + +### Known limitations + +- The installer wizard is in French only. +- English and Spanish are translated for the shell panels; some rarer system-derived labels may still appear in French. The language follows the Windows display language and can be forced with the `language` key (`auto`/`fr`/`en`/`es`) in `%LOCALAPPDATA%\Panneaux\Caelestia\language.json`. Fallback text is French. +- Not tested on a clean machine or VM, nor after a real reboot or sign-in (the scheduled-task launch was tested manually). +- Binaries are **not signed**, so SmartScreen may warn. +- Windows 11 x64 only. Temperature is in Celsius only. +- There is **no notification centre**: only the on-screen indicator and toasts. Windows notifications can be switched off from the tools panel. +- Window preview quality in the dock depends on what each application exposes to Windows. +- Weather: with no city set, your approximate location comes from your IP address through wttr.in; the forecast comes from Open-Meteo. Temperature is in °C only. +- Bundled wallpapers: the 10 images were supplied by the maintainer and are not covered by the GPL-3.0 licence; rights remain with their owners (see `assets/wallpapers/CREDITS.txt`). A rights holder can ask for removal through a GitHub issue. +- Automatic tiling is **off by default**. +- Tested on a real Windows 11 Home machine with a single 3440x1440 display, not on a clean virtual machine. Other display layouts, scalings and Windows editions have had less testing. +- Enterprise (802.1X) and hidden Wi-Fi networks are not handled in the Wi-Fi panel. +- The optional terminal integration prints a welcome banner in French, showing your session and computer names. +- When you confirm a wallpaper in the switcher, the previous wallpaper can flash briefly before the new one appears. +- The wallpaper switcher also lists images from `Pictures\Wallpapers`, `Pictures` and the Windows wallpaper folders, not only the bundled set. +- CPU temperature can show N/A, depending on the hardware. + +### What was tested + +Tested by hand and by script on one Windows 11 Home machine (single 3440x1440 display), with the installer built from a clean checkout: + +| Check | Result | +| --- | --- | +| Install, first start, dock replaces the taskbar | Pass | +| Upgrade from 0.8.0 with the shell running | Pass | +| Main panels open (settings, clipboard, tools, audio, mixer, capture, palette, dashboard) | Pass | +| Theme change and wallpaper-driven palette | Pass | +| Global shortcuts Ctrl+F1, Ctrl+F2, Ctrl+Alt+Space, Ctrl+Alt+W | Pass | +| Autostart task created, launched manually with the shell closed | Pass | +| Taskbar restored after normal close, after a killed process, and by `--restore-taskbar` and Ctrl+Alt+Backspace | Pass | +| Uninstall with the shell running (user profile and wallpaper kept) | Pass | +| Clean machine or VM; real reboot and sign-in | Not run | +| Other display layouts and scalings | Not run | + +These tests ran from an MSIX-packaged parent process, which redirects `%LOCALAPPDATA%` writes for its child processes; autostart was exercised from Task Scheduler, outside that redirection. + +## 0.8.0 - 2026-10-29 + +Nouveautés : panneaux social et favoris, palette automatique, page « Tout ton espace », gains de performance. Correctifs : onglets des Préférences défilants, badge WhatsApp, température CPU, masquage du dock, icône Ethernet, icône Fichiers dans le dock, aperçu des fenêtres au survol. Détail : page GitHub Releases (v0.8.0). + +## 0.7.6 - date non relevée + +- Réorganisation automatique animée sur 240 ms avec ralentissement progressif. Le minuteur d’animation s’arrête au repos ; aucun hook de souris permanent. Une manipulation, une réduction ou un agrandissement interrompt le mouvement concerné. +- Arrondis des fenêtres agrandies alignés sur leur surface visible DWM. Le découpage est réappliqué si une application le réinitialise, puis restauré au retour en fenêtre. Les vidéos et jeux en plein écran réel restent exclus. +- Logo du Bureau agrandi (116 px au lieu de 76 px, transparence et clics traversants conservés). +- Organisation automatique désactivée par défaut pour les nouvelles préférences. Les choix déjà enregistrés sont conservés. + +Validation : tests natifs sur dix fenêtres dédiées (ouverture, réduction, restauration, fermeture, agrandissement, retour aux positions originales), partitions sur coordonnées négatives, réparation d’une région effacée par l’application, tests QML du logo et des interactions, 32 tests Python. Compilation autonome et installeur reconstruits. + +Limites : le rendu des transitions dépend de la vitesse de redessin des applications. Les fenêtres protégées ou exécutées avec des privilèges supérieurs peuvent refuser un déplacement ou un découpage ; aucun résultat universel n’est garanti. + +## 0.7.5 - date non relevée (organisation automatique du bureau) + +### Mosaïque +Les fenetres redimensionnables se repartissent automatiquement dans la zone de travail de chaque moniteur, avec espacement et ordre stables. L'ouverture, la fermeture, la reduction et la restauration recalculent les emplacements. La disposition est activee par defaut ; un interrupteur dans Personnaliser > Bureau permet de la desactiver. + +Le double-clic sur la barre de titre conserve l'agrandissement Windows. Tant qu'une fenetre geree est agrandie, sa disposition est preservee ; le bouton Restaurer permet de reprendre la mosaique. Une nouvelle application peut reouvrir la disposition partagee. Les jeux et videos qui couvrent vraiment un moniteur sont exclus du placement. + +Les positions d'origine sont memorisees et restaurees a la desactivation ou a la fermeture normale pour les fenetres encore a leur emplacement gere. Les deplacements manuels, les fenetres reduites ou agrandies ne sont pas annules de force. Les boites de dialogue, outils flottants, fenetres fixes, bureaux virtuels masques et interfaces Winlestia sont exclus. + +### Logo +Logo fourni affiche en blanc discret dans le coin superieur gauche de chaque ecran. Option Logo Winlestia, desactivee par defaut. Fond transparent, aucun clic intercepte, opacite attenuee suivant le verre. Masque en plein ecran et pendant les captures/pipette. + +### Fluidite et limites +Detection legere toutes les 700 ms, sans hook souris global. Les placements qui ne changent pas ne sont pas reappliques ; un glisser-deposer en cours n'est pas interrompu. Les fenetres soumises a une taille minimale ne sont pas redimensionnees en boucle. + +Le nombre gere simultanement est borne selon la taille du moniteur, jusqu'a 16 fenetres recentes par ecran. Les applications imposant de grandes tailles minimales ou un niveau d'administration superieur peuvent refuser un placement ; une organisation parfaite de toutes les applications Windows ne peut pas etre garantie. La restauration en cas de terminaison forcee du processus n'est pas garantie. + +### Verification +Fixture native isolee : 3, 4 puis 10 vraies fenetres sans chevauchement, agrandir/restaurer, reduire/restaurer, fermer/reorganiser et restauration des positions initiales. Partitionnement de 1 a 16 cases avec coordonnees negatives. 30 cycles stables moyens sous 25 ms sur la machine de test ; ce n'est pas une mesure du PC du collegue. + +Tests QML : logo visible, transparent aux clics et masque en plein ecran ; regressions grille et menus, plein ecran et DPI mixtes. Editeur de palette/raccourcis et 32 tests Python de regression passes. Aucun autre logiciel du bureau n'a ete deplace par la fixture : sa source ne contient que les fenetres de test. + +## 0.7.0 - date non relevée (theme personnalise) + +Quatrieme theme Personnalise, en plus de Porcelaine, Nuit et Automatique. Le studio reprend les cartes, arrondis et typographie du panneau Personnaliser. + +- Cinq couleurs : fond, texte, principal, secondaire et troisieme accent. Les surfaces, contours et couleurs de contraste des boutons sont derives de ces roles. Palette initiale inspiree de Porcelaine. +- Roue HSV avec luminosite, saisie hexadecimale #RRGGBB et apercu avant application. +- Pipette d'ecran : interface masquee pendant l'echantillonnage d'un pixel ; clic intercepte temporairement sur un fil Windows dedie, sans hook permanent ni enregistrement d'image. Echap ou clic droit annule. Le hook est retire a la fin et a la fermeture. +- Verre optionnel : desactive, le fond choisi est opaque et le curseur disparait ; active, un curseur regle sa transparence. Le cadre, le dashboard et le dock utilisent les memes roles et le meme materiau. +- Couleurs et transparence personnalisees sauvegardees. Annuler l'editeur ne sauvegarde pas le brouillon. Le theme Automatique conserve son propre reglage de verre. +- Les terminaux reprennent la palette personnalisee ; Windows Terminal adapte aussi son opacite et son effet acrylique. Le mode allege conserve son comportement pour les configurations modestes. + +Tests : palette et validation hexadecimale, roue/editeur QML sans erreur, modes opaque/verre, selection et annulation d'un pixel deterministe, persistance native des cinq roles et du verre, 32 regressions Python, import du service terminal et cycle de vie reel du hook temporaire dans le runtime embarque. Capture du studio inspectee. Les couleurs visibles peuvent dependre de la gestion HDR du bureau ; le rendu sur le second PC reste a tester. + +## 0.6.5.2 - date non relevée + +### Personnaliser +Refonte inspiree des composants, arrondis et couleurs de Caelestia : https://github.com/caelestia-dots/shell . Trois cartes Apparence / Bureau / Au quotidien, apercus de themes, interrupteurs, langues compactes et hierarchie typographique. Le selecteur d'animations est retire. La detection superieure dispose d'un bouton Calibrer unique ; aucun curseur redondant dans les parametres. + +### Applications +Les onglets En cours / Arriere-plan utilisent une grille d'icones avec noms au survol. Clic gauche ou droit ouvre les actions. Les fermetures et arrets avec confirmation reviennent a la grille, dans le meme onglet, sans fermer le panneau. Retour et Echap restent disponibles. Le clic exterieur ferme le panneau ; aucun hook souris global n'est ajoute. + +### Plein ecran +Le dock devient une capsule flottante complete quand son ecran accueille un vrai plein ecran. Le dessin, le verre et le masque de clic utilisent la meme forme detachee. Le cadre reste masque lorsque le dock ou son menu prend le focus. + +La detection utilise les coordonnees physiques et le nom du moniteur Windows, sans multiplication des origines Qt par un facteur DPI. Une video plein ecran peut etre reconnue meme si le navigateur conserve son etat maximise. Une fenetre simplement maximisee avec barre de titre reste distincte. Le clip arrondi impose aux fenetres maximisees est retire lorsque leur client couvre le moniteur entier ; retour a l'arrondi a la sortie. + +### Verification +32 tests Python de geometrie/recherche ; tests QML dans le runtime embarque : grille, clic droit, confirmation, maintien du panneau, clic exterieur, bouton de calibration, cadre masque, capsule et cas de DPI melanges simule ; fixture native : arrondis/restauration, epingles, recents. Aucune erreur QML sur ces parcours. Une capture du nouveau panneau a ete inspectee. + +Le cas Firefox/Chrome du second PC reste a retester sur cette machine ; les tests locaux et simules ne couvrent pas toutes les versions de pilotes ou tous les lecteurs video. Les terminaux ne sont pas modifies par cette version. + +## 0.6.5.1 - date non relevée + +- Reparation de l'installation du theme PowerShell : Set-ExecutionPolicy pouvait modifier CurrentUser puis signaler ExecutionPolicyOverride a cause de la politique du processus du setup. Le helper verifie maintenant la valeur relue et accepte uniquement une modification effectivement reussie. Les restrictions de groupe restent respectees. +- Le theme CMD/PowerShell est inclus automatiquement, y compris lors d'une mise a jour ayant conserve une ancienne liste de taches. +- Synchronisation initiale de la palette avant le lancement du worker ; arret de l'ancien worker enregistre ; mutex propre au dossier d'installation. Les fichiers de couleurs sont publies meme si Windows Terminal n'a pas encore de configuration. +- Windows Terminal nouvellement initialise : ajout du schema Winlestia manquant et activation de son apparence. Les editions Preview sont aussi detectees. Le CMD classique utilise les couleurs RVB du theme ; Windows Terminal conserve ses couleurs indexees adaptatives. +- Ctrl+F2 : extraction des icones des applications et fichiers/dossiers recents, et demande de chargement des la creation des lignes. +- Echecs d'installation : stderr du helper est conserve dans install-result.json pour un diagnostic exploitable. + +### Verification + +PowerShell 5.1 interactif dans un vrai pseudo-terminal : logo ASCII, panneau systeme et prompt affiches, couleur rouge RVB verifiee, fermeture propre. Test reproduisant ExecutionPolicyOverride avec changement applique, puis restauration de la valeur precedente. Tests de palettes rouge/bleue et de configuration Terminal neuve ; test d'import du worker avec le Python embarque ; installation/reinstallation/restauration isolees ; regressions QML sans erreur. + +Le rendu du fond transparent exige un hote compatible tel que Windows Terminal. Une strategie d'entreprise interdisant les profils non signes doit etre geree par son administrateur. Le PC du collegue reste a retester ; les tests locaux ne constituent pas une verification sur cette machine. + +## 0.6.5 - date non relevée (correctifs et audit) + +### Correctifs +- Raccourcis : fenetre independante, panneau principal masque, combinaison affichee pendant la saisie, validation backend, fermeture automatique uniquement apres succes et libelle synchronise. Echap annule. +- Langues : quatre cartes graphiques Windows/France/Royaume-Uni/Espagne, assets SVG locaux, selection persistante. +- Icones Workspace : demandes a la demande avec coalescence et nouvelles tentatives ; les images vectorielles de secours sont aussi rendues pour Qt ; encodage PNG hors du fil de saisie. +- Recents : applications observees au premier plan et raccourcis Windows Recent sont fusionnes par horodatage UTC ; dernier acces conserve, ordre decroissant, historique local borne. La collecte commence avec Winlestia et ne reconstitue pas un historique Windows absent ou desactive. +- Terminal : installation du profil accompagnee de RemoteSigned pour le compte courant lorsque necessaire, ancienne valeur sauvegardee puis restauree a la desinstallation. CMD lance son helper avec une politique limitee au processus. Les strategies imposees par une organisation restent prioritaires et sont signalees. Les settings Windows Terminal avec commentaires/virgules finales sont acceptes. +- Mise a jour/desinstallation : fermeture propre, puis nettoyage des seuls processus frontend/theme du dossier installe. Suppression du taskkill global par nom : les autres installations et applications Python restent intactes. + +### Audit des performances +Defauts identifies : enumeration de tous les processus sur le dispatcher du dock ; icones demandees uniquement pour les favoris/dock ; encodeur d'images sur le dispatcher ; arret force du backend pouvant laisser son frontend orphelin ; listes recentes concatenees sans tri commun. + +Corrections : inventaire des processus uniquement a l'ouverture du panneau dedie, sur une tache de fond ; un seul worker STA pour les recents, cache des liens et file bornee ; pas de Shell COM dans les requetes d'etat ; ecriture des icones en arriere-plan ; nettoyage du cycle de vie. + +Mode allege automatique jusqu'a 8 Gio de memoire disponible pour le runtime, reglable dans Personnalisation : flou natif desactive, transparence conservee, sondes materielles moins frequentes. Le test sur le PC du collegue reste necessaire : aucune mesure sur cette machine n'est disponible et aucune garantie de fluidite universelle n'est annoncee. + +### Verifications +- 32 tests Python de geometrie, recherche et palettes. +- QML du runtime embarque : popup seul, touche Ctrl+K capturee, succes simule, retour aux parametres/libelle, demandes d'icones coalescees, quatre cartes de langue ; aucune erreur QML. +- Fixture native : arrondis/restauration, ordre des epingles, recents mixtes tries et dedupliques. +- Capture audio : FFT variable et isolation du processus validees avec signal de test. +- Installation terminal isolee : profils, chemins portables, CMD AutoRun, reinstal idempotente, restauration, JSON avec commentaires ; banner reel lance sous environnement Restricted avec son option de processus. +- Nettoyage reel sur deux processus factices : seul le processus du dossier choisi est arrete. + +Les dialogues secondaires herites ne sont pas tous traduits. L'estimation de ville reste reseau/IP. Les tests automatises ne remplacent pas une ouverture de session Windows ni l'essai sur la petite configuration. + +Reference des politiques PowerShell : https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies/ + +## 0.6.0 - date non relevée + +La numerotation passe de 9.5.0 a 0.6.0 ; le setup accepte la mise a jour avec le meme identifiant. + +- Spectre FFT dynamique a 48 bandes : capture WASAPI du processus du lecteur et de ses enfants, sans repli sur le son global. Analyse en memoire, aucun enregistrement. Test reel avec signal sinusoidal et processus exclu reussi. +- Menu alimentation : cartes avec icones, confirmation, position au-dessus du dock. +- Fluidite : retrait du hook souris global de fermeture des panneaux, remplacement par detection des transitions de boutons ; suppression des abonnements globaux bruyants aux changements de position/etat ; cadence du mixeur reduite. Le ralentissement du PC du collegue reste a confirmer sur cette machine, sa cause exacte n'est pas prouvee. +- Langues : detection de la langue d'affichage Windows (FR/EN/ES, anglais sinon), choix manuel persistant dans Personnalisation et premier catalogue de traduction de l'interface principale. Certains libelles secondaires et dialogues Windows/herites restent dans leur langue initiale ; la couverture n'est pas encore exhaustive. +- Meteo : en absence de ville manuelle, estimation de ville par adresse IP (wttr.in), puis meteo Open-Meteo. Ce n'est pas une localisation GPS ; VPN/reseau peuvent affecter la ville. +- Ctrl+F2 : raccourcis recents du dossier Windows Recent en tete ; applications observees au premier plan depuis le lancement sont aussi prises en compte. Les historiques Windows desactives/proteges ne sont pas contournes. +- Calibration : bouton Calibrer dans Personnalisation, panneau principal masque, reglage isole et ligne rouge non interactive sur l'ecran. Valider avec la coche ; Echap annule. + +Tests : 32 tests Python ; runtime QML/menus sans erreur ; FFT/isolation native ; choix/persistance des langues et ordre recent d'abord. Le PC du collegue et une vraie ouverture de session restent a tester. + +Implementation WASAPI : https://learn.microsoft.com/en-us/samples/microsoft/windows-classic-samples/applicationloopbackaudio-sample/ + +## 9.5.0 - date non relevée + +- L'installateur embarque le theme CMD/PowerShell et propose son installation. Profils interactifs, ASCII Winlestia, Clink, couleurs, verre Windows Terminal et adaptation au fond d'ecran. Les reglages existants sont sauvegardes. Les sessions elevees du meme compte utilisent les memes profils. +- Media : bouton volume cible a la place du bouton de deplacement ; pochette tournante pendant la lecture, angle conserve en pause. +- Le visualiseur utilise le niveau des sessions audio du lecteur selectionne, sans repli sur la sortie globale. C'est un indicateur d'amplitude, pas une analyse FFT par frequence. Le volume d'un navigateur concerne ses sessions, pas un onglet individuel. +- Dock : separation des groupes epingles/ouverts, deplacement des epingles par glissement, largeur reglable au bord droit et centrage conserve. +- Applications : onglets en cours/arriere-plan ; executables accessibles de la session, groupes par chemin. Les processus proteges ou inaccessibles ne sont pas listes. +- Alimentation : veille, redemarrage et arret avec confirmation. +- Reglages : hauteur de detection du bord superieur de 0 a 160 pixels, persistante. +- Fenetres maximisees : decoupe arrondie dans la zone de travail ; region precedente restauree au retour en mode normal ou a la fermeture du shell. Les pleins ecrans exclusifs restent geres par leur application. +- Curseurs : protection des valeurs choisies contre les retours d'etat anciens pendant les commandes audio et luminosite. +- Mise a jour : conservation du catalogue et des preferences backend ; correctif Explorer 9.4 conserve. + +### Verification + +32 tests Python ; chargement QML et menus avec etat de test ; protection contre etat obsolete ; installation/restauration terminal dans un environnement isole ; fixture native pour arrondis et ordre des epingles ; verification Core Audio avec session silencieuse dediee. Aucune commande d'arret, redemarrage ou veille n'est executee par ces tests. Le demarrage de session Windows et un second ordinateur restent a tester manuellement. + +Le setup est gratuit, Windows 11 x64. Le depot reste prive : les testeurs doivent disposer d'un acces GitHub. + diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b597bca..382b2ad 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,17 +6,17 @@ Thanks for your interest. Winlestia is a GPL-3.0 project; contributions are acce | Path | Content | |---|---| -| `src/backend` | .NET 10 backend (`Panneaux.Glass.csproj`, C#), native helpers (`*.cpp`) and their `build-*.cmd` | +| `src/backend` | .NET 8 backend (`Panneaux.Glass.csproj`, C#), native helpers (`*.cpp`) and their `build-*.cmd` | | `src/frontend` | Qt Quick interface (QML) and Python 3.12 / PySide6 host (`frontend.py`) | -| `src/cli` | The `winlestia` command (.NET 10) | -| `src/files` | Winlestia Files (.NET 10) | +| `src/cli` | The `winlestia` command (.NET 8) | +| `src/files` | Winlestia Files (.NET 8) | | `src/terminal` | Terminal integration (Clink theme scripts) | | `installer` | Inno Setup script and `build.ps1` | | `tests` | Small console test projects, one per area (`tests/WifiPolicy`, `tests/CliCommands`, ...), plus Python scripts | ## Building from source -Requirements: Windows 11 x64, .NET 10 SDK, Python 3.12 (for the Qt frontend and for `pip`), PowerShell 7, Inno Setup 6 (to build the installer), and MSVC only if you rebuild the native helpers. +Requirements: Windows 11 x64, .NET 8 SDK, Python 3.12 (for the Qt frontend and for `pip`), PowerShell 7, Inno Setup 6 (to build the installer), and MSVC only if you rebuild the native helpers. **Backend** @@ -68,19 +68,3 @@ $env:WINLESTIA_DATA_DIR = "$env:TEMP\winlestia-test" Describe what changed and why, how you tested it (which test project or manual steps, on which Windows build), and note anything touching restore paths, installer or autostart. By contributing you agree your work is released under GPL-3.0. Third-party code must be listed in `THIRD_PARTY_NOTICES.md` with its licence. - -## Development setup and conventions - -See `docs/ARCHITECTURE.md` (module map and names that must not change), `docs/BUILD-AND-TEST.md` (exact commands), `docs/WINDOWS-INTEGRATIONS.md` and `docs/RESTORE.md`. - -- **Setup.** .NET SDK 8.0.x; Python 3.12 with a PySide6 virtual environment in `src/frontend/.venv` (`pip install -r src/frontend/requirements.txt`). -- **Single test.** `dotnet run --project tests/ -c Release` prints `TOTAL x/y`. Do not run the whole suite for a small change. `tests/FullscreenWatcher` currently does not terminate (known issue). -- **QML lint.** Run `pyside6-qmllint` from the venv (`-I src/frontend/qml`) on each QML file you touched and fix what you introduced. -- **Style.** Target 120 columns (advisory, see `.editorconfig`); English identifiers and comments; match the surrounding file's indentation and layout. Do not reformat code you are not changing. -- **User-visible strings.** Wrap QML text in `qsTr(...)` and add a `fr|en|es` row to `ROWS` in `src/frontend/localization.py`, keyed by the exact French text. -- **No hard-coded colours.** Use the wallpaper-derived palette through `Colours` / `Appearance` tokens (`src/frontend/qml/qs/services/Colours.qml`, `qs/config/Appearance.qml`). -- **No idle cost.** No timers, polling or animations that run while nothing happens; prefer events and stop work when hidden. -- **Do not rename** preferences JSON properties, pipe names or IPC JSON keys, `Bridge.*` members used by QML, `ROWS` keys, command-line switches, or `catalog.json` fields (`docs/ARCHITECTURE.md`). -- **Generated files.** Verification and benchmark outputs (`src/backend/verification*.json`, `performance-*.json`, `motion-*.json`, ...) are git-ignored; do not commit them. -- **Commits.** One concern per commit, imperative subject line, explain why in the body; no unrelated formatting or merge noise. Never commit personal data (`preferences-glass.json`, logs, `catalog.json`). -- **Licences.** Files derived from Caelestia keep their attribution: `src/backend/CAELESTIA-NOTICES.md`, `src/backend/LICENSE-CAELESTIA.txt`, `src/frontend/LICENSE`, `src/frontend/licenses/`, and the root `THIRD_PARTY_NOTICES.md`. Add any new third-party code there. diff --git a/Directory.Build.props b/Directory.Build.props index 8e21e72..4942f36 100644 --- a/Directory.Build.props +++ b/Directory.Build.props @@ -1,6 +1,6 @@ - latest - true + 1.0.0 + true diff --git a/README.md b/README.md index e292fd6..01e5db1 100644 --- a/README.md +++ b/README.md @@ -8,11 +8,11 @@ Join the Winlestia Discord server -[![Release](https://img.shields.io/github/v/release/lilidoxdev/winlestia?style=flat-square)](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1) +[![Release](https://img.shields.io/github/v/release/lilidoxdev/winlestia?style=flat-square)](https://github.com/lilidoxdev/winlestia/releases/tag/v1.0.0) [![License](https://img.shields.io/github/license/lilidoxdev/winlestia?style=flat-square)](LICENSE) [![Windows 11](https://img.shields.io/badge/Windows-11-0078D4?style=flat-square)](docs/INSTALL.md) -[Download](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1) · [Demo](#demo) · [Install guide](docs/INSTALL.md) · [Shortcuts](docs/SHORTCUTS.md) · [Troubleshooting](docs/TROUBLESHOOTING.md) · [Discord](https://discord.gg/5jXv7NRj3Q) +[Download](https://github.com/lilidoxdev/winlestia/releases/latest) · [Demo](#demo) · [Install guide](docs/INSTALL.md) · [Shortcuts](docs/SHORTCUTS.md) · [Troubleshooting](docs/TROUBLESHOOTING.md) · [Discord](https://discord.gg/5jXv7NRj3Q) Winlestia on a Windows 11 desktop @@ -28,10 +28,31 @@ These visuals are motion-design illustrations made in HTML/CSS. They are not scr ## What is Winlestia -Winlestia is a free, open-source desktop shell for Windows 11, bringing a Caelestia-inspired interface, dynamic themes, glass effects, a customizable dock and desktop tools. +Winlestia is a free, open-source desktop shell for Windows 11. It is a port of [Caelestia](https://github.com/caelestia-dots/shell), which is its visual reference, and adds a dynamic dock, glass panels, desktop widgets (Winjets), a lock screen and a set of desktop tools. Version 1.0 is the first stable release. It replaces the surface of Windows, not the system. The taskbar is swapped for a dock, and a dashboard and glass panels sit on top of your normal desktop. Your files, windows and wallpaper stay where they are. The interface is a port of [Caelestia](https://github.com/caelestia-dots/shell) (Qt Quick), and a .NET 8 service handles the Windows side. Panel colours can be derived from your wallpaper (see [Wallpaper and dynamic theme](#wallpaper-and-dynamic-theme)). +## What is new in 1.0 + +- **Dock**: it grows with the open apps and scrolls when it overflows; optional battery pill for Bluetooth and XInput devices; pins of Store (MSIX) apps survive app updates and reboots; windows no longer slip between the dock's glass background and its icons. +- **Control center**: Wi-Fi page, Bluetooth device connect/disconnect, audio output and microphone pages, per-application mixer. +- **Command palette**: faster to open, including the first time after start-up. +- **Winjets**: ten built-in desktop widgets that replace the PC Widgets pack, drawn with the liquid glass v2 treatment and fed with real data (weather with your location, Yahoo Finance quotes, ICS calendar, system, storage, media session, notes and more). +- **Social rail**: the right-edge panel gathers notifications from Discord, Instagram, Snapchat, WhatsApp and Telegram. +- **Also**: push-to-talk voice dictation (off by default), redesigned file manager, lock screen, window overview, and a new WPF installer and uninstaller. + +Full list: [CHANGELOG.md](CHANGELOG.md) and [release notes](docs/RELEASE-NOTES-1.0.md). + +### Screenshots + +The dock growing with open apps + +Battery pill for connected devices in the dock + +The built-in Winjets on the desktop + +WinlestiaSetup welcome screen + ## Features The images in this section are motion-design illustrations made in HTML/CSS, not screen captures (see [docs/illustrations](docs/illustrations/README.md)). @@ -55,11 +76,12 @@ Applications, Games, Projects and Documents boards, your favorites, recent short - A dock instead of the Windows taskbar, with window previews on hover and a virtual-desktop indicator. The dock auto-hides: it slides away a fraction of a second (about 0.45 s) after the pointer leaves it, and appears when the pointer reaches the bottom edge of the screen. The Windows key opens the normal Windows Start menu. - **Ctrl+F2** opens the palette: calculator, `>emoji`, `>wallpaper`, `>file ` for indexed files, open windows, Windows Settings pages and session actions (each asks for confirmation). +- Optional battery indicator for connected Bluetooth and XInput devices (headset, gamepad, mouse, keyboard), next to the clock: one icon, gauge and percentage per device, in the error colour at 20 % or less. Hovering shows the name and state, clicking opens the Controls panel. Off by default; enable it and choose which paired devices appear, and their type, in Settings > Docks and panels > Icon bar. ### Media and quick controls Media panel -Quick controls include a Wi-Fi network list, per-display brightness (DDC/CI, external displays too) and a "Reduced effects" switch. Audio and per-application mixer panels are included. The media panel shows a readable source name for browsers, updates the playback position, and the audio visualiser follows the playing browser. +The Control center has toggle tiles (Wi-Fi, Bluetooth, Dark theme, Light mode), thick volume and per-display brightness sliders (DDC/CI, external displays too) and capture/clipboard shortcuts. Wi-Fi, Bluetooth and Sound sub-pages open inside the panel: Wi-Fi network list, Bluetooth device connect/disconnect, output/input device selection and per-application volume. ### Performance Performance panel @@ -77,7 +99,13 @@ Screen capture with annotation (**Ctrl+F3**), text recognition (OCR) on a captur ### Settings Settings -Six pages with a search field: appearance, desktop and dock, file explorer, daily use, messengers and bookmarks. Screen frame, accent border on windows, desktop logo, quiet mode (dock and OSD hidden during fullscreen), on-screen indicators for volume, brightness and microphone, and optional automatic tiling (off by default; Ctrl+Alt+arrows). +Eight pages with a search field (a result opens its page and highlights the row): Appearance, Interface, Docks and panels, Keyboard shortcuts, Media and audio, Apps, bookmarks and links, Files and Windows, General. + +- **Docks and panels**: the dock, the bookmarks panel (left edge) and the social networks panel (right edge) can each be hidden. Hiding the dock while it replaces the Windows taskbar gives the Windows taskbar back, so there is always one bar. +- **Keyboard shortcuts**: every global shortcut in one page, grouped. "Modifier" opens a capture dialog; a combination reserved by Windows or already used by another action is refused with the reason. Fixed shortcuts (backup dashboard shortcut, desktop rescue, tiling keys, dictation key) show why they cannot be changed here. A shortcut that another application already holds at start-up is flagged "Inactif". +- **Opening Settings**: **Win+Alt+S** (reassignable), the tray icon menu ("Paramètres de Winlestia"), or `winlestia panel settings` from a terminal. + +Screen frame, accent border on windows, desktop logo, quiet mode (dock and OSD hidden during fullscreen), on-screen indicators for volume, brightness and microphone, and optional automatic tiling (off by default; Ctrl+Alt+arrows). ### Terminal Terminal with the Winlestia palette @@ -87,17 +115,25 @@ Opt-in at setup: Command Prompt through [Clink](https://github.com/chrisant996/c ### Panels Winlestia panels -Also: a Files explorer, messenger and bookmark side rails (the dashboard moves aside so the social rail no longer covers its tabs; it reopens on the last tab used), the Glass shell UI in English, French and Spanish (language detected from Windows), an installer that detects the system language, an optional push-to-talk dictation (hold AltGr, off by default), and a `winlestia` command line to script the running shell. +Also: a redesigned Files explorer, messenger and bookmark side rails, an optional push-to-talk dictation (hold AltGr, off by default), and a `winlestia` command line to script the running shell. ## Install Requires **Windows 11 (64-bit)**. No administrator rights needed. -1. Download [`Winlestia-Setup-0.9.1.exe`](https://github.com/lilidoxdev/winlestia/releases/download/v0.9.1/Winlestia-Setup-0.9.1.exe) from the [release](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1). -2. Check it: run `Get-FileHash .\Winlestia-Setup-0.9.1.exe -Algorithm SHA256` in PowerShell and compare the result with the SHA-256 printed in the [release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1). -3. Run it. The installer is not code-signed yet, so Windows may show a SmartScreen warning: choose **More info**, then **Run anyway**. Code signing is being looked into (SignPath Foundation offers free signing for open-source projects). +1. Download `WinlestiaSetup.exe` from the [GitHub Releases page](https://github.com/lilidoxdev/winlestia/releases/latest). +2. Check it: run `Get-FileHash .\WinlestiaSetup.exe -Algorithm SHA256` in PowerShell and compare the result with the SHA-256 printed in the release notes. +3. Run it. The binaries are **not code-signed**, so SmartScreen will likely warn: choose **More info**, then **Run anyway**. + +After installing, move the pointer to the bottom edge of the screen to reveal the dock. Full guide, options and updating: [docs/INSTALL.md](docs/INSTALL.md). + +### Uninstall -After installing, move the pointer to the bottom edge of the screen to reveal the dock. The setup wizard is in English by default and uses French or Spanish when Windows is set to one of them. Full guide, options, updating and uninstalling: [docs/INSTALL.md](docs/INSTALL.md). +Run `WinlestiaSetup.exe` again and choose uninstall, or use Settings > Apps > Installed apps > Winlestia, or the "Désinstaller Winlestia" entry of the power menu. The Windows taskbar is restored first. You choose whether settings and data (`%LOCALAPPDATA%\Panneaux`) are kept or sent to the Recycle Bin. + +### Restore the Windows taskbar + +If the taskbar is missing: press **Ctrl+Alt+Backspace**, or run `Panneaux.Glass.exe --restore-taskbar` from the `Glass-v5` folder of the install. More options: [docs/RESTORE.md](docs/RESTORE.md). ## Usage @@ -108,6 +144,7 @@ After installing, move the pointer to the bottom edge of the screen to reveal th | Ctrl+F3 | Screen capture | | Ctrl+F8 | Pin window on top | | Win+Alt+W | Wallpaper switcher (Ctrl+Alt+W if Windows refuses it) | +| Win+Alt+Tab | Window overview (Win+Alt+V if Windows refuses it) | | Ctrl+Alt+Backspace | Emergency rescue | All shortcuts (reassignable in Settings), palette prefixes and the `winlestia` command: [docs/SHORTCUTS.md](docs/SHORTCUTS.md). @@ -118,23 +155,32 @@ All shortcuts (reassignable in Settings), palette prefixes and the `winlestia` c **Why does Windows warn me about the installer?** The installer and the programs it installs are not code-signed, so SmartScreen cannot show a publisher. Verify the SHA-256, then use "More info", "Run anyway". A matching checksum shows the file is the published one; it does not replace a signature. -**Is there a notification centre?** No. Only on-screen indicators and toasts. - **Where are my settings and logs?** In `%LOCALAPPDATA%\Panneaux`. The name is the project's former name, kept on purpose. Uninstalling keeps this folder; see Privacy and data below to remove it. **Why "Panneaux" in some file names?** Same reason: legacy name. +## Winjets + +Winjets are small desktop widgets placed behind your windows, on the desktop. Each one is a package (a ZIP or a folder) that describes its layout, settings and data in JSON; no code from a package is ever run. The default set is: Calendar, Clock, Music (the Windows media session), System, Markets (Yahoo Finance equities and indexes), Storage, Files, Notes, Agenda (an ICS link, for example an Outlook published calendar) and Weather (a city setting, or the Windows location), plus Battery. They follow your palette and sit on the glass; see [all of them](docs/media/winjets/all.png). Add them from Settings > Winjets. Each Winjet has its own background transparency slider (0 to 100 %, or "Par défaut" to follow the global glass setting), under the settings button of its row; text stays opaque. + +To move or resize Winjets, double-click one: edit mode starts for all of them (double-click again, Esc, or a click on the empty desktop ends it). A grid of cells (168 px with a 16 px gap, so 4 x 2 cells is 720 x 352) appears under the cards with the screen centre lines. Drag a card by its body or a handle; edges and sizes snap to the grid, to the screen centre and to the other cards, with an accent guide line when they align. Hold Alt for free placement. The position is saved once, when you release. + +To make your own, see [docs/winjets/MON-PREMIER-WINJET.md](docs/winjets/MON-PREMIER-WINJET.md) (step-by-step guide, in French) and the format reference [docs/winjets/FORMAT-v1.md](docs/winjets/FORMAT-v1.md). A fill-in template and an example are in `docs/winjets/`. + ## Known limitations -- The Glass UI is available in French, English and Spanish. The language comes from `Caelestia/language.json` (`auto`, `fr`, `en` or `es` under `%LOCALAPPDATA%\Panneaux\Caelestia\`), then the Windows UI language, then English. Spanish is partial: about 230 of 820 strings have a Spanish text, the others fall back to English. +- The shell panels are translated into English and Spanish; some rarer labels derived from the system may still appear in French. The language is chosen automatically from the Windows display language. To force it, set the `language` key (`auto`, `fr`, `en` or `es`) in `%LOCALAPPDATA%\Panneaux\Caelestia\language.json`. Fallback text is French. - Not tested on a clean machine or virtual machine, and not tested after a real reboot or sign-in (the start-up scheduled task was launched manually). - Binaries are unsigned, so SmartScreen may warn. - Windows 11 x64 only. - Temperature is shown in Celsius only. -- Not a notification centre. - The optional terminal integration prints a welcome banner in French, with your session and computer names. - When you confirm a wallpaper in the switcher, the previous one can flash briefly before the new one appears. +## Tests + +`dotnet test tests/Winlestia.Tests --filter "Category!=Desktop"` and `pytest -q`. Details in [docs/TESTS.md](docs/TESTS.md). + ## Privacy and data - Weather: when no city is set, your approximate location is found from your IP address through wttr.in (which therefore sees your IP address); the forecast comes from Open-Meteo. Set a city to avoid the IP lookup. Temperature is in °C only. @@ -143,11 +189,13 @@ All shortcuts (reassignable in Settings), palette prefixes and the `winlestia` c ## Roadmap -**Shipped in 0.9.0:** Wi-Fi panel, per-display brightness, dashboard audio bars, fullscreen quiet mode, full-screen wallpaper switcher, richer command palette, settings search, tiling shortcuts, `winlestia` command line. See [CHANGELOG.md](CHANGELOG.md). +**Shipped in 1.0:** dynamic dock, redesigned Control center, ten built-in Winjets, lock screen, window overview, push-to-talk dictation, WPF installer. See [CHANGELOG.md](CHANGELOG.md). + +**Shipped in 0.9.2:** redesigned settings in eight pages with search, palette editor, terminal that follows the light or dark theme, keyboard shortcuts page with rebinding, redesigned file manager, dock icons for packaged apps, separately hideable dock, bookmarks and social panel. -**Shipped in 0.9.1:** media panel fixes, social rail spacing, English installer with language detection, safer writes of user data, .NET 10. See [docs/RELEASE-0.9.1.md](docs/RELEASE-0.9.1.md). +**Shipped in 0.9.0:** Wi-Fi panel, per-display brightness, dashboard audio bars, fullscreen quiet mode, full-screen wallpaper switcher, richer command palette, settings search, tiling shortcuts, `winlestia` command line. See [CHANGELOG.md](CHANGELOG.md). -**Ideas, not promises:** a notification centre, support for enterprise and hidden Wi-Fi networks, more testing on other display layouts, and a code-signed installer. +**Ideas, not promises:** support for enterprise and hidden Wi-Fi networks, more testing on other display layouts, and a code-signed installer. ## Contributing diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 5d08261..96a9c96 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -1,12 +1,13 @@ # Composants tiers -- **Caelestia Shell**, caelestia-dots et contributeurs : GPLv3, https://github.com/caelestia-dots/shell (tag v1.4.0 portée, voir `docs/history/caelestia-windows/PORTAGE.md`). Le portage vit dans `src/frontend` (livré dans `Caelestia-Windows/`) ; la correspondance des fichiers est dans `src/frontend/UPSTREAM.json` et `src/frontend/PORT_PATCHES.json`. Ce dépôt ne contient pas de copie de l'amont (pas de dossier `upstream/`) : l'original est sur GitHub. Licence : `LICENSE` et `src/backend/LICENSE-CAELESTIA.txt`. +- **Caelestia Shell**, caelestia-dots et contributeurs : GPLv3, https://github.com/caelestia-dots/shell (tag v1.4.0 portée, voir `docs/history/caelestia-windows.md`). Le portage vit dans `src/frontend` (livré dans `Caelestia-Windows/`) ; la correspondance des fichiers est dans `src/frontend/UPSTREAM.json` et `src/frontend/PORT_PATCHES.json`. Ce dépôt ne contient pas de copie de l'amont (pas de dossier `upstream/`) : l'original est sur GitHub. Licence : `LICENSE` et `src/backend/LICENSE-CAELESTIA.txt`. - **Qt / PySide6 / Shiboken6 6.10.3**, The Qt Company et contributeurs : licences du runtime Qt/PySide, dont LGPLv3/GPLv3 ; notices dans `licenses/` et les métadonnées du runtime `.venv/Lib/site-packages`. Modules dynamiques remplaçables, sans liaison statique. Sources : https://code.qt.io/ et https://download.qt.io/official_releases/QtForPython/ . - **Rubik**, Google Fonts et auteurs : SIL Open Font License, `assets/fonts/Rubik-OFL.txt`. - **Material Symbols Rounded**, Google : Apache 2.0, `assets/fonts/MaterialSymbols-LICENSE.txt`. - **NAudio 2.2.1**, Mark Heath et contributeurs : MIT, `licenses/NAudio-MIT.txt`, https://github.com/naudio/NAudio . - **LibreHardwareMonitor 0.9.6** : MPL 2.0 et dépendances du paquet NuGet, https://github.com/LibreHardwareMonitor/LibreHardwareMonitor . Le backend conserve ses références de paquets et sources de construction. - **Clink** (chrisant996/clink), Martin Ridgers, Christopher Antos et contributeurs : GPL-3.0 (texte vérifié dans `src/terminal/clink/LICENSE`), https://github.com/chrisant996/clink . Fichiers fournis dans `src/terminal/clink/` ; le binaire `clink_x64.exe` est ignoré par git et ajouté à la construction. +- **Thèmes Clink** (`src/terminal/clink/themes/`) : `*.clinktheme` et `*.clinkprompt` fournis avec Clink (GPL-3.0, voir ci-dessus). Les palettes `Dracula`, `Solarized Dark/Light` et `Tomorrow*` reprennent des schémas de couleurs tiers (Dracula Theme, Ethan Schoonover, Chris Kempson) ; leur licence propre (MIT) n'est PAS vérifiée par un fichier du dépôt. `agnoster`, `pure`, `starship`, `oh-my-posh`, `jonathan`, `darkblood`, `bureau` reproduisent l'apparence de prompts connus (noms cités pour référence) ; origine exacte non vérifiée. - **CaskaydiaCove Nerd Font Mono**, sous-ensemble WOFF2 (`src/terminal/clink/CaskaydiaCoveNerdFontMono-Regular-Subset.woff2`) : police dérivée de Cascadia Code (Microsoft) corrigée par le projet Nerd Fonts. Licence attendue : SIL OFL 1.1 ; NON VÉRIFIÉE (aucun fichier de licence dans le dépôt pour cette police). - **Whisper.net 1.9.1** et **Whisper.net.Runtime 1.9.1**, Sandro Hanea : MIT (métadonnées NuGet et fichier LICENSE du paquet), https://github.com/sandrohanea/whisper.net . Le modèle de dictée est téléchargé à l'exécution depuis https://huggingface.co/ggerganov/whisper.cpp ; sa licence n'a pas été vérifiée ici. - **Microsoft.Web.WebView2 1.0.4314.35**, Microsoft : licence BSD de Microsoft fournie dans le paquet (`LICENSE.txt`), https://aka.ms/webview . Le runtime WebView2 lui-même est installé par Windows/Microsoft. diff --git a/Winlestia.sln b/Winlestia.sln new file mode 100644 index 0000000..6b4736c --- /dev/null +++ b/Winlestia.sln @@ -0,0 +1,113 @@ + +Microsoft Visual Studio Solution File, Format Version 12.00 +# Visual Studio Version 17 +VisualStudioVersion = 17.0.31903.59 +MinimumVisualStudioVersion = 10.0.40219.1 +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72D-47B6-A68D-7590B98EB39B}" +EndProject +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "backend", "backend", "{FE360695-3F2B-1049-3887-35FBB5135923}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Panneaux.Glass", "src\backend\Panneaux.Glass.csproj", "{5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}" +EndProject +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "files", "files", "{B4367576-ED80-C199-DB9B-2EB28302B9E2}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Winlestia.Files", "src\files\Winlestia.Files.csproj", "{E3860575-05D1-4882-8E37-A99AC9B209B6}" +EndProject +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "cli", "cli", "{778427DF-EB2C-5228-964E-6D535DE253CA}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "winlestia", "src\cli\winlestia.csproj", "{16D1F48D-91F1-4F92-9062-3944A5E64B56}" +EndProject +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{0AB3BF05-4346-4AA6-1389-037BE0695223}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Winlestia.Tests", "tests\Winlestia.Tests\Winlestia.Tests.csproj", "{B043B1C4-7D28-4328-84BE-849458C9C42B}" +EndProject +Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "sensors", "sensors", "{D829CD13-33D0-490D-850A-FE4A0FE5E0CA}" +EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Winlestia.Sensors", "src\sensors\Winlestia.Sensors.csproj", "{E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Any CPU = Debug|Any CPU + Debug|x64 = Debug|x64 + Debug|x86 = Debug|x86 + Release|Any CPU = Release|Any CPU + Release|x64 = Release|x64 + Release|x86 = Release|x86 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|Any CPU.Build.0 = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|x64.ActiveCfg = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|x64.Build.0 = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|x86.ActiveCfg = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Debug|x86.Build.0 = Debug|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|Any CPU.ActiveCfg = Release|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|Any CPU.Build.0 = Release|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|x64.ActiveCfg = Release|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|x64.Build.0 = Release|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|x86.ActiveCfg = Release|Any CPU + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E}.Release|x86.Build.0 = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|Any CPU.Build.0 = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|x64.ActiveCfg = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|x64.Build.0 = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|x86.ActiveCfg = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Debug|x86.Build.0 = Debug|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|Any CPU.ActiveCfg = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|Any CPU.Build.0 = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|x64.ActiveCfg = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|x64.Build.0 = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|x86.ActiveCfg = Release|Any CPU + {E3860575-05D1-4882-8E37-A99AC9B209B6}.Release|x86.Build.0 = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|Any CPU.Build.0 = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|x64.ActiveCfg = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|x64.Build.0 = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|x86.ActiveCfg = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Debug|x86.Build.0 = Debug|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|Any CPU.ActiveCfg = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|Any CPU.Build.0 = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|x64.ActiveCfg = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|x64.Build.0 = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|x86.ActiveCfg = Release|Any CPU + {16D1F48D-91F1-4F92-9062-3944A5E64B56}.Release|x86.Build.0 = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|Any CPU.Build.0 = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|x64.ActiveCfg = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|x64.Build.0 = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|x86.ActiveCfg = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Debug|x86.Build.0 = Debug|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|Any CPU.ActiveCfg = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|Any CPU.Build.0 = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|x64.ActiveCfg = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|x64.Build.0 = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|x86.ActiveCfg = Release|Any CPU + {B043B1C4-7D28-4328-84BE-849458C9C42B}.Release|x86.Build.0 = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|Any CPU.Build.0 = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|x64.ActiveCfg = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|x64.Build.0 = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|x86.ActiveCfg = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Debug|x86.Build.0 = Debug|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|Any CPU.ActiveCfg = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|Any CPU.Build.0 = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|x64.ActiveCfg = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|x64.Build.0 = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|x86.ActiveCfg = Release|Any CPU + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58}.Release|x86.Build.0 = Release|Any CPU + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection + GlobalSection(NestedProjects) = preSolution + {FE360695-3F2B-1049-3887-35FBB5135923} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B} + {5065FDC4-DDE4-4CD0-BDC0-173FB1C5266E} = {FE360695-3F2B-1049-3887-35FBB5135923} + {B4367576-ED80-C199-DB9B-2EB28302B9E2} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B} + {E3860575-05D1-4882-8E37-A99AC9B209B6} = {B4367576-ED80-C199-DB9B-2EB28302B9E2} + {778427DF-EB2C-5228-964E-6D535DE253CA} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B} + {16D1F48D-91F1-4F92-9062-3944A5E64B56} = {778427DF-EB2C-5228-964E-6D535DE253CA} + {B043B1C4-7D28-4328-84BE-849458C9C42B} = {0AB3BF05-4346-4AA6-1389-037BE0695223} + {D829CD13-33D0-490D-850A-FE4A0FE5E0CA} = {827E0CD3-B72D-47B6-A68D-7590B98EB39B} + {E6771C4F-C069-4FE8-9FC9-A98D8FF8AE58} = {D829CD13-33D0-490D-850A-FE4A0FE5E0CA} + EndGlobalSection +EndGlobal diff --git a/conftest.py b/conftest.py new file mode 100644 index 0000000..702691b --- /dev/null +++ b/conftest.py @@ -0,0 +1,4 @@ +"""pytest configuration: Qt must never open a real window during tests.""" +import os + +os.environ['QT_QPA_PLATFORM'] = 'offscreen' diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index f5a27ae..a110cae 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -1,106 +1,63 @@ -# Architecture - -Winlestia is a Windows 11 desktop shell (dock, dashboard, glass panels) and a Windows port of -[Caelestia](https://github.com/caelestia-dots/shell) (Quickshell/Linux). Attribution and licences: -`THIRD_PARTY_NOTICES.md`, `src/backend/CAELESTIA-NOTICES.md`, `src/backend/LICENSE-CAELESTIA.txt`, -`src/frontend/LICENSE`, `src/frontend/THIRD_PARTY_NOTICES.md`, `src/frontend/licenses/`. - -## Process map - -```mermaid -flowchart LR - Setup["installer/Winlestia.iss
(Inno Setup, built by installer/build.ps1)"] -->|installs| Backend - subgraph Install["%LOCALAPPDATA%\Programs\Winlestia"] - Backend["Glass-v5\Panneaux.Glass.exe
(.NET 10, WPF + WinForms)"] - Front["Caelestia-Windows\.venv\Scripts\pythonw.exe
frontend.py (PySide6 + QML)"] - Guard["Glass-v5\RETABLIR_BARRE_WINDOWS.exe
--watch-parent (taskbar watchdog)"] - Files["Glass-v5\Winlestia.Files.exe"] - Cli["Glass-v5\winlestia.exe"] - end - Backend -->|starts| Front - Backend -->|starts, lease file| Guard - Front <-->|"pipe PanneauxCaelestia (JSON lines) + event Local-PanneauxCaelestiaWake"| Backend - Cli -->|"pipe WinlestiaCli"| Backend - Files <-->|"single-instance pipe (FilesPipe)"| Backend -``` - -Start-up: the backend runs in Qt mode when `--qt-shell` is passed or `caelestia.enabled` sits next to the exe -(`Coordinator.cs`, `QtMode`), unless `--legacy-shell`. It launches -`\..\Caelestia-Windows\.venv\Scripts\pythonw.exe` on `frontend.py` (override with `--qt-root=`). -A second launch signals the first instance through the `Local\PanneauxGlassV5` mutex and show/quit events, then exits. - -## Folders - -| Path | Responsibility | -|---|---| -| `src/backend` | `Panneaux.Glass.csproj` (net10.0-windows10.0.19041.0, WPF + WinForms). Windows integrations (taskbar hide/restore, audio, media, bookmarks, file search, hotkeys, autostart), the IPC servers, and the legacy "Glass" WPF shell (kept for compatibility, no new features). Native helpers `*.cpp` are built by `build-*.cmd` into `native/` (binaries are git-ignored). | -| `src/backend/Inventory.ps1`, `Install.ps1` | App inventory (writes `catalog.json`) and installation helper. | -| `src/frontend` | Qt Quick shell: `frontend.py` (Bridge, IPC client), `localization.py`, `interaction.py`, `search.py`, palette modules (`wallpaper_theme.py`, `chromatic_palette.py`, `custom_palette.py`), `qml/` (`qml/qs/config/Appearance.qml`, `qml/qs/services/Colours.qml`, panes, dock). Upstream tracking: `UPSTREAM.json`, `PORT_PATCHES.json`, `PORTAGE.md`. | -| `src/files` | Winlestia Files file manager (WPF, `Winlestia.Files.csproj`). | -| `src/cli` | `winlestia.exe` (`winlestia.csproj`, trimmed single file); talks to pipe `WinlestiaCli`. | -| `src/terminal` | Terminal theming (Clink, PowerShell profile, `sync_theme.py`). | -| `installer` | `build.ps1` (full chain) and `Winlestia.iss`. | -| `tests` | Console test projects (one per area) and Python scripts. | -| `docs` | User and developer documentation. | - -## Contracts that must not be renamed - -Renaming any of these breaks existing installs or the other side of an IPC boundary. - -- **Preferences JSON.** `preferences-glass.json` is `Store.State`, serialized from `Preferences` in - `src/backend/Storage/Models.cs` (`Store.Json`: case-insensitive read, indented). Property names are the file keys - (for example `ReplaceTaskbar`, `ShortcutPreferences.Modifiers/Key/View`). Add properties with defaults; never rename. -- **Pipes, events, mutexes.** `PanneauxCaelestia` (`QtShellBridge.cs` server, `frontend.py` client; one JSON object per - line, 128 KiB cap, current user only); `Local\PanneauxCaelestiaWake`; `WinlestiaCli` (`CliServer.cs`; allow-list in - `CliCommands.cs`; reply keys `code` and `text`); the Files pipe (`FilesPipe.cs`, `src/files/SingleInstance.cs`; - `WINLESTIA_FILES_PIPE` is test-only); `Local\PanneauxGlassV5`, `Local\PanneauxGlassTaskbarRestore`, - `Local\PanneauxGuardReady-*` / `Local\PanneauxGuardRelease-*`. -- **JSON keys in IPC messages** are shared by `QtShellBridge.cs` / `QtDockActions.cs` and `frontend.py`; change both - sides in one commit. `src/frontend/tests/check_bridge.py` exercises the pipe. -- **Bridge API used by QML.** The `Bridge(QObject)` class in `frontend.py` exposes `Property` / `Slot` names that - `qml/**/*.qml` reference as `Bridge.` (hundreds of uses). Grep the QML before touching one. -- **Localization.** `ROWS` in `src/frontend/localization.py` are `fr|en|es` lines keyed by the French text. The French - string passed to `qsTr(...)` / `QCoreApplication.translate` must match the first column exactly. -- **Command-line switches** (`Coordinator.cs`, `Main`): `--qt-shell`, `--legacy-shell`, `--qt-root=`, `--show`, - `--quit`, `--restore` (launches `SECOURS_BUREAU.exe`), `--restore-taskbar`, `--taskbar-guard ` - (managed watchdog), `--taskbar-state`, plus `--verify-*`, `--benchmark*` and `--preview*` developer switches. - `RETABLIR_BARRE_WINDOWS.exe` takes `--watch-parent` (`ShellTaskbar.cs`). -- **CLI commands** of `winlestia.exe`: `CliCommands.HelpText` and `tests/CliCommands`. -- **Catalogue.** `catalog.json` is written by `Inventory.ps1` (`Id`, `Name`, `Target`, `Section`, `Category`, - `IconPath`, `SearchText`, ...) and read by `Store.LoadCatalogue` (`Models.cs`) and `AppCatalogueWatcher.cs`. - Keep PowerShell and C# field names identical. -- **Partial classes** spread over several files: `QtShellBridge` (`QtShellBridge.cs`, `QtDockActions.cs`), `HomeWindow` - (+`HomeShellPages.cs`), `ExplorerAppearance` (+`.StableIcons.cs`), `MonitorBrightness` (+`MonitorDisplays.cs`), - `UI` (`UiTokens.cs`, `Visuals.cs`), `WindowTiler` (+`WindowTilerKeys.cs`), `MainWindow.*.cs` in `src/files`. Tests - link source files by name; update `tests/*/*.csproj` if you move or rename a file. -- **Legacy names.** Namespace `PanneauxGlass`, assembly `Panneaux.Glass`, folder `%LOCALAPPDATA%\Panneaux`, - `Glass-v5`, `Caelestia-Windows`, scheduled task `WinlestiaShell`. These are compatibility constraints. - -## Data locations - -| What | Where | -|---|---| -| User data (preferences, `glass.log`, clipboard, pins) | `%LOCALAPPDATA%\Panneaux` (`Store.DataDir`, `Models.cs`); `WINLESTIA_DATA_DIR` overrides it (tests). Legacy install-folder data is migrated by `Store.MigrateLegacyData`. | -| Installed program | `%LOCALAPPDATA%\Programs\Winlestia` (`Glass-v5`, `Caelestia-Windows`, `Winlestia-Terminal`) | -| Taskbar lease (restore data) | `TaskbarNative.LeasePath` (`taskbar-session.json`) | -| Autostart | Scheduled task `WinlestiaShell` (see `docs/WINDOWS-INTEGRATIONS.md`) | - -## Restore paths (invariant) - -Every way back to the Windows taskbar must keep working. User instructions: `docs/RESTORE.md`. - -| Path | Code | -|---|---| -| Watchdog, started when the taskbar is hidden | `ShellTaskbar.Enable` starts `RETABLIR_BARRE_WINDOWS.exe --watch-parent` (source `src/backend/TaskbarRescue.cpp`); fallback `Panneaux.Glass.exe --taskbar-guard` -> `TaskbarNative.Guard` | -| `--restore-taskbar` | `Coordinator.cs` -> `TaskbarNative.RestoreSaved` | -| `RETABLIR_BARRE_WINDOWS.exe` | `src/backend/native/`, copied to `Glass-v5` by `installer/build.ps1` | -| `SECOURS_BUREAU.exe` | `src/backend/Secours.cpp`, `build-rescue.cmd` | -| Ctrl+Alt+Backspace | `GlobalShortcut.cs` (`RegisterHotKey`, modifiers 0x4003, key 0x08) | - -## Backend namespaces - -`src/backend` is split into one folder per area, each with its own namespace `PanneauxGlass.` (listed as global usings in `src/backend/GlobalUsings.cs`): Shell (coordinator, Qt bridge, CLI server), Media, Social, Explorer, Desktop (tiling, virtual desktops, wallpaper, fullscreen), Platform (network, power, telemetry, autostart, app catalogue), Storage (Store, Preferences, models), Interop (P/Invoke), Views (WPF windows and visual tokens), Tools (clipboard, capture, dictation, palette, bookmarks), SelfTest (verification harnesses) and Shared (`Winlestia.Shared`, also linked by `src/files`). `Program.cs` stays at the root. - -## Localisation of the Glass shell - -User-visible text of the WPF shell and of Winlestia Files lives in `src/backend/Views/Strings.cs` (`PanneauxGlass.Views`), linked into `src/files` as `Shared\Strings.cs`. It holds one table of `(Fr, En, Es?)` per key; French values are the original literals, English is the fallback, Spanish exists only where the Qt shell already has a translation and falls back to English otherwise. The language is resolved once, on first use, in this order: the `language` key (`auto`, `fr`, `en`, `es`) of `\Caelestia\language.json` (the file the Qt shell writes), then `CurrentUICulture`, then English. Strings with counts or names are format methods (`Strings.StatusLine`, `Strings.DeletePermanentlyConfirm`). Exception messages that reach a message box, toast or status label are thrown from `Strings`; log-only messages stay English. Category and folder names that double as data keys (board filters, tool categories) keep their key; only the displayed text goes through `Strings.CategoryLabel` or `Strings.KnownFolder`. `tests/StringsTable` checks the table. +# Architecture de Winlestia + +Vue d'ensemble pour s'orienter dans le dépôt. Les détails vivent dans les documents cités en fin de page. + +## Processus + +| Processus | Source | Rôle | +|---|---|---| +| Glass (backend) | `src/backend/` (`Panneaux.Glass.exe`, C# .NET 8, WPF) | Chef d'orchestre : réglages, barre des tâches, dock, tuilage, audio, fond d'écran, télémétrie. Il est l'unique propriétaire de l'état. | +| Frontend | `src/frontend/` (PySide6 / QML) | Interface (tableau de bord, palette, réglages). Lancé et surveillé par le backend ; il n'a aucun droit sur le bureau. | +| Garde (watchdog) | `Panneaux.Glass.exe --taskbar-guard ` | Processus séparé qui rétablit la barre Windows si le backend s'arrête ou plante. | +| Secours | `SECOURS_BUREAU.exe` (`Secours.cpp`) | Outil indépendant (Ctrl+Alt+Retour arrière) qui arrête Winlestia et rend un bureau normal. | +| Winlestia Fichiers | `src/files/` (WPF) | Gestionnaire de fichiers. Préchargé masqué par le backend, joint par tube nommé (`src/backend/Files/`). | +| CLI `winlestia` | `src/cli/` | Petite commande qui parle au backend par le tube `WinlestiaCli` (`Bridge/CliServer.cs`). | +| Synchro terminal | `src/terminal/` (`sync_theme.py`) | Service local qui relit les réglages et le fond d'écran toutes les quatre secondes et applique la palette à Windows Terminal et à CMD. | + +Instance unique : un mutex `Local\PanneauxGlassV5` et des événements nommés (afficher, quitter, restaurer la barre) permettent aux relances de signaler l'instance déjà active. + +## Flux de données + +1. `Program.Main` lit la ligne de commande une seule fois et fabrique un `RunOptions` immuable (mode de lancement normal, revue ou vérification). +2. Le `Coordinator` charge les réglages (`Store`, `Core/Models.cs`), crée les fenêtres WPF et, en mode Qt, le `QtShellBridge`. +3. Le pont démarre le frontend (rattaché à un Job Object : il meurt avec le backend) et ouvre le tube `PanneauxCaelestia`. +4. Le frontend envoie `{command, args}` ; le pont répond par l'état complet, les évènements en file, un éventuel message et des listes ponctuelles. +5. Chaque commande est traitée par une méthode `[BridgeAction("nom")]` (`Bridge/QtShellBridge.Actions.*.cs`). Un test de contrat vérifie que le schéma et les handlers coïncident. +6. Dans l'autre sens, le backend pousse des évènements (`Send("…")`) que le frontend récupère à son prochain échange ; le minuteur de 500 ms échantillonne audio, réseau et télémétrie seulement quand une page les affiche. +7. Les réglages persistent dans `%LOCALAPPDATA%\Panneaux` ; les outils externes (terminal, Fichiers) les relisent. + +## Découpage des gros fichiers + +`Coordinator` et `QtShellBridge` sont des classes partielles découpées par domaine : `Coordinator..cs` (Shell, Tools, Views, Layout, Boards, Preview, Palette, Feedback, Dialogs, Desktop, Catalogue) et `QtShellBridge..cs` (Frontend, Pipe, Cli, Sampling, Icons, State, Actions). Aucun fichier `Coordinator.*` ne dépasse 350 lignes ; les fichiers sources restent sous 500 lignes. + +Le Coordinator ne fait plus qu'orchestrer. Les collaborateurs vivent dans `Core/Services/` derrière des interfaces : + +- `ShellState` : état partagé (ouvert, replié, détaillé, dialogue ouvert, épinglé…) lu par le Coordinator, le dialogue et la boucle d'horloge. +- `IDialogService` (`Scope`, `ScopeAsync`, `Layers`, `Confirm`, `Message`, `PickFiles`, `PickFolder`) : portée des dialogues modaux. +- `ILaunchService` (`Launch`, `Reveal`, `LaunchTarget`, `LaunchShortcut`, `WebSearch`, `AddPath`, `Rescue`) et `LaunchRules` (décisions pures). +- `ITickController` (`Tick`) : poignée latérale et repli automatique ; `TickRules` garde les seuils. +- `IShortcutBindings` : libellés, états, réaffectation et aiguillage des raccourcis globaux (`Resolve` renvoie un `HotkeyAction`). +- `QuickTabRules` (cibles `glass:`), `LayoutRules` (disposition des panneaux) et `ShellChrome` (construction de la poignée et de la barre d'outils). +- `ICatalogueService`, `IDesktopIconsService`, `ITrayService`, `IPreviewExportService` : catalogue, icônes du Bureau, zone de notification, export d'aperçu. + +Les règles pures (`*Rules`) sont testées dans `tests/Winlestia.Tests` sans fenêtre ni processus. + +## Winjets (frontend) + +Spécification : `docs/WINJETS-DESIGN.md`. Le backend publie `state.winjets` ; le frontend ne fait que l'afficher et renvoyer des actions `winjets.*`. + +- `bridge_winjets.py` : objet `Bridge.winjets` (seule propriété ajoutée au Bridge). Fonctions pures testées : clé d'écran, géométrie relative à la zone de travail, rééchelonnage et clamp, repli sur l'écran principal (`recovered`), première place libre, aimantation (`snap_move`, `snap_resize`, seuil 8, grille 8, marge 16). +- `winjet_expr.py` : gabarits `{{ }}`, filtres et conditions, sans `eval` ni `Qt.createQmlObject` : le contenu d'un paquet n'est jamais du code. +- `desktop_layer.py` (ctypes) : style `WS_EX_TOOLWINDOW|WS_EX_NOACTIVATE`, fond de pile tenu par `WM_WINDOWPOSCHANGING` (filtre natif), `SetWinEventHook(EVENT_SYSTEM_FOREGROUND)` pour « Afficher le bureau », réapplication au redémarrage d'Explorer et aux changements d'écran. Ni minuteur de scrutation ni hook souris. `desktop_glass.py` pose le verre natif par carte. +- `qml/winjets/` : `WinjetLayer` (une `WinjetWindow` par instance, `EditOverlay` par écran en édition), `WinjetCard` (voile de palette, liseré, habillage d'édition), `WinjetRenderer` (choix de la mise en page selon la taille réelle) et `BlockNode` (types de blocs d'une liste fermée, chargés par URL). Réglages d'une instance : `WinjetSettingsForm`, dans Réglages > Winjets (`settings/PageWinjets.qml`). +- Tests : `tests/test_winjet_expr.py`, `tests/test_winjet_geometry.py`, `tests/test_winjets_qml.py` (hors écran, vrais paquets). + +## Où lire la suite + +- Carte des dossiers du backend : `src/backend/README.md`. +- Contrat du pont : `docs/BRIDGE.md` et `docs/bridge-schema.json` (test : `tests/Winlestia.Tests/BridgeContractTests.cs`). +- Règle de threading (thread UI, tâches, sondes) : `docs/THREADING.md`. +- Restauration de la barre des tâches, du bureau et du terminal : `docs/RESTORE.md`, `docs/TROUBLESHOOTING.md`. +- Explorateur natif : `docs/NATIVE-EXPLORER.md`. Raccourcis : `docs/SHORTCUTS.md`. +- Tests et commandes de vérification : `docs/TESTS.md`. +- Installation et désinstallation : `docs/INSTALL.md`. diff --git a/docs/AUTO-PALETTE-PROGRESS.md b/docs/AUTO-PALETTE-PROGRESS.md deleted file mode 100644 index b905635..0000000 --- a/docs/AUTO-PALETTE-PROGRESS.md +++ /dev/null @@ -1,7 +0,0 @@ -# Auto palette progress (DONE, not deployed) -- chromatic_palette.py rewritten: analyze_images(paths,key) -> seeds/lightness/colorfulness; palette_from_images(); generate_palette() kept as wrapper. -- Pipeline: pool pixels (<=96px per frame) -> 5-bit histogram -> deterministic weighted k-means (24, OKLab) -> HCT per cluster -> MCU-style score + 15deg hue dedup -> seed gets chroma of its hue family (dark bulk is low chroma, accents lift it). -- Scheme: own MD3 tonal assembly (primary C boosted from seed; secondary same hue lower C; tertiary = 2nd seed if >=40deg else hue+60; neutral tinted by primary), tones MD3 (dark surface 6, containers 4/10/12/17/22), contrast guard. -- Light/dark from area-weighted L* with hysteresis (>=62 light, <=50 dark, band keeps previous, default dark). frontend.py `dark` property now follows theme in auto mode. -- Tests: src/frontend/tests/test_chromatic_palette.py (11 OK). Timing 8x320px: 10.8 ms median; 1 image 4.5 ms. -- Sheets in scratchpad: palette-.png. Not verified: live shell with light auto palette, glass over light wallpapers. diff --git a/docs/BRIDGE.md b/docs/BRIDGE.md new file mode 100644 index 0000000..6597ee2 --- /dev/null +++ b/docs/BRIDGE.md @@ -0,0 +1,197 @@ +# Pont backend C# <-> frontend PySide6 + +Contrat du canal entre `src/backend/Bridge/QtShellBridge*.cs` (serveur ; un handler `[BridgeAction("nom")]` par action, dans `QtShellBridge.Actions.*.cs`) et `src/frontend/bridge_client.py` (client). Version du protocole : **1** (`QtShellBridge.ProtocolVersion`, `bridge_client.PROTOCOL_VERSION`). La forme lisible par machine est `docs/bridge-schema.json` ; les tests `BridgeContractTests` (xUnit) et `tests/test_bridge_contract.py` (pytest) vérifient par extraction statique que chaque message émis ou traité y figure. + +## Cadrage + +- Canal nommé Windows `\\.\pipe\PanneauxCaelestia`, octets, un seul client, `CurrentUserOnly`. +- JSON UTF-8, **une ligne par message** terminée par ` +`. Requête client > 131072 octets : connexion fermée ; réponse lue côté client jusqu'à 8 Mio. +- Mode **requête/réponse strict** : le client écrit une requête, le serveur répond exactement une ligne. Le serveur n'écrit jamais de lui-même ; les notifications passent par la file `events` de la réponse suivante. +- Le client interroge en boucle (`state` toutes les 180 ms visible, 500 ms sinon, 1 s en mode silencieux ; `visualizer` 55 ms ; `audioBars` 33 ms) et intercale les commandes utilisateur. + +## Poignée de main / version + +Pas de message dédié : chaque requête porte `args.protocol` (entier). Au **premier message de chaque connexion**, le serveur compare à `ProtocolVersion` et écrit un avertissement dans le journal (`Qt IPC: version de protocole différente ...`) en cas de divergence ou d'absence (client ancien). La connexion n'est jamais refusée ; les commandes inconnues sont ignorées silencieusement. Un client récent sur un serveur ancien ne reçoit rien de plus (champ ignoré). + +## Requête (client -> serveur) + +`{"command": nom, "args": {...}}`. Les champs d'`args` absents prennent la valeur par défaut du serveur (`""`, `0`, `false`). Le client fusionne dans **chaque** requête l'abonnement courant : + +`pid:number, epoch:number, protocol:number, visible:boolean, page:number, dock:boolean, controls:boolean, mixer:boolean, wifi:boolean, bars:boolean` + +`pid` (processus du frontend), `epoch` (compteur de navigation ; les évènements `close` d'une époque révolue sont écartés), `visible/page/dock/controls/mixer/wifi/bars` (ce que le frontend affiche, pilote l'échantillonnage). `seq` n'est utile qu'à `audioBars`. + +Cas spéciaux traités avant le `switch` : `dictation` (renvoie `{"dictation": {state, level, levels, lang, text, error}}`), `audioBars` (`{"audioBars": {seq, idle, bars}}`), `visualizer` (`{"spectrum": [..]}`). Toutes les autres commandes renvoient la réponse générale. + +### Commandes + +| Commande | Champs `args` | Requis | +|---|---|---| +| `activate` | hwnd:number, id:string | hwnd | +| `addAccess` | board:string | - | +| `addFolder` | board:string | - | +| `audio` | - | - | +| `audioBars` | seq:number | - | +| `bookmarksBrowser` | id:string | - | +| `bookmarksDeleteInBrowser` | confirmSync:boolean, id:string | - | +| `bookmarksHide` | id:string | - | +| `bookmarksItems` | - | - | +| `bookmarksOpen` | id:string | - | +| `bookmarksRefresh` | ifDirty:boolean | - | +| `bookmarksUnhideAll` | - | - | +| `brightness` | id:string, value:number | - | +| `capture` | - | - | +| `captureExport` | path:string | path | +| `captureShortcutMode` | enabled:boolean | - | +| `clipboard` | - | - | +| `clipboardCopy` | id:string | - | +| `clipboardFiles` | paths:array | - | +| `clipboardPin` | id:string | - | +| `copyText` | text:string | text | +| `customTheme` | colors:object, glass:boolean, opacity:number | - | +| `desktopClose` | index:number | - | +| `desktopNew` | - | - | +| `desktopSwitch` | index:number, relative:number | - | +| `deviceMute` | id:string, muted:boolean | - | +| `deviceSelect` | id:string | - | +| `deviceVolume` | id:string, value:number | - | +| `dictation` | - | - | +| `dictationCapture` | enabled:boolean | - | +| `dockApp` | action:string, confirmed:boolean, hwnd:number, id:string, index:number | - | +| `dockLayout` | bar:array, drawer:array | - | +| `dockPreview` | cx:number, cy:number, dpr:number, id:string, x:number, y:number | - | +| `dockPreviewEnd` | now:boolean | - | +| `edit` | id:string | - | +| `editEntry` | category:string, id:string, name:string | - | +| `emptyRecycleBin` | - | - | +| `entryIcon` | id:string, path:string | - | +| `explorerFolder` | - | - | +| `explorerOpen` | - | - | +| `explorerPalette` | accent:string, background:string, text:string | - | +| `explorerReport` | - | - | +| `explorerRestore` | - | - | +| `favorite` | id:string | - | +| `fileCancel` | - | - | +| `fileOpen` | gen:number, index:number | index | +| `fileResults` | - | - | +| `fileSearch` | gen:number, term:string | term | +| `icon` | id:string | - | +| `launch` | id:string | - | +| `locate` | - | - | +| `lockNow` | - | - | +| `lockSetPassword` | current:string, password:string | - | +| `lockSettings` | enabled:boolean, idleSeconds:number | - | +| `lockShown` | - | - | +| `lockUnlock` | password:string | - | +| `lyrics` | album:string, artist:string, duration:number, key:string, title:string | title | +| `masterMute` | muted:boolean | - | +| `media` | action:string, value:number | - | +| `mediaVolume` | value:number | - | +| `microphone` | - | - | +| `move` | board:string, id:string | - | +| `openFiles` | - | - | +| `overviewAct` | action:string, hwnd:string | - | +| `overviewWindows` | - | - | +| `palette` | - | - | +| `paletteRun` | id:string, kind:string, query:string | - | +| `preference` | enabled:boolean, key:string, value:string | key | +| `profiles` | - | - | +| `quit` | - | - | +| `quickToggle` | enabled:boolean, id:string | - | +| `openBluetooth` | - | - | +| `peripheralKind` | id:string, kind:string (`auto` retire la surcharge) | - | +| `peripheralVisibility` | id:string, visible:boolean | - | +| `peripheralsRefresh` | - | - | +| `radio` | kind:string | - | +| `raiseMedia` | - | - | +| `recycleFiles` | paths:array | - | +| `refreshCatalogue` | - | - | +| `restoreTaskbar` | - | - | +| `reveal` | id:string | - | +| `runningRefresh` | - | - | +| `sensorsInstall` | driver:boolean | - | +| `sensorsRemove` | - | - | +| `sessionMute` | id:string, muted:boolean | - | +| `sessionVolume` | id:string, value:number | - | +| `settings` | section:string | - | +| `shortcut` | combo:string, id:any, key:number, kind:string, modifiers:number | - | +| `shortcut-reset` | id:string | - | +| `socialEnable` | enabled:boolean, id:string | - | +| `socialGlobalMute` | muted:boolean | - | +| `socialHistoryClear` | - | - | +| `socialHistoryRemove` | seq:number | seq | +| `socialLogin` | id:string | - | +| `socialLogout` | id:string | - | +| `socialMute` | id:string, muted:boolean | - | +| `socialOpen` | id:string | - | +| `socialSound` | enabled:boolean | - | +| `socialTestSound` | - | - | +| `socialVolume` | value:number | - | +| `state` | - | - | +| `systemAction` | confirmed:boolean, id:string | - | +| `theme` | dark:boolean, mode:string | - | +| `toolRun` | id:string | - | +| `tools` | - | - | +| `visualizer` | - | - | +| `volume` | value:number | - | +| `wallpaperApply` | display:number, path:string | path | +| `wallpaperCapture` | h:number, token:string, w:number, x:number, y:number | - | +| `wallpaperChanged` | - | - | +| `wallpaperPicker` | - | - | +| `website` | id:string | - | +| `websites` | - | - | +| `wifiConnect` | password:string, ssid:string | ssid | +| `wifiForget` | ssid:string | ssid | +| `wifiPortal` | - | - | +| `wifiSettings` | page:string | - | +| `windowList` | - | - | +| `winjets.inspect` | path:string | - | +| `winjets.import` | path:string | - | +| `winjets.uninstall` | packageId:string | - | +| `winjets.add` | packageId:string, screen:string, x:number, y:number | - | +| `winjets.remove` | instanceId:string | - | +| `winjets.setHidden` | instanceId:string, hidden:boolean | - | +| `winjets.setOpacity` | instanceId:string, opacity:number|null | - | +| `winjets.setGeometry` | instanceId:string, geometry:object | - | +| `winjets.setSettings` | instanceId:string, settings:object | - | +| `winjets.setState` | instanceId:string, key:string, value:any | - | +| `winjets.setEditMode` | enabled:boolean | - | +| `winjets.refresh` | instanceId:string | - | +| `winjets.recoverAll` | - | - | +| `workspace` | id:string | - | +| `zipFiles` | paths:array | - | + +### Clés de `preference` + +`args.key` choisit la préférence ; `enabled` (booléen) ou `value` (nombre / chaîne) porte la valeur. Clés : `accentBorders`, `activeBorderOnly`, `autoTile`, `autostart`, `bookmarksRailVisible`, `clipboardHistory`, `clipboardImages`, `clipboardLimit`, `customGlassOpacity`, `desktopIndicator`, `desktopLogo`, `dictationEnabled`, `dictationKey`, `dockDrawerOpen`, `dockVisible`, `dockWidth`, `explorerTheme`, `filesDefaultHandler`, `filesPreload`, `frameThickness`, `glassOpacity`, `iconSize`, `lyrics`, `motion`, `osd`, `peripheralBattery`, `pill`, `quietFullscreen`, `reducedEffects`, `replaceTaskbar`, `screenFrame`, `socialBackground`, `socialRailVisible`, `taskbar`, `tileExclusionRemove`, `topActivationMargin`. Le détail des champs par clé est dans le schéma (`preferenceKeys`). + +## Réponse générale (serveur -> client) + +`{"state", "events", "notice", "wallpaperCapture", "bookmarksItems", "windows", "fileResults", "lyrics", "wallpaperPicker"}` ; les clés `null` sont émises telles quelles. + +- `state` : objet instantané, clés de premier niveau : `systemRecent`, `wallpapers`, `wallpaperRevision`, `audioReadMs`, `audioMixer`, `quickTabs`, `social`, `bookmarks`, `settings`, `clipboard`, `diagnostics`, `dark`, `taskbarEnabled`, `networkKind`, `virtualDesktops`, `fullscreenMonitors`, `quiet`, `quietForced`, `performance`, `sysInfo`, `media`, `controls`, `quick`, `lock`, `apps`, `favorites`, `recent`, `launchCounts`, `websites`, `profiles`, `taskbarApps`, `runningApps`, `icons`, `iconRevision`, `winjets`, `desktop`, `peripherals`. `lock` : `{locked, failures, retryAfter, passwordResult, passwordSeq}` (`passwordResult` : `""`, `"ok"`, `"wrong"`, `"invalid"` ; `settings.lock` : `{enabled, hasPassword, idleSeconds}` ; ni mot de passe ni empreinte ne sortent jamais ; `retryAfter` = secondes restantes ; le client envoie `lockShown` dès sa fenêtre visible, sinon le verrou est levé après 8 s ; le raccourci de secours lève le verrou, c'est un verrou de shell et non une frontière de sécurité). `quick` : `{wifi, bluetooth, airplane, micMute, keepAwake}`, chacun `{available, on}` (cache alimenté par évènements, jamais d'appel système dans l'instantané) ; `settings.sensors` : `{state, driver, outdated, available, result}` (`state` : `"absent"`, `"noDriver"`, `"stopped"`, `"active"` ; `result`, issue de la dernière action : `""`, `"ok"`, `"reboot"`, `"declined"`, `"failed"`, `"busy"` ; état en cache 10 s, `sensorsInstall {driver}` et `sensorsRemove` lancent l'assistant élevé hors du fil du pont et émettent `sensors` au début et à la fin) ; `peripherals` : `{enabled, devices:[{id, name, kind, percent, charging, approximate, hidden, source}], paired:[{id, name, kind, detectedKind, overridden, connected, percent}]}` (`id` : `bt:` / `xinput:` / `hid::` / `system:battery` ; `source` : `bluetooth`, `ble`, `xinput`, `hid`, `system` ; `kind` : `headset`, `gamepad`, `mouse`, `keyboard`, `other`, `laptop` (batterie de l'ordinateur, nom vide, jamais surchargeable) ; `charging` peut être `null` ; `devices` = connectés avec batterie connue, masqués inclus avec `hidden` ; cache alimenté par un sondage de 60 s actif seulement dock affiché et fonction activée, `settings.peripheralBattery` en est l'interrupteur) ; `settings.dockBar` et `settings.dockDrawer` : identifiants ordonnés des éléments du dock (barre / tiroir), écrits par `dockLayout`. Le contenu des sous-objets est libre (lu avec `.get` côté Python, donc tolérant aux champs manquants) et n'est pas figé par ce contrat. +- Éléments de `runningApps` : en plus de `id`, `name`, `path`, `hwnd`, `pinned`, `favorite`, `background`, `canStop`, `count`, `active` et `windows`, chaque élément porte `cpu` (nombre, un chiffre après la virgule, % de la machine entière), `mem` (entier, Mo de jeu de travail privé, comme la colonne « Mémoire » du Gestionnaire des tâches ; repli sur la mémoire privée validée si la lecture globale est indisponible) et `procs` (entier, nombre de processus regroupés sous ce chemin). Ces trois champs ne sont mesurés que sur l’action `runningRefresh` ; hors de la fenêtre « Applications », ils gardent leur dernière valeur. Un élément à pseudo-chemin (application empaquetée) a `0`, `0`, `0`. +- `events` : tableau de chaînes, vidé à chaque réponse (32 maximum en file). +- `notice` : texte à afficher une fois (erreur ou confirmation). +- `wallpaperCapture`, `bookmarksItems`, `windows`, `fileResults`, `lyrics`, `wallpaperPicker` : réponses ponctuelles aux commandes homonymes. `lyrics` : `{state, lines, plain, key}` ; la commande ne bloque jamais sur le réseau : elle répond `loading` tant que la recherche (LRCLIB, hors du canal) court, puis l'évènement `lyrics` invite le client à renvoyer la commande pour lire le résultat. + +### Évènements (`events`) + +Exacts : `toggle`, `access`, `media`, `performance`, `controls`, `palette`, `settings`, `settings:social`, `settings:bookmarks`, `clipboard`, `audio`, `microphone`, `tools`, `capture`, `capture-ocr`, `capture-select`, `wallpaper-switcher`, `overview`, `close`, `bookmarks`, `social`, `files`, `lyrics`, `quick`, `lock`, `sensors`, `dock`, `desktop.explorerRestarted`, `dictation:start`, `dictation:stop`, `dictation:keycancel`. +Préfixes (suffixe variable) : `workspace:`, `osd:volume:`, `osd:brightness:`, `shortcut-key:`, `shortcut-saved:`, `osd:mic:`, `dictation:key:` — `workspace:`, `osd:volume::`, `osd:brightness:`, `osd:mic::`, `shortcut-key::`, `shortcut-saved:`, `dictation:key:`. +Évènements gérés côté client seulement (jamais émis par le serveur actuel) : `mixer`. + +### Winjets + +Actions `winjets.*` (voir `docs/WINJETS-DESIGN.md` §4), état `state.winjets` (`editMode`, `packages`, `instances`, `data`, `lastImport`) et `state.desktop.explorerEpoch` (compteur incrémenté à chaque redémarrage d'Explorer, avec l'évènement `desktop.explorerRestarted`). + +### Position (`locate`, `state.location`) + +Action `locate` (sans argument) : demande la position Windows (Windows.Devices.Geolocation, précision par défaut, délai de 5 s) au service de position, une seule lecture à la fois. Rien n'est lu en arrière-plan : seul `locate` déclenche une lecture. Un succès est gardé 30 min (un nouvel appel dans ce délai ne relit pas) ; un échec peut être réessayé après 1 min. Le résultat est publié dans `state.location` = `{lat, lon, accuracyM, ok, requested}` (`lat`/`lon` arrondis à 3 décimales, `accuracyM` en mètres) ; `requested` vaut `false` tant qu'aucune tentative n'a abouti ou échoué, `true` ensuite (succès ou échec) ; `ok` vaut `false` tant que rien n'a été lu et en cas d'accès refusé, de service de localisation désactivé ou de délai dépassé (alors `lat`, `lon` et `accuracyM` valent 0). + +## Faire évoluer le contrat + +1. Ajouter le message dans `docs/bridge-schema.json` et ce document. +2. Changer d'incompatibilité (champ retiré, sens modifié) : incrémenter `ProtocolVersion` et `PROTOCOL_VERSION` ensemble (un test vérifie qu'ils sont égaux au schéma). +3. Ajouter un champ optionnel ou une commande ne change pas la version. diff --git a/docs/BUILD-AND-TEST.md b/docs/BUILD-AND-TEST.md deleted file mode 100644 index e56ed42..0000000 --- a/docs/BUILD-AND-TEST.md +++ /dev/null @@ -1,74 +0,0 @@ -# Build and test - -Requirements: Windows 11 x64, .NET SDK 8.0.x, Python 3.12, PowerShell 7, Inno Setup 6 (installer only), MSVC only -to rebuild the native helpers. Commands below come from `installer/build.ps1` and the `.csproj` files. - -## Backend - -`src/backend/Panneaux.Glass.csproj`: `net10.0-windows10.0.19041.0`, WPF + WinForms, `win-x64`, version in ``. - -```powershell -dotnet build src\backend\Panneaux.Glass.csproj -c Release -dotnet publish src\backend\Panneaux.Glass.csproj -c Release -r win-x64 --self-contained true ` - -p:PublishSingleFile=false -p:DebugType=none -p:DebugSymbols=false -o build\dev\Glass-v5 -``` - -Other .NET projects (the installer publishes all three into the same `Glass-v5` folder): - -```powershell -dotnet publish src\files\Winlestia.Files.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=false -o build\dev\Glass-v5 -dotnet publish src\cli\winlestia.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:PublishTrimmed=true -o build\dev\Glass-v5 -``` - -## Native helpers - -`GlassBackdrop.dll`, `ProcessAudio.dll`, `SECOURS_BUREAU.exe`, `RETABLIR_BARRE_WINDOWS.exe` are not produced by -`dotnet publish`. Rebuild with MSVC from `src\backend`: `build-backdrop.cmd`, `build-process-audio.cmd`, -`build-rescue.cmd`, `build-taskbar-rescue.cmd`; results live in `src\backend\native\` (git-ignored, see its -`README.md`). `installer\build.ps1` stops if `RETABLIR_BARRE_WINDOWS.exe`, `SECOURS_BUREAU.exe` or -`GlassBackdrop.dll` is missing there. - -## Frontend (development) - -```powershell -python -m venv src\frontend\.venv -src\frontend\.venv\Scripts\pip install -r src\frontend\requirements.txt -``` - -Pinned in `src/frontend/requirements.txt`: PySide6 6.10.3, material-color-utilities, numpy, Pillow. The shipped -build uses embedded Python 3.12.10 (`$pythonVersion` in `installer/build.ps1`). - -## Installer - -```powershell -pwsh installer\build.ps1 -``` - -Steps: clean `build\payload`, publish backend/Files/CLI into `build\payload\Glass-v5`, copy native files and -`Inventory.ps1`, copy `src\frontend` to `build\payload\Caelestia-Windows`, unpack embedded Python into -`.venv\Scripts`, `pip install --target` the requirements, prune unused Qt modules, verify the runtime and -frontend import, copy `src\terminal`, then run `ISCC.exe installer\Winlestia.iss`. - -Output: `build\out\Winlestia-Setup-.exe` (`OutputDir=..\build\out` in `installer/Winlestia.iss`; the -version is `AppVersion` there and `` in the csproj; the final `Write-Host` in `build.ps1` also hard-codes -it). For a neutral release build follow the comment header of `installer/build.ps1` (build from a path without a -user name). - -## Tests - -Each `tests/` folder is a console project that links the source files it checks and prints `TOTAL x/y`. - -```powershell -dotnet run --project tests\WifiPolicy -c Release -``` - -Run only the project matching your change. Known issue: `tests/FullscreenWatcher` does not terminate. -Set `WINLESTIA_DATA_DIR` to a throwaway folder first so nothing touches `%LOCALAPPDATA%\Panneaux`: - -```powershell -$env:WINLESTIA_DATA_DIR = "$env:TEMP\winlestia-test" -``` - -Python checks: `tests\*.py` and `src\frontend\tests\*.py` (some need a running shell or a Qt display; read the -script header first). QML lint: `qmllint` from the PySide6 install, for example -`src\frontend\.venv\Scripts\pyside6-qmllint.exe -I src\frontend\qml `. diff --git a/docs/CODE-SIGNING.md b/docs/CODE-SIGNING.md new file mode 100644 index 0000000..c7da4dc --- /dev/null +++ b/docs/CODE-SIGNING.md @@ -0,0 +1,270 @@ +# Signature de code pour Winlestia + +Document de travail rédigé le 17 novembre 2026. Les prix et conditions changent souvent : chaque chiffre est daté et sourcé. Les points marqués **[non vérifié]** n'ont pas pu être confirmés sur une source officielle à cette date. + +Contexte : Winlestia est distribué par un développeur individuel en France (pas de société), sous licence GPL-3.0. Le nouvel installateur `WinlestiaSetup.exe` (WPF, .NET 8) n'est pas signé ; Windows affiche « Windows a protégé votre ordinateur » et « Éditeur : inconnu ». + +--- + +## 1. Résumé + +**Ce que la signature change, et ce qu'elle ne change pas.** Signer remplace « éditeur inconnu » par un nom vérifié et garantit que le fichier n'a pas été modifié. Elle **ne supprime pas** à elle seule l'écran SmartScreen : depuis 2024, aucun certificat (même EV) ne donne de réputation immédiate. La réputation s'accumule avec les téléchargements sans incident, sur le hash du fichier et sur l'identité du certificat. Microsoft parle de « plusieurs semaines et centaines d'installations propres ». + +**Ordre conseillé :** + +1. **SignPath Foundation (gratuit)** si le projet passe l'examen. Plusieurs points du dépôt sont à régler avant de candidater (voir 4.1) : build de release sur GitHub Actions, binaires tiers non signables par SignPath, statut des fonds d'écran. L'éditeur affiché sera « SignPath Foundation », pas votre nom ni « Winlestia ». +2. **Azure Artifact Signing (ex-Trusted Signing) : non disponible pour vous.** La documentation Microsoft (mise à jour le 17/11/2026) limite les particuliers aux États-Unis et au Canada. Un particulier en France ne peut pas faire valider son identité. À réévaluer si Microsoft ouvre l'UE aux particuliers, ou si vous créez une structure (les organisations de l'UE sont acceptées). +3. **Certum Open Source Code Signing** comme solution de repli, ou en attendant SignPath. Ce certificat est réservé aux personnes physiques, ce qui correspond à votre situation. Prix constatés sur la boutique Certum le 17/11/2026 : 49 € TTC (clé dans le cloud SimplySign) ou 69 € TTC (carte à puce + lecteur). L'éditeur affiché sera « Open Source Developer, ». +4. **Microsoft Store : pas une voie réaliste à court terme** pour un shell qui remplace la barre des tâches (voir 4.4). Le chemin MSIX (signé gratuitement par Microsoft) demande `runFullTrust`, une capacité restreinte soumise à approbation. Le chemin EXE/MSI exige de toute façon un installateur déjà signé par vous. +5. **winget** : aucune signature exigée par la politique du dépôt. C'est utile en complément, mais SmartScreen peut quand même avertir à l'exécution. + +**Coûts annuels estimés :** + +| Option | Coût annuel | Délai de mise en place | +|---|---|---| +| SignPath Foundation | 0 € | Examen manuel, durée non publiée **[non vérifié]**, compter plusieurs semaines | +| Certum Open Source, cloud | 49 € TTC/an (boutique, 17/11/2026) | Quelques jours ouvrés après envoi des pièces **[délai non vérifié]** | +| Certum Open Source, carte | 69 € TTC la 1re année, carte et lecteur compris ; renouvellement moins cher **[non vérifié]** | Idem, plus la livraison depuis la Pologne | +| Azure Artifact Signing | ~9,99 $/mois, soit ~120 $/an (~110 €) **[conversion approximative]** | Inaccessible aux particuliers en France | +| OV classique (Sectigo, DigiCert, SSL.com…) | 150 à 300 $/an selon Microsoft ; plus un token ou un abonnement de signature cloud | Plusieurs jours ouvrés | +| EV | 400 $/an et plus ; aucun avantage SmartScreen depuis 2024 | Non pertinent | + +--- + +## 2. Règles en vigueur en 2026 + +- **Clé privée sur matériel.** Depuis juin 2023, les exigences de base du CA/Browser Forum imposent que la clé privée d'un certificat de signature de code OV soit stockée sur un HSM ou un token matériel (FIPS 140-2 niveau 2 / Common Criteria EAL4+). Il n'est plus possible de recevoir un fichier `.pfx` à garder sur disque. Les options sont : token USB, carte à puce, HSM cloud (SimplySign, eSigner, Azure Key Vault…) ou service géré (Azure Artifact Signing, SignPath). +- **Durée maximale.** Le ballot CSC-31 (Code Signing Baseline Requirements v3.10.0, adopté le 17/11/2025) ramène la durée maximale d'un certificat de signature de code à **460 jours**, pour tout certificat émis à partir du 1er mars 2026. Les certificats émis avant gardent leur échéance. Certaines AC appliquent un plafond légèrement inférieur : SSL.com indique 458 jours à partir du 27/02/2026, Certum 459 jours. Concrètement, il faut renouveler chaque année. +- **Fin de l'avantage EV.** Le programme Microsoft Trusted Root a retiré les OID EV des racines à partir d'août 2024 : « all Code Signing certificates will be treated equally ». Microsoft écrit que payer l'EV « solely to avoid SmartScreen warnings is no longer justified ». +- **Horodatage.** Sans horodatage RFC 3161, une signature devient invalide à l'expiration du certificat. Avec horodatage, elle reste valide. Avec des certificats d'un an, horodater est indispensable. + +--- + +## 3. Tableau comparatif + +| Critère | SignPath Foundation | Azure Artifact Signing | Certum Open Source | OV classique (Sectigo / SSL.com / DigiCert) | Microsoft Store | +|---|---|---|---|---|---| +| Coût | Gratuit | ~9,99 $/mois (Basic : 5 000 signatures/mois) | 49 € (cloud) ou 69 € (carte) TTC, la 1re année | 150 à 300 $/an, plus le token ou la signature cloud (SSL.com eSigner : 20 $/mois par identifiant supplémentaire) | Compte individuel gratuit | +| Particulier en France | Oui : c'est le projet qui est éligible, pas la personne | **Non** (particuliers : USA/Canada seulement) | **Oui**, uniquement pour les personnes physiques | IV (« Individual Validation ») possible chez SSL.com et d'autres **[prix et pièces non vérifiés]** | Oui | +| Nom affiché comme éditeur | « SignPath Foundation » | Votre nom | « Open Source Developer, » | Votre nom | Nom du compte Store | +| Matériel | Aucun (HSM géré par SignPath) | Aucun (géré par Microsoft) | Cloud SimplySign (appli mobile pour les codes) ou carte + lecteur | Token USB FIPS ou HSM cloud | Aucun (MSIX) / certificat requis (EXE/MSI) | +| Effet SmartScreen | Réputation progressive. Partage-t-elle la réputation des autres projets signés par la fondation ? **[non vérifié]** | Réputation progressive | Réputation progressive | Réputation progressive | Pas d'avertissement SmartScreen à l'installation depuis le Store | +| Intégration CI | Native : action GitHub `signpath/github-action-submit-signing-request@v3`, runners hébergés par GitHub obligatoires pour l'OSS | Native : action GitHub, Azure DevOps | Difficile : SimplySign demande un code à usage unique depuis le téléphone ; la carte demande un poste physique | eSigner (SSL.com) automatisable ; token USB = poste physique | Hors sujet | +| Contraintes particulières | Build vérifiable depuis le dépôt, approbation manuelle de chaque release, MFA, politique de signature publiée, aucun binaire tiers | Validation d'identité de 1 à 30 jours ouvrés | Justificatif de domicile, URL du projet | Validation d'identité | `runFullTrust` restreint ; silencieux obligatoire pour EXE/MSI | + +--- + +## 4. Détail par option + +### 4.1 SignPath Foundation + +Conditions (https://signpath.org/terms, consulté le 17/11/2026) : + +- Licence approuvée par l'OSI pour **tous** les composants, sans double licence commerciale ; aucun composant propriétaire. +- Projet maintenu, déjà publié sous la forme à signer, fonctionnalités décrites sur la page de téléchargement. +- Signature réservée aux binaires construits à partir du code du projet, par un build vérifiable. Pour l'open source, tous les jobs du workflow GitHub menant à la demande de signature doivent tourner sur des runners hébergés par GitHub. +- Les bibliothèques amont doivent être signées par leurs propres mainteneurs. +- Approbation manuelle de chaque release ; MFA obligatoire sur SignPath et GitHub ; rôles définis (Authors, Reviewers, Approvers). +- Page « Code signing policy » publiée sur la page d'accueil et la page de téléchargement, avec la mention SignPath, les rôles et une déclaration sur la vie privée. +- Respect de l'utilisateur : annoncer les modifications système et fournir une désinstallation. Un shell qui remplace la barre des tâches modifie le système : l'installateur doit le dire clairement et la désinstallation doit tout restaurer. +- Logiciels malveillants, PUP et outils d'intrusion exclus. La fondation n'accepte aucune responsabilité. + +**Points à régler dans le dépôt avant de candidater** (constatés le 17/11/2026) : + +- Les releases sont construites en local (`installer/build.ps1`, `installer/Deploy-Local.ps1`). `.github/workflows/ci.yml` ne fait que build et test. Il faut un workflow de release qui produise `WinlestiaSetup.exe` et le payload sur `windows-latest`. +- Le payload contient des binaires tiers : runtime Python/PySide6/Qt, `clink_x64.exe` (ajouté à la construction, ignoré par git). SignPath ne les signera pas. Seuls les binaires construits depuis vos sources (backend .NET, DLL natives `src/backend/*.cpp`, installateur) peuvent l'être. Les binaires tiers restent avec leur signature d'origine, ou sans signature s'ils n'en ont pas **[état de signature des DLL Qt/PySide non vérifié]**. +- `THIRD_PARTY_NOTICES.md` indique que les fonds d'écran de `assets/wallpapers/` ne sont pas couverts par la GPL et que leur licence n'est pas établie. Ce point risque de faire échouer la condition « licence OSI pour tous les composants », et c'est de toute façon un risque juridique à part. Mieux vaut le régler avant de candidater : retirer ces images ou les remplacer par des images sous licence libre. +- Développeur seul : un même compte peut-il tenir les rôles Author, Reviewer et Approver ? **[non vérifié]** + +Délai : non publié. Le formulaire est sur https://signpath.org/apply (la page n'a pas pu être lue en détail). + +### 4.2 Azure Artifact Signing (ex-Trusted Signing) + +- Nom actuel : « Artifact Signing » (documentation `learn.microsoft.com/azure/artifact-signing`, service GA pour les organisations USA/Canada/Europe en janvier 2026 selon DevClass). +- Éligibilité, citation de la page de démarrage rapide (ms.date 21/05/2026, mise à jour le 17/11/2026) : « Public Trust certificates are available to organizations in the United States, Canada, the European Union, the United Kingdom, […]. Individual developers must be located in the United States or Canada. » Un fil Microsoft Q&A de mars 2026 confirme qu'un développeur français n'a pas pu choisir la France dans le formulaire « Individual ». +- Prix : ~9,99 $/mois selon la page Microsoft « Code signing options » (ms.date 29/10/2026). La page de tarification Azure affiche des valeurs vides ce jour-là ; seuls les quotas sont lisibles (Basic : 5 000 signatures/mois et 1 profil de chaque type ; Premium : 100 000 signatures/mois). Facturation dès la création du compte. Le prix exact en euros n'a pas pu être lu **[non vérifié]**. +- SmartScreen : pas de confiance immédiate ; la réputation de l'éditeur se construit sur les versions successives. +- Conclusion : **inaccessible tant que vous restez un particulier en France.** Une micro-entreprise compte-t-elle comme « organization » ? La validation « Organization » demande un identifiant d'entreprise, un domaine et une adresse e-mail sur ce domaine. L'acceptation d'un entrepreneur individuel n'est pas confirmée ; un témoignage sur le forum JUCE parle de refus pour des entreprises individuelles européennes **[non vérifié]**. + +### 4.3 Certum Open Source Code Signing + +- Prix sur la boutique, relevés le 17/11/2026 : « Open Source Code Signing on SimplySign » 49,00 € TTC (5 000 signatures/mois, clé dans le cloud, appli mobile SimplySign + SimplySign Desktop) ; « Open Source Code Signing - set » 69,00 € TTC (carte cryptoCertum 3.7 + lecteur). Une autre page de la boutique affiche « à partir de 359 € » à côté du même produit : affichage ambigu **[non vérifié]**. Durée : 1 an selon des sources tierces, plafond Certum de 459 jours. +- Éligibilité (support Certum, « Code Signing – required documents ») : émis **uniquement à des personnes physiques** ; le demandeur doit être l'abonné ; aucun nom de domaine dans le certificat ; « Open Source Developer » ajouté au CN, champ O = « Open Source Developer ». +- Pièces : vérification d'identité (pièce d'identité, plusieurs méthodes au choix lors de l'activation ; la liste exacte n'a pas été lue **[non vérifié]**), justificatif de domicile à votre nom (facture d'eau, de gaz, d'électricité ou de téléphone), adresse web du projet open source en cours (le dépôt GitHub suffit a priori **[non vérifié]**). Il n'y a plus de vérification par téléphone depuis 2017. +- Limite pour la CI : SimplySign demande un code à usage unique depuis le téléphone pour ouvrir une session. On signe donc sur votre poste au moment de la release. Une automatisation complète dans GitHub Actions n'est pas prévue par Certum **[contournements tiers non évalués]**. + +### 4.4 Microsoft Store + +- Compte développeur individuel gratuit depuis le 10/09/2025 (blog Windows Developer) ; inscription sur https://storedeveloper.microsoft.com. +- **MSIX** : Microsoft re-signe le paquet après certification, gratuitement. Mais une application Win32 empaquetée en MSIX doit déclarer `runFullTrust`, une capacité restreinte qui doit être justifiée lors de la soumission. Le Store accepte-t-il un remplaçant de barre des tâches ou de shell (hooks globaux, masquage de la barre des tâches, démarrage automatique, composants natifs) ? La politique ne le dit pas explicitement **[non vérifié, risque de refus élevé]**. MSIX virtualise aussi une partie du registre et du système de fichiers, ce qui peut gêner un shell. +- **EXE/MSI** (accepté depuis juin 2021) : « The binary and all of its Portable Executable (PE) files must be digitally signed with a code signing certificate that chains up to […] the Microsoft Trusted Root Program ». Microsoft ne re-signe pas. Il faut aussi : une URL versionnée immuable, une installation silencieuse (seule l'invite UAC est tolérée) et un installateur hors ligne. Le Store ne règle donc pas le problème de certificat ; il vient après. + +### 4.5 winget + +La politique de `microsoft/winget-pkgs` (`doc/Policies.md`) n'exige pas de signature Authenticode. Elle exige des URL officielles « discoverable on the publishers website » (une release GitHub convient a priori), des URL uniques par version de préférence, et le passage des analyses de sécurité du pipeline de validation. Un installateur non signé est donc accepté, mais SmartScreen et la Marque du Web s'appliquent toujours selon la façon dont le fichier est téléchargé **[comportement exact avec winget non vérifié]**. + +--- + +## 5. Réputation SmartScreen et faux positifs + +- Deux signaux selon Microsoft : la réputation du **fichier** (hash) et celle de l'**éditeur** (certificat). Sans signature, chaque nouvelle version repart de zéro. Avec une identité stable, la réputation acquise aide les versions suivantes, mais un nouveau build peut encore déclencher l'avertissement tant que son hash ou le certificat n'a pas assez d'historique. Un renouvellement de certificat peut faire perdre une partie de la réputation (témoignages Microsoft Q&A). +- Il n'y a pas de seuil publié : « several weeks and hundreds of clean installs ». +- Bonnes pratiques : signer **chaque** release avec la même identité ; ne jamais modifier un fichier après signature ; éviter de multiplier les builds publics (chaque hash repart à zéro) ; ne pas signer de binaire au comportement douteux, car la réputation négative s'attache au certificat. +- Soumission à Microsoft : https://www.microsoft.com/wdsi/filesubmission. La page Microsoft sur la réputation SmartScreen dit qu'il n'existe pas de mécanisme de soumission pour accélérer la réputation côté grand public. Le formulaire sert à signaler un **faux positif de Microsoft Defender** (détection antivirus), ce qui est un problème différent. À utiliser si Defender détecte `WinlestiaSetup.exe` ou un binaire du payload, en tant que « Software developer ». + +--- + +## 6. Étapes concrètes + +### 6.1 Principes communs (quelle que soit l'option) + +1. **Ce qu'on signe** : `WinlestiaSetup.exe`, les `.exe` et `.dll` du backend .NET (assemblées Winlestia), les DLL et EXE natifs construits depuis `src/backend/*.cpp`, et tout lanceur `.exe` propre au projet. +2. **Ce qu'on ne signe pas** : les binaires tiers (python.exe, DLL Qt/PySide6, `clink_x64.exe`, runtime .NET). Les signer avec votre certificat mettrait votre nom sur du code que vous n'avez pas écrit, et SignPath l'interdit. +3. **Ordre** : signer le payload, puis construire l'installateur qui l'embarque, puis signer l'installateur en dernier. Toute modification après signature casse la signature et la réputation du hash. +4. **Algorithme** : SHA-256 pour le condensat du fichier (`/fd sha256`) et pour l'horodatage (`/td sha256`). +5. **Vérification** : `signtool verify /pa /all /v ` sur chaque fichier signé, dans la CI avant publication. + +### 6.2 Option recommandée : SignPath via GitHub Actions + +Prérequis côté dépôt : workflow de release reproductible sur `windows-latest`, MFA sur GitHub, page « Code signing policy », règlement des fonds d'écran (voir 4.1). + +1. Candidater sur https://signpath.org/apply. Une fois accepté, créer dans SignPath le projet, une *artifact configuration* qui liste les fichiers à signer dans l'archive (vos `.exe`/`.dll` et l'installateur), et une *signing policy* « release » avec approbation manuelle. +2. Stocker `SIGNPATH_API_TOKEN` dans les secrets GitHub. +3. Workflow en deux passes (payload, puis installateur) : + +```yaml +name: release +on: + push: + tags: ['v*'] +jobs: + build: + runs-on: windows-latest # runners hébergés par GitHub exigés pour l'OSS + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-dotnet@v4 + with: { dotnet-version: 8.0.x } + # ... construire le backend, les DLL natives, le payload ... + - id: up-payload + uses: actions/upload-artifact@v4 + with: { name: payload-unsigned, path: out/payload } + - uses: signpath/github-action-submit-signing-request@v3 + with: + api-token: ${{ secrets.SIGNPATH_API_TOKEN }} + organization-id: '' + project-slug: 'winlestia' + signing-policy-slug: 'release' + artifact-configuration-slug: 'payload' + github-artifact-id: ${{ steps.up-payload.outputs.artifact-id }} + wait-for-completion: true + output-artifact-directory: out/payload-signed + # ... construire WinlestiaSetup.exe à partir de out/payload-signed ... + - id: up-setup + uses: actions/upload-artifact@v4 + with: { name: setup-unsigned, path: out/WinlestiaSetup.exe } + - uses: signpath/github-action-submit-signing-request@v3 + with: + api-token: ${{ secrets.SIGNPATH_API_TOKEN }} + organization-id: '' + project-slug: 'winlestia' + signing-policy-slug: 'release' + artifact-configuration-slug: 'installer' + github-artifact-id: ${{ steps.up-setup.outputs.artifact-id }} + wait-for-completion: true + output-artifact-directory: out/signed +``` + +Les entrées `wait-for-completion` et `output-artifact-directory`, l'horodatage automatique par SignPath et la possibilité d'enchaîner deux demandes dans un même job : **[non vérifiés]**, à contrôler dans https://docs.signpath.io/trusted-build-systems/github. Chaque demande attend l'approbation manuelle dans SignPath. + +### 6.3 Repli : Certum Open Source (SimplySign) en local + +1. Commander sur shop.certum.eu, activer le certificat, envoyer les pièces (identité, justificatif de domicile, URL du dépôt). +2. Installer SimplySign Desktop et se connecter avec le code de l'appli mobile : le certificat apparaît dans le magasin personnel Windows. +3. Récupérer l'empreinte SHA-1 du certificat (`certutil -user -store My`), puis signer (signtool du Windows SDK) : + +```powershell +$tsa = 'http://time.certum.pl' # horodateur RFC 3161 de Certum [URL à confirmer sur le site Certum] +$thumb = '' +# 1. payload : fichiers propres au projet uniquement +Get-ChildItem out\payload -Recurse -Include Winlestia*.exe,Winlestia*.dll, | + ForEach-Object { + signtool sign /sha1 $thumb /fd sha256 /tr $tsa /td sha256 /d "Winlestia" /du "https://github.com/lilidoxdev/winlestia" $_.FullName + } +# 2. construire WinlestiaSetup.exe à partir du payload signé, puis : +signtool sign /sha1 $thumb /fd sha256 /tr $tsa /td sha256 /d "Winlestia Setup" /du "https://github.com/lilidoxdev/winlestia" out\WinlestiaSetup.exe +signtool verify /pa /all /v out\WinlestiaSetup.exe +``` + +4. Publier sur GitHub Releases les fichiers **déjà signés**, avec leurs empreintes SHA-256 dans les notes de version. + +--- + +## 7. Signature de code ≠ licence produit + +Les deux notions sont souvent confondues. Elles répondent à des questions différentes. + +| | Signature de code (Authenticode) | Licence produit / activation | +|---|---|---| +| Question | **Qui** a publié ce fichier, et a-t-il été **modifié** depuis ? | **Qui a le droit** d'utiliser, copier ou modifier le logiciel, et à quelles conditions ? | +| Mécanisme | Certificat X.509 émis par une AC après vérification d'identité ; signature cryptographique du hash ; horodatage | Texte juridique (contrat, licence) ; éventuellement clé d'activation ou serveur de licences qui restreint l'exécution | +| Bénéficiaire | L'utilisateur, qui peut vérifier l'origine et l'intégrité ; Windows (SmartScreen, Smart App Control) | L'éditeur, qui contrôle les droits d'usage, souvent pour être payé | +| Effet sur Windows | « Éditeur : » au lieu de « inconnu » ; réputation SmartScreen | Aucun | + +Un certificat ne donne et ne retire aucun droit d'utilisation. Une clé d'activation ne prouve ni l'identité de l'éditeur ni l'intégrité du binaire. + +**Faut-il un système de licence ou d'activation pour Winlestia ? Non.** + +- Le fichier `LICENSE` du dépôt contient la **GNU GPL version 3** (29 juin 2007), et `THIRD_PARTY_NOTICES.md` confirme « Licence de Winlestia : GPL-3.0 ». Ce texte accorde déjà à tout destinataire le droit d'exécuter, d'étudier, de modifier et de redistribuer le logiciel. Il n'y a rien à vendre ni à contrôler. +- La GPL interdit d'imposer des restrictions supplémentaires aux destinataires (articles 7 et 10). Un mécanisme d'activation pourrait être retiré légalement par n'importe qui dans une version modifiée. Il n'aurait donc aucun effet, et il compliquerait la candidature à SignPath (logiciel respectueux de l'utilisateur). +- L'article 9 de la GPL précise qu'il n'est **pas nécessaire d'accepter la licence pour recevoir ou exécuter** le programme. L'écran « Licence » de l'installateur doit donc **informer** (texte GPL-3.0 et lien vers `THIRD_PARTY_NOTICES.md`) et ne pas conditionner l'installation à une case « J'accepte ». Un simple bouton « Suivant » suffit. + +**Obligations envers Caelestia (projet amont).** Le dépôt `caelestia-dots/shell` est sous **GPL-3.0** (fichier `LICENSE` lu sur GitHub le 17/11/2026). Winlestia en est un portage (v1.4.0, voir `THIRD_PARTY_NOTICES.md` et `src/backend/LICENSE-CAELESTIA.txt`), donc une œuvre dérivée. Obligations : + +1. Distribuer Winlestia sous GPL-3.0 (c'est le cas) et joindre le texte de la licence à chaque distribution, installateur compris. +2. Conserver les mentions de copyright de Caelestia et de ses contributeurs (fait dans `THIRD_PARTY_NOTICES.md` ; à reprendre dans l'écran Licence ou dans un fichier installé). +3. Signaler les modifications et leur date (article 5a). C'est couvert par `UPSTREAM.json` / `PORT_PATCHES.json` et l'historique git. +4. Fournir le **code source correspondant** à chaque binaire publié (article 6). Le tag git de la version sur GitHub suffit, à condition qu'il permette réellement de reconstruire le payload. Un workflow de release sur GitHub Actions, utile pour SignPath, rend aussi cette correspondance vérifiable. +5. La signature de code est compatible avec la GPL-3.0. L'obligation de fournir des « Installation Information » (article 6) ne vise que les « User Products » (appareils grand public) et ne s'applique pas à un logiciel distribué pour PC. Vous n'avez pas à publier votre clé de signature. + +Points connexes à traiter séparément : la licence des fonds d'écran (`assets/wallpapers/`, non établie) et les licences des thèmes Clink tiers marquées « non vérifiées » dans `THIRD_PARTY_NOTICES.md`. + +--- + +## 8. Points non vérifiés (récapitulatif) + +- Prix exact d'Azure Artifact Signing en euros (la page de tarification Azure affiche des valeurs vides le 17/11/2026 ; seul le « ~9,99 $/mois » de Microsoft Learn est disponible). +- Éligibilité d'une micro-entreprise française comme « organization » chez Azure. +- Délai d'examen SignPath ; possibilité pour un développeur seul de tenir tous les rôles ; partage éventuel de réputation SmartScreen entre projets signés par la fondation ; entrées exactes de l'action GitHub au-delà des entrées obligatoires. +- Prix de renouvellement Certum, liste exacte des pièces d'identité, affichage « à partir de 359 € » sur une page de la boutique, URL de l'horodateur (`http://time.certum.pl`, valeur habituelle mais non relue sur le site). +- Prix d'un certificat IV chez SSL.com ou Sectigo pour un particulier, et pièces demandées. +- Acceptation par le Store d'un remplaçant de barre des tâches en MSIX avec `runFullTrust`. +- État de signature des DLL Qt/PySide6 embarquées. +- Comportement de SmartScreen pour un installateur téléchargé par winget. +- Taux de conversion dollar/euro (approximation, non vérifié). + +--- + +## 9. Sources (consultées le 17/11/2026) + +- Microsoft Learn, Code signing options for Windows app developers (ms.date 29/10/2026) : https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/code-signing-options +- Microsoft Learn, SmartScreen reputation : https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/smartscreen-reputation +- Microsoft Learn, Quickstart: Set up Artifact Signing (ms.date 21/05/2026) : https://learn.microsoft.com/en-us/azure/artifact-signing/quickstart +- Azure, Artifact Signing pricing (montants non affichés) : https://azure.microsoft.com/en-us/pricing/details/artifact-signing/ +- Microsoft Q&A, particulier français refusé (mars 2026) : https://learn.microsoft.com/en-us/answers/questions/5810735/cant-create-a-new-trusted-signing-individual-ident +- DevClass, GA d'Artifact Signing (14/01/2026) : https://www.devclass.com/security/2026/01/14/code-signing-windows-apps-may-be-easier-and-more-secure-with-new-azure-artifact-service/4079554 +- Forum JUCE (témoignage, source secondaire) : https://forum.juce.com/t/azure-code-signing-for-plugin-developers-guide/60391?page=6 +- Microsoft Q&A, citation du programme Trusted Root (EV, août 2024) : https://learn.microsoft.com/en-us/answers/questions/1846647/program-requirements-microsoft-trusted-root-progra +- Microsoft Learn, App package requirements for MSI/EXE app : https://learn.microsoft.com/en-us/windows/apps/publish/publish-your-app/msi/app-package-requirements +- Windows Developer Blog, inscription gratuite des développeurs individuels (10/09/2025) : https://blogs.windows.com/windowsdeveloper/2025/09/10/free-developer-registration-for-individual-developers-on-microsoft-store/ +- Microsoft Q&A, `runFullTrust` capacité restreinte : https://learn.microsoft.com/en-us/answers/questions/1424817/the-following-restricted-capabilities-require-appr +- Microsoft, soumission de fichiers (Defender) : https://www.microsoft.com/wdsi/filesubmission +- winget-pkgs, Policies : https://github.com/microsoft/winget-pkgs/blob/master/doc/Policies.md +- SignPath Foundation, conditions : https://signpath.org/terms ; candidature : https://signpath.org/apply ; accueil : https://signpath.org/ +- SignPath, intégration GitHub : https://docs.signpath.io/trusted-build-systems/github +- Certum, Open Source Code Signing on SimplySign (49 € TTC) : https://shop.certum.eu/open-source-code-signing-on-simplysign.html +- Certum, Open Source Code Signing set (69 € TTC) : https://shop.certum.eu/open-source-code-signing.html +- Certum, pièces requises : https://support.certum.eu/en/code-signing-required-documents/ +- Durée 460 jours (CSC-31) : https://www.encryptionconsulting.com/new-code-signing-certificate-validity-change/ ; GlobalSign : https://support.globalsign.com/customer/en/portal/articles/1464693-maximum-certificate-validity ; SSL.com : https://www.ssl.com/article/reminder-reduced-code-signing-certificate-lifecycles/amp/ +- SSL.com, tarifs eSigner : https://ssl.com/guide/esigner-pricing-for-code-signing/ +- Caelestia Shell, licence GPL-3.0 : https://github.com/caelestia-dots/shell/blob/main/LICENSE +- GNU GPL v3 (articles 5, 6, 7, 9, 10) : https://www.gnu.org/licenses/gpl-3.0.html diff --git a/docs/ESPACE-REDESIGN-PROGRESS.md b/docs/ESPACE-REDESIGN-PROGRESS.md deleted file mode 100644 index ef272df..0000000 --- a/docs/ESPACE-REDESIGN-PROGRESS.md +++ /dev/null @@ -1,10 +0,0 @@ -# Espace ("Tout ton espace") redesign progress -- File: src/frontend/qml/WorkspaceBrowser.qml (always instantiated in Main.qml, visible toggled by pageMode). -- Python: AppData/Local/Programs/Winlestia/Caelestia-Windows/.venv/Scripts/python.exe (PySide6 ok if version printed). -- Harness: src/frontend/tests/render_espace.py + EspaceHarness.qml (new). Scratch PNGs in session scratchpad. -## Log -- [1] Located panel, read it. Candidate causes: per-delegate C.ToolTip (Popup) + StateLayer, duplicate Bridge.action("icon") per delegate, full JS recompute (indexed/base/categories/entries) on becoming visible. -- [2] Harness done (tests/render_espace.py + EspaceHarness.qml, stub 372 items). BEFORE (orig WorkspaceBrowser, saved at scratchpad/WorkspaceBrowser.orig.qml): open->first-frame median 43.4 ms (runs 40.6-47.2), of which ~35 ms is synchronous inside setting visible (JS index/filter only 1-3 ms; rest = ~34 delegate creations, each with StateLayer+C.ToolTip Popup+dup Bridge.action("icon")); delegates destroyed on every hide (model:[] when hidden). ToolTip removal alone = -4 ms. -- [3] WorkspaceBrowser.qml rewritten (persistent ListModel with incremental diff, recycled delegates, shared tooltip, sliding nav pill, wrapped chips, springs, staggered reveal, fx gating). NEXT: run harness, fix warnings, shots, bench after. -- [4] File WAS written (coordinator note was stale). Harness check_espace.py: 16/16 PASS (hidden=0 frames, settled idle=0 frames, click/right-click/Ctrl+F/type/Down+Enter/chips/scope/list/empty/catalog change). AFTER bench median ~7.4 ms (before 43.4). Shot espace-before.png saved. Popup menu not captured by grabWindow (opened=true verified). NEXT: reduced-effects run, final shots red/teal/1366/search, final report. Do NOT touch Workspaces.qml/Content.qml/Models.cs. -- [5] DONE. Final: before median 43.5 ms, after 7.9 ms (fx) / 4.9 ms (reduced); check_espace 16/16 in fx and reduced; all PNGs read. Only report remains. diff --git a/docs/EXPLORER-MVP-PLAN.md b/docs/EXPLORER-MVP-PLAN.md deleted file mode 100644 index 144b062..0000000 --- a/docs/EXPLORER-MVP-PLAN.md +++ /dev/null @@ -1,85 +0,0 @@ -# Winlestia Fichiers — plan du MVP - -Statut : plan, rien d'implémenté. Local uniquement, pas de push ni de release. - -## Principes -- **Optionnel** : désactivé par défaut. Il s'active dans Personnaliser > Explorateur > « Ouvrir les dossiers avec Winlestia Fichiers ». -- **Aucune dépendance tierce, aucune injection.** Il n'utilise que les API shell publiques (COM). -- **Repli permanent sur Explorer.** Tout ce qui n'est pas un chemin de fichiers ordinaire, et tout échec, est renvoyé vers `explorer.exe`. -- **HKCU uniquement.** L'installateur reste en `PrivilegesRequired=lowest`, et c'est réversible à 100 %. -- **Identité unifiée.** Il reprend `Tokens.cs` et `UiTokens.cs` (palette M3, rayons 12/17/25, Rubik, Material Symbols, Effets allégés). - -## Architecture -- **Exécutable séparé** : `src/files/Winlestia.Files.csproj` (WPF, net10.0-windows10.0.19041.0), publié à côté de `Panneaux.Glass.exe`. Un plantage n'emporte donc ni le dock ni le backend. -- **Partage des jetons** : les fichiers `Tokens.cs`, `UiTokens.cs` et `Visuals.cs` sont liés (``), sans copie. -- **Choix de WPF plutôt que QML** : `IContextMenu3` et `IDropTarget` ont besoin d'un HWND et de COM dans le même processus. QML ne garantit pas la virtualisation des vues. -- **Instance unique** : une deuxième ouverture envoie le chemin par pipe nommé et ouvre un nouvel onglet. -- **Thème** : à l'ouverture, on lit le même fichier de réglages que le backend (palette, `reducedEffects`). Un changement de palette est reçu par le pipe. - -## Périmètre MVP -| # | Fonction | Mise en œuvre | -|---|---|---| -| 1 | Navigation : adresse (fil d'Ariane + saisie), précédent/suivant/parent, onglets | `IShellItem` / `SHCreateItemFromParsingName` | -| 2 | Volet latéral : Accès rapide (lecture), dossiers personnels, lecteurs | `SHGetKnownFolderPath`, `DriveInfo` | -| 3 | Liste et grille virtualisées, tri par nom/date/taille/type | `VirtualizingStackPanel` / `VirtualizingWrapPanel`, recyclage | -| 4 | Énumération asynchrone par lots de 256, annulable | `Directory.EnumerateFileSystemEntries` sur un thread de fond | -| 5 | Icônes et vignettes | `IShellItemImageFactory` sur un pool limité, cache LRU, annulation au défilement | -| 6 | Ouvrir, ouvrir avec | `ShellExecuteEx` (verbe par défaut) | -| 7 | Menu clic droit natif complet | `IContextMenu3` hébergé, avec en tête nos entrées stylées (Copier le chemin, Ouvrir dans Explorer) | -| 8 | Copier / couper / coller / supprimer (Corbeille) / renommer / nouveau dossier, avec annulation Windows | `IFileOperation` (progression native) | -| 9 | Glisser-déposer entrant et sortant | `DoDragDrop` / `IDropTarget` OLE | -| 10 | Rafraîchissement automatique | `SHChangeNotifyRegister`, avec mise à jour incrémentale sans reconstruction de liste | -| 11 | Filtre rapide sur le dossier courant (pas de recherche indexée) | Filtre en mémoire | -| 12 | États vides et d'erreur (accès refusé, dossier introuvable) | Bloc `EmptyState` | - -**Hors MVP** : recherche Windows Search, volet d'aperçu, téléphones (MTP), zip comme dossier, réseau en navigation, bibliothèques, Win+E, épingle de la barre des tâches. - -## Repli vers Explorer (`PathRouter`) -Le chemin passe par `explorer.exe ""` puis l'application se ferme, dans chacun de ces cas : -- l'argument commence par `shell:`, `::{`, `\\?\` ou `\\` (UNC), ou bien c'est un `.zip`, ou un chemin qui n'est pas un dossier existant ; -- le dossier est la Corbeille, le Panneau de configuration, Ce PC ou un ID shell virtuel ; -- l'énumération échoue pour une autre raison qu'un accès refusé. - -La commande « Ouvrir dans Explorer » est toujours présente, dans le menu et en `Ctrl+Maj+E`. - -**Anti-boucle** : le lancement d'Explorer utilise `explorer.exe` avec un chemin explicite et ne passe jamais par le verbe `Directory`. - -## Enregistrement comme gestionnaire par défaut -Clés écrites seulement à l'activation : -``` -HKCU\Software\Classes\Directory\shell\winlestia\command (Default) = "\Glass-v5\Winlestia.Files.exe" "%1" -HKCU\Software\Classes\Directory\shell (Default) = winlestia -HKCU\Software\Classes\Drive\shell\winlestia\command (Default) = idem -HKCU\Software\Classes\Drive\shell (Default) = winlestia -``` -- `Folder\shell` n'est **pas** touché, pour ne pas capturer les dossiers virtuels. -- Avant l'écriture, une sauvegarde des valeurs existantes est faite dans `%LOCALAPPDATA%\Winlestia\Files\handler-backup.json`. -- `--restore` remet ces valeurs exactement et supprime nos clés. Il est appelé à la désactivation, par l'installateur (`[UninstallRun]`) et par le garde-fou. - -**Garde-fou :** -- Au démarrage, le backend vérifie que l'exe existe. S'il est absent, il appelle `--restore`. -- Trois plantages au démarrage en moins de 60 s désactivent l'option, appellent `--restore` et affichent un toast. -- Un journal `%LOCALAPPDATA%\Winlestia\Files\crash.log` garde au plus 200 lignes. - -## Performance (critères mesurés, pas estimés) -- **Ouverture d'un dossier de 50 fichiers** : moins de 300 ms jusqu'à la première peinture, en démarrage à chaud. Le démarrage à froid est mesuré à part. -- **Dossier de 10 000 fichiers** : premières lignes en moins de 150 ms, aucun gel du fil d'interface de plus de 50 ms (minuteur de détection), mémoire privée sous 250 Mo. -- **Au repos** : 0 % de CPU et aucun minuteur actif quand la fenêtre est réduite. Les vignettes sont suspendues hors écran. -- **Fuites** : 50 ouvertures et fermetures d'onglets, puis 30 s de repos et un nouvel échantillon. Handles et threads doivent revenir à ±5 % de la mesure de départ. -- **Effets allégés** : pas d'animations ni de flou, comme le reste du shell. - -## Étapes et validation -Chaque étape est validée à l'écran sur cette machine avant de passer à la suivante. - -1. **Squelette** : projet, fenêtre unifiée, `PathRouter` et tests unitaires du routage (`tests/FilesRouter`). Ajout au `build.ps1` et à `Deploy-Local.ps1`. -2. **Navigation et liste** : énumération asynchrone, vue virtualisée, tri, onglets, volet latéral. Première mesure de performance. -3. **Icônes et vignettes** : pool de threads, cache, annulation. Nouvelle mesure. -4. **Actions** : ouvrir, `IFileOperation`, renommer, presse-papiers, menu natif, glisser-déposer. -5. **Rafraîchissement automatique**, états vides et d'erreur, filtre. -6. **Gestionnaire par défaut** : réglage dans Personnaliser, écriture des clés, sauvegarde, `--restore`, garde-fou. Test aller-retour sur une ruche de test, puis sur HKCU réel avec contrôle manuel du Bureau et de « Afficher dans le dossier ». -7. **Installateur** : fichiers dans `Winlestia.iss` et `--restore` à la désinstallation. Test d'installation et de désinstallation sur une session Windows propre (autre compte ou VM) : c'est le seul test « autre machine ». -8. **Revue** (sécurité du registre, fuites), puis rapport en quatre colonnes : modifié / testé / validé visuellement / imparfait ou dépendant de Windows. - -## Limites connues, même terminé -- Win+E, l'épingle Explorer de la barre des tâches, `explorer.exe /select,` appelé directement par une application, et les boîtes Ouvrir/Enregistrer restent natifs. -- Le contenu du menu clic droit natif (entrées des autres logiciels) garde le style Windows. Seuls le cadre et nos entrées sont stylés. diff --git a/docs/FOLDER-ICONS-PROGRESS.md b/docs/FOLDER-ICONS-PROGRESS.md deleted file mode 100644 index 8700c59..0000000 --- a/docs/FOLDER-ICONS-PROGRESS.md +++ /dev/null @@ -1,9 +0,0 @@ -# Folder icons: stable path scheme (progress) - -- Icons now live at `%LOCALAPPDATA%\Winlestia\Explorer\icons\-current.ico` (folder, desktop, download, document, picture, music, video); `icons\state.json` stores the current accent and the Migrated flag. -- Palette change: Sync arms a 1 s debounced regeneration (atomic temp + replace, off the UI thread, skipped if accent unchanged), then one SHCNE_ASSOCCHANGED and SHCNE_UPDATEITEM per manifest folder (64 per 250 ms; 32 per 500 ms with reduced effects). No desktop.ini rewrite. -- Migration: one background pass (MigrateAsync) rewrites manifest inis that point to legacy `--v2.ico`; skipped when ini hash != AppliedHash; then unreferenced legacy icons are deleted. -- Junctions/reparse points stay skipped (their target is themed when visited). -- ColourVisibleFolder(path): thread safe, 3 s per-folder debounce, 12 calls / 10 s budget (not wired to Files yet). -- Shell cache measurement: a fresh process sees the new colour at the same path immediately; a warm process (proxy for explorer.exe) did not refresh in 9 s in ANY case, including the alternate-path control, so the proxy is inconclusive for explorer.exe. To verify manually after redeploy. -- Tests: `tests/FolderIcons` (18/18), `tests/Explorer077` (36/36). diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 428283e..4d53937 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -11,7 +11,7 @@ This guide is for people who just want Winlestia running, with no technical back ## 1. Download -Go to the [Releases page](https://github.com/lilidoxdev/winlestia/releases/latest) and download `Winlestia-Setup-0.9.1.exe`, the installer. The SHA-256 used to verify it is in the [v0.9.1 release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1). +Go to the [Releases page](https://github.com/lilidoxdev/winlestia/releases/latest) and download `WinlestiaSetup.exe`, the installer. The SHA-256 used to verify it is in the [v1.0.0 release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v1.0.0). ## 2. Verify the download (recommended) @@ -21,10 +21,10 @@ The installer is not code-signed (see the next section). A checksum lets you con 2. Run, adjusting the folder if you did not save to Downloads: ```powershell - Get-FileHash "$env:USERPROFILE\Downloads\Winlestia-Setup-0.9.1.exe" -Algorithm SHA256 + Get-FileHash "$env:USERPROFILE\Downloads\WinlestiaSetup.exe" -Algorithm SHA256 ``` -3. Compare the `Hash` shown by PowerShell with the SHA-256 in the [release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1). It must match exactly (letter case does not matter). +3. Compare the `Hash` shown by PowerShell with the SHA-256 in the [release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v1.0.0). It must match exactly (letter case does not matter). If the values differ, do not run the file. Download it again, and open an issue if it still differs. @@ -39,7 +39,7 @@ If the checksum matched and you want to continue: ## 4. Run the setup -The setup wizard is in English by default and picks French or Spanish when Windows uses one of them. The steps are: +The setup wizard is in French only (no other language is offered). The steps are: 1. **Welcome** and licence (GPL-3.0). 2. **Tasks** (checked on first install unless noted): @@ -69,7 +69,7 @@ If something looks wrong, jump to [TROUBLESHOOTING.md](TROUBLESHOOTING.md). The ## Updating from an older version -Run the new `Winlestia-Setup-0.9.1.exe`. The setup detects the existing install and offers to update (or reinstall, or uninstall). It closes the running shell itself before replacing files, so you do not need to quit Winlestia first. Your settings in `%LOCALAPPDATA%\Panneaux` are kept. If terminal integration was already enabled, it stays checked. +Run the new `WinlestiaSetup.exe`. The setup detects the existing install and offers to update (or reinstall, or uninstall). It closes the running shell itself before replacing files, so you do not need to quit Winlestia first. Your settings in `%LOCALAPPDATA%\Panneaux` are kept. If terminal integration was already enabled, it stays checked. ## Uninstalling @@ -86,3 +86,13 @@ To remove both by hand after uninstalling, delete the profile folder and run `Re If an older install was made as administrator, the uninstaller may ask for UAC confirmation. To reset without uninstalling, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md#resetting-your-profile). + +## WinlestiaSetup (custom installer) + +`WinlestiaSetup.exe` is a single-window installer built with WPF (`installer/WinlestiaSetup`). Steps: welcome, license (information only), features, updates, summary, progress, done. If Winlestia is already installed, the first screen offers update, change features or uninstall and shows the installed and new versions. + +- Per-user install, no administrator rights. Nothing is written until you confirm on the summary screen. +- Some features have no config key (panels, Winjets) and appear locked. The update notification switch is not wired yet. +- Command line: `--dry-run` (full journey, no system writes), `--lang fr|en|es|de`, `--uninstall [--keep-data|--remove-data] [--dry-run]`. +- Uninstall restores the Windows taskbar first and sends folders to the Recycle Bin. It never deletes permanently. +- Details and limits: `installer/WinlestiaSetup/README.md`. Screenshots: `docs/media/installer/`. diff --git a/docs/PERF-AUDIT-PROGRESS.md b/docs/PERF-AUDIT-PROGRESS.md deleted file mode 100644 index 5e118a9..0000000 --- a/docs/PERF-AUDIT-PROGRESS.md +++ /dev/null @@ -1,10 +0,0 @@ -# Dashboard perf audit - -Live idle, 30 s, read-only: pythonw 1.25 % of one core, WS 546 MB, 1601 handles, 155 threads; Panneaux.Glass 1.77 % core, WS 246 MB, 1150 handles, 32 threads. - -Harness: src/frontend/tests/perf_dashboard.py + DashHarness.qml (offscreen, software scenegraph, vsync-capped ~16 ms: frame intervals show dropped frames, not GPU cost). -Findings: hidden tabs idle (0 timers, 0 animations, none loaded until first visit); cold first switch costs 15 ms (Media), 3 ms (Performance), 26 ms (Workspaces) synchronous. -Prime suspect fixed: frontend.py update_state emitted Bridge.changed on every poll because performance/sysInfo (cpu %, etc.) differ each poll; every Bridge binding re-evaluated (1.6 ms/emit in stub, more with real getters). Poll is 55 ms (page 1 visible), 180 ms visible, 500 ms hidden. -Fix: perfChanged signal for performance/sysInfo; changed only for other keys. -Not changed: Wrapper.qml:48 layer.enabled on whole dashboard (not measurable offscreen), sync Loaders (Content sizing depends on currentItem). -Before/after: see final report. Backend signal rate not measured live (would require talking to the pipe). diff --git a/docs/PERSONNALISER-REDESIGN-PROGRESS.md b/docs/PERSONNALISER-REDESIGN-PROGRESS.md deleted file mode 100644 index 9c8260d..0000000 --- a/docs/PERSONNALISER-REDESIGN-PROGRESS.md +++ /dev/null @@ -1,41 +0,0 @@ -# Personnaliser redesign - progress - -Files: src/frontend/qml/ShellPreferences.qml (rewritten), src/frontend/qml/Main.qml (settings panel width 690 -> min(900, screenWidth-80)), tests/prefs_shots.py (offscreen screenshots, 60 s hard timeout). - -## Inventory (before = after) -Bridge key / slot, old location -> new page. -1. theme (4 cards light/dark/custom/auto) + custom editor, Apparence -> Apparence / Theme -2. Modifier ma palette (custom), Apparence -> Apparence / Theme -3. Wallpaper palette dots (auto, display) -> Apparence / Theme -4. glassOpacity slider -> Apparence / Rendu (now always visible, disabled outside Automatique) -5. reducedEffects ("Effets allégés") -> Apparence / Rendu -6. accentBorders (Liseré) -> Apparence / Rendu (moved from Explorateur) -7. explorerTheme -> Explorateur et fichiers / Explorateur Windows -8. filesDefaultHandler -> Explorateur et fichiers / Winlestia Fichiers -9. filesPreload -> Explorateur et fichiers / Winlestia Fichiers -10. explorerFolder (Ajouter un dossier), 11. explorerOpen, 12. explorerRestore -> Explorateur Windows - (the 4+ unlabeled icon buttons were decorative tiles, not controls: kept as a preview strip tied to "Icônes et contours assortis") -13. explorerStatus text + adaptive-icons note -> Explorateur Windows -14. autoTile -> Bureau et dock / Fenêtres et écran -15. desktopLogo -> idem -16. screenFrame -> idem -17. frameThickness slider -> idem (dimmed when frame off) -18. taskbar -> Bureau et dock / Dock et accès rapide -19. iconSize slider -> idem -20. Zone de détection + Calibrer (DetectionGuide) -> idem -21. setLanguage x4 (auto/fr/en/es) -> Au quotidien / Langue et services -22. shortcut panel (recorder) 23. paletteShortcut (recorder) -> Au quotidien / Raccourcis -24. autostart 25. clipboardHistory -> Au quotidien / Démarrage et données -26. chooseCity 27. refreshCatalogue (was an unlabeled refresh icon) -> Langue et services -28. restoreTaskbar, 29. navigate("dashboard") -> footer; 30. closePanel -> X (+ Esc via Main.qml Shortcut) -New: 31. motion (Animations Sans/Rapides/Caelestia = 0/.5/1; existing backend key "motion"/settings.motionScale, no backend change). -Count: 30 before, 31 after (the extra one is the Animations control; nothing removed). - -## Structure -Header (title, subtitle, X), 4 tabs (Apparence, Bureau et dock, Explorateur et fichiers, Au quotidien), page = 2-column grid of cards (icon, title, subtitle; rows with label + explanation), footer (Rétablir la barre Windows, Tableau de bord). -Pages load through a Loader (only the current one, only while visible); a page scrolls inside itself only if the screen is too small. Panel height min(640, screenHeight-100); fits at 1366x768. -Keyboard: tabs, theme cards, chips are focusable (Tab, Enter/Space, Left/Right on tabs) with focus ring; switches/sliders are Qt Controls (Tab) and their row shows a ring. -Colours: palette tokens only; the only literals are the fixed Porcelaine/Nuit swatch colours (they depict themes independent of the live palette). - -## Verification -tests/prefs_shots.py OUTDIR PREFIX WxH pages (python from installed frontend venv, preview bridge on its own pipe). Zero QML warnings (frontend QML_ISSUES empty). Bridge names grep-checked in QtShellBridge.cs / frontend.py. diff --git a/docs/RELEASE-0.6.0.md b/docs/RELEASE-0.6.0.md deleted file mode 100644 index 6a00b94..0000000 --- a/docs/RELEASE-0.6.0.md +++ /dev/null @@ -1,15 +0,0 @@ -# Winlestia 0.6.0 - -La numerotation passe de 9.5.0 a 0.6.0 ; le setup accepte la mise a jour avec le meme identifiant. - -- Spectre FFT dynamique a 48 bandes : capture WASAPI du processus du lecteur et de ses enfants, sans repli sur le son global. Analyse en memoire, aucun enregistrement. Test reel avec signal sinusoidal et processus exclu reussi. -- Menu alimentation : cartes avec icones, confirmation, position au-dessus du dock. -- Fluidite : retrait du hook souris global de fermeture des panneaux, remplacement par detection des transitions de boutons ; suppression des abonnements globaux bruyants aux changements de position/etat ; cadence du mixeur reduite. Le ralentissement du PC du collegue reste a confirmer sur cette machine, sa cause exacte n'est pas prouvee. -- Langues : detection de la langue d'affichage Windows (FR/EN/ES, anglais sinon), choix manuel persistant dans Personnalisation et premier catalogue de traduction de l'interface principale. Certains libelles secondaires et dialogues Windows/herites restent dans leur langue initiale ; la couverture n'est pas encore exhaustive. -- Meteo : en absence de ville manuelle, estimation de ville par adresse IP (wttr.in), puis meteo Open-Meteo. Ce n'est pas une localisation GPS ; VPN/reseau peuvent affecter la ville. -- Ctrl+F2 : raccourcis recents du dossier Windows Recent en tete ; applications observees au premier plan depuis le lancement sont aussi prises en compte. Les historiques Windows desactives/proteges ne sont pas contournes. -- Calibration : bouton Calibrer dans Personnalisation, panneau principal masque, reglage isole et ligne rouge non interactive sur l'ecran. Valider avec la coche ; Echap annule. - -Tests : 32 tests Python ; runtime QML/menus sans erreur ; FFT/isolation native ; choix/persistance des langues et ordre recent d'abord. Le PC du collegue et une vraie ouverture de session restent a tester. - -Implementation WASAPI : https://learn.microsoft.com/en-us/samples/microsoft/windows-classic-samples/applicationloopbackaudio-sample/ diff --git a/docs/RELEASE-0.6.5.1.md b/docs/RELEASE-0.6.5.1.md deleted file mode 100644 index 417be40..0000000 --- a/docs/RELEASE-0.6.5.1.md +++ /dev/null @@ -1,14 +0,0 @@ -# Winlestia 0.6.5.1 - -- Reparation de l'installation du theme PowerShell : Set-ExecutionPolicy pouvait modifier CurrentUser puis signaler ExecutionPolicyOverride a cause de la politique du processus du setup. Le helper verifie maintenant la valeur relue et accepte uniquement une modification effectivement reussie. Les restrictions de groupe restent respectees. -- Le theme CMD/PowerShell est inclus automatiquement, y compris lors d'une mise a jour ayant conserve une ancienne liste de taches. -- Synchronisation initiale de la palette avant le lancement du worker ; arret de l'ancien worker enregistre ; mutex propre au dossier d'installation. Les fichiers de couleurs sont publies meme si Windows Terminal n'a pas encore de configuration. -- Windows Terminal nouvellement initialise : ajout du schema Winlestia manquant et activation de son apparence. Les editions Preview sont aussi detectees. Le CMD classique utilise les couleurs RVB du theme ; Windows Terminal conserve ses couleurs indexees adaptatives. -- Ctrl+F2 : extraction des icones des applications et fichiers/dossiers recents, et demande de chargement des la creation des lignes. -- Echecs d'installation : stderr du helper est conserve dans install-result.json pour un diagnostic exploitable. - -## Verification - -PowerShell 5.1 interactif dans un vrai pseudo-terminal : logo ASCII, panneau systeme et prompt affiches, couleur rouge RVB verifiee, fermeture propre. Test reproduisant ExecutionPolicyOverride avec changement applique, puis restauration de la valeur precedente. Tests de palettes rouge/bleue et de configuration Terminal neuve ; test d'import du worker avec le Python embarque ; installation/reinstallation/restauration isolees ; regressions QML sans erreur. - -Le rendu du fond transparent exige un hote compatible tel que Windows Terminal. Une strategie d'entreprise interdisant les profils non signes doit etre geree par son administrateur. Le PC du collegue reste a retester ; les tests locaux ne constituent pas une verification sur cette machine. diff --git a/docs/RELEASE-0.6.5.2.md b/docs/RELEASE-0.6.5.2.md deleted file mode 100644 index b1791e0..0000000 --- a/docs/RELEASE-0.6.5.2.md +++ /dev/null @@ -1,17 +0,0 @@ -# Winlestia 0.6.5.2 - -## Personnaliser -Refonte inspiree des composants, arrondis et couleurs de Caelestia : https://github.com/caelestia-dots/shell . Trois cartes Apparence / Bureau / Au quotidien, apercus de themes, interrupteurs, langues compactes et hierarchie typographique. Le selecteur d'animations est retire. La detection superieure dispose d'un bouton Calibrer unique ; aucun curseur redondant dans les parametres. - -## Applications -Les onglets En cours / Arriere-plan utilisent une grille d'icones avec noms au survol. Clic gauche ou droit ouvre les actions. Les fermetures et arrets avec confirmation reviennent a la grille, dans le meme onglet, sans fermer le panneau. Retour et Echap restent disponibles. Le clic exterieur ferme le panneau ; aucun hook souris global n'est ajoute. - -## Plein ecran -Le dock devient une capsule flottante complete quand son ecran accueille un vrai plein ecran. Le dessin, le verre et le masque de clic utilisent la meme forme detachee. Le cadre reste masque lorsque le dock ou son menu prend le focus. - -La detection utilise les coordonnees physiques et le nom du moniteur Windows, sans multiplication des origines Qt par un facteur DPI. Une video plein ecran peut etre reconnue meme si le navigateur conserve son etat maximise. Une fenetre simplement maximisee avec barre de titre reste distincte. Le clip arrondi impose aux fenetres maximisees est retire lorsque leur client couvre le moniteur entier ; retour a l'arrondi a la sortie. - -## Verification -32 tests Python de geometrie/recherche ; tests QML dans le runtime embarque : grille, clic droit, confirmation, maintien du panneau, clic exterieur, bouton de calibration, cadre masque, capsule et cas de DPI melanges simule ; fixture native : arrondis/restauration, epingles, recents. Aucune erreur QML sur ces parcours. Une capture du nouveau panneau a ete inspectee. - -Le cas Firefox/Chrome du second PC reste a retester sur cette machine ; les tests locaux et simules ne couvrent pas toutes les versions de pilotes ou tous les lecteurs video. Les terminaux ne sont pas modifies par cette version. diff --git a/docs/RELEASE-0.6.5.md b/docs/RELEASE-0.6.5.md deleted file mode 100644 index e39d5d5..0000000 --- a/docs/RELEASE-0.6.5.md +++ /dev/null @@ -1,28 +0,0 @@ -# Winlestia 0.6.5 — correctifs et audit - -## Correctifs -- Raccourcis : fenetre independante, panneau principal masque, combinaison affichee pendant la saisie, validation backend, fermeture automatique uniquement apres succes et libelle synchronise. Echap annule. -- Langues : quatre cartes graphiques Windows/France/Royaume-Uni/Espagne, assets SVG locaux, selection persistante. -- Icones Workspace : demandes a la demande avec coalescence et nouvelles tentatives ; les images vectorielles de secours sont aussi rendues pour Qt ; encodage PNG hors du fil de saisie. -- Recents : applications observees au premier plan et raccourcis Windows Recent sont fusionnes par horodatage UTC ; dernier acces conserve, ordre decroissant, historique local borne. La collecte commence avec Winlestia et ne reconstitue pas un historique Windows absent ou desactive. -- Terminal : installation du profil accompagnee de RemoteSigned pour le compte courant lorsque necessaire, ancienne valeur sauvegardee puis restauree a la desinstallation. CMD lance son helper avec une politique limitee au processus. Les strategies imposees par une organisation restent prioritaires et sont signalees. Les settings Windows Terminal avec commentaires/virgules finales sont acceptes. -- Mise a jour/desinstallation : fermeture propre, puis nettoyage des seuls processus frontend/theme du dossier installe. Suppression du taskkill global par nom : les autres installations et applications Python restent intactes. - -## Audit des performances -Defauts identifies : enumeration de tous les processus sur le dispatcher du dock ; icones demandees uniquement pour les favoris/dock ; encodeur d'images sur le dispatcher ; arret force du backend pouvant laisser son frontend orphelin ; listes recentes concatenees sans tri commun. - -Corrections : inventaire des processus uniquement a l'ouverture du panneau dedie, sur une tache de fond ; un seul worker STA pour les recents, cache des liens et file bornee ; pas de Shell COM dans les requetes d'etat ; ecriture des icones en arriere-plan ; nettoyage du cycle de vie. - -Mode allege automatique jusqu'a 8 Gio de memoire disponible pour le runtime, reglable dans Personnalisation : flou natif desactive, transparence conservee, sondes materielles moins frequentes. Le test sur le PC du collegue reste necessaire : aucune mesure sur cette machine n'est disponible et aucune garantie de fluidite universelle n'est annoncee. - -## Verifications -- 32 tests Python de geometrie, recherche et palettes. -- QML du runtime embarque : popup seul, touche Ctrl+K capturee, succes simule, retour aux parametres/libelle, demandes d'icones coalescees, quatre cartes de langue ; aucune erreur QML. -- Fixture native : arrondis/restauration, ordre des epingles, recents mixtes tries et dedupliques. -- Capture audio : FFT variable et isolation du processus validees avec signal de test. -- Installation terminal isolee : profils, chemins portables, CMD AutoRun, reinstal idempotente, restauration, JSON avec commentaires ; banner reel lance sous environnement Restricted avec son option de processus. -- Nettoyage reel sur deux processus factices : seul le processus du dossier choisi est arrete. - -Les dialogues secondaires herites ne sont pas tous traduits. L'estimation de ville reste reseau/IP. Les tests automatises ne remplacent pas une ouverture de session Windows ni l'essai sur la petite configuration. - -Reference des politiques PowerShell : https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies/ diff --git a/docs/RELEASE-0.7.0.md b/docs/RELEASE-0.7.0.md deleted file mode 100644 index 6cc607d..0000000 --- a/docs/RELEASE-0.7.0.md +++ /dev/null @@ -1,12 +0,0 @@ -# Winlestia 0.7.0 — theme personnalise - -Quatrieme theme Personnalise, en plus de Porcelaine, Nuit et Automatique. Le studio reprend les cartes, arrondis et typographie du panneau Personnaliser. - -- Cinq couleurs : fond, texte, principal, secondaire et troisieme accent. Les surfaces, contours et couleurs de contraste des boutons sont derives de ces roles. Palette initiale inspiree de Porcelaine. -- Roue HSV avec luminosite, saisie hexadecimale #RRGGBB et apercu avant application. -- Pipette d'ecran : interface masquee pendant l'echantillonnage d'un pixel ; clic intercepte temporairement sur un fil Windows dedie, sans hook permanent ni enregistrement d'image. Echap ou clic droit annule. Le hook est retire a la fin et a la fermeture. -- Verre optionnel : desactive, le fond choisi est opaque et le curseur disparait ; active, un curseur regle sa transparence. Le cadre, le dashboard et le dock utilisent les memes roles et le meme materiau. -- Couleurs et transparence personnalisees sauvegardees. Annuler l'editeur ne sauvegarde pas le brouillon. Le theme Automatique conserve son propre reglage de verre. -- Les terminaux reprennent la palette personnalisee ; Windows Terminal adapte aussi son opacite et son effet acrylique. Le mode allege conserve son comportement pour les configurations modestes. - -Tests : palette et validation hexadecimale, roue/editeur QML sans erreur, modes opaque/verre, selection et annulation d'un pixel deterministe, persistance native des cinq roles et du verre, 32 regressions Python, import du service terminal et cycle de vie reel du hook temporaire dans le runtime embarque. Capture du studio inspectee. Les couleurs visibles peuvent dependre de la gestion HDR du bureau ; le rendu sur le second PC reste a tester. diff --git a/docs/RELEASE-0.7.5.md b/docs/RELEASE-0.7.5.md deleted file mode 100644 index 77919e4..0000000 --- a/docs/RELEASE-0.7.5.md +++ /dev/null @@ -1,21 +0,0 @@ -# Winlestia 0.7.5 — organisation automatique du bureau - -## Mosaïque -Les fenetres redimensionnables se repartissent automatiquement dans la zone de travail de chaque moniteur, avec espacement et ordre stables. L'ouverture, la fermeture, la reduction et la restauration recalculent les emplacements. La disposition est activee par defaut ; un interrupteur dans Personnaliser > Bureau permet de la desactiver. - -Le double-clic sur la barre de titre conserve l'agrandissement Windows. Tant qu'une fenetre geree est agrandie, sa disposition est preservee ; le bouton Restaurer permet de reprendre la mosaique. Une nouvelle application peut reouvrir la disposition partagee. Les jeux et videos qui couvrent vraiment un moniteur sont exclus du placement. - -Les positions d'origine sont memorisees et restaurees a la desactivation ou a la fermeture normale pour les fenetres encore a leur emplacement gere. Les deplacements manuels, les fenetres reduites ou agrandies ne sont pas annules de force. Les boites de dialogue, outils flottants, fenetres fixes, bureaux virtuels masques et interfaces Winlestia sont exclus. - -## Logo -Logo fourni affiche en blanc discret dans le coin superieur gauche de chaque ecran. Option Logo Winlestia, desactivee par defaut. Fond transparent, aucun clic intercepte, opacite attenuee suivant le verre. Masque en plein ecran et pendant les captures/pipette. - -## Fluidite et limites -Detection legere toutes les 700 ms, sans hook souris global. Les placements qui ne changent pas ne sont pas reappliques ; un glisser-deposer en cours n'est pas interrompu. Les fenetres soumises a une taille minimale ne sont pas redimensionnees en boucle. - -Le nombre gere simultanement est borne selon la taille du moniteur, jusqu'a 16 fenetres recentes par ecran. Les applications imposant de grandes tailles minimales ou un niveau d'administration superieur peuvent refuser un placement ; une organisation parfaite de toutes les applications Windows ne peut pas etre garantie. La restauration en cas de terminaison forcee du processus n'est pas garantie. - -## Verification -Fixture native isolee : 3, 4 puis 10 vraies fenetres sans chevauchement, agrandir/restaurer, reduire/restaurer, fermer/reorganiser et restauration des positions initiales. Partitionnement de 1 a 16 cases avec coordonnees negatives. 30 cycles stables moyens sous 25 ms sur la machine de test ; ce n'est pas une mesure du PC du collegue. - -Tests QML : logo visible, transparent aux clics et masque en plein ecran ; regressions grille et menus, plein ecran et DPI mixtes. Editeur de palette/raccourcis et 32 tests Python de regression passes. Aucun autre logiciel du bureau n'a ete deplace par la fixture : sa source ne contient que les fenetres de test. diff --git a/docs/RELEASE-0.7.6.md b/docs/RELEASE-0.7.6.md deleted file mode 100644 index 5178ada..0000000 --- a/docs/RELEASE-0.7.6.md +++ /dev/null @@ -1,10 +0,0 @@ -# Winlestia 0.7.6 - -- Réorganisation automatique animée sur 240 ms avec ralentissement progressif. Le minuteur d’animation s’arrête au repos ; aucun hook de souris permanent. Une manipulation, une réduction ou un agrandissement interrompt le mouvement concerné. -- Arrondis des fenêtres agrandies alignés sur leur surface visible DWM. Le découpage est réappliqué si une application le réinitialise, puis restauré au retour en fenêtre. Les vidéos et jeux en plein écran réel restent exclus. -- Logo du Bureau agrandi (116 px au lieu de 76 px, transparence et clics traversants conservés). -- Organisation automatique désactivée par défaut pour les nouvelles préférences. Les choix déjà enregistrés sont conservés. - -Validation : tests natifs sur dix fenêtres dédiées (ouverture, réduction, restauration, fermeture, agrandissement, retour aux positions originales), partitions sur coordonnées négatives, réparation d’une région effacée par l’application, tests QML du logo et des interactions, 32 tests Python. Compilation autonome et installeur reconstruits. - -Limites : le rendu des transitions dépend de la vitesse de redessin des applications. Les fenêtres protégées ou exécutées avec des privilèges supérieurs peuvent refuser un déplacement ou un découpage ; aucun résultat universel n’est garanti. diff --git a/docs/RELEASE-0.9.0.md b/docs/RELEASE-0.9.0.md deleted file mode 100644 index a1fc561..0000000 --- a/docs/RELEASE-0.9.0.md +++ /dev/null @@ -1,88 +0,0 @@ -# Winlestia 0.9.0 - -Winlestia is a free, open-source desktop shell for Windows 11, bringing a Caelestia-inspired interface, dynamic themes, glass effects, a customizable dock and powerful desktop tools. It replaces the surface of Windows, not the system: a dock instead of the taskbar, with a dashboard and glass panels on top of your normal desktop. The interface is a port of [Caelestia](https://github.com/caelestia-dots/shell). Licence: GPL-3.0. - -## Highlights - -- Dashboard with media (and audio bars), performance and workspaces pages. Ctrl+F1. -- Command palette (Ctrl+F2): calculator, emoji, wallpapers, open windows, Windows Settings pages, indexed file search, session actions with confirmation. -- Dock with virtual-desktop indicator, window previews and optional automatic tiling. -- Quick controls with a Wi-Fi network list and per-display brightness (DDC/CI). -- Wallpaper switcher with live preview and per-display targeting; the colour palette can follow the wallpaper (Settings, Appearance, Theme, Automatic; the default Porcelain theme is fixed and does not). -- `winlestia` command line to drive the running shell from scripts. - -## Since 0.8.0 - -**Added:** Wi-Fi panel; brightness per display, with OSD for brightness and microphone; dashboard audio bars; fullscreen quiet mode; full-screen wallpaper switcher; palette entries for windows, Windows Settings, files and session actions; settings search; dock desktop `+` button and desktop close; tiling keyboard shortcuts and exclusions; "active window only" accent border; the `winlestia` command; optional, reversible terminal integration. - -**Changed:** wallpaper collection replaced by 10 images supplied by the maintainer, shipped unmodified; Automatic theme default glass transparency is 5 %; panel text stays legible on bright wallpapers in the Automatic theme; data folder is `%LOCALAPPDATA%\Panneaux` (the former project name, kept on purpose), migrated at first launch; start-up through a per-user scheduled task; wallpaper applied through the Windows desktop wallpaper interface; messengers loaded on demand; several start-up and idle-time performance improvements; French, English and Spanish strings. - -**Fixed:** desktop indicator refresh, OSD icon, a settings tile read after its delegate was destroyed, wallpaper palette over a live-wallpaper configuration, a binding loop in the Media panel, start-up log errors; the dashboard now shows the display name chosen at install (it used to show the Windows account name); upgrading no longer aborts while the shell is running; interface strings completed in English and Spanish, and the dashboard calendar follows the app language. - -Full list: [CHANGELOG.md](../CHANGELOG.md). - -## Requirements - -- Windows 11, 64-bit (x64). Not for Windows 10. -- No administrator rights: per-user install in `%LOCALAPPDATA%\Programs\Winlestia`. -- Nothing else to install. An Internet connection is needed only if you tick the optional terminal integration (it downloads Clink 1.9.35 from its official page and checks a pinned SHA-256). - -## Install - -1. Download `Winlestia-Setup-0.9.0.exe` from the assets below. -2. In PowerShell: `Get-FileHash .\Winlestia-Setup-0.9.0.exe -Algorithm SHA256`. The value must match the installer SHA-256: `c9c406669bd9e7205aba2c3458fb23b727cd53b74b1991bc0456d06152442834`. -3. Run the setup (its wizard is in French only). Updating from an older version works the same way: the setup closes the running shell itself and keeps your settings. - -**SmartScreen.** The binaries are not code-signed, so Windows SmartScreen will probably show "Windows protected your PC". After checking the SHA-256, choose **More info**, then **Run anyway**. - -Step-by-step guide: [docs/INSTALL.md](INSTALL.md). Shortcuts: [docs/SHORTCUTS.md](SHORTCUTS.md). - -## If the taskbar does not come back - -Wait a few seconds (a watchdog restores it), press Ctrl+Alt+Backspace, use the Start menu shortcut "Restaurer la barre des tâches Windows", or run `RETABLIR_BARRE_WINDOWS.exe` in `Glass-v5`. All options: [docs/TROUBLESHOOTING.md](TROUBLESHOOTING.md). - -## Known limitations - -- The installer wizard is in French only. -- English and Spanish are translated for the shell panels; some rarer system-derived labels may still appear in French. The language follows the Windows display language and can be forced with the `language` key (`auto`/`fr`/`en`/`es`) in `%LOCALAPPDATA%\Panneaux\Caelestia\language.json`. Fallback text is French. -- Not tested on a clean machine or VM, nor after a real reboot or sign-in (the scheduled-task launch was tested manually). -- Binaries are **not signed**, so SmartScreen may warn. -- Windows 11 x64 only. Temperature is in Celsius only. -- There is **no notification centre**: only the on-screen indicator and toasts. Windows notifications can be switched off from the tools panel. -- Window preview quality in the dock depends on what each application exposes to Windows. -- Weather: with no city set, your approximate location comes from your IP address through wttr.in; the forecast comes from Open-Meteo. Temperature is in °C only. -- Bundled wallpapers: the 10 images were supplied by the maintainer and are not covered by the GPL-3.0 licence; rights remain with their owners (see `assets/wallpapers/CREDITS.txt`). A rights holder can ask for removal through a GitHub issue. -- Automatic tiling is **off by default**. -- Tested on a real Windows 11 Home machine with a single 3440x1440 display, not on a clean virtual machine. Other display layouts, scalings and Windows editions have had less testing. -- Enterprise (802.1X) and hidden Wi-Fi networks are not handled in the Wi-Fi panel. -- The optional terminal integration prints a welcome banner in French, showing your session and computer names. -- When you confirm a wallpaper in the switcher, the previous wallpaper can flash briefly before the new one appears. -- The wallpaper switcher also lists images from `Pictures\Wallpapers`, `Pictures` and the Windows wallpaper folders, not only the bundled set. -- CPU temperature can show N/A, depending on the hardware. - -## What was tested - -Tested by hand and by script on one Windows 11 Home machine (single 3440x1440 display), with the installer built from a clean checkout: - -| Check | Result | -| --- | --- | -| Install, first start, dock replaces the taskbar | Pass | -| Upgrade from 0.8.0 with the shell running | Pass | -| Main panels open (settings, clipboard, tools, audio, mixer, capture, palette, dashboard) | Pass | -| Theme change and wallpaper-driven palette | Pass | -| Global shortcuts Ctrl+F1, Ctrl+F2, Ctrl+Alt+Space, Ctrl+Alt+W | Pass | -| Autostart task created, launched manually with the shell closed | Pass | -| Taskbar restored after normal close, after a killed process, and by `--restore-taskbar` and Ctrl+Alt+Backspace | Pass | -| Uninstall with the shell running (user profile and wallpaper kept) | Pass | -| Clean machine or VM; real reboot and sign-in | Not run | -| Other display layouts and scalings | Not run | - -These tests ran from an MSIX-packaged parent process, which redirects `%LOCALAPPDATA%` writes for its child processes; autostart was exercised from Task Scheduler, outside that redirection. - -## Reporting a bug - -Use the [bug report form](https://github.com/lilidoxdev/winlestia/issues/new/choose) with your Windows build, display setup and log lines with personal data removed. Security issues: see [SECURITY.md](../SECURITY.md), not a public issue. - -## Notes - -Native helper binaries (`GlassBackdrop.dll`, `ProcessAudio.dll`, `RETABLIR_BARRE_WINDOWS.exe`, `SECOURS_BUREAU.exe`) are built from the C++ sources in `src/backend/*.cpp`. Third-party components are listed in `THIRD_PARTY_NOTICES.md`. diff --git a/docs/RELEASE-9.5.0.md b/docs/RELEASE-9.5.0.md deleted file mode 100644 index 2612cc1..0000000 --- a/docs/RELEASE-9.5.0.md +++ /dev/null @@ -1,18 +0,0 @@ -# Winlestia 9.5.0 - -- L'installateur embarque le theme CMD/PowerShell et propose son installation. Profils interactifs, ASCII Winlestia, Clink, couleurs, verre Windows Terminal et adaptation au fond d'ecran. Les reglages existants sont sauvegardes. Les sessions elevees du meme compte utilisent les memes profils. -- Media : bouton volume cible a la place du bouton de deplacement ; pochette tournante pendant la lecture, angle conserve en pause. -- Le visualiseur utilise le niveau des sessions audio du lecteur selectionne, sans repli sur la sortie globale. C'est un indicateur d'amplitude, pas une analyse FFT par frequence. Le volume d'un navigateur concerne ses sessions, pas un onglet individuel. -- Dock : separation des groupes epingles/ouverts, deplacement des epingles par glissement, largeur reglable au bord droit et centrage conserve. -- Applications : onglets en cours/arriere-plan ; executables accessibles de la session, groupes par chemin. Les processus proteges ou inaccessibles ne sont pas listes. -- Alimentation : veille, redemarrage et arret avec confirmation. -- Reglages : hauteur de detection du bord superieur de 0 a 160 pixels, persistante. -- Fenetres maximisees : decoupe arrondie dans la zone de travail ; region precedente restauree au retour en mode normal ou a la fermeture du shell. Les pleins ecrans exclusifs restent geres par leur application. -- Curseurs : protection des valeurs choisies contre les retours d'etat anciens pendant les commandes audio et luminosite. -- Mise a jour : conservation du catalogue et des preferences backend ; correctif Explorer 9.4 conserve. - -## Verification - -32 tests Python ; chargement QML et menus avec etat de test ; protection contre etat obsolete ; installation/restauration terminal dans un environnement isole ; fixture native pour arrondis et ordre des epingles ; verification Core Audio avec session silencieuse dediee. Aucune commande d'arret, redemarrage ou veille n'est executee par ces tests. Le demarrage de session Windows et un second ordinateur restent a tester manuellement. - -Le setup est gratuit, Windows 11 x64. Le depot reste prive : les testeurs doivent disposer d'un acces GitHub. diff --git a/docs/RELEASE-NOTES-1.0.md b/docs/RELEASE-NOTES-1.0.md new file mode 100644 index 0000000..eab4f31 --- /dev/null +++ b/docs/RELEASE-NOTES-1.0.md @@ -0,0 +1,50 @@ +# Winlestia 1.0.0 + +First stable release, after 0.9.2. Winlestia is a free, open-source desktop shell for Windows 11, a port of [Caelestia](https://github.com/caelestia-dots/shell) (the visual reference). It replaces the surface of Windows (taskbar, panels, launcher), not the system. + +## Highlights + +### Dock +- Grows with the open apps and scrolls with the mouse wheel when it overflows. +- Optional battery pill for connected Bluetooth and XInput devices (off by default). +- Pins of Store (MSIX) apps survive app updates and reboots. +- Fixed: windows stuck between the dock's glass background and its icons. + +### Panels +- Control center redesigned: Wi-Fi page, Bluetooth device connect/disconnect, audio output and microphone pages, per-application mixer. +- Social rail (right edge): gathers notifications from Discord, Instagram, Snapchat, WhatsApp and Telegram. +- Command palette opens faster, including the first time after start-up. + +### Winjets (desktop widgets) +- Liquid glass v2: smoked fill, highlight and a thin diagonal border; blur depends on card size. +- Ten built-in Winjets replace the PC Widgets pack: Calendar, Clock, Music, System, Markets (Yahoo Finance), Storage, Files, Notes, Agenda (ICS link) and Weather (city or Windows location). Battery is still included. +- Per-widget transparency, double-click editing with a snapping grid. +- Packages are JSON (`winjet/1`); no package code is executed. Format: `docs/winjets/FORMAT-v1.md`. + +### Other +- Push-to-talk voice dictation (hold AltGr, off by default). +- Redesigned file manager (Winlestia Fichiers). +- Lock screen (Ctrl+Alt+L) and window overview (Win+Alt+Tab). +- New WPF installer and uninstaller: `WinlestiaSetup.exe`. + +## Install + +Requires Windows 11 (64-bit). No administrator rights needed. + +1. Download `WinlestiaSetup.exe` from the assets below. +2. Compare `Get-FileHash .\WinlestiaSetup.exe -Algorithm SHA256` with the SHA-256 published here. +3. Run it. + +### SmartScreen + +The installer and the programs it installs are not code-signed, so Windows SmartScreen shows a warning. Choose **More info**, then **Run anyway**. A matching checksum shows the file is the published one; it does not replace a signature. + +### If the taskbar is missing + +Press Ctrl+Alt+Backspace, or run `Panneaux.Glass.exe --restore-taskbar` from the `Glass-v5` folder of the install. + +### Uninstall + +Run `WinlestiaSetup.exe` again and choose uninstall, or use Settings > Apps. The taskbar is restored first. Settings in `%LOCALAPPDATA%\Panneaux` are kept or sent to the Recycle Bin, as you choose. + +Full list of changes: [CHANGELOG.md](../CHANGELOG.md). diff --git a/docs/RESTORE.md b/docs/RESTORE.md index 30bb306..cc71d62 100644 --- a/docs/RESTORE.md +++ b/docs/RESTORE.md @@ -1,18 +1,31 @@ -# Getting the Windows taskbar back - -Winlestia hides the Windows taskbar only while it runs with "Replace the taskbar" on. A separate watchdog process -restores it when the shell stops or crashes. If it is still missing, try these in order (more detail in -`docs/TROUBLESHOOTING.md`): - -1. Wait a few seconds for the watchdog. -2. Press **Ctrl+Alt+Backspace**. The independent rescue tool stops Winlestia and brings the desktop back - (`src/backend/Tools/GlobalShortcut.cs`, `src/backend/Secours.cpp`). -3. Run `RETABLIR_BARRE_WINDOWS.exe` from `%LOCALAPPDATA%\Programs\Winlestia\Glass-v5`. -4. From a terminal: - `"%LOCALAPPDATA%\Programs\Winlestia\Glass-v5\Panneaux.Glass.exe" --restore-taskbar` - (reads the saved lease and shows `Shell_TrayWnd` again; `TaskbarNative.RestoreSaved`). -5. Run `SECOURS_BUREAU.exe` (or `Panneaux.Glass.exe --restore`) if desktop icons are hidden too. -6. Last resort: restart Explorer (Task Manager, Run new task, `explorer.exe`), or uninstall Winlestia; the - uninstaller restores the taskbar. - -To stop Winlestia from starting at logon, delete its scheduled task: `schtasks /delete /tn WinlestiaShell /f`. +# Restauration de la barre des tâches Windows + +Winlestia masque la barre Windows quand le dock Qt la remplace. Ce document fixe les invariants qui garantissent qu'elle revient, y compris après un arrêt brutal. Analyse faite par lecture du code ; rien n'a été exécuté. + +## Acteurs + +| Acteur | Fichier | Rôle | +|---|---|---| +| Bail `taskbar-session.json` | `Taskbar/TaskbarNative.cs` (`Snapshot`, `LeasePath`) | État d'origine de la barre (`State` : 1 = masquage auto, 2 = toujours visible) et barres visibles. Écrit dans `Store.Root` **avant** tout masquage (`ShellTaskbar.Enable`). | +| Gardien natif | `TaskbarRescue.cpp` -> `RETABLIR_BARRE_WINDOWS.exe --watch-parent ` | Processus séparé lancé par `Enable`. Attend la fin du parent (handle `SYNCHRONIZE`) ou l'événement `release`, puis restaure. | +| Gardien de repli | `Panneaux.Glass.exe --taskbar-guard ` (`TaskbarNative.Guard`) | Même rôle si `RETABLIR_BARRE_WINDOWS.exe` est absent. | +| Restauration manuelle | `Panneaux.Glass.exe --restore-taskbar`, ou `RETABLIR_BARRE_WINDOWS.exe` lancé seul (raccourci du menu Démarrer, désinstallation) | Rétablit sans shell ni pipe. | + +## Invariants + +1. **Bail avant masquage.** `Enable` écrit le bail, démarre le gardien, attend son événement `ready` (4 s) et seulement ensuite appelle `HideExplorer`. Si le gardien ne démarre pas, la barre n'est jamais masquée (`Disable` + message). +2. **Arrêt brutal.** Le gardien attend le *handle du processus* parent : `TerminateProcess`, plantage ou arrêt par le gestionnaire des tâches le réveillent sans qu'aucun `finally` du parent ne s'exécute. Il relit `taskbar-session.json` (dossier de son exe, identique à `Store.Root`), applique `ABM_SETSTATE` puis `ShowWindow(SW_SHOWNA)` sur `Shell_TrayWnd` et `Shell_SecondaryTrayWnd`. +3. **Pas de dépendance au pipe ni au shell.** Ni le gardien ni `--restore-taskbar` n'utilisent le canal `PanneauxCaelestia` ni Qt. `--restore-taskbar` est traité dans `Program.Main` avant le mutex d'instance unique et avant tout démarrage de shell : il signale l'événement `Local\PanneauxGlassTaskbarRestore` (si une instance vit, elle bascule `SetTaskbar(false)`), puis applique `RestoreSaved` directement. +4. **Repli sans bail.** Bail absent ou illisible : le gardien natif et `--restore-taskbar` appliquent tous deux « toujours visible » (état 2) et réaffichent les barres. (Corrigé : `RestoreSaved` ne faisait rien dans ce cas, le gardien natif si.) +5. **Arrêt propre.** `Disable` signale `release`, attend le gardien (2,2 s) puis restaure lui-même ; l'arrêt du frontend seul (`SuspendTaskbar`) restaure sans modifier la préférence `ReplaceTaskbar`. +6. **Restauration idempotente.** Restaurer une barre déjà visible est sans effet ; le gardien peut donc s'exécuter après une restauration manuelle. + +## Ctrl+Alt+Retour arrière + +Ce raccourci global (`GlobalShortcut`, id 2) appelle `Coordinator.Rescue()` qui lance `SECOURS_BUREAU.exe` : il rétablit les **icônes du Bureau**, pas la barre des tâches. Il est enregistré par le processus shell : s'il est mort, le raccourci n'existe plus. Dans ce cas la barre est rétablie par le gardien (invariant 2) ; pour la forcer à la main : `RETABLIR_BARRE_WINDOWS.exe` ou `Panneaux.Glass.exe --restore-taskbar`. + +## Limites connues + +- Si le gardien lui-même est tué avant le parent, personne ne restaure : relancer `RETABLIR_BARRE_WINDOWS.exe`. +- Le gardien de repli (`--taskbar-guard`) retourne 2 sans restaurer si le bail est illisible ; seul le cas où le gardien natif est absent est concerné. +- Non vérifié par exécution : aucun test ne tue le processus réel (règle du dépôt : pas de manipulation du bureau). diff --git a/docs/SHORTCUTS.md b/docs/SHORTCUTS.md index 551ee9c..53583a1 100644 --- a/docs/SHORTCUTS.md +++ b/docs/SHORTCUTS.md @@ -1,6 +1,6 @@ # Shortcuts and command line -Everything below was checked against the source (`src/backend/Tools/GlobalShortcut.cs`, `src/backend/Storage/Models.cs`, `src/frontend/qml`, `src/backend/Shell/CliCommands.cs`). Global shortcuts can be reassigned in Settings; the values shown are the defaults. If another application already owns a combination, Windows refuses it and Winlestia reports the conflict. +Everything below was checked against the source (`src/backend/GlobalShortcut.cs`, `src/backend/Models.cs`, `src/frontend/qml`, `src/backend/CliCommands.cs`). Global shortcuts can be reassigned in Settings, on the Keyboard shortcuts page (Modify, then press the new combination); Windows-reserved combinations and ones already used by another action are refused; the values shown are the defaults. If another application already owns a combination, Windows refuses it and Winlestia reports the conflict. ## Global shortcuts @@ -8,29 +8,31 @@ Everything below was checked against the source (`src/backend/Tools/GlobalShortc |---|---|---| | Ctrl+F1 | Toggle the dashboard (pressing again closes it) | Yes | | Ctrl+Alt+Space | Also opens the dashboard; always registered as a second way in | No | +| Win+Alt+S | Open Settings | Yes | | Ctrl+F2 | Command palette | Yes | | Ctrl+F3 | Screen capture | Yes | | Ctrl+F8 | Keep the active window on top (pin) | Yes | | Win+Alt+W | Wallpaper switcher. If Windows refuses the combination, Ctrl+Alt+W is the fallback | Yes | +| Win+Alt+Tab | Window overview: live thumbnails of the open windows. If Windows refuses the combination, Win+Alt+V is the fallback | No | | Ctrl+Alt+Backspace | Emergency rescue (see [TROUBLESHOOTING.md](TROUBLESHOOTING.md)) | No, reserved | -| Hold AltGr | Push-to-talk dictation. Off by default, enable it in Settings; the key can be changed | Yes | +| Hold AltGr | Push-to-talk dictation. Off by default, enable it in Settings; the key is chosen in Settings, Media and audio, not on the Keyboard shortcuts page | Set elsewhere | ## The dock The Win key opens the normal Windows Start menu; it does not reveal the dock. The dock auto-hides: it slides away about 0.45 s after the pointer leaves it, and appears when the pointer reaches the bottom edge of the screen. -Reassignable shortcuts must combine Ctrl and/or Alt (the wallpaper switcher also accepts Win) with a letter, digit, Space or a function key (F12 excluded). +Reassignable shortcuts must combine Ctrl and/or Alt (the wallpaper switcher and Settings also accept Win) with a letter, digit, Space or a function key (F12 excluded). ## Automatic tiling -Tiling is **off by default**. These keys are registered only while it is turned on (Settings, or the dock button). +Tiling is **off by default**. These keys are registered only while it is turned on (Settings, or the dock button). They are fixed for now and listed, read-only, on the Keyboard shortcuts page. | Shortcut | Action | |---|---| | Ctrl+Alt+Arrows | Move to the neighbouring tile | | Ctrl+Alt+Shift+Arrows | Swap with the neighbouring tile, across displays too | | Ctrl+Alt+Shift+F | Take the window out of tiling, or put it back | -| Ctrl+Alt+Shift++ / - | Grow or shrink the active tile (20 to 80 %) | +| Ctrl+Alt+Shift++ / - | Grow or shrink the active tile (20 to 80 %); the numeric keypad + and - also work | | Ctrl+Alt+Shift+X | Exclude the active window's application, or include it again | Dropping a window onto another tile with the mouse swaps them. Switching virtual desktops uses the standard Windows Win+Ctrl+Arrows. @@ -67,6 +69,16 @@ Ctrl+H and Ctrl+1 to 4 work only while the dashboard window is open, and not on | Delete | Remove the selected image from the list | | Esc | Close | +## Window overview + +| Key | Action | +|---|---| +| Arrows | Move the selection | +| Enter / click | Switch to the window | +| Delete / middle click / close button | Close the window | +| Letters | Filter by title or application; Backspace edits | +| Esc | Clear the filter, then close | + ## Command line: `winlestia` Available if you ticked the PATH option at setup (otherwise run `winlestia.exe` from `%LOCALAPPDATA%\Programs\Winlestia\Glass-v5`). It talks to the running shell through a local named pipe reserved to your user account. `help` works even when the shell is not running. diff --git a/docs/STEP6-PROGRESS.md b/docs/STEP6-PROGRESS.md deleted file mode 100644 index 30b7c51..0000000 --- a/docs/STEP6-PROGRESS.md +++ /dev/null @@ -1,16 +0,0 @@ -# Step 6 (folder handler, guard, toggles, live palette) - DONE, not deployed -- Owner: src/backend/Shared/FilesHandler.cs + FilesHandlerGuard.cs (pure .NET), linked into src/files, backend and tests/FilesHandler. CLI lives in Winlestia.Files.exe (`--register ""`, `--restore`; exit 0/1, log %LOCALAPPDATA%\Winlestia\Files\handler.log). -- Registry root is configurable (HandlerOptions). Test override: WINLESTIA_FILES_HANDLER_ROOT=Software\WinlestiaTest\ (refused elsewhere; no SHChangeNotify; own backup file, WINLESTIA_FILES_HANDLER_BACKUP). -- Backend: FilesDefaultHandler.cs (toggle, startup guard, FileSystemWatcher on handler-tripped.flag), Preferences.FilesDefaultHandler, bridge keys filesDefaultHandler / filesPreload (+ settings fields), FilesPreload.NotifyPalette (called by Theme.Use, 600 ms debounce, never launches). -- Files: startup crash counter (startup-crashes.txt; 3 in 60 s -> restore + handler-tripped.flag), "palette" pipe cmd -> PaletteLoader.Refresh, selftest `palette`. -- Tests: tests/FilesHandler (50/50), harness `-Mode handler` and `-Mode palette`. -- STEP 7 (installer): [UninstallRun] MUST call `{app}\Glass-v5\Winlestia.Files.exe --restore` before the files are removed. - -## Review fixes (applied) -- Mutex `Local\WinlestiaFilesHandler` around Register/Restore (cross-process); Capture never records our own Default/verb as original; Register rolls back (Restore) on any failure after its first write; Restore resets (Default) first, then deletes the verb key, and keeps a foreign Default; a failed Restore keeps the backup and returns Ok=false. -- FilesDefaultHandler.Set returns (pref, notice): pref stays true when Restore fails; registry work under a lock; Store.State/Save only on the UI dispatcher (bridge continuation, Disable via Dispatcher). -- Crash guard counts only real crashes (FilesHandlerGuard.CountsAsCrash); UnhandledException in the first 15 s counts and hands the requested folder to explorer.exe. -- PathRouter.Clean: `C:"` -> `C:\`, `\srv\share"` -> `\srv\share\`; also used by LaunchExplorer. -- WINLESTIA_FILES_HANDLER_BACKUP honoured only under %TEMP%. -- installer/Winlestia.iss [UninstallRun] calls `Glass-v5\Winlestia.Files.exe --restore` (before the Taskbar rescue entry; skipifdoesntexist). -- Known limit: if Winlestia.Files.exe is deleted/moved while the backend is NOT running, nothing repairs the HKCU keys (folders would fail to open). The backend repairs it at its next start (exe missing -> restore + pref off); the uninstaller restores explicitly. diff --git a/docs/STEP6B-PROGRESS.md b/docs/STEP6B-PROGRESS.md deleted file mode 100644 index 5c6715d..0000000 --- a/docs/STEP6B-PROGRESS.md +++ /dev/null @@ -1,9 +0,0 @@ -# STEP 6B progress - -A icon: tools/Make-FilesIcon.ps1 -> src/files/Assets/winlestia-files.ico (16..256), ApplicationIcon set. Dock icon cache key = SHA256(entry.Id+IconPath+Target), new entry => no stale icon. -B pin: FilesDefaultHandler.Migrate adds dock entry "dock:\Winlestia.Files.exe" ("Winlestia Fichiers") to TaskbarPins once (FilesDefaultsMigrated). -C defaults: Models.cs FilesDefaultHandler/FilesPreload default true + FilesDefaultsMigrated; FilesHandlerGuard.DecideDefaults (pure); migration runs after crash-guard Check, off UI thread via Set(true). -D theme: Files-only tokens (UI.Panel/Recess/Tint/Accent in BackendShim), primary-tinted hover, PrimaryContainer for active sidebar/tab, accent crumb/nav/tab icons. - Root cause: Files read the wallpaper via SPI, but the frontend palette comes from a Desktop Hut live wallpaper override. frontend.py now writes Glass-v5/palette-shell.json (auto mode); Files reads it (FileSystemWatcher, debounced) and falls back to its own computation. -Tests: FilesHandler 64/64 (incl. 4 defaults_*), FilesRouter 27/27, FilesPreloadPolicy 12/12, Explorer077 no false, harness palette 0 fails. -Needs redeploy (frontend.py + backend + Files). Test envs: WINLESTIA_FILES_PALETTE_FILE, WINLESTIA_FILES_PALETTE_SHELL; harness modes themeshot. diff --git a/docs/TESTS.md b/docs/TESTS.md new file mode 100644 index 0000000..172f38c --- /dev/null +++ b/docs/TESTS.md @@ -0,0 +1,64 @@ +# Tests + +## .NET (xUnit) + +Un seul projet : `tests/Winlestia.Tests`. Les sources du backend y sont compilees directement, donc les types `internal` sont testables. + +```powershell +# Tests sans bureau (ceux de la CI) +dotnet test tests/Winlestia.Tests --filter "Category!=Desktop" + +# Un seul test +dotnet test tests/Winlestia.Tests --filter "FullyQualifiedName~CliCommandsTests" +``` + +Les tests de categorie `Desktop` (`[Trait("Category","Desktop")]` : demarrage du coordinateur en preview, audio, explorateur, icones de dossiers, tiling, bureaux virtuels, interop native, plein ecran) ouvrent de vraies fenetres ou touchent au shell. Ne les lancez pas pendant que le shell Winlestia tourne : `dotnet test tests/Winlestia.Tests --filter "Category=Desktop"`, a la main uniquement. + +`SettingsMigrationAndShortcutsTests` genere un fichier de preferences pre-refonte ; `WINLESTIA_LEGACY_PREFS` peut pointer vers une vraie sauvegarde. + +### Couverture + +La CI collecte la couverture avec coverlet (`coverlet.collector`) et verifie un plancher (etape « Resume de couverture » de `.github/workflows/ci.yml`). Valeur mesuree en Release (comme la CI) le 2026-11-09 : 17,61 % des lignes (backend seul, application Fichiers exclue), plancher 17 %. Une mesure en Debug donne environ un point de plus ; seule la valeur Release fait foi. Le backend etant compile dans l'assembly de test, `tests/coverage.runsettings` active `IncludeTestAssembly` et exclut les fichiers de tests. + +```powershell +dotnet test tests/Winlestia.Tests -c Release --filter "Category!=Desktop" --collect:"XPlat Code Coverage" --settings tests/coverage.runsettings --results-directory TestResults +``` + +Le rapport est `TestResults//coverage.cobertura.xml`. Le code WPF/shell non testable sans bureau pese sur le chiffre. + +Regle du cliquet : le plancher vaut toujours `floor(couverture mesuree)` (partie entiere, variable `$floor` de l'etape CI). Il ne baisse jamais ; une PR qui fait monter la couverture d'un point entier releve le plancher dans la meme PR, avec la valeur mesuree datee ici et dans le commentaire de `ci.yml`. Une baisse sous le plancher exige des tests, pas un plancher plus bas. + +### Winjets + +`tests/Winlestia.Tests/Winjets/` : `WinjetValidatorTests` (paquet valide, rejets : chemins, bombe ZIP, extensions, hotes, couleurs litterales, proprietes inconnues ; validation des trois paquets inclus `src/winjets/builtin` et de `docs/winjets/examples/com.exemple.citation-1.0.0.zip`), `WinjetLibraryTests` (import, mise a jour atomique, desinstallation, paquets inclus) et `WinjetInstancesTests` (persistance, coercition des reglages, cles d'etat, reprise depuis `.bak`), `WinjetDataServiceTests` (liste d'hotes, intervalle minimal, taille, delai, cache perime, requete unique, minuteur ; gestionnaire HTTP et horloge factices), `WinjetConditionTests` (evaluateur `enabledWhen` et SemVer). `WinjetFixtures` fabrique les paquets en code ; `WINLESTIA_DATA_DIR` est redirige vers un dossier temporaire puis restaure. + +### Style et fumee de l'installateur + +Le job `lint` de la CI echoue sur toute ligne de plus de 140 colonnes (`python tools/check_line_length.py`, perimetre : tous les `*.cs`, `*.py`, `*.qml`, `*.ps1` suivis par git, hors `src/terminal/clink`, `VsCodeTheme*` et fichiers generes) et sur `dotnet format whitespace --verify-no-changes` pour les trois projets. Le job `installer-smoke` execute `installer/build.ps1 -CI` (composants natifs MSVC remplaces par des fichiers vides) et publie le setup en artefact `winlestia-setup-smoke`. + +### Winlestia Fichiers (harnais) + +`tests/FilesHarness/Run-Files.ps1 -Mode ` est le seul lanceur autorise des auto-tests de Winlestia Fichiers (processus plafonne par un Job Object : 800 Mo, 4 processus, delai <= 120 s, 4 Go de RAM libre requis). Les auto-tests (`ops`, `dnd`, `refresh`, `states`, `palette`, `handler`, `tabs`, `idle`...) sont absents des builds Release : il faut d'abord compiler avec `dotnet build src/files/Winlestia.Files.csproj -p:SelfTest=true` (constante `WINLESTIA_SELFTEST`), puis passer `-Exe` si l'executable n'est pas au chemin par defaut. Hors CI, a lancer a la main uniquement. + +## Python (pytest) + +```powershell +pip install -r src/frontend/requirements.txt pytest +pytest -q +``` + +`pytest.ini` collecte `tests/`, `src/frontend/tests/` et `src/terminal/tests/` (fichiers `test_*.py`). `conftest.py` force `QT_QPA_PLATFORM=offscreen`. Les scripts `check_*.py` / `render_*.py` restent des outils manuels ; `tools/prefs_shots.py` prend des captures et n'est pas un test. + +Les deux suites tournent en CI (`.github/workflows/ci.yml`). `Winlestia.sln` regroupe les projets `src/` et les tests. + +## Avant une release + +Etape manuelle, a faire par un humain sur un poste de bureau Windows 11 interactif, avant de tagger une version : + +```powershell +dotnet test tests/Winlestia.Tests --filter "Category=Desktop" +``` + +Ces tests (demarrage du coordinateur en preview, audio, explorateur, icones de dossiers, tiling, bureaux virtuels, interop native, plein ecran) exigent une session de bureau reelle : fenetres visibles, shell Explorer, peripherique audio, plusieurs bureaux virtuels. Les runners GitHub Actions n'ont pas de session interactive, donc la CI les exclut (`Category!=Desktop`) et ne peut pas les remplacer. Fermer le shell Winlestia avant de lancer, puis consigner le resultat dans la PR de release. + +Dernier passage : 2026-11-08, Windows 11 26200, shell Winlestia lance, barre des taches en masquage automatique : 7/7 reussis. diff --git a/docs/THREADING.md b/docs/THREADING.md new file mode 100644 index 0000000..7744dce --- /dev/null +++ b/docs/THREADING.md @@ -0,0 +1,28 @@ +# Règle de threading du backend + +Dérivée du code (chemins relatifs à `src/backend/`). Trois familles de threads. + +## 1. Thread UI (STA, Dispatcher WPF) + +- `Core/Coordinator.cs` : `Program.Main` est `[STAThread]`. Toute fenêtre WPF, tout état partagé du shell (`Coordinator`, `QtShellBridge`) et toute mutation de collections vivent sur ce thread. +- `Bridge/QtShellBridge.cs` capture `Dispatcher.CurrentDispatcher` à la construction (champ `dispatcher`) et s'en sert pour revenir sur l'UI : `dispatcher.BeginInvoke(...)` (fire and forget) ou `dispatcher.InvokeAsync(...)` (quand on attend le résultat). +- Hors du pont, le même principe s'applique : `Application.Current.Dispatcher.BeginInvoke` dans `Core/Coordinator.cs` (fin des tâches de fond du catalogue) et `Invoke` dans `Bridge/QtShellBridge.cs` (`Fail`). +- Les minuteries d'interface sont des `DispatcherTimer` (ex. `timer` de `QtShellBridge`), jamais des `System.Threading.Timer`. + +## 2. Tâches de fond (thread pool) + +- Tout ce qui bloque (disque, COM, PowerShell, WinRT, réseau) part en `Task.Run`, jamais sur l'UI : `VirtualDesktops.*`, `RecycleActions.Zip`, `explorer.Sync/Restore`, `FilesDefaultHandler.Set`, la liste des fenêtres de la palette, etc. (`Bridge/QtShellBridge.cs`), ou `CatalogueTick` dans `Core/Coordinator.cs`. +- Le résultat revient à l'UI par le Dispatcher (point 1). Une tâche de fond ne touche jamais un objet WPF directement. +- Les commandes CLI (`Bridge/CliServer.cs`) sont traitées par `RunCli` ; la boucle `Serve` tourne en `Task.Run`, la réponse est bornée à 5 s (`WaitAsync`). + +## 3. Lecture du tube du pont Qt + +- `Bridge/QtShellBridge.cs`, méthode `Serve` (tube `PanneauxCaelestia`, `PipeOptions.Asynchronous`) : boucle `async` démarrée depuis le constructeur (`_ = Serve()`), sans thread dédié. `ReadLineAsync` attend sans bloquer. +- Règle : le lecteur du tube ne traite jamais une requête lui-même. Il parse le JSON, clone l'élément (`Clone()`), puis passe par `await dispatcher.InvokeAsync(() => Handle(element))` : `Handle` s'exécute donc toujours sur l'UI, et la réponse est écrite ensuite. +- Sens inverse (`Send`, appelé depuis l'UI) : file `events` bornée à 32 entrées + `EventWaitHandle` `Local\PanneauxCaelestiaWake`, que le frontend Qt attend de son côté. +- En fin de connexion, le nettoyage (`finally`) repasse aussi par `dispatcher.BeginInvoke`. + +## Threads dédiés (exception) + +- `Taskbar/FullscreenWatcher.cs` : un thread `IsBackground` nommé `FullscreenWatcher` porte les hooks `SetWinEventHook` (boucle de messages obligatoire) ; le recalcul tourne sur le thread pool. +- Processus frontend : sa sortie d'erreur est lue en événementiel (`BeginErrorReadLine`), et `Exited` revient sur l'UI via le Dispatcher. diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 42812c9..e04a27c 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -40,7 +40,7 @@ Press Ctrl+Alt+Backspace (see step 2 above). It re-shows the Desktop icons and s ## SmartScreen blocks the installer -The installer and the programs it installs are not code-signed, so SmartScreen warns on a file it does not know. Check the SHA-256 against the one in the [release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.1) (`Get-FileHash .\Winlestia-Setup-0.9.1.exe`), then choose **More info**, **Run anyway**. Details in [INSTALL.md](INSTALL.md#3-smartscreen-will-probably-warn-you). +The installer and the programs it installs are not code-signed, so SmartScreen warns on a file it does not know. Check the SHA-256 against the one in the [release notes](https://github.com/lilidoxdev/winlestia/releases/tag/v0.9.0) (`Get-FileHash .\Winlestia-Setup-0.9.0.exe`), then choose **More info**, **Run anyway**. Details in [INSTALL.md](INSTALL.md#3-smartscreen-will-probably-warn-you). ## Where the logs are diff --git a/docs/WALLPAPER-SOURCES-PROGRESS.md b/docs/WALLPAPER-SOURCES-PROGRESS.md deleted file mode 100644 index 216429f..0000000 --- a/docs/WALLPAPER-SOURCES-PROGRESS.md +++ /dev/null @@ -1,19 +0,0 @@ -# Wallpaper sources progress -- [started] reading code; plan: wallpaper_sources.py resolver, wallpaper_theme.py wiring, C# events + capture, tests. -- WallpaperX: ProgramData\LiveWallpaperConfig\ServiceConfig.json (Screens:[], GlobalFilePath null = none set). Package LocalState empty. Reader best-effort -- Finding: venv PySide6 6.10.3 has NO QtMultimedia (only .pyi stubs) -> frame extraction = backend exe CLI mode (WinRT Windows.Media.Editing MediaComposition.GetThumbnailAsync), launched as killable subprocess (5 s timeout) from Python. Fallback = thumbnail. -- Finding: bridge is request/response (state replies); capture = command "wallpaperCapture" -> reply field wallpaperCapture. Revision pushed in state as wallpaperRevision. -- Plan order: 1 wallpaper_sources.py, 2 wallpaper_theme.py + frontend.py ~436, 3 C# WindowsWallpaper.cs events, 4 C# FrameExtractor/WallpaperCapture + Coordinator CLI + QtShellBridge, 5 sync_theme, 6 tests, 7 build -- [done] wallpaper_sources.py written (resolve, representative_images, extract_frames->backend exe --extract-frames) -- [done] wallpaper_theme.py rewritten; frontend.py lines 435-437 (update call + wallpaperCapture reply hook) -- [done] WindowsWallpaper.cs rewritten (reg notify, FSW, WinEvent hook, SystemEvents; Revision). Next: WallpaperMedia.cs (frames+capture), Coordinator CLI, QtShellBridge -- [done] WallpaperMedia.cs, Coordinator CLI, QtShellBridge (cmd wallpaperCapture, state wallpaperRevision); dotnet build OK 0 err (-o scratchpad build dir). Next: test frames, unit tests, sync_theme -- FINDING: all DesktopHut videos are HEVC (hvc1); Media Foundation has no HEVC decoder here (0xC00D5212 CODEC_NOT_FOUND); DesktopHut mpv.exe is access-denied outside its package. => on this machine frames fall back to thumbnail. MF path to be proven on an H.264 file. mpv tier only for env WINLESTIA_MPV / PATH. -- MF frame extraction proven on H.264 wispysky.mp4: 8 frames in ~2.1 s (parallel clips, NearestKeyFrame) -- [done] palette wiring: palette_from_images for >1 frame, generate_palette for single image. Remaining: unit tests, real test, sync_theme, final build -- [done] tests (10 pass), sync_theme wait_for_change, real test, build OK. Only final report left. -- [done] WgcCapture.cs (--capture-frames) + python tier 2 (MF -> WGC -> mpv(env/PATH) -> thumbnail). Next: real test on DesktopHut -- [started] reviewer fixes 1-9 -- [done] fix5,6,7 python (publish off-thread+custom, theme_inputs_changed replaces explorer timer, slot hysteresis bounded, LRU) -- [done] C# fixes 1,2,3,4,8 patched -- [done] all reviewer fixes, tests 46 OK, build 0 err, real run done diff --git a/docs/WINJETS-DESIGN.md b/docs/WINJETS-DESIGN.md new file mode 100644 index 0000000..36807e6 --- /dev/null +++ b/docs/WINJETS-DESIGN.md @@ -0,0 +1,182 @@ +# Winjets — conception + +Document de référence interne. Le format public destiné aux créateurs est décrit dans +`docs/winjets/FORMAT-v1.md`, qui ne doit jamais contredire ce document. + +## 1. Références visuelles + +| Image | Observé | Décision | +|---|---|---| +| 1 — carte « six programmes » | Carte verticale très arrondie, verre sombre, liseré 1 px ; visuel circulaire en matrice de points ; légende en petites capitales monospace ; six boutons pilule, un actif plein. | Un créateur donne une identité à sa carte (bloc `dots`, bloc `image`) et propose des interactions internes (bloc `buttons` qui modifie un état d'instance). L'état actif prend l'accent de la palette. | +| 2 — **référence prioritaire** | Cartes translucides posées sur le fond ; rayon ~20 px ; gouttière régulière ~16 px ; petits formats (horloge, calendrier, météo), format large (batterie), grande carte horizontale en haut au centre (médias). Titre de carte petit en haut à gauche, valeur principale grande, détails estompés. Le fond reste visible entre et à travers les cartes. | Grille d'ancrage 8 px, cellule de base 168 px, gouttière 16 px : tailles 1×1, 2×1, 4×1, 2×2. Verre DWM natif + voile de la palette. Chaque Winjet déclare des mises en page par palier de taille. Aucun fond plein derrière les cartes. | +| 3 — variante sombre | Fond quasi noir, cartes sombres avec liseré clair, texte blanc ; petits formats groupés à gauche, lecteur isolé à droite. | Texte secondaire `onSurfaceVariant` avec contraste ≥ 4.5:1 sur le voile ; liseré renforcé en sombre ; positions libres sur n'importe quel écran, l'aimantage aide sans imposer. | + +Arbitrage : l'image 2 fixe composition, proportions et verre ; l'image 3 la lisibilité en sombre ; l'image 1 l'étendue de l'expression d'un créateur. + +## 2. Architecture + +Responsabilités (règle du projet : état et persistance côté backend, rendu côté Qt) : + +- **Backend C# — `src/backend/Winjets/`** (namespace `PanneauxGlass.Winjets`) + - `WinjetPackage` / `WinjetManifest` / `WinjetDefinition` : modèle du paquet, lecture JSON. + - `WinjetValidator` : validation d'un ZIP ou d'un dossier, renvoie une liste d'erreurs lisibles en français. + - `WinjetLibrary` : paquets inclus (lecture seule) et installés (`\winjets\packages\\`), import, mise à jour, désinstallation. + - `WinjetInstances` : instances posées, persistées dans `\winjets\instances.json` par `AtomicFile`. + - `WinjetDataService` : seul accès réseau des Winjets. `HttpClient` partagé, domaine obligatoirement déclaré dans `manifest.permissions.network`, HTTPS seulement, cache disque `\winjets\cache\`, intervalle minimal 60 s (clamp), taille de réponse ≤ 512 Kio, timeout 10 s, un seul appel en vol par source, repli sur le cache en cas d'échec. + - Actions bridge et état publié (§4). +- **Frontend Qt — `src/frontend/qml/winjets/` + `src/frontend/bridge_winjets.py` + `src/frontend/desktop_layer.py`** + - `WinjetLayer.qml` déclaré dans `Main.qml` : un `Repeater` crée une fenêtre `WinjetWindow.qml` par instance visible. + - `WinjetWindow.qml` : fenêtre sans cadre, transparente, verre via `native_glass`, coins arrondis ; contient `WinjetCard.qml`. + - `WinjetRenderer.qml` + `blocks/*.qml` : interprète la composition déclarée, choisit la mise en page selon la taille réelle. + - `desktop_layer.py` (ctypes) : place les fenêtres au fond de la pile, sans activation, les garde visibles après « Afficher le bureau », les replace après redémarrage d'Explorer. + - Mode **Modifier les Winjets** : déplacement, poignées, repères d'alignement sur une surcouche par écran qui n'existe que pendant l'édition. + - `PageWinjets.qml` (Réglages) et entrée **Ajouter un Winjet** dans `DockMenu.qml`. +- **Paquets inclus — `src/winjets/builtin//`**, installés dans `{app}\Winjets\builtin\`. + +Le contenu d'un paquet est traité comme des données : aucun QML, JavaScript, script ou exécutable n'est chargé depuis un paquet. Le renderer n'interprète qu'une liste fermée de blocs et d'expressions. + +### Couche bureau + +- Fenêtres `Qt.Tool | Qt.FramelessWindowHint | Qt.WindowDoesNotAcceptFocus`, `WS_EX_TOOLWINDOW | WS_EX_NOACTIVATE`, placées `HWND_BOTTOM`. Aucun propriétaire n'est donné (un propriétaire Progman détruirait les fenêtres au redémarrage d'Explorer). +- `WM_WINDOWPOSCHANGING` est filtré pour maintenir le fond de pile hors mode édition. +- « Afficher le bureau » : un hook `SetWinEventHook(EVENT_SYSTEM_FOREGROUND)` (événementiel, pas de sondage) détecte le passage au premier plan de `WorkerW`/`Progman` et réaffiche les cartes au-dessus du bureau sans activation ; elles retournent au fond dès qu'une autre fenêtre passe au premier plan. +- Redémarrage d'Explorer : le backend relaie `TaskbarCreated` ; le frontend réapplique la couche. +- Écrans : la géométrie d'une instance est stockée en pixels logiques relatifs à la zone de travail de son écran, plus la clé de l'écran (nom + taille) et une position normalisée. Changement de résolution → repositionnement proportionnel puis clamp ; écran absent → l'instance passe sur l'écran principal, marquée `recovered`. La page Réglages propose « Ramener tous les Winjets sur l'écran principal ». +- Repos : aucune animation ni minuterie hors besoin. L'horloge rafraîchit à la seconde seulement si les secondes sont affichées, sinon à la minute. + +## 3. Grille et tailles + +- Unité logique = pixel indépendant du DPI (96 dpi). +- Cellule 168, gouttière 16 : 1 col = 168, 2 = 352, 3 = 536, 4 = 720 ; mêmes valeurs en hauteur. +- Aimantage : grille 8 px, bords et centres des autres cartes, bords de la zone de travail (marge 16) ; seuil 8 px ; repères affichés pendant le geste. +- `minSize` du paquet ≥ 120×120 imposé par le moteur ; `maxSize` ≤ 1600×1000. + +## 4. Contrat bridge + +État publié par le backend (`state.winjets`) : + +```json +{ + "editMode": false, + "packages": [ { "id": "", "version": "", "name": "", "author": "", "description": "", + "builtin": true, "dir": "C:\\...", "preview": "C:\\...\\preview.png", + "network": ["api.example.com"], "definition": { /* widget.json validé */ }, + "manifest": { /* manifest.json validé */ } } ], + "instances": [ { "id": "w-…", "packageId": "", "hidden": false, + "geometry": { "screen": "\\\\.\\DISPLAY1|2560x1440", "x": 0, "y": 0, "w": 352, "h": 168, + "nx": 0.0, "ny": 0.0, "recovered": false }, + "settings": {}, "state": {} } ], + "data": { "": { "": { "value": {}, "updated": "ISO-8601", "error": null, "stale": false } } }, + "lastImport": { "ok": true, "packageId": "", "errors": [] } +} +``` + +Actions (`Bridge.action(name, args)`) : + +| Action | Arguments | Effet | +|---|---|---| +| `winjets.inspect` | `path` | Valide un ZIP sans l'installer ; remplit `lastImport` avec l'aperçu (`preview` = paquet décompressé en zone temporaire). | +| `winjets.import` | `path` | Valide puis installe ou met à jour le paquet. | +| `winjets.uninstall` | `packageId` | Retire le paquet et ses instances (refusé pour un paquet inclus). | +| `winjets.add` | `packageId`, `screen?`, `x?`, `y?` | Crée une instance à la taille par défaut, à la première place libre de l'écran. | +| `winjets.remove` | `instanceId` | Retire l'instance. | +| `winjets.setHidden` | `instanceId`, `hidden` | Masque/affiche. | +| `winjets.setGeometry` | `instanceId`, `geometry` | Enregistre position et taille (le frontend clampe). | +| `winjets.setSettings` | `instanceId`, `settings` | Valide contre les réglages déclarés puis enregistre. | +| `winjets.setState` | `instanceId`, `key`, `value` | État d'interaction (bloc `buttons`). Clé déclarée seulement. | +| `winjets.setEditMode` | `enabled` | Entrée/sortie du mode édition. | +| `winjets.refresh` | `instanceId` | Rafraîchit les sources réseau en respectant l'intervalle minimal. | +| `winjets.recoverAll` | — | Ramène toutes les instances sur l'écran principal. | + +Le backend publie aussi l'événement `desktop.explorerRestarted` et le compteur `state.desktop.explorerEpoch` (incrémenté à chaque redémarrage d'Explorer). + +Précisions de l'implémentation : + +- `lastImport` contient aussi `inspect` (vrai pour `winjets.inspect`), `updated` (mise à jour d'un paquet déjà installé) et `package` (même forme qu'un élément de `packages`, avec `dir` et `preview` dans la zone temporaire pour un aperçu). +- Les champs nuls sont omis du JSON : `data...value` est absent tant que rien n'a pu être lu, `error` est absent sans erreur. +- `geometry` suit les noms `screen, x, y, w, h, nx, ny, recovered` ; `winjets.setGeometry` borne `w`/`h` aux tailles min/max du paquet. +- Les propriétés à valeurs énumérées des blocs acceptent une valeur littérale ou une expression entière `{{ ... }}` ; le validateur n'en analyse pas le contenu (arguments de filtre compris). + +## 5. Format Winjet v1 (normatif) + +Un paquet est un ZIP (ou un dossier) contenant à la racine : + +``` +manifest.json obligatoire +widget.json obligatoire +preview.png facultatif (≤ 1 Mo, ≤ 1600×1000) +assets/ facultatif : images et JSON de données locales +``` + +Limites : ZIP ≤ 5 Mio, décompressé ≤ 20 Mio, ≤ 200 entrées, profondeur ≤ 4, aucun chemin absolu, `..`, lien ou nom réservé Windows. Extensions autorisées : `.json .png .jpg .jpeg .webp .gif .txt .md`. JSON ≤ 256 Kio chacun, profondeur ≤ 32. Tout autre contenu fait échouer l'import. + +### manifest.json + +```json +{ + "format": "winjet/1", + "id": "com.exemple.horloge", + "name": "Horloge", + "version": "1.0.0", + "author": "Nom déclaré", + "description": "Une phrase.", + "license": "MIT", + "homepage": "https://exemple.com", + "compatibility": { "winlestia": ">=0.9.2" }, + "permissions": { "network": ["api.coingecko.com"] } +} +``` + +- `id` : `^[a-z0-9]+(\.[a-z0-9-]+){1,4}$`, 3 à 64 caractères. `version` : SemVer `x.y.z`. +- `permissions.network` : noms d'hôte exacts, sans joker ni schéma ; vide par défaut. + +### widget.json + +```json +{ + "size": { "default": [352, 168], "min": [168, 168], "max": [720, 352] }, + "settings": [ + { "id": "showSeconds", "type": "toggle", "label": "Afficher les secondes", "default": false }, + { "id": "city", "type": "text", "label": "Ville", "default": "Paris", "maxLength": 40 }, + { "id": "range", "type": "choice", "label": "Période", "default": "7d", + "options": [ { "value": "1d", "label": "24 h" }, { "value": "7d", "label": "7 jours" } ] }, + { "id": "decimals", "type": "number", "label": "Décimales", "default": 2, "min": 0, "max": 6 } + ], + "state": { "mode": "face" }, + "data": { + "btc": { "type": "file", "path": "assets/btc-demo.json" }, + "live": { "type": "http", "url": "https://api.coingecko.com/api/v3/...", "refresh": 300, + "enabledWhen": "settings.source == 'live'" } + }, + "layouts": [ + { "minWidth": 0, "root": { "type": "column", "children": [ ] } }, + { "minWidth": 340, "root": { "type": "row", "children": [ ] } }, + { "minWidth": 520, "minHeight": 300, "root": { } } + ] +} +``` + +- **Mise en page** : on retient la dernière entrée de `layouts` dont `minWidth`/`minHeight` sont satisfaits par la taille réelle de la carte. +- **Conteneurs** : `column`, `row`, `stack` (superposition), `grid` (`columns`). Propriétés communes : `gap`, `padding`, `align` (`start|center|end|stretch`), `grow` (poids), `visibleWhen` (expression). +- **Blocs** : + - `text` : `text`, `style` (`title|label|body|caption|display|mono`), `align`, `maxLines`, `tone` (`primary|secondary|accent`). + - `image` : `src` (chemin sous `assets/`), `fit` (`contain|cover`), `radius`. + - `clock` : `variant` (`analog|digital`), `showSeconds`, `format` (`HH:mm`, etc.), `timezone` (IANA, facultatif). + - `calendar` : `variant` (`month|day`), `firstDay` (`monday|sunday`). + - `list` : `items` (expression vers un tableau), `title`, `subtitle`, `trailing` (champs de l'élément), `max`. + - `chart` : `series` (expression vers un tableau de nombres ou de `[t, v]`), `variant` (`line|area|bars`), `axes` (bool), `period` (texte), `color` (rôle de palette). + - `stat` : `value`, `label`, `delta` (nombre signé, coloré selon le signe). + - `progress` : `value` (0..1), `variant` (`ring|bar`), `label`. + - `dots` : `matrix` (expression vers un tableau 2D de 0..1) ou `pattern` (`pulse|ripple|torus` animé seulement si visible), `shape` (`circle|square`). + - `buttons` : `options` (`[{ value, label }]`), `bind` (`state.`). + - `spacer`, `divider`. +- **Expressions** : `{{ chemin | filtre:arg }}` dans les chaînes. Chemins : `settings.*`, `state.*`, `data..*`, `now`, `instance.width`, `instance.height`. Filtres : `number:n`, `currency:EUR`, `percent:n`, `date:motif`, `upper`, `lower`, `default:valeur`, `last`, `first`, `delta` (variation relative entre premier et dernier élément d'une série). Conditions (`visibleWhen`, `enabledWhen`) : comparaisons `== != < <= > >=`, `&&`, `||`, `!`, littéraux. Aucune autre évaluation. +- **Actions** (champ `action` sur `text`, `image`, `stat`, conteneurs) : `{ "type": "setState", "key": "", "value": "" }`, `{ "type": "refresh" }`, `{ "type": "openUrl", "url": "https://…" }` (hôte déclaré dans `permissions.network` ou `homepage`), `{ "type": "openSettings" }`. +- **Couleurs** : uniquement des rôles de palette (`accent`, `primary`, `secondary`, `tertiary`, `onSurface`, `onSurfaceVariant`, `positive`, `negative`). Aucune couleur littérale. + +## 6. Paquets livrés + +- `winlestia.horloge` (1×1 analogique → 2×1 numérique + date → 2×2 + fuseaux). +- `winlestia.calendrier` (1×1 jour → 2×2 mois). +- `winlestia.graphique-btc` (2×1 prix + courbe → 4×1 + période + axes → 4×2 + liste des jours) avec `assets/btc-demo.json` hors ligne ; source `live` désactivée par défaut (réglage `source`). +- Exemple communautaire : `docs/winjets/examples/com.exemple.citation/` et son ZIP `docs/winjets/examples/com.exemple.citation-1.0.0.zip`. diff --git a/docs/WORKSPACES-REDESIGN-PROGRESS.md b/docs/WORKSPACES-REDESIGN-PROGRESS.md deleted file mode 100644 index 4563861..0000000 --- a/docs/WORKSPACES-REDESIGN-PROGRESS.md +++ /dev/null @@ -1,3 +0,0 @@ -# Workspaces tab redesign -- Rewrote src/frontend/qml/qs/modules/dashboard/Workspaces.qml (header, 4 category cards, favoris + recents cards, quick-action chips). Palette tokens only; handlers/Bridge calls unchanged (navigate workspace:*, clipboard, palette, settings; action launch/icon/websites). -- Render check: src/frontend/tests/render_workspaces.py (+ WorkspacesHarness.qml), offscreen, stub Bridge. diff --git a/docs/WORKSPACES-V2-PROGRESS.md b/docs/WORKSPACES-V2-PROGRESS.md deleted file mode 100644 index f0f8d54..0000000 --- a/docs/WORKSPACES-V2-PROGRESS.md +++ /dev/null @@ -1,5 +0,0 @@ -# Workspaces tab v2 (progress) -- Regression analysis done: QML data source (Bridge.favorites + Bridge.iconUrl(id, iconRevision)) is IDENTICAL to pre-redesign (backup step6b). Cause is data: preferences-glass.json Favorites = ['dock:...\Discord\app-1.0.9265\Discord.exe'] only; that folder no longer exists (Discord is app-1.0.9266) so icon extraction fails -> letter "D". Claude (uwp:Claude_...) / ChatGPT (uwp:OpenAI.Codex_...) / named:discord are not in State.Favorites any more. -- Plan: rewrite Workspaces.qml (blob shapes, Entrance stagger gated by tabActive&&visible, spring hover), Content.qml passes tabActive, harness stub gets icons. -- DONE: Workspaces.qml rewritten; Content.qml passes tabActive (currentTab===3); render_workspaces.py extended (icons stub, tertiary/error palette, anim frame). Renders ws2-{red,teal,red-light,anim}.png OK, only stub Bridge-null warnings. -- NOT verified: hover/press spring, reduced-effects look, real dashboard gating, live data. diff --git a/docs/bridge-schema.json b/docs/bridge-schema.json new file mode 100644 index 0000000..eceef47 --- /dev/null +++ b/docs/bridge-schema.json @@ -0,0 +1,1084 @@ +{ + "protocol": 1, + "description": "Contrat du pont Winlestia (voir docs/BRIDGE.md). Un message client->serveur = {\"command\":nom,\"args\":{...}}. Tous les champs d'args absents prennent la valeur par défaut du serveur (\"\"/0/false) ; \"required\" liste ceux sans lesquels la commande est sans effet.", + "envelope": { + "request": { + "required": [ + "command", + "args" + ], + "commonArgs": { + "pid": "number", + "epoch": "number", + "protocol": "number", + "visible": "boolean", + "page": "number", + "dock": "boolean", + "controls": "boolean", + "mixer": "boolean", + "wifi": "boolean", + "bars": "boolean" + } + }, + "reply": { + "required": [] + } + }, + "commands": { + "activate": { + "args": { + "hwnd": "number", + "id": "string" + }, + "required": [ + "hwnd" + ] + }, + "addAccess": { + "args": { + "board": "string" + }, + "required": [] + }, + "addFolder": { + "args": { + "board": "string" + }, + "required": [] + }, + "audio": { + "args": {}, + "required": [] + }, + "audioBars": { + "args": { + "seq": "number" + }, + "required": [] + }, + "bluetoothDevice": { + "args": { + "connect": "boolean", + "id": "string" + }, + "required": [] + }, + "bookmarksBrowser": { + "args": { + "id": "string" + }, + "required": [] + }, + "bookmarksDeleteInBrowser": { + "args": { + "confirmSync": "boolean", + "id": "string" + }, + "required": [] + }, + "bookmarksHide": { + "args": { + "id": "string" + }, + "required": [] + }, + "bookmarksItems": { + "args": {}, + "required": [] + }, + "bookmarksOpen": { + "args": { + "id": "string" + }, + "required": [] + }, + "bookmarksRefresh": { + "args": { + "ifDirty": "boolean" + }, + "required": [] + }, + "bookmarksUnhideAll": { + "args": {}, + "required": [] + }, + "brightness": { + "args": { + "id": "string", + "value": "number" + }, + "required": [] + }, + "capture": { + "args": {}, + "required": [] + }, + "captureExport": { + "args": { + "path": "string" + }, + "required": [ + "path" + ] + }, + "captureShortcutMode": { + "args": { + "enabled": "boolean" + }, + "required": [] + }, + "clipboard": { + "args": {}, + "required": [] + }, + "clipboardCopy": { + "args": { + "id": "string" + }, + "required": [] + }, + "clipboardFiles": { + "args": { + "paths": "array" + }, + "required": [] + }, + "clipboardPin": { + "args": { + "id": "string" + }, + "required": [] + }, + "copyText": { + "args": { + "text": "string" + }, + "required": [ + "text" + ] + }, + "customTheme": { + "args": { + "colors": "object", + "glass": "boolean", + "opacity": "number" + }, + "required": [] + }, + "desktopClose": { + "args": { + "index": "number" + }, + "required": [] + }, + "desktopNew": { + "args": {}, + "required": [] + }, + "desktopSwitch": { + "args": { + "index": "number", + "relative": "number" + }, + "required": [] + }, + "deviceMute": { + "args": { + "id": "string", + "muted": "boolean" + }, + "required": [] + }, + "deviceSelect": { + "args": { + "id": "string" + }, + "required": [] + }, + "deviceVolume": { + "args": { + "id": "string", + "value": "number" + }, + "required": [] + }, + "dictation": { + "args": {}, + "required": [] + }, + "dictationCapture": { + "args": { + "enabled": "boolean" + }, + "required": [] + }, + "dockApp": { + "args": { + "action": "string", + "confirmed": "boolean", + "hwnd": "number", + "id": "string", + "index": "number" + }, + "required": [] + }, + "dockLayout": { + "args": { + "bar": "array", + "drawer": "array" + }, + "required": [] + }, + "dockPreview": { + "args": { + "cx": "number", + "cy": "number", + "dpr": "number", + "id": "string", + "x": "number", + "y": "number" + }, + "required": [] + }, + "dockPreviewEnd": { + "args": { + "now": "boolean" + }, + "required": [] + }, + "edit": { + "args": { + "id": "string" + }, + "required": [] + }, + "editEntry": { + "args": { + "category": "string", + "id": "string", + "name": "string" + }, + "required": [] + }, + "emptyRecycleBin": { + "args": {}, + "required": [] + }, + "entryIcon": { + "args": { + "id": "string", + "path": "string" + }, + "required": [] + }, + "explorerFolder": { + "args": {}, + "required": [] + }, + "explorerOpen": { + "args": {}, + "required": [] + }, + "explorerPalette": { + "args": { + "accent": "string", + "background": "string", + "text": "string" + }, + "required": [] + }, + "explorerReport": { + "args": {}, + "required": [] + }, + "explorerRestore": { + "args": {}, + "required": [] + }, + "favorite": { + "args": { + "id": "string" + }, + "required": [] + }, + "fileCancel": { + "args": {}, + "required": [] + }, + "fileOpen": { + "args": { + "gen": "number", + "index": "number" + }, + "required": [ + "index" + ] + }, + "fileResults": { + "args": {}, + "required": [] + }, + "fileSearch": { + "args": { + "gen": "number", + "term": "string" + }, + "required": [ + "term" + ] + }, + "icon": { + "args": { + "id": "string" + }, + "required": [] + }, + "launch": { + "args": { + "id": "string" + }, + "required": [] + }, + "locate": { + "args": {}, + "required": [] + }, + "lockNow": { + "args": {}, + "required": [] + }, + "lockSetPassword": { + "args": { + "current": "string", + "password": "string" + }, + "required": [] + }, + "lockSettings": { + "args": { + "enabled": "boolean", + "idleSeconds": "number" + }, + "required": [] + }, + "lockShown": { + "args": {}, + "required": [] + }, + "lockUnlock": { + "args": { + "password": "string" + }, + "required": [] + }, + "masterMute": { + "args": { + "muted": "boolean" + }, + "required": [] + }, + "media": { + "args": { + "action": "string", + "value": "number" + }, + "required": [] + }, + "mediaVolume": { + "args": { + "value": "number" + }, + "required": [] + }, + "microphone": { + "args": {}, + "required": [] + }, + "move": { + "args": { + "board": "string", + "id": "string" + }, + "required": [] + }, + "openBluetooth": { + "args": {}, + "required": [] + }, + "openFiles": { + "args": {}, + "required": [] + }, + "palette": { + "args": {}, + "required": [] + }, + "paletteRun": { + "args": { + "id": "string", + "kind": "string", + "query": "string" + }, + "required": [] + }, + "peripheralKind": { + "args": { + "id": "string", + "kind": "string" + }, + "required": [] + }, + "peripheralVisibility": { + "args": { + "id": "string", + "visible": "boolean" + }, + "required": [] + }, + "peripheralsRefresh": { + "args": {}, + "required": [] + }, + "preference": { + "args": { + "enabled": "boolean", + "key": "string", + "value": "string" + }, + "required": [ + "key" + ] + }, + "profiles": { + "args": {}, + "required": [] + }, + "quit": { + "args": {}, + "required": [] + }, + "quickToggle": { + "args": { + "enabled": "boolean", + "id": "string" + }, + "required": [ + "id" + ] + }, + "radio": { + "args": { + "kind": "string" + }, + "required": [] + }, + "raiseMedia": { + "args": {}, + "required": [] + }, + "recycleFiles": { + "args": { + "paths": "array" + }, + "required": [] + }, + "refreshCatalogue": { + "args": {}, + "required": [] + }, + "restoreTaskbar": { + "args": {}, + "required": [] + }, + "reveal": { + "args": { + "id": "string" + }, + "required": [] + }, + "runningRefresh": { + "args": {}, + "required": [] + }, + "sessionMute": { + "args": { + "id": "string", + "muted": "boolean" + }, + "required": [] + }, + "sessionVolume": { + "args": { + "id": "string", + "value": "number" + }, + "required": [] + }, + "sensorsInstall": { + "args": { + "driver": "boolean" + }, + "required": [] + }, + "sensorsRemove": { + "args": {}, + "required": [] + }, + "settings": { + "args": { + "section": "string" + }, + "required": [] + }, + "shortcut": { + "args": { + "combo": "string", + "id": "any", + "key": "number", + "kind": "string", + "modifiers": "number" + }, + "required": [] + }, + "shortcut-reset": { + "args": { + "id": "string" + }, + "required": [] + }, + "socialEnable": { + "args": { + "enabled": "boolean", + "id": "string" + }, + "required": [] + }, + "socialGlobalMute": { + "args": { + "muted": "boolean" + }, + "required": [] + }, + "socialHistoryClear": { + "args": {}, + "required": [] + }, + "socialHistoryRemove": { + "args": { + "seq": "number" + }, + "required": [ + "seq" + ] + }, + "socialLogin": { + "args": { + "id": "string" + }, + "required": [] + }, + "socialLogout": { + "args": { + "id": "string" + }, + "required": [] + }, + "socialMute": { + "args": { + "id": "string", + "muted": "boolean" + }, + "required": [] + }, + "socialOpen": { + "args": { + "id": "string" + }, + "required": [] + }, + "socialSound": { + "args": { + "enabled": "boolean" + }, + "required": [] + }, + "socialTestSound": { + "args": {}, + "required": [] + }, + "socialVolume": { + "args": { + "value": "number" + }, + "required": [] + }, + "state": { + "args": {}, + "required": [] + }, + "systemAction": { + "args": { + "confirmed": "boolean", + "id": "string" + }, + "required": [] + }, + "theme": { + "args": { + "dark": "boolean", + "mode": "string" + }, + "required": [] + }, + "toolRun": { + "args": { + "id": "string" + }, + "required": [] + }, + "tools": { + "args": {}, + "required": [] + }, + "uninstall": { + "args": { + "keepData": "boolean" + }, + "required": [] + }, + "visualizer": { + "args": {}, + "required": [] + }, + "volume": { + "args": { + "value": "number" + }, + "required": [] + }, + "wallpaperApply": { + "args": { + "display": "number", + "path": "string" + }, + "required": [ + "path" + ] + }, + "wallpaperCapture": { + "args": { + "h": "number", + "token": "string", + "w": "number", + "x": "number", + "y": "number" + }, + "required": [] + }, + "wallpaperChanged": { + "args": {}, + "required": [] + }, + "wallpaperPicker": { + "args": {}, + "required": [] + }, + "website": { + "args": { + "id": "string" + }, + "required": [] + }, + "websites": { + "args": {}, + "required": [] + }, + "wifiConnect": { + "args": { + "password": "string", + "ssid": "string" + }, + "required": [ + "ssid" + ] + }, + "wifiForget": { + "args": { + "ssid": "string" + }, + "required": [ + "ssid" + ] + }, + "wifiPortal": { + "args": {}, + "required": [] + }, + "wifiSettings": { + "args": { + "page": "string" + }, + "required": [] + }, + "windowList": { + "args": {}, + "required": [] + }, + "overviewWindows": { + "args": {}, + "required": [] + }, + "lyrics": { + "args": { + "title": "string", + "artist": "string", + "album": "string", + "duration": "number", + "key": "string" + }, + "required": [ + "title" + ] + }, + "overviewAct": { + "args": { + "hwnd": "string", + "action": "string" + }, + "required": [ + "hwnd", + "action" + ] + }, + "winjets.add": { + "args": { + "packageId": "string", + "screen": "string", + "x": "number", + "y": "number" + }, + "required": [ + "packageId" + ] + }, + "winjets.import": { + "args": { + "path": "string" + }, + "required": [ + "path" + ] + }, + "winjets.inspect": { + "args": { + "path": "string" + }, + "required": [ + "path" + ] + }, + "winjets.recoverAll": { + "args": {}, + "required": [] + }, + "winjets.refresh": { + "args": { + "instanceId": "string" + }, + "required": [ + "instanceId" + ] + }, + "winjets.remove": { + "args": { + "instanceId": "string" + }, + "required": [ + "instanceId" + ] + }, + "winjets.setEditMode": { + "args": { + "enabled": "boolean" + }, + "required": [] + }, + "winjets.setOpacity": { + "args": { + "instanceId": "string", + "opacity": "number|null" + }, + "required": [ + "instanceId" + ] + }, + "winjets.setGeometry": { + "args": { + "instanceId": "string", + "geometry": "object" + }, + "required": [ + "instanceId", + "geometry" + ] + }, + "winjets.setHidden": { + "args": { + "instanceId": "string", + "hidden": "boolean" + }, + "required": [ + "instanceId" + ] + }, + "winjets.setSettings": { + "args": { + "instanceId": "string", + "settings": "object" + }, + "required": [ + "instanceId", + "settings" + ] + }, + "winjets.setState": { + "args": { + "instanceId": "string", + "key": "string", + "value": "any" + }, + "required": [ + "instanceId", + "key", + "value" + ] + }, + "winjets.uninstall": { + "args": { + "packageId": "string" + }, + "required": [ + "packageId" + ] + }, + "workspace": { + "args": { + "id": "string" + }, + "required": [] + }, + "zipFiles": { + "args": { + "paths": "array" + }, + "required": [] + } + }, + "preferenceKeys": { + "accentBorders": { + "enabled": "boolean" + }, + "activeBorderOnly": { + "enabled": "boolean" + }, + "autoTile": { + "enabled": "boolean" + }, + "autostart": { + "enabled": "boolean" + }, + "bookmarksRailVisible": { + "enabled": "boolean" + }, + "clipboardHistory": { + "enabled": "boolean" + }, + "clipboardImages": { + "enabled": "boolean" + }, + "clipboardLimit": { + "value": "number" + }, + "customGlassOpacity": { + "value": "number" + }, + "desktopIndicator": { + "enabled": "boolean" + }, + "desktopLogo": { + "enabled": "boolean" + }, + "dictationEnabled": { + "enabled": "boolean" + }, + "dictationKey": { + "value": "number" + }, + "dockDrawerOpen": { + "enabled": "boolean" + }, + "dockVisible": { + "enabled": "boolean" + }, + "dockWidth": { + "value": "number" + }, + "explorerTheme": { + "enabled": "boolean" + }, + "filesDefaultHandler": { + "enabled": "boolean" + }, + "filesPreload": { + "enabled": "boolean" + }, + "frameThickness": { + "value": "number" + }, + "glassOpacity": { + "value": "number" + }, + "iconSize": { + "value": "number" + }, + "motion": { + "value": "number" + }, + "osd": { + "enabled": "boolean" + }, + "lyrics": { + "enabled": "boolean" + }, + "peripheralBattery": { + "enabled": "boolean" + }, + "pill": { + "enabled": "boolean" + }, + "quietFullscreen": { + "enabled": "boolean" + }, + "reducedEffects": { + "enabled": "boolean" + }, + "replaceTaskbar": { + "enabled": "boolean" + }, + "screenFrame": { + "enabled": "boolean" + }, + "socialBackground": { + "enabled": "boolean" + }, + "socialRailVisible": { + "enabled": "boolean" + }, + "taskbar": {}, + "tileExclusionRemove": { + "value": "string" + }, + "topActivationMargin": { + "value": "number" + } + }, + "replyKeys": { + "state": "object", + "events": "array", + "notice": "string|null", + "wallpaperCapture": "object|null", + "bookmarksItems": "array|null", + "windows": "array|null", + "fileResults": "object|null", + "lyrics": "object|null", + "wallpaperPicker": "object|null", + "dictation": "object", + "audioBars": "object", + "spectrum": "array" + }, + "stateKeys": [ + "systemRecent", + "wallpapers", + "wallpaperRevision", + "audioReadMs", + "audioMixer", + "quickTabs", + "social", + "bookmarks", + "settings", + "clipboard", + "diagnostics", + "dark", + "taskbarEnabled", + "networkKind", + "virtualDesktops", + "fullscreenMonitors", + "quiet", + "quietForced", + "performance", + "sysInfo", + "media", + "controls", + "quick", + "lock", + "apps", + "favorites", + "recent", + "launchCounts", + "websites", + "profiles", + "taskbarApps", + "runningApps", + "icons", + "iconRevision", + "winjets", + "desktop", + "peripherals", + "location" + ], + "events": [ + "toggle", + "access", + "media", + "performance", + "controls", + "palette", + "settings", + "settings:social", + "settings:bookmarks", + "clipboard", + "audio", + "microphone", + "tools", + "capture", + "capture-ocr", + "capture-select", + "wallpaper-switcher", + "overview", + "close", + "bookmarks", + "social", + "files", + "lyrics", + "quick", + "lock", + "sensors", + "dock", + "dictation:start", + "dictation:stop", + "dictation:keycancel", + "desktop.explorerRestarted" + ], + "clientOnlyEvents": [ + "mixer" + ], + "eventPrefixes": [ + "workspace:", + "osd:volume:", + "osd:brightness:", + "shortcut-key:", + "shortcut-saved:", + "osd:mic:", + "dictation:key:" + ] +} \ No newline at end of file diff --git a/docs/history/caelestia-windows.md b/docs/history/caelestia-windows.md new file mode 100644 index 0000000..203d6dd --- /dev/null +++ b/docs/history/caelestia-windows.md @@ -0,0 +1,57 @@ +# Historique : portage Caelestia pour Windows + +Synthèse des notes de portage 8.1 à 9.3 (anciennement `docs/history/caelestia-windows/`, supprimées ; elles restent +consultables dans l'historique git). Le détail courant vit dans `docs/ARCHITECTURE.md` et `docs/BRIDGE.md`. + +## Origine et licence + +- Amont : [Caelestia Shell](https://github.com/caelestia-dots/shell) (caelestia-dots et contributeurs), tag **v1.4.0**, + commit `04bfc87f65d6e13b287358e1024d9bbc055b0c58`. Ce tag correspond aux captures de référence du thème. +- Licence : GPLv3. Le portage est distribué avec son code source ; voir `LICENSE`, `THIRD_PARTY_NOTICES.md` et + `src/backend/LICENSE-CAELESTIA.txt`. +- Le dépôt ne contient pas de copie de l'amont (pas de dossier `upstream/`). La correspondance des fichiers et les + empreintes d'origine sont dans `src/frontend/UPSTREAM.json` ; les empreintes du portage dans + `src/frontend/PORT_PATCHES.json`. `src/frontend/prepare_port.py` documente l'extraction initiale, pas la + reconstruction : ne pas remplacer les QML livrés par une extraction brute de l'amont. + +## Ce qui vient de Caelestia + +Dashboard, calendrier, horloge, lecteur, visualiseur circulaire, bongocat, jauges, onglets, transitions, courbes +d'animation, boutons, ondulations au clic, menus, sliders, typographie et espacements. La bibliothèque et le lanceur +(8.1) ajoutent leurs propres sources QML. + +## Décisions structurantes + +- **Rendu** : Qt Quick 6.10 avec fenêtres natives transparentes (Direct3D 11), sans navigateur embarqué. +- **Remplacement des services Linux** : `frontend.py` remplace les services Quickshell par une connexion locale réservée + au compte Windows courant (pont décrit dans `docs/BRIDGE.md`). Les adaptateurs sont sous `qml/Quickshell`, + `qml/Caelestia` et `qml/qs/services`. +- **Backend** : .NET 8 (`Glass-v5`, projet `Panneaux.Glass`) : contrôle des médias via GSMTC, spectre par WASAPI + loopback et FFT (aucun enregistrement), télémétrie PC, volume, luminosité, connexions. +- **Sobriété** : capteurs arrêtés hors des pages Dashboard/Performance, spectre arrêté hors de Média, écritures des + sliders regroupées. +- **Dock** (8.x à 9.x) : bord physique inférieur, masquage automatique, zone de déclenchement de sept pixels, touche + Windows seule pour l'afficher (les combinaisons Win+lettre sont conservées). Réveil par événement Windows plutôt que + par attente périodique de 500 ms. Applications empaquetées et catalogue actualisés pendant l'affichage. +- **Menus du dock** (9.3) : clic droit sur une application (fenêtres, nouvelle fenêtre, administrateur, épingles, + favoris, Explorateur, fermeture) et sur le logo Windows (applications, alimentation, système, réseau, disques, + Terminal). Les fenêtres se ferment par `WM_CLOSE` ; arrêter un processus est une action distincte avec confirmation. +- **Filets de sécurité** : un gardien indépendant rétablit Explorer si le backend s'arrête ; un arrêt du frontend + rétablit la barre Windows ; `RETABLIR_BARRE_WINDOWS.exe` et `SECOURS_BUREAU.exe` restent disponibles (voir + `docs/RESTORE.md`). +- **Préférences** : fichier `preferences-glass.json` à côté du backend ; caches Qt sous `%LOCALAPPDATA%`. Favoris, + récents et profils ne sont jamais remplacés par des données de test. +- **Météo** : facultative, données [Open-Meteo](https://open-meteo.com/) (CC BY 4.0) ; configurer l'offre du fournisseur + adaptée avant une distribution commerciale. + +## Limites connues + +- Températures dépendantes des sondes et pilotes disponibles. +- Superposition soumise aux restrictions Windows pour les jeux en plein écran exclusif. +- Au portage initial, aucun installateur autonome ; il est venu ensuite avec `installer/` (Inno Setup). + +## Validation d'époque + +Chaque version 8.1 à 9.3 a été validée par captures et rapports JSON (pages, ouverture et fermeture des menus, arrêt des +capteurs, absence d'avertissement QML), puis par tests isolés des favoris, épingles et fermetures de fenêtres. Ces +artefacts n'ont pas été conservés ; les tests actuels sont décrits dans `docs/TESTS.md`. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.1.md b/docs/history/caelestia-windows/AMELIORATIONS-8.1.md deleted file mode 100644 index 72a6483..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.1.md +++ /dev/null @@ -1,44 +0,0 @@ -# Panneaux 8.1 — bibliothèque et lanceur Caelestia - -Le dépôt officiel [caelestia-dots/shell](https://github.com/caelestia-dots/shell) a été revérifié. Le portage conserve le tag v1.4.0 pour rester cohérent avec le thème choisi. Le lanceur ajoute ses sources `Content.qml`, `AppList.qml`, `AppItem.qml` et `LauncherConfig.qml` ; leurs origines et modifications figurent dans les manifestes. - -## Navigation et dock - -- Une application maximisée avec une barre de titre ne bloque plus la détection du bord inférieur. -- Une zone de sept pixels déclenche le dock. Atteindre volontairement le bord l’affiche même devant une application plein écran ; il reste masqué pendant l’usage normal de cette application. -- Les commandes ouvertes depuis le dock restent présentes jusqu’à Échap ou un clic extérieur. -- Un numéro de navigation empêche une ancienne fermeture de replier une vue qui vient d’être ouverte. -- Un événement Windows réveille le canal local à la demande : les raccourcis ne dépendent plus de l’attente périodique de 500 ms. - -## Bibliothèque - -Applications, Jeux, Projets et Documents ouvrent désormais une bibliothèque Qt : espaces latéraux, catégories, recherche, favoris, récents, tri et modes grille/liste. Le rendu est virtualisé ; seules les icônes nécessaires sont chargées. Le clic droit permet de renommer, catégoriser, choisir une icône et ranger un accès dans un autre espace. Les fichiers restent à leur emplacement. - -L’onglet Workspaces du tableau de bord présente quatre cartes d’accès, les favoris et les récents. L’interface précédente reste disponible avec le mode de secours ; elle n’est plus utilisée pour ces vues. - -## Ctrl + F2 et fonctions ajoutées - -Le lanceur utilise les composants visuels et les transitions Caelestia avec les services Windows : applications, onglets rapides conservés, sites, commandes préfixées par `>` et calcul direct. Les flèches sélectionnent un résultat et Entrée l’ouvre ; un calcul est copié à la demande. - -Les paramètres Qt regroupent les deux thèmes, les animations, la taille des icônes, le dock, le démarrage Windows, les raccourcis et l’historique. Le presse-papiers utilise également les surfaces et listes Caelestia, avec recherche, copie et épinglage. Les outils spécialisés Windows existants restent accessibles. - -## Correspondance avec Caelestia - -| Module examiné | Adaptation Windows | -| --- | --- | -| Dashboard / Media / Performance | Pages originales et services Windows conservés | -| Launcher | Composants importés, recherche locale et commandes Windows | -| Control center | Contrôles Caelestia raccordés au son, DDC/CI et radios Windows | -| Workspaces / Hyprland | Bibliothèque d’accès et profils Panneaux ; le compositeur Linux n’est pas utilisé | -| Sidebar / notifications | Le système de notifications Windows existant reste accessible via les outils | -| Schemes / wallpaper / power services | Thèmes clair/sombre repris ; services propres à Linux non chargés sous Windows | - -## Validation - -`tests/test_interaction_search.py` couvre le dock, les fenêtres maximisées, le plein écran, les calculs et la recherche. `tests/check_bridge.py` vérifie les changements de métadonnées dans le backend isolé uniquement, puis les rétablit. Les quinze vues, les captures, les erreurs QML et la veille des capteurs sont vérifiées dans `validation-8.1/report.json`. - -Les préférences de test ne sont jamais recopiées sur l’installation. Une sauvegarde de la version 8.0 se trouve dans `../Glass-v5/checkpoint-20261025-before-8.1` ; le secours du Bureau reste indépendant et inchangé. - -## Correctif du 26 octobre : dock indépendant - -Le dock est explicitement séparé de la fenêtre supérieure (`transientParent: null`). Le test natif `tests/check_dock_lifecycle.py` reproduit la panne précédente et vérifie cinq phases, dont une apparition avant toute ouverture du haut et une réapparition après fermeture. Les rapports avant/après sont dans `validation-8.1/dock-lifecycle-before.json` et `dock-lifecycle.json`. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.2.md b/docs/history/caelestia-windows/AMELIORATIONS-8.2.md deleted file mode 100644 index ccda6b0..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.2.md +++ /dev/null @@ -1,15 +0,0 @@ -# Panneaux 8.2 — Atelier et audio natifs Caelestia - -L’atelier, les sorties audio, les microphones et la capture utilisent maintenant les composants Qt de Caelestia : couleurs du thème, icônes Material, courbes d’animation, boutons et curseurs d’origine. Les accès à l’historique ouvrent la vue Qt existante. Ces vues restent dans la fenêtre native superposée ; aucun navigateur n’est nécessaire. - -Dans **Commandes rapides**, la flèche à droite du volume déploie le **mixeur d’applications** sur le côté. Le groupe reste centré pendant son agrandissement. Chaque application ayant une session audio Windows dispose de son volume et de son bouton muet. Les sessions d’une même application sont regroupées, y compris sur plusieurs sorties. Windows conserve ses réglages audio. Une application sans session apparaît dès qu’elle crée une lecture audio ; aucune liste artificielle d’applications silencieuses n’est affichée. - -Les vues **Sortie audio** et **Microphones** permettent de choisir le périphérique par défaut et de régler son niveau ou son bouton muet. Le microphone n’est pas enregistré. Les lectures des sessions s’arrêtent lorsque ces vues et le mixeur sont fermés. Les changements de valeur mettent à jour les délégués existants afin de garder un curseur stable sous la souris. - -La capture propose sélection de zone, crayon, surligneur, annulation, copie, enregistrement PNG, reconnaissance de texte Windows et épinglage. **Ctrl F3** ouvre la sélection native. L’image reste en mémoire ; un fichier temporaire n’est créé que pour transmettre une capture à l’OCR ou à l’épinglage. L’OCR rejoint le presse-papiers. La capture concerne l’écran où se trouve la souris ; l’enregistrement permet de choisir un fichier. - -Les outils spécialisés déjà existants (pipette, règle, papiers épinglés, gros fichiers et profils) restent accessibles depuis le nouvel atelier. Leur moteur historique est conservé. La version de secours du Bureau n’a pas été modifiée. - -Validation : `validation-8.2/tools-report.json`, `validation-8.2/live-report.json` et `validation-8.2/audio-mixer-verification.json`. Le test audio crée sa propre session silencieuse, vérifie gain, muet, réactivation et bornes, puis restaure ses valeurs. Il vérifie également que les volumes des autres applications restent inchangés. Les tests de cycle de vie du dock et les tests de recherche/raccourcis sont conservés. - -Sauvegardes avant modification : `Glass-v5/checkpoint-20261026-before-8.2` et `Caelestia-Windows/checkpoint-8.1-tools/frontend.zip`. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.3.md b/docs/history/caelestia-windows/AMELIORATIONS-8.3.md deleted file mode 100644 index 2d96601..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.3.md +++ /dev/null @@ -1,20 +0,0 @@ -# Panneaux 8.3 — Cadre Caelestia et thème du fond d’écran - -Un contour permanent de 12 pixels logiques entoure chaque écran. Il utilise le masque arrondi du composant `modules/drawers/Border.qml` de Caelestia. Le dock reprend le tracé inférieur de `modules/launcher/Background.qml`. Les fenêtres de ces contours sont natives, transparentes au clic et incapables de prendre le focus. Le panneau supérieur et le dock sortent maintenant du contour. Le contour se masque sur l’écran d’une application en plein écran et pendant une capture. - -Windows réserve une marge de 20 pixels logiques sur chaque bord, ajustée au DPI. Les fenêtres maximisées suivent cette zone de travail ; les fenêtres ordinaires ouvertes ou déplacées sont ramenées à l’intérieur si elles débordent. Le plein écran reste exclu de ce placement. La réservation utilise les appbars Windows et leurs fenêtres de contrôle : elle disparaît avec le processus. À la fermeture normale, Panneaux retire les réservations et restitue les positions qu’il a ajustées, tant qu’elles n’ont pas été modifiées entre-temps. Le réglage **Cadre de l’écran** permet également de le désactiver. - -Dans **Personnaliser → Apparence**, trois modes sont disponibles : **Porcelaine**, **Nuit** et **Automatique**. Les deux palettes fixes sont conservées. Le mode automatique lit le fond déclaré par Windows pour chaque écran, puis produit une palette Material You : surfaces, textes, pictogrammes et contrôles. Les familles de teintes sont regroupées pour identifier la couleur dominante ; les fonds monochromes restent neutres. La luminosité moyenne du fond décide de la variante claire ou sombre. - -Le fond d’écran n’est jamais capturé à l’écran et n’est envoyé à aucun service. Windows est interrogé toutes les cinq secondes ; une nouvelle analyse n’est faite que si le fichier ou sa date de modification change. Le calcul travaille sur une miniature de 128 pixels, sur un fil distinct. Pour les logiciels de fond animé qui ne publient pas leur image via Windows, la référence utilisée est l’image déclarée par Windows. - -Le mixeur audio dispose maintenant de son propre fil COM : détection des périphériques, recherche des sessions et réglages des applications ne s’exécutent plus sur le fil de l’interface. L’ouverture d’une vue active ce service sans attendre la détection. Les valeurs se mettent à jour ensuite et le suivi s’arrête à la fermeture. Les transitions des menus audio et des commandes rapides passent de 350 à 210 ms à l’échelle normale, en conservant les courbes de Caelestia. - -Validation locale : - -- `validation-8.3/theme-report.json` : palettes bleue, jaune, monochrome, contraste, transparence du contour, passage des clics, plein écran et capture. -- `validation-8.3/frame-verification.json` : réservation réelle des quatre bords Windows et restitution de la zone de travail. -- `validation-8.3/audio-mixer-verification.json` : réglages réels d’une session silencieuse dédiée et activation asynchrone du service audio. -- `validation-8.3/live-report.json` : parcours des menus avec les périphériques et le fond d’écran de ce PC, premières images rendues et mesure au repos. - -Sources originales : [Caelestia Shell](https://github.com/caelestia-dots/shell), commit `04bfc87f65d6e13b287358e1024d9bbc055b0c58`. Adaptation Windows et correspondance dans `PORT_PATCHES.json`. Sauvegardes avant cette version : `Glass-v5/checkpoint-20261026-before-8.3` et `Caelestia-Windows/checkpoint-8.2-adaptive/frontend.zip`. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.4.md b/docs/history/caelestia-windows/AMELIORATIONS-8.4.md deleted file mode 100644 index 80ca7ed..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.4.md +++ /dev/null @@ -1,22 +0,0 @@ -# Panneaux 8.4 — Verre unifié et accents du fond réel - -Le contour passe de 12 à 16 pixels logiques. Le dashboard, le dock et le contour utilisent exactement la même couleur et la même opacité ; le trait extérieur des panneaux et le recouvrement d’un pixel à leur jonction sont supprimés. Porcelaine et Nuit restent opaques. - -En Automatique, les trois surfaces reçoivent un hôte Acrylic Windows séparé, découpé selon leur silhouette. Il floute le contenu réellement derrière les fenêtres, y compris un fond animé. Le centre du cadre reste absent de la région native. La matière utilise une base presque noire teintée selon le fond ; elle ne passe plus en blanc sur un fond lumineux. Les cartes et surfaces secondaires sont également translucides en Automatique et suivent ce même réglage. Le réglage **Personnaliser → Apparence → Transparence du verre**, de 5 à 80 %, agit immédiatement et est enregistré. - -La palette utilise la présence chromatique : pixels saturés et visibles regroupés en familles de teintes. Les ombres bleues très sombres ne prennent plus le dessus sur les fleurs rouges. Les pictogrammes de navigation et les contrôles reprennent cet accent ; les logos des applications conservent leur identité. Les fonds monochromes gardent des accents neutres. Le contraste des accents et du texte est contrôlé sans décaler la teinte. - -Le logiciel lit toujours le fond Windows par écran. Quand DesktopHut est actif, il lit aussi sa configuration, y compris les chemins virtualisés MSIX, et analyse la miniature du fond réellement sélectionné. Il ne dépend donc plus du vieux fond statique Windows pendant la lecture de la vidéo. Le fond actuel dark-knight-in-red-flowers produit l’accent #fa3c5b. Le changement de source est recherché toutes les quatre secondes ; Windows actualise sa liste toutes les cinq secondes. Les configurations DesktopHut sont lues uniquement. Les autres moteurs non reconnus utilisent la source publiée par Windows. - -Le suivi du verre est déclenché par les mouvements, dimensions, visibilité et changements de thème, avec une surveillance légère toutes les 250 ms. La fermeture différée du contenu du dashboard ne dépend plus de sa propre hauteur animée, ce qui supprime une boucle de liaison QML à la réouverture. - -## Vérification - -- 27 vérifications Python : comportement du dock, recherche et accents rouge/bleu/vert/jaune/neutre, ombres sombres et contraste. -- validation-8.4/theme-report.json : comparaison des pixels des trois surfaces, alpha réglable, modes opaques, régions natives, passage des clics, plein écran, capture et absence d’avertissements QML. -- validation-8.4/native-blur-report.json : bandes de 8 pixels derrière une fenêtre transparente ; l’écart type passe d’environ 79 à moins de 1 après activation du verre. -- validation-8.4/live-material-report.json : fond réel DesktopHut, accent rouge, bascule des modes, retour du réglage par le backend et persistance sur disque. - -Sauvegardes : checkpoint-8.3-before-8.4 et ../Glass-v5/checkpoint-20261026-before-8.4. Les sources C++ et le script build-qt-glass.cmd sont inclus ; aucun nouveau paquet Python n’est requis. - -Références : [DWM et régions de flou](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/ns-dwmapi-dwm_blurbehind), [composition des fenêtres](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setwindowpos). La couche Acrylic réutilise le mécanisme Windows déjà employé par le backend ; sa fenêtre de rendu est maintenant placée immédiatement sous le contenu Qt. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.5.md b/docs/history/caelestia-windows/AMELIORATIONS-8.5.md deleted file mode 100644 index 9c5cadc..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.5.md +++ /dev/null @@ -1,19 +0,0 @@ -# Panneaux 8.5 — Correction du voile noir et épaisseur réglable - -La couche Acrylic du cadre ne possède plus de fenêtre de la taille de l’écran avec un trou central. Elle utilise huit fenêtres natives bornées : quatre bandes et quatre coins. Même si le compositeur applique un fond opaque ou ignore un découpage, ces fenêtres ne peuvent pas peindre le centre du bureau. - -Les auxiliaires restent cachés jusqu’à la validation complète de leur géométrie. Les dimensions invalides, un découpage refusé ou une mise à jour incohérente masquent le verre. L’API destinée aux panneaux refuse les fenêtres presque aussi larges et hautes qu’un écran. Les auxiliaires ne changent plus le propriétaire des fenêtres Qt, ne reçoivent pas les clics et disparaissent à la destruction ou au masquage du contenu. La réapparition après masquage natif est également vérifiée. - -Le réglage **Personnaliser → Apparence → Épaisseur des contours** va de **4 à 40 pixels logiques**, dans les trois thèmes, avec 16 px par défaut. Le cadre, le raccord du dashboard et le dock suivent immédiatement cette valeur. Windows réserve l’épaisseur choisie plus quatre pixels pour les applications. La valeur est enregistrée dans les préférences. Le curseur de transparence reste disponible dans le mode Automatique. - -Validation de la version : - -- `validation-8.5/desktop-regression-report.json` : véritable capture du bureau de test sous le compositeur, pixels centraux inchangés à 4/16/40 px, auxiliaires bornés, refus d’un voile plein écran, fermeture en cas d’erreur, masquage/réaffichage et destruction. -- `validation-8.5/theme-report.json` : trois surfaces identiques, transparence, thèmes fixes opaques, géométrie native et QML, changement d’épaisseur, plein écran et capture. -- `validation-8.5/native-blur-report.json` : flou réel conservé derrière une fenêtre de test. -- `validation-8.5/live-thickness-report.json` : curseur, frontend, backend et disque synchronisés ; marges Windows réellement mesurées à 8, 20 et 44 px pour des épaisseurs de 4, 16 et 40 px. -- Les 27 vérifications Python de recherche, comportement du dock et palette passent. - -Sauvegardes : `checkpoint-8.4-before-8.5` et `../Glass-v5/checkpoint-20261026-before-8.5`. Préférences précédentes conservées. L’application reste fermée après l’installation pour le test final de dj. - -Le masquage des icônes du bureau est rétabli au démarrage normal. Les icônes sont réaffichées à la fermeture ou si le moteur Qt s’arrête. Le cycle démarrage/fermeture a été vérifié sur Windows. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-8.6.md b/docs/history/caelestia-windows/AMELIORATIONS-8.6.md deleted file mode 100644 index e33d8ea..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-8.6.md +++ /dev/null @@ -1,13 +0,0 @@ -# Panneaux 8.6 — Suppression des rectangles noirs - -Les fonds Acrylic sont remplacés par des surfaces de composition transparentes. Le flou du contenu derrière chaque fenêtre est découpé par un masque géométrique au niveau du compositeur. Les zones extérieures à la forme restent transparentes. - -Le cadre conserve huit auxiliaires bornés aux bords et aux coins. Le dashboard et le dock utilisent le même masque. Transparence, épaisseur, thèmes et masquage des icônes du bureau sont conservés. - -Le test reproduit le défaut avec la DLL 8.5 : 1 936 pixels sombres dans les quatre zones de coin testées. La DLL 8.6 en produit zéro aux épaisseurs 4, 16 et 40 px. Les pixels du centre restent inchangés. Les tests de fermeture, masquage et destruction passent. - -Le test de flou conserve une luminance moyenne de 84/255 tout en supprimant les bandes fines : il vérifie un flou effectif et exclut un fond noir. Les contrôles QML des trois surfaces et des réglages passent sans avertissement. - -Rapports : validation-8.6/. baseline-corner-report.json utilise volontairement l’ancienne DLL ; son échec reproduit le défaut. Les autres rapports concernent la version corrigée. - -Sauvegardes : checkpoint-8.5-before-8.6 et ../Glass-v5/checkpoint-20261026-before-8.6. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-9.1.md b/docs/history/caelestia-windows/AMELIORATIONS-9.1.md deleted file mode 100644 index 2e76fee..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-9.1.md +++ /dev/null @@ -1,17 +0,0 @@ -# WinLestia / Panneaux 9.1 — Une matière continue - -Le cadre, le dashboard et le dock partagent désormais un seul fond par écran. `surface_geometry.py` calcule l’union de leurs silhouettes et fournit les mêmes courbes au rendu QML et au compositeur Windows. Main.qml et Dock.qml affichent leurs contenus, sans ajouter un autre fond. Les anciens ScreenBorder.qml et DockBackground.qml ne dessinent plus la matière courante. - -Le rendu natif utilise des courbes Direct2D, découpées en auxiliaires bornés. Le masque n’est plus une collection de rectangles issus des régions Win32. La silhouette commune évite les superpositions de transparence et les raccords divergents. - -Le curseur contrôle à la fois la teinte et la contribution du flou. Auparavant, le flou natif restait opaque même lorsque la teinte devenait transparente. Le produit des transmissions des deux couches correspond maintenant à la transparence demandée. Les surfaces des cartes internes sont plus légères. - -Plage de transparence : 5 à 98 %. Réglage choisi pour la relance : 88 %. Les changements faits ensuite dans l’interface restent enregistrés. Les thèmes Porcelaine et Nuit restent opaques ; les favoris, catégories, raccourcis et le masquage des icônes du bureau sont conservés. - -## Vérification - -`validation-9.1/surface-report.json` mesure une capture réelle sous Windows : mêmes pixels RGB sur les quatre échantillons cadre/dashboard/dock/cadre, aucune séparation inattendue dans les coins, transmission de contraste identique pour les trois surfaces à 88 %, 98 % et 50 %. L’écart aux frontières des auxiliaires natifs reste de 1 niveau RGB à forte transparence, au plus 2 niveaux dans les cas testés. Aucun avertissement QML ni erreur native. - -Les 32 tests Python passent. `live-startup-report.json` confirme le démarrage réel, le fond DesktopHut, les réglages et les auxiliaires bornés. `baseline-opaque-blur-report.json` décrit l’essai antérieur ayant montré qu’une simple réduction du rayon de flou ne suffisait pas : il ne concerne pas le matériau final. - -Sauvegardes : checkpoint-before-9.1 et ../Glass-v5/checkpoint-before-9.1. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-9.2.1.md b/docs/history/caelestia-windows/AMELIORATIONS-9.2.1.md deleted file mode 100644 index 0bc47b6..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-9.2.1.md +++ /dev/null @@ -1,9 +0,0 @@ -# WinLestia / Panneaux 9.2.1 — Correctif des clics à travers le verre - -Les auxiliaires natifs du flou étaient transparents visuellement mais leurs rectangles interceptaient les clics lorsqu’ils se trouvaient au-dessus d’une autre application. WS_EX_TRANSPARENT seul ne garantissait pas le passage entre applications ; les auxiliaires utilisent désormais WS_EX_LAYERED avec WS_EX_TRANSPARENT et une alpha globale de 255 pour conserver le rendu du compositeur. Un échec de configuration est contrôlé. - -Le test 9.2 avait placé la fenêtre cible devant les auxiliaires, masquant le défaut. Le test 9.2.1 replace explicitement les auxiliaires au premier plan avant les clics physiques. Le défaut est reproduit avec l’ancienne DLL : aucun clic transmis au bureau, à la marge ou à l’angle. Avec la DLL corrigée, les quatre clics (bureau, marge, angle et cadre) atteignent la fenêtre cible indépendante, et le bouton Applications ouvre son espace sans transmettre son clic. - -Les 14 contrôles du rendu passent toujours : matière identique sur cadre/dashboard/dock, angles propres et transparence conforme. L’application a été relancée ; les auxiliaires visibles possèdent effectivement les deux styles requis. Les réglages et les fichiers du backend 9.2.0 sont conservés. Les mesures de performances précédentes n’ont pas été répétées pour ce correctif natif. - -Rapports : validation-9.3/pointer-after.json, surface-report.json, live-input-report.json. Sauvegarde native : checkpoint-before-9.2.1. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-9.2.md b/docs/history/caelestia-windows/AMELIORATIONS-9.2.md deleted file mode 100644 index 99274d3..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-9.2.md +++ /dev/null @@ -1,17 +0,0 @@ -# WinLestia / Panneaux 9.2 — Clics, contours et fluidité - -Les fenêtres de contenu possèdent désormais un masque d’entrée natif correspondant à leur silhouette visible. Les marges et les angles transparents laissent passer les clics vers les applications situées derrière ; les commandes du dashboard restent interactives. Le masque suit aussi le déplacement du dock. - -En mode automatique, un liseré continu de 1 pixel à 23 % d’alpha permet de distinguer les formes, même lorsque le verre est très transparent. Il suit l’union cadre/dashboard/dock et ne dessine pas de raccords internes. La matière et le curseur de transparence restent communs aux trois surfaces. - -Le compositeur conserve ses auxiliaires natifs et ne recalcule que les cellules affectées par une animation. La fenêtre du dashboard conserve son tampon pendant l’ouverture : seule la silhouette change. Les onglets déjà visités restent chargés ; les animations médias sont suspendues lorsqu’elles ne sont pas affichées. Les animations imbriquées de taille ont été retirées et l’ouverture/fermeture utilise une courbe de décélération sur 260 ms, adaptée au réglage de mouvement. - -## Validation - -- 32 tests Python passent. -- 14 contrôles du rendu Windows passent : matière identique, coins propres, absence de raccords entre cellules, transmission identique à 50 %, 88 % et 98 %, aucun verre résiduel à la fermeture. -- Des clics physiques envoyés vers une fenêtre de test indépendante traversent le bureau, la marge et l’angle transparent. Le bouton Applications ouvre son espace sans transmettre le clic à cette fenêtre. -- Sur 12 transitions à 165 Hz, le temps natif médian vaut 0,26 ms et son 95e percentile 0,44 ms, contre 8,85 ms et 41,31 ms avant modification. Les intervalles d’images mesurés pendant les transitions ont une médiane de 6,71 ms, un 95e percentile de 16,95 ms et un maximum de 27,76 ms. Cela mesure ce scénario ; le maintien permanent de 165 images/s n’est pas garanti. -- Démarrage réel confirmé, masque natif présent, aucun nouveau message QML. Réglages conservés, y compris opacité 0,55 et épaisseur 31 au moment de la relance. Les icônes du bureau sont masquées normalement. - -Rapports dans validation-9.2/. Sauvegardes : checkpoint-before-9.2 et ../Glass-v5/checkpoint-before-9.2. Aucun favori, raccourci ou réglage personnel n’a été réinitialisé. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-9.3.md b/docs/history/caelestia-windows/AMELIORATIONS-9.3.md deleted file mode 100644 index e5931de..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-9.3.md +++ /dev/null @@ -1,11 +0,0 @@ -# Winlestia 9.3 — Menus du dock - -Clic droit sur une application : nom, chemin, nombre de fenêtres, activation d’une fenêtre précise, nouvelle fenêtre, lancement administrateur, épingler/détacher, favoris, Explorateur, réduire/agrandir, fermer une fenêtre ou toutes ses fenêtres. Ajouter aux favoris épingle aussi l’accès au dock ; retirer un favori conserve son épingle. Les accès externes sont enregistrés sans duplication. - -Clic droit sur le logo Windows : menu Winlestia des applications installées, alimentation, événements, système, périphériques, réseau, disques, gestion de l’ordinateur, Terminal normal/administrateur, gestionnaire des tâches, paramètres, panneau de configuration, Explorateur, recherche/exécution et bureau. Les outils Windows s’ouvrent depuis ce menu personnalisé ; leurs interfaces internes ne sont pas remplacées. - -Le bouton Applications près du son ouvre les applications en cours. Les fenêtres et les applications du catalogue reconnues en arrière-plan sont actualisées chaque seconde pendant que le dock est affiché. Ce panneau ne constitue pas une reproduction de la zone de notification native ni de ses menus spécifiques à chaque éditeur. - -Les fenêtres se ferment normalement avec WM_CLOSE, permettant aux applications de demander l’enregistrement. Arrêter l’application est une action distincte, soumise à une confirmation Winlestia ; les exécutables du dossier Windows et le processus du shell sont exclus de cet arrêt forcé. Les menus occupent une petite fenêtre indépendante, ferment à Échap ou après perte de focus et maintiennent le dock visible. - -Validation : les trois clics ouvrent leurs menus ; aucun avertissement QML ni erreur native dans ce scénario. Tests isolés des favoris, épingles, absence de doublons et fermeture de deux fenêtres d’un exécutable de test unique. Les 32 tests Python passent. Les réglages personnels ont été comparés avant/après relance et sont conservés. Sauvegarde : checkpoint-before-dock10. Rapports : validation-dock10/. diff --git a/docs/history/caelestia-windows/AMELIORATIONS-9.md b/docs/history/caelestia-windows/AMELIORATIONS-9.md deleted file mode 100644 index 23b1efb..0000000 --- a/docs/history/caelestia-windows/AMELIORATIONS-9.md +++ /dev/null @@ -1,118 +0,0 @@ -# Panneaux 9.0 — Une seule matière, une seule transparence - -Le cadre, le dashboard et le dock lisent maintenant la même valeur. Le réglage -« Transparence du verre » pilote les trois surfaces, et rien d'autre. - -## La ligne au raccord - -`ScreenBorder.qml` peignait la teinte du cadre dans une couche Qt (`layer.enabled`) -puis la découpait avec un `MultiEffect` masqué. La couleur était déjà semi-transparente -avant d'entrer dans la texture, puis composée une seconde fois à la sortie : l'alpha -réel du cadre tombait autour de 0,04 au lieu de 0,20. - -Mesure sur le bureau réel, même colonne, avant correction : - -| zone | couleur | -|---|---| -| cadre (y = 0…19) | 43, 72, 93 | -| dashboard (y = 22…) | 33, 42, 49 | - -Le cadre laissait donc passer le fond presque brut, sans teinte, alors que le -dashboard appliquait la sienne. D'où la ligne nette au raccord. - -Le cadre est désormais un `Shape` en anneau, rempli en `OddEvenFill` : un seul -tracé, aucune texture intermédiaire, aucun effet. L'alpha arrive à l'écran tel quel. - -## Une seule matière - -`Colours.qml` expose `surfaceBase` (couleur opaque de la palette) et `surfaceColor` -(`Qt.alpha(surfaceBase, surfaceOpacity)`). Le cadre, le dashboard et le dock -consomment tous les trois `surfaceColor`. Le cadre n'utilise plus sa propre -`paletteForScreen` pour son fond : plus de teinte parallèle, donc plus d'écart. - -## Plus de transparence - -- Curseur : 5 → 95 % (au lieu de 5 → 80 %). -- Bornes backend et frontend : alpha 0,05 → 0,95. -- Valeur en place : `GlassOpacity = 0.05`, soit 95 % de transparence — c'est la position - que dj a laissée sur le curseur. Le verre laisse franchement voir le bureau et le - texte des panneaux reste lisible. -- Épaisseur du cadre inchangée : 20 px. - -Porcelaine et Nuit restent opaques : hors mode Automatique, `surfaceOpacity` vaut 1 -et `surfaceColor` renvoie la couleur pleine, exactement comme avant. - -## Coins bas - -Deux défauts se cumulaient aux angles : - -1. les huit auxiliaires natifs avaient la taille exacte de leur bande (20 px). Un - flou gaussien de rayon 22 dans une fenêtre de 20 px est entièrement mangé par son - bord : le liseré dur du noyau tombait pile sur la limite entre deux pièces ; -2. la couche Qt du cadre ne peignait rien (voir plus haut), donc ces liserés - restaient seuls visibles. - -Chaque fenêtre native est maintenant agrandie vers l'intérieur de `max(56, 2 × épaisseur + rayon)` -pixels. Le noyau de flou se développe entièrement à l'intérieur de la fenêtre et son -bord dur tombe hors de la zone découpée. La zone découpée, elle, reste strictement -la même : huit pièces disjointes, jamais le centre du bureau. - -## Mesures - -`validation-9/seam-report.json` — colonne centrale, dashboard ouvert, même fond -visible des deux côtés : - -- cadre : 184,0 / 200,0 / 215,0 -- dashboard : 184,0 / 200,0 / 215,0 -- écart au raccord : **0,0** - -Un premier passage sur un fond bleu sombre donnait 48,0 / 62,0 / 80,0 de part et -d'autre, également à 0,0 d'écart. - -`validation-9/desktop-regression-report.json` — DLL de production, épaisseurs 4, 16 et 40 px : - -- 0 pixel noir dans les quatre coins pour chacune des trois épaisseurs ; -- 8 auxiliaires par cadre, aucun ne couvre le centre du bureau ; -- chaque auxiliaire reste une bande bornée (< 40 % de la surface de l'écran) ; -- pixels du centre du bureau inchangés ; -- géométrie invalide : tout est masqué, puis tout revient au rétablissement. - -Tests Python : 27/27 (palette chromatique et interaction/recherche). - -## La barre des tâches disparue - -Deux verrous se cumulaient. - -1. `QtShellBridge` appelait `owner.SetTaskbar(false)` quand le moteur Qt s'arrêtait. - Cette méthode écrivait `ReplaceTaskbar = false` dans les préférences : un simple - arrêt du frontend décidait donc, durablement, que la barre n'était plus voulue. - Au démarrage suivant, le secours n'était plus activé, et comme le dock Qt est - conditionné par `TaskbarEnabled` (lui-même `taskbar.Enabled`), le dock restait - caché pour toujours. Le 26/10 à 02:33:23, un arrêt du moteur Qt a suffi. - `SuspendTaskbar()` restaure maintenant la barre Windows **sans** réécrire la - préférence. Vérifié : frontend tué à 02:53:09, `ReplaceTaskbar` toujours à `true`. -2. En plein écran, `EdgePolicy` renvoyait `False` dès que la souris quittait les sept - derniers pixels de l'écran, sans regarder si elle était dans le dock. Le dock - s'ouvrait puis se refermait avant qu'on puisse cliquer une icône. Le test - `inside` passe désormais avant le test `fullscreen` : une fois révélé, le dock - reste tant que la souris est dedans. - -Le journal affiche maintenant `Démarrage Panneaux 9.0`. - -## Fichiers touchés - -Frontend : `qml/ScreenBorder.qml`, `qml/ScreenFrame.qml`, -`qml/qs/services/Colours.qml`, `qml/ShellPreferences.qml`, `frontend.py`, -`interaction.py`, `tests/test_interaction_search.py`, `QtGlassBackdrop.cpp`, -`QtGlassBackdrop.dll`. -Backend : `Coordinator.cs`, `Models.cs`, `QtShellBridge.cs`, -`preferences-glass.json`. - -## Sauvegardes - -`checkpoint-20261026-021942-avant-reprise` (frontend) et -`../Glass-v5/checkpoint-20261026-before-8.6` (backend) restent la référence 8.6. - -## En attente - -Le retour visuel de dj sur cette 9.0. Rien n'est déclaré validé avant. diff --git a/docs/history/caelestia-windows/PORTAGE.md b/docs/history/caelestia-windows/PORTAGE.md deleted file mode 100644 index 51ddaa5..0000000 --- a/docs/history/caelestia-windows/PORTAGE.md +++ /dev/null @@ -1,47 +0,0 @@ -# Panneaux 8.1 — portage Caelestia pour Windows - -L’interface utilise les sources QML de [Caelestia Shell](https://github.com/caelestia-dots/shell), tag **v1.4.0**, commit `04bfc87f65d6e13b287358e1024d9bbc055b0c58`. Cette version correspond aux captures de référence. Ce portage est distribué avec la GPLv3 et son code source. - -Voir aussi [les améliorations 8.1](AMELIORATIONS-8.1.md) pour la bibliothèque complète, Ctrl + F2, les paramètres et le dock. - -## Ce qui vient directement de Caelestia - -Dashboard, calendrier, horloge, lecteur, visualiseur circulaire, bongocat, jauges doubles, onglets, transitions de taille et de déplacement, courbes d’animation, boutons, ondulations au clic, menus, sliders, typographie et espacements. `UPSTREAM.json` conserve les chemins et empreintes d’origine ; `PORT_PATCHES.json` indique les empreintes du portage. `upstream/` reste la copie originale. - -## Adaptations Windows - -Qt Quick 6.10.3 rend des fenêtres natives transparentes avec Direct3D 11. Aucun navigateur n’est utilisé. `frontend.py` remplace les services Quickshell/Linux par une connexion locale réservée au compte Windows courant. Les adapters sont sous `qml/Quickshell`, `qml/Caelestia` et `qml/qs/services`. - -Le backend .NET 8 est dans `../Glass-v5/` : `QtShellBridge.cs`, `WindowsSpectrum.cs`, `WindowsDockKey.cs`, `MediaController.cs`, `PcTelemetry.cs`, `SystemAudio.cs`, `MonitorBrightness.cs`, `WindowsConnections.cs` et les outils Panneaux existants. Le quatrième onglet est adapté aux applications et fichiers Windows. - -La lecture audio utilise GSMTC ; le spectre utilise WASAPI loopback et une FFT, sans enregistrement audio. Les capteurs s’arrêtent hors des pages Dashboard/Performance. Le spectre s’arrête hors de Media. Les écritures des sliders sont regroupées pour éviter les commandes en attente. - -Le dock est au bord physique inférieur et se masque automatiquement. La touche Windows seule l’affiche ; les combinaisons Win+lettre sont conservées. Un gardien indépendant rétablit Explorer si le backend s’arrête. Un arrêt du frontend rétablit également la barre Windows. - -## Lancer et revenir en arrière - -`LANCER_CAELESTIA.cmd` lance le logiciel installé. Survoler le haut au centre affiche les quatre onglets ; Ctrl+F1 ouvre/replie le panneau. Le bas de l’écran fait apparaître le dock. Ses boutons son/Wi-Fi ouvrent les commandes Windows. Le clic droit sur un accès propose favoris, Explorateur et personnalisation. - -`REVENIR_A_PANNEAUX.ps1` désactive le nouveau frontend et relance l’interface précédente. `../Glass-v5/RETABLIR_BARRE_WINDOWS.exe` rétablit la barre Windows indépendamment. Le secours du Bureau dans Documents reste inchangé. - -Les préférences restent dans `../Glass-v5/preferences-glass.json`. Favoris, récents, sites et profils ne sont pas remplacés par les données de test. Les caches Qt sont dans `%LOCALAPPDATA%/Panneaux/Caelestia`. - -## Reconstruire - -Installer Python 3.12 et .NET SDK 8, puis : - -```powershell -python -m venv .venv -.\.venv\Scripts\python.exe -m pip install -r requirements.txt -dotnet publish ..\Glass-v5\Panneaux.Glass.csproj -c Release -o .\artifacts\backend -``` - -Les sources QML livrées contiennent déjà les adaptations : ne pas les remplacer par une extraction brute de l’upstream. `prepare_port.py` documente l’extraction initiale, pas la reconstruction finale. - -## Validation et limites - -`validation/report.json` et les PNG montrent les quatre pages avec les données du PC, la fermeture et l’arrêt des capteurs. `verification-qt-keys.json` vérifie les combinaisons Windows sans injecter de frappes. `validation/summary.json` contient les mesures de la dernière exécution. - -Les températures dépendent des sondes/pilotes disponibles. La superposition reste soumise aux restrictions Windows des jeux en plein écran exclusif. Le backend et les anciens outils Windows restent conservés ; ce premier portage n’est pas encore un installateur commercial autonome pour d’autres PC. - -La météo est facultative : cliquer sur la tuile pour choisir une ville. Données [Open-Meteo](https://open-meteo.com/), attribution CC BY 4.0 ; configurer l’offre du fournisseur adaptée avant une distribution commerciale. diff --git a/docs/history/caelestia-windows/PORT_PATCHES.json b/docs/history/caelestia-windows/PORT_PATCHES.json deleted file mode 100644 index db4c596..0000000 --- a/docs/history/caelestia-windows/PORT_PATCHES.json +++ /dev/null @@ -1,544 +0,0 @@ -{ - "upstreamCommit": "04bfc87f65d6e13b287358e1024d9bbc055b0c58", - "files": [ - { - "source": "components/Anim.qml", - "destination": "qml/qs/components/Anim.qml", - "sha256": "daf84b005a64e78d8f50c02b42edb9ca502b01dd0eafc8685bce3dc98d87164f", - "portedSha256": "daf84b005a64e78d8f50c02b42edb9ca502b01dd0eafc8685bce3dc98d87164f", - "modified": false - }, - { - "source": "components/CAnim.qml", - "destination": "qml/qs/components/CAnim.qml", - "sha256": "1634c7fd92a6bc0190d96fca86803e20ac528f114255d83adbf90cae71715a1f", - "portedSha256": "1634c7fd92a6bc0190d96fca86803e20ac528f114255d83adbf90cae71715a1f", - "modified": false - }, - { - "source": "components/ConnectionHeader.qml", - "destination": "qml/qs/components/ConnectionHeader.qml", - "sha256": "0e03f121d9406b6732fb5ac7439175a01c8d536cd7086706fea57c5ca27939c2", - "portedSha256": "0e03f121d9406b6732fb5ac7439175a01c8d536cd7086706fea57c5ca27939c2", - "modified": false - }, - { - "source": "components/ConnectionInfoSection.qml", - "destination": "qml/qs/components/ConnectionInfoSection.qml", - "sha256": "63eac37f457195fae4c2263da2f0d02f862474cf502ecadd187ce7f35dc926ec", - "portedSha256": "63eac37f457195fae4c2263da2f0d02f862474cf502ecadd187ce7f35dc926ec", - "modified": false - }, - { - "source": "components/MaterialIcon.qml", - "destination": "qml/qs/components/MaterialIcon.qml", - "sha256": "d870983245e4fcf9886a2b0ac6fd31fc3ed480b8f7bffb6511543db462b16a37", - "portedSha256": "7a152099c3187deab38b59451e690ec7049dab9111ec3e8daf586e80d3265de1", - "modified": true - }, - { - "source": "components/PropertyRow.qml", - "destination": "qml/qs/components/PropertyRow.qml", - "sha256": "cdcd744a0b3edff9e66182cd0bf4f00a7ee81d985b663bd6043bca24640a8dec", - "portedSha256": "cdcd744a0b3edff9e66182cd0bf4f00a7ee81d985b663bd6043bca24640a8dec", - "modified": false - }, - { - "source": "components/SectionContainer.qml", - "destination": "qml/qs/components/SectionContainer.qml", - "sha256": "9b5fe860b1a1ec67983fcf5fc1723202f323206ca6526e9f14d7ae88079bd623", - "portedSha256": "9b5fe860b1a1ec67983fcf5fc1723202f323206ca6526e9f14d7ae88079bd623", - "modified": false - }, - { - "source": "components/SectionHeader.qml", - "destination": "qml/qs/components/SectionHeader.qml", - "sha256": "1493475da6aeba138d558e6d6997103b687d4c06606f4ae27aeeec9fbffe6507", - "portedSha256": "1493475da6aeba138d558e6d6997103b687d4c06606f4ae27aeeec9fbffe6507", - "modified": false - }, - { - "source": "components/StateLayer.qml", - "destination": "qml/qs/components/StateLayer.qml", - "sha256": "811a93ca953af089eed2409e5c8fa41712698161a67bed8637e2d05c3465c99c", - "portedSha256": "811a93ca953af089eed2409e5c8fa41712698161a67bed8637e2d05c3465c99c", - "modified": false - }, - { - "source": "components/StyledClippingRect.qml", - "destination": "qml/qs/components/StyledClippingRect.qml", - "sha256": "9c7509b93a19c136e81e7c5b3e9b157736468b8a64961d1d2237b2dc61141745", - "portedSha256": "9c7509b93a19c136e81e7c5b3e9b157736468b8a64961d1d2237b2dc61141745", - "modified": false - }, - { - "source": "components/StyledRect.qml", - "destination": "qml/qs/components/StyledRect.qml", - "sha256": "2555d0dc4a18ec897238cc1594fbc4ab32522ad1ac09679337e2b5de25500f2d", - "portedSha256": "2555d0dc4a18ec897238cc1594fbc4ab32522ad1ac09679337e2b5de25500f2d", - "modified": false - }, - { - "source": "components/StyledText.qml", - "destination": "qml/qs/components/StyledText.qml", - "sha256": "5ecb84234195763bb52da29392a1c55ce047bd3b8be989be723f2e43a9274ad8", - "portedSha256": "5ecb84234195763bb52da29392a1c55ce047bd3b8be989be723f2e43a9274ad8", - "modified": false - }, - { - "source": "components/containers/StyledFlickable.qml", - "destination": "qml/qs/components/containers/StyledFlickable.qml", - "sha256": "35653286ea5ea0c1cb1e387c827a2097b61d04e9e31b2524e95933e8dc872258", - "portedSha256": "35653286ea5ea0c1cb1e387c827a2097b61d04e9e31b2524e95933e8dc872258", - "modified": false - }, - { - "source": "components/containers/StyledListView.qml", - "destination": "qml/qs/components/containers/StyledListView.qml", - "sha256": "15d8994170f60f3d012245947600dbb3f51bc4fb29394455dc578a753d820f27", - "portedSha256": "15d8994170f60f3d012245947600dbb3f51bc4fb29394455dc578a753d820f27", - "modified": false - }, - { - "source": "components/containers/StyledWindow.qml", - "destination": "qml/qs/components/containers/StyledWindow.qml", - "sha256": "e6d8bc5cf20a4e5e27ce7354c83902711ee66a40ac89c23347d1fb87653a95d4", - "portedSha256": "e6d8bc5cf20a4e5e27ce7354c83902711ee66a40ac89c23347d1fb87653a95d4", - "modified": false - }, - { - "source": "components/controls/CircularIndicator.qml", - "destination": "qml/qs/components/controls/CircularIndicator.qml", - "sha256": "b55d36c9d1697d40ba3d4d114eafaab5b563f4f7bb620c49753324abdcd271b2", - "portedSha256": "b55d36c9d1697d40ba3d4d114eafaab5b563f4f7bb620c49753324abdcd271b2", - "modified": false - }, - { - "source": "components/controls/CircularProgress.qml", - "destination": "qml/qs/components/controls/CircularProgress.qml", - "sha256": "498fcab5ec9a6c3c76bcaae10adf90c9469da01a87255dd9a6f2fe1040355436", - "portedSha256": "498fcab5ec9a6c3c76bcaae10adf90c9469da01a87255dd9a6f2fe1040355436", - "modified": false - }, - { - "source": "components/controls/CollapsibleSection.qml", - "destination": "qml/qs/components/controls/CollapsibleSection.qml", - "sha256": "d20d96f869fd85f03c4cfad8450474d00706c7bb48d1f54f1666da6f27581382", - "portedSha256": "d20d96f869fd85f03c4cfad8450474d00706c7bb48d1f54f1666da6f27581382", - "modified": false - }, - { - "source": "components/controls/CustomMouseArea.qml", - "destination": "qml/qs/components/controls/CustomMouseArea.qml", - "sha256": "d558f65cd6614bdb299c35309aef6fea9fb86a910149a7f1add37298b8caad71", - "portedSha256": "d558f65cd6614bdb299c35309aef6fea9fb86a910149a7f1add37298b8caad71", - "modified": false - }, - { - "source": "components/controls/CustomSpinBox.qml", - "destination": "qml/qs/components/controls/CustomSpinBox.qml", - "sha256": "acb1a8dc210104b2d68bfc908e7b745fa58a49dd244e69a63a0a4f1e4b189d9e", - "portedSha256": "acb1a8dc210104b2d68bfc908e7b745fa58a49dd244e69a63a0a4f1e4b189d9e", - "modified": false - }, - { - "source": "components/controls/FilledSlider.qml", - "destination": "qml/qs/components/controls/FilledSlider.qml", - "sha256": "58c7ca603dda875fd175e6d101b295f5688ae584866625d290950e76620ef695", - "portedSha256": "58c7ca603dda875fd175e6d101b295f5688ae584866625d290950e76620ef695", - "modified": false - }, - { - "source": "components/controls/IconButton.qml", - "destination": "qml/qs/components/controls/IconButton.qml", - "sha256": "464dd333c6ca7a995483e5bf525c1c50ca68674272df1d54326fae22dcd75358", - "portedSha256": "f2b2b99c8c36444731f7cc1c8c66790c7b5e00f49339b310c6bb34929d5623d3", - "modified": true - }, - { - "source": "components/controls/IconTextButton.qml", - "destination": "qml/qs/components/controls/IconTextButton.qml", - "sha256": "1b1256141e5c3d05b2c4b89a3f76ed1ebac16a1d4c66ee0064d50ee45921b9bd", - "portedSha256": "1b1256141e5c3d05b2c4b89a3f76ed1ebac16a1d4c66ee0064d50ee45921b9bd", - "modified": false - }, - { - "source": "components/controls/Menu.qml", - "destination": "qml/qs/components/controls/Menu.qml", - "sha256": "a3f7ad510270a0f7672ec806f8a2a9c32be74811e7f66280178a3d296cb9428d", - "portedSha256": "a3f7ad510270a0f7672ec806f8a2a9c32be74811e7f66280178a3d296cb9428d", - "modified": false - }, - { - "source": "components/controls/MenuItem.qml", - "destination": "qml/qs/components/controls/MenuItem.qml", - "sha256": "c6c1d766d2c017e050c734ba0ca50052eee183b9b56d74a915fa38c64362931d", - "portedSha256": "c6c1d766d2c017e050c734ba0ca50052eee183b9b56d74a915fa38c64362931d", - "modified": false - }, - { - "source": "components/controls/SpinBoxRow.qml", - "destination": "qml/qs/components/controls/SpinBoxRow.qml", - "sha256": "07c3a74e0ae89aefa817a7dc9f32641757c112fd318269a1e7a30bfa7270be9a", - "portedSha256": "07c3a74e0ae89aefa817a7dc9f32641757c112fd318269a1e7a30bfa7270be9a", - "modified": false - }, - { - "source": "components/controls/SplitButton.qml", - "destination": "qml/qs/components/controls/SplitButton.qml", - "sha256": "b12e1d459b0781f260ea49054357726a769326ed38caf806e9fe3b7f6443b9e3", - "portedSha256": "b12e1d459b0781f260ea49054357726a769326ed38caf806e9fe3b7f6443b9e3", - "modified": false - }, - { - "source": "components/controls/StyledInputField.qml", - "destination": "qml/qs/components/controls/StyledInputField.qml", - "sha256": "ee17c58b75890e6750c4f7257fa98ed30fad4022a5fde5436d4f938da1a01b58", - "portedSha256": "ee17c58b75890e6750c4f7257fa98ed30fad4022a5fde5436d4f938da1a01b58", - "modified": false - }, - { - "source": "components/controls/StyledRadioButton.qml", - "destination": "qml/qs/components/controls/StyledRadioButton.qml", - "sha256": "a9205bf8b1ddbd779106620c2cc2223a7304297026be4fca7782083b6e5ab615", - "portedSha256": "a9205bf8b1ddbd779106620c2cc2223a7304297026be4fca7782083b6e5ab615", - "modified": false - }, - { - "source": "components/controls/StyledScrollBar.qml", - "destination": "qml/qs/components/controls/StyledScrollBar.qml", - "sha256": "b5a63a5ceedf25a67db03d2d0a6a59d85a7ed3eca025fbd0a49d1f75e6926481", - "portedSha256": "b5a63a5ceedf25a67db03d2d0a6a59d85a7ed3eca025fbd0a49d1f75e6926481", - "modified": false - }, - { - "source": "components/controls/StyledSlider.qml", - "destination": "qml/qs/components/controls/StyledSlider.qml", - "sha256": "c1efa217e500861de9b06df7e2712ce931a551eeededf1e513ff5c0ec0f40cf1", - "portedSha256": "c1efa217e500861de9b06df7e2712ce931a551eeededf1e513ff5c0ec0f40cf1", - "modified": false - }, - { - "source": "components/controls/StyledSwitch.qml", - "destination": "qml/qs/components/controls/StyledSwitch.qml", - "sha256": "f83abd29b83da7ff59991ba6c77db90fbffc61cfc659e6794aaf8a1fa6ee7b2d", - "portedSha256": "f83abd29b83da7ff59991ba6c77db90fbffc61cfc659e6794aaf8a1fa6ee7b2d", - "modified": false - }, - { - "source": "components/controls/StyledTextField.qml", - "destination": "qml/qs/components/controls/StyledTextField.qml", - "sha256": "57dc4adf28817b4d347d83da764f9da8d0dde2f6c1fbac57586e3025d1f0e6ef", - "portedSha256": "57dc4adf28817b4d347d83da764f9da8d0dde2f6c1fbac57586e3025d1f0e6ef", - "modified": false - }, - { - "source": "components/controls/SwitchRow.qml", - "destination": "qml/qs/components/controls/SwitchRow.qml", - "sha256": "7a79f65393b7dfdbe1a9c887711fadf857a4461da5145a7ae87e0fe2de3dae95", - "portedSha256": "7a79f65393b7dfdbe1a9c887711fadf857a4461da5145a7ae87e0fe2de3dae95", - "modified": false - }, - { - "source": "components/controls/TextButton.qml", - "destination": "qml/qs/components/controls/TextButton.qml", - "sha256": "706ca5d766de4b4aa0a2b4431a47c8f2b02bfb3679db88930399977e26bf5568", - "portedSha256": "706ca5d766de4b4aa0a2b4431a47c8f2b02bfb3679db88930399977e26bf5568", - "modified": false - }, - { - "source": "components/controls/ToggleButton.qml", - "destination": "qml/qs/components/controls/ToggleButton.qml", - "sha256": "bf6ace2309b827c39852cd8a0eeedb5ddc736377e0933ca0ecd0345fe7523a64", - "portedSha256": "bf6ace2309b827c39852cd8a0eeedb5ddc736377e0933ca0ecd0345fe7523a64", - "modified": false - }, - { - "source": "components/controls/ToggleRow.qml", - "destination": "qml/qs/components/controls/ToggleRow.qml", - "sha256": "4e27e73651daa0cf87501aeb1216d49106ed81bfa0b52aa81a0fa0d2f37cdce0", - "portedSha256": "4e27e73651daa0cf87501aeb1216d49106ed81bfa0b52aa81a0fa0d2f37cdce0", - "modified": false - }, - { - "source": "components/controls/Tooltip.qml", - "destination": "qml/qs/components/controls/Tooltip.qml", - "sha256": "fc442b46f9d04e89863c931945b23cbc6e7ea26175f691b2c6051b34991a0c99", - "portedSha256": "fc442b46f9d04e89863c931945b23cbc6e7ea26175f691b2c6051b34991a0c99", - "modified": false - }, - { - "source": "components/effects/ColouredIcon.qml", - "destination": "qml/qs/components/effects/ColouredIcon.qml", - "sha256": "b5a1bbe0a21447b1e878be8bf738d13636ff8e8a103f1ff2aca99bfcf8bbf9f2", - "portedSha256": "2851b3bfb364c01d04c3b99e8946f40ed77eec349b74ccf7e635b43df1cef623", - "modified": true - }, - { - "source": "components/effects/Colouriser.qml", - "destination": "qml/qs/components/effects/Colouriser.qml", - "sha256": "033d2ecd96b51a47e4b857293ecac67a6edefa32651d2ed67f19ae498abef0a5", - "portedSha256": "033d2ecd96b51a47e4b857293ecac67a6edefa32651d2ed67f19ae498abef0a5", - "modified": false - }, - { - "source": "components/effects/Elevation.qml", - "destination": "qml/qs/components/effects/Elevation.qml", - "sha256": "60c626e0612d2bd6292d7a1bd5367df6b36ec844178e77e2d88d747fc52872d3", - "portedSha256": "60c626e0612d2bd6292d7a1bd5367df6b36ec844178e77e2d88d747fc52872d3", - "modified": false - }, - { - "source": "components/effects/InnerBorder.qml", - "destination": "qml/qs/components/effects/InnerBorder.qml", - "sha256": "6aeaba2fc7beb5164894447a63c32a7300e311fe3d06da5fddc3649560df6dc9", - "portedSha256": "6aeaba2fc7beb5164894447a63c32a7300e311fe3d06da5fddc3649560df6dc9", - "modified": false - }, - { - "source": "components/effects/OpacityMask.qml", - "destination": "qml/qs/components/effects/OpacityMask.qml", - "sha256": "e8426f9af1efc42d4e57d4b5e10d4350991169fe6326097f0d83a1e15faf4558", - "portedSha256": "5f8d1754dcc53fcd9b189b62b47042c5782d1964a2e2baf5444bf1de2ef07923", - "modified": true - }, - { - "source": "components/filedialog/CurrentItem.qml", - "destination": "qml/qs/components/filedialog/CurrentItem.qml", - "sha256": "5b76c88c4bd1bdc6af0346f90c833e3d19dee9da54f1f48917ce44fb74585cfe", - "portedSha256": "5b76c88c4bd1bdc6af0346f90c833e3d19dee9da54f1f48917ce44fb74585cfe", - "modified": false - }, - { - "source": "components/filedialog/DialogButtons.qml", - "destination": "qml/qs/components/filedialog/DialogButtons.qml", - "sha256": "daac554da65b774f3b90ff3d387db2c5511e0e544db8691cfe9dba4ce56d5115", - "portedSha256": "daac554da65b774f3b90ff3d387db2c5511e0e544db8691cfe9dba4ce56d5115", - "modified": false - }, - { - "source": "components/filedialog/FileDialog.qml", - "destination": "qml/qs/components/filedialog/FileDialog.qml", - "sha256": "3603dcd37b18a7eb0e6336bbd57c158a7a960a83a6df1aa2e4529c5cc1ea0028", - "portedSha256": "40a2d49dffaf73965da9454d3d17dc5c64ed12b451dc65352859e78579e3aac6", - "modified": true - }, - { - "source": "components/filedialog/FolderContents.qml", - "destination": "qml/qs/components/filedialog/FolderContents.qml", - "sha256": "886016d444ae09fcc9d763878da96899cdcc3a58dcba769ff3071d449bb227ca", - "portedSha256": "886016d444ae09fcc9d763878da96899cdcc3a58dcba769ff3071d449bb227ca", - "modified": false - }, - { - "source": "components/filedialog/HeaderBar.qml", - "destination": "qml/qs/components/filedialog/HeaderBar.qml", - "sha256": "4dbb3a19647beda53dd1dd5dede1a636022bf5182fc9561278b8da1ac29054b3", - "portedSha256": "4dbb3a19647beda53dd1dd5dede1a636022bf5182fc9561278b8da1ac29054b3", - "modified": false - }, - { - "source": "components/filedialog/Sidebar.qml", - "destination": "qml/qs/components/filedialog/Sidebar.qml", - "sha256": "b34a8d7520ae9ffc6c1f025d40eb84dc9113a18b5c09dd6aad20108f822dcb91", - "portedSha256": "b34a8d7520ae9ffc6c1f025d40eb84dc9113a18b5c09dd6aad20108f822dcb91", - "modified": false - }, - { - "source": "components/filedialog/Sizes.qml", - "destination": "qml/qs/components/filedialog/Sizes.qml", - "sha256": "e97931ccca06782a298da3b364ab5d76f78ce51688f1b8238b93e0147828c61b", - "portedSha256": "e97931ccca06782a298da3b364ab5d76f78ce51688f1b8238b93e0147828c61b", - "modified": false - }, - { - "source": "components/images/CachingIconImage.qml", - "destination": "qml/qs/components/images/CachingIconImage.qml", - "sha256": "e8ea65276888b78b9e495bb7426e8baeb8a7206ddbbd144d47c229cfe3feefa0", - "portedSha256": "e8ea65276888b78b9e495bb7426e8baeb8a7206ddbbd144d47c229cfe3feefa0", - "modified": false - }, - { - "source": "components/images/CachingImage.qml", - "destination": "qml/qs/components/images/CachingImage.qml", - "sha256": "50cf3a006df64eff545218726e6ef1244485396b9940821793e854f6c60c6509", - "portedSha256": "0e12bf92a5d8e34c366661f74737bd4e3465a703588656b35b35641e9f2458d5", - "modified": true - }, - { - "source": "components/misc/CustomShortcut.qml", - "destination": "qml/qs/components/misc/CustomShortcut.qml", - "sha256": "209c4587ce9f2d15fddf1fccb90b714794c75d83d9b38780f90b367e6ed58716", - "portedSha256": "209c4587ce9f2d15fddf1fccb90b714794c75d83d9b38780f90b367e6ed58716", - "modified": false - }, - { - "source": "components/misc/Ref.qml", - "destination": "qml/qs/components/misc/Ref.qml", - "sha256": "6d1ecab07d42502a9e960ee8c42b4c65c34af3d0fabaddab05ea97ff8b663d23", - "portedSha256": "6d1ecab07d42502a9e960ee8c42b4c65c34af3d0fabaddab05ea97ff8b663d23", - "modified": false - }, - { - "source": "components/widgets/ExtraIndicator.qml", - "destination": "qml/qs/components/widgets/ExtraIndicator.qml", - "sha256": "c0f629a88b1f4aa1232e13a7bbb9fa40e98b283cb4d88dd449c9c79765d5b4f7", - "portedSha256": "c0f629a88b1f4aa1232e13a7bbb9fa40e98b283cb4d88dd449c9c79765d5b4f7", - "modified": false - }, - { - "source": "modules/dashboard/Background.qml", - "destination": "qml/qs/modules/dashboard/Background.qml", - "sha256": "a3b3b517917ed6b977f020ad17f9cc8f45a491111fa1d3b12773a786e478474c", - "portedSha256": "a3b3b517917ed6b977f020ad17f9cc8f45a491111fa1d3b12773a786e478474c", - "modified": false - }, - { - "source": "modules/dashboard/Content.qml", - "destination": "qml/qs/modules/dashboard/Content.qml", - "sha256": "ea54bd484dcdaa90decbb09e57247f97e82483f8d6bfa87f93e1d8c93af7fdb9", - "portedSha256": "b7e62080e97d13f058cbc48aeec4f1a05eb2fcb5648c07f0fb7bd81f905329fd", - "modified": true - }, - { - "source": "modules/dashboard/Dash.qml", - "destination": "qml/qs/modules/dashboard/Dash.qml", - "sha256": "00de0d966cc2884dc205398a0e34b1f5e6e25e9b6cce46243e31568c6b04825f", - "portedSha256": "00de0d966cc2884dc205398a0e34b1f5e6e25e9b6cce46243e31568c6b04825f", - "modified": false - }, - { - "source": "modules/dashboard/Media.qml", - "destination": "qml/qs/modules/dashboard/Media.qml", - "sha256": "fa269b03bf3bc57a160d76f8433bede03df38a2e675930463268bac2bef8ec77", - "portedSha256": "81269e42571ea33bc736d601eede3284d74cc038a44dbf4486de88cf0b134ec4", - "modified": true - }, - { - "source": "modules/dashboard/Performance.qml", - "destination": "qml/qs/modules/dashboard/Performance.qml", - "sha256": "286780cb4f3710c4aaefe78b3191c09f388ac80336c4f7c46ec6aba145360df4", - "portedSha256": "f744683901d853c2f9471d19862e444aad20f7241dfe280b818422200ad8aa13", - "modified": true - }, - { - "source": "modules/dashboard/Tabs.qml", - "destination": "qml/qs/modules/dashboard/Tabs.qml", - "sha256": "130f34e7f732e0bd7f44036cccbd786d55e2cb0d9507c9601919ef9fcb440b16", - "portedSha256": "c455042a2f6c147661d5f831abe9972ed28eade713c9c1af984a59938464a0cf", - "modified": true - }, - { - "source": "modules/dashboard/Weather.qml", - "destination": "qml/qs/modules/dashboard/Weather.qml", - "sha256": "199d46e5e8c73a26f7a93963a68db84a983dd3b86fa5d35650480a5301127839", - "portedSha256": "199d46e5e8c73a26f7a93963a68db84a983dd3b86fa5d35650480a5301127839", - "modified": false - }, - { - "source": "modules/dashboard/Wrapper.qml", - "destination": "qml/qs/modules/dashboard/Wrapper.qml", - "sha256": "d27391367eaa7a7c619f7c5a09c3da5dd17c4642dd0b85f0dfee63c48cc6c1c6", - "portedSha256": "2510692404a495aa70283085ea4d861008717446c40c4ee53af85a784fe9b3c4", - "modified": true - }, - { - "source": "modules/dashboard/dash/Calendar.qml", - "destination": "qml/qs/modules/dashboard/dash/Calendar.qml", - "sha256": "530630415e2dcd2e9ebb287fe63378983089191f16a9348903267f00be4a43ea", - "portedSha256": "530630415e2dcd2e9ebb287fe63378983089191f16a9348903267f00be4a43ea", - "modified": false - }, - { - "source": "modules/dashboard/dash/DateTime.qml", - "destination": "qml/qs/modules/dashboard/dash/DateTime.qml", - "sha256": "71f9922430dd9093b007c59e8914bd08657397c2956748a3715e69e46d883fcf", - "portedSha256": "71f9922430dd9093b007c59e8914bd08657397c2956748a3715e69e46d883fcf", - "modified": false - }, - { - "source": "modules/dashboard/dash/Media.qml", - "destination": "qml/qs/modules/dashboard/dash/Media.qml", - "sha256": "51c254d5f1b15081a9ab6262448ea2d60e2ee98fbccfad6ebbb4bc94fe9238b1", - "portedSha256": "51c254d5f1b15081a9ab6262448ea2d60e2ee98fbccfad6ebbb4bc94fe9238b1", - "modified": false - }, - { - "source": "modules/dashboard/dash/Resources.qml", - "destination": "qml/qs/modules/dashboard/dash/Resources.qml", - "sha256": "60259f1f737926aa8dc553c48d831b63b7ae074eb8c46b9d3f4576c2dd0d19c2", - "portedSha256": "60259f1f737926aa8dc553c48d831b63b7ae074eb8c46b9d3f4576c2dd0d19c2", - "modified": false - }, - { - "source": "modules/dashboard/dash/User.qml", - "destination": "qml/qs/modules/dashboard/dash/User.qml", - "sha256": "9b3c0bb5c8bcd4504e469d995cf633fd6aacdd7e3e6c41e2f1367ee3e6d5066b", - "portedSha256": "9b3c0bb5c8bcd4504e469d995cf633fd6aacdd7e3e6c41e2f1367ee3e6d5066b", - "modified": false - }, - { - "source": "modules/dashboard/dash/Weather.qml", - "destination": "qml/qs/modules/dashboard/dash/Weather.qml", - "sha256": "78c9d738cdeeece52f4d9dae3cdf11d06c22fc364306c4fa6e589fc6ee296dda", - "portedSha256": "36a792c8cb1c73c8a23ca6d2d84955d929987ee3811243bd0bfe1196fcb80bdc", - "modified": true - }, - { - "source": "config/AppearanceConfig.qml", - "destination": "qml/qs/config/AppearanceConfig.qml", - "sha256": "83c680d2ded938f3b806b76583a1e2fe6aa6860da06b8db3e10e55badfe2e449", - "portedSha256": "83c680d2ded938f3b806b76583a1e2fe6aa6860da06b8db3e10e55badfe2e449", - "modified": false - }, - { - "source": "config/DashboardConfig.qml", - "destination": "qml/qs/config/DashboardConfig.qml", - "sha256": "6952b707bea10e3f5d446b56da906a64f82256c77067a86740afe1d058174007", - "portedSha256": "6952b707bea10e3f5d446b56da906a64f82256c77067a86740afe1d058174007", - "modified": false - }, - { - "source": "modules/launcher/Content.qml", - "destination": "qml/qs/modules/launcher/Content.qml", - "sha256": "2985b439005b63207e70fe619c2324cd77fd9c4d105e050fa688c7837235e3af", - "portedSha256": "10cf945889a2cc6962ed4b3169443b08f2e38bbe60f5e3895e644b4240feae4f", - "modified": true - }, - { - "source": "modules/launcher/AppList.qml", - "destination": "qml/qs/modules/launcher/AppList.qml", - "sha256": "66ff5d423364ffe8d2704cdd4a6c57fd476827ca2706b5f09682cbff443d3822", - "portedSha256": "abab7263bcc5c395a32be38d5f0521d46d194b9135d447a631271b70e99acab3", - "modified": true - }, - { - "source": "modules/launcher/items/AppItem.qml", - "destination": "qml/qs/modules/launcher/items/AppItem.qml", - "sha256": "10480d489d74c66b50adc5106439094af98fc621f3aa9910c7bc7bfc5214a83d", - "portedSha256": "0a10b8c87ae802a6cb739cd1c6296bdfe6e458cc2f497c88eb5061aa8fde8587", - "modified": true - }, - { - "source": "config/LauncherConfig.qml", - "destination": "qml/qs/config/LauncherConfig.qml", - "sha256": "1c1176d0fc2b907413a83326f178ecc5893ce24fae2f244c2bd3c362a4f0735e", - "portedSha256": "1c1176d0fc2b907413a83326f178ecc5893ce24fae2f244c2bd3c362a4f0735e", - "modified": false - }, - { - "source": "modules/drawers/Border.qml", - "destination": "qml/ScreenBorder.qml", - "sha256": "d1f1ba5123b7d96e5f84e3c4febf4a18c060512fbd8f0aeec569537142517a4e", - "portedSha256": "9d52192d4210543b66074d1c38c6f7908d469317e26780c155007c766fd84472", - "modified": true - }, - { - "source": "modules/launcher/Background.qml", - "destination": "qml/DockBackground.qml", - "sha256": "e4e131915cff6e1b469ae1a6a05417627a7af99df241fe6718b8b22c86df4bd4", - "portedSha256": "a20e827a809c6c0d6052ad019857c23229a0a4bcb31008c557bca952a17ed64c", - "modified": true - } - ] -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.1.json b/docs/history/caelestia-windows/RELEASE-8.1.json deleted file mode 100644 index 9ec081f..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.1.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "version": "8.1.0", - "upstreamCommit": "04bfc87f65d6e13b287358e1024d9bbc055b0c58", - "originalFiles": 75, - "unmodifiedOriginalFiles": 63, - "favoritesPreserved": true, - "recentPreserved": true, - "websitesPreserved": true, - "quickTabsPreserved": true, - "validation": { - "checks": { - "all15ViewsVisible": true, - "noQmlIssues": true, - "controlsStayOpen": true, - "shortcutRecorderArmed": true, - "shortcutRecorderReleased": true, - "sensorsStopped": true, - "panelClosed": true - }, - "allPassed": true, - "pythonTests": 20, - "bridgeTests": 13, - "cpuPercentWholeMachineIdle": 0.195, - "idleSeconds": 6.0, - "logicalProcessors": 12 - }, - "backup": "checkpoint-20261025-before-8.1", - "desktopRescueSha256": "fd1015b569c9292a7fa07afd23bf3b4ce760ffce26e1b1daad320a1a4b619779", - "dockIndependentWindowFix": { - "date": "2026-10-26", - "nativeLifecycleChecks": 5, - "allPassed": true - } -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.2.json b/docs/history/caelestia-windows/RELEASE-8.2.json deleted file mode 100644 index 0e8a64f..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.2.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "version": "8.2.0", - "upstreamCommit": "04bfc87f65d6e13b287358e1024d9bbc055b0c58", - "originalFiles": 75, - "unmodifiedOriginalFiles": 63, - "preferencesPreserved": { - "Favorites": true, - "Websites": true, - "QuickTabs": true, - "Shortcut": true, - "PaletteShortcut": true, - "BoardOverrides": true, - "Names": true, - "Categories": true, - "Icons": true, - "ExistingRecentEntries": true - }, - "desktopRescueSha256": "fd1015b569c9292a7fa07afd23bf3b4ce760ffce26e1b1daad320a1a4b619779", - "validation": { - "tools-report.json": 14, - "live-report.json": 14, - "audio-mixer-verification.json": 11, - "dock-lifecycle.json": 5 - }, - "allPassed": true, - "pythonTests": 20, - "bridgeTests": 13, - "backup": "checkpoint-20261026-before-8.2", - "idle": { - "seconds": 5.498555399997713, - "qtPercentOneCore": 0.568331092926935, - "backendPercentOneCore": 1.4208277323173373 - } -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.3.json b/docs/history/caelestia-windows/RELEASE-8.3.json deleted file mode 100644 index 5b19597..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.3.json +++ /dev/null @@ -1,48 +0,0 @@ -{ - "version": "8.3.0", - "upstreamCommit": "04bfc87f65d6e13b287358e1024d9bbc055b0c58", - "originalFiles": 77, - "unmodifiedOriginalFiles": 63, - "preferencesPreserved": { - "Favorites": true, - "Websites": true, - "QuickTabs": true, - "Shortcut": true, - "PaletteShortcut": true, - "BoardOverrides": true, - "Names": true, - "Categories": true, - "Icons": true, - "Custom": true, - "Workspaces": true, - "ExistingRecentEntries": true - }, - "autoThemeEnabled": true, - "screenFrameEnabled": true, - "framePixelsLogical": 12, - "windowInsetLogical": 20, - "validation": { - "theme-report.json": 21, - "live-report.json": 15, - "tools-report.json": 14, - "frame-verification.json": 3, - "audio-mixer-verification.json": 14, - "dock-lifecycle.json": 5 - }, - "allPassed": true, - "pythonTests": 20, - "bridgeTests": 13, - "menuFirstFrameMs": { - "tools": 170.3, - "audio": 33.7, - "microphone": 30.4, - "capture": 25.8, - "clipboard": 4.1, - "controls": 38.4, - "mixer": 10.7 - }, - "idleCpuPercentWholeMachine": 0.26022210569536575, - "logicalProcessors": 12, - "desktopRescueSha256": "fd1015b569c9292a7fa07afd23bf3b4ce760ffce26e1b1daad320a1a4b619779", - "backup": "checkpoint-20261026-before-8.3" -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.4.json b/docs/history/caelestia-windows/RELEASE-8.4.json deleted file mode 100644 index 4616f74..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.4.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "version": "8.4.0", - "upstreamCommit": "04bfc87f65d6e13b287358e1024d9bbc055b0c58", - "framePixelsLogical": 16, - "windowInsetLogical": 20, - "autoThemeEnabled": true, - "glassOpacityDefault": 0.6, - "transparencyRangePercent": [ - 5, - 80 - ], - "animatedWallpaperProviders": [ - "DesktopHut" - ], - "preferencesPreserved": { - "Favorites": true, - "Websites": true, - "QuickTabs": true, - "Shortcut": true, - "PaletteShortcut": true, - "BoardOverrides": true, - "Names": true, - "Categories": true, - "Icons": true, - "Custom": true, - "Workspaces": true, - "TaskbarPins": true - }, - "validation": { - "theme-report.json": 41, - "native-blur-report.json": 0, - "live-material-report.json": 11 - }, - "nativeBlurVerified": true, - "pythonTests": 27, - "allPassed": true, - "backupFrontend": "checkpoint-8.3-before-8.4", - "backupBackend": "checkpoint-20261026-before-8.4", - "artifacts": { - "Panneaux.Glass.exe": "e81d55aff2b937d71610c160f48c32919eba62d5eabb30b5f8df19672b9ae97b", - "Panneaux.Glass.dll": "36e6ba1a58768f51639bb7698a600b35537a1ee7eda26e6a67ebfacced99cd13" - } -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.5.json b/docs/history/caelestia-windows/RELEASE-8.5.json deleted file mode 100644 index b38da61..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.5.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "version": "8.5.0", - "fix": "Bounded Acrylic frame helpers replace screen-sized backdrop", - "nativeFramePieces": 8, - "nativeFullscreenFrame": false, - "frameThicknessDefault": 16, - "frameThicknessRange": [ - 4, - 40 - ], - "windowInset": "frameThickness + 4", - "preferencesPreserved": true, - "allPassed": true, - "pythonTests": 27, - "validation": { - "theme-report.json": 48, - "desktop-regression-report.json": 47, - "native-blur-report.json": 0, - "live-thickness-report.json": 17 - }, - "backupFrontend": "checkpoint-8.4-before-8.5", - "backupBackend": "checkpoint-20261026-before-8.5", - "artifacts": { - "Panneaux.Glass.exe": "a0c0256871524e46efda939580ca6805757cd2b146e988b657dfef306635def3", - "Panneaux.Glass.dll": "5d0504be6644912ab9fc9deb812eaeef0e2ac6e0b607b8140ed136cf1890bf49" - }, - "nativeDllSha256": "777bdad44446ba149dcb87e32e760ba73ba6b7b9d15c6e95fdbbbe09fe0f6bb8", - "desktopIconsLifecycleVerified": true -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-8.6.json b/docs/history/caelestia-windows/RELEASE-8.6.json deleted file mode 100644 index 5dc5101..0000000 --- a/docs/history/caelestia-windows/RELEASE-8.6.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "version": "8.6.0", - "fix": "Per-pixel composition masks replace black Acrylic backing", - "nativeFramePieces": 8, - "nativeFullscreenFrame": false, - "frameThicknessDefault": 16, - "frameThicknessRange": [ - 4, - 40 - ], - "windowInset": "frameThickness + 4", - "preferencesPreserved": true, - "allPassed": true, - "pythonTests": 27, - "validation": { - "theme-report.json": 48, - "desktop-regression-report.json": 50, - "native-blur-report.json": 0 - }, - "backupFrontend": "checkpoint-8.5-before-8.6", - "backupBackend": "checkpoint-20261026-before-8.6", - "artifacts": { - "Panneaux.Glass.exe": "a8da922a18d2bedef99181ff81845515f4d43dbf0015e48d77395dc9b7a0ba33", - "Panneaux.Glass.dll": "1a502ff772831ab59acf6be6d444d4dde66ed55b4abf0364c5b264227a04f478" - }, - "nativeDllSha256": "339b0e48734e45be02c46987b02b96b66d493a19fb69f8c578fc2f41e4f9246f", - "desktopIconsLifecycleVerified": true, - "blackCornerPixels": { - "4px": 0, - "16px": 0, - "40px": 0 - }, - "baselineBugReproduced": true -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-9.0.json b/docs/history/caelestia-windows/RELEASE-9.0.json deleted file mode 100644 index 6176638..0000000 --- a/docs/history/caelestia-windows/RELEASE-9.0.json +++ /dev/null @@ -1,45 +0,0 @@ -{ - "version": "9.0.0", - "fix": "One shared surface alpha for frame, dashboard and dock; native ring hosts grown inwards; dock survives engine shutdown and stays open under the pointer", - "nativeFramePieces": 8, - "nativeFullscreenFrame": false, - "nativeHostPadding": "max(56, 2*thickness + rounding)", - "frameThickness": 20, - "frameThicknessRange": [4, 40], - "glassOpacity": 0.05, - "glassOpacityRange": [0.05, 0.95], - "transparencySliderRange": [5, 95], - "windowInset": "frameThickness + 4", - "preferencesPreserved": true, - "pythonTests": 28, - "seamDelta": 0.0, - "seamSamples": { - "frame": [184.0, 200.0, 215.0], - "dashboard": [184.0, 200.0, 215.0] - }, - "blackCornerPixels": { - "4px": 0, - "16px": 0, - "40px": 0 - }, - "centrePixelsUnchanged": true, - "helpersNeverCoverCentre": true, - "favouritesPreserved": true, - "desktopIconsLifecycleVerified": true, - "artifacts": { - "Panneaux.Glass.exe": "a8da922a18d2bedef99181ff81845515f4d43dbf0015e48d77395dc9b7a0ba33", - "Panneaux.Glass.dll": "7703127a2d7ad193378a14cdbd528bd2e015d251b919c6ba1dbf64b3a5c91384" - }, - "nativeDllSha256": "03f69103f5044b06ff2a3fb08b25ae0fc7d7daded27626ed4c2cc1eb95f4d989", - "nativeStagingCopy": "../research/qt90-glass/QtGlassBackdrop.dll", - "validation": { - "seam-report.json": "1/1", - "desktop-regression-report.json": "74/74" - }, - "backupFrontend": "checkpoint-20261026-021942-avant-reprise", - "backupBackend": "../Glass-v5/checkpoint-20261026-before-8.6", - "dockRevealedOnEdge": true, - "dockStaysOpenUnderPointer": true, - "taskbarPreferenceSurvivesEngineShutdown": true, - "awaitingUserVisualReview": true -} diff --git a/docs/history/caelestia-windows/RELEASE-9.1.json b/docs/history/caelestia-windows/RELEASE-9.1.json deleted file mode 100644 index 6258be1..0000000 --- a/docs/history/caelestia-windows/RELEASE-9.1.json +++ /dev/null @@ -1,136 +0,0 @@ -{ - "version": "9.1.0", - "surfaceRenderer": "One shared vector union per monitor", - "nativeGeometry": "Analytic Direct2D curves in bounded composition tiles", - "launchTransparencyPercent": 88, - "transparencyRangePercent": [ - 5, - 98 - ], - "frameThicknessAtLaunch": 33, - "preferencesPreserved": { - "Favorites": true, - "TaskbarPins": true, - "Websites": true, - "QuickTabs": true, - "Shortcut": true, - "PaletteShortcut": true, - "Categories": true, - "Names": true, - "BoardOverrides": true, - "Custom": true, - "Workspaces": true - }, - "pythonTests": 32, - "surfaceChecks": 13, - "surfaceReport": { - "checks": [ - { - "name": "Frame dashboard dock have identical composited material", - "pass": true - }, - { - "name": "Smooth corners have no internal segment lines", - "pass": true - }, - { - "name": "No native geometry errors", - "pass": true - }, - { - "name": "0.12 no native tile seam", - "pass": true - }, - { - "name": "0.12 same transparency for every surface", - "pass": true - }, - { - "name": "0.12 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.02 no native tile seam", - "pass": true - }, - { - "name": "0.02 same transparency for every surface", - "pass": true - }, - { - "name": "0.02 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.5 no native tile seam", - "pass": true - }, - { - "name": "0.5 same transparency for every surface", - "pass": true - }, - { - "name": "0.5 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "No QML warnings", - "pass": true - } - ], - "flatSamples": { - "frameTop": [ - 146, - 176, - 205 - ], - "panelTop": [ - 146, - 176, - 205 - ], - "dockBottom": [ - 146, - 176, - 205 - ], - "frameBottom": [ - 146, - 176, - 205 - ] - }, - "cornerMismatches": 0, - "0.12Detail": { - "frame": 0.875, - "panel": 0.875, - "dock": 0.875 - }, - "0.12TileSeamDelta": 1, - "0.02Detail": { - "frame": 0.9791666666666666, - "panel": 0.9791666666666666, - "dock": 0.9791666666666666 - }, - "0.02TileSeamDelta": 1, - "0.5Detail": { - "frame": 0.5, - "panel": 0.5, - "dock": 0.5 - }, - "0.5TileSeamDelta": 2, - "allPassed": true, - "qmlIssues": [], - "nativeErrors": [] - }, - "liveStartupPassed": true, - "allPassed": true, - "artifacts": { - "Panneaux.Glass.exe": "891cbf9b85a687788a05cb88eeb48f4254f028b45872911b17b744034b07d399", - "Panneaux.Glass.dll": "f96d17405979689302f0d034206e26dd9f851a903f56a4df6033bd2601b99d55" - }, - "nativeDllSha256": "fd4d76a490ee156e92d8d4270fc5e673f1defae876840360aae8881ed6c04c7b", - "backupFrontend": "checkpoint-before-9.1", - "backupBackend": "../Glass-v5/checkpoint-before-9.1", - "awaitingUserVisualReview": true -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-9.2.1.json b/docs/history/caelestia-windows/RELEASE-9.2.1.json deleted file mode 100644 index ba2852e..0000000 --- a/docs/history/caelestia-windows/RELEASE-9.2.1.json +++ /dev/null @@ -1,177 +0,0 @@ -{ - "version": "9.2.1", - "input": "Native input regions follow the visible dashboard and dock silhouette; the frame remains click-through.", - "rim": "One 1px continuous outline at 23% alpha in automatic mode, independent of glass transparency.", - "renderer": "Persistent native tiles; dirty bounds update only changed cells; fixed backing window during panel animation.", - "preferencesPreserved": true, - "pythonTests": 32, - "surfaceChecks": 14, - "surfaceReport": { - "checks": [ - { - "name": "Frame dashboard dock have identical composited material", - "pass": true - }, - { - "name": "Smooth corners have no internal segment lines", - "pass": true - }, - { - "name": "No native geometry errors", - "pass": true - }, - { - "name": "0.12 no native tile seam", - "pass": true - }, - { - "name": "0.12 same transparency for every surface", - "pass": true - }, - { - "name": "0.12 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.02 no native tile seam", - "pass": true - }, - { - "name": "0.02 same transparency for every surface", - "pass": true - }, - { - "name": "0.02 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.5 no native tile seam", - "pass": true - }, - { - "name": "0.5 same transparency for every surface", - "pass": true - }, - { - "name": "0.5 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "Closing panel leaves no stale glass tile", - "pass": true - }, - { - "name": "No QML warnings", - "pass": true - } - ], - "flatSamples": { - "frameTop": [ - 146, - 176, - 205 - ], - "panelTop": [ - 146, - 176, - 205 - ], - "dockBottom": [ - 146, - 176, - 205 - ], - "frameBottom": [ - 146, - 176, - 205 - ] - }, - "cornerMismatches": 0, - "0.12Detail": { - "frame": 0.875, - "panel": 0.875, - "dock": 0.875 - }, - "0.12TileSeamDelta": 1, - "0.02Detail": { - "frame": 0.9791666666666666, - "panel": 0.9791666666666666, - "dock": 0.9791666666666666 - }, - "0.02TileSeamDelta": 1, - "0.5Detail": { - "frame": 0.5, - "panel": 0.5, - "dock": 0.5 - }, - "0.5TileSeamDelta": 2, - "allPassed": true, - "qmlIssues": [], - "nativeErrors": [] - }, - "pointerReport": { - "before": 0, - "afterDesktopClick": 1, - "afterShoulderClick": 2, - "afterCornerClick": 3, - "tileFound": true, - "buttonPoint": [ - 458.0, - 219.0 - ], - "beforeFrameClick": 3, - "afterButtonClick": 3, - "afterFrameClick": 4, - "framePass": true, - "mode": "workspace", - "qmlIssues": [], - "cornerPass": true, - "buttonPass": true, - "desktopPass": true, - "shoulderPass": true, - "nativeErrors": [], - "surfaceStyles": [ - 134742184 - ], - "helperStyles": [ - 136839336 - ] - }, - "performanceReport": { - "spikes": [], - "activeFrameMs": { - "count": 404, - "median": 6.714999999985594, - "p95": 16.94919999999911, - "max": 27.759399999922607 - }, - "nativeGeometryMs": { - "count": 388, - "median": 0.26109999998880085, - "p95": 0.4338999997344217, - "max": 33.82469999996829 - }, - "over33ms": 0, - "nativeErrors": [], - "qmlIssues": [], - "refreshRate": 165.0 - }, - "liveStartupPassed": true, - "artifacts": { - "Panneaux.Glass.exe": "5e034a4b6b5372f010866698b998bccc25dd80cf73d038677f6b85137ecb0fea", - "Panneaux.Glass.dll": "54779f823f6aaef28aae90de8df1fa5abfb9c956f5a1903f1b298f0ce671e4c2" - }, - "nativeDllSha256": "ab1c68aa99005f4f60fc459532a37b4b8243ce702340a1f5063368a5a5d34d54", - "backupFrontend": "checkpoint-before-9.2", - "backupBackend": "../Glass-v5/checkpoint-before-9.2", - "allPassed": true, - "awaitingUserVisualReview": true, - "backendVersion": "9.2.0", - "liveInputReport": { - "visibleHelpers": 19, - "allHelpersLayeredAndTransparent": true - }, - "backupNative": "checkpoint-before-9.2.1", - "performanceMeasuredVersion": "9.2.0" -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-9.2.json b/docs/history/caelestia-windows/RELEASE-9.2.json deleted file mode 100644 index 55aa43f..0000000 --- a/docs/history/caelestia-windows/RELEASE-9.2.json +++ /dev/null @@ -1,167 +0,0 @@ -{ - "version": "9.2.0", - "input": "Native input regions follow the visible dashboard and dock silhouette; the frame remains click-through.", - "rim": "One 1px continuous outline at 23% alpha in automatic mode, independent of glass transparency.", - "renderer": "Persistent native tiles; dirty bounds update only changed cells; fixed backing window during panel animation.", - "preferencesPreserved": true, - "pythonTests": 32, - "surfaceChecks": 14, - "surfaceReport": { - "checks": [ - { - "name": "Frame dashboard dock have identical composited material", - "pass": true - }, - { - "name": "Smooth corners have no internal segment lines", - "pass": true - }, - { - "name": "No native geometry errors", - "pass": true - }, - { - "name": "0.12 no native tile seam", - "pass": true - }, - { - "name": "0.12 same transparency for every surface", - "pass": true - }, - { - "name": "0.12 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.02 no native tile seam", - "pass": true - }, - { - "name": "0.02 same transparency for every surface", - "pass": true - }, - { - "name": "0.02 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "0.5 no native tile seam", - "pass": true - }, - { - "name": "0.5 same transparency for every surface", - "pass": true - }, - { - "name": "0.5 transparency matches requested detail transmission", - "pass": true - }, - { - "name": "Closing panel leaves no stale glass tile", - "pass": true - }, - { - "name": "No QML warnings", - "pass": true - } - ], - "flatSamples": { - "frameTop": [ - 146, - 176, - 205 - ], - "panelTop": [ - 146, - 176, - 205 - ], - "dockBottom": [ - 146, - 176, - 205 - ], - "frameBottom": [ - 146, - 176, - 205 - ] - }, - "cornerMismatches": 0, - "0.12Detail": { - "frame": 0.875, - "panel": 0.875, - "dock": 0.875 - }, - "0.12TileSeamDelta": 1, - "0.02Detail": { - "frame": 0.9791666666666666, - "panel": 0.9791666666666666, - "dock": 0.9791666666666666 - }, - "0.02TileSeamDelta": 1, - "0.5Detail": { - "frame": 0.5, - "panel": 0.5, - "dock": 0.5 - }, - "0.5TileSeamDelta": 2, - "allPassed": true, - "qmlIssues": [], - "nativeErrors": [] - }, - "pointerReport": { - "before": 0, - "afterDesktopClick": 1, - "afterShoulderClick": 2, - "afterCornerClick": 3, - "tileFound": true, - "buttonPoint": [ - 458.0, - 219.0 - ], - "afterButtonClick": 3, - "mode": "workspace", - "qmlIssues": [], - "cornerPass": true, - "buttonPass": true, - "desktopPass": true, - "shoulderPass": true, - "nativeErrors": [], - "surfaceStyles": [ - 134742184 - ], - "helperStyles": [ - 136315048 - ] - }, - "performanceReport": { - "spikes": [], - "activeFrameMs": { - "count": 404, - "median": 6.714999999985594, - "p95": 16.94919999999911, - "max": 27.759399999922607 - }, - "nativeGeometryMs": { - "count": 388, - "median": 0.26109999998880085, - "p95": 0.4338999997344217, - "max": 33.82469999996829 - }, - "over33ms": 0, - "nativeErrors": [], - "qmlIssues": [], - "refreshRate": 165.0 - }, - "liveStartupPassed": true, - "artifacts": { - "Panneaux.Glass.exe": "5e034a4b6b5372f010866698b998bccc25dd80cf73d038677f6b85137ecb0fea", - "Panneaux.Glass.dll": "54779f823f6aaef28aae90de8df1fa5abfb9c956f5a1903f1b298f0ce671e4c2" - }, - "nativeDllSha256": "17b29663669e9c54738c33bd6f3952a97e453edf6c2fdea030eb005efc9cc38c", - "backupFrontend": "checkpoint-before-9.2", - "backupBackend": "../Glass-v5/checkpoint-before-9.2", - "allPassed": true, - "awaitingUserVisualReview": true -} \ No newline at end of file diff --git a/docs/history/caelestia-windows/RELEASE-9.3.json b/docs/history/caelestia-windows/RELEASE-9.3.json deleted file mode 100644 index 82fa0c2..0000000 --- a/docs/history/caelestia-windows/RELEASE-9.3.json +++ /dev/null @@ -1,91 +0,0 @@ -{ - "version": "9.3.0", - "dockMenus": true, - "nativeClickThroughDllUnchanged": true, - "report": { - "version": "9.3.0", - "preferencesPreserved": true, - "qml": { - "states": [ - { - "kind": "app", - "height": 589, - "visible": true - }, - { - "kind": "system", - "height": 620, - "visible": true - }, - { - "kind": "running", - "height": 119, - "visible": true - } - ], - "clicks": [ - { - "target": "dockStart", - "kind": "system", - "visible": true, - "point": [ - 54.0, - 34.0 - ], - "itemSize": [ - 40.0, - 40.0 - ], - "pass": true - }, - { - "target": "dock-app-fixture", - "kind": "app", - "visible": true, - "point": [ - 152.0, - 33.0 - ], - "itemSize": [ - 42.0, - 42.0 - ], - "pass": true - }, - { - "target": "dockRunning", - "kind": "running", - "visible": true, - "point": [ - 552.5, - 34.5 - ], - "itemSize": [ - 29.0, - 29.0 - ], - "pass": true - } - ], - "qmlIssues": [], - "nativeErrors": [], - "allPassed": true - }, - "backend": { - "favoritePersistsAndPins": true, - "unfavoriteKeepsPin": true, - "unpin": true, - "repinWithoutDuplicate": true, - "closeAllOnlyFixtureWindows": true - }, - "pythonTestsPassed": 32, - "allPassed": true - }, - "nativeDllSha256": "ab1c68aa99005f4f60fc459532a37b4b8243ce702340a1f5063368a5a5d34d54", - "artifacts": { - "Panneaux.Glass.exe": "d45a4c75933173390477da9437704abc85799186f0df80bead2b02b1afccb042", - "Panneaux.Glass.dll": "2f049933fa1b757f0978f7fd3e8aeaa7d38a84c168f7744b715b1c1fa0098d22" - }, - "backup": "checkpoint-before-dock10", - "awaitingUserVisualReview": true -} \ No newline at end of file diff --git a/docs/history/workspace-v4/VALIDATION_2026-10-20.md b/docs/history/workspace-v4/VALIDATION_2026-10-20.md deleted file mode 100644 index b942336..0000000 --- a/docs/history/workspace-v4/VALIDATION_2026-10-20.md +++ /dev/null @@ -1,33 +0,0 @@ -# Panneaux v4 — Vérification du 20 octobre 2026 - -## Version livrée - -Application native .NET Framework compilée en exécutable Windows x64. Sources conservées dans ce dossier. Ancienne application PowerShell conservée dans le dossier parent. - -## Contrôles réussis - -- Compilation C# terminée sans erreur ni avertissement sur la version finale. -- Tous les scripts PowerShell passent l’analyse syntaxique. -- Inventaire généré et régénéré : **355 accès**, aucun diagnostic de collecte. -- **254 applications et outils**, **76 dossiers**, **24 jeux référencés** et **1 accès Rocket League pour terminer son installation dans Epic**. -- Aucun identifiant dupliqué et aucun doublon de nom parmi les logiciels/jeux. -- Aucune cible locale absente dans le catalogue. -- Canada pointe sur `Documents\04_Documents_Administratifs\Canada`. -- Les raccourcis Ubisoft Anno 1800, The Crew Motorfest et The Division 2 dont les installations sont absentes sont écartés. -- Les jeux et applications encore présents sur E: sont pris en compte, indépendamment des suppressions décrites dans le rapport précédent. -- Recherche « canada » vérifiée dans l’interface : Canada et ses deux sous-dossiers apparaissent. -- Favori Canada ajouté dans l’interface et retrouvé après arrêt puis relancement. -- Repli par Échap vérifié à l’écran. -- Déclenchement de la poignée par le pointeur au bord gauche vérifié à l’écran. -- Clic sur la poignée : réouverture du panneau vérifiée à l’écran. -- Ouverture de Canada : fenêtre Explorateur et chemin réel vérifiés. -- Arrêt du processus par son canal d’instance unique vérifié après correction de la libération des ressources. -- Registre de démarrage : entrée Panneaux vers `Workspace-v4\Panneaux.Workspace.exe`. -- Réglage Windows `HideIcons=1`, appliqué par le Bureau Windows. -- Ancien réglage du Bureau, ancien démarrage et anciens raccourcis sauvegardés avant intégration. - -## Limites de vérification - -La session Windows n’a pas été redémarrée. Le démarrage automatique a été contrôlé par sa configuration et par le lancement du même exécutable en arrière-plan. Les jeux et logiciels n’ont pas tous été lancés ; les cibles locales et les manifestes ont été contrôlés. Le comportement multi-écrans et plein écran est implémenté, mais n’a pas été essayé sur plusieurs écrans ni pendant une partie. - -Rocket League dispose de données sur disque, mais son manifeste Epic est dans `Pending`, avec `bIsIncompleteInstall=true` et un exécutable de lancement manquant. Sa tuile ouvre Epic et indique « installation à terminer ». diff --git a/docs/media/dock-dynamic.png b/docs/media/dock-dynamic.png new file mode 100644 index 0000000..fca460a Binary files /dev/null and b/docs/media/dock-dynamic.png differ diff --git a/docs/media/installer/de-01-welcome.png b/docs/media/installer/de-01-welcome.png new file mode 100644 index 0000000..2326f97 Binary files /dev/null and b/docs/media/installer/de-01-welcome.png differ diff --git a/docs/media/installer/de-02-welcome-update.png b/docs/media/installer/de-02-welcome-update.png new file mode 100644 index 0000000..4fc13e8 Binary files /dev/null and b/docs/media/installer/de-02-welcome-update.png differ diff --git a/docs/media/installer/de-04-features-a-taskbar-on.png b/docs/media/installer/de-04-features-a-taskbar-on.png new file mode 100644 index 0000000..71144cd Binary files /dev/null and b/docs/media/installer/de-04-features-a-taskbar-on.png differ diff --git a/docs/media/installer/de-04-features-b-taskbar-off.png b/docs/media/installer/de-04-features-b-taskbar-off.png new file mode 100644 index 0000000..058878b Binary files /dev/null and b/docs/media/installer/de-04-features-b-taskbar-off.png differ diff --git a/docs/media/installer/de-05-updates.png b/docs/media/installer/de-05-updates.png new file mode 100644 index 0000000..8f00d12 Binary files /dev/null and b/docs/media/installer/de-05-updates.png differ diff --git a/docs/media/installer/de-09-uninstall.png b/docs/media/installer/de-09-uninstall.png new file mode 100644 index 0000000..d2b08d6 Binary files /dev/null and b/docs/media/installer/de-09-uninstall.png differ diff --git a/docs/media/installer/en-01-welcome.png b/docs/media/installer/en-01-welcome.png new file mode 100644 index 0000000..356010e Binary files /dev/null and b/docs/media/installer/en-01-welcome.png differ diff --git a/docs/media/installer/en-02-welcome-update.png b/docs/media/installer/en-02-welcome-update.png new file mode 100644 index 0000000..8a35f4d Binary files /dev/null and b/docs/media/installer/en-02-welcome-update.png differ diff --git a/docs/media/installer/en-03-license.png b/docs/media/installer/en-03-license.png new file mode 100644 index 0000000..5ef516c Binary files /dev/null and b/docs/media/installer/en-03-license.png differ diff --git a/docs/media/installer/en-04-features-a-taskbar-on.png b/docs/media/installer/en-04-features-a-taskbar-on.png new file mode 100644 index 0000000..6c008ab Binary files /dev/null and b/docs/media/installer/en-04-features-a-taskbar-on.png differ diff --git a/docs/media/installer/en-04-features-b-taskbar-off.png b/docs/media/installer/en-04-features-b-taskbar-off.png new file mode 100644 index 0000000..c1405ac Binary files /dev/null and b/docs/media/installer/en-04-features-b-taskbar-off.png differ diff --git a/docs/media/installer/en-04-features-c-winjets-locked.png b/docs/media/installer/en-04-features-c-winjets-locked.png new file mode 100644 index 0000000..6fde34b Binary files /dev/null and b/docs/media/installer/en-04-features-c-winjets-locked.png differ diff --git a/docs/media/installer/en-04-features-d-terminal.png b/docs/media/installer/en-04-features-d-terminal.png new file mode 100644 index 0000000..e2b3ca9 Binary files /dev/null and b/docs/media/installer/en-04-features-d-terminal.png differ diff --git a/docs/media/installer/en-05-updates.png b/docs/media/installer/en-05-updates.png new file mode 100644 index 0000000..5e054d5 Binary files /dev/null and b/docs/media/installer/en-05-updates.png differ diff --git a/docs/media/installer/en-06-summary.png b/docs/media/installer/en-06-summary.png new file mode 100644 index 0000000..c8296ea Binary files /dev/null and b/docs/media/installer/en-06-summary.png differ diff --git a/docs/media/installer/en-07-progress.png b/docs/media/installer/en-07-progress.png new file mode 100644 index 0000000..c8e73e3 Binary files /dev/null and b/docs/media/installer/en-07-progress.png differ diff --git a/docs/media/installer/en-08-done.png b/docs/media/installer/en-08-done.png new file mode 100644 index 0000000..c1b1972 Binary files /dev/null and b/docs/media/installer/en-08-done.png differ diff --git a/docs/media/installer/en-09-uninstall.png b/docs/media/installer/en-09-uninstall.png new file mode 100644 index 0000000..f227f0d Binary files /dev/null and b/docs/media/installer/en-09-uninstall.png differ diff --git a/docs/media/installer/en-10-uninstall-done.png b/docs/media/installer/en-10-uninstall-done.png new file mode 100644 index 0000000..4207fec Binary files /dev/null and b/docs/media/installer/en-10-uninstall-done.png differ diff --git a/docs/media/installer/es-01-welcome.png b/docs/media/installer/es-01-welcome.png new file mode 100644 index 0000000..a7d6dfa Binary files /dev/null and b/docs/media/installer/es-01-welcome.png differ diff --git a/docs/media/installer/es-02-welcome-update.png b/docs/media/installer/es-02-welcome-update.png new file mode 100644 index 0000000..d55cc5e Binary files /dev/null and b/docs/media/installer/es-02-welcome-update.png differ diff --git a/docs/media/installer/es-04-features-a-taskbar-on.png b/docs/media/installer/es-04-features-a-taskbar-on.png new file mode 100644 index 0000000..b9cf20e Binary files /dev/null and b/docs/media/installer/es-04-features-a-taskbar-on.png differ diff --git a/docs/media/installer/es-04-features-b-taskbar-off.png b/docs/media/installer/es-04-features-b-taskbar-off.png new file mode 100644 index 0000000..65fd1df Binary files /dev/null and b/docs/media/installer/es-04-features-b-taskbar-off.png differ diff --git a/docs/media/installer/es-05-updates.png b/docs/media/installer/es-05-updates.png new file mode 100644 index 0000000..4b83a78 Binary files /dev/null and b/docs/media/installer/es-05-updates.png differ diff --git a/docs/media/installer/es-09-uninstall.png b/docs/media/installer/es-09-uninstall.png new file mode 100644 index 0000000..750c19d Binary files /dev/null and b/docs/media/installer/es-09-uninstall.png differ diff --git a/docs/media/installer/fr-01-welcome.png b/docs/media/installer/fr-01-welcome.png new file mode 100644 index 0000000..44f28a7 Binary files /dev/null and b/docs/media/installer/fr-01-welcome.png differ diff --git a/docs/media/installer/fr-02-welcome-update.png b/docs/media/installer/fr-02-welcome-update.png new file mode 100644 index 0000000..a12e87d Binary files /dev/null and b/docs/media/installer/fr-02-welcome-update.png differ diff --git a/docs/media/installer/fr-03-license.png b/docs/media/installer/fr-03-license.png new file mode 100644 index 0000000..4c1ef6a Binary files /dev/null and b/docs/media/installer/fr-03-license.png differ diff --git a/docs/media/installer/fr-04-features-a-taskbar-on.png b/docs/media/installer/fr-04-features-a-taskbar-on.png new file mode 100644 index 0000000..2c676eb Binary files /dev/null and b/docs/media/installer/fr-04-features-a-taskbar-on.png differ diff --git a/docs/media/installer/fr-04-features-b-taskbar-off.png b/docs/media/installer/fr-04-features-b-taskbar-off.png new file mode 100644 index 0000000..91a8d75 Binary files /dev/null and b/docs/media/installer/fr-04-features-b-taskbar-off.png differ diff --git a/docs/media/installer/fr-04-features-c-winjets-locked.png b/docs/media/installer/fr-04-features-c-winjets-locked.png new file mode 100644 index 0000000..5583e92 Binary files /dev/null and b/docs/media/installer/fr-04-features-c-winjets-locked.png differ diff --git a/docs/media/installer/fr-04-features-d-terminal.png b/docs/media/installer/fr-04-features-d-terminal.png new file mode 100644 index 0000000..a2e02eb Binary files /dev/null and b/docs/media/installer/fr-04-features-d-terminal.png differ diff --git a/docs/media/installer/fr-05-updates.png b/docs/media/installer/fr-05-updates.png new file mode 100644 index 0000000..4f43052 Binary files /dev/null and b/docs/media/installer/fr-05-updates.png differ diff --git a/docs/media/installer/fr-06-summary.png b/docs/media/installer/fr-06-summary.png new file mode 100644 index 0000000..28447bf Binary files /dev/null and b/docs/media/installer/fr-06-summary.png differ diff --git a/docs/media/installer/fr-07-progress.png b/docs/media/installer/fr-07-progress.png new file mode 100644 index 0000000..f6f351a Binary files /dev/null and b/docs/media/installer/fr-07-progress.png differ diff --git a/docs/media/installer/fr-08-done.png b/docs/media/installer/fr-08-done.png new file mode 100644 index 0000000..de7e507 Binary files /dev/null and b/docs/media/installer/fr-08-done.png differ diff --git a/docs/media/installer/fr-09-uninstall.png b/docs/media/installer/fr-09-uninstall.png new file mode 100644 index 0000000..a018ae1 Binary files /dev/null and b/docs/media/installer/fr-09-uninstall.png differ diff --git a/docs/media/installer/fr-10-uninstall-done.png b/docs/media/installer/fr-10-uninstall-done.png new file mode 100644 index 0000000..a9c212e Binary files /dev/null and b/docs/media/installer/fr-10-uninstall-done.png differ diff --git a/docs/media/installer/transition-1.png b/docs/media/installer/transition-1.png new file mode 100644 index 0000000..7d5e49d Binary files /dev/null and b/docs/media/installer/transition-1.png differ diff --git a/docs/media/installer/transition-2.png b/docs/media/installer/transition-2.png new file mode 100644 index 0000000..53356a4 Binary files /dev/null and b/docs/media/installer/transition-2.png differ diff --git a/docs/media/installer/transition-3.png b/docs/media/installer/transition-3.png new file mode 100644 index 0000000..c252d23 Binary files /dev/null and b/docs/media/installer/transition-3.png differ diff --git a/docs/media/installer/transition-4.png b/docs/media/installer/transition-4.png new file mode 100644 index 0000000..2e862cb Binary files /dev/null and b/docs/media/installer/transition-4.png differ diff --git a/docs/media/installer/transition-5.png b/docs/media/installer/transition-5.png new file mode 100644 index 0000000..137f2bd Binary files /dev/null and b/docs/media/installer/transition-5.png differ diff --git a/docs/media/installer/transition-6.png b/docs/media/installer/transition-6.png new file mode 100644 index 0000000..b8bf49a Binary files /dev/null and b/docs/media/installer/transition-6.png differ diff --git a/docs/media/installer/transition-frames/frame-00.png b/docs/media/installer/transition-frames/frame-00.png new file mode 100644 index 0000000..7d5e49d Binary files /dev/null and b/docs/media/installer/transition-frames/frame-00.png differ diff --git a/docs/media/installer/transition-frames/frame-01.png b/docs/media/installer/transition-frames/frame-01.png new file mode 100644 index 0000000..1b552ff Binary files /dev/null and b/docs/media/installer/transition-frames/frame-01.png differ diff --git a/docs/media/installer/transition-frames/frame-02.png b/docs/media/installer/transition-frames/frame-02.png new file mode 100644 index 0000000..c8bb730 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-02.png differ diff --git a/docs/media/installer/transition-frames/frame-03.png b/docs/media/installer/transition-frames/frame-03.png new file mode 100644 index 0000000..b879d6a Binary files /dev/null and b/docs/media/installer/transition-frames/frame-03.png differ diff --git a/docs/media/installer/transition-frames/frame-04.png b/docs/media/installer/transition-frames/frame-04.png new file mode 100644 index 0000000..53356a4 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-04.png differ diff --git a/docs/media/installer/transition-frames/frame-05.png b/docs/media/installer/transition-frames/frame-05.png new file mode 100644 index 0000000..442f8ea Binary files /dev/null and b/docs/media/installer/transition-frames/frame-05.png differ diff --git a/docs/media/installer/transition-frames/frame-06.png b/docs/media/installer/transition-frames/frame-06.png new file mode 100644 index 0000000..3be267d Binary files /dev/null and b/docs/media/installer/transition-frames/frame-06.png differ diff --git a/docs/media/installer/transition-frames/frame-07.png b/docs/media/installer/transition-frames/frame-07.png new file mode 100644 index 0000000..c252d23 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-07.png differ diff --git a/docs/media/installer/transition-frames/frame-08.png b/docs/media/installer/transition-frames/frame-08.png new file mode 100644 index 0000000..dc6327a Binary files /dev/null and b/docs/media/installer/transition-frames/frame-08.png differ diff --git a/docs/media/installer/transition-frames/frame-09.png b/docs/media/installer/transition-frames/frame-09.png new file mode 100644 index 0000000..5fb7a8c Binary files /dev/null and b/docs/media/installer/transition-frames/frame-09.png differ diff --git a/docs/media/installer/transition-frames/frame-10.png b/docs/media/installer/transition-frames/frame-10.png new file mode 100644 index 0000000..2e862cb Binary files /dev/null and b/docs/media/installer/transition-frames/frame-10.png differ diff --git a/docs/media/installer/transition-frames/frame-11.png b/docs/media/installer/transition-frames/frame-11.png new file mode 100644 index 0000000..1e98c49 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-11.png differ diff --git a/docs/media/installer/transition-frames/frame-12.png b/docs/media/installer/transition-frames/frame-12.png new file mode 100644 index 0000000..c4d6834 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-12.png differ diff --git a/docs/media/installer/transition-frames/frame-13.png b/docs/media/installer/transition-frames/frame-13.png new file mode 100644 index 0000000..137f2bd Binary files /dev/null and b/docs/media/installer/transition-frames/frame-13.png differ diff --git a/docs/media/installer/transition-frames/frame-14.png b/docs/media/installer/transition-frames/frame-14.png new file mode 100644 index 0000000..d1c4414 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-14.png differ diff --git a/docs/media/installer/transition-frames/frame-15.png b/docs/media/installer/transition-frames/frame-15.png new file mode 100644 index 0000000..5d2fc17 Binary files /dev/null and b/docs/media/installer/transition-frames/frame-15.png differ diff --git a/docs/media/installer/transition-frames/frame-16.png b/docs/media/installer/transition-frames/frame-16.png new file mode 100644 index 0000000..6b95c1e Binary files /dev/null and b/docs/media/installer/transition-frames/frame-16.png differ diff --git a/docs/media/installer/transition-frames/frame-17.png b/docs/media/installer/transition-frames/frame-17.png new file mode 100644 index 0000000..b8bf49a Binary files /dev/null and b/docs/media/installer/transition-frames/frame-17.png differ diff --git a/docs/media/installer/transition-slow.gif b/docs/media/installer/transition-slow.gif new file mode 100644 index 0000000..eae35e5 Binary files /dev/null and b/docs/media/installer/transition-slow.gif differ diff --git a/docs/media/installer/transition-slow.mp4 b/docs/media/installer/transition-slow.mp4 new file mode 100644 index 0000000..f2470da Binary files /dev/null and b/docs/media/installer/transition-slow.mp4 differ diff --git a/docs/media/peripheral-battery-settings.png b/docs/media/peripheral-battery-settings.png new file mode 100644 index 0000000..3b10524 Binary files /dev/null and b/docs/media/peripheral-battery-settings.png differ diff --git a/docs/media/peripheral-battery.png b/docs/media/peripheral-battery.png new file mode 100644 index 0000000..ab905b0 Binary files /dev/null and b/docs/media/peripheral-battery.png differ diff --git a/docs/media/src/render.ps1 b/docs/media/src/render.ps1 index ea1ee66..7e425d7 100644 --- a/docs/media/src/render.ps1 +++ b/docs/media/src/render.ps1 @@ -1,9 +1,9 @@ -# Winlestia - renders the HTML/CSS illustrations (motion-design stills, not screen captures). -# stills -> docs/illustrations/*.webp (2000 px wide, quality 90) -# banner -> docs/media/banner.webp (2000 px wide) -# Edge headless at 4x device scale (5120x3200), then bicubic downscale with System.Drawing. +# Winlestia - rend les illustrations HTML/CSS (images fixes de motion design, pas des captures d'écran). +# stills -> docs/illustrations/*.webp (2000 px de large, qualité 90) +# banner -> docs/media/banner.webp (2000 px de large) +# Edge headless à l'échelle d'appareil 4x (5120x3200), puis réduction bicubique avec System.Drawing. # Usage: powershell -ExecutionPolicy Bypass -File render.ps1 [-Only dashboard,media,banner] -# -Shots : renders only the aurora-palette variants used by the videos into video/shots/ (generated, not committed) +# -Shots : rend uniquement les variantes de palette aurore utilisées par les vidéos dans video/shots/ (générées, non commitées) param([string[]]$Only = @(), [switch]$Shots) $ErrorActionPreference = 'Stop' $Only = @($Only | ForEach-Object { $_ -split ',' } | Where-Object { $_ }) @@ -12,13 +12,14 @@ try { (Get-Process -Id $PID).PriorityClass = 'BelowNormal' } catch {} $src = $PSScriptRoot $out = [IO.Path]::GetFullPath((Join-Path $src '..\..\illustrations')) $media = [IO.Path]::GetFullPath((Join-Path $src '..')) -$edge = @("${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe", "$env:ProgramFiles\Microsoft\Edge\Application\msedge.exe") | Where-Object { Test-Path $_ } | Select-Object -First 1 +$edge = @("${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe", "$env:ProgramFiles\Microsoft\Edge\Application\msedge.exe") | + Where-Object { Test-Path $_ } | Select-Object -First 1 if (-not $edge) { throw 'Microsoft Edge not found.' } $utf8 = New-Object System.Text.UTF8Encoding($false) $tmp = Join-Path ([IO.Path]::GetTempPath()) 'winlestia-render' New-Item -ItemType Directory -Force -Path $tmp, $out | Out-Null -# name, fragments (joined), palette override, wallpaper, window title +# nom, fragments (joints), surcharge de palette, fond d'écran, titre de fenêtre $scenes = @( @{ n='desktop'; frag=@('desktop'); amb=''; wp='wallpaper-aurora.svg'; title='Desktop' }, @{ n='dashboard'; page='dashboard.html' }, @@ -34,7 +35,8 @@ $scenes = @( @{ n='v-workspaces'; frag=@('workspaces'); amb=''; wp='wallpaper-aurora.svg'; title='Workspaces'; shot=$true }, @{ n='v-workspaces-warm'; frag=@('workspaces'); amb='tokens-warm.css'; wp='wallpaper-warm.svg'; title='Workspaces'; shot=$true }, @{ n='v-workspaces-teal'; frag=@('workspaces'); amb='tokens-teal.css'; wp='wallpaper-teal.svg'; title='Workspaces'; shot=$true }, - @{ n='v-dock-palette'; frag=@('dock'); amb=''; wp='wallpaper-aurora.svg'; title='Dock and quick command'; shot=$true }, + @{ n='v-dock-palette'; frag=@('dock'); amb=''; wp='wallpaper-aurora.svg'; title='Dock and quick command'; + shot=$true }, @{ n='v-tools'; frag=@('outils'); amb=''; wp='wallpaper-aurora.svg'; title='Tools'; shot=$true }, @{ n='v-settings'; frag=@('reglages'); amb=''; wp='wallpaper-aurora.svg'; title='Settings'; shot=$true }, @{ n='banner'; page='banner.html'; w=1280; h=640; scale=2; dest=$media } @@ -50,10 +52,11 @@ foreach ($s in $scenes) { $k = if ($s.scale) { $s.scale } else { 4 } $dest = if ($s.dest) { $s.dest } else { $out } if ($Shots) { $dest = Join-Path $src 'video\shots'; New-Item -ItemType Directory -Force -Path $dest | Out-Null } - if ($s.frag) { # compose page = template + fragments + if ($s.frag) { # composition de la page = modèle + fragments $body = ($s.frag | ForEach-Object { [IO.File]::ReadAllText((Join-Path $src "fragments\$_.html"), $utf8) }) -join "`n" $amb = if ($s.amb) { "" } else { '' } - $html = $template.Replace('{{TITLE}}', $s.title).Replace('{{AMBIANCE}}', $amb).Replace('{{WALLPAPER}}', $s.wp).Replace('{{ICONS}}', $icons).Replace('{{BODY}}', $body) + $html = $template.Replace('{{TITLE}}', $s.title).Replace('{{AMBIANCE}}', $amb).Replace('{{WALLPAPER}}', $s.wp).Replace('{{ICONS}}', + $icons).Replace('{{BODY}}', $body) $page = "_$($s.n).html" [IO.File]::WriteAllText((Join-Path $src $page), $html, $utf8) } else { $page = $s.page } @@ -69,14 +72,16 @@ foreach ($s in $scenes) { $img = [Drawing.Image]::FromFile($big) $dst = New-Object Drawing.Bitmap $ow, $oh $g = [Drawing.Graphics]::FromImage($dst) - $g.InterpolationMode = 'HighQualityBicubic'; $g.SmoothingMode = 'HighQuality'; $g.PixelOffsetMode = 'HighQuality'; $g.CompositingQuality = 'HighQuality' + $g.InterpolationMode = 'HighQualityBicubic'; $g.SmoothingMode = 'HighQuality'; $g.PixelOffsetMode = 'HighQuality'; + $g.CompositingQuality = 'HighQuality' $g.DrawImage($img, 0, 0, $ow, $oh) $g.Dispose(); $img.Dispose() if ($Shots) { $dst.Save((Join-Path $dest "$($s.n).png"), [Drawing.Imaging.ImageFormat]::Png); $dst.Dispose() } else { $mid = Join-Path $tmp "$($s.n)-2x.png" $dst.Save($mid, [Drawing.Imaging.ImageFormat]::Png); $dst.Dispose() - & ffmpeg -v error -y -i $mid -vf scale=2000:-1:flags=lanczos -c:v libwebp -quality 90 -compression_level 6 (Join-Path $dest "$($s.n).webp") + $webp = Join-Path $dest "$($s.n).webp" + & ffmpeg -v error -y -i $mid -vf scale=2000:-1:flags=lanczos -c:v libwebp -quality 90 -compression_level 6 $webp if ($LASTEXITCODE -ne 0) { throw "ffmpeg failed for $($s.n)" } } Write-Host "ok $($s.n)" diff --git a/docs/media/src/video/build_scene.py b/docs/media/src/video/build_scene.py index 680ec1b..f7d8deb 100644 --- a/docs/media/src/video/build_scene.py +++ b/docs/media/src/video/build_scene.py @@ -37,14 +37,17 @@ def layers(tag): background:rgba(10,6,19,.45);border:1px solid rgba(255,255,255,.16)}} #title,#end{{position:absolute;inset:0;opacity:0}} #title .bgp,#end .bgp{{position:absolute;inset:-40px;background:url("../wallpaper-aurora.svg") center/cover;filter:saturate(1.15)}} -#title .shade,#end .shade{{position:absolute;inset:0;background:radial-gradient(ellipse 60% 50% at 50% 50%,rgba(10,6,19,.62),rgba(10,6,19,.18) 70%,rgba(10,6,19,0))}} +#title .shade,#end .shade{{position:absolute;inset:0; + background:radial-gradient(ellipse 60% 50% at 50% 50%,rgba(10,6,19,.62),rgba(10,6,19,.18) 70%,rgba(10,6,19,0))}} .cen{{position:absolute;left:0;right:0;display:flex;flex-direction:column;align-items:center;text-align:center}} -.mark{{width:250px;height:178px;background:url("../../../../src/frontend/assets/winlestia-mark.png") no-repeat;background-size:350px 350px;background-position:-53px -76px; +.mark{{width:250px;height:178px;background:url("../../../../src/frontend/assets/winlestia-mark.png") no-repeat; + background-size:350px 350px;background-position:-53px -76px; filter:drop-shadow(0 0 22px rgba(214,150,255,.75)) drop-shadow(0 6px 22px rgba(60,20,120,.6))}} .nm{{font-weight:700;letter-spacing:-2px;line-height:1;display:flex;filter:drop-shadow(0 4px 24px rgba(120,40,200,.55))}} .nm span{{display:inline-block;background:linear-gradient(180deg,#fff 30%,#e6c9ff 100%);-webkit-background-clip:text;color:transparent}} .tg{{font-weight:500;color:rgba(255,255,255,.92);text-shadow:0 2px 14px rgba(20,8,40,.6)}} -.url{{padding:12px 28px;border-radius:99px;font-weight:500;color:#f4e9ff;background:rgba(255,255,255,.12);border:1px solid rgba(255,255,255,.26); +.url{{padding:12px 28px;border-radius:99px;font-weight:500;color:#f4e9ff;background:rgba(255,255,255,.12); + border:1px solid rgba(255,255,255,.26); box-shadow:inset 0 1px 0 rgba(255,255,255,.18),0 6px 20px rgba(10,6,19,.35)}}
@@ -53,9 +56,11 @@ def layers(tag):
{layers("c")}
-
A port of Caelestia for Windows 11
+
+
A port of Caelestia for Windows 11
-
Desktop shell for Windows 11
{REPO_URL}
+
+
Desktop shell for Windows 11
{REPO_URL}
diff --git a/docs/media/src/video/capture.py b/docs/media/src/video/capture.py index 9afdb1d..435dd3b 100644 --- a/docs/media/src/video/capture.py +++ b/docs/media/src/video/capture.py @@ -117,14 +117,16 @@ def main(): shot(float(t), frames / f"t{float(t):05.2f}.png") finally: edge.terminate() - out = Path(os.environ.get("WL_DEBUG_DIR", Path(tempfile.gettempdir()) / "winlestia-frames-debug")); out.mkdir(parents=True, exist_ok=True) + out = Path(os.environ.get("WL_DEBUG_DIR", Path(tempfile.gettempdir()) / "winlestia-frames-debug")) + out.mkdir(parents=True, exist_ok=True) for f in frames.glob("t*.png"): shutil.copy(f, out / f.name) print("dumped to", out); return n = round(a.seconds * a.fps) if not a.frames_dir: t0 = time.time() - ps = [multiprocessing.Process(target=worker, args=(k, a.workers, n, a.fps, w, h, str(tmp), str(frames))) for k in range(a.workers)] + ps = [multiprocessing.Process(target=worker, args=(k, a.workers, n, a.fps, w, h, str(tmp), str(frames))) + for k in range(a.workers)] [p.start() for p in ps]; [p.join() for p in ps] got = len(list(frames.glob("f*.png"))) print(f"captured {got}/{n} frames in {time.time() - t0:.1f}s") diff --git a/docs/media/winjets/all.png b/docs/media/winjets/all.png new file mode 100644 index 0000000..5c49418 Binary files /dev/null and b/docs/media/winjets/all.png differ diff --git a/docs/media/winjets/winlestia.agenda-168x168.png b/docs/media/winjets/winlestia.agenda-168x168.png new file mode 100644 index 0000000..8a088ae Binary files /dev/null and b/docs/media/winjets/winlestia.agenda-168x168.png differ diff --git a/docs/media/winjets/winlestia.agenda-352x352.png b/docs/media/winjets/winlestia.agenda-352x352.png new file mode 100644 index 0000000..8a0dd34 Binary files /dev/null and b/docs/media/winjets/winlestia.agenda-352x352.png differ diff --git a/docs/media/winjets/winlestia.agenda-536x536.png b/docs/media/winjets/winlestia.agenda-536x536.png new file mode 100644 index 0000000..4fe70a5 Binary files /dev/null and b/docs/media/winjets/winlestia.agenda-536x536.png differ diff --git a/docs/media/winjets/winlestia.agenda-vide-352x352.png b/docs/media/winjets/winlestia.agenda-vide-352x352.png new file mode 100644 index 0000000..7aabe1d Binary files /dev/null and b/docs/media/winjets/winlestia.agenda-vide-352x352.png differ diff --git a/docs/media/winjets/winlestia.calendrier-168x168.png b/docs/media/winjets/winlestia.calendrier-168x168.png new file mode 100644 index 0000000..244f925 Binary files /dev/null and b/docs/media/winjets/winlestia.calendrier-168x168.png differ diff --git a/docs/media/winjets/winlestia.calendrier-352x352.png b/docs/media/winjets/winlestia.calendrier-352x352.png new file mode 100644 index 0000000..e4bab98 Binary files /dev/null and b/docs/media/winjets/winlestia.calendrier-352x352.png differ diff --git a/docs/media/winjets/winlestia.fichiers-168x168.png b/docs/media/winjets/winlestia.fichiers-168x168.png new file mode 100644 index 0000000..befc1c0 Binary files /dev/null and b/docs/media/winjets/winlestia.fichiers-168x168.png differ diff --git a/docs/media/winjets/winlestia.fichiers-352x352.png b/docs/media/winjets/winlestia.fichiers-352x352.png new file mode 100644 index 0000000..2a04cc0 Binary files /dev/null and b/docs/media/winjets/winlestia.fichiers-352x352.png differ diff --git a/docs/media/winjets/winlestia.fichiers-536x536.png b/docs/media/winjets/winlestia.fichiers-536x536.png new file mode 100644 index 0000000..90df889 Binary files /dev/null and b/docs/media/winjets/winlestia.fichiers-536x536.png differ diff --git a/docs/media/winjets/winlestia.horloge-168x168.png b/docs/media/winjets/winlestia.horloge-168x168.png new file mode 100644 index 0000000..caccdde Binary files /dev/null and b/docs/media/winjets/winlestia.horloge-168x168.png differ diff --git a/docs/media/winjets/winlestia.horloge-352x168.png b/docs/media/winjets/winlestia.horloge-352x168.png new file mode 100644 index 0000000..7c2c694 Binary files /dev/null and b/docs/media/winjets/winlestia.horloge-352x168.png differ diff --git a/docs/media/winjets/winlestia.horloge-536x352.png b/docs/media/winjets/winlestia.horloge-536x352.png new file mode 100644 index 0000000..5cd9df7 Binary files /dev/null and b/docs/media/winjets/winlestia.horloge-536x352.png differ diff --git a/docs/media/winjets/winlestia.lecteur-168x168.png b/docs/media/winjets/winlestia.lecteur-168x168.png new file mode 100644 index 0000000..a8c1f2b Binary files /dev/null and b/docs/media/winjets/winlestia.lecteur-168x168.png differ diff --git a/docs/media/winjets/winlestia.lecteur-352x168.png b/docs/media/winjets/winlestia.lecteur-352x168.png new file mode 100644 index 0000000..caad2a7 Binary files /dev/null and b/docs/media/winjets/winlestia.lecteur-352x168.png differ diff --git a/docs/media/winjets/winlestia.lecteur-520x340.png b/docs/media/winjets/winlestia.lecteur-520x340.png new file mode 100644 index 0000000..46ea269 Binary files /dev/null and b/docs/media/winjets/winlestia.lecteur-520x340.png differ diff --git a/docs/media/winjets/winlestia.marches-168x168.png b/docs/media/winjets/winlestia.marches-168x168.png new file mode 100644 index 0000000..bb010c2 Binary files /dev/null and b/docs/media/winjets/winlestia.marches-168x168.png differ diff --git a/docs/media/winjets/winlestia.marches-352x352.png b/docs/media/winjets/winlestia.marches-352x352.png new file mode 100644 index 0000000..a5e639b Binary files /dev/null and b/docs/media/winjets/winlestia.marches-352x352.png differ diff --git a/docs/media/winjets/winlestia.marches-536x536.png b/docs/media/winjets/winlestia.marches-536x536.png new file mode 100644 index 0000000..314bdaf Binary files /dev/null and b/docs/media/winjets/winlestia.marches-536x536.png differ diff --git a/docs/media/winjets/winlestia.meteo-168x168.png b/docs/media/winjets/winlestia.meteo-168x168.png new file mode 100644 index 0000000..84cb6b9 Binary files /dev/null and b/docs/media/winjets/winlestia.meteo-168x168.png differ diff --git a/docs/media/winjets/winlestia.meteo-352x168.png b/docs/media/winjets/winlestia.meteo-352x168.png new file mode 100644 index 0000000..52a4b4f Binary files /dev/null and b/docs/media/winjets/winlestia.meteo-352x168.png differ diff --git a/docs/media/winjets/winlestia.meteo-536x352.png b/docs/media/winjets/winlestia.meteo-536x352.png new file mode 100644 index 0000000..935ae2d Binary files /dev/null and b/docs/media/winjets/winlestia.meteo-536x352.png differ diff --git a/docs/media/winjets/winlestia.notes-168x168.png b/docs/media/winjets/winlestia.notes-168x168.png new file mode 100644 index 0000000..2b74989 Binary files /dev/null and b/docs/media/winjets/winlestia.notes-168x168.png differ diff --git a/docs/media/winjets/winlestia.notes-352x352.png b/docs/media/winjets/winlestia.notes-352x352.png new file mode 100644 index 0000000..373211e Binary files /dev/null and b/docs/media/winjets/winlestia.notes-352x352.png differ diff --git a/docs/media/winjets/winlestia.stockage-168x168.png b/docs/media/winjets/winlestia.stockage-168x168.png new file mode 100644 index 0000000..c69adea Binary files /dev/null and b/docs/media/winjets/winlestia.stockage-168x168.png differ diff --git a/docs/media/winjets/winlestia.stockage-352x168.png b/docs/media/winjets/winlestia.stockage-352x168.png new file mode 100644 index 0000000..61b748a Binary files /dev/null and b/docs/media/winjets/winlestia.stockage-352x168.png differ diff --git a/docs/media/winjets/winlestia.stockage-536x536.png b/docs/media/winjets/winlestia.stockage-536x536.png new file mode 100644 index 0000000..ef6354f Binary files /dev/null and b/docs/media/winjets/winlestia.stockage-536x536.png differ diff --git a/docs/media/winjets/winlestia.systeme-168x168.png b/docs/media/winjets/winlestia.systeme-168x168.png new file mode 100644 index 0000000..a4de46d Binary files /dev/null and b/docs/media/winjets/winlestia.systeme-168x168.png differ diff --git a/docs/media/winjets/winlestia.systeme-352x352.png b/docs/media/winjets/winlestia.systeme-352x352.png new file mode 100644 index 0000000..e98769a Binary files /dev/null and b/docs/media/winjets/winlestia.systeme-352x352.png differ diff --git a/docs/media/winjets/winlestia.systeme-536x536.png b/docs/media/winjets/winlestia.systeme-536x536.png new file mode 100644 index 0000000..d4fc153 Binary files /dev/null and b/docs/media/winjets/winlestia.systeme-536x536.png differ diff --git a/docs/quality/MATRIX.md b/docs/quality/MATRIX.md deleted file mode 100644 index 21c098f..0000000 --- a/docs/quality/MATRIX.md +++ /dev/null @@ -1,89 +0,0 @@ -# Verification matrix - -Branch `quality/community-fixes`, commits `6b1ba4a..29dd13a`. Date: 2026-11-04. - -## Request matrix - -| Item | Cause | Fix | Files / commit | Proof | Limits | -|---|---|---|---|---|---| -| #1 media widget | Firefox AUMID hash shown as name; dead session object kept (not compared by AUMID); metadata not re-read; position not ticking (frontend `positionChanged` was a no-op, duration may be 0); audio session matching by exe stem fails for Firefox child processes; visualizer target PID 0 for Firefox | Identity compared by AUMID; readable display name; metadata re-read; position extrapolated only inside the existing visible-dashboard timer; audio sessions matched through the process tree; visualizer uses WASAPI process loopback (`PROCESS_LOOPBACK_MODE_INCLUDE_TARGET_PROCESS_TREE`, `src/backend/ProcessAudio.cpp:21`) on the root PID of the matched tree, 2048-pt Hann FFT into 48 log bands; paused: capture destroyed, bars decay to 0; Discord not captured unless a descendant. Dashboard bar (AudioBars) = default output loopback, unchanged | ebac43b | `tests/MediaIdentity` 61/61 | Not yet verified live with Firefox/YouTube. Registry DisplayName may not exist (process heuristic used). Ambiguous browsers shown as "Navigateur". Per-tab volume impossible (Windows audio sessions are per process) | -| #2 social rail overlays tabs | Rail drawn over tab content | Dashboard slides by the real overlap and scales panes (min 0.7). Below ~1000 logical px the rail overlays (documented fallback) | ef8a438 | qmllint 0 errors; arithmetic checked for 1920 and 1280 widths | Not visually checked at 100/125/150/200 %, FR/EN/ES, multi-DPI. Text scaled to >= 0.7 | -| Reopen on last tab (top-bar reveal) | Dashboard always opened on the default tab | Last tab kept in session memory only (explicit decision: not persisted). Drag-drop menu priority unchanged | ef8a438 | qmllint 0 errors | Multi-monitor, fullscreen and quiet mode not manually tested | -| Installer English + auto detect | Installer was French only | English default, language auto-detected (EN fallback, FR, ES); UTF-8 BOM added; licence files shipped | b27b22c, 17cbda7 | Installer compiled | Not executed: fresh install, upgrade with preferences kept, paths with spaces and accents, launch without SDK, uninstall (needs test account or VM) | -| Security | Audit requested | SQL injection reported as false positive, with evidence. Hardening: L1 bookmarks http/https only (user-visible change); L2 private folder for task XML; L3 `install.py` typographic quotes | 966b58e, see `SECURITY-AUDIT.md` | `tests/SecurityHardening` 20/20, `tests/FileSearch` 22/22 | No confirmed vulnerability; no external pen-test | -| Readability | Wide files, ad hoc name logic, tracked artefacts | 5f2c24a name normaliser; b7220cb docs, `.editorconfig`, 31 artefacts untracked; 659b862 QtShellBridge split; 8857ab3 Coordinator/Models/Visuals split | 5f2c24a, b7220cb, 659b862, 8857ab3 | Normaliser 43/43 + PowerShell parity; splits checked by token equivalence; Preferences JSON order kept | Behaviour-preserving only; no runtime comparison beyond tests | -| .NET 10 | Requested | 31 csproj net8.0 to net10.0 (suffixes kept); Microsoft.Data.Sqlite 10.0.14, other packages unchanged and build. Self-contained publish verified: coreclr/hostfxr present, runtimeconfig 10.0.14, `runtimes/` tree identical to the net8 payload. Native95 test made baseline-aware: on net10 the maximized titled fixture already has a window region before RoundMaximized; product restores the original region correctly; test compares with the captured baseline (type + EqualRgn) | fe48ea8 | Full build; all test projects pass | Installer not yet run on a PC without SDK (no test session available; owner chose to publish and handle bug reports) | -| Hygiene | Not requested explicitly | Duplicate ProcessAudio.dll item removed, CS9191 fixed, analyzers enabled as suggestions (`Directory.Build.props`, `.editorconfig`), local CI workflow `.github/workflows/build.yml` (not pushed) | 44d3449 | Build | Backend warning WFO0003 (app.manifest high-DPI, ApplicationHighDpiMode) left on purpose: changing it may alter DPI behaviour | -| Atomic writes | Robustness | `AtomicFile.cs` / `atomicfile.py` (unique tmp, flush, replace) on preferences, clipboard history, social counts, recents, taskbar lease, tiler exclusions, handler backup, Explorer appearance files; Python language.json, hidden wallpapers, weather city | 125dd1c | `tests/AtomicFile` 13/13 | No power-loss test | -| Preferences recovery | Robustness | Corrupt JSON: keep `.corrupt.bak`, restore from `.bak`, defaults only if both fail. Transient IO errors retried once, never treated as corruption | 89f76b2 | `tests/StoreRecovery` 10/10 | None | - -## Readability metrics (base to now) - -| Metric | Base | Now | -|---|---|---| -| Lines over 1000 characters | 29 | 0 | -| Lines over 500 characters | 207 | 0 | -| One-line loops | 246 | 54 (collection initialisers) | -| C# namespaces | one dominant namespace (81% of files) | 12 area namespaces (largest 20%) | -| French literals in code | about 535 lines | data keys and patterns only (about 140 sites: category ids, regexes, preference ids; kept on purpose) | -| App-name normaliser | chained `Regex.Replace` | ordered rule table plus a dictionary of known display names | - -UI text is in `Views/Strings.cs` (fr, en, es); log and exception messages are in English (commits 888c4c4, 29dd13a). The taskbar window title stays French because `TaskbarRescue.cpp` matches it verbatim. - -## Formatting and checks - -- CSharpier (printWidth 120) and ruff are enforced (`dotnet-tools.json`, `.csharpierrc.json`, `ruff.toml`); formatting commit f8bc3e2 changes no behaviour. -- `.editorconfig` and analyzers are in place (analyzers as suggestions). -- CI runs the `StringsTable` test. - -## Platform - -.NET 8 to .NET 10 (see the .NET 10 row above). Version 0.9.1. - -## SQL injection claim - -Investigated: no exploitable injection. `BookmarksCore.cs` passes values through the parameterised `$u`; the Windows Search query escapes literals with `EscapeLiteral`. Evidence in `SECURITY-AUDIT.md` (commit 966b58e). - -## Live validation (2026-11-04) - -The 0.9.0 build was installed on the maintainer's PC and the UI was tested by the user: OK. The `FullscreenWatcher` test needs a real foreground desktop; in headless runs it ends in an environmental timeout. - -## Automated tests - -All 30 projects pass (tests-final run). New: AtomicFile 13, StoreRecovery 10. - -With counts: AppCatalogueWatch 32, AppNameNormalizer 43, AudioBars 22, FileSearch 22, AutostartPolicy 10, FramePolicy 10, BrightnessPolicy 21, CliCommands 106, DesktopReassert 15, FilesHandler 64, FilesPinMigration 8, FilesPreloadPolicy 12, FilesRouter 27, MediaIdentity 61, SecurityHardening 20, SocialPolicy 11, WifiPolicy 41, FolderIcons 18. - -PASS without counts: DataDirMigration, StaleDockTarget, TileLogicTests, FullscreenWatcher (finished within 90 s this run), NetworkKind, VirtualDesktops. - -JSON flags all true: Explorer077, Native95, Tiler075. Audio06: variation=True, silence=True. - -## Manual checks done - -- qmllint on the changed QML: 0 errors. -- Installer compiled: build 1 min 13 s with warm caches. -- Payload inspected: self-contained runtime, embedded Python, restore tools present, no Unsplash key. - -Installer artefact (0.9.0, historical): build/out/Winlestia-Setup-0.9.0.exe (rebuilt on .NET 10; 196,046,165 bytes, SHA256 64c53b17f2c49b08d96f7201b111caea6c7b58857b3c7d77bba516fa02ad4ce2) - -0.9.1 artefact: `Winlestia-Setup-0.9.1.exe`, 196,088,088 bytes, SHA-256 `93293e815af688fd6135e6f1cd271b5481475bd3d4ba2b90fdaebd294c208c51`, built from 506cee3 in a neutral path (no personal path in the payload). - -## Not executed - -- Live UI checks (media widget with Firefox/YouTube, social rail at several DPI and languages, top-bar reveal). -- Installer scenarios (fresh, upgrade, special paths, no-SDK launch, uninstall). -- CPU, memory and latency measurements (visualizer capture, position timer). -- Installer run on a PC without SDK (.NET 10 payload). -- Power-loss test of atomic writes. - -## Known issues found, not fixed - -- Payload contains the build user path in `.pyc` and numpy config. Build from a neutral path such as `C:\wl-build`, as recommended in the `build.ps1` header. -- `build.ps1` fails if stderr is redirected inside PowerShell (a pip warning becomes fatal). -- `build.ps1` hard-coded the version in its final message (now 0.9.1, still hard-coded). -- `src/terminal/clink-profile` (3 files) is tracked since v0.7.6 and shipped by `build.ps1`. Decided: keep tracked; contains no personal data, it is the shipped terminal theme. -- Autostart task name is `WinlestiaShell`. -- Swallowed errors left as findings: Store legacy Workspace-v4 migration `catch{}`, DataDir `CreateDirectory` `catch{}`, FilesHandler `LoadBackup` returns null, icon writes `catch{}`, SocialService `QueueSave` `catch{}`. -- Timers: Coordinator.cs 120 ms timer runs for the process lifetime (cheap; follow-up). Frontend pointer timer 500 ms when idle. -- async void audit: no crash path (global Dispatcher/AppDomain handlers exist; Files app handlers wrapped). -- Backend warning WFO0003 left on purpose (see Hygiene row). diff --git a/docs/quality/NAME-NORMALISATION.md b/docs/quality/NAME-NORMALISATION.md deleted file mode 100644 index de815b0..0000000 --- a/docs/quality/NAME-NORMALISATION.md +++ /dev/null @@ -1,27 +0,0 @@ -# App display-name normalisation - -Single C# source of truth: `src/backend/Platform/AppNameNormalizer.cs` (`Normalize`). `CatalogueWatchRules.CleanName` is a thin wrapper. -PowerShell twin: `Clean-Name` in `src/backend/Inventory.ps1` (keep in sync; `tests/AppNameNormalizer/parity.ps1` compares both). - -Rules apply in this order (all case-insensitive, culture-invariant), then the result is trimmed. Null gives "". - -| # | Rule | Regex | Example | -|---|------|-------|---------| -| 1 | ExeShortcutSuffix | `\.exe\s*-\s*Raccourci$` | `Foo.exe - Raccourci` -> `Foo` | -| 2 | ShortcutSuffix | `\s*-\s*Raccourci$` | `Foo - Raccourci` -> `Foo` | -| 3 | LaunchPrefix | `^Lancer\s+` | `Lancer Foo` -> `Foo` | -| 4 | VlcExe | `^VLC Media Player\.exe$` | `VLC Media Player.exe` -> `VLC Media Player` | -| 5 | TrademarkSigns | `Â?®\|™` | `Foo™` -> `Foo` | -| 6 | Windows10Suffix | `\s*-\s*Windows10$` | `Foo - Windows10` -> `Foo` | -| 7 | CrimsonDesert | `^CrimsonDesert$` | `CrimsonDesert` -> `Crimson Desert` | -| 8 | HogwartsLegacy | `^HogwartsLegacy$` | `HogwartsLegacy` -> `Hogwarts Legacy` | - -## Where used -- `AppCatalogueWatcher.cs` (via `CatalogueWatchRules.CleanName`): shortcut events and catalogue scans. -- `Inventory.ps1` `Clean-Name`: inventory of shortcuts and Epic pending installs. - -## Adding a rule -1. Add a named `static readonly Regex` with an XML doc example in `AppNameNormalizer.cs` and apply it in `Normalize` (order matters). -2. Add the same `-replace` to `Clean-Name` in `Inventory.ps1` at the same position. -3. Add inputs to `Inputs` and recorded outputs to `Expected` in `tests/AppNameNormalizer/Program.cs` (same index). -4. Run `tests/AppNameNormalizer` (expects `TOTAL n/n`; parity prints `SKIP` if PowerShell is unavailable) and `tests/AppCatalogueWatch`. diff --git a/docs/quality/PROGRESS.md b/docs/quality/PROGRESS.md deleted file mode 100644 index fc17d0c..0000000 --- a/docs/quality/PROGRESS.md +++ /dev/null @@ -1,64 +0,0 @@ -# Quality pass — progress log - -Branch `quality/community-fixes`, -based on `6b1ba4a` (= tag `v0.9.0` + README-only commits; no `src/` or `installer/` difference). -The installed build reports `0.9.0+a41b13b` (tag `v0.9.0`). `winlestia-0.9.0-clean` is an older -ancestor (`27e07f6`) and is not used. Nothing is pushed. - -## Baseline (2026-11-04) - -| Language | Files | Lines | Lines > 120 | > 300 | > 1000 | -|---|---|---|---|---|---| -| C# | 183 | 18,234 | 4,150 | 645 | 32 | -| QML | 142 | 11,764 | 900 | 69 | 0 | -| Python | 72 | 8,339 | 1,131 | 74 | 0 | -| PowerShell | 16 | 1,071 | 144 | 5 | 0 | - -- C# namespaces: `PanneauxGlass` 129 files, `WinlestiaFiles` 25, `Winlestia.Shared` 3, `WinlestiaCli` 1, none 25. -- 226 empty `catch` blocks, 65 direct `File.WriteAll*` calls, 67 timers, ~14 `async void` candidates. -- No `.editorconfig`, no analyzer configuration, no CI workflow. -- Worst files: `QtShellBridge.cs` (line of 4,775 chars, 105 command cases), `Coordinator.cs` (3,324), - `Visuals.cs`, `Models.cs`, `frontend.py`. -- 30 generated artefacts (`performance-*.json`, `verification-*.json`, …) are tracked in `src/backend`. -- Tests (25 console projects, 90 s cap each, script `run-tests.ps1` pattern): 24 report all checks - passing; `FullscreenWatcher` does not finish within 90 s (pre-existing, to investigate). - Backend Release build: 8.7 s, 0 errors. -- Toolchain: SDK 8.0.407 only. Backend/Files published self-contained (`build.ps1`), so target PCs need no runtime. - -## Plan (separate commits, in this order) - -1. **Fix — media widget (#1)**: session identity, AUMID display name, browser audio-session matching, - visualizer target, live position. Pure functions + tests. -2. **Fix — social rail reserves space (#2)** and **dashboard reopens on last tab** (session memory). -3. **Fix — installer in English** with automatic language detection (EN fallback, FR, ES). -4. **Security hardening** (no confirmed vulnerability; see `SECURITY-AUDIT.md`). -5. **Structure (behaviour-preserving)**: `.editorconfig`, analyzers, shortcut-name normalisation module, - splitting the widest files, removing tracked artefacts, contributor docs. -6. **Migration .NET 8 → .NET 10** (separate commit; needs the .NET 10 SDK). -7. Build + local installer, verification matrix. - -## User-visible changes - -- Bookmarks with file: URIs no longer open (only http/https). - -## Log - -- 2026-11-04: audits done (architecture, security, media, social rail/top bar, .NET/installer). -- 2026-11-04: committed ef8a438 social rail + last tab, b27b22c installer EN/auto-detect, ebac43b media #1 (61 tests) -- 2026-11-04: lot 4 security hardening (see SECURITY-AUDIT.md) -- 2026-11-04: 5f2c24a shortcut-name normaliser (43 tests, PowerShell parity) -- 2026-11-04: b7220cb docs, .editorconfig, 31 generated artefacts untracked -- 2026-11-04: 659b862 QtShellBridge split into partial files (token equivalence) -- 2026-11-04: 8857ab3 Coordinator/Models/Visuals split (token equivalence, Preferences JSON order kept) -- 2026-11-04: 17cbda7 installer ships Caelestia licence and notices -- 2026-11-04: build + 27 test projects pass; installer Winlestia-Setup-0.9.0.exe built; see MATRIX.md (.NET 10 not done) -- 2026-11-04: fe48ea8 .NET 10 migration (31 csproj, Sqlite 10.0.14, Native95 baseline-aware, self-contained publish verified) -- 2026-11-04: 44d3449 hygiene (duplicate item, CS9191, analyzers as suggestions, local CI) -- 2026-11-04: 125dd1c atomic writes for durable state (AtomicFile 13/13) -- 2026-11-04: 89f76b2 preferences recovery from .bak (StoreRecovery 10/10); 30 test projects pass; installer to be rebuilt -- 2026-11-04: f8bc3e2 CSharpier (printWidth 120) and ruff; no line over 500 characters (was 207 over 500, 29 over 1000); one-line loops 246 to 54 -- 2026-11-04: 0a53929 backend split into 12 area namespaces (largest 20% of files, was 81%); AppNameNormalizer as ordered rule table plus KnownDisplayNames -- 2026-11-04: 888c4c4, 29dd13a French literals out of code (about 535 lines to about 140 data keys and patterns); UI text in Views/Strings.cs (fr/en/es), English logs; StringsTable test in CI -- 2026-11-04: SQL injection claim investigated: no exploitable injection (parameterised `$u`, EscapeLiteral in the Windows Search query); see SECURITY-AUDIT.md -- 2026-11-04: live validation: 0.9.0 build installed on the maintainer's PC, UI tested OK. FullscreenWatcher test needs a real foreground desktop (environmental timeout in headless runs) -- 2026-11-04: version bumped to 0.9.1; notes in docs/RELEASE-0.9.1.md diff --git a/docs/quality/SECURITY-AUDIT.md b/docs/quality/SECURITY-AUDIT.md deleted file mode 100644 index 2b62b0c..0000000 --- a/docs/quality/SECURITY-AUDIT.md +++ /dev/null @@ -1,37 +0,0 @@ -# Security audit - lot 4 (2026-11-04) - -## Scope -C# backend (`src/backend`), file manager IPC (`src/files/SingleInstance.cs`, `src/backend/Shared/FilesPipe.cs`), Python frontend IPC client (`src/frontend/frontend.py`), terminal installer (`src/terminal/install.py`), backend installer script (`src/backend/Install.ps1`), and the community claim of "SQL injection". - -## Method -Manual reading of the cited code (line numbers re-located with `rg`), targeted pure-function tests (`tests/SecurityHardening`), Release build of the backend. No dynamic testing, no fuzzing, no scheduled task or schtasks call was run. This is a point-in-time review; it does not prove the absence of other issues. - -## SQL injection claim: false positive -| Claim | Evidence read | -|---|---| -| Bookmark favicon lookup | `BookmarksCore.cs` `Query()`: the only `string.Format` argument is a constant clause (`=$u` or ` LIKE $u`); values go through `Parameters.AddWithValue("$u", ...)`. No user text reaches the SQL text. | -| Windows Search query | `FileSearch.cs` `TryBuild`: term is normalised, `NeutraliseContains` replaces `" * % _ [ ]` with blanks, `EscapeLiteral` doubles `'`; the profile path is fully-qualified-checked, NUL-checked and `EscapeLiteral`-ed. Characterised by tests (see S5). | -| WMI/WQL | `CpuTempChain.cs`, `OsdWatcher.cs`: query strings are constants. | -Result: not confirmed; no injectable sink found in the code read. - -## Findings -| ID | File:line | Scenario | Impact | Status | Fix | Test | -|---|---|---|---|---|---|---| -| S1 | `BookmarksService.cs` Open (~149) | Imported/edited bookmark with `file://server/share/...` or `file:///...` passed to the browser | file: was accepted; a UNC host makes Windows authenticate to a remote SMB server, local files open in browser. Requires a malicious bookmark already in the user's browser profile. Low | Hardening | New `BookmarkUri.IsOpenable` (http/https only). file: was not documented as a feature; the only caller is `QtShellBridge.cs:205` (`bookmarksOpen`). User-visible behaviour change: `file:` bookmarks previously opened and are now refused. about:/edge: were never accepted, left refused | `tests/SecurityHardening` (javascript:, file:, UNC, ms-settings:, data:, malformed, http, https) | -| S2 | `AutostartTask.cs` Create (~29) | Task XML written to shared `%TEMP%` then read by `schtasks /Create /XML` | Predictable-window swap by another local process of the same user (a different user cannot write into this user's `%TEMP%` by default ACL, but the pattern is fragile). Low | Hardening | XML now written to `%LOCALAPPDATA%\Panneaux\tmp\winlestia-task-.xml` (created if missing), deleted in `finally`. Task name and XML content unchanged | `AutostartPolicy.PrivateTaskFile` tests (location, unique, not under `%TEMP%`). `schtasks` itself NOT run | -| S3 | `src/terminal/install.py:58-65` | Script path taken from the Run registry value is embedded in a single-quoted PowerShell literal for `-EncodedCommand`; only `'` was doubled, but PowerShell also treats U+2018/2019/201A/201B as quote delimiters | A path containing a typographic quote would break out of the literal (also a functional bug for user names like O'Brien with a curly quote). The value is in HKCU, so exploiting it already needs same-user write access. Low | Hardening | All four typographic quotes are now doubled too | Not covered by an automated test (no Python test harness for install.py); regex checked by hand (`'` and U+2019 are doubled) | -| S4 | `src/backend/Install.ps1` | Search for `Invoke-Expression`, `-EncodedCommand`, user-controlled strings | Only fixed paths and `Start-Process` with constant arguments found in lines matched | Not confirmed | none | n/a | -| S5 | `FileSearch.cs:39-58` | Inputs `a' OR 1=1 --`, `"x" OR "y"`, `100%_[a]*`, profile path with `'` | Stay literals inside the CONTAINS string / SCOPE string | False positive | none (behaviour unchanged; helpers already `internal`) | `tests/SecurityHardening` characterisation (8 checks) | -| S6 | `CliServer.cs:23-26`, `CliCommands.cs:44-86` | Other local users or processes driving the CLI pipe | DACL holds one entry (current user SID); bounded line read; command whitelist | Not confirmed | none | existing `tests/CliCommands` | -| S7 | `SingleInstance.cs:27-29,75-100`, `FilesPipe.cs` | Foreign client on the Files pipe | `CurrentUserOnly`, 64 KiB buffer, 2 s limit, 16 handlers, JsonException swallowed; request only opens folders/args via the app's own handler | Not confirmed | none | n/a | -| S8 | `QtShellBridge.cs:124` | Qt bridge pipe `PanneauxCaelestia` | `CurrentUserOnly`; `JsonDocument.Parse` in try/catch; `switch(command)` dispatch. Observation: the 131072-char limit is applied after `ReadLineAsync` returns, so a same-user peer could send one huge line and consume memory. Same-user only, so no privilege boundary crossed | Hardening | none made | n/a | -| S9 | `src/frontend/frontend.py:78-90` | Python client of the bridge | Client reads with `readline(8 MiB)` and `json.loads` inside `except (OSError, ValueError)`. The client does not verify the server's identity (pipe name squatting by a same-user process) | Not confirmed | none | n/a | -| S10 | repo-wide | `BinaryFormatter`, `shell=True` | none found by search | Not confirmed | none | n/a | - -## Not reviewed -- `Install.ps1` was only searched for dangerous constructs (`Invoke-Expression`, `-EncodedCommand`, `$env:`, `Start-Process`), not read in full; `installer/*.ps1`, `Winlestia.iss` likewise not audited. -- The body of `QtShellBridge.Handle` (each command's argument handling), `Social*`, `WebIcons`, WebView2 pages (`assets/web`), the Whisper/voice code, the native DLLs, `src/files` beyond the pipe, `src/cli`. -- Python frontend beyond the IPC client; QML. -- Third-party dependencies and the Clink download path (hash pinned in `install.py`; not re-verified). -- Browser profiles and cookies were deliberately not read; no secrets were opened. -- No dynamic, fuzz or penetration testing. diff --git a/docs/release-notes-0.9.2.md b/docs/release-notes-0.9.2.md new file mode 100644 index 0000000..cd44227 --- /dev/null +++ b/docs/release-notes-0.9.2.md @@ -0,0 +1,35 @@ +# Winlestia 0.9.2 + +Winlestia est un shell de bureau libre pour Windows 11, inspiré de Caelestia. Cette version refond les réglages et le gestionnaire de fichiers, et corrige la dictée vocale. + +## Nouveautés + +- Réglages redessinés en huit pages, avec recherche et navigation latérale ; éditeur de palette ; le terminal suit le mode clair ou sombre du thème. +- Page « Raccourcis clavier » : liste complète, réaffectation des raccourcis configurables, refus expliqué des combinaisons réservées ou en conflit. Win+Alt+S ouvre les Réglages. +- Gestionnaire de fichiers redessiné. +- Icônes dans le dock pour les applications empaquetées ; catalogue d'applications mis à jour en direct. +- Dock, signets et panneau social masquables séparément. +- « Ajouter un site web » est retiré. + +## Corrections + +- Dictée vocale : Whisper.net revient sur .NET 8. +- Flèches affichées comme des cases vides dans la liste des raccourcis de mosaïque. +- Raccourci non enregistré au démarrage signalé à tort « inchangé » ; raccourci Réglages en doublon remplacé par une combinaison libre. +- Dock, signets et panneau social non masqués avant le premier instantané des réglages. + +## Installation + +Télécharger `Winlestia-Setup-0.9.2.exe` ci-dessous, comparer son SHA-256 (`Get-FileHash`) à la valeur indiquée dans ces notes, puis lancer l'installateur. Il n'est pas signé : SmartScreen peut avertir (Informations complémentaires, puis Exécuter quand même). Guide : `docs/INSTALL.md`. + +SHA-256 de `Winlestia-Setup-0.9.2.exe` : `A7E525FB7FF2AB3A918F5185414D7B563EEB19E39454E354D996446A2AD4142B` + +## Restauration + +Si la barre des tâches Windows ne revient pas : Ctrl+Alt+Retour arrière, ou `--restore-taskbar`. + +## Interne + +Version unique dans `Directory.Build.props` ; CI (build, xUnit, pytest) ; tests regroupés ; blocs `catch` vides classés ; auto-tests du gestionnaire de fichiers exclus des builds Release ; code reformaté, backend et `frontend.py` découpés ; dépendances épinglées ; l'installateur vérifie l'empreinte du Python téléchargé. + +Détail : `CHANGELOG.md`. diff --git a/docs/winjets/FORMAT-v1.md b/docs/winjets/FORMAT-v1.md new file mode 100644 index 0000000..9002238 --- /dev/null +++ b/docs/winjets/FORMAT-v1.md @@ -0,0 +1,298 @@ +# Format Winjet v1 (`winjet/1`) + +Spécification publique du format des paquets Winjets de Winlestia. Un Winjet est un widget de bureau décrit par des données JSON : Winlestia l'affiche, le paquet ne contient aucun code. + +- Schémas JSON (draft 2020-12) : [`schema/manifest.schema.json`](schema/manifest.schema.json) et [`schema/widget.schema.json`](schema/widget.schema.json). +- Gabarit à remplir : [`template/`](template/). Exemple complet : [`examples/com.exemple.citation/`](examples/com.exemple.citation/). +- Guide pas à pas : [`MON-PREMIER-WINJET.md`](MON-PREMIER-WINJET.md). + +Les schémas décrivent la forme du JSON ; Winlestia applique en plus des contrôles (références, hôtes, limites) listés plus bas. Un paquet qui passe les schémas peut donc encore être refusé à l'import, avec un message en français qui indique le chemin fautif. + +## 1. Contenu d'un paquet + +Un paquet est un fichier ZIP ou un dossier contenant, **à la racine** : + +``` +manifest.json obligatoire +widget.json obligatoire +preview.png facultatif (aperçu, 1 Mo et 1600 x 1000 pixels au plus) +assets/ facultatif : images et JSON de données locales +``` + +Dans un ZIP, ces fichiers sont à la racine de l'archive, pas dans un dossier intermédiaire. Rien d'autre n'est permis à la racine (pas de `README.md`, pas de `LICENSE`) : tout autre fichier va sous `assets/`. + +### Limites + +| Élément | Limite | +|---|---| +| Taille du ZIP | 5 Mio | +| Taille décompressée | 20 Mio | +| Entrées | 200 au plus | +| Profondeur des dossiers | 4 au plus | +| Chemins | relatifs ; ni chemin absolu, ni `..`, ni lien, ni nom réservé Windows (`CON`, `NUL`, `COM1`...) | +| Extensions | `.json .png .jpg .jpeg .webp .gif .txt .md` | +| Fichier JSON | 256 Kio chacun, profondeur 32 au plus, sans commentaires ni virgule finale | +| Mise en page | 500 noeuds, 12 niveaux d'imbrication, 64 enfants par conteneur | +| Réglages | identifiants uniques | +| État (`state`) | 24 clés au plus ; valeur initiale de 100 caractères au plus | +| Sources (`data`) | 8 au plus | +| Réponse réseau | 512 Kio au plus par appel, délai de 10 s | + +Tout autre contenu (script, exécutable, QML, extension non listée) fait échouer l'import. Les JSON sont lus comme des données : aucun fichier du paquet n'est exécuté ni chargé comme du code. + +## 2. `manifest.json` + +```json +{ + "format": "winjet/1", + "id": "com.exemple.horloge", + "name": "Horloge", + "version": "1.0.0", + "author": "Nom déclaré", + "description": "Une phrase.", + "license": "MIT", + "homepage": "https://exemple.com", + "compatibility": { "winlestia": ">=0.9.2" }, + "permissions": { "network": ["api.coingecko.com"] } +} +``` + +| Champ | Obligatoire | Règle | +|---|---|---| +| `format` | oui | exactement `"winjet/1"` | +| `id` | oui | `^[a-z0-9]+(\.[a-z0-9-]+){1,4}$`, 3 à 64 caractères. Sert d'identité : réimporter le même `id` met le paquet à jour. Convention : nom de domaine inversé (`com.exemple.horloge`). Le préfixe `winlestia.` est celui des paquets inclus : évitez-le. | +| `name` | oui | nom affiché | +| `version` | oui | SemVer `x.y.z` (`1.0.0`) | +| `author` | oui | nom déclaré par le créateur ; affiché tel quel à l'import, Winlestia ne le vérifie pas | +| `description` | non | une phrase | +| `license` | non | identifiant de licence (`MIT`...) | +| `homepage` | non | adresse `https://` ; son hôte est accepté par l'action `openUrl` | +| `compatibility.winlestia` | non | version minimale, éventuellement bornée : `>=0.9.2`, `>=0.9.2 <2.0.0` | +| `permissions.network` | non | liste de noms d'hôte exacts, en minuscules, sans schéma, sans port, sans chemin, sans joker. Vide par défaut. | + +Tout champ inconnu est une erreur. + +## 3. `widget.json` + +```json +{ + "size": { "default": [352, 168], "min": [168, 168], "max": [720, 352] }, + "settings": [ ], + "state": { "mode": "face" }, + "data": { }, + "layouts": [ { "minWidth": 0, "root": { "type": "column", "children": [ ] } } ] +} +``` + +Seuls `size.default` et `layouts` sont obligatoires. + +### 3.1 Taille et grille + +Les tailles sont en pixels logiques (indépendants du DPI). La grille a une cellule de 168 px et une gouttière de 16 px : + +| Cellules | 1 | 2 | 3 | 4 | +|---|---|---|---|---| +| Pixels | 168 | 352 | 536 | 720 | + +La même échelle vaut en hauteur : `[352, 168]` est un format 2 x 1. `size.min` est au moins `[120, 120]` (valeur par défaut), `size.max` au plus `[1600, 1000]` (valeur par défaut). L'utilisateur redimensionne la carte entre ces bornes ; `default` est ramené dans l'intervalle. + +### 3.2 Réglages (`settings`) + +Les réglages sont modifiables par l'utilisateur, par instance. Champs communs : `id` (une lettre puis lettres, chiffres ou `_`, 32 caractères au plus, unique), `type`, `label` (texte affiché), `default`. + +| `type` | Champs en plus | `default` | +|---|---|---| +| `toggle` | | vrai ou faux | +| `text` | `maxLength` (facultatif) | texte | +| `choice` | `options` : `[{ "value": "7d", "label": "7 jours" }]`, au moins une | l'une des `value` | +| `number` | `min`, `max` (facultatifs) | nombre compris entre `min` et `max` | + +Lecture dans les expressions : `settings.`. + +### 3.3 État d'instance (`state`) + +`state` déclare des clés avec leur valeur initiale (texte, nombre ou vrai/faux). Seules les actions `setState` et le bloc `buttons` peuvent les modifier, et seulement pour une clé déclarée. L'état est propre à chaque instance posée sur le bureau. Lecture : `state.`. Le bloc `note` écrit lui aussi dans une clé déclarée (texte de 4 000 caractères au plus à l'exécution, retours à la ligne compris ; la valeur initiale reste limitée à 100 caractères). + +### 3.4 Sources de données (`data`) + +Le nom de la source (une lettre puis lettres, chiffres ou `_`) devient `data.` dans les expressions. + +```json +"data": { + "demo": { "type": "file", "path": "assets/donnees.json" }, + "live": { "type": "http", "url": "https://api.exemple.com/v1/prix", "refresh": 300, + "enabledWhen": "settings.source == 'live'" } +} +``` + +- `file` : un JSON du paquet sous `assets/` (obligatoire : `path`). Lu localement, hors ligne. +- `http` : un JSON distant. `url` en `https://` seulement, dont l'hôte figure dans `permissions.network` ; sans cela l'import échoue. `refresh` : intervalle en secondes, 300 par défaut, **minimum 60** (une valeur plus petite est relevée à 60), 86 400 au plus. `enabledWhen` : condition ; tant qu'elle est fausse, la source n'est jamais appelée. + +- `market` : cours en direct de cryptomonnaies via Binance. Obligatoire : `symbols` (1 à 4 symboles en majuscules, ex. `["BTC", "ETH", "SOL"]`) ; facultatif : `enabledWhen`. Le manifeste doit déclarer `api.binance.com` et `stream.binance.com` dans `permissions.network`. Valeur : `{ "live", "updated", "symbols": { "BTC": { "price", "change24h", "candles": { "1h": [...], "1j": [...], "1s": [...], "1m": [...] } } } }`. `change24h` est en pourcents (2.41 pour +2,41 %). Chaque bougie est `[t, o, h, l, c]`. Les mises à jour arrivent en direct, au plus une fois par seconde ; `live` vaut `false` quand le flux est coupé. + + `provider` (facultatif) : `"binance"` (défaut) ou `"yahoo"` (actions, indices, devises). Avec `"yahoo"`, le manifeste doit déclarer `query1.finance.yahoo.com` dans `permissions.network` (et non les hôtes Binance) ; chaque symbole respecte `^[A-Z0-9^.=-]{1,15}$` (`AAPL`, `^GSPC`, `EURUSD=X`). Valeur : `{ "live": false, "symbols": { "AAPL": { "status", "name", "price", "change24h", "history", "candles" } } }` : `status` vaut `ok` ou `error` (un titre en échec n'empêche pas les autres), `history` est la liste des dernières clôtures (60 valeurs au plus), `candles` les bougies `[t, o, h, l, c]`. `live` vaut toujours `false` : les cours sont relus à l'intervalle `refresh`, sans flux. +- `calendar` : agenda ICS en lecture seule. Obligatoire : `url`, soit une expression seule `"{{settings.agenda}}"` (adresse saisie par l'utilisateur dans un réglage `text`), soit une adresse `https://` littérale dont l'hôte figure dans `permissions.network` ; facultatifs : `refresh` (secondes, de 300 à 86 400, 900 par défaut) et `enabledWhen`. Seuls `https://` et `webcal://` (lu comme `https://`) sont acceptés, port 443 uniquement, sans identifiants dans l'adresse, réponse de 2 Mio au plus ; une adresse non publique est refusée à la connexion. Valeur : `{ "status", "count", "events": [{ "title", "location", "start", "end", "allDay", "timeLabel", "dayLabel" }] }`. `status` vaut `ok`, `unconfigured` (réglage vide) ou `error`. La fenêtre couvre aujourd'hui et les 6 jours suivants, 12 événements au plus, triés par début. Les règles de récurrence `RRULE` prises en charge sont `DAILY`, `WEEKLY` et `MONTHLY` avec `INTERVAL`, `COUNT`, `UNTIL`, `BYDAY` (hebdomadaire seulement) et `EXDATE` ; toute autre règle (`YEARLY`, `BYMONTHDAY`, `BYSETPOS`...) n'est pas développée. + +```json +"data": { "market": { "type": "market", "symbols": ["BTC", "ETH", "SOL"] } } +``` + +Une source indisponible ne bloque pas la carte : les chemins `data.*` sans valeur sont simplement vides, et le dernier résultat en cache est réutilisé en cas d'échec. + +### 3.5 Mises en page (`layouts`) + +`layouts` est une liste ordonnée. Chaque entrée : + +```json +{ "minWidth": 340, "minHeight": 300, "root": { "type": "row", "children": [ ] } } +``` + +`minWidth` est obligatoire, `minHeight` facultatif. Winlestia retient **la dernière entrée** dont `minWidth` et `minHeight` sont satisfaits par la taille réelle de la carte. Ordonnez-les donc de la plus petite à la plus grande et faites commencer la liste par `"minWidth": 0`, qui couvre tous les cas. Comme la cellule 2 x 1 mesure 352 px, un seuil de 340 repère « au moins 2 colonnes » et 520 « au moins 3 ». + +Chaque mise en page est un arbre complet : elle ne dépend pas des précédentes. + +## 4. Conteneurs + +Quatre conteneurs, tous avec `children` (liste de conteneurs et de blocs) : + +| `type` | Rôle | +|---|---| +| `column` | enfants empilés verticalement | +| `row` | enfants alignés horizontalement | +| `stack` | enfants superposés | +| `grid` | grille ; `columns` (1 à 12) obligatoire | + +Propriétés communes : `gap` (espace entre enfants, entier de 0 à 1000), `padding` (marge intérieure), `align` (`start`, `center`, `end`, `stretch`), `grow` (poids de répartition de l'espace restant), `visibleWhen` (condition ; faux = non affiché), `action` (rend le conteneur cliquable). + +## 5. Blocs + +Les blocs n'ont pas d'enfants. Une valeur de type texte accepte des expressions `{{ ... }}` (section 6) sauf mention contraire ; les valeurs d'énumération sont littérales. Les propriétés `visibleWhen`, `grow`, `gap`, `padding` sont acceptées par l'import sur tout noeud ; ce document et les schémas les déclarent sur les conteneurs, et les paquets fournis enveloppent un bloc dans une `column` quand ils en ont besoin. + +| Bloc | Propriétés (obligatoires en gras) | +|---|---| +| `text` | **`text`**, `style` (`title`, `label`, `body`, `caption`, `display`, `mono`, `icon`, `eyebrow`, `glyph`), `align` (`start`, `center`, `end`), `maxLines`, `tone` (`primary`, `secondary`, `accent`, `signed`, `faint`), `action`. `glyph` : nom de Material Symbols en petite taille (20 px), pour les lignes denses ; `eyebrow` : majuscules, petite taille, graisse 600, interlettrage large, couleur d'accent par défaut ; `display` : chiffres légers (300) à interlettrage serré ; `title` : gras. `faint` : texte principal à 0,45 d'opacité. Un texte qui change se fond en 220 ms avec un glissement de 4 px | +| `image` | **`src`** (chemin sous `assets/`, image `.png .jpg .jpeg .webp .gif`), `fit` (`contain`, `cover`), `radius`, `action` | +| `clock` | **`variant`** (`analog`, `digital`), `showSeconds` ou `seconds` (vrai/faux ou expression), `format` (`HH:mm`, `HH:mm:ss`...), `timezone` (nom IANA, ex. `Europe/Paris` ; vide = fuseau local) | +| `calendar` | **`variant`** (`month`, `day`), `firstDay` (`monday`, `sunday`, valeur littérale), `nav` (vrai/faux ou expression, mois : chevrons précédent/suivant visibles au survol, glissement de 24 px au changement de mois ; le mois courant revient quand la carte est réaffichée) | +| `list` | **`items`** (expression vers un tableau), **`title`**, `subtitle`, `trailing` (**noms de champs** de chaque élément, sans accolades), `max`, `bar`, `group` (champ dont la valeur donne un en-tête de groupe, affiché à chaque changement de valeur), `icon` (champ contenant un nom de Material Symbols : pastille d'icône), `relative` (champ contenant une date ISO ou des secondes epoch : affiche « dans 1 h » pour un événement à venir le jour même ; avec `past` vrai, « il y a 2 j » pour une date passée), `accent` (vrai/faux : barre d'accent de 3 px à gauche de chaque ligne, d'opacité variable selon la ligne), `tiles` (1 à 6 : disposition en tuiles d'icône sur ce nombre de colonnes). Les lignes apparaissent en fondu, décalées de 30 ms, uniquement quand le contenu change réellement | +| `chart` | **`series`** (expression vers un tableau de nombres ou de paires `[t, v]`), `variant` (`line`, `area`, `bars`, `candles`, `spark` : courbe fine, aire en dégradé d'accent et point final, sans axes), `axes` (vrai/faux), `period` (texte), `color` (rôle de palette), `hover` (vrai/faux : réticule au survol ; la valeur survolée est écrite dans `state.hover`, à déclarer dans `state`), `valueFormat` (`currency`, `percent`, `number`). Avec `candles`, la série est un tableau de `[t, o, h, l, c]` | +| `stat` | **`value`**, `label`, `delta` (nombre signé, coloré selon le signe), `action` | +| `progress` | **`value`** (0 à 1), `variant` (`ring`, `bar`), `label`, `from` (0 à 1 : avec `bar`, la barre couvre l'intervalle de `from` à `value`, pour une plage de températures), `thickness` (épaisseur de l'anneau, 1 à 16 px), `big` (vrai/faux : grand nombre centré dans l'anneau). Les valeurs s'animent en 450 ms | +| `dots` | **`matrix`** (expression vers un tableau 2D de nombres de 0 à 1) ou **`pattern`** (`pulse`, `ripple`, `torus`, animé seulement quand la carte est visible), `shape` (`circle`, `square`) | +| `buttons` | **`options`** (`[{ "value": "a", "label": "A" }]`, 16 au plus), **`bind`** (`state.`, clé déclarée dans `state`) | +| `media` | `showArt`, `showProgress`, `showControls`, `backdrop` (pochette floutée et assombrie en fond de carte), `pill` (commandes précédent/lecture/suivant dans une pastille flottante) (vrai/faux ou expression) : carte de lecture en cours avec pochette, titre, artiste, progression et commandes ; un clic sur la barre de progression déplace la lecture si le lecteur le permet | +| `visualizer` | `bars` (8 à 64) : barres animées pendant la lecture | +| `note` | **`key`** (clé déclarée dans `state`, valeur texte de 4 000 caractères au plus, retours à la ligne compris), `placeholder` (100 caractères au plus), `grow`, `visibleWhen` : zone de texte multiligne modifiable, enregistrée dans l'état de l'instance. Un clic dans la zone donne le clavier à la carte le temps de la saisie ; la carte reste au fond du bureau. | +| `spacer` | aucune : espace flexible | +| `divider` | aucune : filet de séparation | + +Le contenu s'adapte automatiquement à la taille de la carte : inutile de multiplier les mises en page pour agrandir ou réduire les textes. Une mise en page de plus ne sert qu'à changer la disposition. + +Exemple de `list` : avec `"items": "{{ data.demo.jours }}"` et `"title": "jour"`, chaque ligne affiche le champ `jour` de l'élément. Les valeurs sont affichées telles qu'elles sont dans le JSON : préparez-les déjà mises en forme. + +## 6. Expressions et conditions + +### Expressions + +Dans une chaîne : `{{ chemin | filtre:arg | filtre }}`. Le texte autour des accolades est conservé : `"Total : {{ data.x.total | number:2 }} €"`. + +Chemins permis : + +| Chemin | Valeur | +|---|---| +| `settings.` | réglage | +| `state.` | état d'instance | +| `data..` | contenu de la source, champs séparés par des points | +| `a.b[state.x].c[state.y]` | indexation : l'indice est un chemin, un nombre ou un texte entre apostrophes | +| `media.title`, `media.artist`, `media.album`, `media.art`, `media.app` | lecture en cours (texte) | +| `media.playing`, `media.canNext`, `media.canPrev` | lecture en cours (vrai/faux) | +| `media.position`, `media.length` | position et durée de la piste | +| `system.cpu`, `system.ram` | usage en pourcents, entier de 0 à 100 | +| `system.disk[]` | disques fixes : `{ drive, label, usedGb, totalGb, freeGb, percent, ratio }` (`drive` vaut `C:`, `percent` est un entier, `ratio` la proportion 0 à 1 pour `progress`) | +| `system.diskMain` | le disque système (sinon le premier) : mêmes champs ; vide sans disque | +| `system.cpuHistory` | 40 entiers au plus (usage CPU en pourcents), échantillonnés seulement tant qu'une carte visible lit ce chemin | +| `weather.status` | `ok`, `locating`, `error` ou `unconfigured` | +| `weather.source`, `weather.city` | origine (`city` ou `location`) et ville affichée | +| `weather.temp`, `weather.feelsLike`, `weather.high`, `weather.low` | températures arrondies (`high` et `low` : aujourd'hui) | +| `weather.weekLow`, `weather.weekHigh` | minimum et maximum de la semaine (échelle des barres de plage) | +| `weather.condition`, `weather.icon` | libellé et pictogramme | +| `weather.daily[]` | 7 jours au plus : `{ day, icon, max, min, rangeFrom, rangeTo }` ; `rangeFrom` et `rangeTo` (0 à 1) placent min et max sur l'échelle de la semaine | +| `files.recent[]` | 8 fichiers récents au plus : `{ name, path, kind, icon, modified }`, `kind` valant `folder`, `app` ou `file`, `icon` un glyphe de type de fichier, `modified` la date de modification en secondes epoch | +| `files.folders[]` | `{ name, path, icon }` pour Desktop, Downloads, Documents et Pictures | +| `system.uptime` | durée depuis le démarrage, déjà mise en forme | +| `system.battery`, `system.charging` | niveau en pourcents (vide sans batterie) ; en charge ou non | +| `time.hours`, `time.minutes`, `time.seconds` | heure locale | +| `now` | date et heure actuelles | +| `instance.width`, `instance.height` | taille réelle de la carte | + +La météo suit le réglage `city` de l'instance (déclarez un réglage `text` d'identifiant `city`) : vide, la carte utilise la position de Windows (demande `locate` au backend), puis à défaut la ville globale de Winlestia ; sans ville, `weather.status` vaut `unconfigured`. + +Filtres (liste fermée) : + +| Filtre | Effet | +|---|---| +| `number:n` | nombre avec `n` décimales | +| `currency:EUR` | montant dans la devise (code ISO 4217) | +| `percent:n` | pourcentage avec `n` décimales | +| `date:motif` | date avec un motif (`dddd d MMMM yyyy`, `HH:mm`) ; tout ce qui suit le premier `:` est le motif | +| `upper`, `lower` | majuscules, minuscules | +| `default:valeur` | valeur de repli si le chemin est vide | +| `first`, `last` | premier ou dernier élément d'un tableau | +| `delta` | variation relative entre le premier et le dernier élément d'une série | + +Autres écritures de tête d'expression : + +- `a ?? b ?? 0` : première valeur non vide (absente ou chaîne vide comptent comme vides) ; +- `fmt(valeur, 'currency')`, `fmt(valeur, 'percent')`, `fmt(valeur, 'number')` : `currency` donne un montant en `$` (0 décimale au-dessus de 1 000, 2 en dessous), `percent` attend une **proportion** (0.0241 donne « +2,4 % »), `number` un nombre groupé. Valeur illisible : texte vide. Exemple : `{{ fmt(state.hover ?? data.market.symbols[state.pair].price, 'currency') }}`. + +Aucun autre filtre ni fonction n'existe, et il n'y a **pas de calcul** (ni division, ni addition) : préparez les valeurs dans les données. `system.cpu`, `system.ram` et `system.battery` vont de 0 à 100 alors que `progress` attend 0 à 1 : ne les passez pas tels quels à `progress`. Pour convertir un pourcentage entier en proportion sans calcul, indexez un tableau de données local de 101 valeurs (0, 0.01 ... 1) : `{{ data.niveaux.ratio[system.battery] }}`. Le paquet inclus `winlestia.batterie` fait ainsi. Sans batterie, `system.battery` est vide : testez `system.battery == null` (ou `system.battery >= 0`) dans `visibleWhen`. + +### Conditions + +`visibleWhen` et `enabledWhen` s'écrivent **sans accolades** : `"settings.source == 'live' && state.mode != 'auteur'"`. + +- comparaisons : `== != < <= > >=` ; +- logique : `&&`, `||`, `!`, parenthèses ; +- littéraux : `'texte'`, `"texte"`, `1.5`, `true`, `false`, `null` ; +- valeurs : les chemins de la section 6 (un chemin inconnu vaut `null`, donc faux) ; +- `??` pour une valeur de repli. L'import refuse l'indexation `[...]` dans `visibleWhen` : réservez-la aux gabarits `{{ ... }}` et à `series`. + +Une condition invalide est refusée à l'import (`visibleWhen`) ou laisse la source désactivée (`enabledWhen`). + +## 7. Actions + +Le champ `action` d'un `text`, `image`, `stat` ou d'un conteneur le rend cliquable : + +| Action | Effet | +|---|---| +| `{ "type": "setState", "key": "mode", "value": "auteur" }` | modifie une clé d'état déclarée | +| `{ "type": "refresh" }` | rafraîchit les sources réseau, en respectant l'intervalle minimal | +| `{ "type": "openUrl", "url": "https://exemple.com/page" }` | ouvre l'adresse dans le navigateur ; l'hôte doit être dans `permissions.network` ou être celui de `homepage` | +| `{ "type": "open", "path": "{{ ... }}" }` | ouvre un fichier, un dossier ou une application avec le programme associé. L'hôte n'ouvre que les chemins publiés par `files.recent` et `files.folders` ; toute adresse (`https://`, `file:`...) et tout chemin réseau UNC (`\\serveur\partage`) est refusé. `open` et les références `files.*` sont réservées aux paquets intégrés (id commençant par `winlestia.`) : le validateur les refuse dans les autres paquets | +| `{ "type": "openDrive", "drive": "C:" }` | ouvre un disque dans l'Explorateur ; seuls les disques fixes présents dans `system.disk` sont acceptés (lettre suivie de `:`) | +| `{ "type": "openSettings" }` | ouvre les réglages du Winjet | +| `{ "type": "media.playPause" }`, `media.next`, `media.prev` | commande le lecteur multimédia en cours | + +## 8. Couleurs + +Aucune couleur littérale (`#ff0000`, `rgb(...)`, `hsl(...)`). Une couleur est un **rôle de palette**, qui suit le thème de l'utilisateur : + +`accent`, `primary`, `secondary`, `tertiary`, `onSurface`, `onSurfaceVariant`, `positive`, `negative`. + +Les propriétés de couleur (`color` sur `chart`) n'acceptent que ces valeurs ; `tone` sur `text` choisit entre `primary`, `secondary` et `accent`. + +## 9. Sécurité + +- **Contenu = données.** Winlestia n'exécute et ne charge aucun QML, JavaScript, script ni exécutable depuis un paquet. Il n'interprète qu'une liste fermée de conteneurs, de blocs, de filtres et d'actions. +- **Réseau.** Un paquet n'ouvre jamais de connexion lui-même. Seul le service de données de Winlestia appelle les sources `http`, uniquement vers les hôtes déclarés dans `permissions.network`, en HTTPS, au plus un appel en vol par source, avec un intervalle minimal de 60 s, un délai de 10 s et une réponse de 512 Kio au plus. Le dernier résultat est gardé en cache sur disque et resservi si l'appel échoue. +- **Transparence.** L'import affiche le nom, l'auteur déclaré et les hôtes réseau demandés avant l'ajout au bureau. +- **Fichiers.** Aucun chemin absolu, `..`, lien ou nom réservé ; extensions en liste fermée ; limites de taille et de profondeur de la section 1. +- **Pas de secrets.** Le format n'a pas de champ pour une clé d'API ; n'en mettez jamais dans un paquet partagé. + +## 10. Versions du format + +- Le champ `format` vaut `winjet/1` pour toute la série 1.x du format. Winlestia refuse un paquet dont `format` est inconnu, avec un message qui cite la valeur lue. +- **En v1, un champ inconnu est une erreur** : cela permet d'ajouter des champs plus tard sans que d'anciens paquets changent de sens. +- Les évolutions compatibles (nouvelle valeur d'énumération, nouveau bloc, nouveau filtre) ne sont pas annoncées par un nouveau numéro de format tant qu'elles ne changent pas le sens d'un paquet existant ; elles sont documentées ici avec la version de Winlestia qui les apporte. Un paquet qui les utilise déclare `compatibility.winlestia`. +- Une rupture (changement de sens d'un champ, suppression) introduit **`winjet/2`**, avec sa propre spécification (`FORMAT-v2.md`) et ses propres schémas. Winlestia continuera de lire les paquets `winjet/1` tant que `winjet/2` existe ; les deux formats ne se mélangent pas dans un même paquet. +- La version du paquet (`version`) est indépendante de celle du format : incrémentez-la à chaque publication ; un import d'une version plus récente du même `id` met le paquet à jour. diff --git a/docs/winjets/MON-PREMIER-WINJET.md b/docs/winjets/MON-PREMIER-WINJET.md new file mode 100644 index 0000000..334179b --- /dev/null +++ b/docs/winjets/MON-PREMIER-WINJET.md @@ -0,0 +1,185 @@ +# Mon premier Winjet + +Ce guide vous mène d'un dossier vide à un Winjet posé sur votre bureau. Aucune programmation : vous écrivez des fichiers JSON (du texte) avec le Bloc-notes ou VS Code. La référence complète est dans [FORMAT-v1.md](FORMAT-v1.md). + +À la fin, vous aurez un Winjet qui affiche un message et l'heure, avec deux mises en page (compacte et grande), un réglage, une donnée locale et un aperçu. + +## 1. Copier le gabarit + +Copiez le dossier `docs/winjets/template/` quelque part (par exemple `Documents\Winjets\`) et renommez la copie `mon-winjet`. Dedans : + +``` +mon-winjet\ + manifest.json + widget.json + README.md (à supprimer avant de zipper) + assets\ + .gitkeep (à supprimer avant de zipper) +``` + +## 2. Remplir le manifeste + +Ouvrez `manifest.json` et changez ces champs : + +```json +{ + "format": "winjet/1", + "id": "com.votrenom.mon-winjet", + "name": "Mon Winjet", + "version": "1.0.0", + "author": "Votre nom", + "description": "Un message et l'heure.", + "license": "MIT", + "compatibility": { "winlestia": ">=0.9.2" }, + "permissions": { "network": [] } +} +``` + +- `id` : unique, en minuscules, avec des points (`com.votrenom.mon-winjet`). Pas de majuscules, pas d'espaces. +- `version` : trois nombres (`1.0.0`). +- `permissions.network` : `[]` signifie « pas d'Internet ». Laissez-le ainsi ici. + +## 3. Construire deux mises en page + +Ouvrez `widget.json`. Une carte Winjet a une taille choisie par l'utilisateur ; vous décrivez ce qu'elle affiche **selon sa largeur** avec `layouts`. Les tailles de la grille sont 168, 352, 536 et 720 pixels (1, 2, 3 ou 4 cellules). + +Winlestia retient la **dernière** mise en page dont les seuils sont atteints : + +```json +"layouts": [ + { + "minWidth": 0, + "root": { + "type": "column", "padding": 16, "gap": 8, + "children": [ + { "type": "text", "text": "{{ settings.message }}", "style": "title", "maxLines": 2 }, + { "type": "clock", "variant": "digital", "format": "HH:mm" } + ] + } + }, + { + "minWidth": 340, "minHeight": 340, + "root": { + "type": "column", "padding": 24, "gap": 8, + "children": [ + { "type": "text", "text": "{{ settings.message }}", "style": "display", "maxLines": 2 }, + { "type": "clock", "variant": "digital", "format": "HH:mm" }, + { "type": "text", "text": "{{ now | date:dddd d MMMM }}", "style": "caption", "tone": "secondary" } + ] + } + } +] +``` + +- La première mise en page (compacte) commence à `"minWidth": 0` : elle sert tant que la carte est petite. +- La seconde (grande) n'est utilisée que si la carte fait au moins 340 px de large et 340 px de haut, soit 2 x 2 cellules (352 x 352). +- `{{ settings.message }}` insère la valeur du réglage `message` ; `{{ now | date:dddd d MMMM }}` insère la date du jour. +- Blocs possibles : `text`, `image`, `clock`, `calendar`, `list`, `chart`, `stat`, `progress`, `dots`, `buttons`, `spacer`, `divider`. Conteneurs : `column`, `row`, `stack`, `grid`. Il n'y en a pas d'autres. +- Pas de couleur écrite en dur. Pour colorer, utilisez `tone` (`primary`, `secondary`, `accent`) ou, sur un graphique, `color` avec un rôle de palette (`accent`, `positive`...). + +## 4. Ajouter un réglage + +Un réglage est une option que l'utilisateur change depuis les Réglages de Winlestia. Dans `widget.json`, la liste `settings` en contient déjà un (`message`). Ajoutez un interrupteur pour la date : + +```json +"settings": [ + { "id": "message", "type": "text", "label": "Message affiché", "default": "Bonjour", "maxLength": 40 }, + { "id": "showDate", "type": "toggle", "label": "Afficher la date", "default": true } +] +``` + +Puis utilisez-le : enveloppez le bloc de date de la grande mise en page dans une colonne qui ne s'affiche que si le réglage est actif. + +```json +{ "type": "column", "visibleWhen": "settings.showDate", "children": [ + { "type": "text", "text": "{{ now | date:dddd d MMMM }}", "style": "caption", "tone": "secondary" } +] } +``` + +`visibleWhen` s'écrit **sans accolades**. Autres types de réglages : `text`, `choice` (liste d'options), `number`. + +## 5. Ajouter des données locales + +Créez le fichier `assets/conseils.json` : + +```json +{ "texte": "Pensez à boire un verre d'eau." } +``` + +Déclarez-le dans `widget.json`, au même niveau que `settings` : + +```json +"data": { + "conseils": { "type": "file", "path": "assets/conseils.json" } +} +``` + +Et affichez-le, à la fin de la grande mise en page : + +```json +{ "type": "divider" }, +{ "type": "text", "text": "{{ data.conseils.texte }}", "style": "body", "tone": "secondary", "maxLines": 3 } +``` + +Le nom `conseils` devient `data.conseils` dans les expressions, et `texte` est le champ du fichier. Le fichier doit rester sous `assets/` et faire moins de 256 Kio. + +Le `widget.json` complet de ce guide tient en une quarantaine de lignes : les morceaux ci-dessus, dans `layouts`, `settings` et `data`, avec `"size": { "default": [352, 168], "min": [168, 168], "max": [536, 352] }`. + +## 6. Image d'aperçu (facultatif) + +Ajoutez à la racine un fichier `preview.png` (1 Mo et 1600 x 1000 pixels au plus), par exemple une capture de votre Winjet. Il est affiché dans les Réglages. + +## 7. Créer le ZIP + +Les fichiers doivent être **à la racine** du ZIP : on doit voir `manifest.json` en ouvrant l'archive, pas un dossier `mon-winjet`. + +1. Supprimez `README.md` et `assets\.gitkeep` du dossier (ils ne sont pas autorisés). +2. Ouvrez PowerShell dans le dossier **parent** de `mon-winjet` et lancez : + +```powershell +Compress-Archive -Path .\mon-winjet\* -DestinationPath .\com.votrenom.mon-winjet-1.0.0.zip -Force +``` + +Le `\*` est important : il zippe le contenu du dossier et non le dossier lui-même. Vérifiez : ouvrez le ZIP dans l'Explorateur, `manifest.json` et `widget.json` doivent être visibles tout de suite. Le ZIP doit faire moins de 5 Mio. + +## 8. Importer dans Winlestia + +1. Ouvrez les Réglages de Winlestia (Win+Alt+S), page **Winjets**. +2. Glissez le ZIP dans la zone d'import. +3. Winlestia valide le paquet et affiche une fiche. Vérifiez le **nom**, l'**auteur** (c'est le nom déclaré dans le manifeste) et le **réseau** : « aucun accès réseau » pour votre premier Winjet. Pour un paquet téléchargé, n'ajoutez que ce qui vous convient. +4. Cliquez sur **Ajouter au bureau**. La carte apparaît derrière vos fenêtres ; utilisez « Modifier les Winjets » pour la déplacer ou la redimensionner et voir la mise en page changer. + +Pour mettre à jour : augmentez `version`, rezippez, réimportez le même `id`. + +## 9. Corriger les erreurs + +L'import affiche des messages en français qui commencent par le fichier et le chemin fautif (`$.layouts[1].root.children[0]`). Corrigez, rezippez, réimportez. + +| Message | Cause et remède | +|---|---| +| `manifest.json est obligatoire.` | Le ZIP contient un dossier au lieu des fichiers. Rezippez avec `Compress-Archive -Path .\dossier\*`. | +| `entrée « x » : fichier non prévu à la racine` | Un fichier autre que `manifest.json`, `widget.json`, `preview.png` est à la racine (souvent `README.md`). Déplacez-le sous `assets/` ou supprimez-le. | +| `tout contenu doit se trouver sous assets/` | Un dossier à la racine n'est pas `assets`. | +| `extension « .svg » non autorisée` | Seuls `.json .png .jpg .jpeg .webp .gif .txt .md` sont permis. Convertissez l'image en PNG. | +| `JSON invalide ou trop profond` | Virgule oubliée ou en trop, guillemet manquant, commentaire. Collez le fichier dans un validateur JSON. | +| `$.id : identifiant invalide` | Minuscules, chiffres, points et tirets seulement, au moins deux segments (`com.nom.widget`). | +| `$.version : version invalide` | Trois nombres : `1.0.0`, pas `1.0`. | +| `$.format : valeur « … » non prise en charge` | Mettez exactement `"winjet/1"`. | +| `type « carte » inconnu` | Le bloc ou conteneur n'existe pas. Liste fermée : voir l'étape 3. | +| `valeur permise : …` | Une valeur d'énumération (`style`, `variant`, `align`...) n'est pas dans la liste affichée. | +| `couleur littérale interdite` / `couleur non permise` | Remplacez `#ff0000` par un rôle de palette : `accent`, `primary`, `secondary`, `tertiary`, `onSurface`, `onSurfaceVariant`, `positive`, `negative`. | +| `fichier introuvable dans le paquet : assets/x.json` | Le chemin ne correspond à aucun fichier : vérifiez le nom, les majuscules et le dossier `assets/`. | +| `expression invalide` | Une condition (`visibleWhen`, `enabledWhen`) est mal écrite : comparaisons `== != < <= > >=`, `&&`, `\|\|`, `!`, et rien d'autre. Pas d'accolades. | +| `clé d'état « x » non déclarée dans « state »` | Ajoutez la clé dans `"state": { "x": "valeur" }`. | +| `l'hôte « … » n'est pas déclaré dans permissions.network` | Ajoutez l'hôte exact (sans `https://`) dans `manifest.json`. | +| `seul https:// est autorisé.` | Une source `http` doit utiliser une adresse `https://`. | +| `« min » dépasse « max »` | Corrigez `size.min` et `size.max`. | +| `Trop d'erreurs : la liste est tronquée.` | Corrigez les premières erreurs, puis réimportez. | + +Un Winjet qui s'importe mais n'affiche rien : vérifiez que la première mise en page a `"minWidth": 0`, que les chemins `{{ data.source.champ }}` correspondent au JSON, et que `visibleWhen` n'est pas toujours faux. + +## Aller plus loin + +- Un exemple complet avec boutons et données locales : [`examples/com.exemple.citation/`](examples/com.exemple.citation/). +- Générer un paquet avec une IA : [PROMPT-IA.md](PROMPT-IA.md). +- Valider vos fichiers avec les schémas : [`schema/`](schema/) (utilisables dans VS Code via `"$schema"` ou avec un validateur JSON Schema). diff --git a/docs/winjets/PROMPT-IA.md b/docs/winjets/PROMPT-IA.md new file mode 100644 index 0000000..f5176b5 --- /dev/null +++ b/docs/winjets/PROMPT-IA.md @@ -0,0 +1,32 @@ +# Prompt pour générer un Winjet avec une IA +Collez le texte ci-dessous dans votre assistant, puis décrivez votre idée à la fin. +```text +Tu génères un paquet "Winjet" (widget de bureau Winlestia, format winjet/1) : uniquement des fichiers JSON, aucun code. +Réponds par un bloc de code par fichier : manifest.json, widget.json, puis chaque JSON de assets/. +Règles obligatoires : +- Les fichiers seront à la RACINE du ZIP : manifest.json, widget.json, preview.png (facultatif), assets/. +- manifest.json : format "winjet/1", id minuscules du type com.nom.monwinjet, name, version x.y.z, author, + description, permissions.network = [] sauf si des hôtes web sont nécessaires (noms d'hôte exacts, HTTPS). +- widget.json : size {default, min, max} en pixels (grille : 168, 352, 536, 720), settings (toggle, text, choice, number), + state, data (file sous assets/ ou http avec refresh >= 60), layouts du plus petit au plus grand + (le premier a minWidth 0, le dernier dont les seuils sont atteints est utilisé). +- Conteneurs autorisés : column, row, stack, grid. Blocs autorisés, et aucun autre : text, image, clock, calendar, + list, chart (variant line, area, bars, candles ; hover, valueFormat), stat, progress, dots, buttons, media, visualizer, + spacer, divider. Le contenu se met à l'échelle tout seul avec la taille de la carte. +- Expressions : {{ settings.x }}, {{ state.x }}, {{ data.source.champ }}, {{ now }}, {{ media.title }} (title, artist, album, + art, playing, position, length, canNext, canPrev, app), {{ system.cpu }} (cpu, ram en % de 0 à 100, uptime, battery, charging), + {{ time.hours }} (hours, minutes, seconds). Indexation : data.m.symbols[state.pair].candles[state.tf]. Repli : a ?? b. + Mise en forme : fmt(x, 'currency'|'percent'|'number') (percent attend une proportion). Aucun calcul (pas de division). Filtres : + number:n, currency:EUR, percent:n, date:motif, upper, lower, default:valeur, first, last, delta. +- Conditions (visibleWhen, enabledWhen) sans accolades : == != < <= > >= && || ! et littéraux. +- Actions : setState (clé déclarée dans state), refresh, openUrl (hôte déclaré), openSettings, media.playPause, media.next, media.prev. +- Source data "market" : { "type": "market", "symbols": ["BTC","ETH"] } (4 au plus) ; permissions.network doit contenir api.binance.com et + stream.binance.com. Valeur : data.market = {live, updated, symbols:{BTC:{price, change24h en %, candles:{"1h","1j","1s","1m"}}}}. +- chart candles : series = tableau de [t,o,h,l,c] ; hover:true écrit la valeur survolée dans state.hover (à déclarer dans state). +- Couleurs : seulement les rôles accent, primary, secondary, tertiary, onSurface, onSurfaceVariant, positive, negative. + Jamais de #rrggbb ni rgb(). +- Interdits : code, script, HTML, QML, CSS, SVG, exécutable, champ inconnu. Extensions : json png jpg jpeg webp gif txt md. +- Limites : ZIP 5 Mio, JSON 256 Kio chacun, 200 fichiers, 4 niveaux de dossiers. +À la fin, donne la commande PowerShell Compress-Archive qui crée le ZIP avec les fichiers à la racine. +Mon idée de Winjet : +``` diff --git a/docs/winjets/examples/com.exemple.citation-1.0.0.zip b/docs/winjets/examples/com.exemple.citation-1.0.0.zip new file mode 100644 index 0000000..9911b93 Binary files /dev/null and b/docs/winjets/examples/com.exemple.citation-1.0.0.zip differ diff --git a/docs/winjets/examples/com.exemple.citation/assets/quotes.json b/docs/winjets/examples/com.exemple.citation/assets/quotes.json new file mode 100644 index 0000000..01cc8c2 --- /dev/null +++ b/docs/winjets/examples/com.exemple.citation/assets/quotes.json @@ -0,0 +1,24 @@ +{ + "citation": { + "text": "Je pense, donc je suis.", + "author": "René Descartes" + }, + "auteur": { + "name": "René Descartes", + "bio": "Philosophe, mathématicien et physicien français (1596-1650).", + "oeuvres": [ + { + "titre": "Discours de la méthode", + "annee": "1637" + }, + { + "titre": "Méditations métaphysiques", + "annee": "1641" + }, + { + "titre": "Les Passions de l'âme", + "annee": "1649" + } + ] + } +} diff --git a/docs/winjets/examples/com.exemple.citation/manifest.json b/docs/winjets/examples/com.exemple.citation/manifest.json new file mode 100644 index 0000000..ac2fa1a --- /dev/null +++ b/docs/winjets/examples/com.exemple.citation/manifest.json @@ -0,0 +1,12 @@ +{ + "format": "winjet/1", + "id": "com.exemple.citation", + "name": "Citation du jour", + "version": "1.0.0", + "author": "Exemple Winlestia", + "description": "Une citation locale, avec un bouton pour afficher la fiche de son auteur.", + "license": "MIT", + "compatibility": { + "winlestia": ">=0.9.2" + } +} diff --git a/docs/winjets/examples/com.exemple.citation/preview.png b/docs/winjets/examples/com.exemple.citation/preview.png new file mode 100644 index 0000000..01be097 Binary files /dev/null and b/docs/winjets/examples/com.exemple.citation/preview.png differ diff --git a/docs/winjets/examples/com.exemple.citation/widget.json b/docs/winjets/examples/com.exemple.citation/widget.json new file mode 100644 index 0000000..8e389e8 --- /dev/null +++ b/docs/winjets/examples/com.exemple.citation/widget.json @@ -0,0 +1,207 @@ +{ + "size": { + "default": [ + 352, + 168 + ], + "min": [ + 352, + 168 + ], + "max": [ + 536, + 352 + ] + }, + "state": { + "mode": "citation" + }, + "data": { + "quotes": { + "type": "file", + "path": "assets/quotes.json" + } + }, + "layouts": [ + { + "minWidth": 0, + "root": { + "type": "column", + "padding": 16, + "gap": 8, + "children": [ + { + "type": "row", + "gap": 8, + "children": [ + { + "type": "text", + "text": "CITATION DU JOUR", + "style": "mono", + "tone": "secondary", + "maxLines": 1 + }, + { + "type": "dots", + "pattern": "ripple", + "shape": "circle" + } + ] + }, + { + "type": "column", + "visibleWhen": "state.mode == 'citation'", + "gap": 4, + "grow": 1, + "children": [ + { + "type": "text", + "text": "{{ data.quotes.citation.text }}", + "style": "title", + "maxLines": 3 + }, + { + "type": "text", + "text": "{{ data.quotes.citation.author }}", + "style": "caption", + "tone": "accent" + } + ] + }, + { + "type": "column", + "visibleWhen": "state.mode == 'auteur'", + "gap": 4, + "grow": 1, + "children": [ + { + "type": "text", + "text": "{{ data.quotes.auteur.name }}", + "style": "title", + "maxLines": 1 + }, + { + "type": "text", + "text": "{{ data.quotes.auteur.bio }}", + "style": "caption", + "tone": "secondary", + "maxLines": 3 + } + ] + }, + { + "type": "buttons", + "bind": "state.mode", + "options": [ + { + "value": "citation", + "label": "Citation" + }, + { + "value": "auteur", + "label": "Auteur" + } + ] + } + ] + } + }, + { + "minWidth": 340, + "minHeight": 340, + "root": { + "type": "column", + "padding": 16, + "gap": 8, + "children": [ + { + "type": "row", + "gap": 8, + "children": [ + { + "type": "text", + "text": "CITATION DU JOUR", + "style": "mono", + "tone": "secondary", + "maxLines": 1 + }, + { + "type": "dots", + "pattern": "ripple", + "shape": "circle" + } + ] + }, + { + "type": "column", + "visibleWhen": "state.mode == 'citation'", + "gap": 4, + "grow": 1, + "children": [ + { + "type": "text", + "text": "{{ data.quotes.citation.text }}", + "style": "title", + "maxLines": 3 + }, + { + "type": "text", + "text": "{{ data.quotes.citation.author }}", + "style": "caption", + "tone": "accent" + } + ] + }, + { + "type": "column", + "visibleWhen": "state.mode == 'auteur'", + "gap": 4, + "grow": 1, + "children": [ + { + "type": "text", + "text": "{{ data.quotes.auteur.name }}", + "style": "title", + "maxLines": 1 + }, + { + "type": "text", + "text": "{{ data.quotes.auteur.bio }}", + "style": "caption", + "tone": "secondary", + "maxLines": 3 + } + ] + }, + { + "type": "column", + "visibleWhen": "state.mode == 'auteur'", + "children": [ + { + "type": "list", + "items": "{{ data.quotes.auteur.oeuvres }}", + "title": "titre", + "trailing": "annee", + "max": 3 + } + ] + }, + { + "type": "buttons", + "bind": "state.mode", + "options": [ + { + "value": "citation", + "label": "Citation" + }, + { + "value": "auteur", + "label": "Auteur" + } + ] + } + ] + } + } + ] +} diff --git a/docs/winjets/schema/manifest.schema.json b/docs/winjets/schema/manifest.schema.json new file mode 100644 index 0000000..4076545 --- /dev/null +++ b/docs/winjets/schema/manifest.schema.json @@ -0,0 +1,47 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "title": "Winjet v1 - manifest.json", + "description": "Manifeste d'un paquet Winjet (format winjet/1). Voir docs/winjets/FORMAT-v1.md.", + "type": "object", + "additionalProperties": false, + "required": ["format", "id", "name", "version", "author"], + "properties": { + "format": { "const": "winjet/1" }, + "id": { + "type": "string", + "minLength": 3, + "maxLength": 64, + "pattern": "^[a-z0-9]+(\\.[a-z0-9-]+){1,4}$" + }, + "name": { "type": "string", "minLength": 1 }, + "version": { + "type": "string", + "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$" + }, + "author": { "type": "string", "minLength": 1 }, + "description": { "type": "string" }, + "license": { "type": "string" }, + "homepage": { "type": "string", "pattern": "^https://[A-Za-z0-9.-]+(:[0-9]+)?(/\\S*)?$" }, + "compatibility": { + "type": "object", + "additionalProperties": false, + "properties": { + "winlestia": { "type": "string", "pattern": "^(>=|<=|>|<|=)?[0-9]+\\.[0-9]+\\.[0-9]+( (>=|<=|>|<|=)?[0-9]+\\.[0-9]+\\.[0-9]+)*$" } + } + }, + "permissions": { + "type": "object", + "additionalProperties": false, + "properties": { + "network": { + "type": "array", + "uniqueItems": true, + "items": { + "type": "string", + "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$" + } + } + } + } + } +} diff --git a/docs/winjets/schema/widget.schema.json b/docs/winjets/schema/widget.schema.json new file mode 100644 index 0000000..46aac38 --- /dev/null +++ b/docs/winjets/schema/widget.schema.json @@ -0,0 +1,484 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "title": "Winjet v1 - widget.json", + "description": "Definition d'un Winjet (format winjet/1). Voir docs/winjets/FORMAT-v1.md.", + "type": "object", + "additionalProperties": false, + "required": ["size", "layouts"], + "properties": { + "size": { + "type": "object", + "additionalProperties": false, + "required": ["default"], + "properties": { + "default": { "$ref": "#/$defs/sizePair" }, + "min": { "$ref": "#/$defs/sizePair" }, + "max": { "$ref": "#/$defs/sizePair" } + } + }, + "settings": { "type": "array", "items": { "$ref": "#/$defs/setting" } }, + "state": { + "type": "object", + "propertyNames": { "$ref": "#/$defs/identifier" }, + "additionalProperties": { "type": ["string", "number", "boolean"] } + }, + "data": { + "type": "object", + "propertyNames": { "$ref": "#/$defs/identifier" }, + "additionalProperties": { "$ref": "#/$defs/dataSource" } + }, + "layouts": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "additionalProperties": false, + "required": ["minWidth", "root"], + "properties": { + "minWidth": { "type": "integer", "minimum": 0, "maximum": 5000 }, + "minHeight": { "type": "integer", "minimum": 0, "maximum": 5000 }, + "root": { "$ref": "#/$defs/node" } + } + } + } + }, + "$defs": { + "identifier": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,31}$" }, + "sizePair": { + "type": "array", + "minItems": 2, + "maxItems": 2, + "prefixItems": [ + { "type": "integer", "minimum": 120, "maximum": 1600 }, + { "type": "integer", "minimum": 120, "maximum": 1000 } + ] + }, + "setting": { + "type": "object", + "required": ["id", "type", "label", "default"], + "oneOf": [ + { + "properties": { + "id": { "$ref": "#/$defs/identifier" }, + "type": { "const": "toggle" }, + "label": { "type": "string", "minLength": 1 }, + "default": { "type": "boolean" } + }, + "additionalProperties": false + }, + { + "properties": { + "id": { "$ref": "#/$defs/identifier" }, + "type": { "const": "text" }, + "label": { "type": "string", "minLength": 1 }, + "default": { "type": "string" }, + "maxLength": { "type": "integer", "minimum": 1, "maximum": 200 } + }, + "additionalProperties": false + }, + { + "properties": { + "id": { "$ref": "#/$defs/identifier" }, + "type": { "const": "choice" }, + "label": { "type": "string", "minLength": 1 }, + "default": { "type": "string" }, + "options": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "additionalProperties": false, + "required": ["value", "label"], + "properties": { + "value": { "type": "string" }, + "label": { "type": "string", "minLength": 1 } + } + } + } + }, + "required": ["options"], + "additionalProperties": false + }, + { + "properties": { + "id": { "$ref": "#/$defs/identifier" }, + "type": { "const": "number" }, + "label": { "type": "string", "minLength": 1 }, + "default": { "type": "number" }, + "min": { "type": "number" }, + "max": { "type": "number" } + }, + "additionalProperties": false + } + ] + }, + "dataSource": { + "oneOf": [ + { + "type": "object", + "additionalProperties": false, + "required": ["type", "path"], + "properties": { + "type": { "const": "file" }, + "path": { "type": "string", "pattern": "^assets/[^\\\\:*?\"<>|]+\\.json$" } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "url"], + "properties": { + "type": { "const": "http" }, + "url": { "type": "string", "pattern": "^https://[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+(:443)?(/\\S*)?$" }, + "refresh": { "type": "integer", "minimum": 60, "maximum": 86400 }, + "enabledWhen": { "type": "string", "minLength": 1 } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "symbols"], + "properties": { + "type": { "const": "market" }, + "provider": { "enum": ["binance", "yahoo"] }, + "symbols": { + "type": "array", + "minItems": 1, + "maxItems": 4, + "uniqueItems": true, + "items": { "type": "string", "pattern": "^([A-Z0-9]{2,10}|[A-Za-z0-9^.=-]{1,15})$" } + }, + "refresh": { "type": "integer", "minimum": 60, "maximum": 86400 }, + "enabledWhen": { "type": "string", "minLength": 1 } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "url"], + "properties": { + "type": { "const": "calendar" }, + "url": { "type": "string", "minLength": 1, "maxLength": 500 }, + "refresh": { "type": "integer", "minimum": 60, "maximum": 86400 }, + "enabledWhen": { "type": "string", "minLength": 1 } + } + } + ] + }, + "paletteRole": { + "enum": ["accent", "primary", "secondary", "tertiary", "onSurface", "onSurfaceVariant", "positive", "negative"] + }, + "alignment": { "enum": ["start", "center", "end", "stretch"] }, + "boolOrExpr": { "type": ["boolean", "string"] }, + "action": { + "oneOf": [ + { + "type": "object", + "additionalProperties": false, + "required": ["type", "key", "value"], + "properties": { + "type": { "const": "setState" }, + "key": { "$ref": "#/$defs/identifier" }, + "value": { "type": ["string", "number", "boolean"] } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { "type": { "const": "refresh" } } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "url"], + "properties": { + "type": { "const": "openUrl" }, + "url": { "type": "string", "pattern": "^https://[A-Za-z0-9.-]+(:[0-9]+)?(/\\S*)?$" } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { "type": { "const": "openSettings" } } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { "type": { "enum": ["media.playPause", "media.next", "media.prev"] } } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "path"], + "properties": { + "type": { "const": "open" }, + "path": { "type": "string", "minLength": 1, "maxLength": 500 } + } + }, + { + "type": "object", + "additionalProperties": false, + "required": ["type", "drive"], + "properties": { + "type": { "const": "openDrive" }, + "drive": { "type": "string", "minLength": 1, "maxLength": 40 } + } + } + ] + }, + "containerProps": { + "properties": { + "children": { "type": "array", "items": { "$ref": "#/$defs/node" } }, + "gap": { "type": "integer", "minimum": 0, "maximum": 64 }, + "padding": { "type": "integer", "minimum": 0, "maximum": 64 }, + "align": { "$ref": "#/$defs/alignment" }, + "grow": { "type": "number", "minimum": 0 }, + "visibleWhen": { "type": "string", "minLength": 1 }, + "action": { "$ref": "#/$defs/action" } + }, + "required": ["children"] + }, + "node": { + "oneOf": [ + { "$ref": "#/$defs/column" }, + { "$ref": "#/$defs/row" }, + { "$ref": "#/$defs/stack" }, + { "$ref": "#/$defs/grid" }, + { "$ref": "#/$defs/text" }, + { "$ref": "#/$defs/image" }, + { "$ref": "#/$defs/clock" }, + { "$ref": "#/$defs/calendar" }, + { "$ref": "#/$defs/list" }, + { "$ref": "#/$defs/note" }, + { "$ref": "#/$defs/chart" }, + { "$ref": "#/$defs/stat" }, + { "$ref": "#/$defs/progress" }, + { "$ref": "#/$defs/dots" }, + { "$ref": "#/$defs/buttons" }, + { "$ref": "#/$defs/visualizer" }, + { "$ref": "#/$defs/media" }, + { "$ref": "#/$defs/spacer" }, + { "$ref": "#/$defs/divider" } + ] + }, + "column": { + "allOf": [{ "$ref": "#/$defs/containerProps" }, { "properties": { "type": { "const": "column" } }, "required": ["type"] }], + "unevaluatedProperties": false + }, + "row": { + "allOf": [{ "$ref": "#/$defs/containerProps" }, { "properties": { "type": { "const": "row" } }, "required": ["type"] }], + "unevaluatedProperties": false + }, + "stack": { + "allOf": [{ "$ref": "#/$defs/containerProps" }, { "properties": { "type": { "const": "stack" } }, "required": ["type"] }], + "unevaluatedProperties": false + }, + "grid": { + "allOf": [ + { "$ref": "#/$defs/containerProps" }, + { + "properties": { "type": { "const": "grid" }, "columns": { "type": "integer", "minimum": 1, "maximum": 12 } }, + "required": ["type", "columns"] + } + ], + "unevaluatedProperties": false + }, + "text": { + "type": "object", + "additionalProperties": false, + "required": ["type", "text"], + "properties": { + "type": { "const": "text" }, + "text": { "type": "string" }, + "style": { "enum": ["title", "label", "body", "caption", "display", "mono", "icon", "eyebrow", "glyph"] }, + "align": { "enum": ["start", "center", "end"] }, + "maxLines": { "type": "integer", "minimum": 1, "maximum": 20 }, + "tone": { "enum": ["primary", "secondary", "accent", "signed", "faint"] }, + "action": { "$ref": "#/$defs/action" } + } + }, + "image": { + "type": "object", + "additionalProperties": false, + "required": ["type", "src"], + "properties": { + "type": { "const": "image" }, + "src": { "type": "string", "pattern": "^assets/[^\\\\:*?\"<>|]+\\.(png|jpg|jpeg|webp|gif)$" }, + "fit": { "enum": ["contain", "cover"] }, + "radius": { "type": "integer", "minimum": 0, "maximum": 200 }, + "action": { "$ref": "#/$defs/action" } + } + }, + "clock": { + "type": "object", + "additionalProperties": false, + "required": ["type", "variant"], + "properties": { + "type": { "const": "clock" }, + "variant": { "enum": ["analog", "digital"] }, + "showSeconds": { "$ref": "#/$defs/boolOrExpr" }, + "seconds": { "$ref": "#/$defs/boolOrExpr" }, + "format": { "type": "string", "minLength": 1 }, + "timezone": { "type": "string" } + } + }, + "calendar": { + "type": "object", + "additionalProperties": false, + "required": ["type", "variant"], + "properties": { + "type": { "const": "calendar" }, + "variant": { "enum": ["month", "day"] }, + "firstDay": { "enum": ["monday", "sunday"] }, + "nav": { "$ref": "#/$defs/boolOrExpr" } + } + }, + "list": { + "type": "object", + "additionalProperties": false, + "required": ["type", "items", "title"], + "properties": { + "type": { "const": "list" }, + "items": { "type": "string", "minLength": 1 }, + "title": { "type": "string", "minLength": 1 }, + "subtitle": { "type": "string", "minLength": 1 }, + "trailing": { "type": "string", "minLength": 1 }, + "max": { "type": "integer", "minimum": 1, "maximum": 50 }, + "bar": { "type": "string", "minLength": 1 }, + "group": { "type": "string", "minLength": 1 }, + "icon": { "type": "string", "minLength": 1 }, + "relative": { "type": "string", "minLength": 1 }, + "past": { "$ref": "#/$defs/boolOrExpr" }, + "accent": { "$ref": "#/$defs/boolOrExpr" }, + "tiles": { "type": "integer", "minimum": 1, "maximum": 6 }, + "grow": { "type": "number", "minimum": 0 }, + "action": { "$ref": "#/$defs/action" } + } + }, + "note": { + "type": "object", + "additionalProperties": false, + "required": ["type", "key"], + "properties": { + "type": { "const": "note" }, + "key": { "$ref": "#/$defs/identifier" }, + "placeholder": { "type": "string", "maxLength": 100 }, + "grow": { "type": "number", "minimum": 0 }, + "visibleWhen": { "type": "string", "minLength": 1 } + } + }, + "chart": { + "type": "object", + "additionalProperties": false, + "required": ["type", "series"], + "properties": { + "type": { "const": "chart" }, + "series": { "type": "string", "minLength": 1 }, + "variant": { "enum": ["line", "area", "bars", "candles", "spark"] }, + "axes": { "$ref": "#/$defs/boolOrExpr" }, + "period": { "type": "string" }, + "color": { "$ref": "#/$defs/paletteRole" }, + "hover": { "$ref": "#/$defs/boolOrExpr" }, + "valueFormat": { "type": "string", "minLength": 1, "maxLength": 20 } + } + }, + "stat": { + "type": "object", + "additionalProperties": false, + "required": ["type", "value"], + "properties": { + "type": { "const": "stat" }, + "value": { "type": "string" }, + "label": { "type": "string" }, + "delta": { "type": ["string", "number"] }, + "action": { "$ref": "#/$defs/action" } + } + }, + "progress": { + "type": "object", + "additionalProperties": false, + "required": ["type", "value"], + "properties": { + "type": { "const": "progress" }, + "value": { "type": ["string", "number"] }, + "variant": { "enum": ["ring", "bar"] }, + "label": { "type": "string" }, + "from": { "type": ["string", "number"] }, + "thickness": { "type": "integer", "minimum": 1, "maximum": 16 }, + "big": { "$ref": "#/$defs/boolOrExpr" } + } + }, + "dots": { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "anyOf": [{ "required": ["matrix"] }, { "required": ["pattern"] }], + "properties": { + "type": { "const": "dots" }, + "matrix": { "type": "string", "minLength": 1 }, + "pattern": { "enum": ["pulse", "ripple", "torus"] }, + "shape": { "enum": ["circle", "square"] } + } + }, + "buttons": { + "type": "object", + "additionalProperties": false, + "required": ["type", "options", "bind"], + "properties": { + "type": { "const": "buttons" }, + "options": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "additionalProperties": false, + "required": ["value", "label"], + "properties": { + "value": { "type": "string" }, + "label": { "type": "string", "minLength": 1 } + } + } + }, + "bind": { "type": "string", "pattern": "^state\\.[A-Za-z][A-Za-z0-9_]{0,31}$" } + } + }, + "spacer": { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { "type": { "const": "spacer" } } + }, + "visualizer": { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { + "type": { "const": "visualizer" }, + "bars": { "type": "integer", "minimum": 8, "maximum": 64 }, + "source": { "enum": ["spectrum"] } + } + }, + "media": { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { + "type": { "const": "media" }, + "showArt": { "$ref": "#/$defs/boolOrExpr" }, + "showProgress": { "$ref": "#/$defs/boolOrExpr" }, + "showControls": { "$ref": "#/$defs/boolOrExpr" }, + "backdrop": { "$ref": "#/$defs/boolOrExpr" }, + "pill": { "$ref": "#/$defs/boolOrExpr" } + } + }, + "divider": { + "type": "object", + "additionalProperties": false, + "required": ["type"], + "properties": { "type": { "const": "divider" } } + } + } +} diff --git a/docs/winjets/template/README.md b/docs/winjets/template/README.md new file mode 100644 index 0000000..b7b0826 --- /dev/null +++ b/docs/winjets/template/README.md @@ -0,0 +1,46 @@ +# Gabarit de Winjet + +Copiez ce dossier, renommez-le, puis remplissez les champs ci-dessous. Guide complet : `docs/winjets/MON-PREMIER-WINJET.md`. Référence : `docs/winjets/FORMAT-v1.md`. + +## Contenu + +``` +manifest.json identité du Winjet (à remplir) +widget.json taille, réglages, données et mise en page (à adapter) +assets/ vos images et vos JSON de données (supprimez .gitkeep) +preview.png facultatif : aperçu affiché dans les Réglages (à ajouter vous-même) +README.md ce fichier : ne le mettez pas dans le ZIP +``` + +## `manifest.json` : champs à remplir + +| Champ | Quoi mettre | +|---|---| +| `format` | ne pas changer : `winjet/1` | +| `id` | identifiant unique en minuscules, de type `com.votrenom.monwinjet` (lettres, chiffres, tirets ; 2 à 5 segments séparés par des points) | +| `name` | le nom affiché | +| `version` | `1.0.0` ; augmentez-la à chaque nouvelle version | +| `author` | votre nom ou pseudo | +| `description` | une phrase | +| `license` | par exemple `MIT` | +| `compatibility.winlestia` | version minimale de Winlestia, par exemple `>=0.9.2` | +| `permissions.network` | laissez `[]` si le Winjet n'utilise pas Internet ; sinon la liste des hôtes (`"api.exemple.com"`) | +| `homepage` | facultatif : adresse `https://` de votre page. Ajoutez la ligne vous-même si vous la voulez. | + +## `widget.json` : parties à adapter + +| Partie | Quoi faire | +|---|---| +| `size` | `default` = taille de départ, `min` et `max` = bornes. Tailles de la grille : 168, 352, 536, 720 | +| `settings` | un réglage par entrée : `id`, `type` (`toggle`, `text`, `choice`, `number`), `label`, `default` | +| `state` | (absent du gabarit) valeurs modifiables par des boutons : `"state": { "mode": "a" }` | +| `data` | (absent du gabarit) sources : fichier de `assets/` ou adresse `https://` d'un hôte déclaré | +| `layouts` | une mise en page par palier de largeur ; la première commence à `"minWidth": 0` ; la dernière satisfaite est utilisée | + +Le gabarit affiche un message (réglage `message`) et l'heure, avec une seconde mise en page pour les grandes cartes. + +## Avant de zipper + +1. Supprimez `README.md` et `assets/.gitkeep` de la copie que vous zippez. +2. Les fichiers doivent être à la racine du ZIP. +3. Pas de couleur écrite en dur : utilisez des rôles de palette (`accent`, `primary`, `secondary`, `tertiary`, `onSurface`, `onSurfaceVariant`, `positive`, `negative`). diff --git a/docs/winjets/template/assets/.gitkeep b/docs/winjets/template/assets/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/docs/winjets/template/manifest.json b/docs/winjets/template/manifest.json new file mode 100644 index 0000000..fed0a89 --- /dev/null +++ b/docs/winjets/template/manifest.json @@ -0,0 +1,15 @@ +{ + "format": "winjet/1", + "id": "com.exemple.mon-winjet", + "name": "Mon Winjet", + "version": "1.0.0", + "author": "Votre nom", + "description": "Une phrase qui décrit votre Winjet.", + "license": "MIT", + "compatibility": { + "winlestia": ">=0.9.2" + }, + "permissions": { + "network": [] + } +} diff --git a/docs/winjets/template/widget.json b/docs/winjets/template/widget.json new file mode 100644 index 0000000..908029f --- /dev/null +++ b/docs/winjets/template/widget.json @@ -0,0 +1,76 @@ +{ + "size": { + "default": [ + 352, + 168 + ], + "min": [ + 168, + 168 + ], + "max": [ + 536, + 352 + ] + }, + "settings": [ + { + "id": "message", + "type": "text", + "label": "Message affiché", + "default": "Bonjour", + "maxLength": 40 + } + ], + "layouts": [ + { + "minWidth": 0, + "root": { + "type": "column", + "padding": 16, + "gap": 8, + "children": [ + { + "type": "text", + "text": "{{ settings.message }}", + "style": "title", + "maxLines": 2 + }, + { + "type": "clock", + "variant": "digital", + "format": "HH:mm" + } + ] + } + }, + { + "minWidth": 340, + "minHeight": 340, + "root": { + "type": "column", + "padding": 24, + "gap": 8, + "children": [ + { + "type": "text", + "text": "{{ settings.message }}", + "style": "display", + "maxLines": 2 + }, + { + "type": "clock", + "variant": "digital", + "format": "HH:mm" + }, + { + "type": "text", + "text": "{{ now | date:dddd d MMMM }}", + "style": "caption", + "tone": "secondary" + } + ] + } + } + ] +} diff --git a/dotnet-tools.json b/dotnet-tools.json deleted file mode 100644 index 6e2e244..0000000 --- a/dotnet-tools.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "version": 1, - "isRoot": true, - "tools": { - "csharpier": { - "version": "1.3.0", - "commands": [ - "csharpier" - ], - "rollForward": false - } - } -} \ No newline at end of file diff --git a/global.json b/global.json new file mode 100644 index 0000000..066a8f7 --- /dev/null +++ b/global.json @@ -0,0 +1,6 @@ +{ + "sdk": { + "version": "8.0.407", + "rollForward": "latestPatch" + } +} diff --git a/installer/Close-Winlestia.ps1 b/installer/Close-Winlestia.ps1 index e5ddd4d..b3144b4 100644 --- a/installer/Close-Winlestia.ps1 +++ b/installer/Close-Winlestia.ps1 @@ -1,18 +1,25 @@ -# PowerShell 5.1 / Close-Winlestia.ps1 / Scoped installer cleanup, never other Python applications. +# PowerShell 5.1 / Close-Winlestia.ps1 / Nettoyage ciblé de l'installeur, jamais d'autres applications Python. param([Parameter(Mandatory=$true)][string]$AppRoot,[switch]$ListOnly) $ErrorActionPreference='Stop' $installRoot=[IO.Path]::GetFullPath($AppRoot).TrimEnd('\')+'\' if($installRoot.Length -lt 12 -or $installRoot -eq [IO.Path]::GetPathRoot($installRoot)){throw 'Unexpected installation root'} $targets=@(Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -and $_.ExecutablePath.StartsWith($installRoot,[StringComparison]::OrdinalIgnoreCase) -and - (($_.Name -eq 'Panneaux.Glass.exe') -or ($_.Name -in @('python.exe','pythonw.exe') -and $_.CommandLine -match '(frontend\.py|sync_theme\.py)')) + (($_.Name -eq 'Panneaux.Glass.exe') -or ($_.Name -in @('python.exe','pythonw.exe') -and + $_.CommandLine -match '(frontend\.py|sync_theme\.py)')) }) if($ListOnly){$targets | Select-Object ProcessId,Name;return} $backend=Join-Path $installRoot 'Glass-v5\Panneaux.Glass.exe' -if(Test-Path -LiteralPath $backend){$quit=Start-Process -FilePath $backend -ArgumentList '--quit' -WindowStyle Hidden -PassThru;$quit.WaitForExit(1000) | Out-Null} +if(Test-Path -LiteralPath $backend){$quit=Start-Process -FilePath $backend -ArgumentList '--quit' -WindowStyle Hidden -PassThru; +$quit.WaitForExit(1000) | Out-Null} $until=[DateTime]::UtcNow.AddSeconds(4) -do{ $remaining=@($targets | Where-Object {Get-Process -Id $_.ProcessId -ErrorAction SilentlyContinue});if(!$remaining){break};Start-Sleep -Milliseconds 100 }while([DateTime]::UtcNow -lt $until) -foreach($target in $remaining){$live=Get-CimInstance Win32_Process -Filter "ProcessId=$($target.ProcessId)";if($live -and $live.ExecutablePath -eq $target.ExecutablePath){Stop-Process -Id $target.ProcessId -Force -ErrorAction SilentlyContinue}} -# Balayage final : tout processus restant dont l'exécutable est sous la racine d'installation (hors désinstalleur) garde des fichiers verrouillés. +do{ $remaining=@($targets | Where-Object {Get-Process -Id $_.ProcessId -ErrorAction SilentlyContinue});if(!$remaining){break}; +Start-Sleep -Milliseconds 100 }while([DateTime]::UtcNow -lt $until) +foreach($target in $remaining){$live=Get-CimInstance Win32_Process -Filter "ProcessId=$($target.ProcessId)"; +if($live -and $live.ExecutablePath -eq $target.ExecutablePath){Stop-Process -Id $target.ProcessId -Force -ErrorAction SilentlyContinue}} +# Balayage final : tout processus restant dont l'exécutable est sous la racine d'installation (hors désinstalleur) garde des fichiers +# verrouillés. Start-Sleep -Milliseconds 300 -foreach($left in @(Get-CimInstance Win32_Process | Where-Object {$_.ExecutablePath -and $_.ExecutablePath.StartsWith($installRoot,[StringComparison]::OrdinalIgnoreCase) -and $_.Name -notlike 'unins*.exe' -and $_.ProcessId -ne $PID})){Stop-Process -Id $left.ProcessId -Force -ErrorAction SilentlyContinue} +foreach($left in @(Get-CimInstance Win32_Process | Where-Object {$_.ExecutablePath -and $_.ExecutablePath.StartsWith($installRoot, + [StringComparison]::OrdinalIgnoreCase) -and $_.Name -notlike 'unins*.exe' -and $_.ProcessId -ne $PID})){ + Stop-Process -Id $left.ProcessId -Force -ErrorAction SilentlyContinue} diff --git a/installer/Deploy-Local.ps1 b/installer/Deploy-Local.ps1 index 0b7a685..7288a89 100644 --- a/installer/Deploy-Local.ps1 +++ b/installer/Deploy-Local.ps1 @@ -1,4 +1,4 @@ -# Winlestia - deploiement local du build vers une copie installee (sans release, sans commit). +# Winlestia - deploiement local du build vers une copie installee (sans release, sans commit). # Sauvegarde, ferme l'app, publie le backend, copie backend + frontend, relance. param( [string]$InstallDir = (Join-Path $env:LOCALAPPDATA 'Programs\Winlestia'), @@ -10,9 +10,33 @@ $root = Split-Path $PSScriptRoot -Parent $stamp = Get-Date -Format 'yyyyMMdd-HHmmss' $backup = Join-Path $root "build\backups\$BackupTag-$stamp" $stage = Join-Path $root 'build\deploy-staging\Glass-v5' +$filesStage = Join-Path $root 'build\deploy-staging\Files' $glass = Join-Path $InstallDir 'Glass-v5' $front = Join-Path $InstallDir 'Caelestia-Windows' +# Fusionne un publish secondaire dans le dossier principal : ajoute les fichiers absents et les assemblies +# gérées dont l'AssemblyVersion est strictement supérieure ; Winlestia.Files.* est toujours copié. +function Merge-Publish([string]$Source, [string]$Dest) { + $srcRoot = (Resolve-Path $Source).Path.TrimEnd('\') + foreach ($f in Get-ChildItem $srcRoot -Recurse -File) { + $rel = $f.FullName.Substring($srcRoot.Length).TrimStart('\') + $target = Join-Path $Dest $rel + $copy = $false + if ($f.Name -like 'Winlestia.Files.*' -or -not (Test-Path $target)) { $copy = $true } + else { + try { + $new = [Reflection.AssemblyName]::GetAssemblyName($f.FullName).Version + $old = [Reflection.AssemblyName]::GetAssemblyName($target).Version + if ($new -gt $old) { $copy = $true } + } catch { } # natif ou illisible : on garde la copie du backend + } + if ($copy) { + New-Item -ItemType Directory -Force -Path (Split-Path $target -Parent) | Out-Null + Copy-Item $f.FullName $target -Force + } + } +} + Write-Host '-> Sauvegarde' -ForegroundColor Cyan New-Item -ItemType Directory -Force -Path $backup | Out-Null robocopy $glass (Join-Path $backup 'Glass-v5') /E /NFL /NDL /NJH /NJS /NP | Out-Null @@ -33,14 +57,21 @@ if ($LASTEXITCODE -ne 0) { throw 'Compilation du backend echouee.' } Write-Host '-> Publish Winlestia Fichiers' -ForegroundColor Cyan dotnet publish (Join-Path $root 'src\files\Winlestia.Files.csproj') ` -c Release -r win-x64 --self-contained true -p:PublishSingleFile=false ` - -o $stage --nologo + -o $filesStage --nologo if ($LASTEXITCODE -ne 0) { throw 'Compilation de Winlestia Fichiers echouee.' } +Merge-Publish $filesStage $stage +Remove-Item -Recurse -Force $filesStage -ErrorAction SilentlyContinue Write-Host '-> Publish winlestia.exe' -ForegroundColor Cyan dotnet publish (Join-Path $root 'src\cli\winlestia.csproj') ` -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:PublishTrimmed=true ` -p:EnableCompressionInSingleFile=true -p:DebugType=none ` -o $stage --nologo if ($LASTEXITCODE -ne 0) { throw 'Compilation de winlestia.exe echouee.' } +Write-Host '-> Publish assistant de capteurs' -ForegroundColor Cyan +dotnet publish (Join-Path $root 'src\sensors\Winlestia.Sensors.csproj') ` + -c Release -r win-x64 --self-contained true -p:PublishSingleFile=false ` + -o (Join-Path $stage 'Sensors') --nologo +if ($LASTEXITCODE -ne 0) { throw 'Compilation de l assistant de capteurs echouee.' } Copy-Item (Join-Path $root 'src\backend\Inventory.ps1') $stage -Force Copy-Item (Join-Path $root 'src\backend\native\*.dll') $stage -Force Copy-Item (Join-Path $root 'src\backend\native\*.exe') $stage -Force @@ -48,15 +79,34 @@ Copy-Item (Join-Path $root 'src\backend\native\*.exe') $stage -Force Write-Host '-> Copie backend' -ForegroundColor Cyan robocopy $stage $glass /E /NFL /NDL /NJH /NJS /NP | Out-Null if ($LASTEXITCODE -ge 8) { throw "robocopy backend: $LASTEXITCODE" } +# robocopy saute un fichier de même taille et même date même si son contenu diffère (Whisper.net net8 vs net10 : la DLL net10 restait +# en place et cassait la dictée). Passe de rattrapage par empreinte. +Get-ChildItem $stage -File -Recurse | ForEach-Object { + $target = Join-Path $glass $_.FullName.Substring($stage.Length).TrimStart('\') + if (-not (Test-Path $target) -or (Get-FileHash $_.FullName).Hash -ne (Get-FileHash $target).Hash) { + Copy-Item $_.FullName $target -Force + Write-Host " recopie (contenu différent) : $($_.Name)" + } +} + +Write-Host '-> Verre natif Qt' -ForegroundColor Cyan +$qtGlass = Join-Path $root 'build\QtGlassBackdrop.dll' +if (-not (Test-Path $qtGlass)) { + cmd /c (Join-Path $root 'src\native\qtglass\build-qt-glass.cmd') + if ($LASTEXITCODE -ne 0 -or -not (Test-Path $qtGlass)) { + throw 'QtGlassBackdrop.dll manquant : compilation (src\native\qtglass\build-qt-glass.cmd) echouee.' } +} Write-Host '-> Copie frontend' -ForegroundColor Cyan robocopy (Join-Path $root 'src\frontend') $front /E /NFL /NDL /NJH /NJS /NP ` /XD '.venv' '__pycache__' 'tests' 'validation-*' 'checkpoint-*' /XF '*.zip' '*.pyc' | Out-Null if ($LASTEXITCODE -ge 8) { throw "robocopy frontend: $LASTEXITCODE" } $global:LASTEXITCODE = 0 +# La DLL est produite dans build\ : elle doit finir a cote des modules du frontend. +Copy-Item -LiteralPath $qtGlass -Destination $front -Force if (-not $NoStart) { Write-Host '-> Demarrage' -ForegroundColor Cyan - Start-Process (Join-Path $glass 'Panneaux.Glass.exe') -WorkingDirectory $glass + schtasks /run /tn WinlestiaShell | Out-Null # meme point d'entree que l'autostart a l'ouverture de session (--qt-shell) } Write-Host "Termine. Sauvegarde: $backup" diff --git a/installer/Uninstall-Winlestia.ps1 b/installer/Uninstall-Winlestia.ps1 new file mode 100644 index 0000000..70338fb --- /dev/null +++ b/installer/Uninstall-Winlestia.ps1 @@ -0,0 +1,222 @@ +# PowerShell 5.1 / Uninstall-Winlestia.ps1 / Script de repli : desinstalle Winlestia sans Inno Setup ni WinlestiaSetup.exe. +# Usage : Uninstall-Winlestia.ps1 [-KeepData | -RemoveData] [-DryRun] [-InstallDir ] +# -KeepData (defaut) conserve %LOCALAPPDATA%\Winlestia et %LOCALAPPDATA%\Panneaux. +# -RemoveData envoie les dossiers de donnees a la Corbeille (jamais de suppression definitive). +# -DryRun affiche ce qui serait fait, ne modifie rien et ne lance aucun processus. +param( + [switch]$KeepData, + [switch]$RemoveData, + [switch]$DryRun, + [string]$InstallDir = (Join-Path $env:LOCALAPPDATA 'Programs\Winlestia') +) +$ErrorActionPreference = 'Continue' +if ($KeepData -and $RemoveData) { Write-Error 'Choisir -KeepData ou -RemoveData, pas les deux.'; exit 2 } + +# Garde-fou : seul %LOCALAPPDATA%\Programs\Winlestia est accepte (chemin normalise, sans casse) ; +# variable vide ou racine de lecteur refusees. +if ([string]::IsNullOrWhiteSpace($env:LOCALAPPDATA) -or [string]::IsNullOrWhiteSpace($env:TEMP) -or + [string]::IsNullOrWhiteSpace($InstallDir)) { + Write-Error 'Variable d environnement ou InstallDir vide.'; exit 2 +} +$localRoot = [IO.Path]::GetFullPath($env:LOCALAPPDATA).TrimEnd('\') +if ($localRoot -eq [IO.Path]::GetPathRoot($localRoot).TrimEnd('\')) { Write-Error 'LOCALAPPDATA est une racine de lecteur.'; exit 2 } +$expectedRoot = $localRoot + '\Programs\Winlestia' +$installRoot = [IO.Path]::GetFullPath($InstallDir).TrimEnd('\') +if (-not $installRoot.Equals($expectedRoot, [StringComparison]::OrdinalIgnoreCase)) { + Write-Error "Dossier d'installation refuse : $installRoot (attendu : $expectedRoot)"; exit 2 +} +$installRoot = $expectedRoot +$mode = if ($DryRun) { '[SIMULATION] ' } else { '' } +$failures = 0 +$leftovers = @() +$logFile = Join-Path $env:TEMP 'WinlestiaUninstall.log' +function Log([string]$Text) { + if (-not $DryRun) { Add-Content -LiteralPath $logFile -Value ((Get-Date -Format o) + ' ' + $Text) -ErrorAction SilentlyContinue } +} + +function Step([string]$Text, [scriptblock]$Action) { + if ($DryRun) { Write-Host "$mode$Text"; return } + Write-Host "-> $Text" -ForegroundColor Cyan + Log $Text + try { & $Action } + catch { $script:failures++; Write-Warning "Echec : $Text ($($_.Exception.Message))"; Log "ECHEC : $Text ($($_.Exception.Message))" } +} + +Add-Type -TypeDefinition @' +using System; +using System.Runtime.InteropServices; +public static class WinlestiaTaskbar { + [DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern IntPtr FindWindow(string cls, string title); + [DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr h); + public static bool Visible() { IntPtr h = FindWindow("Shell_TrayWnd", null); return h != IntPtr.Zero && IsWindowVisible(h); } +} +'@ + +# 1. Barre des taches : le chemin de restauration du projet d'abord, explorer.exe en dernier recours. +Step 'Restaurer la barre des taches Windows' { + $glass = Join-Path $installRoot 'Glass-v5' + $backend = Join-Path $glass 'Panneaux.Glass.exe' + $rescue = Join-Path $glass 'RETABLIR_BARRE_WINDOWS.exe' + if (Test-Path -LiteralPath $backend) { Start-Process -FilePath $backend -ArgumentList '--restore-taskbar' -WindowStyle Hidden -Wait } + elseif (Test-Path -LiteralPath $rescue) { Start-Process -FilePath $rescue -WindowStyle Hidden -Wait } + elseif (-not (Get-Process explorer -ErrorAction SilentlyContinue)) { Start-Process explorer.exe } +} + +# 2. Tache planifiee de session. +Step 'Supprimer la tache planifiee WinlestiaShell' { + & "$env:SystemRoot\System32\schtasks.exe" /delete /tn WinlestiaShell /f 2>&1 | Out-Null +} + +# 3. Processus Winlestia (limites au dossier d'installation par Close-Winlestia.ps1). +$closer = Join-Path $installRoot 'Close-Winlestia.ps1' +if (-not (Test-Path -LiteralPath $closer)) { $closer = Join-Path $PSScriptRoot 'Close-Winlestia.ps1' } +Step 'Arreter les processus Winlestia' { + & $closer -AppRoot $installRoot +} + +# 4. Associations et integrations posees a l'installation (Inno : [UninstallRun]). +$files = Join-Path $installRoot 'Glass-v5\Winlestia.Files.exe' +Step 'Rendre le gestionnaire de dossiers a Windows (Winlestia.Files --restore)' { + if (Test-Path -LiteralPath $files) { Start-Process -FilePath $files -ArgumentList '--restore' -WindowStyle Hidden -Wait } +} +$python = Join-Path $installRoot 'Caelestia-Windows\.venv\Scripts\python.exe' +$terminal = Join-Path $installRoot 'Winlestia-Terminal\install.py' +Step 'Restaurer le terminal (install.py --restore)' { + if ((Test-Path -LiteralPath $python) -and (Test-Path -LiteralPath $terminal)) { + Start-Process -FilePath $python -ArgumentList @('"' + $terminal + '"', '--restore') -WindowStyle Hidden -Wait + } +} +$sensors = Join-Path $installRoot 'Glass-v5\Sensors\Winlestia.Sensors.exe' +$sensorsInstalled = Join-Path $env:ProgramFiles 'Winlestia\Sensors\Winlestia.Sensors.exe' +Step 'Retirer le service de capteurs eleve (demande UAC ; PawnIO conserve)' { + if ((Test-Path -LiteralPath $sensors) -and (Test-Path -LiteralPath $sensorsInstalled)) { + Start-Process -FilePath $sensors -ArgumentList 'uninstall' -Verb RunAs -WindowStyle Hidden -Wait + } +} + +# 5. Registre (HKCU uniquement). +Step 'Supprimer la valeur Run "Panneaux"' { + Remove-ItemProperty -LiteralPath 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Run' -Name 'Panneaux' -ErrorAction SilentlyContinue +} +Step 'Retirer le dossier Glass-v5 du PATH utilisateur' { + $key = 'HKCU:\Environment' + $current = (Get-ItemProperty -LiteralPath $key -Name Path -ErrorAction SilentlyContinue).Path + if ($current) { + $glass = Join-Path $installRoot 'Glass-v5' + $alt = if ($glass.StartsWith($localRoot, [StringComparison]::OrdinalIgnoreCase)) { + '%localappdata%' + $glass.Substring($localRoot.Length) + } else { $glass } + $kept = @($current -split ';' | Where-Object { $_ -and $_.TrimEnd('\') -ne $glass -and $_.TrimEnd('\') -ne $alt }) + if ($kept.Count -ne @($current -split ';' | Where-Object { $_ }).Count) { + Set-ItemProperty -LiteralPath $key -Name Path -Value ($kept -join ';') -Type ExpandString + } + } +} +Step 'Supprimer l entree "Applications installees" (cle Uninstall HKCU)' { + $uninstall = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall' + $inno = Join-Path $uninstall '{8E2B7C41-5F1A-4F7B-9C3D-6A2E0D5B7C18}_is1' + if (Test-Path -LiteralPath $inno) { Remove-Item -LiteralPath $inno -Recurse -Force } + # Nouvel installateur : toute cle HKCU dont le nom affiche est exactement Winlestia. + foreach ($k in @(Get-ChildItem -LiteralPath $uninstall -ErrorAction SilentlyContinue)) { + if ((Get-ItemProperty -LiteralPath $k.PSPath -ErrorAction SilentlyContinue).DisplayName -eq 'Winlestia') { + Remove-Item -LiteralPath $k.PSPath -Recurse -Force + } + } +} + +# 6. Raccourcis. +$programs = [Environment]::GetFolderPath('Programs') +$desktop = [Environment]::GetFolderPath('DesktopDirectory') +$shortcuts = @( + (Join-Path $programs 'Winlestia.lnk'), + (Join-Path $programs ('Restaurer la barre des t' + [char]0xE2 + 'ches Windows.lnk')), + (Join-Path $programs 'Restore the Windows taskbar.lnk'), + (Join-Path $programs 'Restaurar la barra de tareas de Windows.lnk'), + (Join-Path $programs ('D' + [char]0xE9 + 'sinstaller Winlestia.lnk')), + (Join-Path $programs 'Uninstall Winlestia.lnk'), + (Join-Path $programs 'Desinstalar Winlestia.lnk'), + (Join-Path $desktop 'Winlestia.lnk') +) +Step 'Supprimer les raccourcis du menu Demarrer et du Bureau' { + foreach ($s in $shortcuts) { if (Test-Path -LiteralPath $s) { Remove-Item -LiteralPath $s -Force } } +} + +# 7. Dossier d'installation. Le script peut tourner depuis ce dossier : on se place ailleurs d'abord. +Step "Supprimer le dossier d'installation ($installRoot)" { + Set-Location -LiteralPath $env:TEMP + if (Test-Path -LiteralPath $installRoot) { Remove-Item -LiteralPath $installRoot -Recurse -Force } +} + +# 8. Donnees utilisateur : Corbeille uniquement, jamais de suppression definitive. +# Noms exacts utilises par le backend (Store : Panneaux ; Files, Explorer, terminal-backup : Winlestia) et par Qt +# (app_main.py : setApplicationName 'Panneaux - Caelestia Windows', avec un point median U+00B7). +if ($RemoveData) { + $qtName = 'Panneaux ' + [char]0xB7 + ' Caelestia Windows' + $dataDirs = @(foreach ($name in @('Winlestia', 'Panneaux', $qtName)) { + $candidate = Join-Path $localRoot $name + if (Test-Path -LiteralPath $candidate -PathType Container) { $candidate } + }) + if ($DryRun -and -not $dataDirs) { Write-Host "$mode(aucun dossier de donnees trouve)" } + Add-Type -TypeDefinition @' +using System; +using System.Runtime.InteropServices; +public static class WinlestiaRecycle { + [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)] + struct SHFILEOPSTRUCT { + public IntPtr hwnd; public uint wFunc; public string pFrom; public string pTo; public ushort fFlags; + public bool fAnyOperationsAborted; public IntPtr hNameMappings; public string lpszProgressTitle; + } + [DllImport("shell32.dll", CharSet = CharSet.Unicode)] static extern int SHFileOperationW(ref SHFILEOPSTRUCT op); + // FO_DELETE | FOF_ALLOWUNDO (0x40) | FOF_NOCONFIRMATION (0x10) | FOF_WANTNUKEWARNING (0x4000) : si la Corbeille ne peut pas + // recevoir le dossier, Windows avertit au lieu de le detruire ; un refus de l'utilisateur annule l'operation. + // Structure a 64 bits uniquement (alignement 8) : l'appelant verifie [IntPtr]::Size. + public static int Send(string path) { + var op = new SHFILEOPSTRUCT { wFunc = 3, pFrom = path + "\0\0", fFlags = 0x40 | 0x10 | 0x4000 }; + int rc = SHFileOperationW(ref op); + return op.fAnyOperationsAborted && rc == 0 ? 1223 : rc; + } +} +'@ + foreach ($dir in $dataDirs) { + Step "Envoyer a la Corbeille : $dir" { + $drive = New-Object IO.DriveInfo ([IO.Path]::GetPathRoot($dir)) + if ([IntPtr]::Size -ne 8) { throw 'PowerShell 32 bits : envoi a la Corbeille non pris en charge' } + if ($drive.DriveType -ne [IO.DriveType]::Fixed) { throw "lecteur non local ($($drive.DriveType)) : pas de Corbeille garantie" } + $rc = [WinlestiaRecycle]::Send($dir) + if ($rc -ne 0 -or (Test-Path -LiteralPath $dir)) { throw "Corbeille impossible (code $rc)" } + } + if (-not $DryRun -and (Test-Path -LiteralPath $dir)) { $leftovers += $dir } + } + Step 'Supprimer la cle HKCU\Software\Winlestia (profil)' { + Remove-Item -LiteralPath 'HKCU:\Software\Winlestia' -Recurse -Force -ErrorAction SilentlyContinue + } +} else { + Write-Host "$mode Donnees conservees : $localRoot\Winlestia, $localRoot\Panneaux" +} +# 9. Invariant : jamais d'utilisateur sans barre des taches. +$taskbarOk = $true +Step 'Verifier explorer.exe et la barre des taches' { + function Wait-Bar([int]$Seconds) { + $until = [DateTime]::UtcNow.AddSeconds($Seconds) + while (-not [WinlestiaTaskbar]::Visible() -and [DateTime]::UtcNow -lt $until) { Start-Sleep -Milliseconds 300 } + return [WinlestiaTaskbar]::Visible() + } + if (-not (Get-Process explorer -ErrorAction SilentlyContinue)) { Start-Process explorer.exe } + if (-not (Wait-Bar 8)) { + # explorer tourne mais sans barre : arret puis relance comme shell (Windows le relance seul, sinon on le lance). + Log 'Barre invisible : redemarrage d explorer.exe' + Get-Process explorer -ErrorAction SilentlyContinue | Stop-Process -Force + Start-Sleep -Seconds 2 + if (-not (Get-Process explorer -ErrorAction SilentlyContinue)) { Start-Process explorer.exe } + if (-not (Wait-Bar 10)) { $script:taskbarOk = $false; throw 'Shell_TrayWnd toujours invisible apres le redemarrage d explorer.exe' } + } +} +if ($DryRun) { Write-Host "$mode Termine, rien n'a ete modifie."; exit 0 } +if ($leftovers.Count -gt 0) { + Write-Warning ('Dossiers de donnees laisses en place (Corbeille indisponible) : ' + ($leftovers -join ' ; ')) + Log ('Dossiers laisses : ' + ($leftovers -join ' ; ')) +} +if (-not $taskbarOk) { Write-Warning 'La barre des taches reste invisible.'; exit 4 } +if ($failures -gt 0) { Write-Warning "$failures etape(s) en echec. Journal : $logFile"; exit 1 } +Write-Host 'Winlestia est desinstalle.' +exit 0 diff --git a/installer/Winlestia.iss b/installer/Winlestia.iss index b67cf0f..3e2a9af 100644 --- a/installer/Winlestia.iss +++ b/installer/Winlestia.iss @@ -7,7 +7,9 @@ ; - déjà installé → une page propose « Mettre à jour » ou « Désinstaller ». #define AppName "Winlestia" -#define AppVersion "0.9.1" +#ifndef AppVersion + #error AppVersion non defini : compiler via installer/build.ps1 (/DAppVersion lu dans Directory.Build.props). +#endif #define AppPublisher "dj" #define AppExe "Panneaux.Glass.exe" #define AppId "{{8E2B7C41-5F1A-4F7B-9C3D-6A2E0D5B7C18}" @@ -157,6 +159,8 @@ Type: files; Name: "{app}\Glass-v5\winlestia.deps.json" Type: files; Name: "{app}\Glass-v5\winlestia.runtimeconfig.json" ; Les anciens fonds d'écran fournis sont remplacés par les nouveaux (le dossier utilisateur %LOCALAPPDATA%\Panneaux\Wallpapers n'est jamais touché). Type: files; Name: "{app}\wallpapers\*" +; Winjets inclus : le dossier est remplacé en entier (retire les anciens horloge/calendrier/graphique-btc). +Type: filesandordirs; Name: "{app}\Winjets\builtin" [Files] Source: "Close-Winlestia.ps1"; Flags: dontcopy @@ -177,6 +181,9 @@ Source: "..\assets\wallpapers\*"; DestDir: "{app}\wallpapers"; Flags: ignorevers Source: "..\build\payload\Winlestia-Terminal\*"; DestDir: "{app}\Winlestia-Terminal"; Flags: ignoreversion recursesubdirs createallsubdirs +; Winjets inclus (lecture seule) +Source: "..\build\payload\Winjets\builtin\*"; DestDir: "{app}\Winjets\builtin"; Flags: ignoreversion recursesubdirs createallsubdirs + [Icons] Name: "{autoprograms}\{#AppName}"; Filename: "{app}\Glass-v5\{#AppExe}"; Parameters: "--qt-shell --show"; WorkingDir: "{app}\Glass-v5"; IconFilename: "{app}\Glass-v5\{#AppExe}"; Tasks: startmenu Name: "{autodesktop}\{#AppName}"; Filename: "{app}\Glass-v5\{#AppExe}"; Parameters: "--qt-shell --show"; WorkingDir: "{app}\Glass-v5"; IconFilename: "{app}\Glass-v5\{#AppExe}"; Tasks: desktopicon @@ -198,6 +205,9 @@ Filename: "{sys}\schtasks.exe"; Parameters: "/delete /tn WinlestiaShell /f"; Fla Filename: "{sys}\WindowsPowerShell\v1.0\powershell.exe"; Parameters: "-NoLogo -NoProfile -ExecutionPolicy Bypass -File ""{app}\Close-Winlestia.ps1"" -AppRoot ""{app}"""; Flags: runhidden waituntilterminated; RunOnceId: "CloseWinlestia" +; Assistant de capteurs élevé (installé dans Program Files à la demande de l'utilisateur) : tâche et dossier retirés, PawnIO conservé. +Filename: "{app}\Glass-v5\Sensors\Winlestia.Sensors.exe"; Parameters: "uninstall"; Verb: runas; Flags: shellexec waituntilterminated runhidden skipifdoesntexist; Check: SensorsInstalled(); RunOnceId: "RemoveSensors" + Filename: "{app}\Glass-v5\Winlestia.Files.exe"; Parameters: "--restore"; Flags: runhidden waituntilterminated skipifdoesntexist; RunOnceId: "RestoreFolderHandler" Filename: "{app}\Caelestia-Windows\.venv\Scripts\python.exe"; Parameters: """{app}\Winlestia-Terminal\install.py"" --restore"; Flags: runhidden waituntilterminated; RunOnceId: "RestoreTerminal" @@ -460,6 +470,12 @@ begin end; end; +// Vrai si l'assistant de capteurs a été installé dans Program Files (jamais d'élévation sinon). +function SensorsInstalled(): Boolean; +begin + Result := FileExists(ExpandConstant('{commonpf}\Winlestia\Sensors\Winlestia.Sensors.exe')); +end; + function PathIsEmpty(): Boolean; var Current: String; begin diff --git a/installer/WinlestiaSetup/App.xaml b/installer/WinlestiaSetup/App.xaml new file mode 100644 index 0000000..abcae9e --- /dev/null +++ b/installer/WinlestiaSetup/App.xaml @@ -0,0 +1,126 @@ + + + Segoe UI Variable Text, Segoe UI + Segoe Fluent Icons, Segoe MDL2 Assets + + + + + + + + + + + + + diff --git a/installer/WinlestiaSetup/App.xaml.cs b/installer/WinlestiaSetup/App.xaml.cs new file mode 100644 index 0000000..87cb2b8 --- /dev/null +++ b/installer/WinlestiaSetup/App.xaml.cs @@ -0,0 +1,66 @@ +using System.Windows; +using System.Windows.Media; + +namespace WinlestiaSetup; + +public partial class App : Application +{ + protected override void OnStartup(StartupEventArgs e) + { + base.OnStartup(e); + var o = Options.Parse(e.Args); + Ctx.O = o; Ctx.Screenshot = o.Screenshots != null; Ctx.LoadVersion(); + Loc.Init(o.Lang); + if (!Ctx.Screenshot) Log.File = Path.Combine(Path.GetTempPath(), "WinlestiaSetup-" + DateTime.Now.ToString("yyyyMMdd-HHmmss") + + ".log"); + Log.Write("WinlestiaSetup " + Ctx.Version + " args: " + string.Join(" ", e.Args)); + + Ctx.Info = Ctx.Screenshot ? new InstallInfo() : InstallInfo.Detect(); + Ctx.Demo = !Ctx.Screenshot && !o.Uninstall && !Installer.HasPayload(); + if (o.Uninstall) Ctx.Mode = Mode.Uninstall; + else if (Ctx.Info.Exists) Ctx.Mode = Mode.Update; + + // Le setup ne doit jamais s'exécuter depuis le dossier qu'il remplace ou supprime (le balayage du shell l'arrêterait). + if (!Ctx.Screenshot && Ctx.Info.Exists) + { + try { if (Uninstaller.RelocateIfNeeded(e.Args)) { Shutdown(); return; } } catch (Exception ex) { + Log.Write("Relocation failed: " + ex.Message); } + } + + string? wall = o.Wallpaper ?? (Ctx.Screenshot ? RepoWallpaper() : null) ?? Native.WallpaperPath(); + var pal = Palette.FromWallpaper(wall); + pal.Apply(Resources); + Features.Reset(); + + var win = new MainWindow(); + if (Ctx.Screenshot) + { + win.WindowStartupLocation = WindowStartupLocation.Manual; win.Left = -20000; win.Top = 0; win.ShowInTaskbar = false; + win.Show(); + _ = Shots.Run(win, o.Screenshots!, wall, pal).ContinueWith(t => + { + if (t.IsFaulted) File.WriteAllText(Path.Combine(o.Screenshots!, "error.txt"), t.Exception!.ToString()); + Dispatcher.Invoke(Shutdown); + }); + return; + } + win.Show(); + win.Closed += (_, _) => + { + if (Ctx.Mode == Mode.Uninstall) Uninstaller.CleanTempCopy(); + if (Ctx.LaunchAfter && win.PageId == "done" && Runner.Failure == null && Ctx.Mode + != Mode.Uninstall) Installer.Launch(Ctx.InstallDir); + }; + } + + static string? RepoWallpaper() + { + for (var d = new DirectoryInfo(AppContext.BaseDirectory); d != null; d = d.Parent) + { + var w = Path.Combine(d.FullName, "assets", "wallpapers"); + if (Directory.Exists(w)) return Directory.GetFiles(w).Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) + || f.EndsWith(".png", StringComparison.OrdinalIgnoreCase)).OrderBy(f => f).FirstOrDefault(); + } + return null; + } +} diff --git a/installer/WinlestiaSetup/Assets/previews/dashboard.png b/installer/WinlestiaSetup/Assets/previews/dashboard.png new file mode 100644 index 0000000..06ec734 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/dashboard.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/desktop.png b/installer/WinlestiaSetup/Assets/previews/desktop.png new file mode 100644 index 0000000..4aee175 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/desktop.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/dock-palette.png b/installer/WinlestiaSetup/Assets/previews/dock-palette.png new file mode 100644 index 0000000..461d487 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/dock-palette.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/dock.png b/installer/WinlestiaSetup/Assets/previews/dock.png new file mode 100644 index 0000000..fa9b1cd Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/dock.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/media.png b/installer/WinlestiaSetup/Assets/previews/media.png new file mode 100644 index 0000000..a578f29 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/media.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/panels.png b/installer/WinlestiaSetup/Assets/previews/panels.png new file mode 100644 index 0000000..4776879 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/panels.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/settings.png b/installer/WinlestiaSetup/Assets/previews/settings.png new file mode 100644 index 0000000..9c41c39 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/settings.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/taskbar.png b/installer/WinlestiaSetup/Assets/previews/taskbar.png new file mode 100644 index 0000000..107ee05 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/taskbar.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/terminal.png b/installer/WinlestiaSetup/Assets/previews/terminal.png new file mode 100644 index 0000000..5d4e8b1 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/terminal.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/tools.png b/installer/WinlestiaSetup/Assets/previews/tools.png new file mode 100644 index 0000000..bd50f0a Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/tools.png differ diff --git a/installer/WinlestiaSetup/Assets/previews/workspaces.png b/installer/WinlestiaSetup/Assets/previews/workspaces.png new file mode 100644 index 0000000..505f762 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/previews/workspaces.png differ diff --git a/installer/WinlestiaSetup/Assets/winlestia-mark.png b/installer/WinlestiaSetup/Assets/winlestia-mark.png new file mode 100644 index 0000000..141a3f1 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/winlestia-mark.png differ diff --git a/installer/WinlestiaSetup/Assets/winlestia.ico b/installer/WinlestiaSetup/Assets/winlestia.ico new file mode 100644 index 0000000..8e91b65 Binary files /dev/null and b/installer/WinlestiaSetup/Assets/winlestia.ico differ diff --git a/installer/WinlestiaSetup/Core/Install.cs b/installer/WinlestiaSetup/Core/Install.cs new file mode 100644 index 0000000..2f7a826 --- /dev/null +++ b/installer/WinlestiaSetup/Core/Install.cs @@ -0,0 +1,538 @@ +using System.Diagnostics; +using System.IO.Compression; +using System.Reflection; +using System.Runtime.InteropServices; +using System.Text; +using System.Text.Json.Nodes; +using Microsoft.Win32; + +namespace WinlestiaSetup; + +sealed class InstallInfo +{ + public bool Exists; public string Version = ""; public string Dir = ""; public bool FromInno; + + const string OwnKey = @"Software\Microsoft\Windows\CurrentVersion\Uninstall\Winlestia"; + const string InnoKey = @"Software\Microsoft\Windows\CurrentVersion\Uninstall\{8E2B7C41-5F1A-4F7B-9C3D-6A2E0D5B7C18}_is1"; + public static string OwnKeyPath => OwnKey; + public static string InnoKeyPath => InnoKey; + + public static InstallInfo Detect() + { + var i = new InstallInfo(); + using (var k = Registry.CurrentUser.OpenSubKey(OwnKey)) + if (k != null) { i.Version = k.GetValue("DisplayVersion") as string ?? ""; + i.Dir = (k.GetValue("InstallLocation") as string ?? "").TrimEnd('\\'); i.Exists = true; } + if (!i.Exists) + using (var k = Registry.CurrentUser.OpenSubKey(InnoKey)) + if (k != null) { i.Version = k.GetValue("DisplayVersion") as string ?? ""; + i.Dir = (k.GetValue("Inno Setup: App Path") as string ?? "").TrimEnd('\\'); i.Exists = true; i.FromInno = true; } + var exe = Path.Combine(i.Exists && i.Dir.Length > 0 ? i.Dir : Ctx.DefaultDir, @"Glass-v5\Panneaux.Glass.exe"); + if (File.Exists(exe)) + { + if (!i.Exists) { i.Exists = true; i.Dir = Ctx.DefaultDir; } + if (i.Version.Length == 0) i.Version = FileVersionInfo.GetVersionInfo(exe).ProductVersion?.Split('+')[0] ?? "?"; + } + else if (i.Exists && !Directory.Exists(i.Dir)) i = new InstallInfo(); + return i; + } +} + +static class Sys +{ + [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)] + struct ShFileOp { public IntPtr hwnd; public uint wFunc; public string pFrom; public string? pTo; public ushort fFlags; + public int fAborted; public IntPtr hMapping; public string? title; } + [DllImport("shell32.dll", CharSet = CharSet.Unicode)] static extern int SHFileOperation(ref ShFileOp op); + [DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern IntPtr FindWindow(string cls, string? title); + + // Corbeille uniquement (FOF_ALLOWUNDO | FOF_NOCONFIRMATION | FOF_WANTNUKEWARNING, comme Uninstall-Winlestia.ps1). + // FOF_WANTNUKEWARNING fait demander le shell au lieu de supprimer définitivement si l'élément ne peut pas être recyclé. + // Refusé sur tout lecteur qui n'est pas un disque fixe (les lecteurs amovibles et réseau n'ont pas de Corbeille). + public static bool Recycle(string path) + { + if (!Directory.Exists(path) && !File.Exists(path)) return true; + try + { + var root = Path.GetPathRoot(Path.GetFullPath(path)); + if (string.IsNullOrEmpty(root) || root.StartsWith("\\\\") || new DriveInfo(root).DriveType != DriveType.Fixed) + { Log.Write("Recycle Bin refused (not a fixed drive): " + path + ", left in place"); return false; } + } + catch (Exception e) { Log.Write("Recycle Bin refused (drive check failed: " + e.Message + "): " + path + ", left in place"); + return false; } + var op = new ShFileOp { wFunc = 3, pFrom = path + "\0\0", fFlags = 0x0040 | 0x0010 | 0x4000 }; + int r = SHFileOperation(ref op); + bool ok = r == 0 && op.fAborted == 0 && !Directory.Exists(path) && !File.Exists(path); + Log.Write("Recycle Bin: " + path + (ok ? " -> ok" : " -> failed (code " + r + "), left in place")); + return ok; + } + + public static bool TrayPresent() => FindWindow("Shell_TrayWnd", null) != IntPtr.Zero; + public static bool ExplorerRunning() => Process.GetProcessesByName("explorer").Length > 0; + + public static (int code, string output) Run(string file, string args, int timeoutMs = 60000) + { + var psi = new ProcessStartInfo(file, args) { + CreateNoWindow = true, UseShellExecute = false, RedirectStandardOutput = true, RedirectStandardError = true }; + using var p = Process.Start(psi)!; + var o = p.StandardOutput.ReadToEndAsync(); var e = p.StandardError.ReadToEndAsync(); + if (!p.WaitForExit(timeoutMs)) { try { p.Kill(); } catch { } return (-1, "timeout"); } + return (p.ExitCode, (o.Result + e.Result).Trim()); + } + + public static bool Under(string path, string root) => + Path.GetFullPath(path).TrimEnd('\\').StartsWith(Path.GetFullPath(root).TrimEnd('\\') + "\\", StringComparison.OrdinalIgnoreCase); + + public static void Shortcut(string lnk, string target, string args, string workDir, string icon) + { + dynamic sh = Activator.CreateInstance(Type.GetTypeFromProgID("WScript.Shell")!)!; + var s = sh.CreateShortcut(lnk); + s.TargetPath = target; s.Arguments = args; s.WorkingDirectory = workDir; s.IconLocation = icon; s.Save(); + } + + public static string ShortcutTarget(string lnk) + { + try { dynamic sh = Activator.CreateInstance(Type.GetTypeFromProgID("WScript.Shell")!)!; + return (string)sh.CreateShortcut(lnk).TargetPath; } catch { return ""; } + } +} + +sealed record StepDef(string Key, Func Run); + +static class Runner +{ + public static string? Failure; + public static readonly List Warnings = new(); + + // Exécute les étapes sur un thread de travail ; une étape en échec interrompt si abortOnFail, sinon elle est signalée et l'exécution + // continue. + public static async Task Run(List steps, bool abortOnFail, Action onStep) + { + Failure = null; Warnings.Clear(); + await Task.Run(() => + { + for (int i = 0; i < steps.Count; i++) + { + onStep(i, steps[i].Key); + Log.Write("== step: " + steps[i].Key); + try + { + var w = steps[i].Run(); + if (!string.IsNullOrEmpty(w)) { Warnings.Add(w); Log.Write("warning: " + w); } + if (Ctx.Dry && !Ctx.Screenshot) Thread.Sleep(380); + } + catch (Exception e) + { + Log.Write("ERROR in " + steps[i].Key + ": " + e.Message); + Warnings.Add(Loc.T("step." + steps[i].Key) + ": " + e.Message); + if (abortOnFail) { Failure = e.Message; break; } + } + } + onStep(steps.Count, ""); + }); + } + + public static void Do(string what, Action a) + { + if (Ctx.Dry) { Log.Write("[dry-run] would: " + what); return; } + Log.Write(what); a(); + } +} + +static class Installer +{ + static readonly string[] Payloaded = { "Glass-v5", "Caelestia-Windows", "Winlestia-Terminal", @"Winjets\builtin" }; + + public static Stream? OpenPayload() + { + var s = Assembly.GetExecutingAssembly().GetManifestResourceStream("payload.zip"); + if (s != null) return s; + var f = Path.Combine(AppContext.BaseDirectory, "payload.zip"); + return File.Exists(f) ? File.OpenRead(f) : null; + } + public static bool HasPayload() { using var s = OpenPayload(); return s != null; } + + public static List Steps() + { + var dir = Ctx.InstallDir; var l = new List(); + l.Add(new("close", () => { ShellCloser.Close(dir); return null; })); + if (Ctx.Mode is Mode.Install or Mode.Update) + { + l.Add(new("backup", () => Backup(dir))); + l.Add(new("copy", () => Copy(dir))); + } + l.Add(new("config", () => Config())); + if (Ctx.Features.TryGetValue("terminal", out var t) + && (t || File.Exists(Path.Combine(Ctx.LocalApp, @"Winlestia\terminal-backup\state.json")))) + l.Add(new("terminal", () => Terminal(dir, t))); + if (Ctx.Mode is Mode.Install or Mode.Update) + { + l.Add(new("task", () => Task(dir))); + l.Add(new("shortcuts", () => Shortcuts(dir))); + l.Add(new("registry", () => Registry_(dir))); + } + return l; + } + + static string? Backup(string dir) + { + if (!Ctx.Info.Exists) { Log.Write("Fresh install: nothing to back up."); return null; } + var tag = (Ctx.Info.Version.Length > 0 ? Ctx.Info.Version : "previous") + "-" + DateTime.Now.ToString("yyyyMMdd-HHmmss"); + var dest = Path.Combine(Ctx.BackupRoot, tag); + Runner.Do("move previous program folders to " + dest, () => + { + if (Directory.Exists(Ctx.BackupRoot)) foreach (var old in Directory.GetDirectories(Ctx.BackupRoot)) Sys.Recycle(old); + Directory.CreateDirectory(dest); + foreach (var p in Payloaded) + { + var src = Path.Combine(dir, p); + if (!Directory.Exists(src)) continue; + var to = Path.Combine(dest, p); Directory.CreateDirectory(Path.GetDirectoryName(to)!); + Directory.Move(src, to); + } + }); + return null; + } + + static string? Copy(string dir) + { + using var ps = OpenPayload(); + if (ps == null) { Log.Write("[demo] no payload.zip: nothing to copy."); return null; } + Runner.Do("extract payload.zip to " + dir, () => + { + using var zip = new ZipArchive(ps, ZipArchiveMode.Read); + var root = Path.GetFullPath(dir).TrimEnd('\\') + "\\"; + foreach (var e in zip.Entries) + { + if (e.FullName.EndsWith("/")) continue; + var target = Path.GetFullPath(Path.Combine(dir, e.FullName.Replace('/', '\\'))); + if (!target.StartsWith(root, StringComparison.OrdinalIgnoreCase)) throw new InvalidDataException("Unsafe entry: " + + e.FullName); + Directory.CreateDirectory(Path.GetDirectoryName(target)!); + e.ExtractToFile(target, true); + } + var setupDir = Path.Combine(dir, "Setup"); Directory.CreateDirectory(setupDir); + File.Copy(Environment.ProcessPath!, Path.Combine(setupDir, "WinlestiaSetup.exe"), true); + }); + return null; + } + + static string? Config() + { + var path = Ctx.PrefsPath; + Runner.Do("write feature choices to " + path, () => + { + JsonObject root = new(); + if (File.Exists(path)) + { + root = JsonNode.Parse(File.ReadAllText(path))?.AsObject() ?? new(); + var bak = path + ".setup-backup"; if (!File.Exists(bak)) File.Copy(path, bak); + } + foreach (var f in Features.All.Where(f => f.Kind == FeatureKind.Pref)) + foreach (var k in f.Keys) root[k] = Ctx.Features[f.Id]; + Directory.CreateDirectory(Path.GetDirectoryName(path)!); + File.WriteAllText(path, root.ToJsonString(new System.Text.Json.JsonSerializerOptions { WriteIndented = true }), + new UTF8Encoding(true)); + }); + foreach (var f in Features.All.Where(f => f.Kind == FeatureKind.Pref)) + Log.Write($" {string.Join("+", f.Keys)} = {Ctx.Features[f.Id]}"); + return null; + } + + static string? Terminal(string dir, bool on) + { + var py = Path.Combine(dir, @"Caelestia-Windows\.venv\Scripts\python.exe"); + var script = Path.Combine(dir, @"Winlestia-Terminal\install.py"); + var args = "\"" + script + "\"" + (on ? "" : " --restore"); + string? warn = null; + Runner.Do((on ? "apply" : "restore") + " terminal integration: python install.py" + (on ? "" : " --restore"), () => + { + if (!File.Exists(py) || !File.Exists(script)) { warn = Loc.T("warn.terminalMissing"); return; } + var (c, o) = Sys.Run(py, args, 180000); + if (c != 0) { Log.Write(o); warn = Loc.T("warn.terminal"); } + }); + return warn; + } + + static string? Task(string dir) + { + var exe = Path.Combine(dir, @"Glass-v5\Panneaux.Glass.exe"); + Runner.Do("create scheduled task WinlestiaShell (logon, current user, no elevation)", () => + { + var user = System.Security.Principal.WindowsIdentity.GetCurrent().Name; + string E(string s) => System.Security.SecurityElement.Escape(s) ?? ""; + var xml = "\n\n" + + " WinlestiaShell\n" + + " true" + E(user) + "\n" + + " " + E(user) + + "InteractiveTokenLeastPrivilege\n" + + " IgnoreNewfalse" + + "" + + "falsetrue" + + "false" + + "falsetruetrue" + + "false" + + "falsefalsePT0S" + + "4\n" + + " " + E("\"" + exe + "\"") + + "--qt-shell" + E(Path.GetDirectoryName(exe)!) + + "\n\n"; + var tmp = Path.Combine(Path.GetTempPath(), "winlestia-task-" + Guid.NewGuid().ToString("N") + ".xml"); + File.WriteAllText(tmp, xml, Encoding.Unicode); + try + { + var (c, o) = Sys.Run("schtasks.exe", "/create /tn WinlestiaShell /xml \"" + tmp + "\" /f"); + if (c != 0) throw new InvalidOperationException("schtasks: " + o); + } + finally { try { File.Delete(tmp); } catch { } } + using var run = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Run", true); + if (run?.GetValue("Panneaux") != null) { run.DeleteValue("Panneaux"); + Log.Write("Removed old Run value (replaced by the task)."); } + }); + return null; + } + + public static string StartMenu => Environment.GetFolderPath(Environment.SpecialFolder.Programs); + + static string? Shortcuts(string dir) + { + var exe = Path.Combine(dir, @"Glass-v5\Panneaux.Glass.exe"); var wd = Path.GetDirectoryName(exe)!; + Runner.Do("create Start menu shortcuts in " + StartMenu, () => + { + Sys.Shortcut(Path.Combine(StartMenu, "Winlestia.lnk"), exe, "--qt-shell --show", wd, exe + ",0"); + Sys.Shortcut(Path.Combine(StartMenu, Loc.T("sc.restore") + ".lnk"), Path.Combine(wd, "RETABLIR_BARRE_WINDOWS.exe"), "", wd, exe + + ",0"); + Sys.Shortcut(Path.Combine(StartMenu, Loc.T("sc.uninstall") + ".lnk"), Path.Combine(dir, @"Setup\WinlestiaSetup.exe"), + "--uninstall", Path.Combine(dir, "Setup"), exe + ",0"); + }); + return null; + } + + static string? Registry_(string dir) + { + var exe = Path.Combine(dir, @"Glass-v5\Panneaux.Glass.exe"); + Runner.Do("write HKCU\\" + InstallInfo.OwnKeyPath + + " (Installed apps entry, uninstall string -> Setup\\WinlestiaSetup.exe --uninstall)", () => + { + using var k = Registry.CurrentUser.CreateSubKey(InstallInfo.OwnKeyPath); + k.SetValue("DisplayName", "Winlestia"); k.SetValue("DisplayVersion", Ctx.Version); k.SetValue("Publisher", "dj"); + k.SetValue("InstallLocation", dir); k.SetValue("DisplayIcon", exe); + k.SetValue("UninstallString", "\"" + Path.Combine(dir, @"Setup\WinlestiaSetup.exe") + "\" --uninstall"); + k.SetValue("NoModify", 1, RegistryValueKind.DWord); k.SetValue("NoRepair", 1, RegistryValueKind.DWord); + k.SetValue("InstallDate", DateTime.Now.ToString("yyyyMMdd")); + if (Registry.CurrentUser.OpenSubKey(InstallInfo.InnoKeyPath) != null) + { + Registry.CurrentUser.DeleteSubKeyTree(InstallInfo.InnoKeyPath, false); + Log.Write("Removed the Inno Setup uninstall entry (replaced by this one)."); + } + }); + return null; + } + + public static void Launch(string dir) + { + var exe = Path.Combine(dir, @"Glass-v5\Panneaux.Glass.exe"); + if (Ctx.Dry) { Log.Write("[dry-run] would: start " + exe + " --qt-shell --show"); return; } + Process.Start(new ProcessStartInfo(exe, "--qt-shell --show") { + WorkingDirectory = Path.GetDirectoryName(exe)!, UseShellExecute = false }); + } +} + +static class ShellCloser +{ + // Même logique que installer\Close-Winlestia.ps1 : utilise le script installé s'il est présent, sinon un repli limité au chemin. + public static void Close(string root) + { + var ps = Path.Combine(root, "Close-Winlestia.ps1"); + if (File.Exists(ps)) + { + var args = "-NoLogo -NoProfile -ExecutionPolicy Bypass -File \"" + ps + "\" -AppRoot \"" + root + "\""; + if (Ctx.Dry) { var (c, o) = Sys.Run("powershell.exe", args + " -ListOnly", 30000); + Log.Write("[dry-run] processes that would be closed:" + Environment.NewLine + (o.Length > 0 ? o : "(none)")); } + else { var (c, o) = Sys.Run("powershell.exe", args, 60000); Log.Write("Close-Winlestia.ps1 exit " + c + " " + o); } + return; + } + if (!Directory.Exists(root)) { Log.Write("Nothing to close (no installation folder)."); return; } + foreach (var p in Process.GetProcesses()) + { + try + { + var path = p.MainModule?.FileName; if (path == null || p.Id == Environment.ProcessId || !Sys.Under(path, root)) continue; + Runner.Do("stop " + p.ProcessName + " (" + p.Id + ")", () => { p.Kill(); p.WaitForExit(3000); }); + } + catch { } + } + } +} + +static class Uninstaller +{ + public static List Steps() + { + var dir = Ctx.InstallDir; + return new() + { + new("restore", () => RestoreShell(dir)), + new("utask", () => { Runner.Do("schtasks /delete /tn WinlestiaShell /f", + () => Sys.Run("schtasks.exe", "/delete /tn WinlestiaShell /f")); return null; }), + new("stop", () => { ShellCloser.Close(dir); return null; }), + new("undo", () => Undo(dir)), + new("uregistry", Registry_), + new("ushortcuts", () => Shortcuts(dir)), + new("files", () => Files(dir)), + new("verify", Verify), + }; + } + + static string? RestoreShell(string dir) + { + var backend = Path.Combine(dir, @"Glass-v5\Panneaux.Glass.exe"); + if (File.Exists(backend)) + Runner.Do("run backend --restore-taskbar", () => + { + var (c, o) = Sys.Run(backend, "--restore-taskbar", 15000); Log.Write("--restore-taskbar exit " + c); + }); + else Log.Write("Backend not found: falling back to the explorer check below."); + return EnsureExplorer(); + } + + // Shell_TrayWnd est la fenêtre de la barre des tâches : si elle manque, le shell n'est pas vraiment revenu, donc explorer.exe est + // relancé. + public static string? EnsureExplorer() + { + bool Wait(int ms) { var end = DateTime.UtcNow.AddMilliseconds(ms); while (DateTime.UtcNow < end) { + if (Sys.TrayPresent()) return true; Thread.Sleep(250); } return Sys.TrayPresent(); } + if (Wait(Ctx.Dry ? 500 : 6000)) { Log.Write("Windows taskbar present (Shell_TrayWnd)."); return null; } + if (Ctx.Dry) { Log.Write("[dry-run] taskbar absent: would restart explorer.exe"); return null; } + Log.Write("Taskbar absent: restarting explorer.exe"); + foreach (var p in Process.GetProcessesByName("explorer")) { try { p.Kill(); p.WaitForExit(3000); } catch { } } + Process.Start(new ProcessStartInfo("explorer.exe") { UseShellExecute = true }); + return Wait(15000) ? null : Loc.T("warn.noTaskbar"); + } + + static string? Undo(string dir) + { + string? warn = null; + var files = Path.Combine(dir, @"Glass-v5\Winlestia.Files.exe"); + if (File.Exists(files)) Runner.Do("Winlestia.Files.exe --restore (folder handler)", () => Sys.Run(files, "--restore", 30000)); + var py = Path.Combine(dir, @"Caelestia-Windows\.venv\Scripts\python.exe"); + var inst = Path.Combine(dir, @"Winlestia-Terminal\install.py"); + if (File.Exists(py) && File.Exists(inst)) + Runner.Do("terminal integration: install.py --restore", () => { + var (c, _) = Sys.Run(py, "\"" + inst + "\" --restore", 120000); if (c != 0) warn = Loc.T("warn.terminal"); }); + return warn; + } + + static string? Registry_() + { + Runner.Do("delete HKCU\\" + InstallInfo.OwnKeyPath, () => Registry.CurrentUser.DeleteSubKeyTree(InstallInfo.OwnKeyPath, false)); + if (Registry.CurrentUser.OpenSubKey(InstallInfo.InnoKeyPath) != null) + Runner.Do("delete HKCU\\" + InstallInfo.InnoKeyPath, () => Registry.CurrentUser.DeleteSubKeyTree(InstallInfo.InnoKeyPath, + false)); + const string UnKey = @"Software\Microsoft\Windows\CurrentVersion\Uninstall"; + using (var un = Registry.CurrentUser.OpenSubKey(UnKey)) + foreach (var name in un?.GetSubKeyNames() ?? Array.Empty()) + { + using var sk = un!.OpenSubKey(name); + if (sk?.GetValue("DisplayName") as string == "Winlestia") + Runner.Do("delete HKCU\\" + UnKey + "\\" + name + + " (DisplayName Winlestia)", () => Registry.CurrentUser.DeleteSubKeyTree(UnKey + "\\" + name, false)); + } + using (var run = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Run")) + if ((run?.GetValue("Panneaux") as string)?.Contains("Glass-v5", StringComparison.OrdinalIgnoreCase) == true) + Runner.Do("delete HKCU Run value Panneaux", () => { + using var w = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Run", true); + w?.DeleteValue("Panneaux", false); }); + var glass = Path.Combine(Ctx.DefaultDir, "Glass-v5"); + using (var env = Registry.CurrentUser.OpenSubKey("Environment")) + if (env?.GetValue("Path", "", RegistryValueOptions.DoNotExpandEnvironmentNames) is string path + && path.Split(';').Any(s => s.TrimEnd('\\').Equals(glass, StringComparison.OrdinalIgnoreCase))) + Runner.Do("remove " + glass + " from the user PATH", () => + { + using var w = Registry.CurrentUser.OpenSubKey("Environment", true); + var kept = path.Split(';').Where(s => s.Length > 0 + && !s.TrimEnd('\\').Equals(glass, StringComparison.OrdinalIgnoreCase)); + w!.SetValue("Path", string.Join(";", kept), RegistryValueKind.ExpandString); + }); + if (Ctx.O.RemoveData && Registry.CurrentUser.OpenSubKey(@"Software\Winlestia") != null) + Runner.Do("delete HKCU\\Software\\Winlestia", () => Registry.CurrentUser.DeleteSubKeyTree(@"Software\Winlestia", false)); + return null; + } + + static string? Shortcuts(string dir) + { + var names = new List { "Winlestia" }; + names.AddRange(Loc.AllValues("sc.restore")); names.AddRange(Loc.AllValues("sc.uninstall")); + var desktop = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory); + foreach (var folder in new[] { Installer.StartMenu, desktop }) + foreach (var n in names.Distinct()) + { + var f = Path.Combine(folder, n + ".lnk"); + if (!File.Exists(f)) continue; + var tgt = Sys.ShortcutTarget(f); + if (tgt.Length > 0 && !tgt.Contains("Winlestia", StringComparison.OrdinalIgnoreCase) + && !tgt.Contains("Panneaux", StringComparison.OrdinalIgnoreCase) + && !tgt.Contains("RETABLIR", StringComparison.OrdinalIgnoreCase)) continue; + Runner.Do("delete shortcut " + f, () => File.Delete(f)); + } + return null; + } + + static string? Files(string dir) + { + var left = new List(); + // Noms exacts uniquement, sans joker. Les données utilisateur vont à la Corbeille seulement si l'utilisateur a choisi de les + // supprimer. + // Dossier Qt : "Panneaux \u00B7 Caelestia Windows", comme dans Uninstall-Winlestia.ps1. + var data = new[] { Path.Combine(Ctx.LocalApp, "Panneaux"), Path.Combine(Ctx.LocalApp, "Winlestia"), + Path.Combine(Ctx.LocalApp, "Panneaux \u00B7 Caelestia Windows") }; + void Bin(string p) { if (!Directory.Exists(p)) return; if (Ctx.Dry) { Log.Write("[dry-run] would send to Recycle Bin: " + p); + return; } if (!Sys.Recycle(p)) left.Add(p); } + if (Ctx.O.RemoveData) foreach (var d in data) Bin(d); else Log.Write("User data kept: " + string.Join(", ", data)); + if (Ctx.O.RemoveData) Bin(Ctx.BackupRoot); else Log.Write("Backups kept: " + Ctx.BackupRoot); + var norm = Path.GetFullPath(dir).TrimEnd('\\'); + if (!norm.Equals(Path.GetFullPath(Ctx.DefaultDir).TrimEnd('\\'), StringComparison.OrdinalIgnoreCase) + || Path.GetPathRoot(norm)!.TrimEnd('\\').Equals(norm, StringComparison.OrdinalIgnoreCase)) + { Log.Write("Program folder refused (not exactly " + Ctx.DefaultDir + "): " + dir); left.Add(dir); } + else Bin(norm); + return left.Count == 0 ? null : Loc.F("warn.left", string.Join(", ", left)); + } + + static string? Verify() + { + if (!Sys.ExplorerRunning() && !Ctx.Dry) Process.Start(new ProcessStartInfo("explorer.exe") { UseShellExecute = true }); + var w = EnsureExplorer(); + Log.Write("explorer.exe running: " + Sys.ExplorerRunning() + ", taskbar: " + Sys.TrayPresent()); + return w; + } + + // Nettoyage différé de la copie dans %TEMP% faite par RelocateIfNeeded (uniquement un dossier WinlestiaSetup-xxxxxxxx directement sous + // %TEMP%). + public static void CleanTempCopy() + { + if (Ctx.O.DryRun || !Ctx.O.Relocated) return; + var dir = Path.GetDirectoryName(Environment.ProcessPath!)!.TrimEnd('\\'); + if (!Path.GetFileName(dir).StartsWith("WinlestiaSetup-") + || !Path.GetDirectoryName(dir)!.TrimEnd('\\').Equals(Path.GetTempPath().TrimEnd('\\'), + StringComparison.OrdinalIgnoreCase)) return; + try { Process.Start(new ProcessStartInfo("cmd.exe", "/c ping -n 4 127.0.0.1 >nul & rmdir /s /q \"" + dir + "\"") { + CreateNoWindow = true, UseShellExecute = false }); } catch { } + } + + // Le désinstalleur ne doit pas s'exécuter depuis le dossier qu'il supprime : copie dans %TEMP% puis relance. + public static bool RelocateIfNeeded(string[] args) + { + var exe = Environment.ProcessPath!; + bool inside = Sys.Under(exe, Ctx.InstallDir) || Sys.Under(exe, Ctx.DefaultDir); + if (!inside || Ctx.O.Relocated) return false; + if (Ctx.O.DryRun) { Log.Write("[dry-run] would copy the setup to %TEMP% and relaunch (running from the install folder)"); + return false; } + var tmp = Path.Combine(Path.GetTempPath(), "WinlestiaSetup-" + Guid.NewGuid().ToString("N").Substring(0, 8)); + Directory.CreateDirectory(tmp); + var copy = Path.Combine(tmp, "WinlestiaSetup.exe"); File.Copy(exe, copy, true); + Process.Start(new ProcessStartInfo(copy, string.Join(" ", args.Select(a => "\"" + a + "\"")) + " --relocated") { + UseShellExecute = false }); + return true; + } +} diff --git a/installer/WinlestiaSetup/Core/Model.cs b/installer/WinlestiaSetup/Core/Model.cs new file mode 100644 index 0000000..ad70c76 --- /dev/null +++ b/installer/WinlestiaSetup/Core/Model.cs @@ -0,0 +1,159 @@ +using System.Globalization; +using System.Reflection; +using System.Text.Json; + +namespace WinlestiaSetup; + +sealed class Options +{ + public bool Uninstall, RemoveData, FromShell, DryRun, NoMotion, Relocated; + public string? Lang, Screenshots, Wallpaper; + public bool DataChosen; + + public static Options Parse(string[] a) + { + var o = new Options(); + for (int i = 0; i < a.Length; i++) + { + switch (a[i].ToLowerInvariant()) + { + case "--uninstall": o.Uninstall = true; break; + case "--keep-data": o.RemoveData = false; o.DataChosen = true; break; + case "--remove-data": o.RemoveData = true; o.DataChosen = true; break; + case "--from-shell": o.FromShell = true; break; + case "--dry-run": o.DryRun = true; break; + case "--no-motion": o.NoMotion = true; break; + case "--relocated": o.Relocated = true; break; + case "--lang": if (i + 1 < a.Length) o.Lang = a[++i]; break; + case "--screenshots": if (i + 1 < a.Length) o.Screenshots = a[++i]; break; + case "--wallpaper": if (i + 1 < a.Length) o.Wallpaper = a[++i]; break; + } + } + return o; + } +} + +static class Log +{ + static readonly object Gate = new(); + public static readonly List Lines = new(); + public static string? File; + public static void Write(string s) + { + var line = DateTime.Now.ToString("HH:mm:ss.fff") + " " + s; + lock (Gate) + { + Lines.Add(line); + if (File != null) { try { System.IO.File.AppendAllText(File, line + Environment.NewLine); } catch { } } + } + } +} + +enum Mode { Install, Update, Modify, Uninstall } + +static class Ctx +{ + public static Options O = new(); + public static InstallInfo Info = new(); + public static bool Demo; // sans payload : tout le flux s'exécute, rien n'est écrit + public static string Version = "0.0.0"; + public static Mode Mode = Mode.Install; + public static Dictionary Features = new(); + public static bool NotifyUpdates; + public static bool LaunchAfter = true; + public static bool Screenshot; + + public static bool Dry => O.DryRun || Screenshot || (Demo && (Mode == Mode.Install || Mode == Mode.Update)); + public static string LocalApp => Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData); + public static string DefaultDir => System.IO.Path.Combine(LocalApp, "Programs", "Winlestia"); + public static string BackupRoot => System.IO.Path.Combine(LocalApp, "Programs", "Winlestia-backups"); + public static string PrefsPath => System.IO.Path.Combine(LocalApp, "Panneaux", "preferences-glass.json"); + public static string InstallDir => Info.Exists && Info.Dir.Length > 0 ? Info.Dir : DefaultDir; + + public static void LoadVersion() + { + var v = Assembly.GetExecutingAssembly().GetCustomAttribute()?.InformationalVersion + ?? "0.0.0"; + Version = v.Split('+')[0]; + } +} + +enum FeatureKind { Pref, Action, Locked } + +sealed record Feature(string Id, FeatureKind Kind, string[] Keys, bool Default, string Glyph, string? Preview); + +static class Features +{ + // Les clés sont les vraies propriétés de PanneauxGlass Preferences (preferences-glass.json). Les panneaux et les Winjets n'ont pas de + // clé on/off. + public static readonly Feature[] All = + { + new("taskbar", FeatureKind.Pref, new[] { "ReplaceTaskbar" }, true, "", "taskbar"), + new("dock", FeatureKind.Pref, new[] { "DockVisible" }, true, "", "dock"), + new("panels", FeatureKind.Locked, Array.Empty(), true, "", "dashboard"), + new("winjets", FeatureKind.Locked, Array.Empty(), true, "", null), + new("terminal", FeatureKind.Action, Array.Empty(), false, "", "terminal"), + new("pill", FeatureKind.Pref, new[] { "Pill" }, true, "", "media"), + new("rails", FeatureKind.Pref, new[] { "SocialRailVisible", "BookmarksRailVisible" }, true, "", null), + }; + + public static void Reset() + { + Ctx.Features = All.ToDictionary(f => f.Id, f => f.Default); + if (!Ctx.Info.Exists || Ctx.Screenshot) return; + try + { + if (File.Exists(Ctx.PrefsPath)) + { + var root = System.Text.Json.Nodes.JsonNode.Parse(File.ReadAllText(Ctx.PrefsPath), documentOptions: new JsonDocumentOptions { + AllowTrailingCommas = true })?.AsObject(); + foreach (var f in All.Where(f => f.Kind == FeatureKind.Pref)) + if (root != null && root.TryGetPropertyValue(f.Keys[0], out var n) && n != null) Ctx.Features[f.Id] = + n.GetValue(); + } + Ctx.Features["terminal"] = File.Exists(Path.Combine(Ctx.LocalApp, @"Winlestia\terminal-backup\state.json")); + } + catch (Exception e) { Log.Write("Could not read current settings: " + e.Message); } + } +} + +static class Loc +{ + static Dictionary en = new(), cur = new(); + public static string Lang = "en"; + public static readonly string[] Supported = { "en", "fr", "es", "de" }; + + static Dictionary Load(string lang) + { + string? json = null; + var ext = Path.Combine(AppContext.BaseDirectory, "Strings", lang + ".json"); + if (File.Exists(ext)) json = File.ReadAllText(ext); + else + { + using var s = Assembly.GetExecutingAssembly().GetManifestResourceStream("Strings/" + lang + ".json"); + if (s != null) json = new StreamReader(s).ReadToEnd(); + } + if (json == null) return new(); + return JsonSerializer.Deserialize>(json, new JsonSerializerOptions { AllowTrailingCommas = true, ReadCommentHandling = JsonCommentHandling.Skip }) + ?? new(); + } + + public static void Init(string? forced) + { + en = Load("en"); + Set((forced ?? CultureInfo.CurrentUICulture.TwoLetterISOLanguageName).ToLowerInvariant()); + } + + public static void Set(string lang) + { + Lang = lang; + cur = lang == "en" ? en : Load(lang); + } + + public static string T(string key) => cur.TryGetValue(key, out var v) ? v : en.TryGetValue(key, out var e) ? e : key; + public static string F(string key, params object[] a) => string.Format(T(key), a); + public static IEnumerable AllValues(string key) => + Supported.Select(l => Load(l)).Select(d => d.TryGetValue(key, out var v) ? v : null).Where(v => v != null).Cast() + .Distinct(); +} diff --git a/installer/WinlestiaSetup/Core/Native.cs b/installer/WinlestiaSetup/Core/Native.cs new file mode 100644 index 0000000..9015507 --- /dev/null +++ b/installer/WinlestiaSetup/Core/Native.cs @@ -0,0 +1,39 @@ +using System.Runtime.InteropServices; +using System.Text; +using System.Windows; +using System.Windows.Interop; +using System.Windows.Media; + +namespace WinlestiaSetup; + +static class Native +{ + [StructLayout(LayoutKind.Sequential)] struct Margins { public int L, R, T, B; } + [DllImport("dwmapi.dll")] static extern int DwmSetWindowAttribute(IntPtr h, int attr, ref int v, int size); + [DllImport("dwmapi.dll")] static extern int DwmExtendFrameIntoClientArea(IntPtr h, ref Margins m); + [DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern bool SystemParametersInfo(uint a, uint b, StringBuilder s, uint f); + + // Cadre sombre, coins arrondis et fond acrylique viennent de DWM, pas d'un dessin. + public static void ApplyGlass(Window w) + { + var h = new WindowInteropHelper(w).Handle; + if (h == IntPtr.Zero) return; + var src = HwndSource.FromHwnd(h); + if (src?.CompositionTarget != null) src.CompositionTarget.BackgroundColor = Colors.Transparent; + int v = 1; DwmSetWindowAttribute(h, 20, ref v, 4); // DWMWA_USE_IMMERSIVE_DARK_MODE + v = 2; DwmSetWindowAttribute(h, 33, ref v, 4); // DWMWA_WINDOW_CORNER_PREFERENCE = arrondi + var m = new Margins { L = -1, R = -1, T = -1, B = -1 }; + DwmExtendFrameIntoClientArea(h, ref m); + v = 3; // DWMWA_SYSTEMBACKDROP_TYPE = transitoire (acrylique) + if (DwmSetWindowAttribute(h, 38, ref v, 4) != 0) { v = 2; DwmSetWindowAttribute(h, 38, ref v, 4); } // Repli sur Mica + } + + public static string? WallpaperPath() + { + var sb = new StringBuilder(520); + if (SystemParametersInfo(0x73, 520, sb, 0) && File.Exists(sb.ToString())) return sb.ToString(); + var t = System.IO.Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), + @"Microsoft\Windows\Themes\TranscodedWallpaper"); + return File.Exists(t) ? t : null; + } +} diff --git a/installer/WinlestiaSetup/Core/Palette.cs b/installer/WinlestiaSetup/Core/Palette.cs new file mode 100644 index 0000000..23717e8 --- /dev/null +++ b/installer/WinlestiaSetup/Core/Palette.cs @@ -0,0 +1,62 @@ +using System.Windows; +using System.Windows.Media; +using System.Windows.Media.Imaging; + +namespace WinlestiaSetup; + +// Un seul accent, chaque surface teintée de la même teinte. La teinte vient du fond d'écran. +sealed class Palette +{ + public double Hue; public double Sat; + + static Color Hsl(double h, double s, double l, byte a = 255) + { + h = ((h % 360) + 360) % 360; double c = (1 - Math.Abs(2 * l - 1)) * s, x = c * (1 - Math.Abs(h / 60 % 2 - 1)), m = l - c / 2; + (double r, double g, double b) = h < 60 ? (c, x, 0.0) : h < 120 ? (x, c, 0.0) : h < 180 ? (0.0, c, x) : h < 240 ? (0.0, x, c) + : h < 300 ? (x, 0.0, c) : (c, 0.0, x); + return Color.FromArgb(a, (byte)Math.Round((r + m) * 255), (byte)Math.Round((g + m) * 255), (byte)Math.Round((b + m) * 255)); + } + + public static Palette FromWallpaper(string? path) + { + var fallback = new Palette { Hue = 12, Sat = 0.5 }; // teinte du primaire Winlestia par défaut + if (path == null || !File.Exists(path)) return fallback; + try + { + var bi = new BitmapImage(); + bi.BeginInit(); bi.UriSource = new Uri(path); bi.DecodePixelWidth = 48; bi.CacheOption = BitmapCacheOption.OnLoad; bi.EndInit(); + var fc = new FormatConvertedBitmap(bi, PixelFormats.Bgra32, null, 0); + int w = fc.PixelWidth, h = fc.PixelHeight; var px = new byte[w * h * 4]; fc.CopyPixels(px, w * 4, 0); + double sx = 0, sy = 0, sw = 0, ss = 0; + for (int i = 0; i < px.Length; i += 4) + { + double b = px[i] / 255.0, g = px[i + 1] / 255.0, r = px[i + 2] / 255.0, mx = Math.Max(r, Math.Max(g, b)), + mn = Math.Min(r, Math.Min(g, b)), d = mx - mn; + if (d < 0.02) continue; + double hue = mx == r ? 60 * (((g - b) / d + 6) % 6) : mx == g ? 60 * ((b - r) / d + 2) : 60 * ((r - g) / d + 4); + double s = d / mx, wt = s * mx; + sx += Math.Cos(hue * Math.PI / 180) * wt; sy += Math.Sin(hue * Math.PI / 180) * wt; sw += wt; ss += s * wt; + } + if (sw < 1e-3) return fallback; + return new Palette { Hue = (Math.Atan2(sy, sx) * 180 / Math.PI + 360) % 360, Sat = Math.Clamp(ss / sw, 0.4, 0.75) }; + } + catch { return fallback; } + } + + public Color Backdrop => Hsl(Hue, Sat * 0.5, 0.16); + + public void Apply(ResourceDictionary r) + { + void S(string k, Color c) { var b = new SolidColorBrush(c); b.Freeze(); r[k] = b; } + S("AccentBrush", Hsl(Hue, Math.Min(0.8, Sat + 0.15), 0.74)); + S("OnAccentBrush", Hsl(Hue, Sat, 0.11)); + S("SurfaceBrush", Hsl(Hue, Sat * 0.45, 0.08, 0xC8)); + S("SidebarBrush", Hsl(Hue, Sat * 0.5, 0.06, 0x8C)); + S("CardBrush", Hsl(Hue, Sat * 0.35, 0.22, 0x66)); + S("CardHoverBrush", Hsl(Hue, Sat * 0.4, 0.28, 0x80)); + S("TextBrush", Hsl(Hue, 0.25, 0.94)); + S("TextDimBrush", Hsl(Hue, 0.14, 0.70)); + S("OutlineBrush", Hsl(Hue, 0.22, 0.45, 0x80)); + S("AccentSoftBrush", Hsl(Hue, Math.Min(0.8, Sat + 0.15), 0.74, 0x2A)); + } +} diff --git a/installer/WinlestiaSetup/README.md b/installer/WinlestiaSetup/README.md new file mode 100644 index 0000000..37b5d93 --- /dev/null +++ b/installer/WinlestiaSetup/README.md @@ -0,0 +1,78 @@ +# WinlestiaSetup + +Custom installer for Winlestia. One window, no Windows chrome, DWM backdrop, animated step transitions. It replaces the Inno Setup wizard (`installer/Winlestia.iss` is kept). + +## Why WPF on .NET 8 + +- Same stack as the backend (C#, .NET 8). No new toolchain, and the project builds with the SDK already used for `src/backend`. +- Published self-contained and single file for win-x64: nothing to install first, no .NET runtime prerequisite on the target PC. +- WinUI 3 was considered. Unpackaged, it needs the Windows App SDK runtime or its bootstrapper on the target machine, which defeats a one-file installer. +- Qt or PySide would also work visually, but would add about 100 MB to an installer that is otherwise small. + +## Window and motion + +- Borderless window (`WindowChrome`, caption height 0). Backdrop through `DwmSetWindowAttribute`: `DWMWA_SYSTEMBACKDROP_TYPE` (38) set to acrylic, falling back to Mica, plus `DWMWA_WINDOW_CORNER_PREFERENCE` (33) for rounded corners and `DWMWA_USE_IMMERSIVE_DARK_MODE` (20). +- Palette derived from the wallpaper (dominant hue, one accent). Falls back to a fixed hue if the wallpaper cannot be read. `--wallpaper ` overrides it. +- Step transitions are one eased value (`CubicEase`, ease-out, 300 ms) driving a slide and a fade. They are skipped when `SystemParameters.ClientAreaAnimation` is off, or with `--no-motion`. +- The only looping animation is the progress bar while the installation runs. + +## Usage + +``` +WinlestiaSetup.exe install, or update/modify/uninstall chooser if an installation exists +WinlestiaSetup.exe --uninstall [--keep-data|--remove-data] [--from-shell] [--dry-run] +WinlestiaSetup.exe --dry-run full journey, writes nothing outside the log +WinlestiaSetup.exe --lang fr|en|es|de +WinlestiaSetup.exe --screenshots renders every screen to PNG, then exits +Other: --no-motion, --wallpaper +``` + +An existing installation is detected from the `Uninstall\Winlestia` key or the install folder. The welcome screen then shows the installed and new versions. + +## Payload + +`build-setup.ps1` runs `installer/build.ps1`, zips `build\payload` with the files the Inno script copied (license, notices, wallpapers, `Close-Winlestia.ps1`) into `payload.zip`, and publishes the setup. + +- `.\build-setup.ps1` puts `payload.zip` next to the exe. +- `.\build-setup.ps1 -Embed` embeds it in the exe. + +Without a payload the installer runs in demonstration mode: every screen works, nothing is installed. + +## Languages + +`Strings/.json` for fr, en, es, de. A missing key falls back to English. A `Strings` folder next to the exe overrides the embedded files. + +## Features and config keys + +| Feature | Key in `preferences-glass.json` | Default | +| --- | --- | --- | +| Windows taskbar replacement | `ReplaceTaskbar` | on | +| Dock | `DockVisible` | on | +| Panels | none | locked | +| Winjets | none | locked | +| Terminal | none (runs the terminal integration script) | off | +| Pill | `Pill` | on | +| Side rails | `SocialRailVisible`, `BookmarksRailVisible` | on | + +Panels and Winjets have no on/off key in the backend, so the installer shows them locked rather than pretending to control them. + +The update notification switch on the Updates screen is not wired: the shell has no release check yet, and the switch is disabled and labelled accordingly. + +## Uninstall safety + +- Order: restore the Windows taskbar and explorer.exe, remove the scheduled task, stop processes, undo the folder handler and terminal integration, clean the registry, remove shortcuts, move files, verify the taskbar is back. +- Nothing is deleted permanently. Folders go to the Recycle Bin (`SHFileOperation` with `FOF_ALLOWUNDO`). If that fails, the folder is left and reported. +- The program folder is removed only if it equals `%LOCALAPPDATA%\Programs\Winlestia` exactly (never a drive root). Data folders are the exact names `Panneaux` and `Winlestia` under `%LOCALAPPDATA%`, and only with `--remove-data`. +- The setup copies itself to `%TEMP%` and relaunches when started from the install folder. + +## Screenshots + +`--screenshots` uses `RenderTargetBitmap`, which cannot capture DWM effects, so the acrylic backdrop in those PNGs is simulated with the blurred wallpaper. The real window uses DWM. Output also includes 18 transition frames, six picked frames and a 6x slowed MP4/GIF (needs `ffmpeg` on PATH). + +## Limits + +- Not signed: SmartScreen warns. +- The sensors helper and PawnIO driver are not handled by the setup. +- The temporary copy of the uninstaller in `%TEMP%` remains after uninstalling. +- Inno `unins000` files of an earlier Inno install are left in place. +- Glyph icons come from Segoe Fluent Icons (Windows 11). diff --git a/installer/WinlestiaSetup/Strings/de.json b/installer/WinlestiaSetup/Strings/de.json new file mode 100644 index 0000000..0417026 --- /dev/null +++ b/installer/WinlestiaSetup/Strings/de.json @@ -0,0 +1,157 @@ +{ + "version": "Version {0}", + "badge.dry": "Testlauf: Es wird nichts auf dein System geschrieben. Ein Protokoll listet auf, was getan würde.", + "badge.demo": "Demonstration: keine Nutzlast gefunden, es wird nichts installiert.", + "demo.note": "Demomodus: keine payload.zip neben diesem Setup. Der gesamte Ablauf funktioniert, es wird nichts installiert.", + + "btn.back": "Zurück", "btn.next": "Weiter", "btn.install": "Installieren", "btn.update": "Aktualisieren", "btn.apply": "Übernehmen", + "btn.uninstall": "Deinstallieren", "btn.finish": "Fertig", + + "nav.welcome": "Willkommen", "nav.license": "Lizenz", "nav.features": "Funktionen", "nav.updates": "Updates", + "nav.install": "Installation", "nav.done": "Fertig", "nav.confirm": "Bestätigung", "nav.uninstall": "Deinstallation", + + "welcome.title": "Willkommen bei Winlestia", + "welcome.sub": "Eine ruhigere, schönere Oberfläche für Windows 11. Deine Dateien, Fenster und dein Hintergrundbild bleiben, wie sie sind; nur die Shell ändert sich.", + "welcome.b1": "Nur für dein Konto installiert, in deinem Benutzerordner. Keine Administratorrechte.", + "welcome.b2": "Auf deinem PC ändert sich nichts, bis du auf der Zusammenfassung bestätigst.", + "welcome.b3": "Du wählst, was Winlestia von Windows ersetzt, und kannst es später ändern.", + "welcome.b4": "Die Windows-Taskleiste lässt sich jederzeit mit einer einzigen Verknüpfung zurückholen.", + "welcome.title.installed": "Winlestia ist bereits installiert", + "welcome.sub.installed": "Wähle, was du tun möchtest. Es ändert sich nichts, bevor du bestätigst.", + "welcome.found": "Installiert in {0}", + "welcome.update": "Aktualisieren", + "welcome.reinstall": "Diese Version neu installieren", + "welcome.update.d": "Ersetzt die Programmdateien, behält deine Einstellungen und sichert die vorherige Version.", + "welcome.modify": "Funktionen ändern", + "welcome.modify.d": "Schaltet Teile von Winlestia ein oder aus. Die Programmdateien bleiben unberührt.", + "welcome.uninstall": "Deinstallieren", + "welcome.uninstall.d": "Stellt zuerst die Windows-Taskleiste wieder her und entfernt dann Winlestia. Du entscheidest, was mit deinen Daten geschieht.", + + "license.title": "Lizenz", + "license.sub": "Zur Information. Zum Installieren musst du nichts akzeptieren.", + "license.b1": "Winlestia ist freie Software und steht unter der GNU General Public License v3.0.", + "license.b2": "Sie ist kostenlos. Du darfst sie nutzen, untersuchen, ändern und unter derselben Lizenz weitergeben.", + "license.b3": "Sie wird ohne Gewährleistung geliefert, soweit das Gesetz es zulässt.", + "license.b4": "Sie ist ein Fork von Caelestia und behält dessen GPL-3.0-Lizenz und Nennungen.", + + "features.title": "Funktionen", + "features.sub": "Wähle, was Winlestia ersetzt. Die Auswahl wird bei der Installation in die Einstellungen geschrieben.", + "state.on": "An", "state.off": "Aus", "state.always": "Immer an", + "when.on": "WENN AN", "when.off": "WENN AUS", + "feat.key": "Einstellung: {0}", + "feat.action": "Installationsaktion, keine Einstellung: führt das Skript für die Terminal-Integration aus.", + "feat.nokey": "Dafür gibt es keine Einstellung: Das Setup kann es nicht ausschalten.", + + "feat.taskbar.name": "Windows-Taskleiste", + "feat.taskbar.desc": "Winlestia kann die Windows-Taskleiste ausblenden und ihren Platz einnehmen.", + "feat.taskbar.on": "Die Windows-Taskleiste ist ausgeblendet, solange Winlestia läuft. Sie kommt zurück, wenn du Winlestia beendest.", + "feat.taskbar.off": "Die Windows-Taskleiste bleibt, wo sie ist. Winlestia läuft daneben.", + "feat.dock.name": "Dock", + "feat.dock.desc": "Die Leiste am unteren Rand: angeheftete Apps, laufende Apps, Systemstatus.", + "feat.dock.on": "Das Dock erscheint, wenn du den Zeiger an den unteren Rand bewegst, und verschwindet wieder.", + "feat.dock.off": "Kein Dock. Apps öffnest du über die Befehlspalette (Strg+F2) oder den Starter.", + "feat.panels.name": "Panels", + "feat.panels.desc": "Dashboard, Benachrichtigungen, Starter, Schnellsteuerung und Befehlspalette.", + "feat.panels.locked": "Diese Panels sind der Kern von Winlestia und haben keine Ein/Aus-Einstellung, deshalb ist der Schalter gesperrt. Öffne sie mit Strg+F1 (Dashboard) und Strg+F2 (Befehlspalette).", + "feat.winjets.name": "Winjets", + "feat.winjets.desc": "Desktop-Widgets hinter deinen Fenstern: Uhr, Kalender, Akku, Märkte, Player.", + "feat.winjets.locked": "Winjets haben keine globale Ein/Aus-Einstellung. Sechs Pakete werden installiert, und keines liegt auf deinem Desktop, bis du in Einstellungen, Winjets eines hinzufügst.", + "feat.terminal.name": "Terminal", + "feat.terminal.desc": "Winlestia-Farben für Eingabeaufforderung und PowerShell, passend zu deinem Hintergrundbild.", + "feat.terminal.on": "Wendet das Design über Clink an und ergänzt PowerShell-Profile. Braucht eine Internetverbindung (Clink-Download). Umkehrbar.", + "feat.terminal.off": "Deine Terminals bleiben, wie sie sind. War die Integration aktiv, wird sie entfernt.", + "feat.pill.name": "Pille", + "feat.pill.desc": "Eine Kapsel am oberen Bildschirmrand, die nur erscheint, wenn etwas passiert.", + "feat.pill.on": "Musik, Lautstärke, Helligkeit und Mikrofon erscheinen in der Pille, danach verschwindet sie.", + "feat.pill.off": "Keine Pille. Stattdessen wird die Randanzeige verwendet.", + "feat.rails.name": "Seitenleisten", + "feat.rails.desc": "Leisten für soziale Netzwerke und Lesezeichen am Bildschirmrand.", + "feat.rails.on": "Beide Leisten sind am Bildschirmrand verfügbar.", + "feat.rails.off": "Keine Leisten. Lesezeichen und Nachrichten erscheinen nicht am Bildschirmrand.", + + "updates.title": "Updates", + "updates.sub": "Winlestia aktualisiert sich nie von selbst im Hintergrund. Du entscheidest, wann.", + "updates.how": "So funktioniert ein Update", + "updates.s1": "Lade das neue Setup herunter und starte es. Es erkennt die vorhandene Installation und zeigt die installierte und die neue Version.", + "updates.s2": "Es sichert die vorherige Version in %LOCALAPPDATA%\\Programs\\Winlestia-backups, damit du zurückgehen kannst.", + "updates.s3": "Deine Einstellungen und dein Profil bleiben erhalten. Die Shell wird beendet, Dateien werden ersetzt, danach kannst du sie neu starten.", + "updates.s4": "Kein stilles Update, kein Hintergrunddienst, keine Prüfung, die du nicht angefordert hast.", + "updates.notify": "Über neue Versionen informieren", + "updates.pending": "Noch nicht angebunden", + "updates.notify.d": "Würde die GitHub-Releases von lilidoxdev/winlestia abfragen. Die Shell hat diese Prüfung noch nicht, daher tut der Schalter vorerst nichts.", + + "summary.title": "Bereit", + "summary.sub": "Prüfe die Liste. Es hat sich noch nichts geändert.", + "summary.install": "Winlestia {0} installieren", + "summary.update": "Winlestia aktualisieren", + "summary.modify": "Deine Funktionsauswahl übernehmen", + "summary.where": "Ordner: {0}", + "summary.backup": "Die vorherige Version wird in einem Sicherungsordner aufbewahrt.", + "summary.fresh": "Erstinstallation: nichts zu sichern.", + "summary.close": "Die laufende Winlestia-Shell wird zuerst beendet.", + "summary.nothing": "Es wird nichts geändert, bevor du unten auf die Schaltfläche klickst.", + + "progress.title": "Installation läuft", + "progress.sub": "Das dauert eine Minute. Lass dieses Fenster geöffnet.", + "progress.title.u": "Deinstallation läuft", + "progress.sub.u": "Die Windows-Taskleiste kommt zuerst zurück.", + + "step.close": "Aktuelle Shell wird beendet", + "step.backup": "Vorherige Version wird gesichert", + "step.copy": "Programmdateien werden kopiert", + "step.config": "Deine Funktionsauswahl wird geschrieben", + "step.terminal": "Terminal-Integration", + "step.task": "Anmeldeaufgabe wird erstellt", + "step.shortcuts": "Startmenü-Verknüpfungen werden erstellt", + "step.registry": "Eintrag in Installierte Apps", + "step.restore": "Taskleiste und explorer.exe werden wiederhergestellt", + "step.utask": "Anmeldeaufgabe wird entfernt", + "step.stop": "Winlestia-Prozesse werden beendet", + "step.undo": "Ordner-Handler und Terminal werden zurückgesetzt", + "step.uregistry": "Registrierung wird bereinigt", + "step.ushortcuts": "Verknüpfungen werden entfernt", + "step.files": "Dateien werden in den Papierkorb verschoben", + "step.verify": "Prüfung, ob Windows wieder da ist", + + "done.title": "Winlestia ist installiert", + "done.modify": "Änderungen übernommen", + "done.sub": "Starte es jetzt oder melde dich ab und wieder an. Es startet bei der Anmeldung.", + "done.launch": "Winlestia jetzt starten", + "done.demo": "Demonstration: Es wurde nichts installiert.", + "done.dry": "Testlauf: Es wurde nichts geschrieben. Das Protokoll liegt in deinem Temp-Ordner.", + "done.failed": "Etwas ist schiefgegangen", + "done.failed.sub": "Die Installation wurde abgebrochen. Deine vorherige Version, falls vorhanden, liegt im Sicherungsordner.", + "done.failed.d": "Fehler: {0}", + "safety.title": "Wenn etwas nicht stimmt", + "safety.s1": "Drücke Strg+Alt+Rücktaste: Winlestia beendet sich und die Windows-Taskleiste kehrt zurück.", + "safety.s2": "Startmenü: „Windows-Taskleiste wiederherstellen“.", + "safety.s3": "Im Terminal: {0}", + "safety.s4": "Oder deinstalliere unter Einstellungen, Apps, Installierte Apps.", + + "uconfirm.title": "Winlestia deinstallieren?", + "uconfirm.sub": "Windows ist danach wieder wie vorher. Das passiert genau.", + "uconfirm.guarantees": "Zusicherungen", + "uconfirm.g1": "Windows-Taskleiste und explorer.exe werden zuerst wiederhergestellt und am Ende geprüft.", + "uconfirm.g2": "Nichts wird endgültig gelöscht. Dateien gehen in den Papierkorb.", + "uconfirm.g3": "Als Programmordner wird nur {0} entfernt. Jeder andere Pfad wird abgelehnt.", + "uconfirm.g4": "Lässt sich ein Ordner nicht in den Papierkorb verschieben, bleibt er bestehen und du wirst informiert.", + "uconfirm.keep": "Meine Daten behalten", + "uconfirm.keep.d": "Einstellungen, Profil, Hintergründe und Winjets in %LOCALAPPDATA%\\Panneaux und \\Winlestia bleiben.", + "uconfirm.remove": "Auch meine Daten entfernen", + "uconfirm.remove.d": "Die Ordner Panneaux, Winlestia und „Panneaux · Caelestia Windows“ in %LOCALAPPDATA% sowie der Ordner Winlestia-backups kommen in den Papierkorb.", + "done.u.title": "Winlestia ist deinstalliert", + "done.u.sub": "Windows nutzt wieder seine eigene Oberfläche.", + "done.u.taskbar": "Die Windows-Taskleiste ist zurück.", + "done.u.taskbar.no": "Die Taskleiste konnte nicht bestätigt werden. Melde dich ab und wieder an, falls sie fehlt.", + "done.u.data.kept": "Deine Daten wurden behalten.", + "done.u.data.removed": "Deine Daten wurden in den Papierkorb verschoben.", + "done.u.bin": "Stelle alles aus dem Papierkorb wieder her, wenn du es dir anders überlegst.", + + "warn.terminal": "Die Terminal-Integration konnte nicht geändert werden. Siehe das Setup-Protokoll in deinem Temp-Ordner.", + "warn.terminalMissing": "Die Dateien der Terminal-Integration fehlen: Dieser Schritt wurde übersprungen.", + "warn.noTaskbar": "Die Windows-Taskleiste ist nicht zurückgekehrt. Melde dich ab und wieder an oder starte explorer.exe.", + "warn.left": "Nicht entfernt, bitte selbst löschen: {0}", + + "sc.restore": "Windows-Taskleiste wiederherstellen", + "sc.uninstall": "Winlestia deinstallieren" +} diff --git a/installer/WinlestiaSetup/Strings/en.json b/installer/WinlestiaSetup/Strings/en.json new file mode 100644 index 0000000..6ca6eb4 --- /dev/null +++ b/installer/WinlestiaSetup/Strings/en.json @@ -0,0 +1,157 @@ +{ + "version": "Version {0}", + "badge.dry": "Dry run: nothing is written to your system. A log lists what would be done.", + "badge.demo": "Demonstration: no payload found, nothing will be installed.", + "demo.note": "Demonstration mode: no payload.zip next to this setup. The whole journey works, nothing is installed.", + + "btn.back": "Back", "btn.next": "Next", "btn.install": "Install", "btn.update": "Update", "btn.apply": "Apply changes", + "btn.uninstall": "Uninstall", "btn.finish": "Finish", + + "nav.welcome": "Welcome", "nav.license": "License", "nav.features": "Features", "nav.updates": "Updates", + "nav.install": "Installation", "nav.done": "Done", "nav.confirm": "Confirmation", "nav.uninstall": "Uninstall", + + "welcome.title": "Welcome to Winlestia", + "welcome.sub": "A calmer, better looking surface for Windows 11. Your files, windows and wallpaper stay as they are; only the shell changes.", + "welcome.b1": "Installed for your account only, in your user folder. No administrator rights.", + "welcome.b2": "Nothing changes on your PC until you confirm on the summary screen.", + "welcome.b3": "You choose which parts of Windows Winlestia replaces, and you can change it later.", + "welcome.b4": "The Windows taskbar can always be brought back, with one shortcut.", + "welcome.title.installed": "Winlestia is already installed", + "welcome.sub.installed": "Choose what to do. Nothing changes until you confirm.", + "welcome.found": "Installed in {0}", + "welcome.update": "Update", + "welcome.reinstall": "Reinstall this version", + "welcome.update.d": "Replaces the program files, keeps your settings and keeps a copy of the previous version.", + "welcome.modify": "Change features", + "welcome.modify.d": "Turn parts of Winlestia on or off. Program files are not touched.", + "welcome.uninstall": "Uninstall", + "welcome.uninstall.d": "Restores the Windows taskbar first, then removes Winlestia. You choose what happens to your data.", + + "license.title": "License", + "license.sub": "For information. You do not need to accept anything to install.", + "license.b1": "Winlestia is free software, published under the GNU General Public License v3.0.", + "license.b2": "It is free of charge. You may use, study, change and share it under the same license.", + "license.b3": "It comes with no warranty, to the extent permitted by law.", + "license.b4": "It is a fork of Caelestia and keeps its GPL-3.0 license and credits.", + + "features.title": "Features", + "features.sub": "Pick what Winlestia replaces. The choice is written to its settings at install time.", + "state.on": "On", "state.off": "Off", "state.always": "Always on", + "when.on": "WHEN ON", "when.off": "WHEN OFF", + "feat.key": "Setting: {0}", + "feat.action": "Install action, not a setting: runs the terminal integration script.", + "feat.nokey": "No setting exists for this: it cannot be turned off from the installer.", + + "feat.taskbar.name": "Windows taskbar", + "feat.taskbar.desc": "Winlestia can hide the Windows taskbar and take its place.", + "feat.taskbar.on": "The Windows taskbar is hidden while Winlestia runs. It comes back when you quit Winlestia.", + "feat.taskbar.off": "The Windows taskbar stays where it is. Winlestia runs next to it.", + "feat.dock.name": "Dock", + "feat.dock.desc": "The bar at the bottom edge: pinned apps, running apps, system status.", + "feat.dock.on": "The dock appears when you move the pointer to the bottom edge, and hides again.", + "feat.dock.off": "No dock. You open apps from the command palette (Ctrl+F2) or the launcher.", + "feat.panels.name": "Panels", + "feat.panels.desc": "Dashboard, notifications, launcher, quick controls and command palette.", + "feat.panels.locked": "These panels are the core of Winlestia and have no on/off setting, so the switch is locked. Open them with Ctrl+F1 (dashboard) and Ctrl+F2 (command palette).", + "feat.winjets.name": "Winjets", + "feat.winjets.desc": "Desktop widgets placed behind your windows: clock, calendar, battery, markets, player.", + "feat.winjets.locked": "Winjets have no global on/off setting. Six packages are installed and none is placed on your desktop until you add one in Settings, Winjets.", + "feat.terminal.name": "Terminal", + "feat.terminal.desc": "Winlestia colours for Command Prompt and PowerShell, following your wallpaper.", + "feat.terminal.on": "Applies the theme through Clink and adds PowerShell profile entries. Needs an Internet connection (Clink download). Reversible.", + "feat.terminal.off": "Your terminals are left as they are. If the integration was on, it is removed.", + "feat.pill.name": "Pill", + "feat.pill.desc": "A capsule at the top of the screen that shows up only when something happens.", + "feat.pill.on": "Music, volume, brightness and microphone changes appear in the pill, then it disappears.", + "feat.pill.off": "No pill. The edge indicator is used instead.", + "feat.rails.name": "Side rails", + "feat.rails.desc": "Social and bookmarks rails at the screen edge.", + "feat.rails.on": "Both rails are available at the edge of the screen.", + "feat.rails.off": "No rails. Bookmarks and messages are not shown at the screen edge.", + + "updates.title": "Updates", + "updates.sub": "Winlestia never updates itself in the background. You decide when.", + "updates.how": "How updating works", + "updates.s1": "Download the new setup and run it. It finds the existing installation and shows the installed and the new version.", + "updates.s2": "It keeps a copy of the previous version in %LOCALAPPDATA%\\Programs\\Winlestia-backups, so you can go back.", + "updates.s3": "Your settings and profile are kept. The shell is closed, files are replaced, then you can start it again.", + "updates.s4": "No silent update, no background service, no check you did not ask for.", + "updates.notify": "Tell me about new versions", + "updates.pending": "Not wired yet", + "updates.notify.d": "Would check GitHub Releases for lilidoxdev/winlestia. The shell has no such check yet, so this switch does nothing for now.", + + "summary.title": "Ready to go", + "summary.sub": "Check the list. Nothing has changed yet.", + "summary.install": "Install Winlestia {0}", + "summary.update": "Update Winlestia", + "summary.modify": "Apply your feature choices", + "summary.where": "Folder: {0}", + "summary.backup": "The previous version is kept in a backup folder.", + "summary.fresh": "Fresh install: nothing to back up.", + "summary.close": "The running Winlestia shell is closed first.", + "summary.nothing": "Nothing is changed before you click the button below.", + + "progress.title": "Installing", + "progress.sub": "This takes a minute. Please keep this window open.", + "progress.title.u": "Uninstalling", + "progress.sub.u": "The Windows taskbar comes back first.", + + "step.close": "Closing the current shell", + "step.backup": "Keeping the previous version", + "step.copy": "Copying program files", + "step.config": "Writing your feature choices", + "step.terminal": "Terminal integration", + "step.task": "Creating the sign-in task", + "step.shortcuts": "Creating Start menu shortcuts", + "step.registry": "Adding to Installed apps", + "step.restore": "Restoring the Windows taskbar and explorer.exe", + "step.utask": "Removing the sign-in task", + "step.stop": "Stopping Winlestia processes", + "step.undo": "Undoing folder handler and terminal integration", + "step.uregistry": "Cleaning the registry", + "step.ushortcuts": "Removing shortcuts", + "step.files": "Sending files to the Recycle Bin", + "step.verify": "Checking that Windows is back", + + "done.title": "Winlestia is installed", + "done.modify": "Changes applied", + "done.sub": "Start it now, or sign out and in again. It starts at sign-in.", + "done.launch": "Start Winlestia now", + "done.demo": "Demonstration: nothing was installed.", + "done.dry": "Dry run: nothing was written. See the log in your temp folder.", + "done.failed": "Something went wrong", + "done.failed.sub": "The installation stopped. Your previous version, if any, is in the backup folder.", + "done.failed.d": "Error: {0}", + "safety.title": "If something looks wrong", + "safety.s1": "Press Ctrl+Alt+Backspace: Winlestia quits and the Windows taskbar returns.", + "safety.s2": "Start menu: \"Restore the Windows taskbar\".", + "safety.s3": "From a terminal: {0}", + "safety.s4": "Or uninstall from Settings, Apps, Installed apps.", + + "uconfirm.title": "Uninstall Winlestia?", + "uconfirm.sub": "Windows comes back as it was. Here is exactly what will happen.", + "uconfirm.guarantees": "Guarantees", + "uconfirm.g1": "The Windows taskbar and explorer.exe are restored first, and checked at the end.", + "uconfirm.g2": "Nothing is deleted for good. Files go to the Recycle Bin.", + "uconfirm.g3": "The only program folder removed is {0}. Any other path is refused.", + "uconfirm.g4": "If a folder cannot be sent to the Recycle Bin, it is left in place and you are told.", + "uconfirm.keep": "Keep my data", + "uconfirm.keep.d": "Settings, profile, wallpapers and Winjets in %LOCALAPPDATA%\\Panneaux and \\Winlestia stay.", + "uconfirm.remove": "Remove my data too", + "uconfirm.remove.d": "The folders Panneaux, Winlestia and \"Panneaux · Caelestia Windows\" in %LOCALAPPDATA%, plus the Winlestia-backups folder, go to the Recycle Bin.", + "done.u.title": "Winlestia is uninstalled", + "done.u.sub": "Windows is back to its own shell.", + "done.u.taskbar": "The Windows taskbar is back.", + "done.u.taskbar.no": "The taskbar could not be confirmed. Sign out and in again if it is missing.", + "done.u.data.kept": "Your data was kept.", + "done.u.data.removed": "Your data was sent to the Recycle Bin.", + "done.u.bin": "Restore anything from the Recycle Bin if you change your mind.", + + "warn.terminal": "The terminal integration could not be changed. See the setup log in your temp folder.", + "warn.terminalMissing": "The terminal integration files are missing: this step was skipped.", + "warn.noTaskbar": "The Windows taskbar did not come back. Sign out and in again, or run explorer.exe.", + "warn.left": "Left in place, to remove yourself: {0}", + + "sc.restore": "Restore the Windows taskbar", + "sc.uninstall": "Uninstall Winlestia" +} diff --git a/installer/WinlestiaSetup/Strings/es.json b/installer/WinlestiaSetup/Strings/es.json new file mode 100644 index 0000000..b4dbdda --- /dev/null +++ b/installer/WinlestiaSetup/Strings/es.json @@ -0,0 +1,157 @@ +{ + "version": "Versión {0}", + "badge.dry": "Simulación: no se escribe nada en tu sistema. Un registro lista lo que se haría.", + "badge.demo": "Demostración: no se encontró la carga útil, no se instalará nada.", + "demo.note": "Modo demostración: no hay payload.zip junto a este instalador. Todo el recorrido funciona, no se instala nada.", + + "btn.back": "Atrás", "btn.next": "Siguiente", "btn.install": "Instalar", "btn.update": "Actualizar", "btn.apply": "Aplicar", + "btn.uninstall": "Desinstalar", "btn.finish": "Finalizar", + + "nav.welcome": "Bienvenida", "nav.license": "Licencia", "nav.features": "Funciones", "nav.updates": "Actualizaciones", + "nav.install": "Instalación", "nav.done": "Listo", "nav.confirm": "Confirmación", "nav.uninstall": "Desinstalación", + + "welcome.title": "Te damos la bienvenida a Winlestia", + "welcome.sub": "Una superficie más tranquila y más bonita para Windows 11. Tus archivos, ventanas y fondo de pantalla se quedan como están; solo cambia la interfaz.", + "welcome.b1": "Se instala solo para tu cuenta, en tu carpeta de usuario. Sin permisos de administrador.", + "welcome.b2": "No cambia nada en tu PC hasta que confirmes en la pantalla de resumen.", + "welcome.b3": "Eliges qué partes de Windows reemplaza Winlestia, y puedes cambiarlo después.", + "welcome.b4": "La barra de tareas de Windows se puede recuperar siempre, con un solo acceso directo.", + "welcome.title.installed": "Winlestia ya está instalado", + "welcome.sub.installed": "Elige qué quieres hacer. No cambia nada hasta que confirmes.", + "welcome.found": "Instalado en {0}", + "welcome.update": "Actualizar", + "welcome.reinstall": "Reinstalar esta versión", + "welcome.update.d": "Reemplaza los archivos del programa, conserva tus ajustes y guarda una copia de la versión anterior.", + "welcome.modify": "Cambiar las funciones", + "welcome.modify.d": "Activa o desactiva partes de Winlestia. Los archivos del programa no se tocan.", + "welcome.uninstall": "Desinstalar", + "welcome.uninstall.d": "Primero restaura la barra de tareas de Windows y luego quita Winlestia. Tú decides qué pasa con tus datos.", + + "license.title": "Licencia", + "license.sub": "A título informativo. No tienes que aceptar nada para instalar.", + "license.b1": "Winlestia es software libre, publicado bajo la licencia GNU GPL v3.0.", + "license.b2": "Es gratuito. Puedes usarlo, estudiarlo, modificarlo y compartirlo bajo la misma licencia.", + "license.b3": "Se entrega sin garantía, en la medida que permita la ley.", + "license.b4": "Es un fork de Caelestia y mantiene su licencia GPL-3.0 y sus créditos.", + + "features.title": "Funciones", + "features.sub": "Elige qué reemplaza Winlestia. La elección se escribe en sus ajustes al instalar.", + "state.on": "Activada", "state.off": "Desactivada", "state.always": "Siempre activa", + "when.on": "ACTIVADA", "when.off": "DESACTIVADA", + "feat.key": "Ajuste: {0}", + "feat.action": "Acción de instalación, no un ajuste: ejecuta el script de integración del terminal.", + "feat.nokey": "No existe ningún ajuste para esto: el instalador no puede desactivarlo.", + + "feat.taskbar.name": "Barra de tareas de Windows", + "feat.taskbar.desc": "Winlestia puede ocultar la barra de tareas de Windows y ocupar su lugar.", + "feat.taskbar.on": "La barra de tareas de Windows se oculta mientras Winlestia está en marcha. Vuelve al cerrar Winlestia.", + "feat.taskbar.off": "La barra de tareas de Windows se queda donde está. Winlestia funciona a su lado.", + "feat.dock.name": "Dock", + "feat.dock.desc": "La barra del borde inferior: apps ancladas, apps abiertas, estado del sistema.", + "feat.dock.on": "El dock aparece al llevar el puntero al borde inferior y se vuelve a ocultar.", + "feat.dock.off": "Sin dock. Abres las apps desde la paleta de comandos (Ctrl+F2) o el lanzador.", + "feat.panels.name": "Paneles", + "feat.panels.desc": "Panel de control, notificaciones, lanzador, controles rápidos y paleta de comandos.", + "feat.panels.locked": "Estos paneles son el núcleo de Winlestia y no tienen ajuste de activar/desactivar, así que el interruptor está bloqueado. Ábrelos con Ctrl+F1 (panel de control) y Ctrl+F2 (paleta de comandos).", + "feat.winjets.name": "Winjets", + "feat.winjets.desc": "Widgets de escritorio colocados detrás de tus ventanas: reloj, calendario, batería, mercados, reproductor.", + "feat.winjets.locked": "Los Winjets no tienen un ajuste global de activar/desactivar. Se instalan seis paquetes y ninguno se coloca en tu escritorio hasta que añadas uno en Ajustes, Winjets.", + "feat.terminal.name": "Terminal", + "feat.terminal.desc": "Los colores de Winlestia para el símbolo del sistema y PowerShell, que siguen tu fondo de pantalla.", + "feat.terminal.on": "Aplica el tema con Clink y añade entradas a los perfiles de PowerShell. Necesita conexión a Internet (descarga de Clink). Reversible.", + "feat.terminal.off": "Tus terminales se quedan como están. Si la integración estaba activa, se retira.", + "feat.pill.name": "Píldora", + "feat.pill.desc": "Una cápsula en la parte superior de la pantalla que solo aparece cuando pasa algo.", + "feat.pill.on": "La música, el volumen, el brillo y el micrófono aparecen en la píldora y luego desaparece.", + "feat.pill.off": "Sin píldora. Se usa el indicador del borde.", + "feat.rails.name": "Rieles laterales", + "feat.rails.desc": "Rieles de redes sociales y de marcadores en el borde de la pantalla.", + "feat.rails.on": "Los dos rieles están disponibles en el borde de la pantalla.", + "feat.rails.off": "Sin rieles. Los marcadores y los mensajes no se muestran en el borde de la pantalla.", + + "updates.title": "Actualizaciones", + "updates.sub": "Winlestia nunca se actualiza solo en segundo plano. Tú decides cuándo.", + "updates.how": "Cómo funciona una actualización", + "updates.s1": "Descarga el nuevo instalador y ejecútalo. Detecta la instalación existente y muestra la versión instalada y la nueva.", + "updates.s2": "Guarda una copia de la versión anterior en %LOCALAPPDATA%\\Programs\\Winlestia-backups, para que puedas volver atrás.", + "updates.s3": "Tus ajustes y tu perfil se conservan. Se cierra el shell, se reemplazan los archivos y luego puedes iniciarlo de nuevo.", + "updates.s4": "Sin actualización silenciosa, sin servicio en segundo plano, sin comprobaciones que no hayas pedido.", + "updates.notify": "Avisarme de nuevas versiones", + "updates.pending": "Por conectar", + "updates.notify.d": "Consultaría las versiones de GitHub de lilidoxdev/winlestia. El shell aún no tiene esa comprobación, así que este interruptor no hace nada por ahora.", + + "summary.title": "Todo listo", + "summary.sub": "Revisa la lista. Todavía no ha cambiado nada.", + "summary.install": "Instalar Winlestia {0}", + "summary.update": "Actualizar Winlestia", + "summary.modify": "Aplicar tus elecciones de funciones", + "summary.where": "Carpeta: {0}", + "summary.backup": "La versión anterior se guarda en una carpeta de copia de seguridad.", + "summary.fresh": "Primera instalación: nada que respaldar.", + "summary.close": "Primero se cierra el shell de Winlestia en ejecución.", + "summary.nothing": "No se cambia nada hasta que pulses el botón de abajo.", + + "progress.title": "Instalando", + "progress.sub": "Tarda un minuto. Mantén esta ventana abierta.", + "progress.title.u": "Desinstalando", + "progress.sub.u": "La barra de tareas de Windows vuelve primero.", + + "step.close": "Cerrando el shell actual", + "step.backup": "Guardando la versión anterior", + "step.copy": "Copiando los archivos del programa", + "step.config": "Escribiendo tus elecciones de funciones", + "step.terminal": "Integración del terminal", + "step.task": "Creando la tarea de inicio de sesión", + "step.shortcuts": "Creando los accesos directos del menú Inicio", + "step.registry": "Añadiendo a Aplicaciones instaladas", + "step.restore": "Restaurando la barra de tareas y explorer.exe", + "step.utask": "Quitando la tarea de inicio de sesión", + "step.stop": "Deteniendo los procesos de Winlestia", + "step.undo": "Quitando el gestor de carpetas y el terminal", + "step.uregistry": "Limpiando el registro", + "step.ushortcuts": "Quitando los accesos directos", + "step.files": "Enviando archivos a la Papelera", + "step.verify": "Comprobando que Windows ha vuelto", + + "done.title": "Winlestia está instalado", + "done.modify": "Cambios aplicados", + "done.sub": "Inícialo ahora, o cierra y vuelve a abrir sesión. Arranca al iniciar sesión.", + "done.launch": "Iniciar Winlestia ahora", + "done.demo": "Demostración: no se instaló nada.", + "done.dry": "Simulación: no se escribió nada. El registro está en tu carpeta temporal.", + "done.failed": "Algo ha salido mal", + "done.failed.sub": "La instalación se detuvo. Tu versión anterior, si la había, está en la carpeta de copia de seguridad.", + "done.failed.d": "Error: {0}", + "safety.title": "Si algo no va bien", + "safety.s1": "Pulsa Ctrl+Alt+Retroceso: Winlestia se cierra y vuelve la barra de tareas de Windows.", + "safety.s2": "Menú Inicio: «Restaurar la barra de tareas de Windows».", + "safety.s3": "Desde un terminal: {0}", + "safety.s4": "O desinstala desde Configuración, Aplicaciones, Aplicaciones instaladas.", + + "uconfirm.title": "¿Desinstalar Winlestia?", + "uconfirm.sub": "Windows vuelve a ser como antes. Esto es exactamente lo que va a pasar.", + "uconfirm.guarantees": "Garantías", + "uconfirm.g1": "La barra de tareas de Windows y explorer.exe se restauran primero y se comprueban al final.", + "uconfirm.g2": "No se borra nada de forma definitiva. Los archivos van a la Papelera.", + "uconfirm.g3": "La única carpeta de programa que se quita es {0}. Cualquier otra ruta se rechaza.", + "uconfirm.g4": "Si una carpeta no puede ir a la Papelera, se deja donde está y se te avisa.", + "uconfirm.keep": "Conservar mis datos", + "uconfirm.keep.d": "Ajustes, perfil, fondos y Winjets en %LOCALAPPDATA%\\Panneaux y \\Winlestia se quedan.", + "uconfirm.remove": "Eliminar también mis datos", + "uconfirm.remove.d": "Las carpetas Panneaux, Winlestia y «Panneaux · Caelestia Windows» de %LOCALAPPDATA%, y la carpeta Winlestia-backups, van a la Papelera.", + "done.u.title": "Winlestia está desinstalado", + "done.u.sub": "Windows vuelve a su propia interfaz.", + "done.u.taskbar": "La barra de tareas de Windows ha vuelto.", + "done.u.taskbar.no": "No se pudo confirmar la barra de tareas. Cierra y abre sesión si falta.", + "done.u.data.kept": "Tus datos se conservaron.", + "done.u.data.removed": "Tus datos se enviaron a la Papelera.", + "done.u.bin": "Restaura lo que quieras desde la Papelera si cambias de opinión.", + + "warn.terminal": "No se pudo cambiar la integración del terminal. Consulta el registro del instalador en tu carpeta temporal.", + "warn.terminalMissing": "Faltan los archivos de integración del terminal: se omitió este paso.", + "warn.noTaskbar": "La barra de tareas de Windows no ha vuelto. Cierra y abre sesión, o ejecuta explorer.exe.", + "warn.left": "Se dejó en su sitio, para quitarlo tú: {0}", + + "sc.restore": "Restaurar la barra de tareas de Windows", + "sc.uninstall": "Desinstalar Winlestia" +} diff --git a/installer/WinlestiaSetup/Strings/fr.json b/installer/WinlestiaSetup/Strings/fr.json new file mode 100644 index 0000000..7ded48c --- /dev/null +++ b/installer/WinlestiaSetup/Strings/fr.json @@ -0,0 +1,157 @@ +{ + "version": "Version {0}", + "badge.dry": "Simulation : rien n'est écrit sur ton système. Un journal liste ce qui serait fait.", + "badge.demo": "Démonstration : aucune charge utile trouvée, rien ne sera installé.", + "demo.note": "Mode démonstration : pas de payload.zip à côté de cet installateur. Tout le parcours fonctionne, rien n'est installé.", + + "btn.back": "Retour", "btn.next": "Suivant", "btn.install": "Installer", "btn.update": "Mettre à jour", "btn.apply": "Appliquer", + "btn.uninstall": "Désinstaller", "btn.finish": "Terminer", + + "nav.welcome": "Accueil", "nav.license": "Licence", "nav.features": "Fonctions", "nav.updates": "Mises à jour", + "nav.install": "Installation", "nav.done": "Terminé", "nav.confirm": "Confirmation", "nav.uninstall": "Désinstallation", + + "welcome.title": "Bienvenue dans Winlestia", + "welcome.sub": "Une surface plus calme et plus belle pour Windows 11. Tes fichiers, tes fenêtres et ton fond d'écran restent en place ; seule l'interface change.", + "welcome.b1": "Installé pour ton compte seulement, dans ton dossier utilisateur. Aucun droit administrateur.", + "welcome.b2": "Rien ne change sur ton PC avant que tu valides l'écran de récapitulatif.", + "welcome.b3": "Tu choisis ce que Winlestia remplace dans Windows, et tu peux le modifier plus tard.", + "welcome.b4": "La barre des tâches Windows revient à tout moment, avec un seul raccourci.", + "welcome.title.installed": "Winlestia est déjà installé", + "welcome.sub.installed": "Choisis ce que tu veux faire. Rien ne change avant ta validation.", + "welcome.found": "Installé dans {0}", + "welcome.update": "Mettre à jour", + "welcome.reinstall": "Réinstaller cette version", + "welcome.update.d": "Remplace les fichiers du programme, garde tes réglages et conserve une copie de la version précédente.", + "welcome.modify": "Modifier les fonctions", + "welcome.modify.d": "Active ou désactive des parties de Winlestia. Les fichiers du programme ne sont pas touchés.", + "welcome.uninstall": "Désinstaller", + "welcome.uninstall.d": "Rétablit d'abord la barre des tâches Windows, puis retire Winlestia. Tu choisis le sort de tes données.", + + "license.title": "Licence", + "license.sub": "À titre d'information. Tu n'as rien à accepter pour installer.", + "license.b1": "Winlestia est un logiciel libre, publié sous la licence GNU GPL v3.0.", + "license.b2": "Il est gratuit. Tu peux l'utiliser, l'étudier, le modifier et le partager sous la même licence.", + "license.b3": "Il est fourni sans garantie, dans les limites permises par la loi.", + "license.b4": "C'est un fork de Caelestia, qui garde sa licence GPL-3.0 et ses crédits.", + + "features.title": "Fonctions", + "features.sub": "Choisis ce que Winlestia remplace. Le choix est écrit dans ses réglages à l'installation.", + "state.on": "Activé", "state.off": "Désactivé", "state.always": "Toujours actif", + "when.on": "ACTIVÉ", "when.off": "DÉSACTIVÉ", + "feat.key": "Réglage : {0}", + "feat.action": "Action d'installation, pas un réglage : lance le script d'intégration du terminal.", + "feat.nokey": "Aucun réglage n'existe pour cela : l'installateur ne peut pas le désactiver.", + + "feat.taskbar.name": "Barre des tâches Windows", + "feat.taskbar.desc": "Winlestia peut masquer la barre des tâches Windows et prendre sa place.", + "feat.taskbar.on": "La barre des tâches Windows est masquée tant que Winlestia tourne. Elle revient quand tu quittes Winlestia.", + "feat.taskbar.off": "La barre des tâches Windows reste en place. Winlestia fonctionne à côté.", + "feat.dock.name": "Dock", + "feat.dock.desc": "La barre du bord inférieur : applications épinglées, applications ouvertes, état du système.", + "feat.dock.on": "Le dock apparaît quand le pointeur touche le bord inférieur, puis se cache.", + "feat.dock.off": "Pas de dock. Tu ouvres les applications depuis la palette de commandes (Ctrl+F2) ou le lanceur.", + "feat.panels.name": "Panneaux", + "feat.panels.desc": "Tableau de bord, notifications, lanceur, contrôles rapides et palette de commandes.", + "feat.panels.locked": "Ces panneaux sont le cœur de Winlestia et n'ont pas de réglage activé/désactivé : l'interrupteur est verrouillé. Ouvre-les avec Ctrl+F1 (tableau de bord) et Ctrl+F2 (palette de commandes).", + "feat.winjets.name": "Winjets", + "feat.winjets.desc": "Widgets de bureau placés derrière tes fenêtres : horloge, calendrier, batterie, marchés, lecteur.", + "feat.winjets.locked": "Les Winjets n'ont pas de réglage global activé/désactivé. Six paquets sont installés et aucun n'est posé sur ton bureau tant que tu n'en ajoutes pas un dans Réglages, Winjets.", + "feat.terminal.name": "Terminal", + "feat.terminal.desc": "Les couleurs de Winlestia pour l'invite de commandes et PowerShell, qui suivent ton fond d'écran.", + "feat.terminal.on": "Applique le thème via Clink et ajoute des entrées aux profils PowerShell. Demande une connexion Internet (téléchargement de Clink). Réversible.", + "feat.terminal.off": "Tes terminaux restent comme ils sont. Si l'intégration était active, elle est retirée.", + "feat.pill.name": "Pilule", + "feat.pill.desc": "Une capsule en haut de l'écran qui n'apparaît que lorsqu'il se passe quelque chose.", + "feat.pill.on": "La musique, le volume, la luminosité et le micro s'affichent dans la pilule, puis elle disparaît.", + "feat.pill.off": "Pas de pilule. L'indicateur du bord est utilisé à la place.", + "feat.rails.name": "Rails latéraux", + "feat.rails.desc": "Rails des réseaux sociaux et des marque-pages au bord de l'écran.", + "feat.rails.on": "Les deux rails sont disponibles au bord de l'écran.", + "feat.rails.off": "Pas de rails. Marque-pages et messages ne s'affichent pas au bord de l'écran.", + + "updates.title": "Mises à jour", + "updates.sub": "Winlestia ne se met jamais à jour tout seul en arrière-plan. C'est toi qui décides.", + "updates.how": "Comment se passe une mise à jour", + "updates.s1": "Télécharge le nouvel installateur et lance-le. Il détecte l'installation existante et affiche la version installée et la nouvelle.", + "updates.s2": "Il garde une copie de la version précédente dans %LOCALAPPDATA%\\Programs\\Winlestia-backups, pour pouvoir revenir en arrière.", + "updates.s3": "Tes réglages et ton profil sont conservés. Le shell est fermé, les fichiers sont remplacés, puis tu peux le relancer.", + "updates.s4": "Pas de mise à jour silencieuse, pas de service en arrière-plan, pas de vérification que tu n'as pas demandée.", + "updates.notify": "Me prévenir des nouvelles versions", + "updates.pending": "À brancher", + "updates.notify.d": "Consulterait les versions GitHub de lilidoxdev/winlestia. Le shell n'a pas encore cette vérification : cet interrupteur ne fait rien pour l'instant.", + + "summary.title": "Prêt à lancer", + "summary.sub": "Vérifie la liste. Rien n'a encore changé.", + "summary.install": "Installer Winlestia {0}", + "summary.update": "Mettre à jour Winlestia", + "summary.modify": "Appliquer tes choix de fonctions", + "summary.where": "Dossier : {0}", + "summary.backup": "La version précédente est conservée dans un dossier de sauvegarde.", + "summary.fresh": "Première installation : rien à sauvegarder.", + "summary.close": "Le shell Winlestia en cours est fermé d'abord.", + "summary.nothing": "Rien n'est modifié avant que tu cliques sur le bouton ci-dessous.", + + "progress.title": "Installation", + "progress.sub": "Cela prend une minute. Garde cette fenêtre ouverte.", + "progress.title.u": "Désinstallation", + "progress.sub.u": "La barre des tâches Windows revient en premier.", + + "step.close": "Fermeture du shell en cours", + "step.backup": "Conservation de la version précédente", + "step.copy": "Copie des fichiers du programme", + "step.config": "Écriture de tes choix de fonctions", + "step.terminal": "Intégration du terminal", + "step.task": "Création de la tâche d'ouverture de session", + "step.shortcuts": "Création des raccourcis du menu Démarrer", + "step.registry": "Ajout à Applications installées", + "step.restore": "Rétablissement de la barre des tâches et d'explorer.exe", + "step.utask": "Suppression de la tâche d'ouverture de session", + "step.stop": "Arrêt des processus Winlestia", + "step.undo": "Retrait du gestionnaire de dossiers et du terminal", + "step.uregistry": "Nettoyage du registre", + "step.ushortcuts": "Suppression des raccourcis", + "step.files": "Envoi des fichiers à la Corbeille", + "step.verify": "Vérification du retour de Windows", + + "done.title": "Winlestia est installé", + "done.modify": "Modifications appliquées", + "done.sub": "Lance-le maintenant, ou ferme puis rouvre ta session. Il démarre à l'ouverture de session.", + "done.launch": "Lancer Winlestia maintenant", + "done.demo": "Démonstration : rien n'a été installé.", + "done.dry": "Simulation : rien n'a été écrit. Le journal est dans ton dossier temporaire.", + "done.failed": "Un problème est survenu", + "done.failed.sub": "L'installation s'est arrêtée. Ta version précédente, s'il y en avait une, est dans le dossier de sauvegarde.", + "done.failed.d": "Erreur : {0}", + "safety.title": "Si quelque chose ne va pas", + "safety.s1": "Appuie sur Ctrl+Alt+Retour arrière : Winlestia se ferme et la barre des tâches Windows revient.", + "safety.s2": "Menu Démarrer : « Restaurer la barre des tâches Windows ».", + "safety.s3": "Depuis un terminal : {0}", + "safety.s4": "Ou désinstalle depuis Paramètres, Applications, Applications installées.", + + "uconfirm.title": "Désinstaller Winlestia ?", + "uconfirm.sub": "Windows revient comme avant. Voici exactement ce qui va se passer.", + "uconfirm.guarantees": "Garanties", + "uconfirm.g1": "La barre des tâches Windows et explorer.exe sont rétablis en premier, puis vérifiés à la fin.", + "uconfirm.g2": "Rien n'est supprimé définitivement. Les fichiers vont à la Corbeille.", + "uconfirm.g3": "Le seul dossier de programme retiré est {0}. Tout autre chemin est refusé.", + "uconfirm.g4": "Si un dossier ne peut pas aller à la Corbeille, il reste en place et tu en es informé.", + "uconfirm.keep": "Garder mes données", + "uconfirm.keep.d": "Réglages, profil, fonds d'écran et Winjets dans %LOCALAPPDATA%\\Panneaux et \\Winlestia restent.", + "uconfirm.remove": "Supprimer aussi mes données", + "uconfirm.remove.d": "Les dossiers Panneaux, Winlestia et « Panneaux · Caelestia Windows » de %LOCALAPPDATA%, ainsi que les sauvegardes Winlestia-backups, vont à la Corbeille.", + "done.u.title": "Winlestia est désinstallé", + "done.u.sub": "Windows a retrouvé sa propre interface.", + "done.u.taskbar": "La barre des tâches Windows est de retour.", + "done.u.taskbar.no": "La barre des tâches n'a pas pu être confirmée. Ferme puis rouvre ta session si elle manque.", + "done.u.data.kept": "Tes données ont été conservées.", + "done.u.data.removed": "Tes données ont été envoyées à la Corbeille.", + "done.u.bin": "Restaure ce que tu veux depuis la Corbeille si tu changes d'avis.", + + "warn.terminal": "L'intégration du terminal n'a pas pu être modifiée. Consulte le journal de l'installateur dans ton dossier temporaire.", + "warn.terminalMissing": "Les fichiers d'intégration du terminal sont absents : cette étape a été ignorée.", + "warn.noTaskbar": "La barre des tâches Windows n'est pas revenue. Ferme puis rouvre ta session, ou lance explorer.exe.", + "warn.left": "Laissé en place, à supprimer toi-même : {0}", + + "sc.restore": "Restaurer la barre des tâches Windows", + "sc.uninstall": "Désinstaller Winlestia" +} diff --git a/installer/WinlestiaSetup/UI/MainWindow.xaml b/installer/WinlestiaSetup/UI/MainWindow.xaml new file mode 100644 index 0000000..03b42fb --- /dev/null +++ b/installer/WinlestiaSetup/UI/MainWindow.xaml @@ -0,0 +1,42 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + +