@codigodoleo/wp-kit 3.2.0 → 3.4.0

package/modules/mu-plugin/lint/eslint.config.mjs

@@ -0,0 +1,30 @@
+import js from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier/flat';
+import prettierPlugin from 'eslint-plugin-prettier';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['node_modules/**', 'vendor/**', 'dist/**'],
+  },
+  js.configs.recommended,
+  {
+    files: ['resources/**/*.{js,mjs,ts}'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  eslintConfigPrettier,
+];

package/modules/mu-plugin/lint/pint.json

@@ -0,0 +1,11 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  }
+}

package/modules/mu-plugin/prompts.js

@@ -0,0 +1,23 @@
+export default [
+  {
+    type: 'input',
+    name: 'mu_plugin_name',
+    message: 'MU Plugin slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-core`,
+    when: (answers) => answers.selectedContentModules?.includes('mu-plugin'),
+  },
+  {
+    type: 'confirm',
+    name: 'mu_plugin_lint_pint',
+    message: 'MU Plugin: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.selectedContentModules?.includes('mu-plugin') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'mu_plugin_lint_eslint',
+    message: 'MU Plugin: enable ESLint for JS/TS?',
+    default: false,
+    when: (answers) => answers.selectedContentModules?.includes('mu-plugin') && answers.enable_lint,
+  },
+];

package/modules/mu-plugin/templates/.lando.yml.hbs

@@ -0,0 +1,15 @@
+tooling:
+{{#if enable_lint}}
+  mu-pint:
+    service: appserver
+    description: Lint PHP in the MU plugin
+    dir: /app/content/mu-plugins/{{mu_plugin_name}}
+    cmd: ./vendor/bin/pint
+{{#if mu_plugin_lint_eslint}}
+  mu-eslint:
+    service: build
+    description: Lint JS/TS in the MU plugin
+    dir: /app/content/mu-plugins/{{mu_plugin_name}}
+    cmd: npx eslint --fix resources/
+{{/if}}
+{{/if}}

package/modules/mu-plugin/templates/composer.json.hbs

@@ -0,0 +1,14 @@
+{
+  "description": "{{projectDescription}} — MU Plugin",
+  "autoload": {
+    "psr-4": {
+      "App\\MuPlugins\\": "src/"
+    }
+  },
+  "require-dev": {
+    "laravel/pint": "^1.21"
+  },
+  "scripts": {
+    "lint": ["./vendor/bin/pint --test"]
+  }
+}

package/modules/mu-plugin/templates/plugin.php.hbs

@@ -0,0 +1,15 @@
+<?php
+/**
+ * Plugin Name: {{mu_plugin_name}}
+ * Description: {{projectDescription}}
+ * Version:     {{projectVersion}}
+ */
+
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// Autoload via Composer
+if (file_exists(__DIR__ . '/vendor/autoload.php')) {
+    require_once __DIR__ . '/vendor/autoload.php';
+}

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

@@ -1 +1,15 @@
-{ "require-dev": { "laravel/pint": "^1.29", "phpunit/phpunit": "^11.5", "phpstan/phpstan": "^2.1", "phpstan/extension-installer": "^1.4", "szepeviktor/phpstan-wordpress": "^2.0", "php-stubs/wordpress-stubs": "^6.8" }, "config": { "allow-plugins": { "phpstan/extension-installer": true } } }
+{
+  "require-dev": {
+    "laravel/pint": "^1.29",
+    "phpunit/phpunit": "^12.5",
+    "phpstan/phpstan": "^2.1",
+    "phpstan/extension-installer": "^1.4",
+    "szepeviktor/phpstan-wordpress": "^2.0",
+    "php-stubs/wordpress-stubs": "^6.8"
+  },
+  "config": {
+    "allow-plugins": {
+      "phpstan/extension-installer": true
+    }
+  }
+}

package/modules/plugin/index.js

@@ -0,0 +1,45 @@
+import path from 'path';
+
+import fs from 'fs-extra';
+
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, generator) {
+  const pluginName = context.plugin_name || `${context.projectName}-plugin`;
+  const pluginDir = `content/plugins/${pluginName}`;
+  const absolutePluginDir = path.join(generator.cwd, pluginDir);
+
+  log(color.blue, `[plugin] 📂 Scaffolding plugin: ${pluginDir}`);
+
+  // 1. Ensure directory exists
+  await fs.ensureDir(absolutePluginDir);
+
+  // 2. Generate main plugin entry file
+  await generator.generateFile(
+    'plugin.php',
+    { ...context, plugin_name: pluginName },
+    'plugin',
+    `${pluginDir}/${pluginName}.php`
+  );
+
+  // 3. Generate composer.json
+  await generator.generateFile(
+    'composer.json',
+    { ...context, plugin_name: pluginName },
+    'plugin',
+    `${pluginDir}/composer.json`
+  );
+
+  // 4. Create src/ scaffold
+  await fs.ensureFile(path.join(absolutePluginDir, 'src', '.gitkeep'));
+
+  // 5. Lint configs co-located in plugin — always installed (IDE/editor support)
+  log(color.blue, '[plugin] 🔧 Installing lint configurations...');
+  await generator.copyFile('lint/.prettierrc.json', 'plugin', `${pluginDir}/.prettierrc.json`);
+  await generator.copyFile('lint/pint.json', 'plugin', `${pluginDir}/pint.json`);
+  if (context.plugin_lint_eslint === true) {
+    await generator.copyFile('lint/eslint.config.mjs', 'plugin', `${pluginDir}/eslint.config.mjs`);
+  }
+
+  log(color.green, `[plugin] ✅ Plugin scaffolded: ${pluginDir}`);
+}

package/modules/plugin/lint/.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2
+}

package/modules/plugin/lint/eslint.config.mjs

@@ -0,0 +1,30 @@
+import js from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier/flat';
+import prettierPlugin from 'eslint-plugin-prettier';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['node_modules/**', 'vendor/**', 'dist/**'],
+  },
+  js.configs.recommended,
+  {
+    files: ['resources/**/*.{js,mjs,ts}'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  eslintConfigPrettier,
+];

package/modules/plugin/lint/pint.json

@@ -0,0 +1,11 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  }
+}

package/modules/plugin/prompts.js

@@ -0,0 +1,23 @@
+export default [
+  {
+    type: 'input',
+    name: 'plugin_name',
+    message: 'Plugin slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-plugin`,
+    when: (answers) => answers.selectedContentModules?.includes('plugin'),
+  },
+  {
+    type: 'confirm',
+    name: 'plugin_lint_pint',
+    message: 'Plugin: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.selectedContentModules?.includes('plugin') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'plugin_lint_eslint',
+    message: 'Plugin: enable ESLint for JS/TS?',
+    default: false,
+    when: (answers) => answers.selectedContentModules?.includes('plugin') && answers.enable_lint,
+  },
+];

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

@@ -0,0 +1,15 @@
+tooling:
+{{#if enable_lint}}
+  plugin-pint:
+    service: appserver
+    description: Lint PHP in the plugin
+    dir: /app/content/plugins/{{plugin_name}}
+    cmd: ./vendor/bin/pint
+{{#if plugin_lint_eslint}}
+  plugin-eslint:
+    service: build
+    description: Lint JS/TS in the plugin
+    dir: /app/content/plugins/{{plugin_name}}
+    cmd: npx eslint --fix resources/
+{{/if}}
+{{/if}}

package/modules/plugin/templates/composer.json.hbs

@@ -0,0 +1,14 @@
+{
+  "description": "{{projectDescription}} — Plugin",
+  "autoload": {
+    "psr-4": {
+      "App\\Plugins\\": "src/"
+    }
+  },
+  "require-dev": {
+    "laravel/pint": "^1.21"
+  },
+  "scripts": {
+    "lint": ["./vendor/bin/pint --test"]
+  }
+}

package/modules/plugin/templates/plugin.php.hbs

@@ -0,0 +1,15 @@
+<?php
+/**
+ * Plugin Name: {{plugin_name}}
+ * Description: {{projectDescription}}
+ * Version:     {{projectVersion}}
+ */
+
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+// Autoload via Composer
+if (file_exists(__DIR__ . '/vendor/autoload.php')) {
+    require_once __DIR__ . '/vendor/autoload.php';
+}

package/modules/sage/index.js

@@ -175,6 +175,31 @@ export async function setupModule(context, generator) {
       mergeStrategy: 'replace',
     });
 
+    // 8. Lint configs co-located in theme — always installed (IDE/editor support)
+    log(color.blue, '[sage] 🔧 Installing lint configurations...');
+    await generator.copyFile(
+      'lint/.prettierrc.json',
+      'sage',
+      `${relativeThemeDir}/.prettierrc.json`
+    );
+    if (context.sage_lint_eslint !== false) {
+      await generator.copyFile(
+        'lint/eslint.config.mjs',
+        'sage',
+        `${relativeThemeDir}/eslint.config.mjs`
+      );
+    }
+    if (context.sage_lint_pint !== false) {
+      await generator.copyFile('lint/pint.json', 'sage', `${relativeThemeDir}/pint.json`);
+    }
+    if (context.sage_lint_stylelint !== false) {
+      await generator.copyFile(
+        'lint/.stylelintrc.json',
+        'sage',
+        `${relativeThemeDir}/.stylelintrc.json`
+      );
+    }
+
     log(color.green, '[sage] ✅ Advanced Sage setup completed successfully');
     log(color.green, `[sage] ✅ Theme directory: ${relativeThemeDir}`);
     log(color.green, '[sage] ✅ Lando + Devcontainer command parity enabled');

package/modules/sage/lint/.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "overrides": [
+    { "files": "*.blade.php", "options": { "parser": "html" } },
+    { "files": "*.vue", "options": { "parser": "vue" } },
+    { "files": "*.scss", "options": { "singleQuote": false } }
+  ]
+}

package/modules/sage/lint/.stylelintrc.json

@@ -0,0 +1,7 @@
+{
+  "extends": ["stylelint-config-standard-scss"],
+  "rules": {
+    "color-hex-length": "short",
+    "string-quotes": "double"
+  }
+}

package/modules/sage/lint/eslint.config.mjs

@@ -0,0 +1,30 @@
+import js from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier/flat';
+import prettierPlugin from 'eslint-plugin-prettier';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['node_modules/**', 'vendor/**', 'public/build/**'],
+  },
+  js.configs.recommended,
+  {
+    files: ['resources/**/*.{js,mjs,ts,vue}'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    plugins: {
+      prettier: prettierPlugin,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  eslintConfigPrettier,
+];

package/modules/sage/lint/pint.json

@@ -0,0 +1,11 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  }
+}

package/modules/sage/prompts.js

@@ -1,16 +1,31 @@
 export default [
-  {
-    type: 'confirm',
-    name: 'enable_sage',
-    message: 'Enable Sage theme (advanced setup is automatic)?',
-    default: true,
-  },
   {
     type: 'list',
     name: 'sageVersion',
     message: 'Sage version:',
     choices: ['11', '10'],
     default: '11',
-    when: (answers) => answers.enable_sage,
+    when: (answers) => answers.selectedContentModules?.includes('sage'),
+  },
+  {
+    type: 'confirm',
+    name: 'sage_lint_eslint',
+    message: 'Sage: enable ESLint for JS/TS/Vue?',
+    default: true,
+    when: (answers) => answers.selectedContentModules?.includes('sage') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'sage_lint_stylelint',
+    message: 'Sage: enable Stylelint for CSS/SCSS?',
+    default: true,
+    when: (answers) => answers.selectedContentModules?.includes('sage') && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'sage_lint_pint',
+    message: 'Sage: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.selectedContentModules?.includes('sage') && answers.enable_lint,
   },
 ];

package/modules/sage/templates/.devcontainer/docker-compose.override.yml.hbs

@@ -1,6 +1,4 @@
 services:
-  wordpress:
+  app:
     environment:
       SAGE_THEME_DIR: /workspace/content/themes/{{projectName}}
-    ports:
-      - "3009:3009"

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

@@ -7,10 +7,10 @@ services:
     scanner: false
 events:
   post-start:
-    - bash ./server/cmd/setup-sage-php.sh
-    - bash ./server/cmd/setup-sage-node.sh
-    - wp theme activate {{projectName}}
-    - cd /app/content/themes/{{projectName}} && wp acorn optimize:clear
+    - appserver: bash ./server/cmd/setup-sage-php.sh
+    - appserver: wp theme activate {{projectName}}
+    - appserver: cd /app/content/themes/{{projectName}} && wp acorn optimize:clear
+    - build: bash ./server/cmd/setup-sage-node.sh
 tooling:
   dev:
     service: build
@@ -29,8 +29,20 @@ tooling:
     cmd: npm run build --prefix /app/content/themes/{{projectName}}
   theme-lint:
     service: build
-    description: Lint the Sage theme
+    description: Lint the Sage theme (JS/TS/Vue)
     cmd: npm run lint --prefix /app/content/themes/{{projectName}}
+{{#if enable_lint}}
+  pint:
+    service: appserver
+    description: Lint PHP in the Sage theme
+    dir: /app/content/themes/{{projectName}}
+    cmd: ./vendor/bin/pint
+  stylelint:
+    service: build
+    description: Lint CSS/SCSS in the Sage theme
+    cmd: npx stylelint --fix "resources/**/*.{css,scss}" --config /app/content/themes/{{projectName}}/.stylelintrc.json
+    dir: /app/content/themes/{{projectName}}
+{{/if}}
   acorn:
     service: appserver
     description: Run Acorn artisan commands

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

@@ -1,8 +1,8 @@
-import fs from 'fs';
-import { defineConfig } from 'vite';
+import { wordpressPlugin, wordpressThemeJson } from '@roots/vite-plugin';
 import tailwindcss from '@tailwindcss/vite';
+import fs from 'fs';
 import laravel from 'laravel-vite-plugin';
-import { wordpressPlugin, wordpressThemeJson } from '@roots/vite-plugin';
+import { defineConfig } from 'vite';
 
 export default defineConfig({
 	base: '/app/content/themes/{{projectName}}/',
@@ -45,7 +45,7 @@ export default defineConfig({
 			cert: fs.readFileSync('/certs/cert.crt'),
 		},
 		host: true,
-		port: 3009,
+		port: 5173,
 		strictPort: true,
 		hmr: {
 			host: 'localhost',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codigodoleo/wp-kit",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Kit opinativo para padronizar projetos WordPress com CI/CD dinâmico.",
   "main": "bin/index.js",
   "bin": {
@@ -30,6 +30,12 @@
     "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",
+    "test:e2e": "bash scripts/validate-e2e.sh",
+    "test:e2e:base": "bash scripts/validate-e2e.sh base",
+    "test:e2e:sage": "bash scripts/validate-e2e.sh sage",
+    "test:e2e:blank-theme": "bash scripts/validate-e2e.sh blank-theme",
+    "test:e2e:mu-plugin": "bash scripts/validate-e2e.sh mu-plugin",
+    "test:e2e:all": "bash scripts/validate-e2e.sh all",
     "open-cursor": "cursor ./__test-sandbox__/test-project/wordpress-dev.code-workspace"
   },
   "keywords": [

package/templates/.devcontainer/docker-compose.yml.hbs

@@ -3,6 +3,9 @@ services:
     build:
       context: ..
       dockerfile: .devcontainer/Dockerfile
+    # Force linux/amd64 for Apple Silicon (ARM) compatibility via Rosetta 2.
+    # Remove this line if the base image gains a native linux/arm64 variant.
+    platform: linux/amd64
     container_name: {{projectName}}-app
     working_dir: /workspace
     env_file:

package/templates/.gitignore.hbs

@@ -1,13 +1,84 @@
-# WordPress wp/ content/uploads/* !content/uploads/.gitkeep content/upgrade/* content/backup-db/*
-content/backups/* content/blogs.dir/* content/cache/* content/advanced-cache.php
-content/wp-cache-config.php content/plugins/* !content/plugins/.gitkeep content/themes/*
-content/languages/* !content/languages/.gitkeep content/mu-plugins/* !content/mu-plugins/.gitkeep #
-Theme{{#if enable_sage}}
-  !content/themes/{{projectName}}{{/if}}
-
-# Composer vendor/ composer.phar # Node.js
-node_modules/ npm-debug.log* yarn-debug.log* yarn-error.log* .npm .yarn-integrity # IDE/Editor *.swp
-*.swo *~ # OS .DS_Store .DS_Store? ._* .Spotlight-V100 .Trashes ehthumbs.db Thumbs.db # Logs *.log
-logs/ # Temporary files *.tmp *.temp .cache/ # Build artifacts dist/ build/ public/build/ # Database
-*.sql *.sqlite # Backup files *.bak *.backup *.old # Lando .lando.local.yml # PHP *.php~ *.php.bak
-php_errors.log # Testing coverage/ .phpunit.result.cache
+# WordPress
+wp/
+content/uploads/*
+!content/uploads/.gitkeep
+content/upgrade/*
+content/backup-db/*
+content/backups/*
+content/blogs.dir/*
+content/cache/*
+content/advanced-cache.php
+content/wp-cache-config.php
+content/plugins/*
+!content/plugins/.gitkeep
+content/themes/*
+content/languages/*
+!content/languages/.gitkeep
+content/mu-plugins/*
+!content/mu-plugins/.gitkeep
+
+# Theme{{#if enable_sage}}
+!content/themes/{{projectName}}{{/if}}
+
+
+# Composer
+vendor/
+composer.phar
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.yarn-integrity
+
+
+# IDE/Editor
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# Build artifacts
+dist/
+build/
+public/build/
+
+# Database
+*.sql
+*.sqlite
+
+# Backup files
+*.bak
+*.backup
+*.old
+
+# Lando
+.lando.local.yml
+
+# PHP
+*.php~
+*.php.bak
+php_errors.log
+
+# Testing
+coverage/
+.phpunit.result.cache

package/templates/.lando.yml.hbs

@@ -28,6 +28,7 @@ services:
     build:
       - bash /app/server/cmd/setup-php.sh
     overrides:
+      platform: linux/amd64
       extra_hosts:
         - "host.docker.internal:host-gateway"
       environment:
@@ -41,6 +42,7 @@ services:
       - bash /app/server/cmd/setup-node.sh
     scanner: false
     overrides:
+      platform: linux/amd64
       ports:
         - 5173:5173
   database: