| name | i18n-sync |
| description | Synchronise les fichiers de locale GitWand. Se déclencher dès que l'utilisateur parle d'ajouter une string UI, d'un texte dans l'interface, d'internationalisation, de traduction, d'une clé manquante dans une locale, de sync entre les langues, ou d'une nouvelle feature qui affiche du texte à l'utilisateur.
|
Contexte
Les 5 fichiers de locale se trouvent dans apps/desktop/src/locales/ :
en.ts — source de vérité (objet TypeScript imbriqué const en = { ... })fr.ts, es.ts, pt-BR.ts, zh-CN.ts — doivent refléter exactement la même structure
Les locales utilisent des objets imbriqués (pas de clés dot-notation plates) :
const fr = {
common: {
cancel: "Annuler",
save: "Enregistrer",
},
}
Les composants Vue consomment les clés via useI18n() :
const { t } = useI18n()
Choix du mode
Au démarrage, demander à l'utilisateur quel mode il souhaite — sauf si le contexte est
explicite (ex : "j'ai ajouté un bouton", "il faut traduire X") : aller directement en Mode 3.
Mode 1 — Audit
Objectif : détecter les désynchronisations sans modifier aucun fichier.
- Lire
en.ts et extraire récursivement toutes les clés (chemin dot-notation : common.cancel, branches.create, …)
- Faire de même pour
fr.ts, es.ts, pt-BR.ts, zh-CN.ts
- Pour chaque locale, calculer :
- Clés manquantes : présentes dans
en.ts mais absentes de la locale
- Clés orphelines : présentes dans la locale mais absentes de
en.ts
- Afficher le tableau récapitulatif :
Locale | Clés manquantes | Clés orphelines
-----------|-----------------|----------------
fr.ts | 0 | 0
es.ts | 3 | 0
pt-BR.ts | 1 | 2
zh-CN.ts | 0 | 0
- Lister les clés concernées sous le tableau (regroupées par locale)
- Signaler les clés orphelines séparément — elles peuvent indiquer une fonctionnalité supprimée ; demander à l'utilisateur si elles doivent être retirées
Mode 2 — Scaffold (correction automatique)
Objectif : corriger toutes les désynchronisations détectées.
Pour chaque clé manquante dans une locale :
- Ajouter la clé avec la valeur anglaise et le commentaire
// TODO: translate
- Respecter la position de la clé dans le groupe imbriqué correspondant (ordre de
en.ts)
- Ne jamais supprimer de clé existante sans confirmation explicite
Exemple :
common: {
cancel: "Cancelar",
save: "Guardar",
},
common: {
cancel: "Cancelar",
refresh: "Refresh",
save: "Guardar",
},
Pour les clés orphelines :
- Ne pas les supprimer automatiquement
- Lister chaque clé orpheline et demander confirmation avant suppression
Terminer par un résumé des fichiers modifiés et du nombre de clés ajoutées.
Mode 3 — Ajout d'une nouvelle clé
Objectif : ajouter proprement une nouvelle string UI dans les 5 locales.
- Identifier le groupe imbriqué approprié dans
en.ts (ex: common, branches, settings…)
- Ajouter la clé dans
en.ts avec la valeur en anglais définitive
- Ajouter la même clé dans
fr.ts, es.ts, pt-BR.ts, zh-CN.ts avec valeur anglaise + // TODO: translate
- Si l'utilisateur précise un composant Vue, vérifier qu'il utilise
useI18n() — signaler tout texte hardcodé détecté
- Afficher la clé dot-notation résultante pour copier-coller dans le composant
Exemple d'ajout dans en.ts :
branches: {
checkout: "Check out",
create: "Create branch",
delete: "Delete branch",
rename: "Rename",
},
Exemple dans fr.ts :
branches: {
checkout: "Extraire",
create: "Créer une branche",
delete: "Delete branch",
rename: "Renommer",
},
Rappels critiques
- Ne jamais hardcoder du texte en dur dans les composants Vue — utiliser
t('clé')
- Ajouter la clé dans tous les fichiers même si la traduction n'est pas prête
- Les clés orphelines sont suspectes : poser la question avant toute suppression
- L'ordre des clés dans
en.ts fait référence ; les autres locales suivent le même ordre dans chaque groupe
