next-auto-i18n 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.0.2] - 2026-06-03
+
+### Added
+
+- **`MIGRATION.md`** : guide de migration 0.x → 1.0 (français + résumé anglais pour les notes de release), livré dans le package et lié depuis le README.
+
 ## [1.0.1] - 2026-06-03
 
 ### Added

package/MIGRATION.md

@@ -0,0 +1,76 @@
+# Guide de migration — 0.x → 1.0
+
+La version `1.0` est une **refonte majeure**. Le changement de fond : **le package ne réécrit plus votre code source**. Tout le reste en découle.
+
+## TL;DR
+
+- Avant, `init` **modifiait vos composants** (remplaçait le texte par `t()`, injectait imports et `const t`). C'était la principale source d'erreurs.
+- Maintenant, l'outil **ne touche pas à votre code** : il détecte, génère les clés, traduit, installe l'infra `next-intl` manquante, et produit un **guide d'intégration** (`i18n-guide.md`) qui vous dit, fichier par fichier et ligne par ligne, comment câbler chaque `t()`.
+- Les commandes passent de 6 à 3 : **`init`**, **`sync`**, **`check`**.
+- C'est un *breaking change* → version majeure `1.0.0`.
+
+## Changements de comportement
+
+| | 0.x | 1.0 |
+|---|---|---|
+| Code source des composants | Réécrit automatiquement | **Jamais modifié** |
+| `app/[locale]/` | Restructuration automatique tentée | **Manuelle** (procédure dans le guide) |
+| `next.config` | Plugin `withNextIntl` injecté | Idem, **seule mutation**, avec backup, sinon signalé « manuel » |
+| `routing.ts` / `request.ts` / middleware / switcher | Créés | Créés **uniquement si absents** |
+| Résultat principal | Code migré (parfois cassé) | Catalogues traduits + **guide d'intégration** |
+
+## Changements de commandes
+
+| 0.x | 1.0 | Quoi faire |
+|---|---|---|
+| `init` | `init` | Installe l'infra + catalogues + traduction + guide (ne réécrit plus le code) |
+| `sync` | `sync` | Inchangé en esprit : rescanne, met à jour le catalogue, traduit le manquant |
+| `add-locale <l>` | — | Ajoutez la locale dans `targetLocales` (config) puis lancez `sync` |
+| `missing` | `check` | `check` est read-only, avec code de sortie pour la CI et `--json` |
+| `extract` / `extract sync` | — | C'est devenu le comportement **par défaut** (`init`/`sync` n'écrivent jamais dans votre code) |
+| — | `check` | **Nouveau** : diagnostic CI (strings non cataloguées, traductions manquantes) |
+
+### Équivalences rapides
+
+```bash
+# Avant → Maintenant
+next-auto-i18n add-locale de   # → ajoutez "de" à targetLocales, puis: next-auto-i18n sync
+next-auto-i18n missing         # → next-auto-i18n check
+next-auto-i18n extract         # → comportement par défaut de init/sync (zéro réécriture)
+```
+
+## Étapes de migration
+
+1. **Mettez à jour** : `npm install -D next-auto-i18n@latest`.
+2. **Lancez** `next-auto-i18n sync` (ou `init` si vous repartez de zéro). Vos fichiers source ne seront pas modifiés.
+3. **Ouvrez `i18n-guide.md`** et câblez les `t()` indiqués (le guide donne la ligne, la clé, le remplacement et le bon hook `useTranslations` / `await getTranslations`).
+4. **Mettez à jour vos scripts** : remplacez `add-locale` / `missing` / `extract` par `init` / `sync` / `check`.
+5. **Config** : `messagesDir` n'est plus obligatoire (défaut appliqué). `init` ajoute un champ `$schema` qui active l'autocomplétion dans VSCode ; vous pouvez l'ajouter à la main sur une config existante :
+   ```json
+   { "$schema": "./node_modules/next-auto-i18n/schema/auto-i18n.config.schema.json" }
+   ```
+
+## Si l'ancienne version avait déjà migré votre code
+
+Aucune action requise : vos `t()` existants sont conservés (l'extraction ignore ce qui est déjà dans un `t()`). `sync` se contentera de mettre à jour les catalogues et les traductions.
+
+## Nouveautés DX (1.0.1)
+
+- **Schéma JSON** de configuration → autocomplétion, validation et infobulles dans VSCode.
+- **API programmatique** : `import { runCheck, runSync } from 'next-auto-i18n'` (l'import n'exécute pas le CLI).
+
+---
+
+## English summary (for release notes)
+
+**next-auto-i18n 1.0 — major rewrite: zero-mutation model.**
+
+The tool no longer rewrites your source code. Previously, `init` edited your components (wrapping text in `t()`, injecting imports) — the main source of breakage. Now it **detects, generates keys, translates, scaffolds the missing `next-intl` files, and produces an integration guide** (`i18n-guide.md`) that tells you exactly where and how to wire each `t()`. Your code is never touched (the only exception is the `next.config` plugin wrap, done with a backup).
+
+- Commands reduced from 6 to **3**: `init`, `sync`, `check`.
+- Removed: `add-locale` (edit `targetLocales` + `sync`), `missing` (→ `check`), `extract` / `extract sync` (now the default behavior).
+- New `check` command for CI (exit code ≠ 0 on pending work, `--json`).
+- `app/[locale]` is no longer auto-restructured (manual, documented in the guide).
+- DX: JSON schema for editor autocomplete, clean library entry point (`import { runCheck } from 'next-auto-i18n'`).
+
+**Migration:** update, run `sync`, follow `i18n-guide.md` to wire `t()`, and rename old commands. Existing `t()` calls are preserved.

package/README.md

@@ -8,6 +8,8 @@
 
 `next-auto-i18n` scanne votre projet, extrait les chaînes traduisibles, génère des clés stables, remplit et traduit les catalogues `messages/*.json`, et met en place l'infrastructure `next-intl` (fichiers additifs). Plutôt que de muter votre JSX — source de la plupart des erreurs — il produit un **guide d'intégration précis** qui vous dit, fichier par fichier et ligne par ligne, comment câbler chaque `t()`.
 
+> **Vous venez de la 0.x ?** Cette `1.0` est une refonte majeure (le code source n'est plus réécrit). Voir le [guide de migration](./MIGRATION.md).
+
 ## Philosophie
 
 - **Zéro mutation du code source.** L'outil ne touche pas à vos composants. Il détecte, catalogue, traduit, et explique.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-auto-i18n",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Internationalisation zéro-mutation pour Next.js App Router : détecte, traduit (DeepL) et installe next-intl sans réécrire votre code.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,7 @@
     "README.md",
     "LICENSE",
     "DOCUMENTATION.md",
+    "MIGRATION.md",
     "CHANGELOG.md"
   ],
   "keywords": [