tkeron 4.3.1 → 4.5.0

package/changelog.md

@@ -1,3 +1,42 @@
+# 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
+
+### New Features
+
+- **Added**: Components (`.com.html`, `.com.md`, `.com.ts`) are now resolved via glob search (`**/${tagName}.com.*`) across any subdirectory of `rootDir`, not just at the exact root path
+  - `currentDir` (same directory as the referencing HTML file) retains the highest priority
+  - If not found locally, tkeron glob-searches all subdirectories of `rootDir` recursively
+  - First glob match is used when multiple subdirectory matches exist
+  - The error message for hyphen-less component names now correctly reports the path found via glob
+
+### Tests
+
+- **Added**: `tests/processCom.test.ts` — 4 new tests covering subdirectory lookup for `.com.html`
+- **Added**: `tests/processComMd.test.ts` — 3 new tests covering subdirectory lookup for `.com.md`
+- **Added**: `tests/processComTs.test.ts` — 3 new tests covering subdirectory lookup for `.com.ts`
+- **Updated**: `tests/examples.test.ts` — updated assertions to match glob-based component resolution
+
+---
+
 # v4.3.1
 
 ## Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tkeron",
-  "version": "4.3.1",
+  "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:`);

package/src/processCom.ts

@@ -83,11 +83,12 @@ const processComponents = async (
     if (tagName) {
       if (!tagName.includes("-")) {
         const localPath = join(currentDir, `${tagName}.com.html`);
-        const rootPath = join(rootDir, `${tagName}.com.html`);
-        if (
-          (await Bun.file(localPath).exists()) ||
-          (await Bun.file(rootPath).exists())
-        ) {
+        const globMatches = getFilePaths(
+          rootDir,
+          `**/${tagName}.com.html`,
+          true,
+        );
+        if ((await Bun.file(localPath).exists()) || globMatches.length > 0) {
           log.error(
             `\n❌ Error: Component name '${tagName}' must contain at least one hyphen.`,
           );
@@ -96,7 +97,7 @@ const processComponents = async (
             `   Rename '${tagName}.com.html' to 'tk-${tagName}.com.html' or similar.`,
           );
           log.error(
-            `   File: ${(await Bun.file(localPath).exists()) ? localPath : rootPath}\n`,
+            `   File: ${(await Bun.file(localPath).exists()) ? localPath : globMatches[0]}\n`,
           );
           throw new Error(
             `Component name '${tagName}' must contain at least one hyphen`,
@@ -104,14 +105,20 @@ const processComponents = async (
         }
       } else {
         const localPath = join(currentDir, `${tagName}.com.html`);
-        const rootPath = join(rootDir, `${tagName}.com.html`);
 
         let componentPath: string | null = null;
 
         if (await Bun.file(localPath).exists()) {
           componentPath = localPath;
-        } else if (await Bun.file(rootPath).exists()) {
-          componentPath = rootPath;
+        } else {
+          const globMatches = getFilePaths(
+            rootDir,
+            `**/${tagName}.com.html`,
+            true,
+          );
+          if (globMatches.length > 0) {
+            componentPath = globMatches[0];
+          }
         }
 
         if (componentPath) {

package/src/processComMd.ts

@@ -83,11 +83,8 @@ const processComponents = async (
     if (tagName) {
       if (!tagName.includes("-")) {
         const localPath = join(currentDir, `${tagName}.com.md`);
-        const rootPath = join(rootDir, `${tagName}.com.md`);
-        if (
-          (await Bun.file(localPath).exists()) ||
-          (await Bun.file(rootPath).exists())
-        ) {
+        const globMatches = getFilePaths(rootDir, `**/${tagName}.com.md`, true);
+        if ((await Bun.file(localPath).exists()) || globMatches.length > 0) {
           log.error(
             `\n❌ Error: Component name '${tagName}' must contain at least one hyphen.`,
           );
@@ -96,7 +93,7 @@ const processComponents = async (
             `   Rename '${tagName}.com.md' to 'tk-${tagName}.com.md' or similar.`,
           );
           log.error(
-            `   File: ${(await Bun.file(localPath).exists()) ? localPath : rootPath}\n`,
+            `   File: ${(await Bun.file(localPath).exists()) ? localPath : globMatches[0]}\n`,
           );
           throw new Error(
             `Component name '${tagName}' must contain at least one hyphen`,
@@ -104,14 +101,20 @@ const processComponents = async (
         }
       } else {
         const localPath = join(currentDir, `${tagName}.com.md`);
-        const rootPath = join(rootDir, `${tagName}.com.md`);
 
         let componentPath: string | null = null;
 
         if (await Bun.file(localPath).exists()) {
           componentPath = localPath;
-        } else if (await Bun.file(rootPath).exists()) {
-          componentPath = rootPath;
+        } else {
+          const globMatches = getFilePaths(
+            rootDir,
+            `**/${tagName}.com.md`,
+            true,
+          );
+          if (globMatches.length > 0) {
+            componentPath = globMatches[0];
+          }
         }
 
         if (componentPath) {

package/src/processComTs.ts

@@ -85,11 +85,8 @@ const processComponentsTs = async (
     if (tagName) {
       if (!tagName.includes("-")) {
         const localPath = join(currentDir, `${tagName}.com.ts`);
-        const rootPath = join(rootDir, `${tagName}.com.ts`);
-        if (
-          (await Bun.file(localPath).exists()) ||
-          (await Bun.file(rootPath).exists())
-        ) {
+        const globMatches = getFilePaths(rootDir, `**/${tagName}.com.ts`, true);
+        if ((await Bun.file(localPath).exists()) || globMatches.length > 0) {
           log.error(
             `\n❌ Error: Component name '${tagName}' must contain at least one hyphen.`,
           );
@@ -98,7 +95,7 @@ const processComponentsTs = async (
             `   Rename '${tagName}.com.ts' to 'tk-${tagName}.com.ts' or similar.`,
           );
           log.error(
-            `   File: ${(await Bun.file(localPath).exists()) ? localPath : rootPath}\n`,
+            `   File: ${(await Bun.file(localPath).exists()) ? localPath : globMatches[0]}\n`,
           );
           throw new Error(
             `Component name '${tagName}' must contain at least one hyphen`,
@@ -106,14 +103,20 @@ const processComponentsTs = async (
         }
       } else {
         const localPath = join(currentDir, `${tagName}.com.ts`);
-        const rootPath = join(rootDir, `${tagName}.com.ts`);
 
         let componentPath: string | null = null;
 
         if (await Bun.file(localPath).exists()) {
           componentPath = localPath;
-        } else if (await Bun.file(rootPath).exists()) {
-          componentPath = rootPath;
+        } else {
+          const globMatches = getFilePaths(
+            rootDir,
+            `**/${tagName}.com.ts`,
+            true,
+          );
+          if (globMatches.length > 0) {
+            componentPath = globMatches[0];
+          }
         }
 
         if (componentPath) {