@configjs/cli 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Julien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,431 @@
+# confjs
+
+<div align="center">
+
+**Configure your frontend stack, instantly**
+
+[![npm version](https://img.shields.io/npm/v/@configjs/cli.svg)](https://www.npmjs.com/package/@configjs/cli)
+[![CI Tests](https://github.com/julien-lin/configjs/actions/workflows/test.yml/badge.svg)](https://github.com/julien-lin/configjs/actions/workflows/test.yml)
+[![Publish](https://github.com/julien-lin/configjs/actions/workflows/publish.yml/badge.svg)](https://github.com/julien-lin/configjs/actions/workflows/publish.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node version](https://img.shields.io/node/v/@configjs/cli.svg)](https://nodejs.org)
+
+Un utilitaire CLI intelligent pour installer et configurer automatiquement vos bibliothèques frontend par catégories fonctionnelles.
+
+[Installation](#-installation) • [Usage](#-usage) • [Fonctionnalités](#-fonctionnalités) • [Documentation](#-documentation)
+
+</div>
+
+---
+
+## 🎯 Pourquoi confjs ?
+
+Le bootstrap d'un projet frontend moderne prend **2-4 heures** entre l'installation des bibliothèques, leur configuration, et la résolution des conflits potentiels.
+
+**confjs** réduit ce temps à **moins de 2 minutes** en :
+
+- ✅ **Détectant automatiquement** votre environnement (React, TypeScript, Vite, etc.)
+- ✅ **Installant ET configurant** les bibliothèques de votre choix
+- ✅ **Validant les compatibilités** pour éviter les conflits
+- ✅ **Générant le code initial** nécessaire (routes, stores, configs)
+- ✅ Garantissant un **projet immédiatement utilisable**
+
+## 🚀 Installation
+
+Aucune installation nécessaire ! Utilisez directement via `npx` :
+
+```bash
+npx @configjs/cli react
+```
+
+Ou installez globalement :
+
+```bash
+npm install -g @configjs/cli
+confjs react
+```
+
+## 📦 Usage
+
+### Mode interactif (recommandé)
+
+```bash
+cd mon-projet-react
+npx confjs react
+```
+
+L'assistant vous guidera à travers les différentes catégories :
+
+```
+🔍 Détection du contexte...
+   ✓ Framework: React 18.2.0
+   ✓ TypeScript: Oui
+   ✓ Bundler: Vite 5.0.0
+
+📦 Sélectionnez vos bibliothèques :
+
+? Routing (recommandé)
+  ● react-router-dom
+  ○ @tanstack/router
+  ○ Aucun
+
+? State Management
+  ○ Redux Toolkit
+  ● zustand
+  ○ jotai
+  ○ Aucun
+
+...
+```
+
+### Mode configuration (CI/CD)
+
+Créez un fichier `.confjs.json` :
+
+```json
+{
+  "routing": "react-router-dom",
+  "state": "zustand",
+  "css": "tailwindcss",
+  "http": "axios",
+  "tooling": ["eslint", "prettier"]
+}
+```
+
+Puis exécutez :
+
+```bash
+npx confjs react --config .confjs.json
+```
+
+### Mode dry-run (simulation)
+
+Visualisez ce qui sera installé sans rien modifier :
+
+```bash
+npx confjs react --dry-run
+```
+
+## ✨ Fonctionnalités
+
+### 🎯 Catégories supportées
+
+| Catégorie | Bibliothèques disponibles |
+|-----------|---------------------------|
+| **Routing** | react-router-dom, @tanstack/router |
+| **State Management** | Redux Toolkit, Zustand, Jotai |
+| **HTTP Client** | Axios, Fetch wrapper |
+| **CSS/UI** | TailwindCSS, Bootstrap |
+| **Tooling** | ESLint, Prettier, Husky, lint-staged, commitlint |
+
+### 🧠 Détection intelligente
+
+confjs détecte automatiquement :
+
+- ✅ Framework et version (React)
+- ✅ TypeScript
+- ✅ Bundler (Vite, Create React App, Webpack)
+- ✅ Package manager (npm, yarn, pnpm, bun)
+- ✅ Structure du projet
+- ✅ Bibliothèques déjà installées
+
+### ⚙️ Configuration automatique
+
+Contrairement aux simples installers, **confjs configure réellement** vos bibliothèques :
+
+**Exemple avec React Router :**
+```
+✓ Installation de react-router-dom
+✓ Création de src/router.tsx
+✓ Création de src/routes/Home.tsx
+✓ Intégration dans src/App.tsx
+✓ Configuration complète et fonctionnelle
+```
+
+**Exemple avec TailwindCSS :**
+```
+✓ Installation de tailwindcss, postcss, autoprefixer
+✓ Création de tailwind.config.js
+✓ Création de postcss.config.js
+✓ Injection dans src/index.css
+✓ Configuration JIT activée
+```
+
+### 🛡️ Validation des compatibilités
+
+confjs vérifie automatiquement :
+
+- ❌ **Conflits exclusifs** : Redux + Zustand (un seul state manager)
+- ⚠️ **Avertissements** : TailwindCSS + Bootstrap (approches différentes)
+- ✅ **Dépendances croisées** : TailwindCSS → PostCSS (installé automatiquement)
+
+### 🔄 Rollback automatique
+
+En cas d'erreur durant l'installation :
+
+```
+❌ Erreur détectée
+↺ Rollback en cours...
+✓ Fichiers restaurés
+✓ package.json restauré
+```
+
+## 🎨 Options CLI
+
+```bash
+npx confjs react [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--yes`, `-y` | Accepte tous les choix par défaut |
+| `--dry-run`, `-d` | Simule sans écrire sur le disque |
+| `--silent`, `-s` | Mode non-interactif (CI/CD) |
+| `--debug` | Active les logs détaillés |
+| `--config <file>`, `-c` | Utilise un fichier de configuration |
+| `--force`, `-f` | Force l'installation (écrase les configs) |
+
+### Exemples
+
+```bash
+# Mode rapide avec valeurs par défaut
+npx confjs react --yes
+
+# Simulation uniquement
+npx confjs react --dry-run
+
+# Pour CI/CD
+npx confjs react --silent --config .confjs.json
+
+# Avec logs détaillés
+npx confjs react --debug
+```
+
+## 📚 Commandes additionnelles
+
+### Liste des bibliothèques disponibles
+
+```bash
+npx confjs list
+```
+
+Filtrer par catégorie :
+
+```bash
+npx confjs list --category routing
+npx confjs list --category state
+```
+
+### Vérifier la compatibilité
+
+```bash
+npx confjs check --config .confjs.json
+```
+
+### Aide
+
+```bash
+npx confjs --help
+npx confjs react --help
+```
+
+## 🎯 Exemples d'utilisation
+
+### Setup complet d'un projet React
+
+```bash
+# Créer un nouveau projet
+npm create vite@latest mon-app -- --template react-ts
+cd mon-app
+
+# Installer et configurer la stack
+npx confjs react
+
+# Sélectionner :
+# - Routing: react-router-dom
+# - State: zustand
+# - CSS: tailwindcss
+# - HTTP: axios
+# - Tooling: eslint, prettier
+
+# Démarrer
+npm run dev
+```
+
+### Configuration pré-définie pour l'équipe
+
+```bash
+# .confjs.json (à versionner dans Git)
+{
+  "routing": "react-router-dom",
+  "state": "zustand",
+  "css": "tailwindcss",
+  "http": "axios",
+  "tooling": ["eslint", "prettier", "husky"]
+}
+
+# Chaque membre de l'équipe exécute :
+npx confjs react --config .confjs.json
+```
+
+### Pipeline CI/CD
+
+```yaml
+# .github/workflows/setup.yml
+- name: Setup project
+  run: npx confjs react --silent --config .confjs.json
+```
+
+## 🏗️ Architecture
+
+### Système de plugins
+
+confjs utilise une architecture modulaire où chaque bibliothèque est un plugin autonome :
+
+```typescript
+interface Plugin {
+  name: string
+  category: Category
+  frameworks: Framework[]
+  
+  // Compatibilité
+  compatibleWith?: string[]
+  incompatibleWith?: string[]
+  
+  // Lifecycle
+  install: (ctx: ProjectContext) => Promise<void>
+  configure: (ctx: ProjectContext) => Promise<void>
+  rollback?: (ctx: ProjectContext) => Promise<void>
+}
+```
+
+### Extensibilité
+
+Créez vos propres plugins :
+
+```bash
+npm install confjs-plugin-react-query
+```
+
+confjs détectera et chargera automatiquement les plugins préfixés par `confjs-plugin-*`.
+
+## 🔧 Configuration
+
+### Fichier .confjs.json
+
+```json
+{
+  "routing": "react-router-dom",
+  "state": "zustand",
+  "css": "tailwindcss",
+  "http": "axios",
+  "forms": "react-hook-form",
+  "tooling": ["eslint", "prettier", "husky"],
+  
+  "options": {
+    "typescript": true,
+    "strict": true,
+    "examples": true
+  }
+}
+```
+
+### Fichier .confjs.yaml (alternatif)
+
+```yaml
+routing: react-router-dom
+state: zustand
+css: tailwindcss
+http: axios
+
+tooling:
+  - eslint
+  - prettier
+  - husky
+
+options:
+  typescript: true
+  strict: true
+  examples: true
+```
+
+## 🤝 Contribuer
+
+Les contributions sont les bienvenues ! Consultez [CONTRIBUTING.md](./docs/CONTRIBUTING.md) pour les guidelines.
+
+### Développer un plugin
+
+Consultez [PLUGIN_DEVELOPMENT.md](./docs/PLUGIN_DEVELOPMENT.md) pour créer vos propres plugins.
+
+### Setup développement
+
+```bash
+# Clone
+git clone https://github.com/julien/confjs.git
+cd confjs
+
+# Install
+npm install
+
+# Dev mode
+npm run dev
+
+# Tests
+npm run test
+npm run test:watch
+
+# Build
+npm run build
+```
+
+## 📋 Requirements
+
+- **Node.js** ≥ 18.0.0
+- **npm** / **yarn** / **pnpm** / **bun**
+- Un projet React existant
+
+## 🗺️ Roadmap
+
+### v1.0 (MVP) ✅
+- [x] Support React
+- [x] 12 plugins intégrés
+- [x] Validation compatibilités
+- [x] Configuration automatique
+
+### v1.1 (Q1 2026)
+- [ ] Support Next.js
+- [ ] Support Remix
+- [ ] Plugins UI (MUI, Chakra, Radix)
+- [ ] Plugins forms (React Hook Form, Formik)
+
+### v2.0 (Q2 2026)
+- [ ] Support Vue 3
+- [ ] Support Svelte
+- [ ] Interface web de configuration
+
+### v2.x (Future)
+- [ ] Templates personnalisables
+- [ ] Marketplace de plugins
+- [ ] React Native support
+
+## 📄 License
+
+[MIT](./LICENSE) © Julien
+
+## 🙏 Remerciements
+
+Inspiré par les meilleures pratiques de :
+- [Vite](https://vitejs.dev)
+- [Create T3 App](https://create.t3.gg)
+- [Projen](https://projen.io)
+
+---
+
+<div align="center">
+
+**Fait avec ❤️ pour la communauté frontend**
+
+[Changelog](./CHANGELOG.md) • [Issues](https://github.com/julien/confjs/issues) • [Contributing](./docs/CONTRIBUTING.md)
+
+</div>
+

package/dist/check-JF56SNQC.js

@@ -0,0 +1,126 @@
+import {
+  CompatibilityValidator,
+  compatibilityRules
+} from "./chunk-PQLKGF6I.js";
+import {
+  logger,
+  pluginRegistry
+} from "./chunk-5T664O5A.js";
+
+// src/cli/commands/check.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { existsSync } from "fs";
+async function checkCompatibility(options) {
+  try {
+    console.log("\n\u{1F50D} V\xE9rification de la compatibilit\xE9\n");
+    const configPath = options.config || join(process.cwd(), ".confjs.json");
+    if (!existsSync(configPath)) {
+      console.error(`\u274C Fichier de configuration introuvable: ${configPath}`);
+      console.log("\n\u{1F4A1} Cr\xE9ez un fichier .confjs.json avec le format suivant:");
+      console.log(
+        JSON.stringify(
+          {
+            plugins: ["react-router-dom", "zustand", "tailwindcss"]
+          },
+          null,
+          2
+        )
+      );
+      process.exit(1);
+    }
+    const configContent = await readFile(configPath, "utf-8");
+    let config;
+    try {
+      const parsed = JSON.parse(configContent);
+      config = parsed;
+    } catch {
+      console.error(
+        "\u274C Erreur de parsing JSON dans le fichier de configuration"
+      );
+      process.exit(1);
+    }
+    if (!config.plugins || !Array.isArray(config.plugins)) {
+      console.error("\u274C Format de configuration invalide");
+      console.log(
+        '   Le champ "plugins" doit \xEAtre un tableau de noms de packages'
+      );
+      process.exit(1);
+    }
+    const selectedPlugins = config.plugins.map((name) => pluginRegistry.find((p) => p.name === name)).filter(Boolean);
+    if (selectedPlugins.length === 0) {
+      console.error("\u274C Aucun plugin valide trouv\xE9 dans la configuration");
+      process.exit(1);
+    }
+    const notFound = config.plugins.filter(
+      (name) => !pluginRegistry.find((p) => p.name === name)
+    );
+    if (notFound.length > 0) {
+      console.warn("\n\u26A0\uFE0F  Plugins non trouv\xE9s:");
+      for (const name of notFound) {
+        console.warn(`   \u2022 ${name}`);
+      }
+    }
+    console.log(`\u{1F4E6} Plugins \xE0 v\xE9rifier: ${selectedPlugins.length}`);
+    for (const plugin of selectedPlugins) {
+      if (plugin) {
+        console.log(`   \u2022 ${plugin.displayName} (${plugin.name})`);
+      }
+    }
+    console.log("\n\u{1F50D} Analyse de compatibilit\xE9...\n");
+    const validator = new CompatibilityValidator(compatibilityRules);
+    const validation = validator.validate(
+      selectedPlugins
+    );
+    if (validation.errors.length === 0) {
+      console.log("\u2705 Aucun conflit d\xE9tect\xE9\n");
+    } else {
+      console.error("\u274C Conflits d\xE9tect\xE9s:\n");
+      for (const error of validation.errors) {
+        console.error(`   \u2022 ${error.message}`);
+        if ("plugins" in error && error.plugins) {
+          console.error(`     Plugins: ${error.plugins.join(", ")}`);
+        }
+      }
+      console.log("");
+    }
+    if (validation.warnings.length > 0) {
+      console.warn("\u26A0\uFE0F  Avertissements:\n");
+      for (const warning of validation.warnings) {
+        console.warn(`   \u2022 ${warning.message}`);
+        if ("plugins" in warning && warning.plugins) {
+          console.warn(`     Plugins: ${warning.plugins.join(", ")}`);
+        }
+      }
+      console.log("");
+    }
+    if (validation.suggestions.length > 0) {
+      console.log("\u{1F4A1} Suggestions:\n");
+      for (const suggestion of validation.suggestions) {
+        console.log(`   \u2022 ${suggestion}`);
+      }
+      console.log("");
+    }
+    if (validation.valid) {
+      console.log(
+        "\u2728 Configuration valide ! Vous pouvez proc\xE9der \xE0 l'installation.\n"
+      );
+      process.exit(0);
+    } else {
+      console.error(
+        "\u274C Configuration invalide. Corrigez les erreurs avant d'installer.\n"
+      );
+      process.exit(2);
+    }
+  } catch (error) {
+    logger.error("Erreur lors de la v\xE9rification:", error);
+    if (error instanceof Error) {
+      console.error(`
+\u274C ${error.message}`);
+    }
+    process.exit(1);
+  }
+}
+export {
+  checkCompatibility
+};