mdsmith 1.1.0 → 1.1.2

package/README-MDSMITH.md

@@ -1,30 +1,30 @@
 
-# mdsmith
+# Docuapi
 
 CLI para gerar READMEs e arquivos Markdown
 
-## 🔖 Informações
-- **Versão:** 1.0.2
-- **Gerenciador:** npm
-- **Tipo:** Projeto Node.js
+## 🔖 Project Info
+- **Version:** 1.1.1
+- **Package Manager:** npm
+- **Type:** Node.js Project
 
-## 🚀 Dependências
-Projeto sem dependências.
+## 🚀 Dependencies
+No dependencies found.
 
-## 📁 Estrutura do Projeto
+
+## 📁 Project Structure
 ```
  📂 bin
    📄 beta.js
    📄 index.js
- 📂 node_modules
- 📄 package-lock.json
+ 📄 mdsmith.config.json
  📄 package.json
  📄 README-MDSMITH.md
 
 ```
 
-## 📜 Scripts disponíveis
-Projeto sem scripts.
+## 📜 Available Scripts
+No scripts available.
 
 
-📄 *README gerado automaticamente pelo **mdSmith***  
+Generated by **mdSmith**

package/bin/index.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 
-// npx mdsmith --help           # ajuda
-// npx mdsmith --tree     # mostra estrutura
-// npx mdsmith --deps     # mostra dependências
-// npx mdsmith --readme   # gera README
+// npx mdsmith --help     # show help
+// npx mdsmith --init     # create config file
+// npx mdsmith --tree     # show project structure
+// npx mdsmith --deps     # list dependencies
+// npx mdsmith --readme   # generate README
+
 
 const fs = require("fs");
 
@@ -19,7 +21,10 @@ const rl = readline.createInterface({
 const projectRoot = process.cwd();
 
 if(!fs.existsSync(path.join(process.cwd(), "package.json"))){
-    console.log("Package.json não encontrado.\nVerifique se você está rodando o comando na raiz do projeto.")
+    console.log(`
+Error: package.json not found.
+Please run mdsmith from the project root.  
+    `)
     process.exit(1)
 }
 
@@ -27,11 +32,15 @@ const packageJson = JSON.parse(fs.readFileSync(path.join(projectRoot, "package.j
 
 const args = process.argv.slice(2)
 
-const IGNORE_DIRS = ["node_modules", ".git", ".vscode"]; 
+const defaultConfig = {
+  ignore: ["node_modules", ".git", ".vscode"],
+  depth: Infinity
+}
+
 
 function formatDependencies(deps) {
     if (!deps || Object.keys(deps).length === 0) {
-        return "Projeto sem dependências.";
+        return "No dependencies found.\n";
     }
 
     return Object.entries(deps)
@@ -39,8 +48,13 @@ function formatDependencies(deps) {
         .join("\n");
 }
 
-function scanDir(dirPath, padding) { 
-    const entries = fs.readdirSync(dirPath, { withFileTypes: true }); 
+function scanDir(dirPath, padding, config) { 
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true })
+        .sort((a, b) => {
+            if (a.isDirectory() && !b.isDirectory()) return -1
+            if (!a.isDirectory() && b.isDirectory()) return 1
+            return a.name.localeCompare(b.name)
+        })
 
     let treeContent = ""
 
@@ -50,16 +64,24 @@ function scanDir(dirPath, padding) {
         const fullPath = path.join(dirPath, entry.name); 
         
         if (entry.isDirectory()) { 
-            if (IGNORE_DIRS.includes(entry.name)){
-                treeContent += `${" ".repeat(padding*2)} 📂 ${entry.name}\n`
+            if (config.ignore.includes(entry.name)){
+                continue
             } else {
                 treeContent += `${" ".repeat(padding*2)} 📂 ${entry.name}\n`
-                padding ++
-                treeContent += scanDir(fullPath, padding)
-                padding --
+                if (config.depth === null || padding < config.depth){
+                    padding ++
+                    treeContent += scanDir(fullPath, padding, config)
+                    padding --
+                } else {
+                    treeContent += `${" ".repeat((padding + 1) * 2)} ··· \n`
+                }
             }
         } else { 
-            treeContent += `${" ".repeat(padding*2)} 📄 ${entry.name}\n`
+            if (config.ignore.includes(entry.name)){
+                continue
+            } else{
+                treeContent += `${" ".repeat(padding*2)} 📄 ${entry.name}\n`
+            }
         } 
     } 
 
@@ -78,26 +100,28 @@ async function buscarNome(nome){
         let respostaValida = false
         let resposta = ""
         while(!respostaValida){
-            resposta = await perguntar("Não achamos o nome do projeto nos arquivos do Package.json, gostaria de informar pelo terminal? (y/n): ")
-            resposta = resposta.toLowerCase()
+            resposta = await perguntar(`
+Project name not found in package.json.
+Would you like to provide one? (y/n): `)
+            resposta = resposta.trim().toLowerCase()
 
             if(resposta == "y" || resposta == "n"){
                 respostaValida = true
             }else {
-                console.log("Digite Y ou N caso queira prosseguir.")
+                console.log("Please type y or n.")
             }
         }
 
 
         if(resposta == "n"){
-            console.log("Escolha feita. O título do Readme ficará como NOME DO PROJETO NÃO INFORMADO.")
-            return "Nome do projeto não informado"
+            console.log("\nProject name will be set as Unnamed Project.\n")
+            return "Unnamed Project"
         }if(resposta == "y"){
-            let nome = await perguntar("Informe o nome desejado para colocarmos no nome do projeto: ")
-            console.log("Obrigado por informar o nome!")
+            let nome = await perguntar("Enter the project name: ")
+            console.log(`Project name set to "${nome}".`)
             return nome
         }else{
-            console.error("Erro ao gerar o nome do readme.")
+            console.error("Failed to generate project name.")
             process.exit(1)
         }
     }
@@ -111,26 +135,28 @@ async function buscarDescricao(descricao){
         let respostaValida = false
         let resposta = ""
         while(!respostaValida){
-            resposta = await perguntar("Não achamos a descrição do projeto nos arquivos do Package.json, gostaria de informar pelo terminal? (y/n): ")
-            resposta = resposta.toLowerCase()
+            resposta = await perguntar(`
+Project description not found.
+Would you like to provide one? (y/n): `)
+            resposta = resposta.trim().toLowerCase()
 
             if(resposta == "y" || resposta == "n"){
                 respostaValida = true
             }else {
-                console.log("Digite Y ou N caso queira prosseguir.")
+                console.log("Please type y or n.")
             }
         }
 
 
         if(resposta == "n"){
-            console.log("\nEscolha feita. O campo da descrição ficará presente para preenchimento posterior.\n")
-            return "*Digite aqui a descrição do projeto*"
+            console.log("\nDescription placeholder added.\n")
+            return "*Project description goes here*"
         }if(resposta == "y"){
-            let descricao = await perguntar("Conte-me sobre seu projeto: ")
-            console.log("\nObrigado por informar os dados do seu projeto!\n")
+            let descricao = await perguntar("Enter the project description: ")
+            console.log("\nDescription saved.\n")
             return descricao
         }else{
-            console.error("Erro ao gerar o a descrição do readme.")
+            console.error("Failed to generate project description.")
             process.exit(1)
         }
     }
@@ -149,12 +175,12 @@ function detectarTipoProjeto(packageJson) {
     if (deps.express) return "API REST (Express)"
     if (deps.typescript) return "Projeto TypeScript"
 
-    return "Projeto Node.js"
+    return "Node.js Project"
 }
 
 function formatScripts(scripts) {
     if (!scripts || Object.keys(scripts).length === 0) {
-        return "Projeto sem scripts.";
+        return "No scripts available.\n";
     }
 
     return Object.entries(scripts)
@@ -173,62 +199,152 @@ const content = `
 
 ${descricaoProjeto}
 
-## 🔖 Informações
-- **Versão:** ${packageJson.version || "Versão não informada."}
-- **Gerenciador:** npm
-- **Tipo:** ${detectarTipoProjeto(packageJson)}
+## 🔖 Project Info
+- **Version:** ${packageJson.version || "Not specified"}
+- **Package Manager:** npm
+- **Type:** ${detectarTipoProjeto(packageJson)}
 
-## 🚀 Dependências
+## 🚀 Dependencies
 ${formatDependencies(packageJson.dependencies)}
 
-## 📁 Estrutura do Projeto
+## 📁 Project Structure
 \`\`\`
 ${tree}
 \`\`\`
 
-## 📜 Scripts disponíveis
+## 📜 Available Scripts
 ${formatScripts(packageJson.scripts)}
 
-
-📄 *README gerado automaticamente pelo **mdSmith***  
+Generated by **mdSmith**
 `
     
     return content 
 
 }
 
+function loadConfig(projectRoot) {
+  const configPath = path.join(projectRoot, "mdsmith.config.json")
+
+  if (!fs.existsSync(configPath)) {
+    return defaultConfig
+  }
+
+  try {
+    const fileContent = fs.readFileSync(configPath, "utf-8")
+    const userConfig = JSON.parse(fileContent)
+
+    return {
+        ...defaultConfig,
+        ...userConfig,
+        ignore: [
+            ...defaultConfig.ignore,
+            ...(userConfig.ignore || [])
+        ]
+    }
+
+
+  } catch (error) {
+    console.log("Failed to read mdsmith.config.json. Using default configuration.")
+    return defaultConfig
+  }
+}
+
 async function main() {
+    const config = loadConfig(projectRoot)
+
     if(args.length == 0){
         console.log(`
-        Bem vindo ao mdSmith!
-        Analisador de projetos Node.js
+mdSmith
+Node.js project analyzer
+────────────────────────
 
-        Digite npx mdsmith --help se quiser ver os comandos disponíveis
+Run "mdsmith --help" to view available commands.
         `);
         process.exit(0);
+    }else if (args.includes("--init")) {
+
+        const configPath = path.join(projectRoot, "mdsmith.config.json")
+
+        if (fs.existsSync(configPath)) {
+            console.log("mdsmith.config.json already exists.")
+            process.exit(0)
+        }
+
+        fs.writeFileSync(
+            configPath,
+            JSON.stringify(defaultConfig, null, 2)
+        )
+
+        console.log("Configuration file created.")
+        process.exit(0)
+
     } else if(args.includes("--help")){
         console.log(`
-        npx mdsmith --help      Mostra os comandos possíveis
-        npx mdsmith --tree      Mostra a estrutura do projeto
-        npx mdsmith --deps      Mostra as dependências
-        npx mdsmith --readme    Gera um README automaticamente
+mdSmith — Available Commands
+────────────────────────
+
+    --help      Show help
+    --init      Create config file
+    --tree      Show project structure
+    --deps      List dependencies
+    --readme    Generate README
         `)  
+        process.exit(0)
     } else if (args.includes("--tree")){
-        console.log("\n🌳 Estrutura do projeto:\n");
-        console.log(scanDir(projectRoot, 0))
+        console.log(`
+Project Structure
+────────────────────────
+        `);
+        console.log(scanDir(projectRoot, 0, config))
+        process.exit(0)
     } else if (args.includes("--deps")){
-        console.log(`O projeto ${packageJson.name} na versão ${packageJson.version}, tem as seguintes dependencias:`)
-        const deps = packageJson.dependencies || "Projeto sem depedencias"
+        console.log(`
+Dependencies
+────────────────────────   
+        `)
+        const deps = formatDependencies(packageJson.dependencies)
         console.log(deps)
+        process.exit(0)
     } else if (args.includes("--readme")){
-        const content = await generateReadme(packageJson, scanDir(projectRoot, 0))
+        const content = await generateReadme(packageJson, scanDir(projectRoot, 0, config))
 
-        fs.writeFileSync("README-MDSMITH.md", content)
-        console.log("✅ README-MDSMITH.md gerado com sucesso!")
-        process.exit(0);
+        console.log(`
+README Preview
+────────────────────────
+        `)
+
+        console.log(content)
+
+        let respostaValida = false
+        let confirm = ""
+
+        while (!respostaValida) {
+            confirm = await perguntar("\nGenerate README-MDSMITH.md? (y/n): ")
+            confirm = confirm.trim().toLowerCase()
+
+            if (confirm === "y" || confirm === "n") {
+                respostaValida = true
+            } else {
+                console.log("\nPlease type y or n.")
+            }
+        }
+
+        if (confirm === "y") {
+            fs.writeFileSync("README-MDSMITH.md", content)
+            console.log("\nREADME-MDSMITH.md created.\n")
+            process.exit(0)
+        } else {
+            console.log("\nOperation cancelled.\n")
+            process.exit(0)
+        }
     } else {
-        console.log("❌ Comando não reconhecido. Use npx mdsmith --help para ver as opções.")
+        console.log(`
+Unknown command.
+Run "mdsmith --help" for usage.    
+        `)
+        process.exit(0)
     }
 }
 
-main()
+main()
+

package/mdsmith.config.json

@@ -0,0 +1,8 @@
+{
+  "ignore": [
+    "node_modules",
+    ".git",
+    ".vscode"
+  ],
+  "depth": 1
+}

package/package.json

@@ -1,6 +1,7 @@
 {
+  "$schema": "https://json.schemastore.org/package.json",
   "name": "mdsmith",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "CLI para gerar READMEs e arquivos Markdown",
   "bin": {
     "mdsmith": "./bin/index.js"