better-ts-stack 1.1.4 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdullah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,82 +1,113 @@
-# better-ts-stack
-
-> An interactive CLI that scaffolds TypeScript backend and full-stack projects.
-
-`better-ts-stack` creates an Express, Next.js, or TanStack Start project with TypeScript, ESLint, and Prettier set up. Database, authentication, Docker, and git are optional.
-
-## Quick Start
-
-```bash
-# Run instantly with npx
-npx better-ts-stack
-
-# Or install globally
-npm install -g better-ts-stack
-better-ts-stack
-```
-
-Run the command and answer the prompts. The CLI creates the project folder.
-
-## What It Can Scaffold
-
-| Project type   | Stack                                   | Optional setup                                                           |
-| -------------- | --------------------------------------- | ------------------------------------------------------------------------ |
-| Backend API    | Express 5 + TypeScript                  | PostgreSQL, MongoDB, Prisma, Drizzle, Mongoose, JWT auth, Docker, git    |
-| Full-stack app | Next.js 16 or TanStack Start + React 19 | PostgreSQL, MongoDB, Prisma, Drizzle, Mongoose, Better Auth, Docker, git |
-
-Notes:
-
-- Express is the only backend framework for now. NestJS is listed in the prompt as "coming soon".
-- Better Auth is only offered for full-stack projects that use a database.
-
-## Interactive Prompt Flow
-
-The CLI has no subcommands or flags. It asks, in order:
-
-1. Project name
-2. Application type: `Backend API` or `Full-stack App`
-3. Framework
-   - Backend: `Express` (`NestJS` is coming soon)
-   - Full-stack: `Next.js` or `TanStack Start`
-4. Database: `none`, `PostgreSQL`, or `MongoDB`
-5. ORM/ODM when a database is selected
-   - PostgreSQL: `Prisma` or `Drizzle`
-   - MongoDB: `Mongoose`
-6. Package manager: `npm`, `pnpm`, or `bun`
-7. Docker setup
-8. Authentication
-   - Express apps: JWT-based auth
-   - Next.js and TanStack Start apps: Better Auth, only when a database is selected
-9. Git initialization
-10. Dependency installation
-
-The CLI does not ask for a port. Backend projects default to `PORT=3000`.
-
-## What You Get
-
-Every generated project includes:
-
-- TypeScript with strict mode enabled
-- ESLint and Prettier pre-configured
-- `.env.example` and `.env` setup
-- Ready-to-run project scripts
-- Health check endpoint at `/health` for backend projects
-- shadcn-compatible UI components for Next.js and TanStack Start projects
-- Database wiring and schema setup when selected
-- Authentication scaffolding when selected
-- Docker files when selected
-- Optional git repository initialization
-
-## Requirements
-
-- Node.js 24 or later
-
-## Links
-
-- [Documentation](https://better-ts-stack.abdullahtech.me/docs)
-- [GitHub Repository](https://github.com/Abdullah-dev0/better-ts-stack)
-- [Issue Tracker](https://github.com/Abdullah-dev0/better-ts-stack/issues)
-
-## License
-
-MIT
+# better-ts-stack
+
+> A CLI that scaffolds TypeScript backend and full-stack projects.
+
+`better-ts-stack` creates an Express, NestJS, Next.js, or TanStack Start project with TypeScript, ESLint, and Prettier set up. Database, authentication, Docker, and git are optional.
+
+## Quick Start
+
+```bash
+# Run instantly with npx
+npx better-ts-stack
+
+# Or install globally
+npm install -g better-ts-stack
+better-ts-stack
+```
+
+Run the command and answer the prompts. The CLI creates the project folder.
+
+## Flags
+
+Every prompt has a flag. Options you leave out are asked interactively, unless you pass `--yes`.
+
+```bash
+# No prompts at all
+npx better-ts-stack my-api --framework nestjs --database prisma --auth --yes
+
+# Create the project in the current (empty) directory
+npx better-ts-stack . --framework nextjs --database drizzle --pm pnpm
+```
+
+| Flag                         | Values                                       |
+| ---------------------------- | -------------------------------------------- |
+| `--framework <name>`         | `express`, `nestjs`, `nextjs`, `tanstack`    |
+| `--database <name>`          | `none`, `prisma`, `drizzle`, `mongoose`      |
+| `--pm <name>`                | `npm`, `pnpm`, `bun`                         |
+| `--auth` / `--no-auth`       | Add authentication                           |
+| `--docker` / `--no-docker`   | Add Docker files                             |
+| `--git` / `--no-git`         | Initialize a git repository                  |
+| `--install` / `--no-install` | Install dependencies                         |
+| `-y`, `--yes`                | Use defaults for missing options, no prompts |
+| `--dry-run`                  | List what would be created, write nothing    |
+| `-h`, `--help`               | Show help                                    |
+| `-v`, `--version`            | Show the version                             |
+
+`--database` names the ORM, which also selects the database: `prisma` and `drizzle` use PostgreSQL, `mongoose` uses MongoDB.
+
+With `--yes`, the defaults are Express, no database, no auth, no Docker, npm, git initialized, and dependencies not installed.
+
+The project path can be a name (`my-app`), a nested path (`apps/api`), or `.` for the current directory.
+
+## What It Can Scaffold
+
+| Project type   | Stack                                   | Optional setup                                                           |
+| -------------- | --------------------------------------- | ------------------------------------------------------------------------ |
+| Backend API    | Express 5 or NestJS 12 + TypeScript     | PostgreSQL, MongoDB, Prisma, Drizzle, Mongoose, JWT auth, Docker, git    |
+| Full-stack app | Next.js 16 or TanStack Start + React 19 | PostgreSQL, MongoDB, Prisma, Drizzle, Mongoose, Better Auth, Docker, git |
+
+Notes:
+
+- Better Auth is only offered for full-stack projects that use a database.
+
+## Interactive Prompt Flow
+
+Without flags, the CLI asks, in order:
+
+1. Project name or path
+2. Application type: `Backend API` or `Full-stack App`
+3. Framework
+   - Backend: `Express` or `NestJS`
+   - Full-stack: `Next.js` or `TanStack Start`
+4. Database: `none`, `PostgreSQL`, or `MongoDB`
+5. ORM/ODM when a database is selected
+   - PostgreSQL: `Prisma` or `Drizzle`
+   - MongoDB: `Mongoose`
+6. Package manager: `npm`, `pnpm`, or `bun`
+7. Docker setup
+8. Authentication
+   - Express and NestJS apps: JWT-based auth
+   - Next.js and TanStack Start apps: Better Auth, only when a database is selected
+9. Git initialization
+10. Dependency installation
+
+The CLI does not ask for a port. Backend projects default to `PORT=3000`.
+
+## What You Get
+
+Every generated project includes:
+
+- TypeScript with strict mode enabled
+- ESLint and Prettier pre-configured
+- `.env.example` and `.env` setup
+- Ready-to-run project scripts
+- Health check endpoint at `/health` for backend projects
+- shadcn-compatible UI components for Next.js and TanStack Start projects
+- Database wiring and schema setup when selected
+- Authentication scaffolding when selected
+- Docker files when selected
+- Optional git repository initialization
+
+## Requirements
+
+- Node.js 24 or later
+
+## Links
+
+- [Documentation](https://better-ts-stack.abdullahtech.me/docs)
+- [GitHub Repository](https://github.com/Abdullah-dev0/better-ts-stack)
+- [Issue Tracker](https://github.com/Abdullah-dev0/better-ts-stack/issues)
+
+## License
+
+MIT

package/dist/args.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP_TEXT = void 0;
+exports.parseCliArgs = parseCliArgs;
+// Command-line flag parsing; every flag is optional and falls back to a prompt
+const node_util_1 = require("node:util");
+const types_1 = require("./types");
+const FRAMEWORKS = [
+    ...types_1.backendFrameworkOptions,
+    ...types_1.frontendFrameworkOptions,
+].map((option) => option.value);
+const DATABASES = ["none", "prisma", "drizzle", "mongoose"];
+const PACKAGE_MANAGERS = types_1.packageManagerOptions.map((option) => option.value);
+exports.HELP_TEXT = `Usage: better-ts-stack [project-path] [options]
+
+Options left out are asked interactively, unless --yes is given.
+
+  --framework <name>      ${FRAMEWORKS.join(" | ")}
+  --database <name>       ${DATABASES.join(" | ")}
+  --pm <name>             ${PACKAGE_MANAGERS.join(" | ")}
+  --auth, --no-auth       Add authentication
+  --docker, --no-docker   Add Docker files
+  --git, --no-git         Initialize a git repository
+  --install, --no-install Install dependencies
+  -y, --yes               Use defaults for missing options and skip confirmation
+  --dry-run               List the files, dependencies, scripts, environment
+                          variables, and commands without writing anything
+  -h, --help              Show this help
+  -v, --version           Show the version
+
+Examples:
+  better-ts-stack my-api --framework nestjs --database prisma --auth --yes
+  better-ts-stack . --framework nextjs --database drizzle --pm pnpm
+`;
+function parseChoice(flag, value, allowed) {
+    if (value === undefined)
+        return undefined;
+    if (!allowed.includes(value)) {
+        throw (0, types_1.buildError)(`Invalid value "${value}" for --${flag}. Use one of: ${allowed.join(", ")}`, "INVALID_ARGUMENT");
+    }
+    return value;
+}
+function parseCliArgs(argv) {
+    let parsed;
+    try {
+        parsed = (0, node_util_1.parseArgs)({
+            args: argv,
+            allowPositionals: true,
+            allowNegative: true,
+            options: {
+                framework: { type: "string" },
+                database: { type: "string" },
+                pm: { type: "string" },
+                auth: { type: "boolean" },
+                docker: { type: "boolean" },
+                git: { type: "boolean" },
+                install: { type: "boolean" },
+                yes: { type: "boolean", short: "y" },
+                "dry-run": { type: "boolean" },
+                help: { type: "boolean", short: "h" },
+                version: { type: "boolean", short: "v" },
+            },
+        });
+    }
+    catch (error) {
+        throw (0, types_1.buildError)(error, "INVALID_ARGUMENT");
+    }
+    const { values, positionals } = parsed;
+    if (positionals.length > 1) {
+        throw (0, types_1.buildError)(`Expected one project path, got: ${positionals.join(" ")}`, "INVALID_ARGUMENT");
+    }
+    const choices = {
+        framework: parseChoice("framework", values.framework, FRAMEWORKS),
+        database: parseChoice("database", values.database, DATABASES),
+        packageManager: parseChoice("pm", values.pm, PACKAGE_MANAGERS),
+        useAuth: values.auth,
+        useDocker: values.docker,
+        initGit: values.git,
+        installDeps: values.install,
+    };
+    return {
+        projectPath: positionals[0],
+        // Keep only the flags that were passed, so the rest can take defaults
+        choices: Object.fromEntries(Object.entries(choices).filter(([, value]) => value !== undefined)),
+        yes: values.yes ?? false,
+        dryRun: values["dry-run"] ?? false,
+        help: values.help ?? false,
+        version: values.version ?? false,
+    };
+}

package/dist/builder/buildPlanner.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadBuildInputs = loadBuildInputs;
+exports.planBuild = planBuild;
+// Works out what a build produces; nothing here writes to disk
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const registry_1 = require("../modules/registry");
+const configGenerator_1 = require("./configGenerator");
+const fileProcessor_1 = require("./fileProcessor");
+const gitInitializer_1 = require("./gitInitializer");
+const moduleSelector_1 = require("./moduleSelector");
+const templateContext_1 = require("./templateContext");
+// Files the builder writes itself instead of copying them from a module
+const GENERATED_FILES = ["package.json", ".env", ".env.example"];
+// Loads the selected modules and merges their configurations
+async function loadBuildInputs(config) {
+    const selection = (0, moduleSelector_1.selectModules)(config);
+    const modules = [];
+    for (const id of [selection.base, ...selection.modules]) {
+        modules.push(await (0, registry_1.getModule)(id));
+    }
+    const templateContext = (0, templateContext_1.buildTemplateContext)(config);
+    const mergedConfig = (0, configGenerator_1.mergeConfigurations)(modules.map((m) => m.config), templateContext);
+    return { modules, templateContext, mergedConfig };
+}
+// The target directory may not exist yet, so git is asked about the closest
+// directory that does
+async function findExistingDirectory(dir) {
+    let current = dir;
+    while (!(await fs_extra_1.default.pathExists(current))) {
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return current;
+}
+// Describes the files, package.json content, environment variables, and
+// commands of a build, for --dry-run
+async function planBuild(config, targetDir) {
+    const { modules, mergedConfig } = await loadBuildInputs(config);
+    // Later modules overwrite files of earlier ones, so each path is listed once
+    const files = new Set(GENERATED_FILES);
+    if (config.packageManager === "pnpm")
+        files.add("pnpm-workspace.yaml");
+    for (const module of modules) {
+        for (const file of await (0, fileProcessor_1.listModuleFiles)(module.path))
+            files.add(file);
+    }
+    const envVars = Object.fromEntries(Object.entries(mergedConfig.envVars).map(([key, value]) => [
+        key,
+        configGenerator_1.GENERATED_SECRETS.includes(key) ? "<random secret>" : value,
+    ]));
+    const commands = [];
+    if (config.installDeps)
+        commands.push(`${config.packageManager} install`);
+    if (config.initGit &&
+        !(0, gitInitializer_1.isInsideGitRepository)(await findExistingDirectory(targetDir))) {
+        commands.push("git init");
+    }
+    return {
+        ...mergedConfig,
+        envVars,
+        files: [...files].sort((a, b) => a.localeCompare(b)),
+        commands,
+    };
+}

package/dist/builder/configGenerator.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GENERATED_SECRETS = void 0;
 exports.processScriptVariables = processScriptVariables;
 exports.mergeConfigurations = mergeConfigurations;
 exports.generatePackageJson = generatePackageJson;
@@ -12,8 +13,15 @@ exports.generateEnvFile = generateEnvFile;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handlebars_1 = __importDefault(require("handlebars"));
 const node_crypto_1 = require("node:crypto");
-const path_1 = __importDefault(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 const types_1 = require("../types");
+// Frameworks whose generated project uses ES modules
+const ESM_FRAMEWORKS = ["tanstack", "nestjs"];
+// Compiled entry file of each backend framework
+const BACKEND_ENTRY_FILES = {
+    express: "dist/index.js",
+    nestjs: "dist/main.js",
+};
 // Replaces Handlebars variables within script command strings
 function processScriptVariables(scripts, context) {
     const processedScripts = {};
@@ -67,21 +75,21 @@ async function generatePackageJson(targetDir, mergedConfig, config) {
                 node: config.framework === "tanstack" ? ">=24.20.0" : ">=24.0.0",
             },
             description: `Project created with better-ts-stack using ${config.database !== "none" ? config.database : "no database"}`,
-            ...(config.framework === "tanstack" ? { type: "module" } : {}),
-            ...(isFullstack ? {} : { main: "dist/index.js" }),
+            ...(ESM_FRAMEWORKS.includes(config.framework) ? { type: "module" } : {}),
+            ...(isFullstack ? {} : { main: BACKEND_ENTRY_FILES[config.framework] }),
             scripts: mergedConfig.scripts,
             keywords: isFullstack
                 ? config.framework === "tanstack"
                     ? ["tanstack-start", "react", "typescript"]
                     : ["nextjs", "react", "typescript"]
-                : ["backend", "typescript", "express"],
+                : ["backend", "typescript", config.framework],
             author: "",
             license: "MIT",
             dependencies: mergedConfig.dependencies,
             devDependencies: mergedConfig.devDependencies,
             overrides,
         };
-        const packageJsonPath = path_1.default.join(targetDir, "package.json");
+        const packageJsonPath = node_path_1.default.join(targetDir, "package.json");
         await fs_extra_1.default.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n", "utf-8");
     }
     catch (error) {
@@ -117,12 +125,14 @@ async function generatePnpmWorkspace(targetDir, overrides) {
         lines.push(`  - "${name}"`);
     }
     try {
-        await fs_extra_1.default.writeFile(path_1.default.join(targetDir, "pnpm-workspace.yaml"), lines.join("\n") + "\n", "utf-8");
+        await fs_extra_1.default.writeFile(node_path_1.default.join(targetDir, "pnpm-workspace.yaml"), lines.join("\n") + "\n", "utf-8");
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "PNPM_WORKSPACE_ERROR", "Failed to generate pnpm-workspace.yaml");
     }
 }
+// Variables that get a random value in .env instead of the module's default
+exports.GENERATED_SECRETS = ["JWT_SECRET", "BETTER_AUTH_SECRET"];
 // Generates .env and .env.example files from merged environment variables
 async function generateEnvFile(targetDir, envVars) {
     try {
@@ -133,21 +143,20 @@ async function generateEnvFile(targetDir, envVars) {
         let localEnvContent = envContent;
         // Add each environment variable
         for (const [key, value] of Object.entries(envVars)) {
-            const resolvedValue = ["JWT_SECRET", "BETTER_AUTH_SECRET"].includes(key)
+            const resolvedValue = exports.GENERATED_SECRETS.includes(key)
                 ? (0, node_crypto_1.randomBytes)(32).toString("hex")
                 : value;
             envContent += `${key}=${value}\n`;
             localEnvContent += `${key}=${resolvedValue}\n`;
         }
         // Write .env.example
-        const envExamplePath = path_1.default.join(targetDir, ".env.example");
+        const envExamplePath = node_path_1.default.join(targetDir, ".env.example");
         await fs_extra_1.default.writeFile(envExamplePath, envContent, "utf-8");
         // Keep generated secrets out of the shareable example file.
-        const envPath = path_1.default.join(targetDir, ".env");
+        const envPath = node_path_1.default.join(targetDir, ".env");
         await fs_extra_1.default.writeFile(envPath, localEnvContent, "utf-8");
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "ENV_FILE_ERROR", "Failed to generate environment files");
     }
 }
-//# sourceMappingURL=configGenerator.js.map

package/dist/builder/dependencyInstaller.js

@@ -1,30 +1,23 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.installDependencies = installDependencies;
-const child_process_1 = require("child_process");
-const consola_1 = __importDefault(require("consola"));
+const node_child_process_1 = require("node:child_process");
+const ui_1 = require("../ui");
 // Installs project dependencies in the target directory
 function installDependencies(packageManager, cwd) {
     const command = `${packageManager} install`;
-    consola_1.default.info(`Installing dependencies with ${packageManager}...`);
-    consola_1.default.debug(`Running: ${command}`);
+    (0, ui_1.info)(`Installing dependencies with ${packageManager}`);
     try {
-        (0, child_process_1.execSync)(command, {
+        (0, node_child_process_1.execSync)(command, {
             cwd,
             stdio: "inherit", // Show installation progress in real-time
         });
-        consola_1.default.success("Dependencies installed successfully");
+        (0, ui_1.success)("Dependencies installed");
         return true;
     }
-    catch (error) {
-        // Display helpful error message but don't throw - allow building to continue
-        consola_1.default.warn("Failed to install dependencies");
-        consola_1.default.debug(`Error: ${error instanceof Error ? error.message : String(error)}`);
-        consola_1.default.info(`You can install dependencies manually later by running: ${command}`);
+    catch {
+        // Not fatal: the project is complete and the install can be run later
+        (0, ui_1.warn)(`Could not install dependencies. Run "${command}" yourself.`);
         return false;
     }
 }
-//# sourceMappingURL=dependencyInstaller.js.map

package/dist/builder/fileProcessor.js

@@ -4,18 +4,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.copyModuleFiles = copyModuleFiles;
+exports.listModuleFiles = listModuleFiles;
 exports.compileTemplate = compileTemplate;
 exports.processTemplateFiles = processTemplateFiles;
-exports.processTemplateFile = processTemplateFile;
 // Utilities for copying files and processing Handlebars templates
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handlebars_1 = __importDefault(require("handlebars"));
-const path_1 = __importDefault(require("path"));
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
 const types_1 = require("../types");
+const TEMPLATE_EXTENSION = ".hbs";
+const MODULE_CONFIG_FILE = "config.json";
+// Names a template's .gitignore can be stored under, see restoreGitignore()
+const GITIGNORE_TEMPLATE_NAMES = ["gitignore", ".npmignore"];
 async function restoreGitignore(targetDir) {
-    const templateGitignorePath = path_1.default.join(targetDir, "gitignore");
-    const npmIgnorePath = path_1.default.join(targetDir, ".npmignore");
-    const gitIgnorePath = path_1.default.join(targetDir, ".gitignore");
+    const templateGitignorePath = node_path_1.default.join(targetDir, "gitignore");
+    const npmIgnorePath = node_path_1.default.join(targetDir, ".npmignore");
+    const gitIgnorePath = node_path_1.default.join(targetDir, ".gitignore");
     const [hasTemplateGitignore, hasNpmIgnore, hasGitIgnore] = await Promise.all([
         fs_extra_1.default.pathExists(templateGitignorePath),
         fs_extra_1.default.pathExists(npmIgnorePath),
@@ -41,8 +46,8 @@ async function copyModuleFiles(moduleDir, targetDir) {
             overwrite: true,
             filter: (src) => {
                 // Skip config.json files
-                const basename = path_1.default.basename(src);
-                return basename !== "config.json";
+                const basename = node_path_1.default.basename(src);
+                return basename !== MODULE_CONFIG_FILE;
             },
         });
         await restoreGitignore(targetDir);
@@ -51,58 +56,56 @@ async function copyModuleFiles(moduleDir, targetDir) {
         throw (0, types_1.buildError)(error, "FILE_COPY_ERROR", `Failed to copy module files from ${moduleDir}`);
     }
 }
+// Lists the files a module adds to a project, under the names they end up
+// with: no .hbs extension, and the gitignore template as .gitignore
+async function listModuleFiles(moduleDir) {
+    const entries = await (0, promises_1.readdir)(moduleDir, {
+        recursive: true,
+        withFileTypes: true,
+    });
+    return entries
+        .filter((entry) => entry.isFile() && entry.name !== MODULE_CONFIG_FILE)
+        .map((entry) => {
+        const file = node_path_1.default
+            .relative(moduleDir, node_path_1.default.join(entry.parentPath, entry.name))
+            .split(node_path_1.default.sep)
+            .join("/");
+        if (GITIGNORE_TEMPLATE_NAMES.includes(file))
+            return ".gitignore";
+        return file.endsWith(TEMPLATE_EXTENSION)
+            ? file.slice(0, -TEMPLATE_EXTENSION.length)
+            : file;
+    });
+}
 // Compiles and renders template content with Handlebars and provided context
 function compileTemplate(content, context) {
     try {
-        // Register helper functions with Handlebars
-        Object.entries(context.helpers).forEach(([name, fn]) => {
-            handlebars_1.default.registerHelper(name, fn);
-        });
-        // Compile the template
-        const template = handlebars_1.default.compile(content);
-        // Render with context
-        return template(context);
+        // The output is source code, not HTML, so values are written unescaped
+        const template = handlebars_1.default.compile(content, { noEscape: true });
+        return template(context, { helpers: context.helpers });
     }
     catch (error) {
         throw (0, types_1.buildError)(error, "TEMPLATE_SYNTAX_ERROR", "Failed to compile Handlebars template");
     }
 }
-// Processes multiple template files by replacing variables and handling extensions
-async function processTemplateFiles(targetDir, context, templateFiles) {
-    for (const templateFile of templateFiles) {
-        await processTemplateFile(path_1.default.join(targetDir, templateFile), context);
+// Renders every .hbs file in the project and removes the .hbs extension
+async function processTemplateFiles(targetDir, context) {
+    const files = await (0, promises_1.readdir)(targetDir, { recursive: true });
+    for (const file of files) {
+        if (file.endsWith(TEMPLATE_EXTENSION)) {
+            await processTemplateFile(node_path_1.default.join(targetDir, file), context);
+        }
     }
 }
-// Processes a single template file, replaces variables, and renames/deletes .hbs files
+// Renders a single .hbs file next to itself and deletes the template
 async function processTemplateFile(filePath, context) {
     try {
-        // Check if file exists
-        const exists = await fs_extra_1.default.pathExists(filePath);
-        if (!exists) {
-            return; // Skip if file doesn't exist
-        }
-        // Read template file
         const content = await fs_extra_1.default.readFile(filePath, "utf-8");
-        // Compile and render template with Handlebars
         const rendered = compileTemplate(content, context);
-        // Determine output path (remove .hbs extension if present)
-        const outputPath = filePath.endsWith(".hbs")
-            ? filePath.slice(0, -4)
-            : filePath;
-        // Write processed content
-        await fs_extra_1.default.writeFile(outputPath, rendered, "utf-8");
-        // Remove original .hbs file if it was renamed
-        if (outputPath !== filePath) {
-            await fs_extra_1.default.remove(filePath);
-        }
+        await fs_extra_1.default.writeFile(filePath.slice(0, -TEMPLATE_EXTENSION.length), rendered, "utf-8");
+        await fs_extra_1.default.remove(filePath);
     }
     catch (error) {
-        // Re-throw BuildErrors as-is
-        if (error && typeof error === "object" && "code" in error) {
-            throw error;
-        }
-        // Wrap other errors
-        throw (0, types_1.buildError)(error, "TEMPLATE_WRITE_ERROR", `Failed to process template file ${filePath}`);
+        throw (0, types_1.buildError)(error, "TEMPLATE_PROCESSING_ERROR", `Failed to process template file ${filePath}`);
     }
 }
-//# sourceMappingURL=fileProcessor.js.map