@codigodoleo/wp-kit 3.1.1 → 3.3.0

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

@@ -11,10 +11,24 @@
   "tasks": {
     "tasks": [
       {
-        "label": "🏗️ Theme: Build Assets",
+        "label": "🛶 Lando: theme-bootstrap",
         "type": "shell",
         "command": "lando",
-        "args": ["yarn", "build"],
+        "args": ["theme-bootstrap"],
+        "group": "build",
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
+      },
+      {
+        "label": "🛶 Lando: theme-build",
+        "type": "shell",
+        "command": "lando",
+        "args": ["theme-build"],
         "options": {
           "cwd": "${workspaceFolder}/content/themes/{{projectName}}"
         },
@@ -28,10 +42,10 @@
         "problemMatcher": []
       },
       {
-        "label": "👀 Theme: Watch Assets",
+        "label": "🛶 Lando: theme-dev",
         "type": "shell",
         "command": "lando",
-        "args": ["yarn", "dev"],
+        "args": ["theme-dev"],
         "options": {
           "cwd": "${workspaceFolder}/content/themes/{{projectName}}"
         },
@@ -46,10 +60,27 @@
         "problemMatcher": []
       },
       {
-        "label": "📦 Theme: Composer Install",
+        "label": "🛶 Lando: theme-lint",
+        "type": "shell",
+        "command": "lando",
+        "args": ["theme-lint"],
+        "options": {
+          "cwd": "${workspaceFolder}/content/themes/{{projectName}}"
+        },
+        "group": "build",
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
+      },
+      {
+        "label": "🛶 Lando: acorn",
         "type": "shell",
         "command": "lando",
-        "args": ["composer", "install"],
+        "args": ["acorn", "make:component", "ExampleBlock"],
         "options": {
           "cwd": "${workspaceFolder}/content/themes/{{projectName}}"
         },
@@ -61,6 +92,63 @@
           "panel": "shared"
         },
         "problemMatcher": []
+      },
+      {
+        "label": "🐳 Devcontainer: theme-build",
+        "type": "shell",
+        "command": "docker",
+        "args": ["compose", "-f", ".devcontainer/docker-compose.yml", "-f", ".devcontainer/docker-compose.override.yml", "exec", "wordpress", "bash", "-lc", "cd /workspace/content/themes/{{projectName}} && yarn build"],
+        "group": "build",
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
+      },
+      {
+        "label": "🐳 Devcontainer: theme-dev",
+        "type": "shell",
+        "command": "docker",
+        "args": ["compose", "-f", ".devcontainer/docker-compose.yml", "-f", ".devcontainer/docker-compose.override.yml", "exec", "wordpress", "bash", "-lc", "cd /workspace/content/themes/{{projectName}} && yarn dev"],
+        "group": "build",
+        "isBackground": true,
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
+      },
+      {
+        "label": "🐳 Devcontainer: theme-lint",
+        "type": "shell",
+        "command": "docker",
+        "args": ["compose", "-f", ".devcontainer/docker-compose.yml", "-f", ".devcontainer/docker-compose.override.yml", "exec", "wordpress", "bash", "-lc", "cd /workspace/content/themes/{{projectName}} && yarn lint"],
+        "group": "build",
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
+      },
+      {
+        "label": "🐳 Devcontainer: acorn",
+        "type": "shell",
+        "command": "docker",
+        "args": ["compose", "-f", ".devcontainer/docker-compose.yml", "-f", ".devcontainer/docker-compose.override.yml", "exec", "wordpress", "bash", "-lc", "cd /workspace/content/themes/{{projectName}} && wp acorn make:component ExampleBlock"],
+        "group": "build",
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared"
+        },
+        "problemMatcher": []
       }
     ]
   }

package/modules/skills/index.js

@@ -0,0 +1,18 @@
+import { installSuperpowersSage } from '../../lib/utils/git.js';
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, _generator) {
+  if (!context.enable_skills) {
+    log(color.orange, '[skills] Instalação de skills desabilitada. Pulando.');
+    return;
+  }
+
+  const targets = context.skills_targets ?? ['claude'];
+
+  if (targets.length === 0) {
+    log(color.orange, '[skills] Nenhum destino selecionado. Pulando.');
+    return;
+  }
+
+  await installSuperpowersSage(context.cwd, targets);
+}

package/modules/skills/prompts.js

@@ -0,0 +1,21 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_skills',
+    message: 'Instalar AI skills (superpowers-sage) no projeto?',
+    default: true,
+  },
+  {
+    type: 'checkbox',
+    name: 'skills_targets',
+    message: 'Onde instalar as skills?',
+    choices: [
+      { name: 'Claude Code  → .claude/', value: 'claude' },
+      { name: 'Cursor       → .cursor/', value: 'cursor' },
+      { name: 'Agnóstico    → .ai/', value: 'ai' },
+    ],
+    default: ['claude'],
+    when: (answers) => answers.enable_skills,
+    validate: (selected) => (selected.length > 0 ? true : 'Selecione ao menos um destino.'),
+  },
+];

package/modules/test/index.js

@@ -0,0 +1,19 @@
+import path from 'path';
+
+import fs from 'fs-extra';
+
+export async function setupModule(context, generator) {
+  const testsDir = path.join(context.cwd, 'tests');
+  await fs.ensureDir(path.join(testsDir, 'e2e', 'helpers'));
+
+  await generator.copyFile('tests/Pest.php', 'test', 'tests/Pest.php');
+  await generator.copyFile('tests/SmokeTest.php', 'test', 'tests/SmokeTest.php');
+  await generator.copyFile('tests/e2e/example.spec.js', 'test', 'tests/e2e/example.spec.js');
+  await generator.copyFile(
+    'tests/e2e/helpers/loginHelper.js',
+    'test',
+    'tests/e2e/helpers/loginHelper.js'
+  );
+
+  await generator.generateFile('playwright.config.js', context, 'test');
+}

package/modules/test/prompts.js

@@ -0,0 +1,8 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_test',
+    message: 'Enable testing suite (Pest for PHP + Playwright for E2E)?',
+    default: true,
+  },
+];

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

@@ -0,0 +1,16 @@
+{
+  "require-dev": {
+    "pestphp/pest": "^4.4"
+  },
+  "config": {
+    "allow-plugins": {
+      "pestphp/pest-plugin": true
+    }
+  },
+  "scripts": {
+    "test": "pest",
+    "test:coverage": "pest --coverage"
+  },
+  "minimum-stability": "dev",
+  "prefer-stable": true
+}

package/modules/test/templates/package.json.hbs

@@ -0,0 +1,11 @@
+{
+  "scripts": {
+    "test": "pest",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:report": "playwright show-report"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0"
+  }
+}

package/modules/test/templates/playwright.config.js.hbs

@@ -0,0 +1,29 @@
+import { devices } from '@playwright/test';
+
+/**
+ * Playwright E2E test configuration.
+ * @see https://playwright.dev/docs/test-configuration
+ */
+const config = {
+  testDir: './tests/e2e',
+  timeout: 30 * 1000,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: process.env.CI ? 'github' : 'list',
+  use: {
+    actionTimeout: 0,
+    baseURL: process.env.WP_HOME || 'https://{{projectName}}.lndo.site',
+    trace: 'on-first-retry',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        ...devices['Desktop Chrome'],
+      },
+    },
+  ],
+};
+
+export default config;

package/modules/test/tests/Pest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+|--------------------------------------------------------------------------
+| Test Case
+|--------------------------------------------------------------------------
+|
+| The closure you provide to your test functions is always bound to a specific
+| PHPUnit test case class. By default, that class is "PHPUnit\Framework\TestCase".
+| You can change this by specifying a `uses()` call at the top of your file.
+|
+*/
+
+// uses(Tests\TestCase::class)->in('Feature');
+
+/*
+|--------------------------------------------------------------------------
+| Expectations
+|--------------------------------------------------------------------------
+|
+| When you're writing tests, you often need to check that values meet certain
+| conditions. The "expect()" function gives you access to a set of "expectations"
+| methods that you can use to assert different things. Of course, you may use
+| the default PHPUnit assertions at any time as well.
+|
+*/
+
+/*
+|--------------------------------------------------------------------------
+| Functions
+|--------------------------------------------------------------------------
+|
+| While Pest is very powerful out-of-the-box, you may have some testing
+| helpers that you want to share between tests. Here you can also set
+| up global helper functions that are available in every test file.
+|
+*/

package/modules/test/tests/SmokeTest.php

@@ -0,0 +1,15 @@
+<?php
+
+// phpcs:disable
+
+use GuzzleHttp\Client;
+
+it('returns a 200 status code on the homepage', function () {
+    $client = new Client([
+        'verify' => in_array(env('WP_ENV'), ['production', 'staging']),
+    ]);
+
+    $response = $client->request('GET', env('WP_HOME'));
+
+    expect($response->getStatusCode())->toBe(200);
+});

package/modules/test/tests/e2e/example.spec.js

@@ -0,0 +1,11 @@
+import { test, expect } from '@playwright/test';
+
+test('homepage returns 200', async ({ page }) => {
+  const response = await page.goto('/');
+  expect(response?.status()).toBe(200);
+});
+
+test('homepage has a title', async ({ page }) => {
+  await page.goto('/');
+  await expect(page).toHaveTitle(/.+/);
+});

package/modules/test/tests/e2e/helpers/loginHelper.js

@@ -0,0 +1,40 @@
+/**
+ * Helper: authenticate an admin user in the WordPress admin panel.
+ *
+ * @param {import('@playwright/test').Page} page
+ * @param {string} [user='admin']
+ * @param {string} [pass='admin']
+ */
+export async function login(page, user = 'admin', pass = 'admin') {
+  await page.goto('/wp/wp-login.php');
+  await page.fill('#user_login', user);
+  await page.fill('#user_pass', pass);
+  await page.click('#wp-submit');
+  await page.waitForURL(/wp-admin/);
+}
+
+/**
+ * Helper: dismiss any WordPress welcome modal that may appear.
+ *
+ * @param {import('@playwright/test').Page} page
+ */
+export async function dismissWelcomeModal(page) {
+  try {
+    await page.waitForSelector('.components-modal__screen-overlay', { timeout: 3000 });
+    const closeButton = page.locator(
+      '.components-modal__header button.components-button[aria-label="Close"]'
+    );
+    if (await closeButton.isVisible()) {
+      await closeButton.click();
+      await page.waitForSelector('.components-modal__screen-overlay', {
+        state: 'detached',
+        timeout: 2000,
+      });
+    } else {
+      await page.keyboard.press('Escape');
+      await page.waitForTimeout(500);
+    }
+  } catch {
+    // Modal not present or already dismissed — continue.
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codigodoleo/wp-kit",
-  "version": "3.1.1",
+  "version": "3.3.0",
   "description": "Kit opinativo para padronizar projetos WordPress com CI/CD dinâmico.",
   "main": "bin/index.js",
   "bin": {

package/templates/.devcontainer/Dockerfile.hbs

@@ -0,0 +1,24 @@
+FROM thecodingmachine/php:8.4-v5-fpm-node24
+
+# Enable PHP extensions needed for WordPress
+# (mysqli, mysqlnd, redis, zip already enabled by default in the fat image)
+ENV PHP_EXTENSION_BCMATH=1 \
+    PHP_EXTENSION_GD=1 \
+    PHP_EXTENSION_PDO_MYSQL=1
+
+# The base image ends with USER docker — switch to root for installations
+USER root
+
+# Install only what is NOT bundled in the base image.
+# Already pre-installed: PHP 8.4, Node 24, npm, yarn (corepack),
+#   Composer, mysqli, mysqlnd, redis, zip, curl, git, unzip
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends default-mysql-client redis-tools \
+  && rm -rf /var/lib/apt/lists/*
+
+# WP-CLI (not included in the base image)
+RUN curl -fsSL -o /usr/local/bin/wp https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar \
+  && chmod +x /usr/local/bin/wp \
+  && wp --info
+
+USER docker

package/templates/.devcontainer/config/nginx.conf

@@ -0,0 +1,23 @@
+server {
+    listen 80;
+    root /workspace/wp;
+    index index.php;
+
+    client_max_body_size 64M;
+
+    location / {
+        try_files $uri $uri/ /index.php$is_args$args;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass app:9000;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        include fastcgi_params;
+        fastcgi_read_timeout 120;
+    }
+
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires max;
+        log_not_found off;
+    }
+}

package/templates/.devcontainer/config/nginx.conf.hbs

@@ -0,0 +1,23 @@
+server {
+    listen 80;
+    root /workspace/wp;
+    index index.php;
+
+    client_max_body_size 64M;
+
+    location / {
+        try_files $uri $uri/ /index.php$is_args$args;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass app:9000;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        include fastcgi_params;
+        fastcgi_read_timeout 120;
+    }
+
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires max;
+        log_not_found off;
+    }
+}

package/templates/.devcontainer/devcontainer.json.hbs

@@ -0,0 +1,29 @@
+{
+  "name": "{{projectName}} Devcontainer",
+  "dockerComposeFile": [
+    "docker-compose.yml"
+  ],
+  "service": "app",
+  "workspaceFolder": "/workspace",
+  "postCreateCommand": "bash .devcontainer/setup.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "bmewburn.vscode-intelephense-client",
+        "esbenp.prettier-vscode",
+        "dbaeumer.vscode-eslint",
+        "ms-azuretools.vscode-docker"
+      ],
+      "settings": {
+        "editor.formatOnSave": false,
+        "terminal.integrated.defaultProfile.linux": "bash"
+      }
+    }
+  },
+  "forwardPorts": [
+    8080,
+    3307,
+    6380,
+    5173
+  ]
+}

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

@@ -0,0 +1,73 @@
+services:
+  app:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    container_name: {{projectName}}-app
+    working_dir: /workspace
+    env_file:
+      - ../.env
+    volumes:
+      - ..:/workspace:cached
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: wordpress
+      WORDPRESS_DB_PASSWORD: wordpress
+      WORDPRESS_DB_NAME: wordpress
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    networks:
+      - wp
+
+  web:
+    image: nginx:alpine
+    container_name: {{projectName}}-web
+    ports:
+      - "8080:80"
+      - "5173:5173"
+    volumes:
+      - ..:/workspace:ro
+      - ./.devcontainer/config/nginx.conf:/etc/nginx/conf.d/default.conf:ro
+    depends_on:
+      - app
+    networks:
+      - wp
+
+  db:
+    image: mariadb:11
+    container_name: {{projectName}}-db
+    restart: unless-stopped
+    environment:
+      MYSQL_DATABASE: wordpress
+      MYSQL_USER: wordpress
+      MYSQL_PASSWORD: wordpress
+      MYSQL_ROOT_PASSWORD: root
+    ports:
+      - "3307:3306"
+    volumes:
+      - db-data:/var/lib/mysql
+    networks:
+      - wp
+    healthcheck:
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      timeout: 20s
+      retries: 10
+
+  redis:
+    image: redis:7-alpine
+    container_name: {{projectName}}-redis
+    restart: unless-stopped
+    ports:
+      - "6380:6379"
+    networks:
+      - wp
+
+networks:
+  wp:
+    driver: bridge
+
+volumes:
+  db-data:

package/templates/.devcontainer/setup.sh.hbs

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# Devcontainer post-create setup — runs once after the container is created.
+# Delegates to unified scripts so Lando, CI/CD and devcontainer share the same logic.
+set -euo pipefail
+
+git config --global --add safe.directory /workspace || true
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.."; pwd)"
+
+bash "${PROJECT_ROOT}/server/cmd/setup-php.sh"
+bash "${PROJECT_ROOT}/server/cmd/setup-node.sh"
+
+if command -v wp >/dev/null 2>&1; then
+  bash "${PROJECT_ROOT}/server/cmd/install-wp.sh"
+fi
+
+echo "Devcontainer setup completed."

package/templates/.env.hbs

@@ -1,27 +1,50 @@
-PROJECT_NAME="{{projectName}}" PROJECT_VERSION="{{projectVersion}}" PROJECT_DOMAIN="{{projectDomain}}"
-APP_URL="https://{{projectDomain}}" AUTHOR="{{author}}" PHP_VERSION="{{phpVersion}}" NODE_VERSION="{{nodeVersion}}"
-WP_CORE_VERSION="{{wpCoreVersion}}"{{#if enable_sage}}
-  SAGE_VERSION="{{sageVersion}}"{{/if}}
-GIT_REPOSITORY="{{gitRepository}}" WORDPRESS_SITE_URL="https://{{projectDomain}}"
-WORDPRESS_DB_NAME="wordpress" WORDPRESS_DB_USER="wordpress" WORDPRESS_DB_PASSWORD="wordpress"
-WORDPRESS_DB_HOST="database" WORDPRESS_DB_CHARSET="utf8" WORDPRESS_DB_COLLATE=""
-WORDPRESS_TABLE_PREFIX="wp_" WORDPRESS_DEBUG={{enableDebug}}
+PROJECT_NAME="{{projectName}}"
+PROJECT_VERSION="{{projectVersion}}"
+PROJECT_DOMAIN="{{projectDomain}}"
+APP_URL="https://{{projectDomain}}"
+AUTHOR="{{author}}"
+PHP_VERSION="{{phpVersion}}"
+NODE_VERSION="{{nodeVersion}}"
+WP_CORE_VERSION="{{wpCoreVersion}}"
+{{#if enable_sage}}
+SAGE_VERSION="{{sageVersion}}"
+{{/if}}
+GIT_REPOSITORY="{{gitRepository}}"
+
+WORDPRESS_SITE_URL="https://{{projectDomain}}"
+WORDPRESS_DB_NAME="wordpress"
+WORDPRESS_DB_USER="wordpress"
+WORDPRESS_DB_PASSWORD="wordpress"
+WORDPRESS_DB_HOST="database"
+WORDPRESS_DB_CHARSET="utf8"
+WORDPRESS_DB_COLLATE=""
+WORDPRESS_TABLE_PREFIX="wp_"
+WORDPRESS_DEBUG={{enableDebug}}
 WORDPRESS_DEBUG_DISPLAY={{enableDebug}}
 WORDPRESS_DEBUG_LOG={{enableDebug}}
 WORDPRESS_SCRIPT_DEBUG={{enableDebug}}
-WORDPRESS_DISABLE_UPDATE=true WORDPRESS_DISABLE_CRON=true WORDPRESS_AUTOSAVE_INTERVAL="600"
-WORDPRESS_POST_REVISIONS="2" WORDPRESS_WP_ENVIRONMENT_TYPE="local" WORDPRESS_DISALLOW_FILE_MODS=true
-WORDPRESS_FORCE_SSL_ADMIN=true WORDPRESS_AUTOMATIC_UPDATER_DISABLED=true
-WORDPRESS_WP_AUTO_UPDATE_CORE=false ### Redis ###
+WORDPRESS_DISABLE_UPDATE=true
+WORDPRESS_DISABLE_CRON=true
+WORDPRESS_AUTOSAVE_INTERVAL="600"
+WORDPRESS_POST_REVISIONS="2"
+WORDPRESS_WP_ENVIRONMENT_TYPE="local"
+WORDPRESS_DISALLOW_FILE_MODS=true
+WORDPRESS_FORCE_SSL_ADMIN=true
+WORDPRESS_AUTOMATIC_UPDATER_DISABLED=true
+WORDPRESS_WP_AUTO_UPDATE_CORE=false
+
+### Redis ###
 {{#if enable_redis}}
-  WORDPRESS_REDIS_HOST=redis WORDPRESS_REDIS_PORT=6379
+WORDPRESS_REDIS_HOST=redis
+WORDPRESS_REDIS_PORT=6379
 {{/if}}
 
-### WordPress salts ### WORDPRESS_AUTH_KEY={{{salts.AUTH_KEY}}}
+### WordPress salts ###
+WORDPRESS_AUTH_KEY={{{salts.AUTH_KEY}}}
 WORDPRESS_SECURE_AUTH_KEY={{{salts.SECURE_AUTH_KEY}}}
 WORDPRESS_LOGGED_IN_KEY={{{salts.LOGGED_IN_KEY}}}
 WORDPRESS_NONCE_KEY={{{salts.NONCE_KEY}}}
 WORDPRESS_AUTH_SALT={{{salts.AUTH_SALT}}}
 WORDPRESS_SECURE_AUTH_SALT={{{salts.SECURE_AUTH_SALT}}}
 WORDPRESS_LOGGED_IN_SALT={{{salts.LOGGED_IN_SALT}}}
-WORDPRESS_NONCE_SALT={{{salts.NONCE_SALT}}}
+WORDPRESS_NONCE_SALT={{{salts.NONCE_SALT}}}