tsc-app 3.1.3 → 3.2.4

package/README.md

@@ -3,17 +3,35 @@
 A minimal and fast **TypeScript project generator** — spin up a ready-to-use TypeScript + Node.js project with a single command.
 
 ## ✨ Features
-- 📦 Creates `package.json` with sensible defaults
-- ⚙ Generates a clean `tsconfig.json`
-- 📂 Sets up `src/` folder with a `main.ts` starter file
-- 🏃 Adds `start`, `build`, and `serve` scripts
-- ⚡ Supports **CommonJS** and **ES Module** formats with `-m` flag
-- 🖥 Instantly ready to run via `npx` — no global install required
+
+- 📦 Automatic `package.json` creation with sensible defaults 
+- ⚙ Clean `tsconfig.json` optimized for Node.js 
+- 📂 `src/` folder setup with a starter `index.ts` 
+- 🏃 Pre-configured scripts: `start`, `build`, and `dev` 
+- ⚡ Supports CommonJS and ES Module formats via the `--module` flag
+- 🖥 No global install required — run instantly via `npx`
+- ✅ Configured with the latest TypeScript best practices 
 
 ---
 
 ## 🚀 Quick Start
 
-### 1. Create a new project
+### Create a New Project
 ```bash
-npx ts-app my-app
+npx ts-app --app-name my-app
+
+Output:
+
+Folder Structure:
+my-app/
+├── package.json
+├── tsconfig.json
+├── src/
+│   └── index.ts
+└── dist/
+
+Build the Project
+ => npm run dev
+
+Run Compiled Code
+ => npm start

package/index.js

@@ -1,33 +1,39 @@
 #!/usr/bin/env node
-
-// Use CommonJS so it works out-of-the-box with npm CLI
 const fs = require("fs");
 const { execSync } = require("child_process");
+const path = require("path");
 
-// --- Args ---
 const args = process.argv.slice(2);
-const projectName = args[0] || "my-ts-app";
+let projectName = args[0] || "my-ts-app";
 
-// Defaults
-let packageType = "module";   // package.json type
-let tsModuleKind = "esnext";  // tsc --module value
+// Validate project name
+const namePattern = /^[a-zA-Z][a-zA-Z0-9-]{2,}$/;
+if (!namePattern.test(projectName)) {
+  console.error(
+    "Invalid project name. Must:\n" +
+      "- start with a letter\n" +
+      "- be at least 3 characters long\n" +
+      "- contain only letters, numbers, and hyphens\n" +
+      "- no spaces or special characters"
+  );
+  process.exit(1);
+}
 
+// Defaults
+let packageType = "module";
 
 // Parse -m flag
 if (args.includes("-m")) {
   const val = args[args.indexOf("-m") + 1]?.toLowerCase();
-  if (["module", "esm", "esnext"].includes(val)) {
-    packageType = "module";
-    tsModuleKind = "esnext";
-  } else if (["commonjs", "cjs"].includes(val)) {
+  if (["commonjs", "cjs"].includes(val)) {
     packageType = "commonjs";
-    tsModuleKind = "commonjs";
-  } else {
-    console.warn(`⚠ Unknown module type "${val}", defaulting to  module`);
+  } else if (!["module", "esm", "esnext"].includes(val)) {
+    console.warn(`Unknown module type "${val}", defaulting to "module"`);
   }
 }
 
-console.log(`Creating TypeScript app: ${projectName} [package.json type=${packageType}, tsc module=${tsModuleKind}] ...`);
+console.log(`Creating TypeScript app: ${projectName}`);
+console.log(` → package.json type = ${packageType}`);
 
 // Create project folder
 fs.mkdirSync(projectName);
@@ -36,30 +42,99 @@ process.chdir(projectName);
 // Init package.json
 execSync("npm init -y", { stdio: "inherit" });
 
-// Install dev deps
-execSync("npm i -D typescript ts-node @types/node", { stdio: "inherit" });
+// Install dev dependencies (latest)
+execSync("npm i -D typescript@latest ts-node@latest @types/node@latest concurrently@latest nodemon@latest", {
+  stdio: "inherit",
+});
 
-// Init tsconfig.json
-execSync(
-  `npx tsc --init --rootDir src --outDir dist --esModuleInterop --resolveJsonModule --module ${tsModuleKind} --target es2020`,
-  { stdio: "inherit" }
-);
+// Create tsconfig.json
+const tsconfig = {
+  compilerOptions: {
+    rootDir: "./src",
+    outDir: "./dist",
+    module: "nodenext",
+    target: "esnext",
+    types: ["node"],
+    sourceMap: true,
+    declaration: true,
+    declarationMap: true,
+    noUncheckedIndexedAccess: true,
+    exactOptionalPropertyTypes: true,
+    strict: true,
+    verbatimModuleSyntax: true,
+    isolatedModules: true,
+    moduleDetection: "force",
+    skipLibCheck: true,
+    esModuleInterop: true,
+    forceConsistentCasingInFileNames: true,
+    moduleResolution: "nodenext"
+  },
+  include: ["src/**/*.ts"],
+  exclude: ["node_modules", "dist"]
+};
+fs.writeFileSync("tsconfig.json", JSON.stringify(tsconfig, null, 2));
 
-// Create src + starter file
+// Create src folder + entry file
 fs.mkdirSync("src");
-fs.writeFileSync("src/main.ts", `console.log("Hello TypeScript CLI");`);
+fs.writeFileSync(
+  "src/index.ts",
+  `export function hello(name: string) {
+  return \`Hello, \${name}!\`;
+}
+
+console.log(hello("World"));`
+);
 
-// Update package.json scripts + type
+// Update package.json scripts
 const pkg = JSON.parse(fs.readFileSync("package.json", "utf8"));
 pkg.type = packageType;
 pkg.scripts = {
-  start: "tsc src/main.ts",
+  dev: 'concurrently "tsc -w" "nodemon dist/index.js"',
   build: "tsc",
-  serve: "node dist/main.js"
+  start: "node dist/index.js"
 };
+pkg.main = "./dist/index.js";
+pkg.types = "./dist/index.d.ts";
 fs.writeFileSync("package.json", JSON.stringify(pkg, null, 2));
 
-console.log("Done!");
-console.log(`cd ${projectName}`);
-console.log(`npm build`);
-console.log("npm run serve");
+// Create .gitignore
+fs.writeFileSync(
+  ".gitignore",
+  `node_modules
+dist
+.env
+*.log
+.DS_Store
+`
+);
+
+// Create README.md
+fs.writeFileSync(
+  "README.md",
+  `# ${projectName}
+
+> Generated with init-ts-app
+
+## Quick Start
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+## Scripts
+- \`npm run dev\` — watch + rebuild + run dist/index.js
+- \`npm run build\` — compile TypeScript to dist/
+`
+);
+
+// Init Git repo
+execSync("git init", { stdio: "inherit" });
+execSync("git add .", { stdio: "inherit" });
+execSync("git commit -m 'Initial commit: generated by init-ts-app'", {
+  stdio: "inherit",
+});
+
+console.log("\n=> Project setup complete!");
+console.log(`=> cd ${projectName}`);
+console.log("=> npm run dev");
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsc-app",
-  "version": "3.1.3",
+  "version": "3.2.4",
   "description": "Quick TypeScript project initializer",
   "main": "index.js",
   "bin": {