@wakastellar/ui 2.0.0 → 2.1.1

package/README.md

@@ -10,7 +10,7 @@
 
 **Bibliothèque de 200+ composants React professionnels pour applications Next.js modernes**
 
-[Quick Start](#quick-start) • [Tailwind v3/v4](#compatibilité-tailwind-v3--v4) • [Composants](#composants) • [Thèmes](#système-de-thèmes) • [i18n](#internationalisation)
+[Quick Start](#quick-start) • [CLI](#cli) • [Tailwind v3/v4](#compatibilité-tailwind-v3--v4) • [Composants](#composants) • [Thèmes](#système-de-thèmes) • [i18n](#internationalisation)
 
 </div>
 
@@ -31,7 +31,7 @@
 
 ## Quick Start
 
-### 1. Installation
+### Option 1 : Package complet (recommandé)
 
 ```bash
 pnpm add @wakastellar/ui
@@ -39,12 +39,6 @@ pnpm add @wakastellar/ui
 npm install @wakastellar/ui
 ```
 
-### 2. Configuration (selon votre version de Tailwind)
-
-Voir la section [Compatibilité Tailwind v3 / v4](#compatibilité-tailwind-v3--v4) ci-dessous.
-
-### 3. Utilisation
-
 ```tsx
 import { Button, Card, CardHeader, CardTitle, CardContent } from "@wakastellar/ui"
 
@@ -62,6 +56,24 @@ export default function Page() {
 }
 ```
 
+### Option 2 : CLI (composants individuels)
+
+```bash
+# Initialiser votre projet
+npx wakastellar-ui init
+
+# Ajouter des composants
+npx wakastellar-ui add button card input
+
+# Lister les composants disponibles
+npx wakastellar-ui list
+
+# Rechercher un composant
+npx wakastellar-ui search "date picker"
+```
+
+Voir la section [CLI](#cli) pour plus de détails.
+
 ---
 
 ## Compatibilité Tailwind v3 / v4
@@ -130,6 +142,57 @@ const preset = require("@wakastellar/ui/tailwind-preset")
 
 ---
 
+## CLI
+
+Le CLI permet d'ajouter des composants individuels à votre projet, similaire à shadcn/ui.
+
+### Commandes
+
+```bash
+# Initialiser un projet
+npx wakastellar-ui init
+npx wakastellar-ui init --defaults  # Utilise les paramètres par défaut
+
+# Ajouter des composants
+npx wakastellar-ui add button
+npx wakastellar-ui add button card input dialog
+npx wakastellar-ui add waka-datatable --overwrite
+
+# Lister les composants
+npx wakastellar-ui list
+npx wakastellar-ui list --type ui
+npx wakastellar-ui list --category gamification
+
+# Rechercher
+npx wakastellar-ui search button
+npx wakastellar-ui search "date picker"
+```
+
+### Configuration (components.json)
+
+Le fichier `components.json` est créé par `init` et configure votre projet :
+
+```json
+{
+  "$schema": "https://wakastellar.dev/schema.json",
+  "style": "default",
+  "tailwind": {
+    "version": "v4",
+    "css": "app/globals.css"
+  },
+  "aliases": {
+    "components": "@/components/ui",
+    "utils": "@/lib/utils"
+  }
+}
+```
+
+### Résolution des dépendances
+
+Le CLI installe automatiquement les dépendances internes. Par exemple, ajouter `waka-modal` installera aussi `button` s'il n'est pas déjà présent.
+
+---
+
 ## Composants
 
 ### Catégories principales

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,7 @@
+interface AddOptions {
+    overwrite?: boolean;
+    all?: boolean;
+    cwd: string;
+}
+export declare function addCommand(components: string[], options: AddOptions): Promise<void>;
+export {};

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,6 @@
+interface InitOptions {
+    yes?: boolean;
+    cwd: string;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,5 @@
+interface ListOptions {
+    category?: string;
+}
+export declare function listCommand(options: ListOptions): Promise<void>;
+export {};

package/dist/cli/commands/search.d.ts

@@ -0,0 +1 @@
+export declare function searchCommand(query: string): Promise<void>;