@stratawp/cli 0.2.2 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2024 Jon Imms
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+---
+
+For the full GPL-3.0 license text, see: https://www.gnu.org/licenses/gpl-3.0.txt

package/dist/create.js

@@ -7,6 +7,7 @@ import ora from "ora";
 import { execa } from "execa";
 import fs from "fs-extra";
 import path from "path";
+import os from "os";
 import validatePackageName from "validate-npm-package-name";
 async function main() {
   console.log(chalk.bold.cyan("\n\u26A1 Create StrataWP Theme\n"));
@@ -41,6 +42,34 @@ async function main() {
       name: "author",
       message: "Author name:"
     },
+    {
+      type: "select",
+      name: "template",
+      message: "Choose a starting template:",
+      choices: [
+        {
+          title: "Basic Theme (Recommended)",
+          description: "Simple starter with essential blocks and clean structure",
+          value: "basic"
+        },
+        {
+          title: "Advanced Theme",
+          description: "Portfolio features, team members, advanced blocks",
+          value: "advanced"
+        },
+        {
+          title: "Store Theme",
+          description: "WooCommerce ready with product features",
+          value: "store"
+        },
+        {
+          title: "Minimal",
+          description: "Start from scratch with minimal setup",
+          value: "minimal"
+        }
+      ],
+      initial: 0
+    },
     {
       type: "select",
       name: "cssFramework",
@@ -87,12 +116,30 @@ async function createTheme(config) {
       spinner.fail(`Directory ${config.slug} already exists`);
       process.exit(1);
     }
-    await fs.ensureDir(themePath);
-    spinner.text = "Copying template files...";
-    await createBasicStructure(themePath, config);
+    if (config.template === "minimal") {
+      await fs.ensureDir(themePath);
+      spinner.text = "Creating basic structure...";
+      await createBasicStructure(themePath, config);
+    } else {
+      spinner.text = `Downloading ${config.template} theme template...`;
+      const degit = (await import("degit")).default;
+      const templateMap = {
+        basic: "JonImmsWordpressDev/StrataWP/examples/basic-theme",
+        advanced: "JonImmsWordpressDev/StrataWP/examples/advanced-theme",
+        store: "JonImmsWordpressDev/StrataWP/examples/store-theme"
+      };
+      const emitter = degit(templateMap[config.template], {
+        cache: false,
+        force: true
+      });
+      await emitter.clone(themePath);
+      spinner.text = "Customizing theme...";
+      await customizeTheme(themePath, config);
+    }
     spinner.text = "Installing dependencies...";
     await execa("pnpm", ["install"], { cwd: themePath });
     spinner.succeed(chalk.green("Theme created successfully!"));
+    await offerWordPressLinking(themePath, config.slug);
     console.log(chalk.cyan("\n\u{1F4E6} Next steps:\n"));
     console.log(`  cd ${config.slug}`);
     console.log("  pnpm dev");
@@ -103,6 +150,127 @@ async function createTheme(config) {
     process.exit(1);
   }
 }
+async function customizeTheme(themePath, config) {
+  const styleCssPath = path.join(themePath, "style.css");
+  if (await fs.pathExists(styleCssPath)) {
+    let styleContent = await fs.readFile(styleCssPath, "utf-8");
+    styleContent = styleContent.replace(/Theme Name:.*$/m, `Theme Name: ${config.name}`).replace(/Description:.*$/m, `Description: ${config.description}`).replace(/Author:.*$/m, `Author: ${config.author}`).replace(/Text Domain:.*$/m, `Text Domain: ${config.slug}`);
+    await fs.writeFile(styleCssPath, styleContent);
+  }
+  const packageJsonPath = path.join(themePath, "package.json");
+  if (await fs.pathExists(packageJsonPath)) {
+    const packageJson = await fs.readJson(packageJsonPath);
+    packageJson.name = config.slug;
+    packageJson.description = config.description;
+    packageJson.author = config.author;
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+  }
+  const readmePath = path.join(themePath, "README.md");
+  if (await fs.pathExists(readmePath)) {
+    let readmeContent = await fs.readFile(readmePath, "utf-8");
+    readmeContent = readmeContent.replace(/^#\s+.*$/m, `# ${config.name}`);
+    await fs.writeFile(readmePath, readmeContent);
+  }
+  const viteConfigPath = path.join(themePath, "vite.config.ts");
+  if (await fs.pathExists(viteConfigPath)) {
+    let viteConfig = await fs.readFile(viteConfigPath, "utf-8");
+    viteConfig = viteConfig.replace(/namespace:\s*['"][\w-]+['"]/, `namespace: '${config.slug}'`);
+    await fs.writeFile(viteConfigPath, viteConfig);
+  }
+}
+async function offerWordPressLinking(themePath, slug) {
+  console.log();
+  const { shouldLink } = await prompts({
+    type: "confirm",
+    name: "shouldLink",
+    message: "Would you like to link this theme to a WordPress installation?",
+    initial: true
+  });
+  if (!shouldLink) {
+    return;
+  }
+  const wordpressSites = await detectWordPressSites();
+  if (wordpressSites.length === 0) {
+    console.log(chalk.yellow("\n\u26A0\uFE0F  No WordPress installations detected automatically."));
+    console.log(chalk.dim("You can manually create a symlink later:\n"));
+    console.log(chalk.dim(`  ln -s "${themePath}" /path/to/wordpress/wp-content/themes/${slug}
+`));
+    return;
+  }
+  const { selectedSite } = await prompts({
+    type: "select",
+    name: "selectedSite",
+    message: "Select WordPress installation:",
+    choices: wordpressSites.map((site) => ({
+      title: `${site.name} (${site.type})`,
+      description: site.path,
+      value: site
+    }))
+  });
+  if (!selectedSite) {
+    return;
+  }
+  try {
+    const targetPath = path.join(selectedSite.path, "wp-content", "themes", slug);
+    if (await fs.pathExists(targetPath)) {
+      console.log(chalk.yellow(`
+\u26A0\uFE0F  Theme already exists at ${targetPath}`));
+      return;
+    }
+    await fs.ensureSymlink(themePath, targetPath);
+    console.log(chalk.green(`
+\u2713 Linked theme to ${selectedSite.name}`));
+    console.log(chalk.dim(`  ${targetPath}`));
+  } catch (error) {
+    console.log(chalk.red("\n\u2716 Failed to create symlink"));
+    console.log(chalk.dim("You can manually create it:\n"));
+    console.log(chalk.dim(`  ln -s "${themePath}" ${path.join(selectedSite.path, "wp-content", "themes", slug)}
+`));
+  }
+}
+async function detectWordPressSites() {
+  const sites = [];
+  const homeDir = os.homedir();
+  const localSitesPath = path.join(homeDir, "Local Sites");
+  if (await fs.pathExists(localSitesPath)) {
+    try {
+      const localDirs = await fs.readdir(localSitesPath);
+      for (const dir of localDirs) {
+        const sitePath = path.join(localSitesPath, dir, "app", "public");
+        const wpConfigPath = path.join(sitePath, "wp-config.php");
+        if (await fs.pathExists(wpConfigPath)) {
+          sites.push({
+            name: dir,
+            path: sitePath,
+            type: "Local by Flywheel"
+          });
+        }
+      }
+    } catch (error) {
+    }
+  }
+  if (process.platform === "darwin") {
+    const mampPath = "/Applications/MAMP/htdocs";
+    if (await fs.pathExists(mampPath)) {
+      try {
+        const mampDirs = await fs.readdir(mampPath);
+        for (const dir of mampDirs) {
+          const sitePath = path.join(mampPath, dir);
+          const wpConfigPath = path.join(sitePath, "wp-config.php");
+          if (await fs.pathExists(wpConfigPath)) {
+            sites.push({
+              name: dir,
+              path: sitePath,
+              type: "MAMP"
+            });
+          }
+        }
+      } catch (error) {
+      }
+    }
+  }
+  return sites;
+}
 async function createBasicStructure(themePath, config) {
   const packageJson = {
     name: config.slug,

package/dist/index.js

@@ -2,7 +2,6 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk10 from "chalk";
 
 // src/commands/dev.ts
 import chalk from "chalk";
@@ -957,6 +956,20 @@ async function createCSSEntry(framework, cwd) {
 }
 
 // src/index.ts
+import {
+  setupCommand,
+  generateCommand,
+  reviewCommand,
+  documentCommand
+} from "@stratawp/ai";
+import {
+  searchCommand,
+  installCommand,
+  infoCommand,
+  publishCommand,
+  listCommand
+} from "@stratawp/registry";
+import { startCommand as explorerStartCommand } from "@stratawp/explorer";
 var program = new Command();
 program.name("stratawp").description("\u26A1 A modern WordPress theme framework").version("0.2.2");
 program.command("dev").description("Start development server with hot reload").option("-p, --port <port>", "Port number", "3000").option("-h, --host <host>", "Host address", "localhost").action(devCommand);
@@ -967,17 +980,40 @@ program.command("template:new <name>").description("Create a new WordPress templ
 program.command("part:new <name>").description("Create a new template part").option("-t, --type <type>", "Part type (header|footer|sidebar|content|custom)", "custom").option("--markup <markup>", "Markup style (html|php)", "php").action(partCommand);
 program.command("design-system:setup <framework>").description("Set up a design system (tailwind|unocss)").action(designSystemCommand);
 program.command("test").description("Run tests").option("--unit", "Run unit tests only").option("--e2e", "Run E2E tests only").option("--watch", "Watch mode").action(testCommand);
-program.command("storybook").description("Launch component explorer").action(() => {
-  console.log(chalk10.cyan("\u{1F3AD} Launching component explorer..."));
-  console.log(chalk10.dim("Coming soon!"));
+program.command("explorer").description("Launch interactive component explorer").option("-p, --port <port>", "Port number", "3000").option("-h, --host <host>", "Host address", "localhost").option("--no-open", "Do not open browser automatically").action((options) => {
+  explorerStartCommand({
+    port: options.port ? parseInt(options.port, 10) : 3e3,
+    host: options.host,
+    open: options.open !== false
+  });
 });
-program.command("ai:block <description>").description("Generate block from description using AI").action((description) => {
-  console.log(chalk10.magenta("\u{1F916} AI Block Generator"));
-  console.log(chalk10.dim(`Description: ${description}`));
-  console.log(chalk10.yellow("\u26A0\uFE0F  Coming soon!"));
+program.command("storybook").description("Alias for explorer command").option("-p, --port <port>", "Port number", "3000").option("-h, --host <host>", "Host address", "localhost").option("--no-open", "Do not open browser automatically").action((options) => {
+  explorerStartCommand({
+    port: options.port ? parseInt(options.port, 10) : 3e3,
+    host: options.host,
+    open: options.open !== false
+  });
 });
-program.command("ai:optimize").description("AI-powered performance optimization").action(() => {
-  console.log(chalk10.magenta("\u{1F916} AI Optimizer"));
-  console.log(chalk10.yellow("\u26A0\uFE0F  Coming soon!"));
+program.command("ai:setup").description("Configure AI providers and API keys").action(setupCommand);
+program.command("ai:generate <type>").description("Generate code with AI (block|component|pattern)").option("-o, --output <path>", "Output file path").action((type, options) => {
+  generateCommand({ type, ...options });
 });
+program.command("ai:review <file>").description("Review code for best practices and security").option("-f, --focus <focus>", "Focus area (security|performance|best-practices|all)", "all").action((file, options) => {
+  reviewCommand({ file, ...options });
+});
+program.command("ai:document <file>").description("Generate documentation for code").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Documentation format (markdown|phpdoc|jsdoc)").action((file, options) => {
+  documentCommand({ file, ...options });
+});
+program.command("registry:search <query>").description("Search for components in the registry").option("-t, --type <type>", "Filter by component type (block|component|pattern|template)").option("-l, --limit <number>", "Maximum number of results", "20").action((query, options) => {
+  searchCommand(query, {
+    type: options.type,
+    limit: parseInt(options.limit, 10)
+  });
+});
+program.command("registry:install <component>").description("Install a component from the registry").option("-v, --version <version>", "Specific version to install").option("-f, --force", "Overwrite if component already exists").option("-d, --dev", "Install as dev dependency").option("--target-dir <dir>", "Custom target directory").action((component, options) => {
+  installCommand(component, options);
+});
+program.command("registry:info <component>").description("Get detailed information about a component").action(infoCommand);
+program.command("registry:publish").description("Publish current component to the registry").option("--tag <tag>", "Publish with a specific tag").option("--access <access>", "Public or restricted access", "public").option("--dry-run", "Test publication without actually publishing").action(publishCommand);
+program.command("registry:list").description("List installed StrataWP components").action(listCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratawp/cli",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "CLI tool for StrataWP - create and manage WordPress themes",
   "author": "Jon Imms",
   "license": "GPL-3.0-or-later",
@@ -39,13 +39,6 @@
     "dist",
     "templates"
   ],
-  "scripts": {
-    "dev": "tsup --watch",
-    "build": "tsup",
-    "test": "vitest",
-    "lint": "eslint src",
-    "clean": "rm -rf dist"
-  },
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
@@ -54,7 +47,10 @@
     "fs-extra": "^11.2.0",
     "ora": "^8.0.1",
     "prompts": "^2.4.2",
-    "validate-npm-package-name": "^5.0.0"
+    "validate-npm-package-name": "^5.0.0",
+    "@stratawp/registry": "0.1.0",
+    "@stratawp/ai": "0.1.0",
+    "@stratawp/explorer": "0.7.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
@@ -63,5 +59,12 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.0.4"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
   }
-}
+}