docs: fix Quick Navigation anchors by adding explicit IDs and headings; unify cleaner plugin i18n and add languages (en, fr, es, de)

Author: PyCompiler ARK++ Team

API/cleaner/__init__.py

@@ -60,11 +60,11 @@ def _is_excluded(path_str: str) -> bool:
 
         # Demande de confirmation avant une opération potentiellement destructive
         if not sctx.msg_question(
-            tr.get("title", "Nettoyeur"),
-            tr.get("confirm_delete", "Supprimer tous les fichiers .pyc et les dossiers __pycache__ du workspace ?"),
+            tr.get("title", "Cleaner"),
+            tr.get("confirm_delete", "Delete all .pyc files and __pycache__ folders from the workspace?"),
             default_yes=False,
         ):
-            sctx.log_warn("Nettoyage annulé par l'utilisateur")
+            sctx.log_warn(tr.get("cleanup_cancelled", "Cleanup cancelled by user"))
             return
 
         # 1) Analyse (comptage des éléments à supprimer) avec progression indéterminée
@@ -89,8 +89,8 @@ def _is_excluded(path_str: str) -> bool:
                             total += 1
 
             if total == 0:
-                ph.update(text="Rien à supprimer")
-                sctx.log_info("Aucun fichier .pyc ou dossier __pycache__ à supprimer.")
+                ph.update(text=tr.get("nothing_to_delete", "Nothing to delete"))
+                sctx.log_info(tr.get("no_files_to_delete", "No .pyc files or __pycache__ folders to delete."))
                 return
 
             # 2) Suppression avec progression déterminée
@@ -107,16 +107,23 @@ def _is_excluded(path_str: str) -> bool:
                         if _is_excluded(path):
                             continue
                         if ph.canceled:
-                            sctx.log_warn("Nettoyage annulé par l'utilisateur")
+                            sctx.log_warn(tr.get("cleanup_cancelled", "Cleanup cancelled by user"))
                             return
                         try:
                             os.remove(path)
                             pyc_count += 1
                         except Exception as e:
-                            sctx.log_warn(f"Erreur suppression {file}: {e}")
+                            sctx.log_warn(
+                                tr.get("delete_error", "Error deleting {file}: {error}").format(file=file, error=e)
+                            )
                         finally:
                             current += 1
-                            ph.update(current, f"Suppression .pyc ({current}/{total})")
+                            ph.update(
+                                current,
+                                tr.get("deleting_pyc", "Deleting .pyc ({current}/{total})").format(
+                                    current=current, total=total
+                                ),
+                            )
 
                 # Supprimer les dossiers __pycache__
                 for d in dirs:
@@ -125,20 +132,30 @@ def _is_excluded(path_str: str) -> bool:
                         if _is_excluded(path):
                             continue
                         if ph.canceled:
-                            sctx.log_warn("Nettoyage annulé par l'utilisateur")
+                            sctx.log_warn(tr.get("cleanup_cancelled", "Cleanup cancelled by user"))
                             return
                         try:
                             shutil.rmtree(path)
                             pycache_count += 1
                         except Exception as e:
-                            sctx.log_warn(f"Erreur suppression {d}: {e}")
+                            sctx.log_warn(
+                                tr.get("delete_error", "Error deleting {file}: {error}").format(file=d, error=e)
+                            )
                         finally:
                             current += 1
-                            ph.update(current, f"Suppression __pycache__ ({current}/{total})")
+                            ph.update(
+                                current,
+                                tr.get("deleting_pycache", "Deleting __pycache__ ({current}/{total})").format(
+                                    current=current, total=total
+                                ),
+                            )
 
             # 3) Logs UI
             sctx.log_info(
-                f"🗑️ Nettoyage terminé : {pyc_count} fichier(s) .pyc et {pycache_count} dossier(s) __pycache__ supprimés."
+                tr.get(
+                    "cleanup_completed",
+                    "🗑️ Cleanup completed: {pyc_count} .pyc file(s) and {pycache_count} __pycache__ folder(s) deleted.",
+                ).format(pyc_count=pyc_count, pycache_count=pycache_count)
             )
         finally:
             ph.close()

API/cleaner/languages/de.json

@@ -0,0 +1,17 @@
+{
+  "_meta": {
+    "code": "de",
+    "name": "Deutsch"
+  },
+  "title": "Bereiniger",
+  "confirm_delete": "Alle .pyc-Dateien und __pycache__-Ordner aus dem Workspace löschen?",
+  "progress_title": "Workspace-Bereinigung",
+  "analysis_text": "Analysiere zu löschende Elemente...",
+  "cleanup_cancelled": "Bereinigung vom Benutzer abgebrochen",
+  "nothing_to_delete": "Nichts zu löschen",
+  "no_files_to_delete": "Keine .pyc-Dateien oder __pycache__-Ordner zu löschen.",
+  "delete_error": "Fehler beim Löschen von {file}: {error}",
+  "deleting_pyc": "Lösche .pyc ({current}/{total})",
+  "deleting_pycache": "Lösche __pycache__ ({current}/{total})",
+  "cleanup_completed": "🗑️ Bereinigung abgeschlossen: {pyc_count} .pyc-Datei(en) und {pycache_count} __pycache__-Ordner gelöscht."
+}

API/cleaner/languages/en.json

@@ -0,0 +1,17 @@
+{
+  "_meta": {
+    "code": "en",
+    "name": "English"
+  },
+  "title": "Cleaner",
+  "confirm_delete": "Delete all .pyc files and __pycache__ folders from the workspace?",
+  "progress_title": "Workspace Cleanup",
+  "analysis_text": "Analyzing items to delete...",
+  "cleanup_cancelled": "Cleanup cancelled by user",
+  "nothing_to_delete": "Nothing to delete",
+  "no_files_to_delete": "No .pyc files or __pycache__ folders to delete.",
+  "delete_error": "Error deleting {file}: {error}",
+  "deleting_pyc": "Deleting .pyc ({current}/{total})",
+  "deleting_pycache": "Deleting __pycache__ ({current}/{total})",
+  "cleanup_completed": "🗑️ Cleanup completed: {pyc_count} .pyc file(s) and {pycache_count} __pycache__ folder(s) deleted."
+}

API/cleaner/languages/es.json

@@ -0,0 +1,17 @@
+{
+  "_meta": {
+    "code": "es",
+    "name": "Español"
+  },
+  "title": "Limpiador",
+  "confirm_delete": "¿Eliminar todos los archivos .pyc y carpetas __pycache__ del workspace?",
+  "progress_title": "Limpieza del workspace",
+  "analysis_text": "Analizando elementos a eliminar...",
+  "cleanup_cancelled": "Limpieza cancelada por el usuario",
+  "nothing_to_delete": "Nada que eliminar",
+  "no_files_to_delete": "No hay archivos .pyc o carpetas __pycache__ para eliminar.",
+  "delete_error": "Error al eliminar {file}: {error}",
+  "deleting_pyc": "Eliminando .pyc ({current}/{total})",
+  "deleting_pycache": "Eliminando __pycache__ ({current}/{total})",
+  "cleanup_completed": "🗑️ Limpieza completada: {pyc_count} archivo(s) .pyc y {pycache_count} carpeta(s) __pycache__ eliminadas."
+}

API/cleaner/languages/fr.json

@@ -0,0 +1,17 @@
+{
+  "_meta": {
+    "code": "fr",
+    "name": "Français"
+  },
+  "title": "Nettoyeur",
+  "confirm_delete": "Supprimer tous les fichiers .pyc et les dossiers __pycache__ du workspace ?",
+  "progress_title": "Nettoyage du workspace",
+  "analysis_text": "Analyse des éléments à supprimer...",
+  "cleanup_cancelled": "Nettoyage annulé par l'utilisateur",
+  "nothing_to_delete": "Rien à supprimer",
+  "no_files_to_delete": "Aucun fichier .pyc ou dossier __pycache__ à supprimer.",
+  "delete_error": "Erreur lors de la suppression de {file} : {error}",
+  "deleting_pyc": "Suppression .pyc ({current}/{total})",
+  "deleting_pycache": "Suppression __pycache__ ({current}/{total})",
+  "cleanup_completed": "🗑️ Nettoyage terminé : {pyc_count} fichier(s) .pyc et {pycache_count} dossier(s) __pycache__ supprimés."
+}

docs/how_to_create_a_bcasl_API.md

@@ -68,7 +68,7 @@ Table of contents
 
 ---
 
-0) TL;DR (copy‑paste template)
+## 0) TL;DR (copy‑paste template) {#0-tldr-copy-paste-template}
 
 ```python
 # API/my_plugin/__init__.py
@@ -116,7 +116,7 @@ def bcasl_register(manager):
 
 ---
 
-1) Quick checklist
+## 1) Quick checklist {#1-quick-checklist}
 - [ ] Package under API/<plugin_id>/ with __init__.py
 - [ ] BCASL signature: BCASL_PLUGIN=True, BCASL_ID, BCASL_DESCRIPTION
 - [ ] Extended metadata (recommended): NAME, VERSION, AUTHOR, CREATED, LICENSE, COMPATIBILITY, TAGS
@@ -129,7 +129,7 @@ def bcasl_register(manager):
 
 ---
 
-2) Folder layout
+## 2) Folder layout {#2-folder-layout}
 
 Place plugins exclusively under API/<plugin_id>/ (never under acasl/ or bcasl/):
 ```
@@ -141,7 +141,7 @@ Place plugins exclusively under API/<plugin_id>/ (never under acasl/ or bcasl/):
 
 ---
 
-3) Minimal plugin (with metadata)
+## 3) Minimal plugin (with metadata) {#3-minimal-plugin-with-metadata}
 
 ```python
 from __future__ import annotations
@@ -183,7 +183,7 @@ def bcasl_register(manager):
 
 ---
 
-4) Tag taxonomy and default ordering (minify before obfuscation)
+## 4) Tag taxonomy and default ordering (minify before obfuscation) {#4-tag-taxonomy-and-default-ordering-minify-before-obfuscation}
 
 The host computes a default order from BCASL_TAGS (no IDs are hard‑coded):
 - clean, cleanup, sanitize, prune, tidy → earliest
@@ -221,7 +221,7 @@ Recommended baseline tags by stage:
 
 ---
 
-5) Progress and non‑interactive considerations
+## 5) Progress and non‑interactive considerations {#5-progress-and-non-interactive-considerations}
 
 - Always use progress(...) for long operations; it is non‑blocking and UI‑safe.
 - Ask confirmation only when interactive. Detect non‑interactive mode (best‑effort):
@@ -245,7 +245,7 @@ if ask and not sctx.msg_question("Proceed?", "Run heavy step now?", default_yes=
 
 ---
 
-6) Configuration patterns
+## 6) Configuration patterns {#6-configuration-patterns}
 
 - Workspace config (bcasl.*) can be JSON/YAML/TOML/INI/CFG; the UI can create and edit it.
 - Per‑plugin settings: use ensure_settings_file(...) to materialize a user‑editable file under the workspace.
@@ -257,7 +257,7 @@ settings = ensure_settings_file(sctx, subdir="config", basename="my_plugin", fmt
 
 ---
 
-6.1) System install helpers (pip global + package managers)
+## 6.1) System install helpers (pip global + package managers) {#61-system-install-helpers-pip-global--package-managers}
 
 - Use the standardized helpers to request consent and install dependencies system‑wide.
 - In non‑interactive mode these helpers return False and skip installation safely.
@@ -294,7 +294,7 @@ if not ok:
 
 ---
 
-7) Context essentials
+## 7) Context essentials {#7-context-essentials}
 
 - Safe paths: sctx.safe_path(rel_or_abs) and sctx.is_within_workspace(Path)
 - Scans: sctx.iter_files(patterns=[...], exclude=[...], enforce_workspace=True)
@@ -303,7 +303,7 @@ if not ok:
 
 ---
 
-8) i18n (async)
+## 8) i18n (async) {#8-i18n-async}
 
 - Place a languages/ folder in your package; load with API_SDK helpers:
 ```python
@@ -314,7 +314,7 @@ tr = asyncio.run(load_plugin_translations(__file__, "System"))
 
 ---
 
-9) Workspace switching (safe)
+## 9) Workspace switching (safe) {#9-workspace-switching-safe}
 
 ```python
 from API_SDK import set_selected_workspace
@@ -325,7 +325,7 @@ if ok:
 
 ---
 
-10) Examples
+## 10) Examples {#10-examples}
 
 A) Minifier (minify before obfuscation via tags)
 ```python
@@ -472,7 +472,7 @@ def bcasl_register(manager):
 
 ---
 
-11) Troubleshooting
+## 11) Troubleshooting {#11-troubleshooting}
 - Plugin not visible → ensure BCASL_PLUGIN/ID/DESCRIPTION exist; it's under API/<plugin_id>/ (not under acasl/ or bcasl/); use @plugin; register via bcasl_register; open API Loader; check logs
 - Config invalid → use UI raw editor; validate formats; fall back to JSON
 - Long operations → use progress; split work; no modal blocking in background