@expcat/tigercat-cli 1.3.4 → 1.5.0

package/dist/index.js

@@ -5,32 +5,67 @@ import { existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync } from
 import { resolve, join, dirname, basename } from 'path';
 import pc2 from 'picocolors';
 import { execSync } from 'child_process';
+import { createRequire } from 'module';
+import { pathToFileURL } from 'url';
+
+function logSuccess(msg) {
+  console.log(pc2.green("\u2714") + " " + msg);
+}
+function logInfo(msg) {
+  console.log(pc2.blue("\u2139") + " " + msg);
+}
+function logWarn(msg) {
+  console.log(pc2.yellow("\u26A0") + " " + msg);
+}
+function logError(msg) {
+  console.error(pc2.red("\u2716") + " " + msg);
+}
+function logStep(step, total, msg) {
+  console.log(pc2.dim(`[${step}/${total}]`) + " " + msg);
+}
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function writeFileSafe(filePath, content) {
+  ensureDir(dirname(filePath));
+  writeFileSync(filePath, content, "utf-8");
+}
+function isDirEmpty(dir) {
+  if (!existsSync(dir)) return true;
+  return readdirSync(dir).length === 0;
+}
+function readFileSafe(filePath) {
+  if (!existsSync(filePath)) return null;
+  return readFileSync(filePath, "utf-8");
+}
 
 // src/constants.ts
 var CLI_NAME = "tigercat";
-var CLI_VERSION = "1.3.4";
+var CLI_VERSION = "1.5.0";
 var TEMPLATES = ["vue3", "react"];
 var TEMPLATE_VERSIONS = {
   // Tigercat packages (use caret on latest major)
-  tigercat: "^1.3.4",
+  tigercat: "^1.5.0",
   // Frameworks
-  vue: "^3.5.33",
-  react: "^19.2.5",
-  reactDom: "^19.2.5",
+  vue: "^3.5.38",
+  react: "^19.2.7",
+  reactDom: "^19.2.7",
   // Build toolchain
   typescript: "^6.0.3",
-  vite: "^8.0.10",
-  tailwindcss: "^4.2.4",
-  tailwindcssVite: "^4.2.4",
+  vite: "^8.1.0",
+  tailwindcss: "^4.3.1",
+  tailwindcssVite: "^4.3.1",
   // Vite plugins
-  vitejsPluginVue: "^6.0.6",
-  vitejsPluginReact: "^6.0.1",
+  vitejsPluginVue: "^6.0.7",
+  vitejsPluginReact: "^6.0.3",
   // Type definitions
-  typesReact: "^19.2.14",
+  typesReact: "^19.2.17",
   typesReactDom: "^19.2.3",
   // Vue-specific
   vueTsconfig: "^0.9.1",
-  vueTsc: "^3.2.7"
+  vueTsc: "^3.3.5"
 };
 var COMPONENT_CATEGORIES = {
   basic: [
@@ -86,37 +121,50 @@ var COMPONENT_CATEGORIES = {
   ]
 };
 var ALL_COMPONENTS = Object.values(COMPONENT_CATEGORIES).flat();
-function logSuccess(msg) {
-  console.log(pc2.green("\u2714") + " " + msg);
-}
-function logInfo(msg) {
-  console.log(pc2.blue("\u2139") + " " + msg);
-}
-function logWarn2(msg) {
-  console.log(pc2.yellow("\u26A0") + " " + msg);
-}
-function logError(msg) {
-  console.error(pc2.red("\u2716") + " " + msg);
-}
-function logStep(step, total, msg) {
-  console.log(pc2.dim(`[${step}/${total}]`) + " " + msg);
-}
-function ensureDir(dir) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
+
+// src/utils/validate.ts
+var PACKAGE_NAME_REGEX = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+function validateProjectName(name) {
+  if (name.trim().length === 0) return "Project name must not be empty";
+  if (name.trim() !== name) return "Project name must not have leading or trailing spaces";
+  if (name.length > 214) return "Project name must be 214 characters or fewer";
+  if (/[A-Z]/.test(name)) return "Project name must not contain uppercase letters";
+  if (!PACKAGE_NAME_REGEX.test(name)) {
+    return 'Project name is not a valid npm package name (use lowercase letters, digits, "-", "_" or ".")';
   }
+  return null;
 }
-function writeFileSafe(filePath, content) {
-  ensureDir(dirname(filePath));
-  writeFileSync(filePath, content, "utf-8");
+function suggestProjectName(name) {
+  const sanitizeSegment = (segment) => segment.trim().toLowerCase().replace(/[^a-z0-9-._~]+/g, "-").replace(/^[-._~]+|[-._~]+$/g, "").replace(/-{2,}/g, "-");
+  const scopeMatch = /^@(.+?)\/(.+)$/.exec(name.trim());
+  const suggestion = scopeMatch ? `@${sanitizeSegment(scopeMatch[1])}/${sanitizeSegment(scopeMatch[2])}` : sanitizeSegment(name);
+  return suggestion || "tigercat-app";
 }
-function isDirEmpty(dir) {
-  if (!existsSync(dir)) return true;
-  return readdirSync(dir).length === 0;
+function isFramework(value) {
+  return value === "vue3" || value === "react";
 }
-function readFileSafe(filePath) {
-  if (!existsSync(filePath)) return null;
-  return readFileSync(filePath, "utf-8");
+async function resolveTemplateOption(arg, promptMessage) {
+  if (arg !== void 0) {
+    if (!TEMPLATES.includes(arg)) {
+      logError(`Invalid template "${arg}". Valid templates: ${TEMPLATES.join(", ")}`);
+      process.exit(1);
+    }
+    return arg;
+  }
+  const response = await prompts({
+    type: "select",
+    name: "template",
+    message: promptMessage,
+    choices: [
+      { title: "Vue 3", value: "vue3" },
+      { title: "React", value: "react" }
+    ]
+  });
+  if (!response.template) {
+    logError("Operation cancelled");
+    process.exit(1);
+  }
+  return response.template;
 }
 
 // src/templates/vue3.ts
@@ -534,31 +582,18 @@ function createCreateCommand() {
   });
 }
 async function runCreate(name, templateArg, dryRun = false) {
-  let template;
-  if (templateArg && TEMPLATES.includes(templateArg)) {
-    template = templateArg;
-  } else {
-    const response = await prompts({
-      type: "select",
-      name: "template",
-      message: "Select a framework",
-      choices: [
-        { title: "Vue 3", value: "vue3" },
-        { title: "React", value: "react" }
-      ]
-    });
-    if (!response.template) {
-      logError("Operation cancelled");
-      process.exit(1);
-    }
-    template = response.template;
+  const nameError = validateProjectName(name);
+  if (nameError) {
+    logError(`${nameError}. Try "${suggestProjectName(name)}" instead.`);
+    process.exit(1);
   }
+  const template = await resolveTemplateOption(templateArg, "Select a framework");
   const targetDir = resolve(process.cwd(), name);
   if (!dryRun && existsSync(targetDir) && !isDirEmpty(targetDir)) {
     const { overwrite } = await prompts({
       type: "confirm",
       name: "overwrite",
-      message: `Directory "${name}" is not empty. Remove existing files and continue?`,
+      message: `Directory "${name}" is not empty. Overwrite conflicting template files? (other files are kept)`,
       initial: false
     });
     if (!overwrite) {
@@ -590,6 +625,20 @@ async function runCreate(name, templateArg, dryRun = false) {
   console.log("  pnpm install");
   console.log("  pnpm dev\n");
 }
+function runCommand(command, options = {}) {
+  try {
+    execSync(command, { cwd: options.cwd, stdio: "inherit" });
+  } catch (error) {
+    if (options.allowFailure) return;
+    if (options.failureMessage !== void 0) {
+      logError(options.failureMessage);
+      process.exit(1);
+    }
+    throw error;
+  }
+}
+
+// src/commands/add.ts
 function createAddCommand() {
   return new Command("add").argument("[components...]", "Component names to add (e.g. Button Input Select)").option("-f, --framework <framework>", "Framework override (vue3 | react)").option("--install", "Install missing Tigercat dependencies before generating snippets").option("--snippet <file>", "Generate a reusable import snippet file").option("--dry-run", "Preview generated demo files without writing them").description("Add component import boilerplate to your project").action(async (components, opts) => {
     await runAdd(components ?? [], opts);
@@ -608,8 +657,7 @@ function detectFramework(cwd) {
   return null;
 }
 function normalizeFramework(value) {
-  if (value === "vue3" || value === "react") return value;
-  return null;
+  return value !== void 0 && isFramework(value) ? value : null;
 }
 async function resolveComponents(components) {
   if (components.length > 0) return components;
@@ -661,6 +709,10 @@ function validateComponents(names) {
 }
 async function runAdd(components, options = {}) {
   const cwd = process.cwd();
+  if (options.framework !== void 0 && !isFramework(options.framework)) {
+    logError(`Invalid framework "${options.framework}". Valid frameworks: vue3, react`);
+    process.exit(1);
+  }
   const framework = normalizeFramework(options.framework) ?? detectFramework(cwd);
   const dryRun = Boolean(options.dryRun);
   if (!framework) {
@@ -672,7 +724,7 @@ async function runAdd(components, options = {}) {
   const selectedComponents = await resolveComponents(components);
   const { valid, invalid } = validateComponents(selectedComponents);
   if (invalid.length > 0) {
-    logWarn2(`Unknown components: ${invalid.join(", ")}`);
+    logWarn(`Unknown components: ${invalid.join(", ")}`);
     logInfo(`Available: ${ALL_COMPONENTS.join(", ")}`);
   }
   if (valid.length === 0) {
@@ -688,7 +740,7 @@ async function runAdd(components, options = {}) {
     const installCommand = formatAddCommand(packageManager, missingDeps);
     if (options.install && !dryRun) {
       logInfo(`Installing missing dependencies: ${missingDeps.join(", ")}`);
-      execSync(installCommand, { cwd, stdio: "inherit" });
+      runCommand(installCommand, { cwd });
     } else {
       logInfo(`Missing dependencies detected. Run: ${installCommand}`);
     }
@@ -731,7 +783,7 @@ async function runAdd(components, options = {}) {
     const ext = framework === "vue3" ? "vue" : "tsx";
     const sampleFile = join(sampleDir, `${comp}Demo.${ext}`);
     if (existsSync(sampleFile)) {
-      logWarn2(`${sampleFile} already exists, skipping`);
+      logWarn(`${sampleFile} already exists, skipping`);
       continue;
     }
     if (dryRun) {
@@ -783,29 +835,14 @@ function createPlaygroundCommand() {
   });
 }
 async function runPlayground(templateArg, port = "3456", open = true, dryRun = false) {
-  let template;
-  if (templateArg && TEMPLATES.includes(templateArg)) {
-    template = templateArg;
-  } else {
-    const response = await prompts({
-      type: "select",
-      name: "template",
-      message: "Select a framework for playground",
-      choices: [
-        { title: "Vue 3", value: "vue3" },
-        { title: "React", value: "react" }
-      ]
-    });
-    if (!response.template) {
-      logError("Operation cancelled");
-      process.exit(1);
-    }
-    template = response.template;
-  }
+  const template = await resolveTemplateOption(
+    templateArg,
+    "Select a framework for playground"
+  );
   const tmpDir = resolve(process.cwd(), ".tigercat-playground");
   const projectDir = join(tmpDir, `playground-${template}`);
   if (dryRun) {
-    const safePort = /^\d+$/.test(port) ? port : "3456";
+    const safePort2 = /^\d+$/.test(port) ? port : "3456";
     logInfo(`Dry run: would prepare ${template} playground in ${projectDir}.`);
     if (!existsSync(projectDir)) {
       const files = template === "vue3" ? getVue3Template("playground") : getReactTemplate("playground");
@@ -814,7 +851,7 @@ async function runPlayground(templateArg, port = "3456", open = true, dryRun = f
       }
       logInfo("Would run pnpm install");
     }
-    logInfo(`Would start Vite on port ${safePort}${open ? " and open the browser" : ""}`);
+    logInfo(`Would start Vite on port ${safePort2}${open ? " and open the browser" : ""}`);
     return;
   }
   if (!existsSync(projectDir)) {
@@ -829,21 +866,16 @@ async function runPlayground(templateArg, port = "3456", open = true, dryRun = f
       writeFileSafe(resolve(projectDir, filePath), content);
     }
     logInfo("Installing dependencies...");
-    try {
-      execSync("pnpm install", { cwd: projectDir, stdio: "inherit" });
-    } catch {
-      logError("Failed to install dependencies. Make sure pnpm is available.");
-      process.exit(1);
-    }
+    runCommand("pnpm install", {
+      cwd: projectDir,
+      failureMessage: "Failed to install dependencies. Make sure pnpm is available."
+    });
   }
   logSuccess(`Starting playground on port ${port}...
 `);
-  try {
-    const safePort = /^\d+$/.test(port) ? port : "3456";
-    const openFlag = open ? " --open" : "";
-    execSync(`npx vite --port ${safePort}${openFlag}`, { cwd: projectDir, stdio: "inherit" });
-  } catch {
-  }
+  const safePort = /^\d+$/.test(port) ? port : "3456";
+  const openFlag = open ? " --open" : "";
+  runCommand(`npx vite --port ${safePort}${openFlag}`, { cwd: projectDir, allowFailure: true });
 }
 function createGenerateCommand() {
   const cmd = new Command("generate").description("Code generation utilities");
@@ -1131,13 +1163,37 @@ Document keyboard behavior, roles, labels, and focus management.
 List boundary states, empty states, loading states, and controlled/uncontrolled behavior.
 `;
 }
-var MIN_NODE_MAJOR = 20;
-var MIN_PNPM_MAJOR = 8;
+var MIN_NODE_VERSION = { major: 22, minor: 13, patch: 0 };
+var MIN_PNPM_VERSION = { major: 11, minor: 9, patch: 0 };
+var MIN_NODE_RANGE = "22.13.0";
+var MIN_PNPM_RANGE = "11.9.0";
 var REQUIRED_TAILWIND_MAJOR = 4;
 var REQUIRED_TIGERCAT_MAJOR = 1;
+var FRAMEWORK_PEER_RANGES = {
+  vue3: [{ dep: "vue", major: 3 }],
+  react: [
+    { dep: "react", major: 19 },
+    { dep: "react-dom", major: 19 }
+  ]
+};
+var REQUIRED_CORE_EXPORTS = [
+  ".",
+  "./tailwind",
+  "./tailwind/modern",
+  "./tokens.css",
+  "./figma-variables.json"
+];
 var VERSION_COMPATIBILITY_MATRIX = [
-  { name: "Node.js", range: ">=20.11.0", reason: "Matches workspace engines and CLI templates" },
-  { name: "pnpm", range: ">=8.0.0", reason: "Required by workspace package management" },
+  {
+    name: "Node.js",
+    range: `>=${MIN_NODE_RANGE}`,
+    reason: "Matches workspace engines and CLI templates"
+  },
+  {
+    name: "pnpm",
+    range: `>=${MIN_PNPM_RANGE}`,
+    reason: "Required by workspace package management"
+  },
   { name: "Tailwind CSS", range: ">=4.0.0", reason: "Required by Tigercat theme utilities" },
   { name: "Vue", range: "^3.0.0", reason: "Peer range for @expcat/tigercat-vue" },
   { name: "React", range: "^19.0.0", reason: "Peer range for @expcat/tigercat-react" }
@@ -1160,6 +1216,7 @@ function createDoctorCommand() {
 function collectDoctorChecks(options = {}) {
   const cwd = options.cwd ?? process.cwd();
   const env = options.env ?? process.env;
+  const readCorePackageJson = options.readCorePackageJson ?? defaultReadCorePackageJson;
   const packageResult = readProjectPackage(cwd);
   const nodeVersion = options.nodeVersion ?? process.versions.node;
   const checks = [createPackageCheck(packageResult)];
@@ -1172,6 +1229,14 @@ function collectDoctorChecks(options = {}) {
   checks.push(createPeerDepsCheck(packageResult.packageJson));
   checks.push(createTemplateCompatibilityCheck(packageResult.packageJson));
   checks.push(createCompatibilityMatrixCheck(packageResult.packageJson));
+  const coreExportsCheck = createCoreExportsCheck(
+    packageResult.packageJson,
+    cwd,
+    readCorePackageJson
+  );
+  if (coreExportsCheck) {
+    checks.push(coreExportsCheck);
+  }
   return checks;
 }
 function runDoctor(json = false) {
@@ -1206,7 +1271,7 @@ function runDoctor(json = false) {
     process.exit(1);
   }
   if (warnings.length > 0) {
-    logWarn2(`${warnings.length} warning${warnings.length === 1 ? "" : "s"} found`);
+    logWarn(`${warnings.length} warning${warnings.length === 1 ? "" : "s"} found`);
     return;
   }
   logSuccess("All checks passed");
@@ -1240,18 +1305,18 @@ function createPackageCheck(result) {
 }
 function createNodeCheck(version) {
   const parsed = parseVersion(version);
-  if (!parsed || parsed.major < MIN_NODE_MAJOR) {
+  if (!parsed || isVersionLessThan(parsed, MIN_NODE_VERSION)) {
     return {
       name: "Node.js",
       status: "fail",
-      message: `Node ${MIN_NODE_MAJOR}+ is required, current version is ${version}`,
-      suggestions: [`Install Node ${MIN_NODE_MAJOR}+ and rerun tigercat doctor`]
+      message: `Node ${MIN_NODE_RANGE}+ is required, current version is ${version}`,
+      suggestions: [`Install Node ${MIN_NODE_RANGE}+ and rerun tigercat doctor`]
     };
   }
   return {
     name: "Node.js",
     status: "pass",
-    message: `Node ${version} satisfies >=${MIN_NODE_MAJOR}`
+    message: `Node ${version} satisfies >=${MIN_NODE_RANGE}`
   };
 }
 function createPnpmCheck(packageJson, env) {
@@ -1260,23 +1325,23 @@ function createPnpmCheck(packageJson, env) {
     return {
       name: "pnpm",
       status: "warn",
-      message: `Could not detect pnpm version; Tigercat templates expect pnpm ${MIN_PNPM_MAJOR}+`,
-      suggestions: ["Add packageManager: pnpm@10.26.2 to package.json or run through pnpm"]
+      message: `Could not detect pnpm version; Tigercat templates expect pnpm ${MIN_PNPM_RANGE}+`,
+      suggestions: ["Add packageManager: pnpm@11.9.0 to package.json or run through pnpm"]
     };
   }
   const parsed = parseVersion(version);
-  if (!parsed || parsed.major < MIN_PNPM_MAJOR) {
+  if (!parsed || isVersionLessThan(parsed, MIN_PNPM_VERSION)) {
     return {
       name: "pnpm",
       status: "fail",
-      message: `pnpm ${MIN_PNPM_MAJOR}+ is required, detected ${version}`,
-      suggestions: [`Upgrade pnpm to ${MIN_PNPM_MAJOR}+`]
+      message: `pnpm ${MIN_PNPM_RANGE}+ is required, detected ${version}`,
+      suggestions: [`Upgrade pnpm to ${MIN_PNPM_RANGE}+`]
     };
   }
   return {
     name: "pnpm",
     status: "pass",
-    message: `pnpm ${version} satisfies >=${MIN_PNPM_MAJOR}`
+    message: `pnpm ${version} satisfies >=${MIN_PNPM_RANGE}`
   };
 }
 function createTailwindCheck(packageJson) {
@@ -1424,13 +1489,71 @@ function createCompatibilityMatrixCheck(packageJson) {
       suggestions: ["Install a Tigercat Vue or React package to validate framework peer ranges"]
     };
   }
+  const incompatible = frameworks.flatMap(
+    (framework) => FRAMEWORK_PEER_RANGES[framework].filter(({ dep, major }) => isOlderMajor(dependencies[dep], major)).map(({ dep, major }) => `${dep}@${dependencies[dep]} is below the supported major ${major}`)
+  );
+  if (incompatible.length > 0) {
+    return {
+      name: "Version compatibility matrix",
+      status: "fail",
+      message: "Installed framework versions are outside the supported range",
+      details: [...incompatible, ...details],
+      suggestions: ["Upgrade the listed framework packages to the supported major versions"]
+    };
+  }
   return {
     name: "Version compatibility matrix",
     status: "pass",
-    message: `${frameworks.map(formatFramework).join(" + ")} compatibility matrix is available`,
+    message: `${frameworks.map(formatFramework).join(" + ")} versions satisfy the compatibility matrix`,
     details
   };
 }
+function createCoreExportsCheck(packageJson, cwd, readCorePackageJson) {
+  const dependencies = collectDependencies2(packageJson);
+  if (!dependencies["@expcat/tigercat-core"]) {
+    return null;
+  }
+  const corePackageJson = readCorePackageJson(cwd);
+  if (!corePackageJson) {
+    return null;
+  }
+  const exportsMap = corePackageJson.exports ?? {};
+  const missing = REQUIRED_CORE_EXPORTS.filter((subpath) => !(subpath in exportsMap));
+  if (missing.length > 0) {
+    return {
+      name: "Core exports",
+      status: "fail",
+      message: "@expcat/tigercat-core is missing required export subpaths",
+      details: missing.map((subpath) => `Missing export: ${subpath}`),
+      suggestions: ["Upgrade @expcat/tigercat-core or reinstall dependencies"]
+    };
+  }
+  return {
+    name: "Core exports",
+    status: "pass",
+    message: "@expcat/tigercat-core exposes the required Tailwind, token and entry exports"
+  };
+}
+function defaultReadCorePackageJson(cwd) {
+  try {
+    const requireFromProject = createRequire(pathToFileURL(join(cwd, "package.json")));
+    const mainEntry = requireFromProject.resolve("@expcat/tigercat-core");
+    let dir = dirname(mainEntry);
+    for (let depth = 0; depth < 6; depth++) {
+      const content = readFileSafe(join(dir, "package.json"));
+      if (content) {
+        const parsed = JSON.parse(content);
+        if (parsed.name === "@expcat/tigercat-core") return parsed;
+      }
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 function collectDependencies2(packageJson) {
   return {
     ...packageJson.peerDependencies,
@@ -1467,6 +1590,11 @@ function parseVersion(value) {
     patch: Number(match[3] ?? 0)
   };
 }
+function isVersionLessThan(current, minimum) {
+  if (current.major !== minimum.major) return current.major < minimum.major;
+  if (current.minor !== minimum.minor) return current.minor < minimum.minor;
+  return current.patch < minimum.patch;
+}
 function getRangeMajor(range) {
   if (!range) return null;
   if (/^(workspace|file|link|catalog):/.test(range)) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expcat/tigercat-cli",
-  "version": "1.3.4",
+  "version": "1.5.0",
   "type": "module",
   "description": "CLI tooling for Tigercat UI library — project scaffolding, component generation, and more",
   "license": "MIT",
@@ -28,14 +28,16 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "templates"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.12.0"
+  },
   "dependencies": {
-    "commander": "^13.1.0",
+    "commander": "^15.0.0",
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2"
   },