tkeron 4.4.0 → 4.5.0

package/changelog.md

@@ -1,3 +1,21 @@
+# v4.5.0
+
+## tsconfig.json Generation on Init
+
+### New Features
+
+- **Added**: `tk i` now generates a `tsconfig.json` in the project root, allowing the IDE/TypeScript language server to detect `tkeron.d.ts` and provide full autocompletion and type checking for `.com.ts` and `.pre.ts` files
+  - New projects receive the full tkeron tsconfig template (`"include": ["websrc/**/*", "tkeron.d.ts"]`)
+  - Existing projects with a custom `tsconfig.json` are **not overwritten** — tkeron merges only the required `include` entries (`"websrc/**/*"` and `"tkeron.d.ts"`), preserving all other settings (`compilerOptions`, `exclude`, custom includes, etc.)
+  - Duplicate entries are never added
+  - `tsconfig.json` is not treated as a tkeron-managed file and does not appear in the overwrite warning
+
+### Tests
+
+- **Added**: `tests/init.test.ts` — 10 new tests covering tsconfig creation, IDE detection includes, websrc includes, current-directory init, no-warning behavior, merge scenarios (missing entries, no-op when already present, no duplicates, no include field, preserving all existing settings)
+
+---
+
 # v4.4.0
 
 ## Component Subdirectory Lookup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tkeron",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "CLI tool for backend-driven frontend development with TypeScript.",
   "type": "module",
   "main": "./src/index.ts",

package/src/init.ts

@@ -3,6 +3,8 @@ import {
   existsSync,
   mkdirSync,
   copyFileSync,
+  readFileSync,
+  writeFileSync,
   readdirSync,
   rmSync,
 } from "fs";
@@ -88,10 +90,38 @@ export const init = async (options: InitOptions) => {
     throw new Error("tkeron.d.ts not found");
   }
 
+  const tsconfigPath = join(targetPath, "tsconfig.json");
+  let existingTsconfig: Record<string, unknown> | null = null;
+  if (isCurrentDir && existsSync(tsconfigPath)) {
+    try {
+      existingTsconfig = JSON.parse(readFileSync(tsconfigPath, "utf-8"));
+    } catch {
+      existingTsconfig = null;
+    }
+  }
+
   mkdirSync(targetPath, { recursive: true });
   cpSync(templatePath, targetPath, { recursive: true });
   copyFileSync(tkeronDtsPath, join(targetPath, "tkeron.d.ts"));
 
+  if (existingTsconfig !== null) {
+    const templateTsconfig = JSON.parse(readFileSync(tsconfigPath, "utf-8"));
+    const requiredIncludes: string[] = Array.isArray(templateTsconfig.include)
+      ? (templateTsconfig.include as string[])
+      : [];
+    const existingIncludes: string[] = Array.isArray(existingTsconfig.include)
+      ? (existingTsconfig.include as string[])
+      : [];
+    const mergedIncludes = [...existingIncludes];
+    for (const entry of requiredIncludes) {
+      if (!mergedIncludes.includes(entry)) {
+        mergedIncludes.push(entry);
+      }
+    }
+    const merged = { ...existingTsconfig, include: mergedIncludes };
+    writeFileSync(tsconfigPath, JSON.stringify(merged, null, 2));
+  }
+
   const projectDisplayName = isCurrentDir ? basename(targetPath) : projectName;
   log.log(`✓ Created project "${projectDisplayName}"`);
   log.log(`\nNext steps:`);