create-gen-app 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Dan Lynch <pyramation@gmail.com>
+
+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

@@ -0,0 +1,150 @@
+# create-gen-app
+
+<p align="center" width="100%">
+    <img height="90" src="https://user-images.githubusercontent.com/545047/190171475-b416f99e-2831-4786-9ba3-a7ff4d95b0d3.svg" />
+</p>
+
+<p align="center" width="100%">
+  
+  <a href="https://github.com/pyramation/inquirerer/actions/workflows/run-tests.yml">
+    <img height="20" src="https://github.com/pyramation/inquirerer/actions/workflows/run-tests.yml/badge.svg" />
+  </a>
+   <a href="https://github.com/pyramation/inquirerer/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
+   <a href="https://www.npmjs.com/package/inquirerer"><img height="20" src="https://img.shields.io/npm/dt/inquirerer"></a>
+   <a href="https://www.npmjs.com/package/inquirerer"><img height="20" src="https://img.shields.io/github/package-json/v/pyramation/inquirerer?filename=packages%2Finquirerer%2Fpackage.json"></a>
+</p>
+
+A TypeScript library for cloning and customizing template repositories with variable replacement.
+
+## Features
+
+- Clone GitHub repositories or any git URL
+- Extract template variables from filenames and file contents using `__VARIABLE__` syntax
+- Load custom questions from `.questions.json` or `.questions.js` files
+- Interactive prompts using inquirerer with CLI argument support
+- Stream-based file processing for efficient variable replacement
+
+## Installation
+
+```bash
+npm install create-gen-app
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { createGen } from 'create-gen-app';
+
+await createGen({
+  templateUrl: 'https://github.com/user/template-repo',
+  outputDir: './my-new-project',
+  argv: {
+    PROJECT_NAME: 'my-project',
+    AUTHOR: 'John Doe'
+  }
+});
+```
+
+### Template Variables
+
+Variables in your template should be wrapped in double underscores:
+
+**Filename variables:**
+```
+__PROJECT_NAME__/
+  __MODULE_NAME__.ts
+```
+
+**Content variables:**
+```typescript
+// __MODULE_NAME__.ts
+export const projectName = "__PROJECT_NAME__";
+export const author = "__AUTHOR__";
+```
+
+### Custom Questions
+
+Create a `.questions.json` file in your template repository:
+
+```json
+{
+  "questions": [
+    {
+      "name": "PROJECT_NAME",
+      "type": "text",
+      "message": "What is your project name?",
+      "required": true
+    },
+    {
+      "name": "AUTHOR",
+      "type": "text",
+      "message": "Who is the author?"
+    }
+  ]
+}
+```
+
+Or use `.questions.js` for dynamic questions:
+
+```javascript
+/**
+ * @typedef {Object} Questions
+ * @property {Array} questions - Array of question objects
+ */
+
+module.exports = {
+  questions: [
+    {
+      name: 'PROJECT_NAME',
+      type: 'text',
+      message: 'What is your project name?',
+      required: true
+    }
+  ]
+};
+```
+
+## API
+
+### `createGen(options: CreateGenOptions): Promise<string>`
+
+Main function to create a project from a template.
+
+**Options:**
+- `templateUrl` (string): URL or path to the template repository
+- `outputDir` (string): Destination directory for the generated project
+- `argv` (Record<string, any>): Command-line arguments to pre-populate answers
+- `noTty` (boolean): Whether to disable TTY mode for non-interactive usage
+
+### `extractVariables(templateDir: string): Promise<ExtractedVariables>`
+
+Extract all variables from a template directory.
+
+### `promptUser(extractedVariables: ExtractedVariables, argv?: Record<string, any>, noTty?: boolean): Promise<Record<string, any>>`
+
+Prompt the user for variable values using inquirerer.
+
+### `replaceVariables(templateDir: string, outputDir: string, extractedVariables: ExtractedVariables, answers: Record<string, any>): Promise<void>`
+
+Replace variables in all files and filenames.
+
+## Variable Naming Rules
+
+Variables can contain:
+- Letters (a-z, A-Z)
+- Numbers (0-9)
+- Underscores (_)
+- Must start with a letter or underscore
+
+Examples of valid variables:
+- `__PROJECT_NAME__`
+- `__author__`
+- `__CamelCase__`
+- `__snake_case__`
+- `__VERSION_1__`
+
+## License
+
+MIT

package/clone.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clone a repository to a temporary directory
+ * @param url - Repository URL (GitHub or any git URL)
+ * @returns Path to the cloned repository
+ */
+export declare function cloneRepo(url: string): Promise<string>;

package/clone.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneRepo = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Clone a repository to a temporary directory
+ * @param url - Repository URL (GitHub or any git URL)
+ * @returns Path to the cloned repository
+ */
+async function cloneRepo(url) {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'create-gen-'));
+    try {
+        const gitUrl = normalizeGitUrl(url);
+        (0, child_process_1.execSync)(`git clone ${gitUrl} ${tempDir}`, {
+            stdio: 'inherit'
+        });
+        const gitDir = path.join(tempDir, '.git');
+        if (fs.existsSync(gitDir)) {
+            fs.rmSync(gitDir, { recursive: true, force: true });
+        }
+        return tempDir;
+    }
+    catch (error) {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to clone repository: ${errorMessage}`);
+    }
+}
+exports.cloneRepo = cloneRepo;
+/**
+ * Normalize a URL to a git-cloneable format
+ * @param url - Input URL
+ * @returns Normalized git URL
+ */
+function normalizeGitUrl(url) {
+    if (url.startsWith('git@') || url.startsWith('https://') || url.startsWith('http://')) {
+        return url;
+    }
+    if (/^[\w-]+\/[\w-]+$/.test(url)) {
+        return `https://github.com/${url}.git`;
+    }
+    return url;
+}

package/esm/clone.js

@@ -0,0 +1,44 @@
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+/**
+ * Clone a repository to a temporary directory
+ * @param url - Repository URL (GitHub or any git URL)
+ * @returns Path to the cloned repository
+ */
+export async function cloneRepo(url) {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'create-gen-'));
+    try {
+        const gitUrl = normalizeGitUrl(url);
+        execSync(`git clone ${gitUrl} ${tempDir}`, {
+            stdio: 'inherit'
+        });
+        const gitDir = path.join(tempDir, '.git');
+        if (fs.existsSync(gitDir)) {
+            fs.rmSync(gitDir, { recursive: true, force: true });
+        }
+        return tempDir;
+    }
+    catch (error) {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to clone repository: ${errorMessage}`);
+    }
+}
+/**
+ * Normalize a URL to a git-cloneable format
+ * @param url - Input URL
+ * @returns Normalized git URL
+ */
+function normalizeGitUrl(url) {
+    if (url.startsWith('git@') || url.startsWith('https://') || url.startsWith('http://')) {
+        return url;
+    }
+    if (/^[\w-]+\/[\w-]+$/.test(url)) {
+        return `https://github.com/${url}.git`;
+    }
+    return url;
+}

package/esm/extract.js

@@ -0,0 +1,140 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Pattern to match __VARIABLE__ in filenames and content
+ */
+const VARIABLE_PATTERN = /__([A-Za-z_][A-Za-z0-9_]*)__/g;
+/**
+ * Extract all variables from a template directory
+ * @param templateDir - Path to the template directory
+ * @returns Extracted variables including file replacers, content replacers, and project questions
+ */
+export async function extractVariables(templateDir) {
+    const fileReplacers = [];
+    const contentReplacers = [];
+    const fileReplacerVars = new Set();
+    const contentReplacerVars = new Set();
+    const projectQuestions = await loadProjectQuestions(templateDir);
+    await walkDirectory(templateDir, async (filePath) => {
+        const relativePath = path.relative(templateDir, filePath);
+        if (relativePath === '.questions.json' || relativePath === '.questions.js') {
+            return;
+        }
+        const matches = relativePath.matchAll(VARIABLE_PATTERN);
+        for (const match of matches) {
+            const varName = match[1];
+            if (!fileReplacerVars.has(varName)) {
+                fileReplacerVars.add(varName);
+                fileReplacers.push({
+                    variable: varName,
+                    pattern: new RegExp(`__${varName}__`, 'g')
+                });
+            }
+        }
+        const contentVars = await extractFromFileContent(filePath);
+        for (const varName of contentVars) {
+            if (!contentReplacerVars.has(varName)) {
+                contentReplacerVars.add(varName);
+                contentReplacers.push({
+                    variable: varName,
+                    pattern: new RegExp(`__${varName}__`, 'g')
+                });
+            }
+        }
+    });
+    return {
+        fileReplacers,
+        contentReplacers,
+        projectQuestions
+    };
+}
+/**
+ * Extract variables from file content using streams
+ * @param filePath - Path to the file
+ * @returns Set of variable names found in the file
+ */
+async function extractFromFileContent(filePath) {
+    const variables = new Set();
+    return new Promise((resolve) => {
+        const stream = fs.createReadStream(filePath, { encoding: 'utf8' });
+        let buffer = '';
+        stream.on('data', (chunk) => {
+            buffer += chunk.toString();
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep the last incomplete line in buffer
+            for (const line of lines) {
+                const matches = line.matchAll(VARIABLE_PATTERN);
+                for (const match of matches) {
+                    variables.add(match[1]);
+                }
+            }
+        });
+        stream.on('end', () => {
+            const matches = buffer.matchAll(VARIABLE_PATTERN);
+            for (const match of matches) {
+                variables.add(match[1]);
+            }
+            resolve(variables);
+        });
+        stream.on('error', () => {
+            resolve(variables);
+        });
+    });
+}
+/**
+ * Walk through a directory recursively
+ * @param dir - Directory to walk
+ * @param callback - Callback function for each file
+ */
+async function walkDirectory(dir, callback) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkDirectory(fullPath, callback);
+        }
+        else if (entry.isFile()) {
+            await callback(fullPath);
+        }
+    }
+}
+/**
+ * Load project questions from .questions.json or .questions.js
+ * @param templateDir - Path to the template directory
+ * @returns Questions object or null if not found
+ */
+async function loadProjectQuestions(templateDir) {
+    const jsonPath = path.join(templateDir, '.questions.json');
+    if (fs.existsSync(jsonPath)) {
+        try {
+            const content = fs.readFileSync(jsonPath, 'utf8');
+            const questions = JSON.parse(content);
+            return validateQuestions(questions) ? questions : null;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`Failed to parse .questions.json: ${errorMessage}`);
+        }
+    }
+    const jsPath = path.join(templateDir, '.questions.js');
+    if (fs.existsSync(jsPath)) {
+        try {
+            const module = require(jsPath);
+            const questions = module.default || module;
+            return validateQuestions(questions) ? questions : null;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`Failed to load .questions.js: ${errorMessage}`);
+        }
+    }
+    return null;
+}
+/**
+ * Validate that the questions object has the correct structure
+ * @param obj - Object to validate
+ * @returns True if valid, false otherwise
+ */
+function validateQuestions(obj) {
+    return obj && typeof obj === 'object' && Array.isArray(obj.questions);
+}

package/esm/index.js

@@ -0,0 +1,40 @@
+import * as fs from 'fs';
+import { cloneRepo } from './clone';
+import { extractVariables } from './extract';
+import { promptUser } from './prompt';
+import { replaceVariables } from './replace';
+export * from './clone';
+export * from './extract';
+export * from './prompt';
+export * from './replace';
+export * from './types';
+/**
+ * Create a new project from a template repository
+ * @param options - Options for creating the project
+ * @returns Path to the generated project
+ */
+export async function createGen(options) {
+    const { templateUrl, outputDir, argv = {}, noTty = false } = options;
+    console.log(`Cloning template from ${templateUrl}...`);
+    const tempDir = await cloneRepo(templateUrl);
+    try {
+        console.log('Extracting template variables...');
+        const extractedVariables = await extractVariables(tempDir);
+        console.log(`Found ${extractedVariables.fileReplacers.length} file replacers`);
+        console.log(`Found ${extractedVariables.contentReplacers.length} content replacers`);
+        if (extractedVariables.projectQuestions) {
+            console.log(`Found ${extractedVariables.projectQuestions.questions.length} project questions`);
+        }
+        console.log('Prompting for variable values...');
+        const answers = await promptUser(extractedVariables, argv, noTty);
+        console.log(`Generating project in ${outputDir}...`);
+        await replaceVariables(tempDir, outputDir, extractedVariables, answers);
+        console.log('Project created successfully!');
+        return outputDir;
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+}

package/esm/prompt.js

@@ -0,0 +1,57 @@
+import { Inquirerer } from 'inquirerer';
+/**
+ * Generate questions from extracted variables
+ * @param extractedVariables - Variables extracted from the template
+ * @returns Array of questions to prompt the user
+ */
+export function generateQuestions(extractedVariables) {
+    const questions = [];
+    const askedVariables = new Set();
+    if (extractedVariables.projectQuestions) {
+        for (const question of extractedVariables.projectQuestions.questions) {
+            questions.push(question);
+            askedVariables.add(question.name);
+        }
+    }
+    for (const replacer of extractedVariables.fileReplacers) {
+        if (!askedVariables.has(replacer.variable)) {
+            questions.push({
+                name: replacer.variable,
+                type: 'text',
+                message: `Enter value for ${replacer.variable}:`,
+                required: true
+            });
+            askedVariables.add(replacer.variable);
+        }
+    }
+    for (const replacer of extractedVariables.contentReplacers) {
+        if (!askedVariables.has(replacer.variable)) {
+            questions.push({
+                name: replacer.variable,
+                type: 'text',
+                message: `Enter value for ${replacer.variable}:`,
+                required: true
+            });
+            askedVariables.add(replacer.variable);
+        }
+    }
+    return questions;
+}
+/**
+ * Prompt the user for variable values
+ * @param extractedVariables - Variables extracted from the template
+ * @param argv - Command-line arguments to pre-populate answers
+ * @param noTty - Whether to disable TTY mode
+ * @returns Answers from the user
+ */
+export async function promptUser(extractedVariables, argv = {}, noTty = false) {
+    const questions = generateQuestions(extractedVariables);
+    if (questions.length === 0) {
+        return argv;
+    }
+    const prompter = new Inquirerer({
+        noTty
+    });
+    const answers = await prompter.prompt(argv, questions);
+    return answers;
+}

package/esm/replace.js

@@ -0,0 +1,82 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { Transform } from 'stream';
+import { pipeline } from 'stream/promises';
+/**
+ * Replace variables in all files in the template directory
+ * @param templateDir - Path to the template directory
+ * @param outputDir - Path to the output directory
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ */
+export async function replaceVariables(templateDir, outputDir, extractedVariables, answers) {
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    await walkAndReplace(templateDir, outputDir, extractedVariables, answers);
+}
+/**
+ * Walk through directory and replace variables in files and filenames
+ * @param sourceDir - Source directory
+ * @param destDir - Destination directory
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ * @param sourceRelativePath - Current relative path in source (for recursion)
+ * @param destRelativePath - Current relative path in destination (for recursion)
+ */
+async function walkAndReplace(sourceDir, destDir, extractedVariables, answers, sourceRelativePath = '', destRelativePath = '') {
+    const currentSource = path.join(sourceDir, sourceRelativePath);
+    const entries = fs.readdirSync(currentSource, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourceEntryPath = path.join(currentSource, entry.name);
+        if (entry.name === '.questions.json' || entry.name === '.questions.js') {
+            continue;
+        }
+        let newName = entry.name;
+        for (const replacer of extractedVariables.fileReplacers) {
+            if (answers[replacer.variable] !== undefined) {
+                newName = newName.replace(replacer.pattern, String(answers[replacer.variable]));
+            }
+        }
+        const destEntryPath = path.join(destDir, destRelativePath, newName);
+        if (entry.isDirectory()) {
+            if (!fs.existsSync(destEntryPath)) {
+                fs.mkdirSync(destEntryPath, { recursive: true });
+            }
+            await walkAndReplace(sourceDir, destDir, extractedVariables, answers, path.join(sourceRelativePath, entry.name), path.join(destRelativePath, newName));
+        }
+        else if (entry.isFile()) {
+            await replaceInFile(sourceEntryPath, destEntryPath, extractedVariables, answers);
+        }
+    }
+}
+/**
+ * Replace variables in a file using streams
+ * @param sourcePath - Source file path
+ * @param destPath - Destination file path
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ */
+async function replaceInFile(sourcePath, destPath, extractedVariables, answers) {
+    const destDir = path.dirname(destPath);
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    const replaceTransform = new Transform({
+        transform(chunk, encoding, callback) {
+            let content = chunk.toString();
+            for (const replacer of extractedVariables.contentReplacers) {
+                if (answers[replacer.variable] !== undefined) {
+                    content = content.replace(replacer.pattern, String(answers[replacer.variable]));
+                }
+            }
+            callback(null, Buffer.from(content));
+        }
+    });
+    try {
+        await pipeline(fs.createReadStream(sourcePath), replaceTransform, fs.createWriteStream(destPath));
+    }
+    catch (error) {
+        fs.copyFileSync(sourcePath, destPath);
+    }
+}

package/esm/types.js

@@ -0,0 +1 @@
+export {};

package/extract.d.ts

@@ -0,0 +1,7 @@
+import { ExtractedVariables } from './types';
+/**
+ * Extract all variables from a template directory
+ * @param templateDir - Path to the template directory
+ * @returns Extracted variables including file replacers, content replacers, and project questions
+ */
+export declare function extractVariables(templateDir: string): Promise<ExtractedVariables>;

package/extract.js

@@ -0,0 +1,167 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractVariables = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Pattern to match __VARIABLE__ in filenames and content
+ */
+const VARIABLE_PATTERN = /__([A-Za-z_][A-Za-z0-9_]*)__/g;
+/**
+ * Extract all variables from a template directory
+ * @param templateDir - Path to the template directory
+ * @returns Extracted variables including file replacers, content replacers, and project questions
+ */
+async function extractVariables(templateDir) {
+    const fileReplacers = [];
+    const contentReplacers = [];
+    const fileReplacerVars = new Set();
+    const contentReplacerVars = new Set();
+    const projectQuestions = await loadProjectQuestions(templateDir);
+    await walkDirectory(templateDir, async (filePath) => {
+        const relativePath = path.relative(templateDir, filePath);
+        if (relativePath === '.questions.json' || relativePath === '.questions.js') {
+            return;
+        }
+        const matches = relativePath.matchAll(VARIABLE_PATTERN);
+        for (const match of matches) {
+            const varName = match[1];
+            if (!fileReplacerVars.has(varName)) {
+                fileReplacerVars.add(varName);
+                fileReplacers.push({
+                    variable: varName,
+                    pattern: new RegExp(`__${varName}__`, 'g')
+                });
+            }
+        }
+        const contentVars = await extractFromFileContent(filePath);
+        for (const varName of contentVars) {
+            if (!contentReplacerVars.has(varName)) {
+                contentReplacerVars.add(varName);
+                contentReplacers.push({
+                    variable: varName,
+                    pattern: new RegExp(`__${varName}__`, 'g')
+                });
+            }
+        }
+    });
+    return {
+        fileReplacers,
+        contentReplacers,
+        projectQuestions
+    };
+}
+exports.extractVariables = extractVariables;
+/**
+ * Extract variables from file content using streams
+ * @param filePath - Path to the file
+ * @returns Set of variable names found in the file
+ */
+async function extractFromFileContent(filePath) {
+    const variables = new Set();
+    return new Promise((resolve) => {
+        const stream = fs.createReadStream(filePath, { encoding: 'utf8' });
+        let buffer = '';
+        stream.on('data', (chunk) => {
+            buffer += chunk.toString();
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep the last incomplete line in buffer
+            for (const line of lines) {
+                const matches = line.matchAll(VARIABLE_PATTERN);
+                for (const match of matches) {
+                    variables.add(match[1]);
+                }
+            }
+        });
+        stream.on('end', () => {
+            const matches = buffer.matchAll(VARIABLE_PATTERN);
+            for (const match of matches) {
+                variables.add(match[1]);
+            }
+            resolve(variables);
+        });
+        stream.on('error', () => {
+            resolve(variables);
+        });
+    });
+}
+/**
+ * Walk through a directory recursively
+ * @param dir - Directory to walk
+ * @param callback - Callback function for each file
+ */
+async function walkDirectory(dir, callback) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkDirectory(fullPath, callback);
+        }
+        else if (entry.isFile()) {
+            await callback(fullPath);
+        }
+    }
+}
+/**
+ * Load project questions from .questions.json or .questions.js
+ * @param templateDir - Path to the template directory
+ * @returns Questions object or null if not found
+ */
+async function loadProjectQuestions(templateDir) {
+    const jsonPath = path.join(templateDir, '.questions.json');
+    if (fs.existsSync(jsonPath)) {
+        try {
+            const content = fs.readFileSync(jsonPath, 'utf8');
+            const questions = JSON.parse(content);
+            return validateQuestions(questions) ? questions : null;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`Failed to parse .questions.json: ${errorMessage}`);
+        }
+    }
+    const jsPath = path.join(templateDir, '.questions.js');
+    if (fs.existsSync(jsPath)) {
+        try {
+            const module = require(jsPath);
+            const questions = module.default || module;
+            return validateQuestions(questions) ? questions : null;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`Failed to load .questions.js: ${errorMessage}`);
+        }
+    }
+    return null;
+}
+/**
+ * Validate that the questions object has the correct structure
+ * @param obj - Object to validate
+ * @returns True if valid, false otherwise
+ */
+function validateQuestions(obj) {
+    return obj && typeof obj === 'object' && Array.isArray(obj.questions);
+}

package/index.d.ts

@@ -0,0 +1,12 @@
+import { CreateGenOptions } from './types';
+export * from './clone';
+export * from './extract';
+export * from './prompt';
+export * from './replace';
+export * from './types';
+/**
+ * Create a new project from a template repository
+ * @param options - Options for creating the project
+ * @returns Path to the generated project
+ */
+export declare function createGen(options: CreateGenOptions): Promise<string>;

package/index.js

@@ -0,0 +1,70 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGen = void 0;
+const fs = __importStar(require("fs"));
+const clone_1 = require("./clone");
+const extract_1 = require("./extract");
+const prompt_1 = require("./prompt");
+const replace_1 = require("./replace");
+__exportStar(require("./clone"), exports);
+__exportStar(require("./extract"), exports);
+__exportStar(require("./prompt"), exports);
+__exportStar(require("./replace"), exports);
+__exportStar(require("./types"), exports);
+/**
+ * Create a new project from a template repository
+ * @param options - Options for creating the project
+ * @returns Path to the generated project
+ */
+async function createGen(options) {
+    const { templateUrl, outputDir, argv = {}, noTty = false } = options;
+    console.log(`Cloning template from ${templateUrl}...`);
+    const tempDir = await (0, clone_1.cloneRepo)(templateUrl);
+    try {
+        console.log('Extracting template variables...');
+        const extractedVariables = await (0, extract_1.extractVariables)(tempDir);
+        console.log(`Found ${extractedVariables.fileReplacers.length} file replacers`);
+        console.log(`Found ${extractedVariables.contentReplacers.length} content replacers`);
+        if (extractedVariables.projectQuestions) {
+            console.log(`Found ${extractedVariables.projectQuestions.questions.length} project questions`);
+        }
+        console.log('Prompting for variable values...');
+        const answers = await (0, prompt_1.promptUser)(extractedVariables, argv, noTty);
+        console.log(`Generating project in ${outputDir}...`);
+        await (0, replace_1.replaceVariables)(tempDir, outputDir, extractedVariables, answers);
+        console.log('Project created successfully!');
+        return outputDir;
+    }
+    finally {
+        if (fs.existsSync(tempDir)) {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+    }
+}
+exports.createGen = createGen;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "create-gen-app",
+  "version": "0.1.0",
+  "author": "Dan Lynch <pyramation@gmail.com>",
+  "description": "Clone and customize template repositories",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "homepage": "https://github.com/pyramation/inquirerer",
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyramation/inquirerer"
+  },
+  "bugs": {
+    "url": "https://github.com/pyramation/inquirerer/issues"
+  },
+  "scripts": {
+    "copy": "copyfiles -f ../../LICENSE README.md package.json dist",
+    "clean": "del dist/**",
+    "prepare": "npm run build",
+    "build": "npm run clean; tsc; tsc -p tsconfig.esm.json; npm run copy",
+    "dev": "ts-node dev/index",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "inquirerer": "^2.1.0"
+  },
+  "keywords": [],
+  "gitHead": "e1b5c305be94ffa5f7c0664ad2d4e12f66ac046f"
+}

package/prompt.d.ts

@@ -0,0 +1,16 @@
+import { Question } from 'inquirerer';
+import { ExtractedVariables } from './types';
+/**
+ * Generate questions from extracted variables
+ * @param extractedVariables - Variables extracted from the template
+ * @returns Array of questions to prompt the user
+ */
+export declare function generateQuestions(extractedVariables: ExtractedVariables): Question[];
+/**
+ * Prompt the user for variable values
+ * @param extractedVariables - Variables extracted from the template
+ * @param argv - Command-line arguments to pre-populate answers
+ * @param noTty - Whether to disable TTY mode
+ * @returns Answers from the user
+ */
+export declare function promptUser(extractedVariables: ExtractedVariables, argv?: Record<string, any>, noTty?: boolean): Promise<Record<string, any>>;

package/prompt.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptUser = exports.generateQuestions = void 0;
+const inquirerer_1 = require("inquirerer");
+/**
+ * Generate questions from extracted variables
+ * @param extractedVariables - Variables extracted from the template
+ * @returns Array of questions to prompt the user
+ */
+function generateQuestions(extractedVariables) {
+    const questions = [];
+    const askedVariables = new Set();
+    if (extractedVariables.projectQuestions) {
+        for (const question of extractedVariables.projectQuestions.questions) {
+            questions.push(question);
+            askedVariables.add(question.name);
+        }
+    }
+    for (const replacer of extractedVariables.fileReplacers) {
+        if (!askedVariables.has(replacer.variable)) {
+            questions.push({
+                name: replacer.variable,
+                type: 'text',
+                message: `Enter value for ${replacer.variable}:`,
+                required: true
+            });
+            askedVariables.add(replacer.variable);
+        }
+    }
+    for (const replacer of extractedVariables.contentReplacers) {
+        if (!askedVariables.has(replacer.variable)) {
+            questions.push({
+                name: replacer.variable,
+                type: 'text',
+                message: `Enter value for ${replacer.variable}:`,
+                required: true
+            });
+            askedVariables.add(replacer.variable);
+        }
+    }
+    return questions;
+}
+exports.generateQuestions = generateQuestions;
+/**
+ * Prompt the user for variable values
+ * @param extractedVariables - Variables extracted from the template
+ * @param argv - Command-line arguments to pre-populate answers
+ * @param noTty - Whether to disable TTY mode
+ * @returns Answers from the user
+ */
+async function promptUser(extractedVariables, argv = {}, noTty = false) {
+    const questions = generateQuestions(extractedVariables);
+    if (questions.length === 0) {
+        return argv;
+    }
+    const prompter = new inquirerer_1.Inquirerer({
+        noTty
+    });
+    const answers = await prompter.prompt(argv, questions);
+    return answers;
+}
+exports.promptUser = promptUser;

package/replace.d.ts

@@ -0,0 +1,9 @@
+import { ExtractedVariables } from './types';
+/**
+ * Replace variables in all files in the template directory
+ * @param templateDir - Path to the template directory
+ * @param outputDir - Path to the output directory
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ */
+export declare function replaceVariables(templateDir: string, outputDir: string, extractedVariables: ExtractedVariables, answers: Record<string, any>): Promise<void>;

package/replace.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceVariables = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const stream_1 = require("stream");
+const promises_1 = require("stream/promises");
+/**
+ * Replace variables in all files in the template directory
+ * @param templateDir - Path to the template directory
+ * @param outputDir - Path to the output directory
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ */
+async function replaceVariables(templateDir, outputDir, extractedVariables, answers) {
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    await walkAndReplace(templateDir, outputDir, extractedVariables, answers);
+}
+exports.replaceVariables = replaceVariables;
+/**
+ * Walk through directory and replace variables in files and filenames
+ * @param sourceDir - Source directory
+ * @param destDir - Destination directory
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ * @param sourceRelativePath - Current relative path in source (for recursion)
+ * @param destRelativePath - Current relative path in destination (for recursion)
+ */
+async function walkAndReplace(sourceDir, destDir, extractedVariables, answers, sourceRelativePath = '', destRelativePath = '') {
+    const currentSource = path.join(sourceDir, sourceRelativePath);
+    const entries = fs.readdirSync(currentSource, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourceEntryPath = path.join(currentSource, entry.name);
+        if (entry.name === '.questions.json' || entry.name === '.questions.js') {
+            continue;
+        }
+        let newName = entry.name;
+        for (const replacer of extractedVariables.fileReplacers) {
+            if (answers[replacer.variable] !== undefined) {
+                newName = newName.replace(replacer.pattern, String(answers[replacer.variable]));
+            }
+        }
+        const destEntryPath = path.join(destDir, destRelativePath, newName);
+        if (entry.isDirectory()) {
+            if (!fs.existsSync(destEntryPath)) {
+                fs.mkdirSync(destEntryPath, { recursive: true });
+            }
+            await walkAndReplace(sourceDir, destDir, extractedVariables, answers, path.join(sourceRelativePath, entry.name), path.join(destRelativePath, newName));
+        }
+        else if (entry.isFile()) {
+            await replaceInFile(sourceEntryPath, destEntryPath, extractedVariables, answers);
+        }
+    }
+}
+/**
+ * Replace variables in a file using streams
+ * @param sourcePath - Source file path
+ * @param destPath - Destination file path
+ * @param extractedVariables - Variables extracted from the template
+ * @param answers - User answers for variable values
+ */
+async function replaceInFile(sourcePath, destPath, extractedVariables, answers) {
+    const destDir = path.dirname(destPath);
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    const replaceTransform = new stream_1.Transform({
+        transform(chunk, encoding, callback) {
+            let content = chunk.toString();
+            for (const replacer of extractedVariables.contentReplacers) {
+                if (answers[replacer.variable] !== undefined) {
+                    content = content.replace(replacer.pattern, String(answers[replacer.variable]));
+                }
+            }
+            callback(null, Buffer.from(content));
+        }
+    });
+    try {
+        await (0, promises_1.pipeline)(fs.createReadStream(sourcePath), replaceTransform, fs.createWriteStream(destPath));
+    }
+    catch (error) {
+        fs.copyFileSync(sourcePath, destPath);
+    }
+}

package/types.d.ts

@@ -0,0 +1,60 @@
+import { Question } from 'inquirerer';
+/**
+ * Questions configuration that can be loaded from .questions.json or .questions.js
+ * @typedef {Object} Questions
+ * @property {Question[]} questions - Array of inquirerer questions
+ */
+export interface Questions {
+    questions: Question[];
+}
+/**
+ * Variable extracted from filename patterns like __VARIABLE__
+ */
+export interface FileReplacer {
+    variable: string;
+    pattern: RegExp;
+}
+/**
+ * Variable extracted from file content patterns like __VARIABLE__
+ */
+export interface ContentReplacer {
+    variable: string;
+    pattern: RegExp;
+}
+/**
+ * Options for creating a new project from a template
+ */
+export interface CreateGenOptions {
+    /**
+     * URL or path to the template repository
+     */
+    templateUrl: string;
+    /**
+     * Destination directory for the generated project
+     */
+    outputDir: string;
+    /**
+     * Command-line arguments to pre-populate answers
+     */
+    argv?: Record<string, any>;
+    /**
+     * Whether to use TTY for interactive prompts
+     */
+    noTty?: boolean;
+}
+/**
+ * Result of extracting variables from a template
+ */
+export interface ExtractedVariables {
+    fileReplacers: FileReplacer[];
+    contentReplacers: ContentReplacer[];
+    projectQuestions: Questions | null;
+}
+/**
+ * Context for processing a template
+ */
+export interface TemplateContext {
+    tempDir: string;
+    extractedVariables: ExtractedVariables;
+    answers: Record<string, any>;
+}

package/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });