@expcat/tigercat-cli 1.3.4 → 1.4.0

package/dist/index.js

@@ -5,14 +5,49 @@ 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.4.0";
 var TEMPLATES = ["vue3", "react"];
 var TEMPLATE_VERSIONS = {
   // Tigercat packages (use caret on latest major)
-  tigercat: "^1.3.4",
+  tigercat: "^1.4.0",
   // Frameworks
   vue: "^3.5.33",
   react: "^19.2.5",
@@ -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) {
@@ -608,8 +643,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 +695,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 +710,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) {
@@ -731,7 +769,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,25 +821,10 @@ 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) {
@@ -1135,6 +1158,20 @@ var MIN_NODE_MAJOR = 20;
 var MIN_PNPM_MAJOR = 8;
 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" },
@@ -1160,6 +1197,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 +1210,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 +1252,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");
@@ -1424,13 +1470,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expcat/tigercat-cli",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "type": "module",
   "description": "CLI tooling for Tigercat UI library — project scaffolding, component generation, and more",
   "license": "MIT",
@@ -28,8 +28,7 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "templates"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"