@vicket/create-support 1.1.1 → 1.1.2

package/bin/create-vicket-support.js

@@ -1,389 +1,429 @@
-#!/usr/bin/env node
-
-const fs = require("node:fs");
-const path = require("node:path");
-const { stdin } = require("node:process");
-
-const PKG_VERSION = require(
-  path.resolve(__dirname, "..", "package.json"),
-).version;
-
-const FRAMEWORK_ALIASES = {
-  next: "next",
-  nextjs: "next",
-  nuxt: "nuxt",
-  svelte: "sveltekit",
-  sveltekit: "sveltekit",
-};
-
-const FRAMEWORK_CHOICES = [
-  { value: "next", label: "Next.js (App Router)" },
-  { value: "nuxt", label: "Nuxt 4 (Vue)" },
-  { value: "sveltekit", label: "SvelteKit" },
-];
-
-const DEFAULT_FRAMEWORK = "next";
-const STYLING_ALIASES = {
-  css: "css",
-  tailwind: "tailwind",
-  tw: "tailwind",
-};
-const STYLING_CHOICES = [
-  { value: "css", label: "CSS file (default)" },
-  { value: "tailwind", label: "Tailwind CSS (inline utilities)" },
-];
-const DEFAULT_STYLING = "css";
-let clack = null;
-
-async function loadClack() {
-  if (clack) return clack;
-  const prompts = await import("@clack/prompts");
-  clack = prompts;
-  return prompts;
-}
-
-function printHelp() {
-  console.log(`
-Usage:
-  create-vicket-support [options]
-
-Options:
-  -f, --framework <name>   Framework: next | nuxt | sveltekit
-  -s, --styling <name>     Styling: css | tailwind (default: css)
-      --tailwind           Shortcut for --styling tailwind
-  -d, --dir <path>         Output directory (default: current directory)
-  -y, --yes                Overwrite existing files without prompt
-  -v, --version            Show version
-  -h, --help               Show help
-
-Examples:
-  npx @vicket/create-support --framework next
-  npx @vicket/create-support --framework next --styling tailwind
-  npx @vicket/create-support --framework nuxt --dir ./my-app
-  npx @vicket/create-support -f sveltekit -d . -y --tailwind
-`);
-}
-
-function parseArgs(argv) {
-  const options = {
-    framework: "",
-    styling: "",
-    dir: process.cwd(),
-    yes: false,
-    help: false,
-    version: false,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--version" || arg === "-v") {
-      options.version = true;
-      continue;
-    }
-    if (arg === "--help" || arg === "-h") {
-      options.help = true;
-      continue;
-    }
-    if (arg === "--framework" || arg === "-f") {
-      options.framework = argv[i + 1] || "";
-      i += 1;
-      continue;
-    }
-    if (arg.startsWith("--framework=")) {
-      options.framework = arg.split("=")[1] || "";
-      continue;
-    }
-    if (arg === "--styling" || arg === "-s") {
-      options.styling = argv[i + 1] || options.styling;
-      i += 1;
-      continue;
-    }
-    if (arg.startsWith("--styling=")) {
-      options.styling = arg.split("=")[1] || options.styling;
-      continue;
-    }
-    if (arg === "--tailwind") {
-      options.styling = "tailwind";
-      continue;
-    }
-    if (arg === "--dir" || arg === "-d") {
-      options.dir = argv[i + 1] || options.dir;
-      i += 1;
-      continue;
-    }
-    if (arg.startsWith("--dir=")) {
-      options.dir = arg.split("=")[1] || options.dir;
-      continue;
-    }
-    if (arg === "--yes" || arg === "-y") {
-      options.yes = true;
-      continue;
-    }
-  }
-
-  return options;
-}
-
-function normalizeFramework(input) {
-  return FRAMEWORK_ALIASES[(input || "").trim().toLowerCase()] || "";
-}
-
-function normalizeStyling(input) {
-  return STYLING_ALIASES[(input || "").trim().toLowerCase()] || "";
-}
-
-async function askFrameworkSelection() {
-  if (!stdin.isTTY) {
-    return "";
-  }
-
-  const p = await loadClack();
-  p.intro("Create Vicket Support");
-  const value = await p.select({
-    message: "Select a framework",
-    initialValue: DEFAULT_FRAMEWORK,
-    options: FRAMEWORK_CHOICES.map((choice) => ({
-      value: choice.value,
-      label: choice.label,
-    })),
-  });
-
-  if (p.isCancel(value)) {
-    p.cancel("Operation cancelled.");
-    return "";
-  }
-
-  return value;
-}
-
-async function askStylingSelection() {
-  if (!stdin.isTTY) {
-    return DEFAULT_STYLING;
-  }
-
-  const p = await loadClack();
-  const value = await p.select({
-    message: "Select a styling mode",
-    initialValue: DEFAULT_STYLING,
-    options: STYLING_CHOICES.map((choice) => ({
-      value: choice.value,
-      label: choice.label,
-    })),
-  });
-
-  if (p.isCancel(value)) {
-    p.cancel("Operation cancelled.");
-    return "";
-  }
-
-  return value;
-}
-
-function collectFiles(baseDir, currentDir = baseDir, acc = []) {
-  const entries = fs.readdirSync(currentDir, { withFileTypes: true });
-  for (const entry of entries) {
-    const absolute = path.join(currentDir, entry.name);
-    if (entry.isDirectory()) {
-      collectFiles(baseDir, absolute, acc);
-      continue;
-    }
-
-    const relative = path.relative(baseDir, absolute);
-    acc.push(relative);
-  }
-  return acc;
-}
-
-function ensureDirectory(filePath) {
-  const dir = path.dirname(filePath);
-  fs.mkdirSync(dir, { recursive: true });
-}
-
-/**
- * Detect whether a Next.js project uses the src/ directory layout.
- * Returns true if src/app exists, false if app/ exists at root,
- * or falls back to checking for a src/ directory.
- */
-function detectNextSrcLayout(targetRoot) {
-  if (fs.existsSync(path.join(targetRoot, "src", "app"))) {
-    return true;
-  }
-  if (fs.existsSync(path.join(targetRoot, "app"))) {
-    return false;
-  }
-  if (fs.existsSync(path.join(targetRoot, "src"))) {
-    return true;
-  }
-  return false;
-}
-
-async function confirmOverwrite(existingFiles) {
-  if (!stdin.isTTY) {
-    return false;
-  }
-
-  const p = await loadClack();
-  p.log.warn("The following files already exist:");
-  for (const file of existingFiles) {
-    p.log.message(`- ${file}`);
-  }
-
-  const value = await p.confirm({
-    message: "Overwrite these files?",
-    initialValue: false,
-  });
-
-  if (p.isCancel(value)) {
-    p.cancel("Operation cancelled.");
-    return false;
-  }
-
-  return Boolean(value);
-}
-
-async function printPostInstall(framework, styling) {
-  const envLinesByFramework = {
-    next: [
-      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
-      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
-    ],
-    nuxt: [
-      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
-      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
-    ],
-    sveltekit: [
-      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
-      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
-    ],
-  };
-  const envLines = envLinesByFramework[framework] || envLinesByFramework.next;
-
-  if (stdin.isTTY) {
-    const p = await loadClack();
-    p.outro("Scaffold complete.");
-    p.log.info("Set these environment variables in the target app:");
-    for (const line of envLines) {
-      p.log.message(line);
-    }
-
-    if (framework === "nuxt") {
-      p.log.info(
-        "Nuxt note: if you prefer global styles, add ~/assets/css/vicket.css to nuxt.config.ts > css. Files are in the app/ directory (Nuxt 4 convention).",
-      );
-    }
-    if (styling === "tailwind") {
-      p.log.info(
-        "Tailwind mode: ensure Tailwind CSS is configured in the target app.",
-      );
-    }
-    return;
-  }
-
-  console.log("\nScaffold complete.");
-  console.log("Set these environment variables in the target app:");
-  for (const line of envLines) {
-    console.log(line);
-  }
-  if (styling === "tailwind") {
-    console.log(
-      "Tailwind mode: ensure Tailwind CSS is configured in the target app.",
-    );
-  }
-}
-
-async function main() {
-  const options = parseArgs(process.argv.slice(2));
-  if (options.version) {
-    console.log(`@vicket/create-support v${PKG_VERSION}`);
-    process.exit(0);
-  }
-  if (options.help) {
-    printHelp();
-    process.exit(0);
-  }
-
-  let framework = normalizeFramework(options.framework);
-  const requestedStyling = (options.styling || "").trim();
-  if (requestedStyling && !normalizeStyling(requestedStyling)) {
-    console.error("Unsupported styling. Use --styling css|tailwind");
-    printHelp();
-    process.exit(1);
-  }
-
-  let styling = normalizeStyling(options.styling) || DEFAULT_STYLING;
-
-  if (!framework) {
-    framework = await askFrameworkSelection();
-  }
-
-  if (!framework) {
-    console.error(
-      "Missing or unsupported framework. Use --framework next|nuxt|sveltekit",
-    );
-    printHelp();
-    process.exit(1);
-  }
-
-  if (
-    !normalizeStyling(options.styling) &&
-    stdin.isTTY &&
-    !process.argv.includes("--tailwind")
-  ) {
-    const selectedStyling = await askStylingSelection();
-    if (!selectedStyling) {
-      console.log("Aborted. No files were written.");
-      process.exit(0);
-    }
-    styling = selectedStyling;
-  }
-
-  const packageRoot = path.resolve(__dirname, "..");
-  const templateDir =
-    styling === "tailwind" ? "templates-tailwind" : "templates";
-  const templateRoot = path.join(packageRoot, templateDir, framework);
-
-  if (!fs.existsSync(templateRoot)) {
-    console.error(`Template not found: ${templateDir}/${framework}`);
-    process.exit(1);
-  }
-
-  const targetRoot = path.resolve(options.dir);
-  const files = collectFiles(templateRoot);
-
-  const stripSrc =
-    framework === "next" && !detectNextSrcLayout(targetRoot);
-  const srcPrefix = "src" + path.sep;
-
-  function toDestRelative(relativePath) {
-    if (stripSrc && relativePath.startsWith(srcPrefix)) {
-      return relativePath.slice(srcPrefix.length);
-    }
-    return relativePath;
-  }
-
-  const existing = files
-    .map((f) => toDestRelative(f))
-    .filter((destPath) => fs.existsSync(path.join(targetRoot, destPath)));
-
-  if (existing.length > 0 && !options.yes) {
-    const shouldOverwrite = await confirmOverwrite(existing);
-    if (!shouldOverwrite) {
-      console.log("Aborted. No files were written.");
-      process.exit(0);
-    }
-  }
-
-  for (const relativePath of files) {
-    const from = path.join(templateRoot, relativePath);
-    const to = path.join(targetRoot, toDestRelative(relativePath));
-    ensureDirectory(to);
-    fs.copyFileSync(from, to);
-  }
-
-  await printPostInstall(framework, styling);
-}
-
-main().catch((error) => {
-  console.error(error);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { stdin } = require("node:process");
+
+const PKG_VERSION = require(
+  path.resolve(__dirname, "..", "package.json"),
+).version;
+
+const FRAMEWORK_ALIASES = {
+  next: "next",
+  nextjs: "next",
+  nuxt: "nuxt",
+  svelte: "sveltekit",
+  sveltekit: "sveltekit",
+};
+
+const FRAMEWORK_CHOICES = [
+  { value: "next", label: "Next.js (App Router)" },
+  { value: "nuxt", label: "Nuxt 4 (Vue)" },
+  { value: "sveltekit", label: "SvelteKit" },
+];
+
+const DEFAULT_FRAMEWORK = "next";
+const STYLING_ALIASES = {
+  css: "css",
+  tailwind: "tailwind",
+  tw: "tailwind",
+};
+const STYLING_CHOICES = [
+  { value: "css", label: "CSS file (default)" },
+  { value: "tailwind", label: "Tailwind CSS (inline utilities)" },
+];
+const DEFAULT_STYLING = "css";
+let clack = null;
+
+async function loadClack() {
+  if (clack) return clack;
+  const prompts = await import("@clack/prompts");
+  clack = prompts;
+  return prompts;
+}
+
+function printHelp() {
+  console.log(`
+Usage:
+  create-vicket-support [options]
+
+Options:
+  -f, --framework <name>   Framework: next | nuxt | sveltekit
+  -s, --styling <name>     Styling: css | tailwind (default: css)
+      --tailwind           Shortcut for --styling tailwind
+  -d, --dir <path>         Output directory (default: current directory)
+  -y, --yes                Overwrite existing files without prompt
+  -v, --version            Show version
+  -h, --help               Show help
+
+Examples:
+  npx @vicket/create-support --framework next
+  npx @vicket/create-support --framework next --styling tailwind
+  npx @vicket/create-support --framework nuxt --dir ./my-app
+  npx @vicket/create-support -f sveltekit -d . -y --tailwind
+`);
+}
+
+function parseArgs(argv) {
+  const options = {
+    framework: "",
+    styling: "",
+    dir: process.cwd(),
+    yes: false,
+    help: false,
+    version: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--version" || arg === "-v") {
+      options.version = true;
+      continue;
+    }
+    if (arg === "--help" || arg === "-h") {
+      options.help = true;
+      continue;
+    }
+    if (arg === "--framework" || arg === "-f") {
+      options.framework = argv[i + 1] || "";
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--framework=")) {
+      options.framework = arg.split("=")[1] || "";
+      continue;
+    }
+    if (arg === "--styling" || arg === "-s") {
+      options.styling = argv[i + 1] || options.styling;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--styling=")) {
+      options.styling = arg.split("=")[1] || options.styling;
+      continue;
+    }
+    if (arg === "--tailwind") {
+      options.styling = "tailwind";
+      continue;
+    }
+    if (arg === "--dir" || arg === "-d") {
+      options.dir = argv[i + 1] || options.dir;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--dir=")) {
+      options.dir = arg.split("=")[1] || options.dir;
+      continue;
+    }
+    if (arg === "--yes" || arg === "-y") {
+      options.yes = true;
+      continue;
+    }
+  }
+
+  return options;
+}
+
+function normalizeFramework(input) {
+  return FRAMEWORK_ALIASES[(input || "").trim().toLowerCase()] || "";
+}
+
+function normalizeStyling(input) {
+  return STYLING_ALIASES[(input || "").trim().toLowerCase()] || "";
+}
+
+async function askFrameworkSelection() {
+  if (!stdin.isTTY) {
+    return "";
+  }
+
+  const p = await loadClack();
+  p.intro("Create Vicket Support");
+  const value = await p.select({
+    message: "Select a framework",
+    initialValue: DEFAULT_FRAMEWORK,
+    options: FRAMEWORK_CHOICES.map((choice) => ({
+      value: choice.value,
+      label: choice.label,
+    })),
+  });
+
+  if (p.isCancel(value)) {
+    p.cancel("Operation cancelled.");
+    return "";
+  }
+
+  return value;
+}
+
+async function askStylingSelection() {
+  if (!stdin.isTTY) {
+    return DEFAULT_STYLING;
+  }
+
+  const p = await loadClack();
+  const value = await p.select({
+    message: "Select a styling mode",
+    initialValue: DEFAULT_STYLING,
+    options: STYLING_CHOICES.map((choice) => ({
+      value: choice.value,
+      label: choice.label,
+    })),
+  });
+
+  if (p.isCancel(value)) {
+    p.cancel("Operation cancelled.");
+    return "";
+  }
+
+  return value;
+}
+
+function collectFiles(baseDir, currentDir = baseDir, acc = []) {
+  const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const absolute = path.join(currentDir, entry.name);
+    if (entry.isDirectory()) {
+      collectFiles(baseDir, absolute, acc);
+      continue;
+    }
+
+    const relative = path.relative(baseDir, absolute);
+    acc.push(relative);
+  }
+  return acc;
+}
+
+function ensureDirectory(filePath) {
+  const dir = path.dirname(filePath);
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+/**
+ * Detect whether a Next.js project uses the src/ directory layout.
+ * Returns true if src/app exists, false if app/ exists at root,
+ * or falls back to checking for a src/ directory.
+ */
+function detectNextSrcLayout(targetRoot) {
+  if (fs.existsSync(path.join(targetRoot, "src", "app"))) {
+    return true;
+  }
+  if (fs.existsSync(path.join(targetRoot, "app"))) {
+    return false;
+  }
+  if (fs.existsSync(path.join(targetRoot, "src"))) {
+    return true;
+  }
+  return false;
+}
+
+async function confirmOverwrite(existingFiles) {
+  if (!stdin.isTTY) {
+    return false;
+  }
+
+  const p = await loadClack();
+  p.log.warn("The following files already exist:");
+  for (const file of existingFiles) {
+    p.log.message(`- ${file}`);
+  }
+
+  const value = await p.confirm({
+    message: "Overwrite these files?",
+    initialValue: false,
+  });
+
+  if (p.isCancel(value)) {
+    p.cancel("Operation cancelled.");
+    return false;
+  }
+
+  return Boolean(value);
+}
+
+function detectPackageManager(targetRoot) {
+  if (fs.existsSync(path.join(targetRoot, "bun.lockb")) || fs.existsSync(path.join(targetRoot, "bun.lock"))) return "bun";
+  if (fs.existsSync(path.join(targetRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs.existsSync(path.join(targetRoot, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+
+async function installVicketPackage(targetRoot) {
+  const { execSync } = require("node:child_process");
+  const pm = detectPackageManager(targetRoot);
+
+  const installCmd = {
+    npm: "npm install vicket",
+    pnpm: "pnpm add vicket",
+    yarn: "yarn add vicket",
+    bun: "bun add vicket",
+  }[pm];
+
+  if (stdin.isTTY) {
+    const p = await loadClack();
+    const s = p.spinner();
+    s.start(`Installing vicket package with ${pm}...`);
+    try {
+      execSync(installCmd, { cwd: targetRoot, stdio: "pipe" });
+      s.stop(`Installed vicket with ${pm}.`);
+    } catch {
+      s.stop(`Could not auto-install. Run "${installCmd}" manually.`);
+    }
+  } else {
+    console.log(`Installing vicket with ${pm}...`);
+    try {
+      execSync(installCmd, { cwd: targetRoot, stdio: "pipe" });
+      console.log("Installed vicket.");
+    } catch {
+      console.log(`Could not auto-install. Run "${installCmd}" manually.`);
+    }
+  }
+}
+
+async function printPostInstall(framework, styling) {
+  const envLinesByFramework = {
+    next: [
+      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
+      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
+    ],
+    nuxt: [
+      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
+      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
+    ],
+    sveltekit: [
+      "- VICKET_API_URL (https://api.vicket.app/api/v1) — server-side only",
+      "- VICKET_API_KEY (website API key) — server-side only, NEVER expose to client",
+    ],
+  };
+  const envLines = envLinesByFramework[framework] || envLinesByFramework.next;
+
+  if (stdin.isTTY) {
+    const p = await loadClack();
+    p.outro("Scaffold complete.");
+    p.log.info("Set these environment variables in the target app:");
+    for (const line of envLines) {
+      p.log.message(line);
+    }
+
+    if (framework === "nuxt") {
+      p.log.info(
+        "Nuxt note: if you prefer global styles, add ~/assets/css/vicket.css to nuxt.config.ts > css. Files are in the app/ directory (Nuxt 4 convention).",
+      );
+    }
+    if (styling === "tailwind") {
+      p.log.info(
+        "Tailwind mode: ensure Tailwind CSS is configured in the target app.",
+      );
+    }
+    return;
+  }
+
+  console.log("\nScaffold complete.");
+  console.log("Set these environment variables in the target app:");
+  for (const line of envLines) {
+    console.log(line);
+  }
+  if (styling === "tailwind") {
+    console.log(
+      "Tailwind mode: ensure Tailwind CSS is configured in the target app.",
+    );
+  }
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (options.version) {
+    console.log(`@vicket/create-support v${PKG_VERSION}`);
+    process.exit(0);
+  }
+  if (options.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  let framework = normalizeFramework(options.framework);
+  const requestedStyling = (options.styling || "").trim();
+  if (requestedStyling && !normalizeStyling(requestedStyling)) {
+    console.error("Unsupported styling. Use --styling css|tailwind");
+    printHelp();
+    process.exit(1);
+  }
+
+  let styling = normalizeStyling(options.styling) || DEFAULT_STYLING;
+
+  if (!framework) {
+    framework = await askFrameworkSelection();
+  }
+
+  if (!framework) {
+    console.error(
+      "Missing or unsupported framework. Use --framework next|nuxt|sveltekit",
+    );
+    printHelp();
+    process.exit(1);
+  }
+
+  if (
+    !normalizeStyling(options.styling) &&
+    stdin.isTTY &&
+    !process.argv.includes("--tailwind")
+  ) {
+    const selectedStyling = await askStylingSelection();
+    if (!selectedStyling) {
+      console.log("Aborted. No files were written.");
+      process.exit(0);
+    }
+    styling = selectedStyling;
+  }
+
+  const packageRoot = path.resolve(__dirname, "..");
+  const templateDir =
+    styling === "tailwind" ? "templates-tailwind" : "templates";
+  const templateRoot = path.join(packageRoot, templateDir, framework);
+
+  if (!fs.existsSync(templateRoot)) {
+    console.error(`Template not found: ${templateDir}/${framework}`);
+    process.exit(1);
+  }
+
+  const targetRoot = path.resolve(options.dir);
+  const files = collectFiles(templateRoot);
+
+  const stripSrc =
+    framework === "next" && !detectNextSrcLayout(targetRoot);
+  const srcPrefix = "src" + path.sep;
+
+  function toDestRelative(relativePath) {
+    if (stripSrc && relativePath.startsWith(srcPrefix)) {
+      return relativePath.slice(srcPrefix.length);
+    }
+    return relativePath;
+  }
+
+  const existing = files
+    .map((f) => toDestRelative(f))
+    .filter((destPath) => fs.existsSync(path.join(targetRoot, destPath)));
+
+  if (existing.length > 0 && !options.yes) {
+    const shouldOverwrite = await confirmOverwrite(existing);
+    if (!shouldOverwrite) {
+      console.log("Aborted. No files were written.");
+      process.exit(0);
+    }
+  }
+
+  for (const relativePath of files) {
+    const from = path.join(templateRoot, relativePath);
+    const to = path.join(targetRoot, toDestRelative(relativePath));
+    ensureDirectory(to);
+    fs.copyFileSync(from, to);
+  }
+
+  await installVicketPackage(targetRoot);
+  await printPostInstall(framework, styling);
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});