@perma-tools/cli 0.0.1

package/dist/project-generator.js

@@ -0,0 +1,311 @@
+import { spinner } from "@clack/prompts";
+import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ActionExecutor } from "./actions.js";
+import { getDependencyVersion } from "./dependency-versions.js";
+import { SnippetManager } from "./snippet-manager.js";
+export class ProjectGenerator {
+    snippetManager;
+    rootPath;
+    constructor(rootPath) {
+        this.snippetManager = new SnippetManager();
+        // Se rootPath não for fornecido, calcula a partir da localização deste arquivo
+        // __dirname alternativa para ES modules
+        if (!rootPath) {
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = dirname(__filename);
+            // Detectar se está em desenvolvimento ou produção
+            // Em desenvolvimento: __dirname = packages/cli/
+            // Em produção (NPM): __dirname = node_modules/@perma-tools/cli/dist/
+            // Em ambos os casos, templates e snippets estão no mesmo nível
+            // Dev: packages/cli/ (arquivos .ts ao lado de templates/ e snippets/)
+            // Prod: dist/ (arquivos .js ao lado de templates/ e snippets/ copiados)
+            this.rootPath = __dirname;
+        }
+        else {
+            this.rootPath = rootPath;
+        }
+    }
+    async generate(config) {
+        const s = spinner();
+        try {
+            // 1. Copiar template base
+            s.start("📁 Copiando template base...");
+            await this.copyTemplate(config);
+            s.stop("✅ Template copiado!");
+            // 2. Processar snippets
+            const snippets = this.snippetManager.getSnippetsForProject(config);
+            if (snippets.length > 0) {
+                s.start("🔧 Configurando bibliotecas...");
+                await this.processSnippets(config, snippets);
+                s.stop("✅ Bibliotecas configuradas!");
+            }
+            // 3. Atualizar package.json
+            s.start("📦 Atualizando dependências...");
+            await this.updatePackageJson(config, snippets);
+            s.stop("✅ Dependências atualizadas!");
+            // 4. Criar .env.example
+            s.start("⚙️ Criando arquivos de configuração...");
+            await this.createEnvFile(config);
+            s.stop("✅ Configuração criada!");
+            // 5. Criar .vscode (sempre, se for frontend)
+            s.start("🔧 Configurando VSCode...");
+            await this.createVscodeConfig(config);
+            s.stop("✅ VSCode configurado!");
+            // 6. Instalar dependências (se o usuário quiser)
+            if (config.shouldInstallDeps) {
+                s.start(`📦 Instalando dependências com ${config.packageManager}...`);
+                await this.installDependencies(config);
+                s.stop("✅ Dependências instaladas!");
+            }
+            // 7. Configurar shadcn/ui (se o usuário quiser)
+            if (config.withShadcn) {
+                s.start("🎨 Configurando shadcn/ui...");
+                await this.setupShadcn(config);
+                s.stop("✅ shadcn/ui configurado!");
+            }
+        }
+        catch (error) {
+            s.stop("❌ Erro durante a geração");
+            throw error;
+        }
+    }
+    async copyTemplate(config) {
+        const templatePath = this.getTemplatePath(config);
+        const projectPath = config.projectPath;
+        // Copiar template recursivamente
+        await cp(templatePath, projectPath, { recursive: true });
+    }
+    getTemplatePath(config) {
+        if (config.applicationType === "frontend") {
+            if (config.framework === "nextjs-15") {
+                return join(this.rootPath, "templates/frontend/next15/base");
+            }
+            else if (config.framework === "vitejs-6") {
+                return join(this.rootPath, "templates/frontend/vite6/base");
+            }
+        }
+        else if (config.applicationType === "backend") {
+            return join(this.rootPath, "templates/backend/base");
+        }
+        throw new Error("Template não encontrado para a configuração especificada");
+    }
+    async processSnippets(config, snippets) {
+        const executor = new ActionExecutor(config.projectPath, this.rootPath, config.packageManager);
+        // Coletar todas as ações de todos os snippets
+        const allActions = snippets.flatMap((snippet) => snippet.actions);
+        // Ordenar por prioridade
+        allActions.sort((a, b) => (a.priority ?? 999) - (b.priority ?? 999));
+        // Executar todas as ações
+        for (const action of allActions) {
+            await executor.execute(action);
+        }
+    }
+    async updatePackageJson(config, snippets) {
+        const packageJsonPath = join(config.projectPath, "package.json");
+        const packageJson = JSON.parse(await readFile(packageJsonPath, "utf-8"));
+        // Obter todas as dependências dos snippets
+        const { dependencies, devDependencies } = this.snippetManager.getAllDependencies(snippets);
+        // Adicionar dependências com versões específicas
+        if (dependencies.length > 0) {
+            packageJson.dependencies = packageJson.dependencies || {};
+            for (const dep of dependencies) {
+                packageJson.dependencies[dep] = getDependencyVersion(dep);
+            }
+        }
+        if (devDependencies.length > 0) {
+            packageJson.devDependencies = packageJson.devDependencies || {};
+            for (const dep of devDependencies) {
+                packageJson.devDependencies[dep] = getDependencyVersion(dep);
+            }
+        }
+        // Atualizar nome do projeto
+        if (config.projectName) {
+            packageJson.name = config.projectName;
+        }
+        // Adicionar scripts do linter
+        packageJson.scripts = packageJson.scripts || {};
+        if (config.linter === "biome") {
+            packageJson.scripts.lint = "biome check .";
+            packageJson.scripts["lint:fix"] = "biome check --write .";
+            packageJson.scripts.format = "biome format --write .";
+        }
+        else if (config.linter === "eslint-prettier") {
+            packageJson.scripts.lint = "next lint";
+            packageJson.scripts["lint:fix"] = "eslint . --fix";
+            packageJson.scripts.format = "prettier --write .";
+        }
+        await writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2), "utf-8");
+    }
+    async createEnvFile(config) {
+        const envPath = join(config.projectPath, ".env.example");
+        let envContent = "# Environment Variables\n\n";
+        // Adicionar variáveis baseadas nas escolhas
+        if (config.httpClient === "ky") {
+            envContent += "NEXT_PUBLIC_API_URL=http://localhost:3000/api\n";
+        }
+        else if (config.httpClient === "axios") {
+            envContent += "REACT_APP_API_BASE_URL=http://localhost:3000/api\n";
+        }
+        await writeFile(envPath, envContent, "utf-8");
+    }
+    async installDependencies(config) {
+        const executor = new ActionExecutor(config.projectPath, this.rootPath, config.packageManager);
+        await executor.execute({
+            type: "install-deps",
+            dependencies: [],
+            devDependencies: [],
+        });
+    }
+    async setupShadcn(config) {
+        const executor = new ActionExecutor(config.projectPath, this.rootPath, config.packageManager);
+        // 1. Executar shadcn init (sempre necessário)
+        console.log("\n🎨 Inicializando shadcn/ui...");
+        let initCommand;
+        let initArgs;
+        // Usar a cor selecionada ou neutral como padrão
+        const baseColor = config.shadcnColor || "neutral";
+        if (config.packageManager === "pnpm") {
+            initCommand = "pnpm";
+            initArgs = [
+                "dlx",
+                "shadcn@latest",
+                "init",
+                "-y",
+                "--defaults",
+                `--base-color=${baseColor}`,
+            ];
+        }
+        else if (config.packageManager === "yarn") {
+            initCommand = "npx";
+            initArgs = [
+                "-y",
+                "shadcn@latest",
+                "init",
+                "-y",
+                "--defaults",
+                `--base-color=${baseColor}`,
+            ];
+        }
+        else {
+            // npm
+            initCommand = "npx";
+            initArgs = [
+                "-y",
+                "shadcn@latest",
+                "init",
+                "-y",
+                "--defaults",
+                `--base-color=${baseColor}`,
+            ];
+        }
+        await executor.execute({
+            type: "run-command",
+            command: initCommand,
+            args: initArgs,
+        });
+        // 2. Adicionar componentes (se foram selecionados)
+        if (config.shadcnComponents && config.shadcnComponents.length > 0) {
+            console.log(`\n🧩 Adicionando ${config.shadcnComponents.length} componente(s)...`);
+            let addCommand;
+            let addArgs;
+            if (config.packageManager === "pnpm") {
+                addCommand = "pnpm";
+                addArgs = [
+                    "dlx",
+                    "shadcn@latest",
+                    "add",
+                    ...config.shadcnComponents,
+                    "-y",
+                ];
+            }
+            else if (config.packageManager === "yarn") {
+                addCommand = "npx";
+                addArgs = [
+                    "-y",
+                    "shadcn@latest",
+                    "add",
+                    ...config.shadcnComponents,
+                    "-y",
+                ];
+            }
+            else {
+                // npm
+                addCommand = "npx";
+                addArgs = [
+                    "-y",
+                    "shadcn@latest",
+                    "add",
+                    ...config.shadcnComponents,
+                    "-y",
+                ];
+            }
+            await executor.execute({
+                type: "run-command",
+                command: addCommand,
+                args: addArgs,
+            });
+        }
+    }
+    async createVscodeConfig(config) {
+        const vscodeDir = join(config.projectPath, ".vscode");
+        const extensionsPath = join(vscodeDir, "extensions.json");
+        const settingsPath = join(vscodeDir, "settings.json");
+        // Criar diretório .vscode se não existir
+        await mkdir(vscodeDir, { recursive: true });
+        // Determinar extensões recomendadas baseado no linter
+        const extensions = ["bradlc.vscode-tailwindcss"]; // Sempre incluir Tailwind
+        if (config.linter === "biome") {
+            extensions.push("biomejs.biome");
+        }
+        else if (config.linter === "eslint-prettier") {
+            extensions.push("dbaeumer.vscode-eslint", "esbenp.prettier-vscode");
+        }
+        // Criar extensions.json
+        const extensionsJson = {
+            recommendations: extensions,
+        };
+        // Criar settings.json baseado no linter
+        const settingsJson = {
+            "editor.formatOnSave": true,
+            "editor.formatOnPaste": true,
+            "files.eol": "\n",
+            "typescript.preferences.preferTypeOnlyAutoImports": true,
+        };
+        // Configurar defaultFormatter baseado no linter
+        if (config.linter === "biome") {
+            settingsJson["editor.defaultFormatter"] = "biomejs.biome";
+            settingsJson["[typescriptreact]"] = {
+                "editor.defaultFormatter": "biomejs.biome",
+            };
+            settingsJson["[typescript]"] = {
+                "editor.defaultFormatter": "biomejs.biome",
+            };
+            settingsJson["[jsonc]"] = {
+                "editor.defaultFormatter": "biomejs.biome",
+            };
+            settingsJson["[css]"] = {
+                "editor.defaultFormatter": "biomejs.biome",
+            };
+        }
+        else if (config.linter === "eslint-prettier") {
+            settingsJson["editor.defaultFormatter"] = "esbenp.prettier-vscode";
+            settingsJson["[typescriptreact]"] = {
+                "editor.defaultFormatter": "esbenp.prettier-vscode",
+            };
+            settingsJson["[typescript]"] = {
+                "editor.defaultFormatter": "esbenp.prettier-vscode",
+            };
+            settingsJson["[jsonc]"] = {
+                "editor.defaultFormatter": "esbenp.prettier-vscode",
+            };
+            settingsJson["[css]"] = {
+                "editor.defaultFormatter": "esbenp.prettier-vscode",
+            };
+        }
+        // Escrever arquivos
+        await writeFile(extensionsPath, JSON.stringify(extensionsJson, null, 2) + "\n", "utf-8");
+        await writeFile(settingsPath, JSON.stringify(settingsJson, null, "\t") + "\n", "utf-8");
+    }
+}

package/dist/snippet-manager.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectConfig, SnippetConfig } from "./types.js";
+export declare class SnippetManager {
+    private snippets;
+    constructor();
+    private registerSnippet;
+    getSnippetsForProject(config: ProjectConfig): SnippetConfig[];
+    getAllDependencies(snippets: SnippetConfig[]): {
+        dependencies: string[];
+        devDependencies: string[];
+    };
+}

package/dist/snippet-manager.js

@@ -0,0 +1,76 @@
+import { axiosConfig } from "./configs/axios.config.js";
+import { biomeConfig } from "./configs/biome.config.js";
+import { cookiesNextConfig } from "./configs/cookies-next.config.js";
+import { dateFnsConfig } from "./configs/date-fns.config.js";
+import { eslintPrettierConfig } from "./configs/eslint-prettier.config.js";
+import { framerMotionConfig } from "./configs/framer-motion.config.js";
+import { kyConfig } from "./configs/ky.config.js";
+import { lucideReactConfig } from "./configs/lucide-react.config.js";
+import { nuqsConfig } from "./configs/nuqs.config.js";
+import { reactHookFormConfig } from "./configs/react-hook-form.config.js";
+import { rechartsConfig } from "./configs/recharts.config.js";
+import { tanstackQueryConfig } from "./configs/tanstack-query.config.js";
+import { zodConfig } from "./configs/zod.config.js";
+export class SnippetManager {
+    snippets = new Map();
+    constructor() {
+        // Registrar todos os snippets disponíveis
+        this.registerSnippet("ky", kyConfig);
+        this.registerSnippet("axios", axiosConfig);
+        this.registerSnippet("tanstack-query", tanstackQueryConfig);
+        this.registerSnippet("nuqs", nuqsConfig);
+        this.registerSnippet("date-fns", dateFnsConfig);
+        this.registerSnippet("biome", biomeConfig);
+        this.registerSnippet("eslint-prettier", eslintPrettierConfig);
+        this.registerSnippet("zod", zodConfig);
+        this.registerSnippet("react-hook-form", reactHookFormConfig);
+        this.registerSnippet("cookies-next", cookiesNextConfig);
+        this.registerSnippet("framer-motion", framerMotionConfig);
+        this.registerSnippet("lucide-react", lucideReactConfig);
+        this.registerSnippet("recharts", rechartsConfig);
+    }
+    registerSnippet(key, config) {
+        this.snippets.set(key, config);
+    }
+    getSnippetsForProject(config) {
+        const selectedSnippets = [];
+        // HTTP Client
+        if (config.httpClient && config.httpClient !== "fetch") {
+            const snippet = this.snippets.get(config.httpClient);
+            if (snippet)
+                selectedSnippets.push(snippet);
+        }
+        // Linter
+        if (config.linter) {
+            const snippet = this.snippets.get(config.linter);
+            if (snippet)
+                selectedSnippets.push(snippet);
+        }
+        // Additional Libs
+        if (config.additionalLibs) {
+            for (const lib of config.additionalLibs) {
+                const snippet = this.snippets.get(lib);
+                if (snippet)
+                    selectedSnippets.push(snippet);
+            }
+        }
+        // Ordenar por prioridade
+        return selectedSnippets.sort((a, b) => {
+            const aPriority = Math.min(...a.actions.map((action) => action.priority ?? 999));
+            const bPriority = Math.min(...b.actions.map((action) => action.priority ?? 999));
+            return aPriority - bPriority;
+        });
+    }
+    getAllDependencies(snippets) {
+        const dependencies = new Set();
+        const devDependencies = new Set();
+        for (const snippet of snippets) {
+            snippet.dependencies?.forEach((dep) => dependencies.add(dep));
+            snippet.devDependencies?.forEach((dep) => devDependencies.add(dep));
+        }
+        return {
+            dependencies: Array.from(dependencies),
+            devDependencies: Array.from(devDependencies),
+        };
+    }
+}

package/dist/snippets/axios/index.ts

@@ -0,0 +1,6 @@
+import axios from "axios";
+
+export const api = axios.create({
+  baseURL: process.env.REACT_APP_API_BASE_URL || "http://localhost:3000/api",
+  timeout: 30000,
+});

package/dist/snippets/biome/biome.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.0.5/schema.json",
+  "root": false,
+  "extends": "//",
+  "css": {
+    "formatter": {
+      "enabled": true
+    },
+    "linter": {
+      "enabled": false
+    }
+  },
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "javascript": {
+    "formatter": {
+      "trailingCommas": "es5",
+      "lineEnding": "lf"
+    },
+    "globals": ["React"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "a11y": {
+        "recommended": true,
+        "noSvgWithoutTitle": "off"
+      },
+      "style": {
+        "recommended": true,
+        "noDefaultExport": "error",
+        "noImplicitBoolean": "off"
+      },
+      "suspicious": {
+        "recommended": true,
+        "noReactSpecificProps": "off"
+      },
+      "complexity": {
+        "recommended": true
+      },
+      "correctness": {
+        "recommended": true,
+        "useImportExtensions": "off"
+      },
+      "performance": {
+        "recommended": true
+      },
+      "security": {
+        "recommended": true
+      }
+    }
+  },
+  "files": {
+    "includes": ["**", "!node_modules"]
+  },
+  "overrides": [
+    {
+      "includes": [
+        "src/app/**/page.tsx",
+        "src/app/**/layout.tsx",
+
+        "*.config.js",
+        "*.config.mjs",
+        "*.config.ts"
+      ],
+      "linter": {
+        "rules": {
+          "style": {
+            "noDefaultExport": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["src/@types/**/*.d.ts"],
+      "linter": {
+        "rules": {
+          "correctness": {
+            "noUndeclaredVariables": "off"
+          }
+        }
+      }
+    }
+  ]
+}

package/dist/snippets/eslint-prettier/eslintignore

@@ -0,0 +1,6 @@
+node_modules
+.next
+out
+dist
+build
+.turbo

package/dist/snippets/eslint-prettier/eslintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ["next/core-web-vitals", "next/typescript"],
+};

package/dist/snippets/eslint-prettier/prettierignore

@@ -0,0 +1,9 @@
+node_modules
+.next
+out
+dist
+build
+.turbo
+package-lock.json
+pnpm-lock.yaml
+yarn.lock

package/dist/snippets/eslint-prettier/prettierrc.js

@@ -0,0 +1,9 @@
+module.exports = {
+  semi: true,
+  trailingComma: "es5",
+  singleQuote: true,
+  printWidth: 100,
+  tabWidth: 2,
+  useTabs: false,
+  plugins: ["prettier-plugin-tailwindcss"],
+};

package/dist/snippets/ky/index.ts

@@ -0,0 +1,5 @@
+import ky from "ky";
+
+export const api = ky.create({
+  prefixUrl: process.env.NEXT_PUBLIC_API_URL, // e.g. 'https://api.example.com'
+});

package/dist/snippets/react-query/index.tsx

@@ -0,0 +1,53 @@
+import {
+  defaultShouldDehydrateQuery,
+  isServer,
+  QueryClientProvider as Provider,
+  QueryClient,
+} from "@tanstack/react-query";
+
+function makeQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: 1000 * 30, // 30 seconds
+        refetchOnReconnect: false,
+        refetchOnWindowFocus: false,
+        retry: false,
+      },
+      dehydrate: {
+        // include pending queries in dehydration
+        shouldDehydrateQuery: (query) =>
+          defaultShouldDehydrateQuery(query) ||
+          query.state.status === "pending",
+      },
+    },
+  });
+}
+
+let browserQueryClient: QueryClient | undefined;
+
+export function getQueryClient() {
+  if (isServer) {
+    // Server: always make a new query client
+    return makeQueryClient();
+  }
+
+  // Browser: make a new query client if we don't already have one
+  // This is very important, so we don't re-make a new client if React
+  // suspends during the initial render. This may not be needed if we
+  // have a suspense boundary BELOW the creation of the query client
+  if (!browserQueryClient) {
+    browserQueryClient = makeQueryClient();
+  }
+  return browserQueryClient;
+}
+
+interface QueryClientProviderProps {
+  children: React.ReactNode;
+}
+
+export function QueryClientProvider({ children }: QueryClientProviderProps) {
+  const client = getQueryClient();
+
+  return <Provider client={client}>{children}</Provider>;
+}

package/dist/snippets/vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["bradlc.vscode-tailwindcss", "biomejs.biome"]
+}

package/dist/snippets/vscode/settings.json

@@ -0,0 +1,19 @@
+{
+  "editor.formatOnSave": true,
+  "editor.formatOnPaste": true,
+  "files.eol": "\n",
+  "typescript.preferences.preferTypeOnlyAutoImports": true,
+  "editor.defaultFormatter": "biomejs.biome",
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}

package/dist/templates/frontend/next15/base/.env.example

@@ -0,0 +1,3 @@
+# Environment Variables
+
+NEXT_PUBLIC_API_URL=http://localhost:3000/api

package/dist/templates/frontend/next15/base/README.md

@@ -0,0 +1,50 @@
+# Next.js 15 Template
+
+Este é o template base gerado pela `@perma-tools/cli`.
+
+## 📝 Próximos Passos
+
+### 1. Adicionar Favicon
+
+Para adicionar um favicon ao seu projeto, coloque um dos seguintes arquivos em `src/app/`:
+
+- `favicon.ico` (16x16 ou 32x32)
+- `icon.png` (qualquer tamanho)
+- `icon.svg` (vetor)
+- `apple-icon.png` (180x180 para dispositivos Apple)
+
+O Next.js detectará automaticamente e os utilizará.
+
+### 2. Personalizar Metadados
+
+Edite `src/app/layout.tsx` para alterar:
+- `title`: Título do site
+- `description`: Descrição para SEO
+- Adicione mais metadados conforme necessário
+
+### 3. Configurar Variáveis de Ambiente
+
+Se você selecionou bibliotecas que requerem variáveis de ambiente, elas estarão listadas em `.env.example`.
+
+Copie para `.env.local` e preencha os valores:
+
+```bash
+cp .env.example .env.local
+```
+
+### 4. Iniciar Desenvolvimento
+
+```bash
+pnpm dev
+```
+
+Abra [http://localhost:3000](http://localhost:3000) no navegador.
+
+## 🔧 Tecnologias Incluídas
+
+Veja o `package.json` para a lista completa de bibliotecas configuradas.
+
+## 📚 Recursos
+
+- [Documentação Next.js](https://nextjs.org/docs)
+- [Learn Next.js](https://nextjs.org/learn)

package/dist/templates/frontend/next15/base/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;