@codigodoleo/wp-kit 2.0.4 → 3.0.1

package/modules/php/templates/workspace.json.hbs

@@ -1,74 +1,15 @@
-{
-  "settings": {
-    "php.validate.enable": true,
-    "php.validate.executablePath": "${workspaceFolder}/scripts/php-wrapper.sh",
-    "php.validate.run": "onSave",
-    "php.suggest.basic": false,
-    "intelephense.files.maxSize": 5000000,
-    "intelephense.files.exclude": [
-      "**/.git/**",
-      "**/node_modules/**",
-      "**/vendor/**/{Test,test,Tests,tests}/**",
-      "**/.lando/**",
-      "**/wp/**",
-      "**/content/cache/**"
-    ],
-    "intelephense.stubs": [
-      "wordpress"
-    ],
-    "[php]": {
-      "editor.defaultFormatter": "open-southeners.laravel-pint",
-      "editor.formatOnSave": true,
-      "editor.insertSpaces": true,
-      "editor.tabSize": 4
-    }
-  },
-  "extensions": {
-    "recommendations": [
-      "open-southeners.laravel-pint"
-    ]
-  },
-  "tasks": {
-    "tasks": [
-      {
-        "label": "🔧 PHP: Fix Code Style (Pint)",
-        "type": "shell",
-        "command": "lando",
-        "args": ["pint"],
-        "group": "build",
-        "presentation": {
-          "echo": true,
-          "reveal": "always",
-          "focus": false,
-          "panel": "shared"
-        },
-        "problemMatcher": []
-      },
-      {
-        "label": "🔍 PHP: Check Code Style (Pint)",
-        "type": "shell",
-        "command": "lando",
-        "args": ["pint", "--test"],
-        "group": "test",
-        "presentation": {
-          "echo": true,
-          "reveal": "always",
-          "focus": false,
-          "panel": "shared"
-        },
-        "problemMatcher": {
-          "owner": "pint",
-          "fileLocation": "absolute",
-          "pattern": {
-            "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error)\\s+-\\s+(.*)$",
-            "file": 1,
-            "line": 2,
-            "column": 3,
-            "severity": 4,
-            "message": 5
-          }
-        }
-      }
-    ]
-  }
-}
+{ "settings": { "php.validate.enable": true, "php.validate.executablePath":
+"${workspaceFolder}/scripts/php-wrapper.sh", "php.validate.run": "onSave", "php.suggest.basic":
+false, "intelephense.files.maxSize": 5000000, "intelephense.files.exclude": [ "**/.git/**",
+"**/node_modules/**", "**/vendor/**/{Test,test,Tests,tests}/**", "**/.lando/**", "**/wp/**",
+"**/content/cache/**" ], "intelephense.stubs": [ "wordpress" ], "[php]": {
+"editor.defaultFormatter": "open-southeners.laravel-pint", "editor.formatOnSave": true,
+"editor.insertSpaces": true, "editor.tabSize": 4 } }, "extensions": { "recommendations": [
+"open-southeners.laravel-pint" ] }, "tasks": { "tasks": [ { "label": "🔧 PHP: Fix Code Style
+(Pint)", "type": "shell", "command": "lando", "args": ["pint"], "group": "build", "presentation": {
+"echo": true, "reveal": "always", "focus": false, "panel": "shared" }, "problemMatcher": [] }, {
+"label": "🔍 PHP: Check Code Style (Pint)", "type": "shell", "command": "lando", "args": ["pint",
+"--test"], "group": "test", "presentation": { "echo": true, "reveal": "always", "focus": false,
+"panel": "shared" }, "problemMatcher": { "owner": "pint", "fileLocation": "absolute", "pattern": {
+"regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error)\\s+-\\s+(.*)$", "file": 1, "line": 2, "column":
+3, "severity": 4, "message": 5 } } } ] } }

package/modules/redis/prompts.js

@@ -3,6 +3,6 @@ export default [
     type: 'confirm',
     name: 'enable_redis',
     message: 'Enable Redis support?',
-    default: true
-  }
+    default: true,
+  },
 ];

package/modules/redis/templates/.lando.yml.hbs

@@ -1,8 +1 @@
-services:
-  cache:
-    type: redis:6
-
-tooling:
-  redis-cli:
-    service: cache
-    cmd: redis-cli
+services: cache: type: redis:6 tooling: redis-cli: service: cache cmd: redis-cli

package/modules/sage/index.js

@@ -1,20 +1,128 @@
 import path from 'path';
+import { execSync } from 'child_process';
+
 import fs from 'fs-extra';
+
 import { log, color } from '../../lib/utils/logger.js';
-import { execSync } from 'child_process';
+import { VERSION_REGISTRY, validateVersionCompatibility } from '../../lib/config/versions.js';
 
+/**
+ * Install Sage theme with enhanced error handling and validation
+ * - Validates version compatibility
+ * - Provides detailed error messages
+ * - Validates installation success
+ * - Better logging and progress tracking
+ */
 export async function setupModule(context, generator) {
   const themeDir = path.join(context.cwd, 'content', 'themes', context.projectName);
   const relativeThemeDir = `content/themes/${context.projectName}`;
 
-  await fs.ensureDir(themeDir);
+  try {
+    // 1. Validate version compatibility
+    const validation = validateVersionCompatibility(
+      context.sageVersion,
+      context.phpVersion,
+      context.nodeVersion,
+      context.wpCoreVersion
+    );
+
+    if (validation.errors.length > 0) {
+      log(color.red, '❌ Version compatibility errors:');
+      validation.errors.forEach((err) => log(color.red, `   - ${err}`));
+      throw new Error('Version compatibility check failed');
+    }
+
+    if (validation.warnings.length > 0) {
+      log(color.orange, '⚠️  Version compatibility warnings:');
+      validation.warnings.forEach((warn) => log(color.orange, `   - ${warn}`));
+    }
+
+    // 2. Get Sage configuration
+    const sageConfig = VERSION_REGISTRY.sage[context.sageVersion];
+    if (!sageConfig) {
+      throw new Error(`Sage version ${context.sageVersion} is not supported. Use 11 or 10.`);
+    }
+
+    // 3. Prepare and validate directory
+    await fs.ensureDir(themeDir);
+    const files = await fs.readdir(themeDir);
+    if (files.length > 0) {
+      log(
+        color.orange,
+        `⚠️  Warning: ${themeDir} is not empty. Existing files may be overwritten.`
+      );
+    }
+
+    // 4. Build composer command with proper error handling
+    const cmd = [
+      'composer create-project',
+      'roots/sage',
+      `"${themeDir}"`,
+      sageConfig.tag,
+      '--no-interaction',
+      '--ignore-platform-reqs',
+    ].join(' ');
+
+    log(color.blue, `[sage] 📦 Installing Sage ${context.sageVersion} (${sageConfig.tag})...`);
+    log(color.blue, `[sage] 📍 Location: ${relativeThemeDir}`);
+
+    // 5. Execute installation
+    execSync(cmd, { stdio: 'inherit', cwd: context.cwd });
+
+    // 6. Validate theme installation
+    await validateThemeInstallation(themeDir, sageConfig);
+    log(color.green, `[sage] ✅ Theme installation verified`);
+
+    // 7. Generate customizations
+    log(color.blue, `[sage] 📝 Generating theme customizations...`);
+    await generator.generateFile(
+      'theme/vite.config.js',
+      context,
+      'sage',
+      `${relativeThemeDir}/vite.config.js`
+    );
+    await generator.generateFile(
+      'theme/style.css',
+      context,
+      'sage',
+      `${relativeThemeDir}/style.css`
+    );
+
+    log(color.green, `[sage] ✅ Sage theme setup completed successfully`);
+  } catch (error) {
+    log(color.red, `[sage] ❌ Installation failed: ${error.message}`);
+    throw error;
+  }
+}
+
+/**
+ * Validate that Sage theme installation was successful
+ */
+async function validateThemeInstallation(themeDir, sageConfig) {
+  const requiredFiles = ['package.json', 'composer.json', 'theme.json'];
+  const missingFiles = [];
+
+  for (const file of requiredFiles) {
+    const filePath = path.join(themeDir, file);
+    if (!(await fs.pathExists(filePath))) {
+      missingFiles.push(file);
+    }
+  }
+
+  if (missingFiles.length > 0) {
+    throw new Error(`Theme installation incomplete. Missing files: ${missingFiles.join(', ')}`);
+  }
 
-  const cmd = `composer create-project roots/sage ${themeDir} ${context.sageVersion === '11' ? 'v11.0.1' : 'v10.8.2'} --no-interaction --ignore-platform-reqs`;
+  // Additional validation: check if package.json has correct structure
+  const packageJsonPath = path.join(themeDir, 'package.json');
+  const packageJson = await fs.readJson(packageJsonPath);
 
-  log(color.blue, `[sage] Installing Sage theme at: ${themeDir}`);
-  execSync(cmd, { stdio: 'inherit' });
+  // Sage packages typically have devDependencies (which is valid)
+  const hasDeps = packageJson.dependencies || packageJson.devDependencies;
 
-  await generator.generateFile('theme/vite.config.js', context, 'sage', `${relativeThemeDir}/vite.config.js`);
-  await generator.generateFile('theme/style.css', context, 'sage', `${relativeThemeDir}/style.css`);
+  if (!hasDeps) {
+    throw new Error('Theme package.json is missing dependency sections');
+  }
 
+  log(color.blue, `[sage] ℹ️  Theme info: ${packageJson.name} v${packageJson.version || '1.0.0'}`);
 }

package/modules/sage/prompts.js

@@ -3,7 +3,7 @@ export default [
     type: 'confirm',
     name: 'enable_sage',
     message: 'Enable Sage theme?',
-    default: true
+    default: true,
   },
   {
     type: 'list',
@@ -11,6 +11,6 @@ export default [
     message: 'Sage version:',
     choices: ['11', '10'],
     default: '11',
-    when: (answers) => answers.enable_sage
-  }
+    when: (answers) => answers.enable_sage,
+  },
 ];

package/modules/sage/templates/.lando.yml.hbs

@@ -1,64 +1,20 @@
-services:
-  appserver:
-    run:
-      - cd /app/content/themes/{{projectName}} && composer install --no-interaction --no-progress --optimize-autoloader
-      - cd /app/content/themes/{{projectName}} && yarn install && yarn build
-      - wp theme activate {{projectName}}
-      - cd /app/content/themes/{{projectName}} && wp acorn optimize:clear && wp acorn optimize
-tooling:
-  theme-build:
-    service: appserver
-    description: "Build the Sage theme"
-    dir: /app/content/themes/{{projectName}}
-    cmd:
-      - composer install --no-interaction --no-progress --optimize-autoloader
-      - yarn install
-      - yarn build
-  theme-lint:
-    service: appserver
-    description: "Lint the Sage theme"
-    dir: /app/content/themes/{{projectName}}
-    cmd:
-      - yarn lint
-      - pint --test
-  theme-dev:
-    service: appserver
-    description: "Dev the Sage theme"
-    dir: /app/content/themes/{{projectName}}
-    cmd:
-      - yarn dev
-  acorn-make:
-    service: appserver
-    description: Create new Acorn classes interactively
-    dir: /app/content/themes/{{projectName}}
-    cmd: wp acorn make:$ACORN_TYPE $ACORN_NAME
-    options:
-      type:
-        passthrough: true
-        alias:
-          - t
-        describe: Type of class to create
-        interactive:
-          type: list
-          message: What type of class would you like to create?
-          choices:
-            - name: Command (Artisan command)
-              value: command
-            - name: Component (View component class)
-              value: component
-            - name: Composer (View composer class)
-              value: composer
-            - name: Provider (Service provider class)
-              value: provider
-          weight: 100
-        env: ACORN_TYPE
-      filename:
-        passthrough: true
-        alias:
-          - n
-        describe: Name of the class to create
-        interactive:
-          type: input
-          message: What is the name of the class?
-          weight: 200
-        env: ACORN_NAME
+events: post-start: - cd /app/content/themes/{{projectName}}
+&& composer install --no-interaction --no-progress --optimize-autoloader - cd /app/content/themes/{{projectName}}
+&& yarn install && yarn build - wp theme activate
+{{projectName}}
+- cd /app/content/themes/{{projectName}}
+&& wp acorn optimize:clear && wp acorn optimize tooling: theme-build: service: appserver
+description: "Build the Sage theme" dir: /app/content/themes/{{projectName}}
+cmd: - composer install --no-interaction --no-progress --optimize-autoloader - yarn install - yarn
+build theme-lint: service: appserver description: "Lint the Sage theme" dir: /app/content/themes/{{projectName}}
+cmd: - yarn lint - pint --test theme-dev: service: appserver description: "Dev the Sage theme" dir:
+/app/content/themes/{{projectName}}
+cmd: - yarn dev acorn-make: service: appserver description: Create new Acorn classes interactively
+dir: /app/content/themes/{{projectName}}
+cmd: wp acorn make:$ACORN_TYPE $ACORN_NAME options: type: passthrough: true alias: - t describe:
+Type of class to create interactive: type: list message: What type of class would you like to
+create? choices: - name: Command (Artisan command) value: command - name: Component (View component
+class) value: component - name: Composer (View composer class) value: composer - name: Provider
+(Service provider class) value: provider weight: 100 env: ACORN_TYPE filename: passthrough: true
+alias: - n describe: Name of the class to create interactive: type: input message: What is the name
+of the class? weight: 200 env: ACORN_NAME

package/modules/sage/templates/theme/composer.json.hbs

@@ -1,18 +1,3 @@
-{
-  "name": "{{projectName}}/wordpress",
-  "type": "wordpress-theme",
-  "license": "MIT",
-  "description": "{{projectDescription}}",
-  "authors": [
-    {
-      "name": "{{author}}",
-      "email": "{{authorEmail}}"
-    }
-  ],
-  "support": { },
-  "require": {
-    "php": ">={{phpVersion}}",
-    "roots/acorn": "^5.0",
-    "log1x/sage-directives": "^2.0"
-  }
-}
+{ "name": "{{projectName}}/wordpress", "type": "wordpress-theme", "license": "MIT", "description": "{{projectDescription}}",
+"authors": [ { "name": "{{author}}", "email": "{{authorEmail}}" } ], "support": { }, "require": {
+"php": ">={{phpVersion}}", "roots/acorn": "^5.0", "log1x/sage-directives": "^2.0" } }

package/modules/sage/templates/theme/package.json.hbs

@@ -1,11 +1,3 @@
-{
-  "name": "{{projectName}}",
-  "author": "{{author}}",
-  "description": "{{projectDescription}}",
-  "version": "{{projectVersion}}",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "{{gitRepository}}"
-  }
-}
+{ "name": "{{projectName}}", "author": "{{author}}", "description": "{{projectDescription}}",
+"version": "{{projectVersion}}", "license": "MIT", "repository": { "type": "git", "url": "{{gitRepository}}"
+} }

package/modules/sage/templates/theme/style.css.hbs

@@ -1,13 +1,20 @@
-/*
-Theme Name:         {{projectName}}
-Theme URI:          {{gitRepository}}
-Description:        {{projectDescription}}
-Version:            {{projectVersion}}
-Author:             {{author}}
-Author URI:         {{gitRepository}}
-Text Domain:        {{projectName}}
-License:            MIT License
-License URI:        {{gitRepository}}/blob/main/LICENSE
-Requires PHP:       {{phpVersion}}
-Requires at least:  {{wpCoreVersion}}
-*/
+/* Theme Name:
+{{projectName}}
+Theme URI:
+{{gitRepository}}
+Description:
+{{projectDescription}}
+Version:
+{{projectVersion}}
+Author:
+{{author}}
+Author URI:
+{{gitRepository}}
+Text Domain:
+{{projectName}}
+License: MIT License License URI:
+{{gitRepository}}/blob/main/LICENSE Requires PHP:
+{{phpVersion}}
+Requires at least:
+{{wpCoreVersion}}
+*/

package/modules/sage/templates/theme/vite.config.js.hbs

@@ -1,53 +1,13 @@
-import fs from 'fs';
-import { defineConfig } from 'vite';
-import tailwindcss from '@tailwindcss/vite';
-import laravel from 'laravel-vite-plugin';
-import { wordpressPlugin, wordpressThemeJson } from '@roots/vite-plugin';
-
-export default defineConfig({
-  base: '/app/content/themes/{{projectName}}/',
-  plugins: [
-    tailwindcss(),
-    laravel({
-      input: [
-        'resources/css/app.css',
-        'resources/js/app.js',
-        'resources/css/editor.css',
-        'resources/js/editor.js',
-      ],
-      refresh: true,
-      watch: {
-        usePolling: true,
-        interval: 1000,
-        ignored: ['node_modules', 'public/build/hot'],
-      },
-    }),
-
-    wordpressPlugin(),
-
-    // Generate the theme.json file in the public/build/assets directory
-    // based on the Tailwind config and the theme.json file from base theme folder
-    wordpressThemeJson({
-      disableTailwindColors: false,
-      disableTailwindFonts: false,
-      disableTailwindFontSizes: false,
-    }),
-  ],
-  resolve: {
-    alias: {
-      '@scripts': '/resources/js',
-      '@styles': '/resources/css',
-      '@fonts': '/resources/fonts',
-      '@images': '/resources/images',
-    },
-  },
-  server: {
-    https: {
-      key: fs.readFileSync('/certs/cert.key'),
-      cert: fs.readFileSync('/certs/cert.crt'),
-    },
-    host: true,
-    port: 3009,
-    hmr: { host: 'localhost', protocol: 'wss' },
-  },
-});
+import fs from 'fs'; import { defineConfig } from 'vite'; import tailwindcss from
+'@tailwindcss/vite'; import laravel from 'laravel-vite-plugin'; import { wordpressPlugin,
+wordpressThemeJson } from '@roots/vite-plugin'; export default defineConfig({ base:
+'/app/content/themes/{{projectName}}/', plugins: [ tailwindcss(), laravel({ input: [
+'resources/css/app.css', 'resources/js/app.js', 'resources/css/editor.css',
+'resources/js/editor.js', ], refresh: true, watch: { usePolling: true, interval: 1000, ignored:
+['node_modules', 'public/build/hot'], }, }), wordpressPlugin(), // Generate the theme.json file in
+the public/build/assets directory // based on the Tailwind config and the theme.json file from base
+theme folder wordpressThemeJson({ disableTailwindColors: false, disableTailwindFonts: false,
+disableTailwindFontSizes: false, }), ], resolve: { alias: { '@scripts': '/resources/js', '@styles':
+'/resources/css', '@fonts': '/resources/fonts', '@images': '/resources/images', }, }, server: {
+https: { key: fs.readFileSync('/certs/cert.key'), cert: fs.readFileSync('/certs/cert.crt'), }, host:
+true, port: 3009, hmr: { host: 'localhost', protocol: 'wss' }, }, });

package/modules/sage/templates/workspace.json.hbs

@@ -1,67 +1,12 @@
-{
-  "folders": [
-    {
-      "path": "./content/themes/{{projectName}}",
-      "name": "🎨 Theme"
-    }
-  ],
-  "settings": {
-    "gitlens.hovers.detailsMarkdownFormat": "testing"
-  },
-  "tasks": {
-    "tasks": [
-      {
-        "label": "🏗️ Theme: Build Assets",
-        "type": "shell",
-        "command": "lando",
-        "args": ["yarn", "build"],
-        "options": {
-          "cwd": "${workspaceFolder}/content/themes/wordpress-dev"
-        },
-        "group": "build",
-        "presentation": {
-          "echo": true,
-          "reveal": "always",
-          "focus": false,
-          "panel": "shared"
-        },
-        "problemMatcher": []
-      },
-      {
-        "label": "👀 Theme: Watch Assets",
-        "type": "shell",
-        "command": "lando",
-        "args": ["yarn", "dev"],
-        "options": {
-          "cwd": "${workspaceFolder}/content/themes/wordpress-dev"
-        },
-        "group": "build",
-        "isBackground": true,
-        "presentation": {
-          "echo": true,
-          "reveal": "always",
-          "focus": false,
-          "panel": "shared"
-        },
-        "problemMatcher": []
-      },
-      {
-        "label": "📦 Theme: Composer Install",
-        "type": "shell",
-        "command": "lando",
-        "args": ["composer", "install"],
-        "options": {
-          "cwd": "${workspaceFolder}/content/themes/wordpress-dev"
-        },
-        "group": "build",
-        "presentation": {
-          "echo": true,
-          "reveal": "always",
-          "focus": false,
-          "panel": "shared"
-        },
-        "problemMatcher": []
-      }
-    ]
-  }
-}
+{ "folders": [ { "path": "./content/themes/{{projectName}}", "name": "🎨 Theme" } ], "settings": {
+"gitlens.hovers.detailsMarkdownFormat": "testing" }, "tasks": { "tasks": [ { "label": "🏗️ Theme:
+Build Assets", "type": "shell", "command": "lando", "args": ["yarn", "build"], "options": { "cwd":
+"${workspaceFolder}/content/themes/wordpress-dev" }, "group": "build", "presentation": { "echo":
+true, "reveal": "always", "focus": false, "panel": "shared" }, "problemMatcher": [] }, { "label":
+"👀 Theme: Watch Assets", "type": "shell", "command": "lando", "args": ["yarn", "dev"], "options": {
+"cwd": "${workspaceFolder}/content/themes/wordpress-dev" }, "group": "build", "isBackground": true,
+"presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared" },
+"problemMatcher": [] }, { "label": "📦 Theme: Composer Install", "type": "shell", "command":
+"lando", "args": ["composer", "install"], "options": { "cwd":
+"${workspaceFolder}/content/themes/wordpress-dev" }, "group": "build", "presentation": { "echo":
+true, "reveal": "always", "focus": false, "panel": "shared" }, "problemMatcher": [] } ] } }

package/modules/test-directory/prompts.js

@@ -3,6 +3,6 @@ export default [
     type: 'confirm',
     name: 'enable_test_directory',
     message: 'Enable test directory module (demonstrates copyDirectory functionality)?',
-    default: false
-  }
+    default: false,
+  },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codigodoleo/wp-kit",
-  "version": "2.0.4",
+  "version": "3.0.1",
   "description": "Kit opinativo para padronizar projetos WordPress com CI/CD dinâmico.",
   "main": "bin/index.js",
   "bin": {
@@ -22,8 +22,11 @@
     ".gitkeep"
   ],
   "scripts": {
+    "prepare": "husky install",
     "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "format": "prettier --write .",
+    "commit": "cz",
     "test:setup": "npm run test:clean && npm run test:scaffold",
     "test:clean": "rm -rf __test-sandbox__",
     "test:scaffold": "node ./bin/index.js init --output=__test-sandbox__/test-project --defaults",
@@ -41,12 +44,23 @@
   "license": "ISC",
   "type": "module",
   "devDependencies": {
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@commitlint/prompt": "^18.4.3",
     "@cspell/dict-php": "^4.0.14",
     "@cspell/dict-pt-br": "^2.4.0",
+    "@eslint/js": "^9.30.1",
+    "commitizen": "^4.3.0",
+    "conventional-changelog-cli": "^4.1.0",
     "eslint": "^9.30.1",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.2.0",
+    "globals": "^16.3.0",
+    "husky": "^8.0.3",
+    "lint-staged": "^15.2.1",
     "prettier": "^3.6.2",
+    "standard-version": "^9.5.0",
     "stylelint": "^16.21.1",
     "stylelint-config-standard-scss": "^15.0.1"
   },
@@ -58,5 +72,10 @@
     "inquirer": "^12.7.0",
     "js-yaml": "^4.1.0",
     "lodash.mergewith": "^4.6.2"
+  },
+  "config": {
+    "commitizen": {
+      "path": "@commitlint/prompt"
+    }
   }
 }