@the-grove/cli 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @the-grove/cli
+
+CLI tool for the-grove component library.
+
+## Usage
+
+### Add components
+```bash
+npx the-grove add async-button
+```
+
+### List components
+```bash
+npx the-grove list
+```
+
+### Contribute components
+```bash
+npx the-grove contribute ./components/my-component.tsx
+```
+
+## Commands
+
+### add
+
+Add components to your project.
+
+```bash
+npx the-grove add <component-name> [options]
+
+Options:
+  -p, --path <path>  Custom installation path
+  -y, --yes          Skip confirmation prompts
+```
+
+### list
+
+List all available components.
+
+```bash
+npx the-grove list [options]
+
+Options:
+  -c, --category <category>  Filter by category
+  -t, --tag <tag>           Filter by tag
+```
+
+### contribute
+
+Contribute components back to the-grove.
+
+```bash
+npx the-grove contribute <file...>
+```
+
+Requires GITHUB_TOKEN environment variable or will prompt for token.
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Test locally
+npm link
+the-grove --help
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/add.ts
+import { execa } from "execa";
+import ora from "ora";
+import chalk from "chalk";
+import prompts from "prompts";
+import fs from "fs-extra";
+var REGISTRY_BASE_URL = "https://raw.githubusercontent.com/matthewnaples/the-grove/main/packages/registry/registry";
+async function add(components, options) {
+  if (!components || components.length === 0) {
+    console.log(chalk.yellow("No components specified."));
+    console.log("Usage: npx the-grove add <component-name>");
+    console.log("\nRun `npx the-grove list` to see available components.");
+    return;
+  }
+  const spinner = ora();
+  try {
+    const stack = await detectProjectStack();
+    for (const componentName of components) {
+      spinner.start(`Adding ${componentName}...`);
+      const registryUrl = await findComponentRegistry(componentName);
+      if (!registryUrl) {
+        spinner.fail(`Component '${componentName}' not found`);
+        continue;
+      }
+      const registryEntry = await fetchRegistryEntry(registryUrl);
+      const missingDeps = await checkDependencies(registryEntry, stack);
+      if (missingDeps.length > 0 && !options.yes) {
+        spinner.stop();
+        const { continue: shouldContinue } = await prompts({
+          type: "confirm",
+          name: "continue",
+          message: `${componentName} requires: ${missingDeps.join(", ")}. Continue?`,
+          initial: true
+        });
+        if (!shouldContinue) {
+          console.log(chalk.gray(`Skipped ${componentName}`));
+          continue;
+        }
+        spinner.start(`Adding ${componentName}...`);
+      }
+      const shadcnUrl = registryUrl;
+      const args = ["shadcn@latest", "add", shadcnUrl];
+      if (options.path) {
+        args.push("--path", options.path);
+      }
+      if (options.yes) {
+        args.push("--yes");
+      }
+      await execa("npx", args, { stdio: "inherit" });
+      spinner.succeed(`Added ${componentName}`);
+    }
+    console.log(chalk.green("\n\u2705 All components added successfully!"));
+  } catch (error) {
+    spinner.fail("Failed to add component");
+    console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+async function detectProjectStack() {
+  try {
+    const packageJson = await fs.readJson("./package.json");
+    const deps = {
+      ...packageJson.dependencies,
+      ...packageJson.devDependencies
+    };
+    return {
+      hasConvex: "convex" in deps,
+      hasClerk: "@clerk/nextjs" in deps || "@clerk/clerk-react" in deps,
+      hasNextAuth: "next-auth" in deps
+    };
+  } catch {
+    return {
+      hasConvex: false,
+      hasClerk: false,
+      hasNextAuth: false
+    };
+  }
+}
+async function findComponentRegistry(componentName) {
+  const categories = ["core", "convex", "clerk", "convex-clerk"];
+  for (const category of categories) {
+    const url = `${REGISTRY_BASE_URL}/${category}/${componentName}.json`;
+    try {
+      const response = await fetch(url);
+      if (response.ok) {
+        return url;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+async function fetchRegistryEntry(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch registry: ${url}`);
+  }
+  return response.json();
+}
+async function checkDependencies(registryEntry, stack) {
+  const missing = [];
+  const deps = registryEntry.dependencies || [];
+  for (const dep of deps) {
+    if (dep === "convex" && !stack.hasConvex) {
+      missing.push("convex");
+    }
+    if ((dep === "@clerk/nextjs" || dep === "@clerk/clerk-react") && !stack.hasClerk) {
+      missing.push("clerk");
+    }
+  }
+  return missing;
+}
+
+// src/commands/contribute.ts
+import { Octokit } from "@octokit/rest";
+import fs2 from "fs-extra";
+import path from "path";
+import prompts2 from "prompts";
+import ora2 from "ora";
+import chalk2 from "chalk";
+var TEMPLATE_REPO = {
+  owner: "matthewnaples",
+  repo: "the-grove",
+  branch: "main"
+};
+async function contribute(filePaths) {
+  const spinner = ora2();
+  try {
+    const files = [];
+    for (const fp of filePaths) {
+      if (!await fs2.pathExists(fp)) {
+        throw new Error(`File not found: ${fp}`);
+      }
+      files.push({
+        localPath: fp,
+        content: await fs2.readFile(fp, "utf-8"),
+        componentName: path.basename(fp, path.extname(fp))
+      });
+    }
+    const answers = await prompts2([
+      {
+        type: "select",
+        name: "changeType",
+        message: "What kind of change is this?",
+        choices: [
+          { title: "New component", value: "feat" },
+          { title: "Bug fix", value: "fix" },
+          { title: "Enhancement", value: "enhance" }
+        ]
+      },
+      {
+        type: "text",
+        name: "description",
+        message: "Describe your changes:",
+        initial: files.length === 1 ? `Update ${files[0].componentName}` : `Update ${files.length} components`
+      }
+    ]);
+    if (!answers.changeType || !answers.description) {
+      console.log(chalk2.gray("Cancelled."));
+      return;
+    }
+    const token = process.env.GITHUB_TOKEN || await promptForToken();
+    const octokit = new Octokit({ auth: token });
+    spinner.start("Creating branch...");
+    const { data: refData } = await octokit.git.getRef({
+      ...TEMPLATE_REPO,
+      ref: `heads/${TEMPLATE_REPO.branch}`
+    });
+    const mainSha = refData.object.sha;
+    const branchName = `${answers.changeType}/${files[0].componentName}-${Date.now()}`;
+    await octokit.git.createRef({
+      ...TEMPLATE_REPO,
+      ref: `refs/heads/${branchName}`,
+      sha: mainSha
+    });
+    spinner.succeed(`Created branch: ${branchName}`);
+    for (const file of files) {
+      spinner.start(`Uploading ${file.localPath}...`);
+      const templatePath = mapLocalPathToTemplate(file.localPath);
+      let existingFileSha;
+      try {
+        const { data: existingFile } = await octokit.repos.getContent({
+          ...TEMPLATE_REPO,
+          path: templatePath,
+          ref: branchName
+        });
+        if ("sha" in existingFile) {
+          existingFileSha = existingFile.sha;
+        }
+      } catch {
+      }
+      await octokit.repos.createOrUpdateFileContents({
+        ...TEMPLATE_REPO,
+        path: templatePath,
+        message: `${answers.changeType}: ${file.componentName}`,
+        content: Buffer.from(file.content).toString("base64"),
+        branch: branchName,
+        sha: existingFileSha
+      });
+      spinner.succeed(`${existingFileSha ? "Updated" : "Added"} ${templatePath}`);
+    }
+    spinner.start("Creating pull request...");
+    const { data: pr } = await octokit.pulls.create({
+      ...TEMPLATE_REPO,
+      title: answers.description,
+      head: branchName,
+      base: TEMPLATE_REPO.branch,
+      body: generatePRBody(files, answers)
+    });
+    spinner.succeed("Pull request created!");
+    console.log(chalk2.green("\n\u2705 Contribution submitted successfully!"));
+    console.log(chalk2.blue(`\u{1F517} ${pr.html_url}`));
+    console.log(chalk2.gray("\nReview and merge when ready."));
+  } catch (error) {
+    spinner.fail("Failed to contribute");
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+}
+function mapLocalPathToTemplate(localPath) {
+  const normalized = localPath.replace(/^\.\//, "").replace(/components\/ui\//, "components/").replace(/components\//, "");
+  const name = path.basename(normalized, path.extname(normalized));
+  return `packages/components/src/core/${name}/index.tsx`;
+}
+async function promptForToken() {
+  const { token } = await prompts2({
+    type: "password",
+    name: "token",
+    message: "Enter your GitHub personal access token:",
+    validate: (value) => value.length > 0 || "Token is required"
+  });
+  return token;
+}
+function generatePRBody(files, answers) {
+  return `## ${answers.description}
+
+### Changes
+${files.map((f) => `- ${f.localPath}`).join("\n")}
+
+### Type
+\`${answers.changeType}\`
+
+---
+*Contributed via \`npx the-grove contribute\`*`;
+}
+
+// src/commands/list.ts
+import chalk3 from "chalk";
+var REGISTRY_BASE_URL2 = "https://raw.githubusercontent.com/matthewnaples/the-grove/main/packages/registry/registry";
+async function list(options) {
+  console.log(chalk3.bold("\n\u{1F4E6} Available Components\n"));
+  const categories = options.category ? [options.category] : ["core", "convex", "clerk", "convex-clerk"];
+  for (const category of categories) {
+    console.log(chalk3.bold.blue(`
+${category.toUpperCase()}:`));
+    try {
+      const components = await fetchCategoryComponents(category);
+      for (const component of components) {
+        if (options.tag && !component.tags?.includes(options.tag)) {
+          continue;
+        }
+        const deps = component.dependencies?.length ? chalk3.gray(` (requires: ${component.dependencies.join(", ")})`) : "";
+        console.log(`  ${chalk3.green(component.name)}${deps}`);
+        if (component.description) {
+          console.log(`    ${chalk3.gray(component.description)}`);
+        }
+      }
+    } catch (error) {
+      console.log(chalk3.gray(`  No components found`));
+    }
+  }
+  console.log(chalk3.gray("\nRun `npx the-grove add <component>` to install\n"));
+}
+async function fetchCategoryComponents(category) {
+  const indexUrl = `${REGISTRY_BASE_URL2}/${category}/index.json`;
+  try {
+    const response = await fetch(indexUrl);
+    if (!response.ok) return [];
+    return await response.json();
+  } catch {
+    return [];
+  }
+}
+
+// src/index.ts
+var program = new Command();
+program.name("the-grove").description("Component library CLI for managing UI components").version("0.1.0");
+program.command("add").description("Add component(s) to your project").argument("[components...]", "Component names to add").option("-p, --path <path>", "Custom installation path").option("-y, --yes", "Skip confirmation prompts").action(add);
+program.command("contribute").description("Contribute component(s) back to the template repository").argument("<files...>", "Component file paths to contribute").action(contribute);
+program.command("list").description("List all available components").option("-c, --category <category>", "Filter by category (core, convex, clerk, convex-clerk)").option("-t, --tag <tag>", "Filter by tag").action(list);
+program.parse();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@the-grove/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "CLI for the-grove component library",
+  "bin": {
+    "the-grove": "./dist/index.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^11.0.0",
+    "prompts": "^2.4.2",
+    "execa": "^8.0.0",
+    "ora": "^7.0.0",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "@octokit/rest": "^20.0.0",
+    "node-fetch": "^3.3.0"
+  },
+  "devDependencies": {
+    "@types/prompts": "^2.4.0",
+    "@types/fs-extra": "^11.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": ["the-grove", "components", "cli", "nextjs", "react"]
+}