docs: mise à jour du README avec les commandes réelles et synchronisation UX

Author: raidos23

README.md

@@ -23,6 +23,7 @@ Build Python apps with a predictable workflow, a configurable pre-compile pipeli
 - **Structured CLI**: explicit `gui`, `engine`, `workspace`, `doctor`, and `scaffold` commands, with JSON output on key headless paths.
 - **Standalone tools**: dedicated BCASL and Engines managers, plus CLI entry points and dry-run support.
 - **Extensible SDKs**: create new engines and BCASL plugins with the provided SDKs.
+- **Theme-aware dynamic colors and SVG icons**: 100% dynamic UI integration using QPalette and themed SVGs.
 - **Customizable**: theming and translations out of the box.
 
 ---
@@ -49,6 +50,8 @@ python pycompiler_ark.py
 python -m pycompiler_ark
 ```
 
+*Note: The application features a centered and auto-scaled splash screen for a professional startup experience.*
+
 ---
 
 ## How it works
@@ -75,106 +78,56 @@ Compilation (PyInstaller / Nuitka / cx_Freeze)
 
 ---
 
-## CLI shortcuts
-
-```bash
-python pycompiler_ark.py --help
-python pycompiler_ark.py --version
-python pycompiler_ark.py --info
-python pycompiler_ark.py --cli
-python pycompiler_ark.py gui main --ide
-python pycompiler_ark.py gui main --classic --no-splash
-python pycompiler_ark.py gui bcasl /path/to/workspace
-python pycompiler_ark.py gui engines /path/to/workspace
-python pycompiler_ark.py engine list --json
-python pycompiler_ark.py engine doctor nuitka src/main.py --json
-python pycompiler_ark.py workspace inspect . --json
-python pycompiler_ark.py doctor --json
-python pycompiler_ark.py init /path/to/workspace --json
-python pycompiler_ark.py init /path/to/workspace --with-venv --json
-python pycompiler_ark.py config-auto /path/to/workspace --json
-python pycompiler_ark.py cfg-auto /path/to/workspace --json
-python pycompiler_ark.py ws init /path/to/workspace --json
-python pycompiler_ark.py check /path/to/workspace --json
-python pycompiler_ark.py scaffold engine demo_engine --json
-python pycompiler_ark.py unload --json
-```
-
-### CLI groups
-
-- `gui`: launch graphical entrypoints explicitly
-- `engine`: inspect engines, run compatibility checks, dry-run or compile
-- `bcasl`: BCASL GUI or delegated headless actions
-- `workspace`: inspect the current workspace and resolved entrypoint
-- `init`: initialize a workspace directory and base configs (`ark.yml`, `bcasl.yml`, `.ark/pref.json`)
-  - `--with-venv`: also create/reuse a local workspace venv and set it in `.ark/pref.json`
-- `config-auto`: auto-detect entrypoint and update workspace config
-- `cfg-auto`: short alias for `config-auto`
-- `ws`: short group alias for workspace bootstrap (`ws init`, `ws config-auto`)
-- `check`: strict CI/CD preflight shortcut
-- `doctor`: global diagnostics snapshot
-- `scaffold`: generate starter templates for engines and plugins
-
-### Headless note
-
-The CLI router no longer bootstraps the main Qt application for headless paths such as:
+## CLI Usage
 
-- `--help`
-- `--version`
-- `--info`
-- `--cli`
-- `unload`
-- `workspace ...`
+The ARK CLI provides a structured set of commands for workspace management, building, and developer tasks.
 
-Structured command groups such as `engine`, `bcasl`, `doctor`, and `scaffold`
-also avoid launching the main GUI entrypoint.
+### Core Commands
 
-This keeps scripting and CI workflows friendly on machines where no GUI window
-should be opened.
-
-### CI-friendly exit codes
-
-- `0`: success
-- `3`: precheck failure (`check --strict`)
-- `4`: invalid or missing workspace
-- `5`: engine not found
+```bash
+# Workspace Initialization
+python pycompiler_ark.py init --entry src/main.py [--icon icon.ico] [--with-venv]
 
-These are the stable codes to key on in CI for the structured headless commands.
+# Building
+python pycompiler_ark.py build                      # Build using ark.yml engine
+python pycompiler_ark.py build --engine nuitka      # Override engine
+python pycompiler_ark.py build --lock latest.lock   # Rebuild from lock file
 
-### Dedicated CLI quick commands
+# Execution
+python pycompiler_ark.py run bcasl                  # Execute BCASL pipeline
+python pycompiler_ark.py run bcasl --timeout 30     # With custom timeout
 
-```text
-ark-cli> main
-ark-cli> main --ide-gui
-ark-cli> bcasl run ~/my_workspace --timeout 30
-ark-cli> engine dry-run pyinstaller src/main.py
-ark-cli> engine list
-ark-cli> unload
+# GUI
+python pycompiler_ark.py gui                        # Launch modern IDE-like GUI
+python pycompiler_ark.py gui --legacy               # Launch classic GUI
 ```
 
-### GUI entrypoints
+### Developer Commands
 
 ```bash
-python pycompiler_ark.py gui main --ide
-python pycompiler_ark.py gui bcasl
-python pycompiler_ark.py gui engines
-```
+# Discovery
+python pycompiler_ark.py list engines               # List available engines
+python pycompiler_ark.py list plugins               # List available BCASL plugins
+
+# Configuration (User Paths)
+python pycompiler_ark.py set user-engine-dir /path  # Set custom engine directory
+python pycompiler_ark.py get user-engine-dir        # Retrieve path
 
-### Standalone modules
+# Scaffolding
+python pycompiler_ark.py scaffold engine demo       # Create a new engine template
+python pycompiler_ark.py scaffold plugin-bcasl demo # Create a new BCASL plugin template
+```
 
+### JSON Output
+For CI/CD and scripting, key commands support the `--json` flag to return machine-readable results:
 ```bash
-python -m OnlyMod.BcaslOnlyMod --gui
-python -m OnlyMod.BcaslOnlyMod --list-plugins
-python -m OnlyMod.BcaslOnlyMod --run --workspace /path/to/workspace
-python -m OnlyMod.EngineOnlyMod
-python -m OnlyMod.EngineOnlyMod --list-engines
-python -m OnlyMod.EngineOnlyMod --check-compat nuitka
-python -m OnlyMod.EngineOnlyMod --engine nuitka -f script.py --dry-run
+python pycompiler_ark.py build --json
+python pycompiler_ark.py init --entry main.py --json
 ```
 
 ---
 
-## Documentation
+## How it works
 
 - [Changelog](CHANGELOG.md)
 - [Release process](docs/release_process.md)

docs/architecture.md

@@ -40,7 +40,7 @@ Responsibilities:
 - map Qt widgets to Python attributes
 - connect UI actions to shared application logic
 - support both classic and IDE-like layouts
-- apply theme and translation behavior
+- apply 100% dynamic theme and translation behavior (QPalette + themed SVG icons)
 
 ### 3. Workspace and environment management
 

docs/dev_docs/Bcasl_Ux_design_review.md

@@ -13,42 +13,37 @@ L'UI BCASL est un éditeur visuel du pipeline qui respecte les contraintes du sy
 · Lecture seule : la catégorie d'un plugin ne peut pas être changée
 · Ordre modifiable : à l'intérieur d'une section (même catégorie)
 · Guidage : plages de priorité recommandées
-· Sauvegarde : tout est écrit dans bcasl.yml 
+· Sauvegarde : tout est écrit dans bcasl.yml
+· Thème : 100% dynamique via QPalette et icônes SVG thémées 
 
 --- 
 
 2. Vue principale 
 
 ```
 ┌─────────────────────────────────────────────────────────────────────┐
-│ BCASL Pipeline                                              [Save] │
+│ BCASL Pipeline                                                      │
 ├─────────────────────────────────────────────────────────────────────┤
 │                                                                     │
-│ ▼ Validation (10-19)                                               │
+│ [✓] Validation (10-19)         (QGroupBox collapsible)              │
 │   ┌─────────────────────────────────────────────────────────────┐  │
-│   │ ☑ syntax_checker               priority [12]  [↑] [↓] (drag)│  │
-│   │ ☑ type_checker                 priority [15]  [↑] [↓]       │  │
+│   │ ☑ syntax_checker               priority [12]  [˄] [˅] (svg) │  │
+│   │ ☑ type_checker                 priority [15]  [˄] [˅]       │  │
 │   └─────────────────────────────────────────────────────────────┘  │
 │                                                                     │
-│ ▼ Transformation (20-39)                                           │
+│ [✓] Transformation (20-39)                                          │
 │   ┌─────────────────────────────────────────────────────────────┐  │
-│   │ ☑ minifier                     priority [25]  [↑] [↓]       │  │
+│   │ ☑ minifier                     priority [25]  [˄] [˅]       │  │
 │   └─────────────────────────────────────────────────────────────┘  │
 │                                                                     │
-│ ▼ Obfuscation (40-59)                                              │
+│ [✓] Obfuscation (40-59)                                            │
 │   ┌─────────────────────────────────────────────────────────────┐  │
-│   │ ☐ pyobfus                      priority [45]  [↑] [↓]       │  │
-│   │ ⚠️ ☑ byteshift                  priority [22]  [↑] [↓]       │  │
+│   │ ☐ pyobfus                      priority [45]  [˄] [˅]       │  │
+│   │ ⚠️ ☑ byteshift                  priority [22]  [˄] [˅]       │  │
 │   │       ↑ hors plage (40-59)                                   │  │
 │   └─────────────────────────────────────────────────────────────┘  │
-│                                                                     │
-│ ▼ Preparation (60-79)                                              │
-│   ┌─────────────────────────────────────────────────────────────┐  │
-│   │ ☐ signer                       priority [70]  [↑] [↓]       │  │
-│   └─────────────────────────────────────────────────────────────┘  │
-│                                                                     │
 ├─────────────────────────────────────────────────────────────────────┤
-│                                        [Cancel]  [Save to bcasl.yml]│
+│ [ ] Expert mode                         [Cancel]  [Save to bcasl.yml]│
 └─────────────────────────────────────────────────────────────────────┘
 ``` 
 
@@ -59,18 +54,17 @@ L'UI BCASL est un éditeur visuel du pipeline qui respecte les contraintes du sy
 3.1 Section (catégorie) 
 
 Élément Rôle
-▼ Validation (10-19) Titre de section (collapsible)
+[✓] Titre (QGroupBox) Titre de section + toggle natif (collapsible)
 Plage de priorité Indique les bornes recommandées
-Background Léger (gris très clair) 
+Background Dynamique (QPalette.AlternateBase) 
 
 3.2 Ligne plugin 
 
 Élément Rôle
 ☑ Checkbox enabled
 Nom plugin.name
 priority [22] Label + champ de saisie (spinbox)
-[↑] [↓] Boutons pour réorganiser
-(drag) Poignée pour drag & drop
+[˄] [˅] (svg) Boutons SVG thémés pour réorganiser
 ⚠️ Warning si priorité hors plage 
 
 --- 
@@ -80,17 +74,17 @@ priority [22] Label + champ de saisie (spinbox)
 4.1 Réorganisation (même section) 
 
 Action Résultat
-Cliquer [↑] Échange avec plugin au-dessus (même section)
-Cliquer [↓] Échange avec plugin en-dessous
-Drag & drop Déplace dans la même section 
+Cliquer [˄] Échange avec plugin au-dessus (même section)
+Cliquer [˅] Échange avec plugin en-dessous
+Drag & drop Déplace dans la même section (logiciel) 
 
 → Si drop dans une autre section, opération annulée + message d'erreur. 
 
 4.2 Modification priorité 
 
 Action Résultat
 Changer spinbox Met à jour la priorité
-Si hors plage Affiche ⚠️ + tooltip explicatif
+Si hors plage Affiche ⚠️ + tooltip explicatif + style warning
 Sauvegarde Écrit la priorité (même hors plage) 
 
 4.3 Activation/désactivation 
@@ -123,9 +117,9 @@ Use 'Expert mode' to disable warnings.
 
 5.3 Priorité hors plage (warning visuel) 
 
-· Fond de ligne : #FFF3CD (jaune pâle)
+· Fond de ligne : Dynamique (ex: ambre sombre en dark mode)
 · Icône ⚠️ devant le nom
-· Bordure orange sur le spinbox 
+· Bordure orange sur le spinbox (adaptée au thème)
 
 --- 
 

docs/releases/v1.0.0.md

@@ -2,11 +2,13 @@
 
 ## Highlights
 - IDE-like GUI stable with full i18n parity.
+- Theme-aware dynamic styling (QPalette) and themed SVG icons integration.
 - Complete headless CLI (engine compile/dry-run, workspace apply, venv management).
 - BCASL plugins runtime + headless execution.
 - AdvancedConfigEditor fully independent (LCS-based diff from scratch).
 - Workspace persistence (.ark/pref.json, per-engine configs).
 - Production-ready CI/CD (docs/ci_cd_ark_cli.md).
+- Improved startup experience with centered and auto-scaled splash screen.
 
 ## Completed Todos
 See root TODO.md for details.