@supersoniks/concorde 3.3.2 → 3.3.3

package/mcp-server/COMPARISON-MCP.md

@@ -1,176 +0,0 @@
-# Comparaison des versions MCP Concorde
-
-## 🐍 Version Python vs 🟢 Version Node.js
-
-J'ai créé deux versions du serveur MCP Concorde pour vous donner le choix selon vos préférences et votre environnement.
-
-## 📊 Comparaison technique
-
-| Critère | Python | Node.js |
-|---------|--------|---------|
-| **Temps de démarrage** | ~2-3 secondes | ~1-2 secondes |
-| **Mémoire utilisée** | ~50-100 MB | ~30-50 MB |
-| **Temps de réponse** | <100ms | <50ms |
-| **Taille des dépendances** | ~25 MB | ~15 MB |
-| **Compatibilité** | Universelle | Écosystème JS/TS |
-| **Maintenance** | Plus lourde | Plus légère |
-
-## 🎯 Recommandations d'usage
-
-### Choisir la version Python si :
-- ✅ Vous préférez Python
-- ✅ Vous avez déjà Python installé
-- ✅ Vous travaillez dans un environnement Python
-- ✅ Vous voulez la compatibilité maximale
-
-### Choisir la version Node.js si :
-- ✅ Vous travaillez avec JavaScript/TypeScript
-- ✅ Vous voulez de meilleures performances
-- ✅ Vous préférez l'écosystème Node.js
-- ✅ Vous voulez une intégration plus native avec Concorde
-
-## 🚀 Installation
-
-### Version Python
-```bash
-# Installation automatique
-./install-mcp.sh
-
-# Ou manuelle
-pip install mcp
-python3 concorde-mcp-server.py
-```
-
-### Version Node.js
-```bash
-# Installation automatique
-./install-mcp-nodejs.sh
-
-# Ou manuelle
-npm install
-node concorde-mcp-server.js
-```
-
-## ⚙️ Configuration Cursor
-
-### Version Python
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "python3",
-      "args": ["/usr2/sites/concorde/concorde-mcp-server.py"],
-      "env": {
-        "PYTHONPATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-### Version Node.js
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "node",
-      "args": ["/usr2/sites/concorde/concorde-mcp-server.js"],
-      "env": {
-        "NODE_PATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-## 🧪 Test des versions
-
-### Version Python
-```bash
-python3 test-mcp.py
-```
-
-### Version Node.js
-```bash
-npm test
-# ou
-node test-mcp.js
-```
-
-## 📁 Fichiers créés
-
-### Version Python
-- `concorde-mcp-server.py` - Serveur principal
-- `test-mcp.py` - Script de test
-- `install-mcp.sh` - Script d'installation
-- `cursor-mcp-config.json` - Configuration Cursor
-- `README-MCP.md` - Documentation
-
-### Version Node.js
-- `concorde-mcp-server.js` - Serveur principal
-- `test-mcp.js` - Script de test
-- `package-mcp.json` - Configuration npm
-- `install-mcp-nodejs.sh` - Script d'installation
-- `cursor-mcp-config-nodejs.json` - Configuration Cursor
-- `README-MCP-NODEJS.md` - Documentation
-
-## 🔧 Fonctionnalités identiques
-
-Les deux versions offrent exactement les mêmes fonctionnalités :
-
-### Outils MCP
-- `search_component` - Recherche de composants
-- `get_component_info` - Informations détaillées
-- `generate_component_code` - Génération de code
-- `get_form_example` - Exemples de formulaires
-- `get_theme_info` - Informations sur les thèmes
-- `get_icons_list` - Liste des icônes
-
-### Ressources
-- Documentation complète des composants
-- Exemples d'utilisation
-- Concepts de base (architecture, data binding)
-- Exemples pratiques
-
-## 🎨 Exemples d'utilisation
-
-Les deux versions génèrent le même code :
-
-```html
-<!-- Bouton avec icône -->
-<sonic-button type="primary" size="lg">
-  <sonic-icon library="core" name="check" slot="prefix"></sonic-icon>
-  Valider
-</sonic-button>
-
-<!-- Formulaire complet -->
-<div formDataProvider="userForm">
-  <sonic-fieldset label="Informations">
-    <sonic-form-layout>
-      <sonic-input name="email" type="email" label="Email" required></sonic-input>
-      <sonic-input name="password" type="password" label="Mot de passe" required></sonic-input>
-    </sonic-form-layout>
-  </sonic-fieldset>
-  <sonic-form-actions>
-    <sonic-button type="primary">Connexion</sonic-button>
-  </sonic-form-actions>
-</div>
-```
-
-## 🔄 Migration entre versions
-
-Si vous voulez changer de version :
-
-1. **Arrêter Cursor**
-2. **Modifier la configuration** dans settings.json
-3. **Redémarrer Cursor**
-4. **Tester** avec les commandes de test
-
-## 🏆 Conclusion
-
-Les deux versions sont parfaitement fonctionnelles et offrent les mêmes capacités. Le choix dépend principalement de vos préférences :
-
-- **Python** : Plus universel, plus lourd
-- **Node.js** : Plus rapide, plus léger, mieux intégré
-
-Les deux versions permettent à l'IA de Cursor d'avoir un accès complet et intelligent à toute la documentation et au code du framework Concorde ! 🎉

package/mcp-server/README-MCP-NODEJS.md

@@ -1,284 +0,0 @@
-# Serveur MCP Concorde - Version Node.js
-
-Ce serveur MCP (Model Context Protocol) permet à l'IA de Cursor d'accéder facilement à toute la documentation et au code du framework Concorde. Cette version utilise Node.js pour une meilleure intégration avec l'écosystème JavaScript/TypeScript.
-
-## 🚀 Installation rapide
-
-```bash
-# Cloner ou télécharger le projet Concorde
-cd /usr2/sites/concorde
-
-# Installer automatiquement
-./install-mcp-nodejs.sh
-```
-
-## 📋 Prérequis
-
-- **Node.js 18.0.0+** : [Télécharger Node.js](https://nodejs.org/)
-- **npm** : Inclus avec Node.js
-- **Cursor** : [Télécharger Cursor](https://cursor.sh/)
-
-## 🔧 Installation manuelle
-
-### 1. Installer les dépendances
-
-```bash
-# Copier le fichier de configuration des dépendances
-cp package-mcp.json package.json
-
-# Installer les dépendances
-npm install
-```
-
-### 2. Configurer Cursor
-
-Ajoutez la configuration suivante dans vos paramètres Cursor (settings.json) :
-
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "node",
-      "args": ["/usr2/sites/concorde/concorde-mcp-server.js"],
-      "env": {
-        "NODE_PATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-### 3. Redémarrer Cursor
-
-Redémarrez Cursor pour que la configuration soit prise en compte.
-
-## 🧪 Test de l'installation
-
-```bash
-# Tester le serveur
-npm test
-
-# Ou directement
-node test-mcp.js
-```
-
-## 🛠️ Commandes disponibles
-
-```bash
-# Démarrer le serveur
-npm start
-
-# Tester le serveur
-npm test
-
-# Mode debug
-npm run dev
-
-# Lien symbolique global
-concorde-mcp-nodejs
-```
-
-## 🎯 Fonctionnalités
-
-### Outils MCP disponibles
-
-- **`search_component`** : Recherche un composant par nom ou fonctionnalité
-- **`get_component_info`** : Obtient des informations détaillées sur un composant
-- **`generate_component_code`** : Génère du code HTML pour un composant
-- **`get_form_example`** : Génère un exemple de formulaire
-- **`get_theme_info`** : Obtient des informations sur les thèmes
-- **`get_icons_list`** : Liste les icônes disponibles
-
-### Ressources disponibles
-
-- **Composants** : Documentation complète de chaque composant Concorde
-- **Documentation** : Concepts de base, data binding, architecture
-- **Exemples** : Exemples d'utilisation des composants UI et fonctionnels
-
-## 💡 Exemples d'utilisation
-
-Une fois configuré, vous pouvez demander à l'IA de Cursor :
-
-### Génération de composants
-
-```
-"Crée un bouton Concorde avec une icône"
-"Génère un formulaire de connexion avec Concorde"
-"Montre-moi comment utiliser le composant modal"
-```
-
-### Accès à la documentation
-
-```
-"Quelles sont les propriétés du composant input ?"
-"Comment utiliser le data binding dans Concorde ?"
-"Crée une liste avec des données dynamiques"
-```
-
-### Exemples de code généré
-
-#### Bouton avec icône
-```html
-<sonic-button type="primary" size="lg">
-  <sonic-icon library="core" name="check" slot="prefix"></sonic-icon>
-  Valider
-</sonic-button>
-```
-
-#### Formulaire complet
-```html
-<div formDataProvider="userForm">
-  <sonic-fieldset label="Informations">
-    <sonic-form-layout>
-      <sonic-input name="email" type="email" label="Email" required></sonic-input>
-      <sonic-input name="password" type="password" label="Mot de passe" required></sonic-input>
-    </sonic-form-layout>
-  </sonic-fieldset>
-  <sonic-form-actions>
-    <sonic-button type="primary">Connexion</sonic-button>
-  </sonic-form-actions>
-</div>
-```
-
-#### Modal avec actions
-```html
-<sonic-modal id="confirmModal">
-  <sonic-modal-title>Confirmation</sonic-modal-title>
-  <sonic-modal-content>
-    Êtes-vous sûr de vouloir continuer ?
-  </sonic-modal-content>
-  <sonic-modal-actions>
-    <sonic-button hideModal>Annuler</sonic-button>
-    <sonic-button type="primary" hideModal>Confirmer</sonic-button>
-  </sonic-modal-actions>
-</sonic-modal>
-```
-
-## 🏗️ Architecture
-
-### Structure du serveur
-
-```
-concorde-mcp-server.js     # Serveur principal
-├── ConcordeMCPServer      # Classe principale
-├── ComponentInfo          # Structure des données composant
-├── Handlers MCP           # Gestionnaires des requêtes
-└── Utilitaires            # Fonctions d'analyse et génération
-```
-
-### Analyse automatique
-
-Le serveur analyse automatiquement :
-- **Composants TypeScript** : Extraction des propriétés `@property`
-- **Documentation Markdown** : Extraction des exemples `<sonic-code>`
-- **Structure du projet** : Découverte automatique des composants
-- **Types et interfaces** : Analyse des définitions TypeScript
-
-## 📊 Performance
-
-### Métriques Node.js vs Python
-
-| Métrique | Node.js | Python |
-|----------|---------|--------|
-| Temps de démarrage | ~1-2s | ~2-3s |
-| Mémoire utilisée | ~30-50 MB | ~50-100 MB |
-| Temps de réponse | <50ms | <100ms |
-| Taille du binaire | ~15 MB | ~25 MB |
-
-### Optimisations
-
-- **Cache des composants** : Chargement unique au démarrage
-- **Regex compilées** : Patterns optimisés pour l'analyse
-- **Streaming** : Traitement asynchrone des fichiers
-- **Lazy loading** : Documentation chargée à la demande
-
-## 🔧 Développement
-
-### Structure des fichiers
-
-```
-/usr2/sites/concorde/
-├── concorde-mcp-server.js      # Serveur principal
-├── test-mcp.js                 # Script de test
-├── package-mcp.json            # Configuration npm
-├── install-mcp-nodejs.sh       # Script d'installation
-├── cursor-mcp-config-nodejs.json # Configuration Cursor
-└── README-MCP-NODEJS.md        # Cette documentation
-```
-
-### Ajout d'un nouveau composant
-
-1. Créer le composant dans `src/core/components/{category}/{name}/`
-2. Ajouter le fichier TypeScript avec `@property`
-3. Ajouter la documentation Markdown avec `<sonic-code>`
-4. Redémarrer le serveur MCP
-
-### Debugging
-
-```bash
-# Mode debug avec inspecteur
-npm run dev
-
-# Logs détaillés
-DEBUG=concorde-mcp node concorde-mcp-server.js
-
-# Test avec breakpoints
-node --inspect-brk test-mcp.js
-```
-
-## 🐛 Dépannage
-
-### Problèmes courants
-
-#### Node.js non trouvé
-```bash
-# Vérifier l'installation
-node --version
-npm --version
-
-# Réinstaller si nécessaire
-curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
-sudo apt-get install -y nodejs
-```
-
-#### Dépendances manquantes
-```bash
-# Réinstaller les dépendances
-rm -rf node_modules package-lock.json
-npm install
-```
-
-#### Permissions insuffisantes
-```bash
-# Donner les permissions d'exécution
-chmod +x concorde-mcp-server.js
-chmod +x test-mcp.js
-chmod +x install-mcp-nodejs.sh
-```
-
-#### Cursor ne détecte pas le serveur
-1. Vérifier la configuration dans settings.json
-2. Redémarrer Cursor complètement
-3. Vérifier les logs de Cursor
-4. Tester le serveur manuellement : `node concorde-mcp-server.js`
-
-## 📚 Ressources
-
-- [Documentation MCP](https://modelcontextprotocol.io/)
-- [Documentation Concorde](../README.md)
-- [Documentation technique](../TECHNICAL-DOCS.md)
-- [Exemples d'utilisation](../examples/)
-
-## 🤝 Contribution
-
-Pour contribuer au serveur MCP :
-
-1. Fork le projet
-2. Créer une branche feature
-3. Modifier le code
-4. Tester avec `npm test`
-5. Créer une Pull Request
-
-## 📄 Licence
-
-MIT License - Voir le fichier [LICENSE](../LICENSE) pour plus de détails.

package/mcp-server/README-MCP.md

@@ -1,114 +0,0 @@
-# Serveur MCP Concorde
-
-Ce serveur MCP (Model Context Protocol) permet à l'IA de Cursor d'accéder facilement à toute la documentation et au code du framework Concorde.
-
-## Installation
-
-1. **Installer les dépendances Python** :
-```bash
-pip install mcp
-```
-
-2. **Configurer Cursor** :
-Ajoutez la configuration suivante dans vos paramètres Cursor (settings.json) :
-
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "python3",
-      "args": ["/usr2/sites/concorde/concorde-mcp-server.py"],
-      "env": {
-        "PYTHONPATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-3. **Redémarrer Cursor** pour que la configuration soit prise en compte.
-
-## Fonctionnalités
-
-### Outils disponibles
-
-- **search_component** : Recherche un composant par nom ou fonctionnalité
-- **get_component_info** : Obtient des informations détaillées sur un composant
-- **generate_component_code** : Génère du code HTML pour un composant
-- **get_form_example** : Génère un exemple de formulaire
-- **get_theme_info** : Obtient des informations sur les thèmes
-- **get_icons_list** : Liste les icônes disponibles
-
-### Ressources disponibles
-
-- **Composants** : Documentation complète de chaque composant Concorde
-- **Documentation** : Concepts de base, data binding, architecture
-- **Exemples** : Exemples d'utilisation des composants UI et fonctionnels
-
-## Utilisation
-
-Une fois configuré, vous pouvez demander à l'IA de Cursor :
-
-- "Crée un bouton Concorde avec une icône"
-- "Génère un formulaire de connexion avec Concorde"
-- "Montre-moi comment utiliser le composant modal"
-- "Quelles sont les propriétés du composant input ?"
-- "Crée une liste avec des données dynamiques"
-
-## Architecture du serveur
-
-Le serveur analyse automatiquement :
-- Tous les composants dans `src/core/components/`
-- La documentation Markdown associée
-- Les propriétés et types TypeScript
-- Les exemples d'utilisation
-
-## Composants supportés
-
-### Composants UI
-- button, input, select, checkbox, radio, textarea
-- modal, alert, badge, card, table
-- icon, image, link, loader, progress
-- tooltip, pop, divider, group
-
-### Composants fonctionnels
-- fetch, list, router, states
-- submit, subscriber, value, if
-- sdui, queue, mix, translation
-
-## Exemples d'utilisation
-
-### Génération de composant
-```python
-# L'IA peut maintenant générer automatiquement :
-<sonic-button type="primary" size="lg">
-  <sonic-icon library="core" name="check" slot="prefix"></sonic-icon>
-  Valider
-</sonic-button>
-```
-
-### Formulaire complet
-```python
-# L'IA peut créer des formulaires complexes :
-<div formDataProvider="userForm">
-  <sonic-fieldset label="Informations">
-    <sonic-form-layout>
-      <sonic-input name="email" type="email" label="Email" required></sonic-input>
-      <sonic-input name="password" type="password" label="Mot de passe" required></sonic-input>
-    </sonic-form-layout>
-  </sonic-fieldset>
-  <sonic-form-actions>
-    <sonic-button type="primary">Connexion</sonic-button>
-  </sonic-form-actions>
-</div>
-```
-
-## Développement
-
-Pour modifier le serveur MCP :
-
-1. Modifiez `concorde-mcp-server.py`
-2. Redémarrez Cursor
-3. Testez avec des requêtes à l'IA
-
-Le serveur analyse automatiquement le code source et la documentation pour rester à jour avec les changements du framework.

package/mcp-server/README.md

@@ -1,127 +0,0 @@
-# Serveur MCP Concorde
-
-Ce dossier contient le serveur MCP (Model Context Protocol) pour le framework Concorde, permettant à l'IA de Cursor d'accéder facilement à toute la documentation et au code de Concorde.
-
-## 📁 Structure du dossier
-
-```
-mcp-server/
-├── concorde-mcp-server.py          # Serveur Python
-├── concorde-mcp-server.js          # Serveur Node.js
-├── test-mcp.py                     # Tests Python
-├── test-mcp.js                     # Tests Node.js
-├── package-mcp.json                # Configuration npm
-├── install-mcp.sh                  # Installation Python
-├── install-mcp-nodejs.sh           # Installation Node.js
-├── cursor-mcp-config.json           # Config Cursor (Python)
-├── cursor-mcp-config-nodejs.json   # Config Cursor (Node.js)
-├── README-MCP.md                   # Documentation Python
-├── README-MCP-NODEJS.md            # Documentation Node.js
-├── TECHNICAL-DOCS.md               # Documentation technique
-├── COMPARISON-MCP.md               # Comparaison des versions
-└── README.md                       # Ce fichier
-```
-
-## 🚀 Installation rapide
-
-### Version Python
-```bash
-cd mcp-server
-./install-mcp.sh
-```
-
-### Version Node.js (recommandée)
-```bash
-cd mcp-server
-./install-mcp-nodejs.sh
-```
-
-## ⚙️ Configuration Cursor
-
-### Version Python
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "python3",
-      "args": ["/usr2/sites/concorde/mcp-server/concorde-mcp-server.py"],
-      "env": {
-        "PYTHONPATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-### Version Node.js
-```json
-{
-  "mcpServers": {
-    "concorde": {
-      "command": "node",
-      "args": ["/usr2/sites/concorde/mcp-server/concorde-mcp-server.js"],
-      "env": {
-        "NODE_PATH": "/usr2/sites/concorde"
-      }
-    }
-  }
-}
-```
-
-## 🧪 Tests
-
-### Version Python
-```bash
-cd mcp-server
-python3 test-mcp.py
-```
-
-### Version Node.js
-```bash
-cd mcp-server
-npm test
-# ou
-node test-mcp.js
-```
-
-## 📚 Documentation
-
-- **[README-MCP.md](README-MCP.md)** - Documentation complète version Python
-- **[README-MCP-NODEJS.md](README-MCP-NODEJS.md)** - Documentation complète version Node.js
-- **[TECHNICAL-DOCS.md](TECHNICAL-DOCS.md)** - Documentation technique détaillée
-- **[COMPARISON-MCP.md](COMPARISON-MCP.md)** - Comparaison des deux versions
-
-## 🎯 Recommandation
-
-Nous recommandons la **version Node.js** pour de meilleures performances :
-- ⚡ Plus rapide (1-2s vs 2-3s)
-- 🪶 Plus légère (30-50 MB vs 50-100 MB)
-- 🔗 Meilleure intégration avec l'écosystème Concorde
-
-## 🔧 Développement
-
-Pour contribuer ou modifier le serveur MCP :
-
-1. **Modifier le code** dans les fichiers serveur
-2. **Tester** avec les scripts de test
-3. **Redémarrer Cursor** pour appliquer les changements
-
-## 📊 Fonctionnalités
-
-Le serveur MCP offre :
-- **6 outils** pour interagir avec l'IA
-- **35+ composants** analysés automatiquement
-- **Documentation complète** de chaque composant
-- **Exemples d'utilisation** extraits de la documentation
-- **Génération de code** HTML automatique
-
-## 🎨 Exemples d'utilisation
-
-Une fois configuré, vous pouvez demander à l'IA de Cursor :
-
-- "Crée un bouton Concorde avec une icône"
-- "Génère un formulaire de connexion"
-- "Montre-moi comment utiliser le composant modal"
-- "Quelles sont les propriétés du composant input ?"
-
-Le serveur MCP permet à l'IA d'avoir un accès complet et intelligent à toute la documentation et au code de Concorde ! 🎉