create-zenith 1.3.18 → 1.3.19

package/README.md

@@ -17,7 +17,7 @@ The official CLI for scaffolding new Zenith applications. Fast, animated, and de
 - **Interactive UX**: Built with `@clack/prompts` for intuitive arrow-key navigation and clear visual indicators.
 - **Reliable Fallbacks**: Automatically detects CI environments and non-TTY pipes to provide clean, static output.
 - **Smart Detection**: automatically detects your preferred package manager (Bun, pnpm, Yarn, or npm).
-- **Batteries Included**: Optional setup for ESLint, Prettier, and TypeScript path aliases.
+- **Tool-Agnostic Output**: ESLint, Prettier, and TypeScript path aliases are opt-in. If you answer `No`, the generated project contains no scripts, dependencies, config files, or ignore files for that tool.
 
 ## Quick Start
 
@@ -40,6 +40,21 @@ pnpm create zenith
 | `-h, --help` | Show usage information |
 | `-v, --version` | Show version number |
 
+## Optional Tooling Contract
+
+During scaffold, `create-zenith` asks whether to include:
+
+- ESLint
+- Prettier
+- TypeScript path aliases
+
+Tooling behavior is strict:
+
+- If you enable ESLint, the project gets `eslint.config.js`, lint scripts, and matching ESLint dependencies.
+- If you disable ESLint, the project contains zero ESLint references.
+- If you enable Prettier, the project gets `.prettierrc`, `.prettierignore`, a format script, and the Prettier dependency.
+- If you disable Prettier, the project contains zero Prettier references.
+
 ## Beta Version Pinning
 
 Zenith beta currently pins `@zenithbuild/core` to `0.5.0-beta.2.20` and leaf packages (compiler, cli, runtime, router, bundler) to `0.5.0-beta.2.20`. This is intentional — core contains the CLI entry point and may bump independently for bin/CLI fixes without touching the engine.
@@ -50,6 +65,7 @@ If you see version mismatches after install, delete `node_modules` and `package-
 
 - Generated apps now depend on `@zenithbuild/core@latest` so new installs track the current stable framework release.
 - Template downloads now resolve from `zenithbuild/framework`, which is the active monorepo source of truth.
+- ESLint and Prettier are now feature overlays, so opting out leaves no stray config or dependency references in the scaffolded app.
 - Verified scaffold → install → build coverage lives in `tests/template-regression.spec.mjs`.
 
 ## Development

package/dist/cli.js

@@ -2819,6 +2819,72 @@ var log = {
   message: (message) => getUiMode(process).plain ? console.log(message) : M2.message(message)
 };
 
+// src/template-features.ts
+var FEATURE_DEFINITIONS = {
+  eslint: {
+    templatePath: "templates/features/eslint",
+    packagePatch: {
+      scripts: {
+        lint: "eslint ."
+      },
+      devDependencies: {
+        eslint: "^9.39.2",
+        "@typescript-eslint/eslint-plugin": "^8.53.0",
+        "@typescript-eslint/parser": "^8.53.0"
+      }
+    }
+  },
+  prettier: {
+    templatePath: "templates/features/prettier",
+    packagePatch: {
+      scripts: {
+        format: "prettier --write ."
+      },
+      devDependencies: {
+        prettier: "^3.7.4"
+      }
+    }
+  }
+};
+function mergeRecord(target, patch) {
+  if (!patch) {
+    return target;
+  }
+  return { ...target || {}, ...patch };
+}
+function selectedTemplateFeaturePaths(options) {
+  const paths = [];
+  if (options.eslint) {
+    paths.push(FEATURE_DEFINITIONS.eslint.templatePath);
+  }
+  if (options.prettier) {
+    paths.push(FEATURE_DEFINITIONS.prettier.templatePath);
+  }
+  return paths;
+}
+function applyPackageFeatures(manifest, options) {
+  const nextManifest = {
+    ...manifest,
+    scripts: { ...manifest.scripts || {} },
+    devDependencies: { ...manifest.devDependencies || {} }
+  };
+  for (const featureName of Object.keys(FEATURE_DEFINITIONS)) {
+    if (!options[featureName]) {
+      continue;
+    }
+    const patch = FEATURE_DEFINITIONS[featureName].packagePatch;
+    nextManifest.scripts = mergeRecord(nextManifest.scripts, patch.scripts);
+    nextManifest.devDependencies = mergeRecord(nextManifest.devDependencies, patch.devDependencies);
+  }
+  if (nextManifest.scripts && Object.keys(nextManifest.scripts).length === 0) {
+    delete nextManifest.scripts;
+  }
+  if (nextManifest.devDependencies && Object.keys(nextManifest.devDependencies).length === 0) {
+    delete nextManifest.devDependencies;
+  }
+  return nextManifest;
+}
+
 // src/index.ts
 var GITHUB_REPO = "zenithbuild/framework";
 var DEFAULT_TEMPLATE = "examples/starter";
@@ -2845,6 +2911,15 @@ function resolveLocalTemplatePath(templatePath) {
   const candidate = path.resolve(__dirname2, "..", templatePath);
   return fs.existsSync(candidate) ? candidate : null;
 }
+function copyDirectoryContents(sourceDir, targetDir) {
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const entry of fs.readdirSync(sourceDir)) {
+    fs.cpSync(path.join(sourceDir, entry), path.join(targetDir, entry), {
+      recursive: true,
+      force: true
+    });
+  }
+}
 function detectPackageManager() {
   const userAgent = process.env.npm_config_user_agent || "";
   if (userAgent.includes("bun"))
@@ -2875,16 +2950,22 @@ function hasGit() {
     return false;
   }
 }
-async function downloadTemplate(targetDir, templatePath) {
-  const localTemplatePath = resolveLocalTemplatePath(templatePath);
+async function downloadTemplate(targetDir, templatePaths) {
+  const localTemplatePaths = templatePaths.map((templatePath) => ({
+    templatePath,
+    localPath: resolveLocalTemplatePath(templatePath)
+  }));
   const forceLocal = process.env.CREATE_ZENITH_TEMPLATE_MODE === "local" || flagEnabled2(process.env.CREATE_ZENITH_OFFLINE);
   const preferLocal = process.env.CREATE_ZENITH_PREFER_LOCAL !== "0";
-  if (localTemplatePath && (forceLocal || preferLocal)) {
-    fs.cpSync(localTemplatePath, targetDir, { recursive: true });
+  if (localTemplatePaths.every((entry) => entry.localPath) && (forceLocal || preferLocal)) {
+    for (const entry of localTemplatePaths) {
+      copyDirectoryContents(entry.localPath, targetDir);
+    }
     return;
   }
-  if (forceLocal && !localTemplatePath) {
-    throw new Error(`Local template not found: ${templatePath}`);
+  if (forceLocal) {
+    const missingPath = localTemplatePaths.find((entry) => !entry.localPath)?.templatePath;
+    throw new Error(`Local template not found: ${missingPath}`);
   }
   const tempDir = path.join(os2.tmpdir(), `zenith-template-${Date.now()}`);
   try {
@@ -2892,13 +2973,15 @@ async function downloadTemplate(targetDir, templatePath) {
       execSync(`git clone --depth 1 --filter=blob:none --sparse https://github.com/${GITHUB_REPO}.git "${tempDir}"`, {
         stdio: "pipe"
       });
-      const repoTemplatePath = `packages/create-zenith/${templatePath}`;
-      execSync(`git sparse-checkout set ${repoTemplatePath}`, {
+      const repoTemplatePaths = templatePaths.map((templatePath) => `packages/create-zenith/${templatePath}`);
+      execSync(`git sparse-checkout set ${repoTemplatePaths.join(" ")}`, {
         cwd: tempDir,
         stdio: "pipe"
       });
-      const templateSource = path.join(tempDir, repoTemplatePath);
-      fs.cpSync(templateSource, targetDir, { recursive: true });
+      for (const repoTemplatePath of repoTemplatePaths) {
+        const templateSource = path.join(tempDir, repoTemplatePath);
+        copyDirectoryContents(templateSource, targetDir);
+      }
     } else {
       const tarballUrl = `https://github.com/${GITHUB_REPO}/archive/refs/heads/main.tar.gz`;
       const tarballPath = path.join(os2.tmpdir(), `zenith-${Date.now()}.tar.gz`);
@@ -2909,8 +2992,10 @@ async function downloadTemplate(targetDir, templatePath) {
       if (!extractedDir) {
         throw new Error("Failed to extract template from GitHub");
       }
-      const templateSource = path.join(tempDir, extractedDir, "packages/create-zenith", templatePath);
-      fs.cpSync(templateSource, targetDir, { recursive: true });
+      for (const templatePath of templatePaths) {
+        const templateSource = path.join(tempDir, extractedDir, "packages/create-zenith", templatePath);
+        copyDirectoryContents(templateSource, targetDir);
+      }
       fs.unlinkSync(tarballPath);
     }
   } finally {
@@ -2919,7 +3004,17 @@ async function downloadTemplate(targetDir, templatePath) {
     }
   }
 }
+function readOptionOverride(name) {
+  const value = process.env[name];
+  if (value == null || value.trim() === "") {
+    return;
+  }
+  return flagEnabled2(value);
+}
 async function gatherOptions(providedName, withTailwind) {
+  const eslintOverride = readOptionOverride("CREATE_ZENITH_ESLINT");
+  const prettierOverride = readOptionOverride("CREATE_ZENITH_PRETTIER");
+  const pathAliasOverride = readOptionOverride("CREATE_ZENITH_PATH_ALIAS");
   let name = providedName;
   if (!name) {
     const nameResult = await text({
@@ -2957,9 +3052,9 @@ async function gatherOptions(providedName, withTailwind) {
     log.info("Non-interactive mode detected, using defaults...");
     return {
       name,
-      eslint: true,
-      prettier: true,
-      pathAlias: true,
+      eslint: eslintOverride ?? true,
+      prettier: prettierOverride ?? true,
+      pathAlias: pathAliasOverride ?? true,
       tailwind: withTailwind ?? false
     };
   }
@@ -2969,23 +3064,23 @@ async function gatherOptions(providedName, withTailwind) {
   });
   if (isCancel(tailwindResult))
     handleCancel();
-  const eslintResult = await confirm({
+  const eslintResult = eslintOverride ?? await confirm({
     message: "Add ESLint for code linting?",
     initialValue: true
   });
-  if (isCancel(eslintResult))
+  if (eslintOverride === undefined && isCancel(eslintResult))
     handleCancel();
-  const prettierResult = await confirm({
+  const prettierResult = prettierOverride ?? await confirm({
     message: "Add Prettier for code formatting?",
     initialValue: true
   });
-  if (isCancel(prettierResult))
+  if (prettierOverride === undefined && isCancel(prettierResult))
     handleCancel();
-  const pathAliasResult = await confirm({
+  const pathAliasResult = pathAliasOverride ?? await confirm({
     message: "Add TypeScript path alias (@/*)?",
     initialValue: true
   });
-  if (isCancel(pathAliasResult))
+  if (pathAliasOverride === undefined && isCancel(pathAliasResult))
     handleCancel();
   return {
     name,
@@ -2998,31 +3093,13 @@ async function gatherOptions(providedName, withTailwind) {
 async function createProject(options) {
   const targetDir = path.resolve(process.cwd(), options.name);
   const templatePath = options.tailwind ? TAILWIND_TEMPLATE : DEFAULT_TEMPLATE;
-  await downloadTemplate(targetDir, templatePath);
+  const templateFeaturePaths = selectedTemplateFeaturePaths(options);
+  await downloadTemplate(targetDir, [templatePath, ...templateFeaturePaths]);
   const pkgPath = path.join(targetDir, "package.json");
   if (fs.existsSync(pkgPath)) {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    const pkg = applyPackageFeatures(JSON.parse(fs.readFileSync(pkgPath, "utf8")), options);
     pkg.name = options.name;
     pkg.version = "0.1.0";
-    if (!options.eslint) {
-      delete pkg.devDependencies?.["eslint"];
-      delete pkg.devDependencies?.["@typescript-eslint/eslint-plugin"];
-      delete pkg.devDependencies?.["@typescript-eslint/parser"];
-      delete pkg.scripts?.lint;
-      const eslintPath = path.join(targetDir, ".eslintrc.json");
-      if (fs.existsSync(eslintPath))
-        fs.unlinkSync(eslintPath);
-    }
-    if (!options.prettier) {
-      delete pkg.devDependencies?.["prettier"];
-      delete pkg.scripts?.format;
-      const prettierRc = path.join(targetDir, ".prettierrc");
-      const prettierIgnore = path.join(targetDir, ".prettierignore");
-      if (fs.existsSync(prettierRc))
-        fs.unlinkSync(prettierRc);
-      if (fs.existsSync(prettierIgnore))
-        fs.unlinkSync(prettierIgnore);
-    }
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4));
   }
   const tsconfigPath = path.join(targetDir, "tsconfig.json");

package/dist/index.js

@@ -2818,6 +2818,72 @@ var log = {
   message: (message) => getUiMode(process).plain ? console.log(message) : M2.message(message)
 };
 
+// src/template-features.ts
+var FEATURE_DEFINITIONS = {
+  eslint: {
+    templatePath: "templates/features/eslint",
+    packagePatch: {
+      scripts: {
+        lint: "eslint ."
+      },
+      devDependencies: {
+        eslint: "^9.39.2",
+        "@typescript-eslint/eslint-plugin": "^8.53.0",
+        "@typescript-eslint/parser": "^8.53.0"
+      }
+    }
+  },
+  prettier: {
+    templatePath: "templates/features/prettier",
+    packagePatch: {
+      scripts: {
+        format: "prettier --write ."
+      },
+      devDependencies: {
+        prettier: "^3.7.4"
+      }
+    }
+  }
+};
+function mergeRecord(target, patch) {
+  if (!patch) {
+    return target;
+  }
+  return { ...target || {}, ...patch };
+}
+function selectedTemplateFeaturePaths(options) {
+  const paths = [];
+  if (options.eslint) {
+    paths.push(FEATURE_DEFINITIONS.eslint.templatePath);
+  }
+  if (options.prettier) {
+    paths.push(FEATURE_DEFINITIONS.prettier.templatePath);
+  }
+  return paths;
+}
+function applyPackageFeatures(manifest, options) {
+  const nextManifest = {
+    ...manifest,
+    scripts: { ...manifest.scripts || {} },
+    devDependencies: { ...manifest.devDependencies || {} }
+  };
+  for (const featureName of Object.keys(FEATURE_DEFINITIONS)) {
+    if (!options[featureName]) {
+      continue;
+    }
+    const patch = FEATURE_DEFINITIONS[featureName].packagePatch;
+    nextManifest.scripts = mergeRecord(nextManifest.scripts, patch.scripts);
+    nextManifest.devDependencies = mergeRecord(nextManifest.devDependencies, patch.devDependencies);
+  }
+  if (nextManifest.scripts && Object.keys(nextManifest.scripts).length === 0) {
+    delete nextManifest.scripts;
+  }
+  if (nextManifest.devDependencies && Object.keys(nextManifest.devDependencies).length === 0) {
+    delete nextManifest.devDependencies;
+  }
+  return nextManifest;
+}
+
 // src/index.ts
 var GITHUB_REPO = "zenithbuild/framework";
 var DEFAULT_TEMPLATE = "examples/starter";
@@ -2844,6 +2910,15 @@ function resolveLocalTemplatePath(templatePath) {
   const candidate = path.resolve(__dirname2, "..", templatePath);
   return fs.existsSync(candidate) ? candidate : null;
 }
+function copyDirectoryContents(sourceDir, targetDir) {
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const entry of fs.readdirSync(sourceDir)) {
+    fs.cpSync(path.join(sourceDir, entry), path.join(targetDir, entry), {
+      recursive: true,
+      force: true
+    });
+  }
+}
 function detectPackageManager() {
   const userAgent = process.env.npm_config_user_agent || "";
   if (userAgent.includes("bun"))
@@ -2874,16 +2949,22 @@ function hasGit() {
     return false;
   }
 }
-async function downloadTemplate(targetDir, templatePath) {
-  const localTemplatePath = resolveLocalTemplatePath(templatePath);
+async function downloadTemplate(targetDir, templatePaths) {
+  const localTemplatePaths = templatePaths.map((templatePath) => ({
+    templatePath,
+    localPath: resolveLocalTemplatePath(templatePath)
+  }));
   const forceLocal = process.env.CREATE_ZENITH_TEMPLATE_MODE === "local" || flagEnabled2(process.env.CREATE_ZENITH_OFFLINE);
   const preferLocal = process.env.CREATE_ZENITH_PREFER_LOCAL !== "0";
-  if (localTemplatePath && (forceLocal || preferLocal)) {
-    fs.cpSync(localTemplatePath, targetDir, { recursive: true });
+  if (localTemplatePaths.every((entry) => entry.localPath) && (forceLocal || preferLocal)) {
+    for (const entry of localTemplatePaths) {
+      copyDirectoryContents(entry.localPath, targetDir);
+    }
     return;
   }
-  if (forceLocal && !localTemplatePath) {
-    throw new Error(`Local template not found: ${templatePath}`);
+  if (forceLocal) {
+    const missingPath = localTemplatePaths.find((entry) => !entry.localPath)?.templatePath;
+    throw new Error(`Local template not found: ${missingPath}`);
   }
   const tempDir = path.join(os2.tmpdir(), `zenith-template-${Date.now()}`);
   try {
@@ -2891,13 +2972,15 @@ async function downloadTemplate(targetDir, templatePath) {
       execSync(`git clone --depth 1 --filter=blob:none --sparse https://github.com/${GITHUB_REPO}.git "${tempDir}"`, {
         stdio: "pipe"
       });
-      const repoTemplatePath = `packages/create-zenith/${templatePath}`;
-      execSync(`git sparse-checkout set ${repoTemplatePath}`, {
+      const repoTemplatePaths = templatePaths.map((templatePath) => `packages/create-zenith/${templatePath}`);
+      execSync(`git sparse-checkout set ${repoTemplatePaths.join(" ")}`, {
         cwd: tempDir,
         stdio: "pipe"
       });
-      const templateSource = path.join(tempDir, repoTemplatePath);
-      fs.cpSync(templateSource, targetDir, { recursive: true });
+      for (const repoTemplatePath of repoTemplatePaths) {
+        const templateSource = path.join(tempDir, repoTemplatePath);
+        copyDirectoryContents(templateSource, targetDir);
+      }
     } else {
       const tarballUrl = `https://github.com/${GITHUB_REPO}/archive/refs/heads/main.tar.gz`;
       const tarballPath = path.join(os2.tmpdir(), `zenith-${Date.now()}.tar.gz`);
@@ -2908,8 +2991,10 @@ async function downloadTemplate(targetDir, templatePath) {
       if (!extractedDir) {
         throw new Error("Failed to extract template from GitHub");
       }
-      const templateSource = path.join(tempDir, extractedDir, "packages/create-zenith", templatePath);
-      fs.cpSync(templateSource, targetDir, { recursive: true });
+      for (const templatePath of templatePaths) {
+        const templateSource = path.join(tempDir, extractedDir, "packages/create-zenith", templatePath);
+        copyDirectoryContents(templateSource, targetDir);
+      }
       fs.unlinkSync(tarballPath);
     }
   } finally {
@@ -2918,7 +3003,17 @@ async function downloadTemplate(targetDir, templatePath) {
     }
   }
 }
+function readOptionOverride(name) {
+  const value = process.env[name];
+  if (value == null || value.trim() === "") {
+    return;
+  }
+  return flagEnabled2(value);
+}
 async function gatherOptions(providedName, withTailwind) {
+  const eslintOverride = readOptionOverride("CREATE_ZENITH_ESLINT");
+  const prettierOverride = readOptionOverride("CREATE_ZENITH_PRETTIER");
+  const pathAliasOverride = readOptionOverride("CREATE_ZENITH_PATH_ALIAS");
   let name = providedName;
   if (!name) {
     const nameResult = await text({
@@ -2956,9 +3051,9 @@ async function gatherOptions(providedName, withTailwind) {
     log.info("Non-interactive mode detected, using defaults...");
     return {
       name,
-      eslint: true,
-      prettier: true,
-      pathAlias: true,
+      eslint: eslintOverride ?? true,
+      prettier: prettierOverride ?? true,
+      pathAlias: pathAliasOverride ?? true,
       tailwind: withTailwind ?? false
     };
   }
@@ -2968,23 +3063,23 @@ async function gatherOptions(providedName, withTailwind) {
   });
   if (isCancel(tailwindResult))
     handleCancel();
-  const eslintResult = await confirm({
+  const eslintResult = eslintOverride ?? await confirm({
     message: "Add ESLint for code linting?",
     initialValue: true
   });
-  if (isCancel(eslintResult))
+  if (eslintOverride === undefined && isCancel(eslintResult))
     handleCancel();
-  const prettierResult = await confirm({
+  const prettierResult = prettierOverride ?? await confirm({
     message: "Add Prettier for code formatting?",
     initialValue: true
   });
-  if (isCancel(prettierResult))
+  if (prettierOverride === undefined && isCancel(prettierResult))
     handleCancel();
-  const pathAliasResult = await confirm({
+  const pathAliasResult = pathAliasOverride ?? await confirm({
     message: "Add TypeScript path alias (@/*)?",
     initialValue: true
   });
-  if (isCancel(pathAliasResult))
+  if (pathAliasOverride === undefined && isCancel(pathAliasResult))
     handleCancel();
   return {
     name,
@@ -2997,31 +3092,13 @@ async function gatherOptions(providedName, withTailwind) {
 async function createProject(options) {
   const targetDir = path.resolve(process.cwd(), options.name);
   const templatePath = options.tailwind ? TAILWIND_TEMPLATE : DEFAULT_TEMPLATE;
-  await downloadTemplate(targetDir, templatePath);
+  const templateFeaturePaths = selectedTemplateFeaturePaths(options);
+  await downloadTemplate(targetDir, [templatePath, ...templateFeaturePaths]);
   const pkgPath = path.join(targetDir, "package.json");
   if (fs.existsSync(pkgPath)) {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    const pkg = applyPackageFeatures(JSON.parse(fs.readFileSync(pkgPath, "utf8")), options);
     pkg.name = options.name;
     pkg.version = "0.1.0";
-    if (!options.eslint) {
-      delete pkg.devDependencies?.["eslint"];
-      delete pkg.devDependencies?.["@typescript-eslint/eslint-plugin"];
-      delete pkg.devDependencies?.["@typescript-eslint/parser"];
-      delete pkg.scripts?.lint;
-      const eslintPath = path.join(targetDir, ".eslintrc.json");
-      if (fs.existsSync(eslintPath))
-        fs.unlinkSync(eslintPath);
-    }
-    if (!options.prettier) {
-      delete pkg.devDependencies?.["prettier"];
-      delete pkg.scripts?.format;
-      const prettierRc = path.join(targetDir, ".prettierrc");
-      const prettierIgnore = path.join(targetDir, ".prettierignore");
-      if (fs.existsSync(prettierRc))
-        fs.unlinkSync(prettierRc);
-      if (fs.existsSync(prettierIgnore))
-        fs.unlinkSync(prettierIgnore);
-    }
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4));
   }
   const tsconfigPath = path.join(targetDir, "tsconfig.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zenith",
-  "version": "1.3.18",
+  "version": "1.3.19",
   "description": "Create a new Zenith application - the modern reactive web framework",
   "type": "module",
   "bin": {