next-auto-i18n 0.7.2 → 0.8.0

package/DOCUMENTATION.md

@@ -8,15 +8,18 @@
   <a href="https://github.com/stvekoulo/next-auto-i18n/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/next-auto-i18n" alt="license"></a>
 </p>
 
-<p align="center"><strong>Translate your Next.js project automatically in under 5 minutes.</strong></p>
+<p align="center"><strong>Conservative i18n automation for Next.js App Router projects.</strong></p>
 
-next-auto-i18n is a CLI tool that fully automates internationalization (i18n) in existing Next.js projects. It scans your codebase via AST, extracts translatable strings, translates them through DeepL, rewrites your components to use `t("key")` calls, and configures [next-intl](https://next-intl-docs.vercel.app/) — all in a single command.
+> This document complements the README. The README is the shortest source of truth for public guarantees. When behavior differs between examples and real project constraints, the engine always prefers safe refusal or manual guidance over risky mutation.
+
+next-auto-i18n is a CLI tool for existing Next.js projects. It scans the codebase via AST, extracts translatable strings, translates them through DeepL, rewrites safe cases automatically, and applies conservative `next-intl` injection when the project structure is compatible.
 
 ---
 
 ## Table of Contents
 
 - [Why next-auto-i18n?](#why-next-auto-i18n)
+- [Compatibility Matrix](#compatibility-matrix)
 - [Prerequisites](#prerequisites)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
@@ -34,6 +37,49 @@ next-auto-i18n is a CLI tool that fully automates internationalization (i18n) in
 
 ---
 
+## Compatibility Matrix
+
+### Project structure
+
+| Target | Status | Notes |
+|---|---|---|
+| `app/` | Supported | Primary target |
+| `src/app/` | Supported | Scanner and injectors handle both roots |
+| `components/`, `ui/`, `features/`, `shared/` | Supported for scan | Included in the default scan scope |
+| custom monorepo layouts | Partial | Depends on actual source tree and ignore rules |
+
+### Rewriting behavior
+
+| Case | Status | Behavior |
+|---|---|---|
+| simple JSX text | Supported | auto rewrite |
+| supported JSX attributes | Supported | auto rewrite |
+| template literals | Supported | generated key + rewrite when safe |
+| module-scope strings | Partial | translated, but often manual integration |
+| ambiguous JSX spacing | Conservative | skipped with diagnostics |
+| unparseable source file | Blocked | file skipped, warning emitted |
+
+### Next.js injection
+
+| Target | Status | Behavior |
+|---|---|---|
+| `next.config.*` | Supported | inject if compatible, otherwise block |
+| `middleware.ts` / `proxy.ts` | Supported | created or skipped if already present |
+| `i18n/routing.ts` | Supported | created or skipped |
+| `i18n/request.ts` | Supported | created or skipped |
+| `LanguageSwitcher` | Supported | can be injected independently |
+| `app/[locale]/` restructuring | Conservative | refused on complex root layouts |
+
+### Runtime guarantees
+
+| Situation | Outcome |
+|---|---|
+| safe project shape | full or near-full automation |
+| mixed safe and unsafe operations | partial run with explicit manual actions |
+| risky mutation candidate | skipped instead of forced |
+
+---
+
 ## Why next-auto-i18n?
 
 ### Manual setup vs next-auto-i18n
@@ -273,28 +319,37 @@ next-auto-i18n add-locale zh
 
 ### `next-auto-i18n extract`
 
-Scans the project, translates all strings, and generates a Markdown integration guide — **without modifying any source file**. Use this command when you want to keep full control over the integration process.
+Scans the project, translates all strings, and generates a Markdown integration guide — **without modifying any source file**.
 
 ```bash
-next-auto-i18n extract                         # Interactive (asks locale if no config)
-next-auto-i18n extract --locale en,es          # Skip locale prompt
-next-auto-i18n extract --out docs/i18n-guide.md  # Custom output path
+next-auto-i18n extract                          # Interactive (asks locale if no config)
+next-auto-i18n extract --locale en,es           # Skip locale prompt
+next-auto-i18n extract --out docs/i18n-guide.md # Custom output path
+next-auto-i18n extract --inject                 # Also configure Next.js after extraction
+next-auto-i18n extract --switcher               # Inject only the Language Switcher widget
+next-auto-i18n extract --no-module-scope        # Exclude module-scope const strings entirely
 ```
 
 | Flag | Description |
 |------|-------------|
-| `--locale <locales>` | Comma-separated target locales (used if no `auto-i18n.config.json` exists) |
+| `--locale <locales>` | Comma-separated target locales (used if no config file exists) |
 | `--out <path>` | Output path for the Markdown guide (default: `i18n-guide.md`) |
+| `--inject` | Runs the full Next.js setup after translation: `next.config`, `middleware.ts`, `i18n/routing.ts`, `i18n/request.ts`, `app/[locale]/` structure, Language Switcher |
+| `--switcher` | Injects only the floating Language Switcher component (without `--inject`) |
+| `--no-module-scope` | Excludes strings declared inside module-scope `const` from detection and translation |
 
 **What it does:**
 
 1. Scans your project for translatable strings (same AST engine as `init`)
-2. Generates/updates `messages/<sourceLocale>.json` with stable key merge
-3. Translates to all target locales via DeepL (incremental — only new strings)
-4. Detects module-scope strings that require manual integration
-5. Generates `i18n-guide.md` with full integration instructions
+2. *(if `--no-module-scope`)* Detects and filters out module-scope strings before key generation
+3. Generates/updates `messages/<sourceLocale>.json` with stable key merge
+4. Translates to all target locales via DeepL (incremental — only new strings)
+5. Detects module-scope strings that require manual integration (unless `--no-module-scope`)
+6. *(if `--inject`)* Configures the full Next.js i18n infrastructure
+7. *(if `--switcher`)* Injects the Language Switcher component
+8. Generates `i18n-guide.md` with full integration instructions
 
-**What it does NOT do:** modify any `.tsx`/`.ts`/`.jsx`/`.js` source file.
+**What it never does:** modify any `.tsx`/`.ts`/`.jsx`/`.js` source file.
 
 **Generated guide contents:**
 
@@ -302,38 +357,29 @@ next-auto-i18n extract --out docs/i18n-guide.md  # Custom output path
 - List of generated translation files
 - Usage examples (Client Component with `useTranslations`, Server Component with `getTranslations`)
 - Module-scope strings section with before/after code examples
-- Per-file string tables with line number, type, original text, key, and replacement code
+- Per-file tables: line number, type, original text, key, ready-to-paste replacement code
 - Complete key reference table
 
-**Example output:**
-
-```
-▸ Configuration
-  ✓ Configuration chargée (fr → en, es)
-
-▸ Scan du projet
-  ✓ 47 strings trouvées dans 12 fichiers
-    components/Hero.tsx                              8 strings
-    components/Navbar.tsx                            5 strings
-    ...
+---
 
-▸ Génération des clés
-  ✓ 42 clés → ./messages/fr.json
+### `next-auto-i18n extract sync`
 
-▸ Traduction via DeepL
-  ✓ 84 strings traduites
-    ./messages/en.json
-    ./messages/es.json
+Sub-command of `extract`. Rescans the project, integrates new strings, and synchronises translations — **without rewriting source files**. Uses the same stable key merge as `sync`.
 
-▸ Analyse du code source
-  ⚠ 3 strings module-scope détectées (action manuelle requise — voir guide)
+```bash
+next-auto-i18n extract sync                    # Rescan + update JSON + translate
+next-auto-i18n extract sync --inject           # + configure Next.js after sync
+next-auto-i18n extract sync --switcher         # + inject the Language Switcher
+next-auto-i18n extract sync --no-module-scope  # Exclude module-scope strings
+```
 
-▸ Génération du guide
-  ✓ Guide généré : i18n-guide.md
+| Flag | Description |
+|------|-------------|
+| `--inject` | Runs full Next.js setup after synchronisation |
+| `--switcher` | Injects only the Language Switcher component |
+| `--no-module-scope` | Excludes module-scope strings from detection and translation |
 
-  ✓ Extraction terminée — aucun fichier source modifié
-  Consultez le guide pour intégrer les traductions manuellement.
-```
+Requires an existing `auto-i18n.config.json` and `messages/<sourceLocale>.json` (run `init` or `extract` first).
 
 ---
 
@@ -953,6 +999,9 @@ The test suite covers all modules:
 - [x] `next-auto-i18n sync` — rescan and incremental update (stable key merge)
 - [x] `next-auto-i18n missing` — report untranslated keys
 - [x] `next-auto-i18n extract` — translate + generate guide without touching source
+- [x] `next-auto-i18n extract sync` — incremental sync without source rewrite
+- [x] `--inject` / `--switcher` options on `extract` and `extract sync`
+- [x] `--no-module-scope` option to exclude const module-scope strings
 - [x] Floating language switcher widget (auto-injected, customizable)
 - [x] Automatic `next-intl` dependency installation
 - [x] `app/[locale]/` structure auto-creation (required by next-intl App Router)

package/README.md

@@ -4,70 +4,89 @@
 ![npm downloads](https://img.shields.io/npm/dm/next-auto-i18n)
 ![license](https://img.shields.io/npm/l/next-auto-i18n)
 
-> Automatise l'internationalisation d'un projet React / Next.js en une seule commande.
+> CLI d’internationalisation pour projets Next.js App Router, avec scan AST, génération de messages, traduction DeepL, réécriture prudente et injection `next-intl`.
 
-**next-auto-i18n** scanne votre code, extrait les strings traduisibles, les traduit via DeepL, et reconfigure votre projet pour utiliser [next-intl](https://next-intl-docs.vercel.app/) — sans intervention manuelle.
+`next-auto-i18n` scanne votre code, extrait les strings traduisibles, génère les clés i18n, remplit les fichiers `messages/*.json`, traduit via DeepL et applique les mutations sûres du projet. Quand une réécriture ou une injection n’est pas jugée fiable, le CLI s’arrête proprement sur cette cible et renvoie une action manuelle recommandée au lieu de modifier silencieusement votre code.
 
-**[Documentation complete](./DOCUMENTATION.md)**
+La version actuelle est pensée pour être **utile en automatique**, mais aussi **conservatrice** sur les cas ambigus.
+
+Le complément de documentation se trouve dans [DOCUMENTATION.md](./DOCUMENTATION.md).
 
 ## Installation
 
 ```bash
-npm install -D next-auto-i18n
+npm install -D next-auto-i18n next-intl
 ```
 
-Ou directement via npx :
+Ou directement :
 
 ```bash
 npx next-auto-i18n init
 ```
 
-## Pre-requis
+## Prérequis
+
+- Node.js `>= 18`
+- Un projet Next.js avec App Router
+- `next-intl` installé dans le projet
+- Une clé API DeepL
+
+## Ce que le package fait vraiment
 
-- Node.js >= 18
-- Un projet Next.js (App Router)
-- Une cle API DeepL ([inscription gratuite](https://www.deepl.com/pro-api))
+- Scan AST des fichiers `.tsx`, `.jsx`, `.ts`, `.js`
+- Extraction des strings JSX, attributs traduisibles et template literals
+- Génération incrémentale des clés dans `messages/<locale>.json`
+- Traduction DeepL avec validation des placeholders
+- Réécriture automatique des cas sûrs
+- Détection des cas risqués : module-scope, JSX ambigu, fichiers non parsables
+- Injection Next.js conservatrice : applique ce qui est sûr, bloque ce qui doit rester manuel
+- Reporting structuré : `success`, `partial`, `failed`, diagnostics et actions manuelles
 
-## Utilisation rapide
+## Ce que le package ne promet pas
+
+- Il ne réécrit pas tous les cas JSX complexes.
+- Il ne force pas la restructuration `app/[locale]` si le layout racine paraît trop personnalisé.
+- Il ne “corrige pas quand même” un projet ambigu.
+- Il ne garantit pas un projet 100% migré sans validation humaine sur les cas avancés.
+
+## Démarrage rapide
 
 ```bash
 npx next-auto-i18n init
 ```
 
-Le CLI vous guide interactivement :
+Le CLI vous guide sur :
 
-1. Langue source (ex: `fr`)
-2. Langues cibles (ex: `en, es, de`)
-3. Cle API DeepL
+1. la locale source
+2. les locales cibles
+3. la clé DeepL
 
-Et en quelques secondes :
+Puis il :
 
-- Scanne tous vos composants via AST
-- Genere `messages/fr.json` avec les cles i18n
-- Traduit automatiquement vers chaque langue cible
-- Installe `next-intl` automatiquement si absent
-- Remplace les strings en dur par `t("cle")`
-- Configure `next.config`, `middleware.ts` (ou `proxy.ts` sur Next.js 16+)
-- Genere `i18n/routing.ts` + `i18n/request.ts` (requis pour les Server Components)
-- Cree la structure `app/[locale]/` requise par le App Router next-intl
-- Injecte un **Language Switcher flottant** (personnalisable) pour changer de langue
-- Detecte les strings dans les `const` module-scope et vous guide pour les integrer manuellement
+- crée `auto-i18n.config.json`
+- alimente `messages/<sourceLocale>.json`
+- traduit les locales cibles
+- réécrit les fichiers sûrs
+- tente les injections Next.js sûres
+- signale clairement les parties à traiter manuellement
 
 ## Commandes
 
 ### `next-auto-i18n init`
 
-Initialisation complete du projet.
+Initialise le projet : scan, messages, traduction, réécriture, injection.
 
 ```bash
-next-auto-i18n init              # mode interactif
-next-auto-i18n init --dry-run    # preview sans modification
-next-auto-i18n init --locale en,es,de  # langues cibles en ligne de commande
+next-auto-i18n init
+next-auto-i18n init --dry-run
+next-auto-i18n init --locale en,es,de
 ```
 
+`--dry-run` montre d’abord un aperçu et demande confirmation avant d’appliquer.
+
 ### `next-auto-i18n sync`
 
-Rescanne le projet, integre les nouvelles strings et synchronise toutes les traductions (mode incrementiel — les cles existantes sont preservees).
+Rescanne le projet, fusionne les nouvelles strings et synchronise les traductions sans régénérer toute la base.
 
 ```bash
 next-auto-i18n sync
@@ -75,19 +94,30 @@ next-auto-i18n sync
 
 ### `next-auto-i18n extract`
 
-Traduit toutes les strings et genere un **guide d'integration Markdown** — sans modifier aucun fichier source. Utile pour garder le controle sur la reecriture du code.
+Génère ou met à jour les fichiers `messages/*.json`, traduit, puis produit un guide Markdown sans modifier les fichiers source applicatifs.
 
 ```bash
-next-auto-i18n extract                          # guide genere dans i18n-guide.md
-next-auto-i18n extract --out docs/i18n-guide.md # chemin personnalise
-next-auto-i18n extract --locale en,es           # langues cibles (si pas de config)
+next-auto-i18n extract
+next-auto-i18n extract --out docs/i18n-guide.md
+next-auto-i18n extract --inject
+next-auto-i18n extract --switcher
+next-auto-i18n extract --no-module-scope
 ```
 
-Le guide genere inclut : exemples d'utilisation Client/Server Component, tableaux par fichier (ligne, type, cle, code a copier-coller), section dedicee aux strings module-scope.
+### `next-auto-i18n extract sync`
+
+Version incrémentale de `extract`.
+
+```bash
+next-auto-i18n extract sync
+next-auto-i18n extract sync --inject
+next-auto-i18n extract sync --switcher
+next-auto-i18n extract sync --no-module-scope
+```
 
 ### `next-auto-i18n add-locale <locale>`
 
-Ajoute une nouvelle langue et traduit toutes les cles existantes.
+Ajoute une locale cible, traduit les clés existantes et met à jour l’infrastructure Next.js avec les mêmes garde-fous que le reste du moteur.
 
 ```bash
 next-auto-i18n add-locale ar
@@ -95,121 +125,117 @@ next-auto-i18n add-locale ar
 
 ### `next-auto-i18n missing`
 
-Affiche les cles non traduites par langue.
+Affiche les clés manquantes par locale cible.
 
 ```bash
 next-auto-i18n missing
 ```
 
-## Configuration
-
-Le fichier `auto-i18n.config.json` est genere automatiquement :
-
-```json
-{
-  "sourceLocale": "fr",
-  "targetLocales": ["en", "es"],
-  "provider": "deepl",
-  "apiKeyEnv": "AUTO_I18N_DEEPL_KEY",
-  "messagesDir": "./messages",
-  "ignore": ["node_modules", ".next", "**/*.test.*", "**/*.spec.*"]
-}
-```
-
-La cle API est stockee dans `.env.local` (jamais commitee) :
+## Modèle de sécurité
 
-```bash
-AUTO_I18N_DEEPL_KEY=votre-cle-ici
-```
+- `.env.local` et `*.backup` sont ajoutés au `.gitignore`
+- les placeholders de traduction sont validés avant écriture
+- les réécritures ambiguës sont exclues au lieu d’être appliquées de force
+- les injecteurs Next.js retournent `applicable`, `already_present`, `manual_required` ou `blocked`
+- le run global peut finir en `partial` avec actions manuelles listées
 
-## Fonctionnement
+## Compatibilité
 
-### 1. Scan AST
+### Structures de projet
 
-Analyse les fichiers `.tsx`, `.jsx`, `.ts`, `.js` via [ts-morph](https://ts-morph.com/) :
+| Structure | Statut | Notes |
+|---|---|---|
+| `app/` | supporté | cas principal |
+| `src/app/` | supporté | supporté par le scanner et les injecteurs |
+| `components/`, `ui/`, `features/`, `shared/` | supporté au scan | scan AST étendu |
+| monorepo avec conventions très custom | partiel | dépend de la structure réellement scannée |
 
-- Texte JSX : `<p>Bonjour</p>`
-- Attributs : `placeholder="Rechercher..."`
-- Template literals : `` `Bienvenue ${name}` ``
+### Réécriture AST
 
-Ignore automatiquement les classNames, imports, strings techniques, fichiers de config.
+| Cas | Statut | Comportement |
+|---|---|---|
+| texte JSX simple | supporté | réécriture automatique |
+| attributs traduisibles | supporté | réécriture automatique |
+| template literals simples | supporté | génération de clé + réécriture |
+| strings module-scope | partiel | traduites, mais intégration souvent manuelle |
+| JSX inline ambigu ou espaces sensibles | conservateur | exclu de la réécriture auto |
+| fichier non parsable | bloqué | diagnostic remonté, aucune mutation |
 
-### 2. Generation des cles
+### Injection Next.js
 
-Chaque string devient une cle i18n normalisee :
+| Cible | Statut | Comportement |
+|---|---|---|
+| `next.config.*` | supporté | injection si sûre, sinon blocage explicite |
+| `middleware.ts` / `proxy.ts` | supporté | création prudente selon contexte |
+| `i18n/routing.ts` | supporté | création ou skip si déjà présent |
+| `i18n/request.ts` | supporté | création ou skip si déjà présent |
+| `LanguageSwitcher` | supporté | injecteur isolé possible |
+| `app/[locale]/` | conservateur | refus explicite sur layout complexe |
 
-| String | Cle |
-|--------|-----|
-| `Bonjour` | `bonjour` |
-| `Ajouter au panier` | `ajouter_au_panier` |
-| `` `Bienvenue ${name}` `` | `bienvenue_name` |
+### Versions et dépendances
 
-### 3. Traduction DeepL
+| Élément | Statut |
+|---|---|
+| Node.js 18+ | requis |
+| Next.js App Router | requis |
+| `next-intl` | requis |
+| DeepL Free / Pro | supporté |
 
-- Appel batch avec protection des placeholders (`{name}` → `<x>name</x>`)
-- Mode incrementiel : seules les cles manquantes sont traduites
-- Compatible DeepL Free (500k chars/mois) et Pro
-- Restauration automatique des entites HTML (`&apos;`, `&#39;`, etc.)
+## Exemples de comportement
 
-### 4. Reecriture des composants
+### Cas sûr
 
-| Avant | Apres |
-|-------|-------|
-| `<p>Bonjour</p>` | `<p>{t("bonjour")}</p>` |
-| `placeholder="Chercher"` | `placeholder={t("chercher")}` |
-| `` `Salut ${name}` `` | `t("salut_name", { name })` |
+```tsx
+<p>Bonjour</p>
+```
 
-- Server Components : `await getTranslations()` (next-intl/server)
-- Client Components : `useTranslations()` (next-intl)
-- Les strings dans des `const` module-scope (hors composant) sont **detectees et signalees** avec le fichier + numero de ligne — elles sont traduites dans les JSON mais pas reecrites automatiquement (voir section suivante)
+devient :
 
-### Strings module-scope
+```tsx
+<p>{t("bonjour")}</p>
+```
 
-Les `const` declarees au niveau module (hors fonction/composant) ne peuvent pas utiliser `t()` directement. next-auto-i18n les detecte, les traduit, et vous indique quoi faire :
+### Cas module-scope
 
 ```tsx
-// ❌ avant — const module-scope, t() inaccessible ici
-const items = ['Accueil', 'A propos', 'Contact'];
-
-// ✅ apres — deplacez la const dans le composant
-export function Nav() {
-  const t = useTranslations();
-  const items = [t('accueil'), t('a_propos'), t('contact')];
-}
+const items = ['Accueil', 'Contact'];
 ```
 
-Utilisez `next-auto-i18n extract` pour obtenir un guide complet avec tous les cas a corriger.
+Le package peut générer les messages, mais laissera une action manuelle plutôt que d’injecter `t()` à un endroit où il n’est pas accessible.
 
-### 5. Injection config Next.js
+### Cas layout complexe
 
-- `next.config` : wrappe avec `createNextIntlPlugin`
-- `middleware.ts` / `proxy.ts` : routing i18n (proxy.ts si Next.js >= 16)
-- `i18n/routing.ts` : definit les locales
-- `i18n/request.ts` : configuration `getRequestConfig` pour les Server Components
-- `app/[locale]/layout.tsx` : cree avec `NextIntlClientProvider` + `LanguageSwitcher`
-- `app/[locale]/page.tsx` : la page existante est deplacee ici
-- `app/layout.tsx` : simplifie en HTML shell (`<html><body>{children}</body></html>`)
+Si le layout racine contient de la logique sensible ou certains patterns considérés à risque, l’injection de `app/[locale]` est marquée `manual required`. Les autres injections sûres peuvent continuer.
 
-### 6. Language Switcher
+## Configuration
 
-Un composant flottant est automatiquement genere dans `components/LanguageSwitcher.tsx` et inclus dans `app/[locale]/layout.tsx` (dans le provider). Personnalisable via `SWITCHER_CONFIG` : position, theme (light/dark), couleur d'accent, offset.
+Le fichier `auto-i18n.config.json` est généré automatiquement :
 
-## Securite
+```json
+{
+  "sourceLocale": "fr",
+  "targetLocales": ["en", "es"],
+  "provider": "deepl",
+  "apiKeyEnv": "AUTO_I18N_DEEPL_KEY",
+  "messagesDir": "./messages",
+  "ignore": ["node_modules", ".next", "**/*.test.*", "**/*.spec.*"]
+}
+```
+
+La clé API est stockée dans `.env.local` :
 
-- La cle API n'est **jamais** dans le code source
-- `.env.local` et `*.backup` sont ajoutes au `.gitignore`
-- Mode `--dry-run` pour verifier avant modification
-- Backups automatiques (`*.backup`) avant chaque reecriture
+```bash
+AUTO_I18N_DEEPL_KEY=votre-cle
+```
 
-## Developpement
+## Développement
 
 ```bash
-git clone https://github.com/stvekoulo/auto-i18n.git
+git clone https://github.com/stvekoulo/next-auto-i18n.git
 cd next-auto-i18n
 npm install
-npm test        # vitest
-npm run build   # tsc
-npm run dev -- init  # test local
+npm run build
+npm test
 ```
 
 ## Licence

package/dist/cli/doc-generator.d.ts

@@ -4,14 +4,13 @@ export interface FileDocEntry {
     /** Chemin relatif depuis projectRoot (pour l'affichage). */
     relPath: string;
     strings: ExtractedString[];
-    /** Valeurs des strings au module-scope (non réécrivables automatiquement). */
+    /** Valeurs des strings au module-scope. */
     moduleScopeValues: Set<string>;
 }
 export interface DocOptions {
     projectRoot: string;
     sourceLocale: string;
     targetLocales: string[];
-    /** Chemin relatif du dossier messages (pour l'affichage). */
     messagesDir: string;
     keyMap: Map<string, string>;
     files: FileDocEntry[];

package/dist/cli/doc-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../src/cli/doc-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,8EAA8E;IAC9E,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAmCD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAwKpD;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE"}
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../src/cli/doc-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,2CAA2C;IAC3C,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CA+JpD;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE"}

package/dist/cli/doc-generator.js

@@ -1,5 +1,4 @@
 import { writeFile } from 'fs/promises';
-// ── Helpers ────────────────────────────────────────────────────────────────
 function escapeCell(s) {
     return s.replace(/\|/g, '\\|').replace(/[\r\n]+/g, ' ');
 }
@@ -25,19 +24,16 @@ function replacementCode(s, key) {
     }
     return `{t("${key}")}`;
 }
-// ── Markdown builder ───────────────────────────────────────────────────────
 export function buildDoc(options) {
     const { sourceLocale, targetLocales, messagesDir, keyMap, files, date } = options;
     const totalStrings = files.reduce((sum, f) => sum + f.strings.length, 0);
     const totalKeys = keyMap.size;
     const moduleScopeTotal = files.reduce((sum, f) => sum + f.moduleScopeValues.size, 0);
     const L = [];
-    // ── En-tête ──────────────────────────────────────────────────────────────
     L.push('# Guide d\'intégration i18n — next-auto-i18n');
     L.push('');
     L.push(`> Généré le **${date}**  ·  ✅ Aucun fichier source modifié.`);
     L.push('');
-    // ── Résumé ───────────────────────────────────────────────────────────────
     L.push('## Résumé');
     L.push('');
     L.push(`| | |`);
@@ -49,7 +45,6 @@ export function buildDoc(options) {
         L.push(`| ⚠️ Action manuelle | **${moduleScopeTotal}** string${moduleScopeTotal > 1 ? 's' : ''} module-scope (voir section dédiée) |`);
     }
     L.push('');
-    // ── Fichiers générés ─────────────────────────────────────────────────────
     L.push('## Fichiers générés');
     L.push('');
     L.push('| Fichier | Description |');
@@ -59,7 +54,6 @@ export function buildDoc(options) {
         L.push(`| \`${messagesDir}/${locale}.json\` | Traductions (${locale}) |`);
     }
     L.push('');
-    // ── Guide d'utilisation ───────────────────────────────────────────────────
     L.push('## Comment utiliser les traductions');
     L.push('');
     L.push('### Composant Client (`\'use client\'`)');
@@ -87,7 +81,6 @@ export function buildDoc(options) {
     L.push('');
     L.push('> 💡 Lancez `npx next-auto-i18n init` pour configurer automatiquement le routing, le middleware et les layouts.');
     L.push('');
-    // ── Section module-scope ─────────────────────────────────────────────────
     if (moduleScopeTotal > 0) {
         L.push('---');
         L.push('');
@@ -116,7 +109,6 @@ export function buildDoc(options) {
         L.push('```');
         L.push('');
     }
-    // ── Strings par fichier ───────────────────────────────────────────────────
     L.push('---');
     L.push('');
     L.push('## Strings par fichier');
@@ -134,7 +126,6 @@ export function buildDoc(options) {
             L.push(`> ⚠️ **${moduleScopeValues.size}** string${moduleScopeValues.size > 1 ? 's' : ''} module-scope dans ce fichier.`);
             L.push('');
         }
-        // Strings auto-remplaçables
         if (autoStrings.length > 0) {
             if (hasModuleScope)
                 L.push('**Remplacements automatiques :**');
@@ -149,7 +140,6 @@ export function buildDoc(options) {
             }
             L.push('');
         }
-        // Strings module-scope (action manuelle)
         if (manualStrings.length > 0) {
             L.push('**Action manuelle requise (module-scope) :**');
             L.push('');
@@ -167,7 +157,6 @@ export function buildDoc(options) {
         L.push('---');
         L.push('');
     }
-    // ── Toutes les clés ───────────────────────────────────────────────────────
     L.push('## Référence complète des clés');
     L.push('');
     L.push(`Toutes les clés générées dans \`${messagesDir}/${sourceLocale}.json\` :`);