@codigodoleo/wp-kit 3.1.1 → 3.3.0

package/modules/deploy/templates/.gitlab/ci/release.yml.hbs

@@ -0,0 +1,26 @@
+# Job reutilizável — Semantic Release
+#
+# Como usar no .gitlab-ci.yml principal:
+#
+#   include:
+#     - local: '.gitlab/ci/release.yml'
+#
+#   stages:
+#     - release
+#
+# Variáveis necessárias (Settings → CI/CD → Variables):
+#   GITLAB_TOKEN  — Personal/Project Access Token com scope "api"
+#   NPM_TOKEN     — Token npm (omita se o projeto não publicar no npm)
+
+semantic-release:
+  stage: release
+  image: node:{{nodeVersion}}-alpine
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+  before_script:
+    - npm ci
+  script:
+    - npx semantic-release
+  variables:
+    GITLAB_TOKEN: $GITLAB_TOKEN
+    NPM_TOKEN: $NPM_TOKEN

package/modules/git/.husky/commit-msg

@@ -1,4 +1,8 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx --no -- commitlint --edit "$1"
+echo "🔍 Validating commit message..."
+if command -v lando >/dev/null 2>&1 && lando info >/dev/null 2>&1; then
+    echo "🐳 Using Lando environment..."
+    lando commitlint --edit "$1"
+else
+    echo "🏠 Using local environment..."
+    npx --no commitlint --edit "$1"
+fi

package/modules/git/.husky/pre-commit

@@ -1,6 +1,3 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
 echo "🔍 Running pre-commit checks..."
 
 # Check if lint-staged config exists

package/modules/git/templates/package.json.hbs

@@ -1,4 +1,4 @@
-{ "scripts": { "prepare": "husky install", "commit": "lando git-cz" }, "devDependencies": {
-"@commitlint/cli": "^18.4.3", "@commitlint/config-conventional": "^18.4.3", "@commitlint/prompt":
-"^18.4.3", "commitizen": "^4.3.0", "conventional-changelog-cli": "^4.1.0", "husky": "^8.0.3",
-"lint-staged": "^15.2.1" } }
+{ "scripts": { "prepare": "husky", "commit": "lando git-cz" }, "devDependencies": {
+"@commitlint/cli": "^19.7.1", "@commitlint/config-conventional": "^19.7.1", "@commitlint/prompt":
+"^19.5.0", "commitizen": "^4.3.1", "husky": "^9.0.11",
+"lint-staged": "^15.5.0" } }

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

@@ -1,6 +1,6 @@
 {
 	"settings": {
-		"git.inputValidation": "always",
+		"git.inputValidation": true,
 		"git.inputValidationSubjectLength": 72,
 		"git.inputValidationLength": 72,
 		"git.verboseCommit": true,

package/modules/lint/.commitlintrc.json

@@ -0,0 +1,21 @@
+{
+  "extends": ["@commitlint/config-conventional"],
+  "rules": {
+    "type-enum": [
+      2,
+      "always",
+      ["feat", "fix", "docs", "style", "refactor", "perf", "test", "chore", "ci", "build", "revert"]
+    ],
+    "type-case": [2, "always", "lower-case"],
+    "type-empty": [2, "never"],
+    "scope-case": [2, "always", "lower-case"],
+    "subject-case": [2, "never", ["sentence-case", "start-case", "pascal-case", "upper-case"]],
+    "subject-empty": [2, "never"],
+    "subject-full-stop": [2, "never", "."],
+    "header-max-length": [2, "always", 72],
+    "body-leading-blank": [1, "always"],
+    "body-max-line-length": [2, "always", 100],
+    "footer-leading-blank": [1, "always"],
+    "footer-max-line-length": [2, "always", 100]
+  }
+}

package/modules/lint/.prettierignore

@@ -1,36 +1,26 @@
-# Ignore node_modules and build directories
+# Node & Composer
 node_modules/
-dist/
-build/
-
-# Ignore WordPress core
-wp/
-wp-content/plugins/
-wp-content/mu-plugins/
-wp-content/uploads/
-wp-content/upgrade/
+vendor/
 
-content/plugins/
+# Development module folders — each has its own lint config
+content/themes/
 content/mu-plugins/
+content/plugins/
+
+# WordPress core and uploads
+wp/
 content/uploads/
 content/upgrade/
+content/cache/
 
-# Ignore Composer dependencies
-vendor/
+# Build outputs
+public/build/
+dist/
+.lando/
 
-# Ignore logs and environment
-*.log
+# Env and logs
 .env
 .env.*
-
-# Ignore IDE and system files
-.DS_Store
-Thumbs.db
-
-# Ignore Lando config cache
-.lando/
-
-# Ignore anything temporary
+*.log
 *.tmp
-*.temp
 *.bak

package/modules/lint/.prettierrc.json

@@ -1,29 +1,18 @@
 {
   "semi": true,
   "singleQuote": true,
-  "trailingComma": "es5",
   "tabWidth": 2,
   "printWidth": 100,
+  "trailingComma": "es5",
   "bracketSpacing": true,
-  "arrowParens": "avoid",
   "overrides": [
     {
-      "files": ["*.scss", "*.css", "*.sass"],
-      "options": {
-        "singleQuote": false
-      }
-    },
-    {
-      "files": ["*.json", "*.yml", "*.yaml"],
-      "options": {
-        "tabWidth": 2
-      }
+      "files": ["*.yml", "*.yaml"],
+      "options": { "tabWidth": 2 }
     },
     {
-      "files": "*.html",
-      "options": {
-        "htmlWhitespaceSensitivity": "ignore"
-      }
+      "files": "*.md",
+      "options": { "proseWrap": "always" }
     }
   ]
 }

package/modules/lint/index.js

@@ -1,14 +1,81 @@
+import path from 'path';
+
+import fs from 'fs-extra';
+
+/**
+ * Builds the lint-staged entries object from active development modules.
+ * Each dev module contributes globs pointing to its own directory.
+ */
+function buildLintStagedEntries(context) {
+  const entries = {};
+
+  // Infra: YAML, JSON, Markdown at root (never touching module folders)
+  entries['*.{yml,yaml}'] = ['prettier --write'];
+  entries['*.{json,md}'] = ['prettier --write'];
+
+  // Sage
+  if (context.enable_sage) {
+    const dir = `content/themes/${context.projectName}`;
+    if (context.sage_lint_eslint !== false) {
+      entries[`${dir}/resources/**/*.{js,ts,vue,mjs}`] = ['eslint --fix'];
+    }
+    if (context.sage_lint_stylelint !== false) {
+      entries[`${dir}/resources/**/*.{css,scss}`] = ['stylelint --fix'];
+    }
+    if (context.sage_lint_pint !== false) {
+      entries[`${dir}/app/**/*.php`] = ['pint'];
+    }
+  }
+
+  // MU-Plugin
+  if (context.enable_mu_plugin) {
+    const dir = `content/mu-plugins/${context.mu_plugin_name || `${context.projectName}-core`}`;
+    if (context.mu_plugin_lint_eslint !== false) {
+      entries[`${dir}/resources/**/*.{js,ts}`] = ['eslint --fix'];
+    }
+    if (context.mu_plugin_lint_pint !== false) {
+      entries[`${dir}/src/**/*.php`] = ['pint'];
+    }
+  }
+
+  // Plugin
+  if (context.enable_plugin) {
+    const dir = `content/plugins/${context.plugin_name || `${context.projectName}-plugin`}`;
+    if (context.plugin_lint_eslint !== false) {
+      entries[`${dir}/resources/**/*.{js,ts}`] = ['eslint --fix'];
+    }
+    if (context.plugin_lint_pint !== false) {
+      entries[`${dir}/src/**/*.php`] = ['pint'];
+    }
+  }
+
+  // Blank Theme
+  if (context.enable_blank_theme) {
+    const dir = `content/themes/${context.blank_theme_name || `${context.projectName}-theme`}`;
+    if (context.blank_theme_lint_eslint !== false) {
+      entries[`${dir}/src/**/*.{js,ts}`] = ['eslint --fix'];
+    }
+    if (context.blank_theme_lint_stylelint !== false) {
+      entries[`${dir}/src/**/*.{css,scss}`] = ['stylelint --fix'];
+    }
+    if (context.blank_theme_lint_pint !== false) {
+      entries[`${dir}/src/**/*.php`] = ['pint'];
+    }
+  }
+
+  return entries;
+}
+
 export async function setupModule(context, generator) {
-  await generator.copyFile('eslint.config.mjs', 'lint');
-  await generator.copyFile('.prettierrc.json', 'lint');
+  if (!context.enable_lint) return;
 
+  // Root developer tooling (always present when lint is enabled)
+  await generator.copyFile('.commitlintrc.json', 'lint');
   await generator.copyFile('.prettierrc.json', 'lint');
   await generator.copyFile('.prettierignore', 'lint');
 
-  await generator.copyFile('pint.json', 'lint');
-
-  if (context.enable_stylelint) {
-    await generator.copyFile('.stylelintrc.json', 'lint');
-    await generator.copyFile('.stylelintignore', 'lint');
-  }
+  // Compose .lintstagedrc.json from active modules
+  const entries = buildLintStagedEntries(context);
+  const lintStagedPath = path.join(generator.cwd, '.lintstagedrc.json');
+  await fs.outputFile(lintStagedPath, JSON.stringify(entries, null, 2) + '\n');
 }

package/modules/lint/prompts.js

@@ -3,14 +3,7 @@ export default [
   {
     type: 'confirm',
     name: 'enable_lint',
-    message: 'Enable linting and formatting tools (ESLint + Prettier)?',
+    message: 'Enable developer tooling (Husky, commitlint, Prettier for infra files)?',
     default: true,
   },
-  {
-    type: 'confirm',
-    name: 'enable_stylelint',
-    message: 'Include Stylelint config?',
-    default: true,
-    when: answers => answers.enable_lint,
-  },
 ];

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

@@ -1,10 +1,5 @@
 tooling:
-  eslint:
+  commitlint:
     service: appserver
-    cmd: yarn eslint
-  prettier:
-    service: appserver
-    cmd: yarn prettier
-  stylelint:
-    service: appserver
-    cmd: yarn stylelint **/*.{css,scss,vue}
+    description: Validate commit message format
+    cmd: npx commitlint --edit

package/modules/lint/templates/package.json.hbs

@@ -1,4 +1,4 @@
-{ "scripts": { "format": "prettier --write .", "lint": "lando eslint . --ext .js,.ts", "lint:fix":
-"lando eslint . --ext .js,.ts --fix" }, "devDependencies": { "globals": "^16.3.0",
-"@eslint/eslintrc": "^3.3.1", "@eslint/js": "^9.30.1", "eslint": "^8.56.0",
-"eslint-config-prettier": "^8.10.0", "eslint-plugin-prettier": "^4.2.1", "prettier": "^2.8.8" } }
+{ "scripts": { "format": "prettier --write .", "lint": "lando eslint .", "lint:fix":
+"lando eslint . --fix" }, "devDependencies": { "globals": "^16.3.0",
+"@eslint/eslintrc": "^3.3.1", "@eslint/js": "^9.30.1", "eslint": "^9.30.1",
+"eslint-config-prettier": "^10.1.5", "eslint-plugin-prettier": "^5.3.1", "prettier": "^3.6.2" } }

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

@@ -3,9 +3,9 @@
     "editor.defaultFormatter": "esbenp.prettier-vscode",
     "editor.formatOnSave": false,
     "editor.codeActionsOnSave": {
-      "source.fixAll": true,
-      "source.fixAll.eslint": true,
-      "source.organizeImports": true
+      "source.fixAll": "explicit",
+      "source.fixAll.eslint": "explicit",
+      "source.organizeImports": "explicit"
     },
     "prettier.requireConfig": true,
     "prettier.useEditorConfig": true,

package/modules/mu-plugin/index.js

@@ -0,0 +1,49 @@
+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.mu_plugin_name || `${context.projectName}-core`;
+  const pluginDir = `content/mu-plugins/${pluginName}`;
+  const absolutePluginDir = path.join(generator.cwd, pluginDir);
+
+  log(color.blue, `[mu-plugin] 📂 Scaffolding MU plugin: ${pluginDir}`);
+
+  // 1. Ensure directory exists
+  await fs.ensureDir(absolutePluginDir);
+
+  // 2. Generate main plugin entry file
+  await generator.generateFile(
+    'plugin.php',
+    { ...context, mu_plugin_name: pluginName },
+    'mu-plugin',
+    `${pluginDir}/${pluginName}.php`
+  );
+
+  // 3. Generate composer.json
+  await generator.generateFile(
+    'composer.json',
+    { ...context, mu_plugin_name: pluginName },
+    'mu-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, '[mu-plugin] 🔧 Installing lint configurations...');
+  await generator.copyFile('lint/.prettierrc.json', 'mu-plugin', `${pluginDir}/.prettierrc.json`);
+  await generator.copyFile('lint/pint.json', 'mu-plugin', `${pluginDir}/pint.json`);
+  if (context.mu_plugin_lint_eslint === true) {
+    await generator.copyFile(
+      'lint/eslint.config.mjs',
+      'mu-plugin',
+      `${pluginDir}/eslint.config.mjs`
+    );
+  }
+
+  log(color.green, `[mu-plugin] ✅ MU plugin scaffolded: ${pluginDir}`);
+}

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

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

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,29 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_mu_plugin',
+    message: 'Enable MU Plugin scaffold?',
+    default: false,
+  },
+  {
+    type: 'input',
+    name: 'mu_plugin_name',
+    message: 'MU Plugin slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-core`,
+    when: (answers) => answers.enable_mu_plugin,
+  },
+  {
+    type: 'confirm',
+    name: 'mu_plugin_lint_pint',
+    message: 'MU Plugin: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.enable_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.enable_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.23", "phpunit/phpunit": "^9.5" } }
+{
+  "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,29 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_plugin',
+    message: 'Enable Plugin scaffold?',
+    default: false,
+  },
+  {
+    type: 'input',
+    name: 'plugin_name',
+    message: 'Plugin slug (used as directory name):',
+    default: (answers) => `${answers.projectName || 'wordpress'}-plugin`,
+    when: (answers) => answers.enable_plugin,
+  },
+  {
+    type: 'confirm',
+    name: 'plugin_lint_pint',
+    message: 'Plugin: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.enable_plugin && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'plugin_lint_eslint',
+    message: 'Plugin: enable ESLint for JS/TS?',
+    default: false,
+    when: (answers) => answers.enable_plugin && answers.enable_lint,
+  },
+];