@codigodoleo/wp-kit 3.2.0 → 3.3.0

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/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.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,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,
+  },
+];

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

@@ -13,4 +13,25 @@ export default [
     default: '11',
     when: (answers) => answers.enable_sage,
   },
+  {
+    type: 'confirm',
+    name: 'sage_lint_eslint',
+    message: 'Sage: enable ESLint for JS/TS/Vue?',
+    default: true,
+    when: (answers) => answers.enable_sage && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'sage_lint_stylelint',
+    message: 'Sage: enable Stylelint for CSS/SCSS?',
+    default: true,
+    when: (answers) => answers.enable_sage && answers.enable_lint,
+  },
+  {
+    type: 'confirm',
+    name: 'sage_lint_pint',
+    message: 'Sage: enable Pint for PHP?',
+    default: true,
+    when: (answers) => answers.enable_sage && answers.enable_lint,
+  },
 ];