docstodev 2.1.1 → 3.0.2

package/README.md

@@ -0,0 +1,60 @@
+
+DocsToDev 🚀
+Solution d'automatisation de documentation technique intelligente
+
+DocsToDev est une extension avancée pour Visual Studio Code conçue pour générer automatiquement une documentation technique complète, structurée et compréhensible à partir du code source d'un projet. Elle transforme n'importe quelle base de code complexe en une source de savoir claire et exploitable pour tous les acteurs du projet.
+
+✨ Fonctionnalités Clés
+
+Analyse Statique Profonde : Analyse l'intégralité de l'arborescence en parcourant tous les fichiers et sous-dossiers pertinents.
+
+
+Exclusion Intelligente : Ignore automatiquement les répertoires non essentiels comme node_modules, .git, dist, ou .docstodev.
+
+
+Système Hybride Unique : Combine une analyse statique déterministe (imports, exports, routes) avec une couche d'Intelligence Artificielle (GPT, Grok) pour des descriptions humaines explicites sans "inventer" de données.
+
+
+Visualisation des Dépendances : Génération automatique de graphiques (Mermaid) pour visualiser les interactions entre composants, APIs et services.
+
+Mode Incrémental & Cache : Système de cache performant permettant de n'analyser que les fichiers modifiés depuis la dernière session.
+
+
+Multi-formats d'Export : Exportation de la documentation en .md (Markdown), .html (interactif), .pdf et .txt.
+
+🛠️ Installation et Prérequis
+Pour utiliser DocsToDev en ligne de commande, suivez ces étapes :
+
+Installation des dépendances :
+
+Compilation du projet (nécessaire pour transformer le TypeScript en JavaScript exécutable) :
+
+🚀 Utilisation (CLI)
+Une fois le projet compilé, vous pouvez lancer l'analyse via npx :
+
+Options disponibles :
+
+--lang <fr|en> : Force la langue du rapport (Français ou Anglais).
+
+-i, --incremental : Analyse uniquement les fichiers modifiés pour un gain de temps majeur.
+
+--clear-cache : Vide le cache avant de démarrer l'analyse.
+
+--no-animation : Désactive les animations dans le terminal.
+
+Gestion du cache :
+🏗️ Architecture et Langages Supportés
+DocsToDev repose sur un moteur capable d'identifier automatiquement le rôle exact de chaque fichier (Page, UI Component, API endpoint, Service, etc.).
+
+Langages supportés :
+
+Web : TypeScript (.ts, .tsx), JavaScript (.js, .jsx, .mjs, .cjs).
+
+Backend & Système : Python (.py), Java (.java), C# (.cs), Go (.go), Rust (.rs).
+
+👥 Bénéficiaires et Cas d'Usage
+📄 Licence et Crédits
+Développé par EspoirDev Massamba Kiminou Chadrack Delmard.
+
+
+Date du projet : 6 janvier 2026.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docstodev",
-  "version": "2.1.1",
+  "version": "3.0.2",
   "description": "Solution d’automatisation de documentation technique intelligente avec IA",
   "type": "module",
   "main": "dist/cli/index.js",

package/docs/docs-to-dev.md

@@ -1,225 +0,0 @@
-# Rapport Technique DocsToDev
-
-> 📅 Généré le : vendredi 9 janvier 2026 à 09:22
-> 📊 7 fichiers analysés • 15 dépendances identifiées
-
-## 💡 Analyse Intelligente
-
-## 1.
-
-**`But` du `Projet`**
-`Le` projet `DocsToDev` vise à analyser des données techniques brutes et à les transformer en documentation métier claire et structurée.
-
-`Il` résout les problèmes de compréhension et d'analyse de données techniques complexes pour les développeurs et les équipes de développement.
-
-`Le` public cible de ce projet inclut les développeurs, les architectes logiciels, et les équipes de développement qui cherchent à améliorer la qualité et la compréhension de leurs projets logiciels.
-
-## 2.
-
-**`Design` `System` Détecté**
-`Le` design system détecté dans le projet inclut :
-- **`Palette` de couleurs** : `Les` couleurs primaires et secondaires utilisées dans le projet ne sont pas explicitement définies dans les extraits de code fournis, mais il est mentionné que la palette de couleurs fait partie de l'analyse du design system.
-
-- **`Typographie`** : `Les` polices utilisées ne sont pas spécifiquement mentionnées dans les extraits de code fournis.
-
-- **`Patterns` de composants** : `Les` patterns de composants, tels que les cartes, les modales, les formulaires, etc., sont détectés et documentés dans le projet.
-
-## 3.
-
-**⚠️ `Risques` `Identifi`és**
-`Les` risques potentiels identifiés dans le projet sont classés par niveau :
-- 🔴 **`Critique`** : 
-  - `La` sécurité du projet pourrait être compromise si les clés API comme `GROQ_API_KEY` ne sont pas sécurisées correctement.
-
-- L'architecture du projet pourrait être affectée par la complexité et la maintenance des fichiers et des dépendances.
-
-- 🟡 **`Moyen`** : 
-  - `La` dette technique et les performances du projet pourraient être impactées par la complexité croissante des analyses et des exports.
-
-- 🟢 **`Faible`** : 
-  - `Les` améliorations mineures pourraient inclure la optimisation des requêtes, la mise à jour des dépendances, et la réduction de la duplication de code.
-
-## 4.
-
-**💡 `Recommandations`**
-`Les` actions concrètes pour améliorer le projet sont :
-- **`Refactoring`** : Réorganiser le code pour améliorer la lisibilité et la maintainabilité.
-
-- **`Optimisations`** : `Optimiser` les performances en utilisant des méthodes plus efficaces pour les analyses et les exports.
-
-- **`Bonnes` pratiques** : `Adopter` des bonnes pratiques de développement telles que les tests unitaires et d'intégration, et la mise à jour régulière des dépendances.
-
-## 5.
-
-**`Analyse` Détaillée des `Fichiers`**
-- **`src/ai/`analyzer.ts`** : `Ce` fichier contient les fonctions d'analyse de l'IA, notamment `askAI` et `askAIDetailed`, qui analysent les données techniques et retournent des résultats détaillés.
-
-- **`src/analyzers/`languageAnalyzer`.ts`** : `Ce` fichier contient les classes et les fonctions d'analyse de langage, notamment `TSJSAnalyzer`, qui analyse les fichiers de code et retourne des informations sur les exports, les imports, les fonctions, les classes, etc.
-
-- **`src/cache/`cacheManager`.ts`** : `Ce` fichier contient la classe `CacheManager`, qui gère le cache des analyses pour améliorer les performances.
-
-- **`src/cli/`index.ts`** : `Ce` fichier contient le point d'entrée de la ligne de commande, qui utilise les commandes pour exécuter les analyses et générer les rapports.
-
-- **`src/commands/`generateSummary`.ts`** : `Ce` fichier contient la fonction `generateSummary`, qui génère un résumé du projet en fonction des données d'analyse.
-
-- **`src/commands/`run.ts`** : `Ce` fichier contient la fonction `runCommand`, qui exécute les analyses et génère les rapports en fonction des options de la ligne de commande.
-
-- **`src/exporters/`html.ts`** : `Ce` fichier contient la fonction `exportToHTML`, qui exporte les résultats des analyses en format HTML.
-
-## 📂 Architecture du projet
-
-```
-├─ [package-lock.json](../package-lock.json)
-├─ [package.json](../package.json)
-├─ [src/ai/analyzer.ts](../src/ai/analyzer.ts)
-├─ [src/analyzers/languageAnalyzer.ts](../src/analyzers/languageAnalyzer.ts)
-├─ [src/cache/cacheManager.ts](../src/cache/cacheManager.ts)
-├─ [src/cli/index.ts](../src/cli/index.ts)
-├─ [src/commands/generateSummary.ts](../src/commands/generateSummary.ts)
-├─ [src/commands/run.ts](../src/commands/run.ts)
-├─ [src/exporters/html.ts](../src/exporters/html.ts)
-└─ [tsconfig.json](../tsconfig.json)
-```
-
-## 🔬 Analyse détaillée des composants
-
-### 📄 [`src/ai/analyzer.ts`](../src/ai/analyzer.ts)
-
-**Complexité et maintenance** : 289 lignes • 🟢 Faible (46)
-
-**Fonctions** : `askAI()`, `askAIDetailed()`, `buildSystemPrompt()`, `parseAIResponse()`
-
-**Types/Interfaces** : `AIAnalysisOptions`, `AIAnalysisResult`
-
-**Exports publics** : `AIAnalysisOptions`, `AIAnalysisResult`, `askAI`, `askAIDetailed`
-
----
-
-### 📄 [`src/analyzers/languageAnalyzer.ts`](../src/analyzers/languageAnalyzer.ts)
-
-**Complexité et maintenance** : 580 lignes • 🟠 Élevée (270)
-
-**Fonctions** : `getAnalyzer()`, `getSupportedExtensions()`, `isExplicitlySupported()`
-
-**Classes** : `TSJSAnalyzer`, `PythonAnalyzer`, `JavaAnalyzer`, `CSharpAnalyzer`, `GoAnalyzer`, `RustAnalyzer`, `HTMLAnalyzer`, `CSSAnalyzer`, `PHPAnalyzer`, `RubyAnalyzer`, `SQLAnalyzer`, `DefaultAnalyzer`
-
-**Types/Interfaces** : `LanguageAnalyzer`, `FileAnalysisResult`
-
-**Exports publics** : `LanguageAnalyzer`, `FileAnalysisResult`, `getAnalyzer`, `getSupportedExtensions`, `isExplicitlySupported`
-
----
-
-### 📄 [`src/cache/cacheManager.ts`](../src/cache/cacheManager.ts)
-
-**Complexité et maintenance** : 179 lignes • 🟢 Faible (36)
-
-**Classes** : `CacheManager`
-
-**Types/Interfaces** : `CacheEntry`, `CacheManifest`
-
-**Exports publics** : `CacheEntry`, `CacheManifest`, `CacheManager`
-
-**Dépendances** :
-
-• `node:crypto` (Node.js) → utilise `createHash`
-• `node:fs` (Node.js) → utilise `readFileSync, writeFileSync, existsSync, statSync, mkdirSync`
-• `node:path` (Node.js) → utilise `path`
-
----
-
-### 📄 [`src/cli/index.ts`](../src/cli/index.ts)
-
-**Complexité et maintenance** : 355 lignes • 🟡 Modérée (77)
-
-**Fonctions** : `typeWriter()`, `showBanner()`, `selectLanguage()`, `showTransition()`
-
-**Classes** : `Spinner`, `ProgressBar`
-
-**Dépendances** :
-
-• `commander` (NPM) → utilise `Command`
-• `../commands/run.js` (Interne) → utilise `runCommand`
-• `../commands/generateSummary.js` (Interne) → utilise `generateSummary`
-• `node:readline/promises` (Node.js) → utilise `readline`
-• `node:process` (Node.js) → utilise `stdin as input, stdout as output`
-• `node:path` (Node.js) → utilise `path`
-
----
-
-### 📄 [`src/commands/generateSummary.ts`](../src/commands/generateSummary.ts)
-
-**Complexité et maintenance** : 150 lignes • 🟢 Faible (27)
-
-**Fonctions** : `generateSummary()`
-
-**Types/Interfaces** : `SummaryData`
-
-**Exports publics** : `generateSummary`
-
-**Dépendances** :
-
-• `node:fs` (Node.js) → utilise `writeFileSync, mkdirSync`
-• `node:path` (Node.js) → utilise `path`
-
----
-
-### 📄 [`src/commands/run.ts`](../src/commands/run.ts)
-
-**Complexité et maintenance** : 459 lignes • 🟡 Modérée (108)
-
-**Fonctions** : `buildTree()`, `renderTree()`, `analyzeFile()`, `getComplexityLevel()`, `formatAISummary()`, `runCommand()`, `generatePDF()`
-
-**Types/Interfaces** : `AIAnalysisOptions`, `TreeNode`, `FileAnalysis`
-
-**Exports publics** : `runCommand`
-
-**Dépendances** :
-
-• `globby` (NPM) → utilise `globby`
-• `node:fs` (Node.js) → utilise `writeFileSync, readFileSync, existsSync, mkdirSync`
-• `node:path` (Node.js) → utilise `path`
-• `puppeteer` (NPM) → utilise `puppeteer`
-• `../exporters/html.js` (Interne) → utilise `exportToHTML`
-• `../ai/analyzer.js` (Interne) → utilise `askAIDetailed, type AIAnalysisOptions`
-• `../analyzers/languageAnalyzer.js` (Interne) → utilise `getAnalyzer, getSupportedExtensions`
-• `../cache/cacheManager.js` (Interne) → utilise `CacheManager`
-
----
-
-### 📄 [`src/exporters/html.ts`](../src/exporters/html.ts)
-
-**Complexité et maintenance** : 894 lignes • 🟠 Élevée (152)
-
-**Fonctions** : `exportToHTML()`, `toggleTheme()`, `sanitizeMermaidGraph()`, `generateHierarchyGraph()`, `sanitizeLabel()`, `getFileExtension()`, `getNodeStyle()`, `traverse()`, `getDefaultHierarchyGraph()`, `generateDataFlowGraph()`, `formatRisksSection()`, `formatText()`
-
-**Types/Interfaces** : `TreeStructure`
-
-**Exports publics** : `exportToHTML`
-
-**Dépendances** :
-
-• `node:fs` (Node.js) → utilise `writeFileSync`
-• `node:path` (Node.js) → utilise `path`
-• `https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs` (NPM) → utilise `mermaid`
-
----
-
-## 📦 Modules externes
-
-| Module | Type | Occurrences |
-| :--- | :--- | :---: |
-| `../ai/analyzer.js` | Interne | 1 |
-| `../analyzers/languageAnalyzer.js` | Interne | 1 |
-| `../cache/cacheManager.js` | Interne | 1 |
-| `../commands/generateSummary.js` | Interne | 1 |
-| `../commands/run.js` | Interne | 1 |
-| `../exporters/html.js` | Interne | 1 |
-| `commander` | NPM | 1 |
-| `globby` | NPM | 1 |
-| `https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs` | NPM | 1 |
-| `node:crypto` | Node.js | 1 |
-| `node:fs` | Node.js | 4 |
-| `node:path` | Node.js | 5 |
-| `node:process` | Node.js | 1 |
-| `node:readline/promises` | Node.js | 1 |
-| `puppeteer` | NPM | 1 |

package/docs/report.html

@@ -1,633 +0,0 @@
-<!DOCTYPE html>
-<html lang="fr" data-theme="dark">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>DocsToDev – Rapport Technique</title>
-
-<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400&family=Fira+Code&display=swap" rel="stylesheet">
-<script type="module">
-  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
-  
-  mermaid.initialize({ 
-    startOnLoad: true,
-    theme: document.documentElement.dataset.theme === "dark" ? "dark" : "default",
-    securityLevel: 'loose',
-    logLevel: 'error',
-    themeVariables: {
-      darkMode: document.documentElement.dataset.theme === "dark",
-      background: "transparent",
-      primaryColor: "#58a6ff",
-      primaryTextColor: "#c9d1d9",
-      primaryBorderColor: "#30363d",
-      lineColor: "#8b949e",
-      secondaryColor: "#161b22",
-      tertiaryColor: "#0d1117",
-      fontSize: "14px",
-      fontFamily: "Inter, sans-serif"
-    },
-    flowchart: {
-      useMaxWidth: true,
-      htmlLabels: true,
-      curve: 'basis'
-    }
-  });
-  
-  window.mermaid = mermaid;
-</script>
-
-<style>
-:root[data-theme="dark"] {
-    --bg: #0d1117;
-    --card: #161b22;
-    --text: #c9d1d9;
-    --muted: #8b949e;
-    --border: #30363d;
-    --accent: #58a6ff;
-    --code-bg: #1f2428;
-    --file-badge-bg: rgba(248, 81, 73, 0.15);
-    --file-badge-text: #f85149;
-}
-
-:root[data-theme="light"] {
-    --bg: #ffffff;
-    --card: #f6f8fa;
-    --text: #24292f;
-    --muted: #57606a;
-    --border: #d0d7de;
-    --accent: #0969da;
-    --code-bg: #eaeef2;
-    --file-badge-bg: rgba(218, 54, 51, 0.15);
-    --file-badge-text: #da3633;
-}
-
-* {
-    margin: 0;
-    padding: 0;
-    box-sizing: border-box;
-}
-
-body {
-    font-family: Inter, sans-serif;
-    background: var(--bg);
-    color: var(--text);
-    line-height: 1.6;
-}
-
-.container {
-    max-width: 1400px;
-    margin: 0 auto;
-    padding: 2rem;
-}
-
-.controls {
-    position: sticky;
-    top: 0;
-    background: var(--bg);
-    padding: 1rem 0;
-    display: flex;
-    gap: 0.75rem;
-    z-index: 100;
-    border-bottom: 1px solid var(--border);
-    margin-bottom: 2rem;
-}
-
-#search {
-    flex: 1;
-    padding: 0.6rem 1rem;
-    border: 1px solid var(--border);
-    background: var(--card);
-    color: var(--text);
-    font-size: 0.95rem;
-    font-family: Inter, sans-serif;
-    transition: border-color 0.2s;
-}
-
-#search:focus {
-    outline: none;
-    border-color: var(--accent);
-}
-
-button {
-    padding: 0.6rem 1.2rem;
-    border: 1px solid var(--border);
-    background: var(--card);
-    color: var(--text);
-    cursor: pointer;
-    font-size: 0.95rem;
-    font-family: Inter, sans-serif;
-    transition: all 0.2s;
-    display: flex;
-    align-items: center;
-    gap: 0.5rem;
-}
-
-button:hover {
-    background: var(--border);
-}
-
-button svg {
-    width: 16px;
-    height: 16px;
-}
-
-h1 {
-    font-size: 2.5rem;
-    color: var(--accent);
-    margin-bottom: 3rem;
-    font-weight: 400;
-    letter-spacing: -0.02em;
-}
-
-h2 {
-    font-size: 1.5rem;
-    margin: 3rem 0 1.5rem 0;
-    padding-bottom: 0.75rem;
-    border-bottom: 1px solid var(--border);
-    font-weight: 400;
-    color: var(--text);
-}
-
-h3 {
-    font-size: 1.1rem;
-    margin-bottom: 1rem;
-    color: var(--accent);
-    font-weight: 400;
-}
-
-.graphs-grid {
-    display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(500px, 1fr));
-    gap: 2rem;
-    margin: 2rem 0;
-}
-
-.graph-container {
-    border: 1px solid var(--border);
-    background: var(--card);
-    padding: 1.5rem;
-    min-height: 300px;
-    position: relative;
-}
-
-.graph-title {
-    font-size: 1rem;
-    color: var(--muted);
-    margin-bottom: 1rem;
-    text-transform: uppercase;
-    letter-spacing: 0.05em;
-    font-size: 0.85rem;
-}
-
-.mermaid-wrapper {
-    width: 100%;
-    overflow-x: auto;
-    overflow-y: hidden;
-}
-
-.component {
-    border: 1px solid var(--border);
-    background: var(--card);
-    padding: 1.5rem;
-    margin-bottom: 1.5rem;
-}
-
-.component p,
-.component .list-item {
-    word-wrap: break-word;
-    overflow-wrap: break-word;
-    word-break: break-word;
-}
-
-.tree-line {
-    font-family: "Fira Code", monospace;
-    font-size: 0.85rem;
-    white-space: pre-wrap;
-    word-wrap: break-word;
-    color: var(--muted);
-    line-height: 1.8;
-}
-
-.branch { 
-    color: var(--accent); 
-}
-
-.pipe { 
-    color: var(--border); 
-}
-
-.file-badge {
-    background: var(--file-badge-bg);
-    color: var(--file-badge-text);
-    padding: 0.15rem 0.5rem;
-    font-size: 0.8rem;
-    font-family: "Fira Code", monospace;
-    display: inline-block;
-    margin-left: 0.25rem;
-}
-
-.table-container {
-    border: 1px solid var(--border);
-    margin: 1.5rem 0;
-    overflow-x: auto;
-    background: var(--card);
-}
-
-table {
-    width: 100%;
-    border-collapse: collapse;
-    font-size: 0.9rem;
-    table-layout: fixed;
-}
-
-th, td {
-    border-bottom: 1px solid var(--border);
-    padding: 0.75rem 1rem;
-    text-align: left;
-    word-wrap: break-word;
-    overflow-wrap: break-word;
-}
-
-th {
-    background: var(--bg);
-    color: var(--muted);
-    text-transform: uppercase;
-    font-size: 0.8rem;
-    letter-spacing: 0.05em;
-    font-weight: 400;
-}
-
-tr:last-child td {
-    border-bottom: none;
-}
-
-code {
-    font-family: "Fira Code", monospace;
-    background: var(--code-bg);
-    padding: 0.2rem 0.4rem;
-    font-size: 0.9em;
-    color: var(--accent);
-    word-wrap: break-word;
-    overflow-wrap: break-word;
-}
-
-.list-item {
-    margin-bottom: 0.5rem;
-    padding-left: 1.5rem;
-    position: relative;
-}
-
-.list-item::before {
-    content: "";
-    position: absolute;
-    left: 0.5rem;
-    top: 0.7rem;
-    width: 4px;
-    height: 4px;
-    background: var(--accent);
-}
-
-p {
-    margin-bottom: 1rem;
-    color: var(--muted);
-}
-
-a {
-    color: var(--accent);
-    text-decoration: none;
-}
-
-a:hover {
-    text-decoration: underline;
-}
-
-mark {
-    background: #ffd33d;
-    color: #000;
-    padding: 0.1rem 0.3rem;
-}
-
-.mermaid {
-    background: transparent;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    min-height: 200px;
-}
-
-.mermaid svg {
-    max-width: 100%;
-    height: auto;
-}
-
-.error-message {
-    color: #f85149;
-    padding: 1rem;
-    background: rgba(248, 81, 73, 0.1);
-    border: 1px solid rgba(248, 81, 73, 0.3);
-    border-radius: 4px;
-    font-family: "Fira Code", monospace;
-    font-size: 0.9rem;
-}
-
-.project-goal-section {
-    background: linear-gradient(135deg, var(--accent) 0%, #7c3aed 100%);
-    padding: 2rem;
-    margin: 2rem 0;
-    border-radius: 8px;
-    border-left: 4px solid var(--accent);
-}
-
-.project-goal-section h2 {
-    color: #ffffff;
-    border-bottom: none;
-    margin: 0 0 1rem 0;
-    font-size: 1.8rem;
-}
-
-.project-goal-section p {
-    color: rgba(255, 255, 255, 0.95);
-    font-size: 1.1rem;
-    line-height: 1.8;
-}
-
-.risks-section {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-left: 4px solid #f85149;
-    padding: 1.5rem;
-    margin: 2rem 0;
-}
-
-.risks-section h3 {
-    color: #f85149;
-    margin-bottom: 1rem;
-}
-
-.risk-item {
-    padding: 0.75rem;
-    margin: 0.5rem 0;
-    border-radius: 4px;
-    display: flex;
-    align-items: flex-start;
-    gap: 0.75rem;
-}
-
-.risk-item.critical {
-    background: rgba(248, 81, 73, 0.1);
-    border-left: 3px solid #f85149;
-}
-
-.risk-item.medium {
-    background: rgba(251, 191, 36, 0.1);
-    border-left: 3px solid #fbbf24;
-}
-
-.risk-item.low {
-    background: rgba(34, 197, 94, 0.1);
-    border-left: 3px solid #22c55e;
-}
-
-.risk-icon {
-    font-size: 1.2rem;
-    flex-shrink: 0;
-}
-
-.recommendations-section {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-left: 4px solid #22c55e;
-    padding: 1.5rem;
-    margin: 2rem 0;
-}
-
-.recommendations-section h3 {
-    color: #22c55e;
-    margin-bottom: 1rem;
-}
-
-.recommendation-item {
-    padding: 0.75rem;
-    margin: 0.5rem 0;
-    background: rgba(34, 197, 94, 0.05);
-    border-radius: 4px;
-    padding-left: 2rem;
-    position: relative;
-}
-
-.recommendation-item::before {
-    content: "💡";
-    position: absolute;
-    left: 0.5rem;
-    top: 0.75rem;
-}
-
-.design-system-section {
-    background: var(--card);
-    border: 1px solid var(--border);
-    padding: 1.5rem;
-    margin: 2rem 0;
-}
-
-.color-palette {
-    display: flex;
-    gap: 1rem;
-    flex-wrap: wrap;
-    margin: 1rem 0;
-}
-
-.color-swatch {
-    display: flex;
-    flex-direction: column;
-    align-items: center;
-    gap: 0.5rem;
-}
-
-.color-box {
-    width: 60px;
-    height: 60px;
-    border-radius: 8px;
-    border: 2px solid var(--border);
-    box-shadow: 0 2px 8px rgba(0,0,0,0.1);
-}
-
-.color-label {
-    font-size: 0.75rem;
-    font-family: "Fira Code", monospace;
-    color: var(--muted);
-}
-
-@media print {
-    .controls {
-        display: none;
-    }
-    
-    .container {
-        max-width: 100%;
-        padding: 0;
-    }
-    
-    .component {
-        page-break-inside: avoid;
-    }
-}
-
-@media (max-width: 768px) {
-    .graphs-grid {
-        grid-template-columns: 1fr;
-    }
-    
-    .controls {
-        flex-direction: column;
-    }
-}
-</style>
-</head>
-
-<body>
-<div class="container">
-
-
-
-
-
-<div class="controls">
-    <input id="search" placeholder="Rechercher dans la documentation..." type="text">
-    <button onclick="toggleTheme()">
-        <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
-        </svg>
-        Thème
-    </button>
-    <button onclick="window.print()">
-        <svg fill="none" stroke="currentColor" viewBox="0 0 24 24">
-            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 17h2a2 2 0 002-2v-4a2 2 0 00-2-2H5a2 2 0 00-2 2v4a2 2 0 002 2h2m2 4h6a2 2 0 002-2v-4a2 2 0 00-2-2H9a2 2 0 00-2 2v4a2 2 0 002 2zm8-12V5a2 2 0 00-2-2H9a2 2 0 00-2 2v4h10z"/>
-        </svg>
-        Exporter PDF
-    </button>
-</div>
-
-<h2>Architecture du projet</h2>
-<div class="graphs-grid">
-    <div class="graph-container">
-        <div class="graph-title">Graphe des dépendances</div>
-        <div class="mermaid-wrapper">
-            <pre class="mermaid">
-graph LR
-    index_ts --> run_js:::jsFileStyle
-    index_ts --> generateSummary_js:::jsFileStyle
-    run_ts --> html_js:::jsFileStyle
-    run_ts --> analyzer_js:::jsFileStyle
-    run_ts --> languageAnalyzer_js:::jsFileStyle
-    run_ts --> cacheManager_js:::jsFileStyle
-
-    classDef jsFileStyle fill:#f7df1e,stroke:#c9b003,stroke-width:2px,color:#000
-    classDef tsFileStyle fill:#3178c6,stroke:#235a97,stroke-width:2px,color:#fff
-    classDef analyzerStyle fill:#8b5cf6,stroke:#6d28d9,stroke-width:2px,color:#fff
-    classDef componentStyle fill:#06b6d4,stroke:#0891b2,stroke-width:2px,color:#fff
-    classDef functionStyle fill:#ec4899,stroke:#be185d,stroke-width:2px,color:#fff
-    classDef serviceStyle fill:#10b981,stroke:#059669,stroke-width:2px,color:#fff
-    classDef configStyle fill:#6e7681,stroke:#484f58,stroke-width:2px,color:#fff
-            </pre>
-        </div>
-    </div>
-    
-    <div class="graph-container">
-        <div class="graph-title">Structure du projet</div>
-        <div class="mermaid-wrapper">
-            <pre class="mermaid">
-graph TD
-    node0["📄 package-lock.json"]:::configStyle
-    node1["📄 package.json"]:::configStyle
-    node2["📄 tsconfig.json"]:::configStyle
-    node3["📄 srcaianalyzer.ts"]:::tsStyle
-    node4["📄 srcanalyzerslanguageAnalyzer.ts"]:::tsStyle
-    node5["📄 srccachecacheManager.ts"]:::tsStyle
-    node6["📄 srccliindex.ts"]:::tsStyle
-    node7["📄 srccommandsgenerateSummary.ts"]:::tsStyle
-    node8["📄 srccommandsrun.ts"]:::tsStyle
-    node9["📄 srcexportershtml.ts"]:::tsStyle
-
-    classDef folderStyle fill:#58a6ff,stroke:#1f6feb,stroke-width:2px,color:#fff
-    classDef tsStyle fill:#3178c6,stroke:#235a97,stroke-width:2px,color:#fff
-    classDef jsStyle fill:#f7df1e,stroke:#c9b003,stroke-width:2px,color:#000
-    classDef configStyle fill:#6e7681,stroke:#484f58,stroke-width:2px,color:#fff
-    classDef htmlStyle fill:#e34c26,stroke:#b83c1f,stroke-width:2px,color:#fff
-    classDef cssStyle fill:#264de4,stroke:#1b3ba3,stroke-width:2px,color:#fff
-    classDef docStyle fill:#22c55e,stroke:#16a34a,stroke-width:2px,color:#fff
-    classDef fileStyle fill:#8b949e,stroke:#6e7681,stroke-width:2px,color:#fff
-            </pre>
-        </div>
-    </div>
-</div>
-
-<div class="graph-container" style="margin-bottom: 3rem;">
-    <div class="graph-title">Flux de données</div>
-    <div class="mermaid-wrapper">
-        <pre class="mermaid">
-graph LR
-    A["📥 Input<br/>(fichiers source)"]:::inputStyle --> B["🔍 Analyzer<br/>(analyse code)"]:::analyzerStyle
-    B --> C["📊 Parser<br/>(extraction données)"]:::parserStyle
-    C --> D["⚙️ Generator<br/>(génération docs)"]:::generatorStyle
-    D --> E["📤 Exporter<br/>(export HTML/PDF)"]:::exporterStyle
-    E --> F["✅ Output<br/>(documentation)"]:::outputStyle
-    
-    classDef inputStyle fill:#3b82f6,stroke:#1d4ed8,stroke-width:2px,color:#fff
-    classDef analyzerStyle fill:#8b5cf6,stroke:#6d28d9,stroke-width:2px,color:#fff
-    classDef parserStyle fill:#ec4899,stroke:#be185d,stroke-width:2px,color:#fff
-    classDef generatorStyle fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#fff
-    classDef exporterStyle fill:#10b981,stroke:#059669,stroke-width:2px,color:#fff
-    classDef outputStyle fill:#22c55e,stroke:#16a34a,stroke-width:2px,color:#fff
-        </pre>
-    </div>
-</div>
-
-<div id="content-area"><h1>Rapport Technique DocsToDev</h1><p>> 📅 Généré le : vendredi 9 janvier 2026 à 09:22</p><p>> 📊 7 fichiers analysés • 15 dépendances identifiées</p><h2>💡 Analyse Intelligente</h2><h2>1.</h2><p><code>But</code> du <code>Projet</code></p><p><code>Le</code> projet <code>DocsToDev</code> vise à analyser des données techniques brutes et à les transformer en documentation métier claire et structurée.</p><p><code>Il</code> résout les problèmes de compréhension et d'analyse de données techniques complexes pour les développeurs et les équipes de développement.</p><p><code>Le</code> public cible de ce projet inclut les développeurs, les architectes logiciels, et les équipes de développement qui cherchent à améliorer la qualité et la compréhension de leurs projets logiciels.</p><h2>2.</h2><p><code>Design</code> <code>System</code> Détecté</p><p><code>Le</code> design system détecté dans le projet inclut :</p><div class="list-item"><code>Palette</code> de couleurs : <code>Les</code> couleurs primaires et secondaires utilisées dans le projet ne sont pas explicitement définies dans les extraits de code fournis, mais il est mentionné que la palette de couleurs fait partie de l'analyse du design system.</div><div class="list-item"><code>Typographie</code> : <code>Les</code> polices utilisées ne sont pas spécifiquement mentionnées dans les extraits de code fournis.</div><div class="list-item"><code>Patterns</code> de composants : <code>Les</code> patterns de composants, tels que les cartes, les modales, les formulaires, etc., sont détectés et documentés dans le projet.</div><h2>3.</h2><p>⚠️ <code>Risques</code> <code>Identifi</code>és</p><p><code>Les</code> risques potentiels identifiés dans le projet sont classés par niveau :</p><div class="list-item">🔴 <code>Critique</code> :</div><div class="list-item"><code>La</code> sécurité du projet pourrait être compromise si les clés API comme <code>GROQ_API_KEY</code> ne sont pas sécurisées correctement.</div><div class="list-item">L'architecture du projet pourrait être affectée par la complexité et la maintenance des fichiers et des dépendances.</div><div class="list-item">🟡 <code>Moyen</code> :</div><div class="list-item"><code>La</code> dette technique et les performances du projet pourraient être impactées par la complexité croissante des analyses et des exports.</div><div class="list-item">🟢 <code>Faible</code> :</div><div class="list-item"><code>Les</code> améliorations mineures pourraient inclure la optimisation des requêtes, la mise à jour des dépendances, et la réduction de la duplication de code.</div><h2>4.</h2><p>💡 <code>Recommandations</code></p><p><code>Les</code> actions concrètes pour améliorer le projet sont :</p><div class="list-item"><code>Refactoring</code> : Réorganiser le code pour améliorer la lisibilité et la maintainabilité.</div><div class="list-item"><code>Optimisations</code> : <code>Optimiser</code> les performances en utilisant des méthodes plus efficaces pour les analyses et les exports.</div><div class="list-item"><code>Bonnes</code> pratiques : <code>Adopter</code> des bonnes pratiques de développement telles que les tests unitaires et d'intégration, et la mise à jour régulière des dépendances.</div><h2>5.</h2><p><code>Analyse</code> Détaillée des <code>Fichiers</code></p><div class="tree-line">- <code>src/ai/</code>analyzer.ts<code> : </code>Ce<code> fichier contient les fonctions d'analyse de l'IA, notamment </code>askAI<code> et </code>askAIDetailed`, qui analysent les données techniques et retournent des résultats détaillés.</div><div class="tree-line">- <code>src/analyzers/</code>languageAnalyzer<code>.ts</code> : <code>Ce</code> fichier contient les classes et les fonctions d'analyse de langage, notamment <code>TSJSAnalyzer</code>, qui analyse les fichiers de code et retourne des informations sur les exports, les imports, les fonctions, les classes, etc.</div><div class="tree-line">- <code>src/cache/</code>cacheManager<code>.ts</code> : <code>Ce</code> fichier contient la classe <code>CacheManager</code>, qui gère le cache des analyses pour améliorer les performances.</div><div class="tree-line">- <code>src/cli/</code>index.ts<code> : </code>Ce` fichier contient le point d'entrée de la ligne de commande, qui utilise les commandes pour exécuter les analyses et générer les rapports.</div><div class="tree-line">- <code>src/commands/</code>generateSummary<code>.ts</code> : <code>Ce</code> fichier contient la fonction <code>generateSummary</code>, qui génère un résumé du projet en fonction des données d'analyse.</div><div class="tree-line">- <code>src/commands/</code>run.ts<code> : </code>Ce<code> fichier contient la fonction </code>runCommand`, qui exécute les analyses et génère les rapports en fonction des options de la ligne de commande.</div><div class="tree-line">- <code>src/exporters/</code>html.ts<code> : </code>Ce<code> fichier contient la fonction </code>exportToHTML`, qui exporte les résultats des analyses en format HTML.</div><h2>📂 Architecture du projet</h2><p><code></code>`</p><div class="tree-line"><span class="branch">├─</span> <a href="../package-lock.json">package-lock.json</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../package.json">package.json</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/ai/analyzer.ts">src/ai/analyzer.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/analyzers/languageAnalyzer.ts">src/analyzers/languageAnalyzer.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/cache/cacheManager.ts">src/cache/cacheManager.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/cli/index.ts">src/cli/index.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/commands/generateSummary.ts">src/commands/generateSummary.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/commands/run.ts">src/commands/run.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/exporters/html.ts">src/exporters/html.ts</a></div><div class="tree-line"><span class="branch">└─</span> <a href="../tsconfig.json">tsconfig.json</a></div><p><code></code>`</p><h2>🔬 Analyse détaillée des composants</h2><div class="tree-line">### 📄 <a href="../src/ai/analyzer.ts"><code>src/ai/analyzer.ts</code></a></div><p>Complexité et maintenance : 289 lignes • 🟢 Faible (46)</p><p>Fonctions : <code>askAI()</code>, <code>askAIDetailed()</code>, <code>buildSystemPrompt()</code>, <code>parseAIResponse()</code></p><div class="tree-line">Types/Interfaces : <code>AIAnalysisOptions</code>, <code>AIAnalysisResult</code></div><p>Exports publics : <code>AIAnalysisOptions</code>, <code>AIAnalysisResult</code>, <code>askAI</code>, <code>askAIDetailed</code></p><p>---</p><div class="tree-line">### 📄 <a href="../src/analyzers/languageAnalyzer.ts"><code>src/analyzers/languageAnalyzer.ts</code></a></div><p>Complexité et maintenance : 580 lignes • 🟠 Élevée (270)</p><p>Fonctions : <code>getAnalyzer()</code>, <code>getSupportedExtensions()</code>, <code>isExplicitlySupported()</code></p><p>Classes : <code>TSJSAnalyzer</code>, <code>PythonAnalyzer</code>, <code>JavaAnalyzer</code>, <code>CSharpAnalyzer</code>, <code>GoAnalyzer</code>, <code>RustAnalyzer</code>, <code>HTMLAnalyzer</code>, <code>CSSAnalyzer</code>, <code>PHPAnalyzer</code>, <code>RubyAnalyzer</code>, <code>SQLAnalyzer</code>, <code>DefaultAnalyzer</code></p><div class="tree-line">Types/Interfaces : <code>LanguageAnalyzer</code>, <code>FileAnalysisResult</code></div><p>Exports publics : <code>LanguageAnalyzer</code>, <code>FileAnalysisResult</code>, <code>getAnalyzer</code>, <code>getSupportedExtensions</code>, <code>isExplicitlySupported</code></p><p>---</p><div class="tree-line">### 📄 <a href="../src/cache/cacheManager.ts"><code>src/cache/cacheManager.ts</code></a></div><p>Complexité et maintenance : 179 lignes • 🟢 Faible (36)</p><p>Classes : <code>CacheManager</code></p><div class="tree-line">Types/Interfaces : <code>CacheEntry</code>, <code>CacheManifest</code></div><p>Exports publics : <code>CacheEntry</code>, <code>CacheManifest</code>, <code>CacheManager</code></p><p>Dépendances :</p><div class="list-item"><code>node:crypto</code> (Node.js) → utilise <code>createHash</code></div><div class="list-item"><code>node:fs</code> (Node.js) → utilise <code>readFileSync, writeFileSync, existsSync, statSync, mkdirSync</code></div><div class="list-item"><code>node:path</code> (Node.js) → utilise <code>path</code></div><p>---</p><div class="tree-line">### 📄 <a href="../src/cli/index.ts"><code>src/cli/index.ts</code></a></div><p>Complexité et maintenance : 355 lignes • 🟡 Modérée (77)</p><p>Fonctions : <code>typeWriter()</code>, <code>showBanner()</code>, <code>selectLanguage()</code>, <code>showTransition()</code></p><p>Classes : <code>Spinner</code>, <code>ProgressBar</code></p><p>Dépendances :</p><div class="list-item"><code>commander</code> (NPM) → utilise <code>Command</code></div><div class="tree-line">• <code>../commands/run.js</code> (Interne) → utilise <code>runCommand</code></div><div class="tree-line">• <code>../commands/generateSummary.js</code> (Interne) → utilise <code>generateSummary</code></div><div class="tree-line">• <code>node:readline/promises</code> (Node.js) → utilise <code>readline</code></div><div class="list-item"><code>node:process</code> (Node.js) → utilise <code>stdin as input, stdout as output</code></div><div class="list-item"><code>node:path</code> (Node.js) → utilise <code>path</code></div><p>---</p><div class="tree-line">### 📄 <a href="../src/commands/generateSummary.ts"><code>src/commands/generateSummary.ts</code></a></div><p>Complexité et maintenance : 150 lignes • 🟢 Faible (27)</p><p>Fonctions : <code>generateSummary()</code></p><div class="tree-line">Types/Interfaces : <code>SummaryData</code></div><p>Exports publics : <code>generateSummary</code></p><p>Dépendances :</p><div class="list-item"><code>node:fs</code> (Node.js) → utilise <code>writeFileSync, mkdirSync</code></div><div class="list-item"><code>node:path</code> (Node.js) → utilise <code>path</code></div><p>---</p><div class="tree-line">### 📄 <a href="../src/commands/run.ts"><code>src/commands/run.ts</code></a></div><p>Complexité et maintenance : 459 lignes • 🟡 Modérée (108)</p><p>Fonctions : <code>buildTree()</code>, <code>renderTree()</code>, <code>analyzeFile()</code>, <code>getComplexityLevel()</code>, <code>formatAISummary()</code>, <code>runCommand()</code>, <code>generatePDF()</code></p><div class="tree-line">Types/Interfaces : <code>AIAnalysisOptions</code>, <code>TreeNode</code>, <code>FileAnalysis</code></div><p>Exports publics : <code>runCommand</code></p><p>Dépendances :</p><div class="list-item"><code>globby</code> (NPM) → utilise <code>globby</code></div><div class="list-item"><code>node:fs</code> (Node.js) → utilise <code>writeFileSync, readFileSync, existsSync, mkdirSync</code></div><div class="list-item"><code>node:path</code> (Node.js) → utilise <code>path</code></div><div class="list-item"><code>puppeteer</code> (NPM) → utilise <code>puppeteer</code></div><div class="tree-line">• <code>../exporters/html.js</code> (Interne) → utilise <code>exportToHTML</code></div><div class="tree-line">• <code>../ai/analyzer.js</code> (Interne) → utilise <code>askAIDetailed, type AIAnalysisOptions</code></div><div class="tree-line">• <code>../analyzers/languageAnalyzer.js</code> (Interne) → utilise <code>getAnalyzer, getSupportedExtensions</code></div><div class="tree-line">• <code>../cache/cacheManager.js</code> (Interne) → utilise <code>CacheManager</code></div><p>---</p><div class="tree-line">### 📄 <a href="../src/exporters/html.ts"><code>src/exporters/html.ts</code></a></div><p>Complexité et maintenance : 894 lignes • 🟠 Élevée (152)</p><p>Fonctions : <code>exportToHTML()</code>, <code>toggleTheme()</code>, <code>sanitizeMermaidGraph()</code>, <code>generateHierarchyGraph()</code>, <code>sanitizeLabel()</code>, <code>getFileExtension()</code>, <code>getNodeStyle()</code>, <code>traverse()</code>, <code>getDefaultHierarchyGraph()</code>, <code>generateDataFlowGraph()</code>, <code>formatRisksSection()</code>, <code>formatText()</code></p><div class="tree-line">Types/Interfaces : <code>TreeStructure</code></div><p>Exports publics : <code>exportToHTML</code></p><p>Dépendances :</p><div class="list-item"><code>node:fs</code> (Node.js) → utilise <code>writeFileSync</code></div><div class="list-item"><code>node:path</code> (Node.js) → utilise <code>path</code></div><div class="tree-line">• <code>https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs</code> (NPM) → utilise <code>mermaid</code></div><p>---</p><h2>📦 Modules externes</h2><div class="table-container"><table><tr><th>Module</th><th>Type</th><th>Occurrences</th></tr><tr><td><code>../ai/analyzer.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>../analyzers/languageAnalyzer.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>../cache/cacheManager.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>../commands/generateSummary.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>../commands/run.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>../exporters/html.js</code></td><td>Interne</td><td>1</td></tr><tr><td><code>commander</code></td><td>NPM</td><td>1</td></tr><tr><td><code>globby</code></td><td>NPM</td><td>1</td></tr><tr><td><code>https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs</code></td><td>NPM</td><td>1</td></tr><tr><td><code>node:crypto</code></td><td>Node.js</td><td>1</td></tr><tr><td><code>node:fs</code></td><td>Node.js</td><td>4</td></tr><tr><td><code>node:path</code></td><td>Node.js</td><td>5</td></tr><tr><td><code>node:process</code></td><td>Node.js</td><td>1</td></tr><tr><td><code>node:readline/promises</code></td><td>Node.js</td><td>1</td></tr><tr><td><code>puppeteer</code></td><td>NPM</td><td>1</td></tr></table></div></div>
-
-</div>
-
-<script>
-function toggleTheme() {
-    const root = document.documentElement;
-    const next = root.dataset.theme === "dark" ? "light" : "dark";
-    root.dataset.theme = next;
-    localStorage.setItem("theme", next);
-    location.reload();
-}
-
-document.documentElement.dataset.theme = localStorage.getItem("theme") || "dark";
-
-const originalHTML = document.getElementById("content-area").innerHTML;
-
-document.getElementById("search").addEventListener("input", e => {
-    const term = e.target.value.trim();
-    const container = document.getElementById("content-area");
-
-    if (!term) {
-        container.innerHTML = originalHTML;
-        return;
-    }
-
-    const regex = new RegExp("(" + term.replace(/[.*+?\${}()|[\]\\]/g, "\\$&") + ")", "gi");
-    container.innerHTML = originalHTML.replace(regex, "<mark>$1</mark>");
-
-    const first = container.querySelector("mark");
-    if (first) first.scrollIntoView({ behavior: "smooth", block: "center" });
-});
-
-window.addEventListener('load', () => {
-    setTimeout(() => {
-        document.querySelectorAll('.mermaid').forEach(el => {
-            if (!el.querySelector('svg') && !el.querySelector('.error-message')) {
-                const errorMsg = document.createElement('div');
-                errorMsg.className = 'error-message';
-                errorMsg.textContent = 'Erreur de rendu du graphe';
-                el.appendChild(errorMsg);
-            }
-        });
-    }, 3000);
-});
-</script>
-
-</body>
-</html>

package/docs/summary.md

@@ -1,16 +0,0 @@
-# 📊 Vue d'ensemble du Projet – DocsToDev
-
-> 📅 **Rapport généré le :** vendredi 9 janvier 2026 à 09:22
-
-## 🚀 État des lieux
-Salut ! J'ai passé ton projet au peigne fin. Voici un résumé rapide de ce que j'ai trouvé :
-- **Volume traité :** 10 fichiers analysés avec succès.
-- **Diagnostic :** La structure est claire et l'analyse est complète. ✅
-
-## 🧭 Navigation Rapide
-Pour aller plus loin, tu peux consulter les documents suivants :
-- **[📂 Arborescence & Analyse](../docs/docs-to-dev.md)** : Pour comprendre la vocation de chaque fichier et les capacités du système.
-- **[💻 Code Source](../)** : Pour retourner explorer la racine de ton projet.
-
----
-*DocsToDev – Ton allié pour une documentation technique vivante et intelligente.*