@codigodoleo/wp-kit 1.0.0

package/modules/lint/index.js

@@ -0,0 +1,15 @@
+export async function setupModule(context, generator) {
+  await generator.copyFile('.eslintrc.json', 'lint');
+  await generator.copyFile('.prettierrc.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');
+  }
+
+}

package/modules/lint/pint.json

@@ -0,0 +1,26 @@
+{
+  "preset": "psr12",
+  "rules": {
+    "array_syntax": {
+      "syntax": "short"
+    },
+    "binary_operator_spaces": {
+      "default": "single_space"
+    }
+  },
+  "exclude": [
+    "wp",
+    "content",
+    "vendor",
+    "node_modules",
+    ".git",
+    "storage",
+    "bootstrap/cache",
+    "public/build",
+    "public/hot",
+    "public/storage",
+    "public/vendor",
+    "tests/coverage",
+    "tests/reports"
+  ]
+}

package/modules/lint/prompts.js

@@ -0,0 +1,16 @@
+// modules/lint/prompts.js
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_lint',
+    message: 'Enable linting and formatting tools (ESLint + Prettier)?',
+    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

@@ -0,0 +1,10 @@
+tooling:
+  eslint:
+    service: appserver
+    cmd: yarn eslint
+  prettier:
+    service: appserver
+    cmd: yarn prettier
+  stylelint:
+    service: appserver
+    cmd: yarn stylelint **/*.{css,scss,vue}

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

@@ -0,0 +1,16 @@
+{
+  "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"
+  }
+}

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

@@ -0,0 +1,56 @@
+{
+  "settings": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": false,
+    "editor.codeActionsOnSave": {
+      "source.fixAll": true,
+      "source.fixAll.eslint": true,
+      "source.organizeImports": true
+    },
+    "prettier.requireConfig": true,
+    "prettier.useEditorConfig": true,
+    "[blade]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": false,
+      "editor.insertSpaces": true,
+      "editor.tabSize": 2
+    },
+    "[javascript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": false,
+      "editor.insertSpaces": true,
+      "editor.tabSize": 2
+    },
+    "[typescript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": false,
+      "editor.insertSpaces": true,
+      "editor.tabSize": 2
+    },
+    "[css]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": false,
+      "editor.insertSpaces": true,
+      "editor.tabSize": 2
+    },
+    "[scss]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": false,
+      "editor.insertSpaces": true,
+      "editor.tabSize": 2
+    },
+    "files.eol": "\n",
+    "files.trimTrailingWhitespace": true,
+    "files.insertFinalNewline": true
+  },
+  "extensions": {
+    "recommendations": [
+      "esbenp.prettier-vscode",
+      "dbaeumer.vscode-eslint",
+      "editorconfig.editorconfig",
+      "stylelint.vscode-stylelint",
+      "bmewburn.vscode-intelephense-client",
+      "bradlc.vscode-tailwindcss"
+    ]
+  }
+}

package/modules/php/index.js

@@ -0,0 +1,3 @@
+export async function setupModule(context, generator) {
+  await generator.copyDirectory('scripts', 'php');
+}

package/modules/php/prompts.js

@@ -0,0 +1,8 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_php',
+    message: 'Enable PHP IDE support and quality tools?',
+    default: true
+  }
+];

package/modules/php/scripts/php-wrapper.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+
+# PHP Wrapper Script for Lando/Local Environment Detection
+# This script automatically detects whether to use Lando or local PHP
+
+# Function to check if Lando is available and project is running
+check_lando() {
+    if command -v lando &> /dev/null && [ -f .lando.yml ]; then
+        # Check if Lando project is running
+        if lando info &> /dev/null 2>&1; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Function to check if local PHP is available
+check_local_php() {
+    if command -v php &> /dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+# Main execution logic
+if check_lando; then
+    # Use Lando PHP
+    exec lando php "$@"
+elif check_local_php; then
+    # Use local PHP as fallback
+    exec php "$@"
+else
+    echo "Error: No PHP executable found (neither Lando nor local)" >&2
+    echo "Please ensure either:" >&2
+    echo "  1. Lando is running: lando start" >&2
+    echo "  2. PHP is installed locally" >&2
+    exit 1
+fi

package/modules/php/scripts/pint-wrapper.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+
+# Pint Wrapper Script for Lando/Local Environment Detection
+# This script automatically detects whether to use Lando or local Pint
+
+# Function to check if Lando is available and project is running
+check_lando() {
+    if command -v lando &> /dev/null && [ -f .lando.yml ]; then
+        # Check if Lando project is running
+        if lando info &> /dev/null 2>&1; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Function to check if local Pint is available
+check_local_pint() {
+    if [ -f ./vendor/bin/pint ]; then
+        return 0
+    elif command -v pint &> /dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+# Main execution logic
+if check_lando; then
+    # Use Lando Pint
+    exec lando pint "$@"
+elif [ -f ./vendor/bin/pint ]; then
+    # Use project-local Pint
+    exec ./vendor/bin/pint "$@"
+elif command -v pint &> /dev/null; then
+    # Use globally installed Pint
+    exec pint "$@"
+else
+    echo "Error: Pint not found" >&2
+    echo "Please ensure either:" >&2
+    echo "  1. Lando is running: lando start" >&2
+    echo "  2. Pint is installed via Composer in project or theme" >&2
+    echo "  3. Pint is installed globally" >&2
+    exit 1
+fi

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

@@ -0,0 +1,11 @@
+tooling:
+  pint:
+    service: appserver
+    description: PHP Code Style (modern PSR-12)
+    cmd:
+      - pint
+  pint-check:
+    service: appserver
+    description: Check code style without fixing
+    cmd:
+      - pint --test

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

@@ -0,0 +1,6 @@
+{
+  "require-dev": {
+    "laravel/pint": "^1.23",
+    "phpunit/phpunit": "^9.5"
+  }
+}

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

@@ -0,0 +1,74 @@
+{
+  "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

@@ -0,0 +1,8 @@
+export default [
+  {
+    type: 'confirm',
+    name: 'enable_redis',
+    message: 'Enable Redis support?',
+    default: true
+  }
+];

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

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

package/modules/sage/index.js

@@ -0,0 +1,20 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { log, color } from '../../lib/utils/logger.js';
+import { execSync } from 'child_process';
+
+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);
+
+  const cmd = `composer create-project roots/sage ${themeDir} ${context.sageVersion === '11' ? 'v11.0.1' : 'v10.8.2'} --no-interaction --ignore-platform-reqs`;
+
+  log(color.blue, `[sage] Installing Sage theme at: ${themeDir}`);
+  execSync(cmd, { stdio: 'inherit' });
+
+  await generator.generateFile('theme/vite.config.js', context, 'sage', `${relativeThemeDir}/vite.config.js`);
+  await generator.generateFile('theme/style.css', context, 'sage', `${relativeThemeDir}/style.css`);
+
+}

package/modules/sage/prompts.js

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

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

@@ -0,0 +1,64 @@
+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

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

@@ -0,0 +1,18 @@
+{
+  "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

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

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

@@ -0,0 +1,13 @@
+/*
+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

@@ -0,0 +1,53 @@
+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

@@ -0,0 +1,67 @@
+{
+  "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/assets/module-file.txt

@@ -0,0 +1 @@
+Arquivo específico do módulo test-directory.

package/modules/test-directory/index.js

@@ -0,0 +1,19 @@
+import { log, color } from '../../lib/utils/logger.js';
+
+export async function setupModule(context, generator) {
+  log(color.blue, '[test-directory] Testing copyDirectory functionality...');
+
+  // Exemplo 1: Copiar pasta simples (sobrescrevendo por padrão)
+  await generator.copyDirectory('test-assets', 'test-directory');
+
+  // Exemplo 2: Copiar pasta com nome personalizado
+  await generator.copyDirectory('test-assets', 'test-directory', 'custom-assets');
+
+  // Exemplo 3: Copiar pasta sem sobrescrever
+  await generator.copyDirectory('test-assets', 'test-directory', 'protected-assets', false);
+
+  // Exemplo 4: Copiar pasta de um módulo específico
+  await generator.copyDirectory('assets', 'test-directory', 'module-assets');
+
+  log(color.green, '[test-directory] ✅ Directory copy tests completed');
+}

package/modules/test-directory/prompts.js

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

package/modules/test-directory/test-assets/file1.txt

@@ -0,0 +1 @@
+Este é um arquivo de teste para demonstrar a funcionalidade copyDirectory.

package/modules/test-directory/test-assets/file2.txt

@@ -0,0 +1 @@
+Segundo arquivo de teste para demonstrar a funcionalidade copyDirectory.