launchts 1.0.0

package/dist/generator.js

@@ -0,0 +1,302 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidProjectName = isValidProjectName;
+exports.createProject = createProject;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const child_process_1 = require("child_process");
+const configs_1 = require("./configs");
+const messages_1 = require("./messages");
+// Helper to run commands with consistent behavior
+function runCommand(command, args, cwd, verbose, silent = false) {
+    const result = (0, child_process_1.spawnSync)(command, args, {
+        cwd,
+        stdio: verbose ? 'inherit' : 'pipe',
+    });
+    // Log errors even in non-verbose mode for better debugging
+    // Skip logging if silent=true (for check commands like git rev-parse)
+    if (result.status !== 0 && !verbose && !silent && result.stderr) {
+        const stderrOutput = result.stderr.toString().trim();
+        if (stderrOutput) {
+            console.error(`Error running ${command}: ${stderrOutput}`);
+        }
+    }
+    return result.status === 0;
+}
+// Validate project name: alphanumeric, hyphens, underscores, 1-214 characters
+function isValidProjectName(name) {
+    if (!name || name.length > 214)
+        return false;
+    // Allow alphanumeric, hyphens, underscores, dots (but not starting with dot or dash)
+    if (/^[.-]/.test(name))
+        return false;
+    return /^[a-zA-Z0-9._-]+$/.test(name);
+}
+function minimalPackageJson(projectName) {
+    return {
+        name: projectName,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            build: 'tsc -p tsconfig.json',
+        },
+    };
+}
+function baseTsconfig() {
+    return {
+        compilerOptions: {
+            target: 'ESNext',
+            module: 'NodeNext',
+            moduleResolution: 'NodeNext',
+            declaration: true,
+            outDir: 'dist',
+            rootDir: 'src',
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            resolveJsonModule: true,
+            isolatedModules: true,
+        },
+    };
+}
+// Helper functions for README generation
+function generateReadmeHeader(projectName) {
+    return `# ${projectName}
+
+TypeScript project generated with [launchts](https://github.com/Jszigeti/launchts).
+
+## Getting Started
+`;
+}
+function generateReadmeScripts(toolOptions) {
+    let scripts = `### Development
+
+\`\`\`bash
+npm run build    # Compile TypeScript to JavaScript
+`;
+    if (toolOptions?.nodemon) {
+        scripts += `npm run dev      # Start development server with auto-reload\n`;
+    }
+    if (toolOptions?.eslint) {
+        scripts += `npm run lint     # Run ESLint\n`;
+    }
+    if (toolOptions?.prettier) {
+        scripts += `npm run format   # Format code with Prettier\n`;
+    }
+    scripts += `\`\`\`
+`;
+    return scripts;
+}
+function generateReadmeStructure(projectName, toolOptions) {
+    let structure = `### Project Structure
+
+\`\`\`
+${projectName}/
+├── src/
+│   └── index.ts       # Entry point
+├── dist/              # Compiled output (generated)
+├── tsconfig.json      # TypeScript configuration
+├── package.json       # Project dependencies and scripts
+`;
+    if (toolOptions?.eslint) {
+        structure += `├── eslint.config.js   # ESLint configuration (flat config)\n`;
+    }
+    if (toolOptions?.prettier) {
+        structure += `├── .prettierrc        # Prettier configuration\n`;
+    }
+    if (toolOptions?.husky) {
+        structure += `└── .husky/            # Git hooks\n`;
+    }
+    else {
+        structure += `└── ...\n`;
+    }
+    structure += `\`\`\`
+`;
+    return structure;
+}
+function generateReadmeTechStack(toolOptions) {
+    let techStack = `## Technology Stack
+
+- **TypeScript** - Type-safe JavaScript with ESNext target
+- **Node.js** - Runtime environment with ESM modules
+`;
+    if (toolOptions?.eslint) {
+        techStack += `- **ESLint** - Code quality and consistency with TypeScript support\n`;
+    }
+    if (toolOptions?.prettier) {
+        techStack += `- **Prettier** - Code formatting\n`;
+    }
+    if (toolOptions?.nodemon) {
+        techStack += `- **Nodemon** - Auto-reload during development\n`;
+    }
+    if (toolOptions?.husky) {
+        techStack += `- **Husky + lint-staged** - Pre-commit hooks for code quality\n`;
+    }
+    return techStack;
+}
+function generateReadmeScriptsDetails(toolOptions) {
+    let scriptsDetails = `
+## Scripts
+
+- \`npm run build\` - Compiles TypeScript files to JavaScript in the \`dist/\` directory
+`;
+    if (toolOptions?.nodemon) {
+        scriptsDetails += `- \`npm run dev\` - Starts the development server with auto-reload on file changes\n`;
+    }
+    if (toolOptions?.eslint) {
+        scriptsDetails += `- \`npm run lint\` - Checks code quality with ESLint\n`;
+    }
+    if (toolOptions?.prettier) {
+        scriptsDetails += `- \`npm run format\` - Formats all files with Prettier\n`;
+    }
+    return scriptsDetails;
+}
+function generateReadmeGitHooks(toolOptions) {
+    if (!toolOptions?.husky)
+        return '';
+    return `
+## Git Hooks
+
+This project uses Husky to run quality checks before commits:
+
+- **Pre-commit**: Automatically runs ESLint and Prettier on staged files
+`;
+}
+function generateReadme(projectName, toolOptions) {
+    let readme = generateReadmeHeader(projectName);
+    readme += generateReadmeScripts(toolOptions);
+    readme += generateReadmeStructure(projectName, toolOptions);
+    readme += generateReadmeTechStack(toolOptions);
+    readme += generateReadmeScriptsDetails(toolOptions);
+    readme += generateReadmeGitHooks(toolOptions);
+    readme += `
+## License
+
+MIT
+`;
+    return readme;
+}
+// Helper to get dependency version from root package.json or fallback
+function getDependencyVersion(rootPkg, depName, fallback) {
+    return (rootPkg.devDependencies?.[depName] ??
+        rootPkg.dependencies?.[depName] ??
+        fallback);
+}
+// Helper to add a tool's dependencies and scripts to package.json
+function addToolToPackage(pkg, rootPkg, config) {
+    pkg.devDependencies = pkg.devDependencies || {};
+    // Add dependencies - resolve versions from rootPkg
+    for (const depName of config.deps) {
+        pkg.devDependencies[depName] = getDependencyVersion(rootPkg, depName, 'latest');
+    }
+    // Add scripts
+    pkg.scripts = pkg.scripts || {};
+    for (const [scriptName, scriptCmd] of Object.entries(config.scripts)) {
+        pkg.scripts[scriptName] = scriptCmd;
+    }
+}
+async function createProject(opts) {
+    const { name, options: toolOptions = {} } = opts;
+    const target = path_1.default.resolve(process.cwd(), name);
+    if (await fs_extra_1.default.pathExists(target)) {
+        throw new Error(messages_1.MESSAGES.targetFolderExists(target));
+    }
+    await fs_extra_1.default.ensureDir(target);
+    const projectName = path_1.default.basename(name);
+    // Create initial package.json object in memory
+    const pkg = minimalPackageJson(projectName);
+    // Write minimal project layout in parallel
+    await Promise.all([
+        fs_extra_1.default.outputFile(path_1.default.join(target, 'src', 'index.ts'), `console.log('Hello TypeScript')\n`),
+        fs_extra_1.default.outputFile(path_1.default.join(target, 'tsconfig.json'), JSON.stringify(baseTsconfig(), null, 2)),
+    ]);
+    // Read versions from this generator's package.json
+    const rootPkg = JSON.parse(await fs_extra_1.default.readFile(path_1.default.resolve(__dirname, '..', 'package.json'), 'utf8'));
+    pkg.scripts = pkg.scripts || {};
+    // TypeScript is always required for a TypeScript project
+    pkg.devDependencies = pkg.devDependencies || {};
+    pkg.devDependencies['typescript'] = getDependencyVersion(rootPkg, 'typescript', 'latest');
+    if (toolOptions.nodemon) {
+        addToolToPackage(pkg, rootPkg, configs_1.TOOL_CONFIGS.nodemon);
+    }
+    // Prepare all config files to write
+    const configFilesToWrite = [];
+    if (toolOptions.eslint) {
+        addToolToPackage(pkg, rootPkg, configs_1.TOOL_CONFIGS.eslint);
+        configFilesToWrite.push(fs_extra_1.default.outputFile(path_1.default.join(target, 'eslint.config.js'), configs_1.TOOL_CONFIGS.eslint.config, 'utf8'));
+    }
+    if (toolOptions.prettier) {
+        addToolToPackage(pkg, rootPkg, configs_1.TOOL_CONFIGS.prettier);
+        configFilesToWrite.push(fs_extra_1.default.outputFile(path_1.default.join(target, '.prettierrc'), JSON.stringify(configs_1.TOOL_CONFIGS.prettier.config, null, 2), 'utf8'));
+    }
+    if (toolOptions.husky) {
+        addToolToPackage(pkg, rootPkg, configs_1.TOOL_CONFIGS.husky);
+        pkg['lint-staged'] = pkg['lint-staged'] || configs_1.TOOL_CONFIGS.husky.lintStaged;
+        const huskyDir = path_1.default.join(target, '.husky');
+        await fs_extra_1.default.ensureDir(huskyDir);
+        configFilesToWrite.push(fs_extra_1.default.outputFile(path_1.default.join(huskyDir, 'pre-commit'), configs_1.TOOL_CONFIGS.husky.preCommitHook, { mode: 0o755 }));
+    }
+    // Generate README content
+    const readmeContent = generateReadme(projectName, toolOptions);
+    // Write package.json and README, plus all config files in parallel
+    configFilesToWrite.push(fs_extra_1.default.outputFile(path_1.default.join(target, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8'), fs_extra_1.default.outputFile(path_1.default.join(target, 'README.md'), readmeContent, 'utf8'));
+    await Promise.all(configFilesToWrite);
+    // optionally initialize git and install dependencies
+    if (toolOptions.git ?? true) {
+        try {
+            const gitAvailable = runCommand('git', ['--version'], target, false, true);
+            if (gitAvailable) {
+                const insideRepo = runCommand('git', ['rev-parse', '--is-inside-work-tree'], target, false, true);
+                if (!insideRepo) {
+                    runCommand('git', ['init'], target, toolOptions.verbose ?? false);
+                    await fs_extra_1.default.outputFile(path_1.default.join(target, '.gitignore'), 'node_modules\ndist\n.env\n', 'utf8');
+                    if (!(toolOptions.noCommit ?? false)) {
+                        try {
+                            runCommand('git', ['add', '-A'], target, toolOptions.verbose ?? false);
+                            runCommand('git', ['commit', '-m', 'chore: initial commit'], target, toolOptions.verbose ?? false);
+                        }
+                        catch (e) {
+                            const errMsg = e instanceof Error ? e.message : String(e);
+                            console.warn(messages_1.MESSAGES.gitCommitFailed(errMsg));
+                        }
+                    }
+                }
+            }
+        }
+        catch (e) {
+            const errMsg = e instanceof Error ? e.message : String(e);
+            console.warn(messages_1.MESSAGES.gitInitFailed(errMsg));
+        }
+    }
+    if (toolOptions.install ?? true) {
+        const pm = (toolOptions && toolOptions.pm) || 'npm';
+        try {
+            if (pm === 'pnpm') {
+                runCommand('pnpm', ['install'], target, toolOptions.verbose ?? false);
+            }
+            else if (pm === 'yarn') {
+                runCommand('yarn', ['install'], target, toolOptions.verbose ?? false);
+            }
+            else {
+                runCommand('npm', ['install'], target, toolOptions.verbose ?? false);
+            }
+            if (toolOptions.husky) {
+                runCommand('npx', ['husky', 'install'], target, toolOptions.verbose ?? false);
+                const preCommitHook = path_1.default.join(target, '.husky', 'pre-commit');
+                if (!(await fs_extra_1.default.pathExists(preCommitHook))) {
+                    runCommand('npx', ['husky', 'add', '.husky/pre-commit', 'npx lint-staged'], target, toolOptions.verbose ?? false);
+                }
+            }
+        }
+        catch (e) {
+            const errMsg = e instanceof Error ? e.message : String(e);
+            console.warn(messages_1.MESSAGES.installFailed(pm, errMsg));
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"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"}

package/dist/messages.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Centralized user-facing messages for better maintainability and potential i18n
+ */
+export declare const MESSAGES: {
+    readonly projectCreated: (name: string) => string;
+    readonly invalidProjectName: (name: string) => string;
+    readonly invalidPackageManager: (pm: string, valid: string[]) => string;
+    readonly targetFolderExists: (target: string) => string;
+    readonly failedToCreateProject: (msg: string) => string;
+    readonly genericError: (msg: string) => string;
+    readonly unknownPackageManager: (pm: string) => string;
+    readonly unknownFlag: (flag: string) => string;
+    readonly gitInitFailed: (reason: string) => string;
+    readonly gitCommitFailed: (reason: string) => string;
+    readonly installFailed: (pm: string, reason: string) => string;
+};

package/dist/messages.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Centralized user-facing messages for better maintainability and potential i18n
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MESSAGES = void 0;
+exports.MESSAGES = {
+    // Success messages
+    projectCreated: (name) => `✔ Project ${name} created`,
+    // Error messages
+    invalidProjectName: (name) => `✖ Invalid project name: ${name}. Use alphanumeric, hyphens, underscores (1-214 chars).`,
+    invalidPackageManager: (pm, valid) => `✖ Invalid package manager: ${pm}. Choose from: ${valid.join(', ')}`,
+    targetFolderExists: (target) => `Target folder already exists: ${target}`,
+    failedToCreateProject: (msg) => `✖ Failed to create project: ${msg}`,
+    genericError: (msg) => `✖ ${msg}`,
+    // Warning messages
+    unknownPackageManager: (pm) => `⚠️  Unknown package manager: ${pm}. Defaulting to npm.`,
+    unknownFlag: (flag) => `⚠️  Unknown flag: ${flag}. Use --help to see available options.`,
+    gitInitFailed: (reason) => `⚠️  Warning: Could not initialize git.\n   Reason: ${reason}\n   Tip: Make sure git is installed ('git --version' should work)`,
+    gitCommitFailed: (reason) => `⚠️  Warning: Could not create git commit.\n   Reason: ${reason}\n   Tip: Run 'git config --global user.email "you@example.com"' and 'git config --global user.name "Your Name"'`,
+    installFailed: (pm, reason) => `⚠️  Warning: Could not install dependencies with ${pm}.\n   Reason: ${reason}\n   Tip: Make sure ${pm} is installed and try running '${pm} install' manually in the project directory`,
+};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,QAAQ,GAAG;IACtB,mBAAmB;IACnB,cAAc,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,aAAa,IAAI,UAAU;IAE7D,iBAAiB;IACjB,kBAAkB,EAAE,CAAC,IAAY,EAAE,EAAE,CACnC,2BAA2B,IAAI,yDAAyD;IAC1F,qBAAqB,EAAE,CAAC,EAAU,EAAE,KAAe,EAAE,EAAE,CACrD,8BAA8B,EAAE,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACtE,kBAAkB,EAAE,CAAC,MAAc,EAAE,EAAE,CACrC,iCAAiC,MAAM,EAAE;IAC3C,qBAAqB,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,+BAA+B,GAAG,EAAE;IAC5E,YAAY,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE;IAEzC,mBAAmB;IACnB,qBAAqB,EAAE,CAAC,EAAU,EAAE,EAAE,CACpC,gCAAgC,EAAE,sBAAsB;IAC1D,WAAW,EAAE,CAAC,IAAY,EAAE,EAAE,CAC5B,qBAAqB,IAAI,wCAAwC;IACnE,aAAa,EAAE,CAAC,MAAc,EAAE,EAAE,CAChC,sDAAsD,MAAM,oEAAoE;IAClI,eAAe,EAAE,CAAC,MAAc,EAAE,EAAE,CAClC,yDAAyD,MAAM,kHAAkH;IACnL,aAAa,EAAE,CAAC,EAAU,EAAE,MAAc,EAAE,EAAE,CAC5C,oDAAoD,EAAE,iBAAiB,MAAM,uBAAuB,EAAE,kCAAkC,EAAE,6CAA6C;CACjL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/** Package manager type: npm, yarn or pnpm */
+export type PackageManager = 'npm' | 'yarn' | 'pnpm';
+/** Options for configuring the generated project and CLI behavior */
+export type ToolOptions = {
+    /** Enable ESLint for code linting */
+    eslint?: boolean;
+    /** Enable Prettier for code formatting */
+    prettier?: boolean;
+    /** Enable Husky for git pre-commit hooks */
+    husky?: boolean;
+    /** Enable nodemon for development auto-reload */
+    nodemon?: boolean;
+    /** Package manager to use (defaults to auto-detection) */
+    pm?: PackageManager;
+    /** Initialize a git repository */
+    git?: boolean;
+    /** Install dependencies after project creation */
+    install?: boolean;
+    /** Enable verbose output */
+    verbose?: boolean;
+    /** Skip initial git commit (when git is enabled) */
+    noCommit?: boolean;
+    /** Skip all prompts and use YES_DEFAULTS (all tools enabled) */
+    yes?: boolean;
+    /** Skip all prompts and use DEFAULT_OPTIONS (sensible defaults) */
+    useDefaults?: boolean;
+};
+/** Options for creating a new TypeScript project */
+export type CreateOptions = {
+    /** Name of the project/directory to create */
+    name: string;
+    /** Tool and CLI configuration options */
+    options?: ToolOptions;
+};
+/** Root package.json structure with dependencies */
+export type RootPackage = {
+    /** Production dependencies */
+    dependencies?: Record<string, string>;
+    /** Development dependencies */
+    devDependencies?: Record<string, string>;
+    /** Allow additional package.json fields */
+    [key: string]: unknown;
+};
+/** Generated package.json structure for the new project */
+export type GeneratedPackage = {
+    /** Project name */
+    name?: string;
+    /** Project version */
+    version?: string;
+    /** Whether the package is private */
+    private?: boolean;
+    /** NPM scripts */
+    scripts?: Record<string, string>;
+    /** Development dependencies */
+    devDependencies?: Record<string, string>;
+    /** Allow additional package.json fields */
+    [key: string]: unknown;
+};
+/** Type for enquirer prompt questions */
+export type PromptQuestion = {
+    /** Type of prompt (input, confirm, etc.) */
+    type: string;
+    /** Identifier for the prompt response */
+    name: string;
+    /** Question text displayed to the user */
+    message: string;
+    /** Default value for the prompt */
+    initial?: string | boolean;
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/eslint.config.mjs

@@ -0,0 +1,36 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import globals from 'globals';
+
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+    },
+    rules: {
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-var-requires': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+    },
+  },
+);

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "launchts",
+  "version": "1.0.0",
+  "description": "Fast, interactive CLI to scaffold TypeScript projects",
+  "bin": {
+    "launchts": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "ts-node src/cli.ts",
+    "test": "vitest",
+    "lint": "eslint .",
+    "prepare": "husky install",
+    "format": "prettier --write ."
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.json": [
+      "prettier --write"
+    ]
+  },
+  "keywords": [
+    "typescript",
+    "scaffold",
+    "cli"
+  ],
+  "author": "Jonas Szigeti <jonas.szigeti@icloud.com>",
+  "license": "MIT",
+  "dependencies": {
+    "cac": "^6.7.2",
+    "enquirer": "^2.3.6",
+    "fs-extra": "^11.1.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^9.0.0",
+    "globals": "^16.5.0",
+    "husky": "^8.0.0",
+    "lint-staged": "^16.2.7",
+    "nodemon": "^3.1.11",
+    "prettier": "^3.7.3",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.48.0",
+    "vitest": "^4.0.14"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}