Merge pull request #25 from laruiss/24-feat-migration-nuxt4-support-exclusif

feat(nuxt4): 🚀 migration vers Nuxt 4 avec support exclusif

Author: laruiss

.eslintignore

@@ -0,0 +1,235 @@
+# 🎯 Conventions Git & Commits
+
+Ce fichier contient les instructions pour créer des messages de commit respectant les conventions du projet.
+
+## Format des commits
+
+Le projet utilise le format conventional commit avec des gitmojis.
+
+## Structure des messages de commit
+
+```text
+type(scope): gitmoji description courte
+
+## Pourquoi les changements ont été faits :
+- Explication du contexte et des raisons
+- Problème résolu ou besoin adressé
+
+## Quelles modifications ont été apportées :
+- Description détaillée des modifications
+- Impact sur l'architecture/fonctionnalités
+
+closes #1234
+```
+
+Pas de majuscule au début de la description courte.
+
+Utilise la troisième personne du singulier au présent de l'indicatif pour la description courte.
+
+### Types de commits principaux (à utiliser en priorité)
+
+Ces types couvrent 90% des cas d'usage courants dans le projet :
+
+#### 🔄 **Développement quotidien**
+
+- `feat`: ✨ Nouvelles fonctionnalités
+- `fix`: 🐛 Corrections de bugs
+- `refactor`: ♻️ Refactoring (ni feat ni fix)
+- `style`: 💄 Formatage, style (pas de changement de logique)
+
+#### 📚 **Documentation et maintenance**
+
+- `docs`: 📝 Documentation
+- `test`: ✅ Ajout/modification de tests
+- `chore`: 🔧 Maintenance, configuration, dépendances
+
+#### 🚀 **Build et déploiement**
+
+- `build`: 📦️ Changements qui affectent le système de build ou dépendances externes
+- `ci`: 👷 CI/CD, GitHub Actions
+
+#### 🚨 **Urgences**
+
+- `hotfix`: 🚑️ Corrections critiques en urgence
+- `perf`: ⚡ Améliorations de performance
+
+### Types de commits spécialisés (usage occasionnel)
+
+Ces types sont à utiliser dans des cas spécifiques :
+
+#### � **Corrections spéciales**
+
+- `revert`: ⏪ Annulation de commit
+- `breaking`: 💥 Changements incompatibles (breaking changes)
+- `security`: 🔒️ Corrections de sécurité
+- `typo`: ✏️ Correction de fautes de frappe
+- `lint`: 🚨 Correction des warnings du linter/compilateur
+
+#### 🏗️ **Structure et architecture**
+
+- `move`: 🚚 Déplacement ou renommage de fichiers
+- `remove`: 🔥 Suppression de code ou fichiers
+- `merge`: 🔀 Fusion de branches
+
+#### 📦 **Dépendances**
+
+- `deps-add`: ➕ Ajout d'une dépendance
+- `deps-upgrade`: ⬆️ Mise à jour des dépendances
+- `deps-remove`: ➖ Suppression d'une dépendance
+
+#### � **Interface utilisateur**
+
+- `ui`: � Interface utilisateur et fichiers de style
+- `accessibility`: ♿ Améliorations d'accessibilité
+- `responsive`: � Design responsive
+
+#### 🔧 **Développement**
+
+- `types`: 🏷️ Types TypeScript
+- `config`: 🔧 Fichiers de configuration
+- `wip`: 🚧 Travail en cours (Work In Progress)
+
+## 📝 Exemples pratiques par contexte
+
+### 🎯 **Développement de composants (cas les plus fréquents)**
+
+```text
+feat(DsfrButton): ✨ ajoute la variante ghost
+
+## Pourquoi les changements ont été faits :
+- Besoin d'une variante de bouton moins visible pour les actions secondaires
+- Améliore la hiérarchie visuelle dans les interfaces
+
+## Quelles modifications ont été apportées :
+- Ajout de la prop `variant="ghost"` dans DsfrButtonProps
+- Nouveau style CSS pour la variante ghost
+- Tests et stories mis à jour
+
+closes #1098
+```
+
+```text
+fix(DsfrModal): 🐛 corrige la fermeture au clic extérieur
+
+## Pourquoi les changements ont été faits :
+- La modale ne se fermait pas quand on cliquait sur l'overlay
+- Problème d'expérience utilisateur signalé dans l'issue #123
+
+## Quelles modifications ont été apportées :
+- Ajout d'un écouteur d'événement click sur l'overlay
+- Vérification que le clic ne vient pas de l'intérieur de la modale
+
+closes #987
+```
+
+```text
+refactor(DsfrTabs): ♻️ simplifie la logique de gestion des onglets actifs
+
+## Pourquoi les changements ont été faits :
+- Code complexe et difficile à maintenir
+- Améliore la lisibilité pour les futures contributions
+
+## Quelles modifications ont été apportées :
+- Remplacement de la logique complexe par un computed plus simple
+- Suppression de code redondant
+- Même comportement utilisateur maintenu
+
+closes #455
+```
+
+### 📚 **Documentation et tests**
+
+```text
+docs(DsfrCard): 📝 ajoute des exemples d'utilisation avancée
+
+## Pourquoi les changements ont été faits :
+- Les développeurs demandaient plus d'exemples concrets
+- Améliore l'adoption du composant
+
+## Quelles modifications ont été apportées :
+- Nouveaux exemples dans DsfrCard.md
+- Stories Storybook enrichies avec cas d'usage métier
+
+closes #1234
+```
+
+```text
+test(DsfrInput): ✅ ajoute tests pour la validation des erreurs
+
+## Pourquoi les changements ont été faits :
+- Couverture de test insuffisante sur la gestion d'erreurs
+- Prévient les régressions sur cette fonctionnalité critique
+
+## Quelles modifications ont été apportées :
+- Tests unitaires pour tous les cas d'erreur
+- Tests d'interaction utilisateur avec des erreurs
+
+fixes #1045
+```
+
+### 🚀 **Build et infrastructure**
+
+```text
+ci: 👷 ajoute vérification des liens dans la documentation
+
+## Pourquoi les changements ont été faits :
+- Éviter les liens cassés dans la documentation déployée
+- Améliore la qualité de la documentation
+
+## Quelles modifications ont été apportées :
+- Nouveau job GitHub Actions pour vérifier les liens
+- Configuration avec exclusions pour les liens externes temporaires
+
+closes #623
+```
+
+```text
+chore: 🔧 met à jour la configuration ESLint pour Vue 3.4
+
+## Pourquoi les changements ont été faits :
+- Nouvelle version de Vue apporte de nouvelles règles recommandées
+- Maintient la qualité du code selon les standards actuels
+
+## Quelles modifications ont été apportées :
+- Mise à jour des règles ESLint
+- Configuration adaptée aux nouvelles fonctionnalités Vue
+
+closes #678
+```
+
+### 🎨 **Styles et interface**
+
+```text
+style(global): 💄 harmonise les espacements selon DSFR 1.11
+
+## Pourquoi les changements ont été faits :
+- Mise en conformité avec la nouvelle version du DSFR
+- Assure la cohérence visuelle avec le système de design
+
+## Quelles modifications ont été apportées :
+- Variables CSS mises à jour
+- Composants utilisant les nouveaux tokens d'espacement
+
+closes #789
+```
+
+### 🎯 **Scopes appropriés pour ce projet**
+
+- **Système** : `build`, `ci`, `types`, `docs`
+- **Global** : `global`, `core`, `utils` (si ça impacte plusieurs composants)
+
+### ⚠️ **Anti-patterns à éviter**
+
+```text
+❌ feat: ajoute un bouton
+✅ feat(DsfrButton): ✨ ajoute la propriété disabled
+
+❌ fix: Bug dans la modale
+✅ fix(DsfrModal): 🐛 corrige la fermeture au clic extérieur
+
+❌ update: Change des trucs
+✅ refactor(DsfrCard): ♻️ simplifie la structure des slots
+
+❌ feat(DsfrButton): Ajoute disabled prop
+✅ feat(DsfrButton): ✨ ajoute la propriété disabled
+```

.eslintrc

@@ -0,0 +1,92 @@
+# Instructions de codage IA pour VueDsfr
+
+## Vue d'ensemble du projet
+
+VueDsfr est une bibliothèque de composants Vue 3 qui porte le Système de Design Français (DSFR) vers Vue.js. Elle fournit ~50 composants accessibles et prêts pour la production suivant les normes de design du gouvernement français.
+
+## Architecture et structure des fichiers
+
+## Workflow de développement
+
+### Commandes de build et exécution
+
+```bash
+npm install             # Installer les dépendances
+npm dev                 # Démarrer le playground (:3000)
+npm docs:dev            # Démarrer la documentation VitePress (:4173)
+npm build               # Builder le module
+npm test                # Exécuter les tests unitaires Vitest
+npm lint                # Exécuter ESLint
+npm format              # Corriger automatiquement ESLint
+```
+
+### Workflow GitHub : Issues et Pull Requests
+
+- **Issues obligatoires** : Toute PR doit être liée à une issue GitHub
+- **Création d'issue** :
+  - Utiliser `gh issue create` avec titre et description en français
+  - **Ne pas exécuter la commande** - la fournir à l'utilisateur pour qu'il l'exécute
+  - Format du titre : `type(scope): 🔧 description courte du problème`
+- **Nommage des branches** :
+  - Préfixe obligatoire avec numéro d'issue : `{numéro-issue}-{type}-{description-kebab-case}`
+  - Exemple : `1172-fix-semantic-release-refactor-config`
+- **Pull Requests** :
+  - Titre reprenant le message de commit principal
+  - Corps commençant par Fixes avec référence à l'issue
+  - Description détaillée du problème et de la solution
+  - Branche cible : `main` (sauf exceptions)
+
+### Qualité du code et commits
+
+- **Commits** : Suivre les commits conventionnels (voir `.github/conventions-commits.md`)
+- **Linting** : @antfu/eslint-config avec règles spécifiques à Vue
+- **Pre-commit** : Husky exécute lint-staged sur `*.{vue,ts}`
+- **CI** : GitHub Actions exécute les tests, le linting et la vérification de build
+
+### Linting et formatage
+
+- Respecter TOUTES les règles ESLint configurées
+- Pas de `console.*`
+- Préférer les imports nommés aux imports par défaut
+- Ordre alphabétique des imports
+
+### TypeScript
+
+- Types explicites pour toutes les props/interfaces
+- Éviter `any`, utiliser `unknown` si nécessaire
+- Utiliser les types génériques pour la réutilisabilité
+- Interfaces plutôt que types pour les objets
+
+---
+
+## 🧱 Règles générales
+
+- Toujours utiliser **TypeScript** (pas de JavaScript pur).
+- Activer les **types stricts** : `strict: true` dans `tsconfig.json`.
+- Ne jamais utiliser `any`, `as unknown`, ou les assertions de type non justifiées.
+- Préférer les **types explicites** aux inférences implicites si cela améliore la lisibilité.
+- Toujours suivre les conventions ESLint du projet.
+- Les imports doivent être **ESM** (`import` / `export`) — pas de `require`.
+- Toujours penser en **code modulaire**, éviter les fonctions globales.
+- Les noms de variables et fonctions doivent être clairs, descriptifs et en anglais.
+
+## 🧭 Documentation & commentaires
+
+- Ajouter un JSDoc clair sur les fonctions publiques ou les utilitaires partagés.
+- Expliquer le _pourquoi_ plus que le _comment_ dans les commentaires.
+- Préférer les docblocks structurés à des commentaires inline dispersés.
+
+## 🧠 Style et lisibilité
+
+- Préférer la clarté au "clever code".
+- Éviter les raccourcis ou la micro-optimisation prématurée.
+- Toujours nommer les fonctions selon leur intention (`getUserProfile` plutôt que `fetchData`).
+
+## 💬 Pour Copilot Chat
+
+Quand l’utilisateur demande :
+
+- "Explique ce code" → Fournir une explication pédagogique claire, sans jargon excessif.
+- "Refactorise" → Proposer une version plus claire, typée et conforme aux règles ci-dessus.
+- "Ajoute des tests" → Générer des tests Vitest minimalistes et lisibles.
+- "Ajoute la doc" → Produire du JSDoc complet et concis.

.github/.copilot-commit-message-instructions.md

@@ -1,3 +1,3 @@
 {
   ".": "2.0.0"
-}
+}