tkeron 4.5.0 → 5.0.1

package/README.md

@@ -82,8 +82,8 @@ document.getElementById("quote").textContent = data.content;
 
 ```bash
 tk init <name>           # Initialize new project
-tk build [src] [out]     # Build project (default: websrc → web)
-tk dev [src] [out]       # Dev server with hot reload (port 3000)
+tk build                 # Build project (websrc → web)
+tk dev [port] [host]     # Dev server with hot reload (default: localhost:3000)
 ```
 
 **Aliases:** `tk i`, `tk b`, `tk d`

package/changelog.md

@@ -1,3 +1,56 @@
+# v5.0.1
+
+## Documentation fixes and dependency updates
+
+- Fix: `tk build` and `tk dev` CLI signatures corrected in README (removed wrong `[src] [out]` args, aligned with v5.0 breaking change)
+- Fix: Component resolution docs updated to reflect actual glob search behavior (not limited to root `websrc/`)
+- Fix: Build process docs updated to include `.com.md` processing step and iterative loop (up to 10 iterations)
+- Fix: `tsconfig.json` example corrected to match real config (`lib: ["ESNext", "DOM"]`, removed `types: ["bun-types"]`)
+- Fix: TypeScript compilation docs clarified — Bun transpiler does NOT type-check, only transpiles
+- Fix: Broken link `tkeron.dev/docs` → `tkeron.com`
+- Fix: `components-html.md` quick start used `<button>` (reserved HTML tag, no hyphen) — replaced with `<my-button>`
+- Fix: `best-practices.md` Summary had orphaned/corrupted code fragment — removed
+- Fix: Added `.com.md` to all feature lists, tables, and build process diagrams across all docs
+- Fix: `package.json` description updated to reflect actual purpose
+- Deps: `bun update --latest` — updated all dependencies
+
+---
+
+# v5.0.0
+
+## Breaking: sourceDir and targetDir removed as CLI arguments
+
+- `tk build` and `tk dev` no longer accept positional directory arguments
+- Fixed convention: source in `websrc/`, output in `web/`
+- To migrate: rename your source directory to `websrc/` (`mv your-dir websrc`)
+- Output is always `web/` (sibling of `websrc/`) — no longer configurable via CLI
+- `port` and `host` remain as positional arguments for `tk dev`
+
+## Fix: pre-rendering module resolution in projects without node_modules
+
+- `processPre.ts` now injects the absolute resolved path of `@tkeron/html-parser` instead of the bare specifier
+- Fixes failure when the user's project lives inside a workspace root with a `node_modules/` that doesn't include `@tkeron` dependencies
+
+### Migration
+
+```bash
+# Before (v4.x)
+tk build src dist
+tk dev src dist 8080
+
+# After (v5.0)
+tk build
+tk dev 8080
+```
+
+### What changed
+
+- `buildWrapper` no longer forwards `sourceDir`/`targetDir` to `build()`
+- CLI positioned arguments for directories removed from `build` and `develop` commands
+- Documentation updated (cli-reference, getting-started)
+
+---
+
 # v4.5.0
 
 ## tsconfig.json Generation on Init

package/docs/best-practices.md

@@ -231,23 +231,20 @@ document.getElementById("stars").textContent = data.public_repos;
 
 - HTML components: static markup
 - TypeScript components: dynamic generation
+- Markdown components: content in Markdown
 - Pre-rendering: DOM manipulation at build time
 - Browser code: regular TypeScript/JavaScript
 - No bundling of npm packages
 - No type checking (use `tsc --noEmit`)
 - Powered by Bun
-  document.querySelectorAll('.my-button').forEach(btn => {
-  btn.addEventListener('click', handleClick);
-  });
-  });
 
-````
+---
 
 ```typescript
 // ❌ Don't try to maintain state
 let count = 0; // This is meaningless
 com.innerHTML = `<button>Count: ${count}</button>`;
-````
+```
 
 **Solution:** Use client-side JavaScript for stateful UI.
 

package/docs/cli-reference.md

@@ -52,30 +52,22 @@ Build your project by processing source files into static output.
 **Usage:**
 
 ```bash
-tk build [sourceDir] [targetDir]
+tk build
 ```
 
-**Arguments:**
+**Convention:**
 
-| Argument    | Type   | Default  | Description                                    |
-| ----------- | ------ | -------- | ---------------------------------------------- |
-| `sourceDir` | string | `websrc` | Source directory containing your project files |
-| `targetDir` | string | `web`    | Output directory for built files               |
+- Source directory: `websrc/` (relative to current directory)
+- Output directory: `web/` (sibling of `websrc/`)
 
 **Examples:**
 
 ```bash
-# Build with defaults (websrc → web)
+# Build the project
 tk build
 
-# Build with custom source directory
-tk build src web
-
-# Build to custom output directory
-tk build websrc dist
-
-# Build with both custom
-tk build source output
+# Using alias
+tk b
 ```
 
 **Build Process:**
@@ -83,16 +75,20 @@ tk build source output
 1. Creates temporary directory as sibling to source
 2. Copies source to temp directory
 3. Runs `.pre.ts` files (pre-rendering)
-4. Processes `.com.ts` components (TypeScript components)
-5. Processes `.com.html` components (HTML components)
-6. Compiles TypeScript to JavaScript
-7. Copies result to target directory
-8. Cleans up temporary directory
+4. Iterative component processing (up to 10 iterations):
+   - Processes `.com.ts` components (TypeScript components)
+   - Processes `.com.html` components (HTML components)
+   - Processes `.com.md` components (Markdown components)
+   - Repeats until no changes are detected
+5. Compiles TypeScript to JavaScript
+6. Copies result to target directory
+7. Cleans up temporary directory
 
 **Files Excluded from Output:**
 
 - `*.com.html` - HTML components (inlined)
 - `*.com.ts` - TypeScript components (inlined)
+- `*.com.md` - Markdown components (inlined)
 - `*.pre.ts` - Pre-rendering scripts (executed)
 
 **Exit Codes:**
@@ -120,17 +116,20 @@ Start a development server with hot reload.
 **Usage:**
 
 ```bash
-tk develop [sourceDir] [outputDir] [port] [host]
+tk develop [port] [host]
 ```
 
 **Arguments:**
 
-| Argument    | Type   | Default     | Description                 |
-| ----------- | ------ | ----------- | --------------------------- |
-| `sourceDir` | string | `websrc`    | Source directory to watch   |
-| `outputDir` | string | `web`       | Output directory for builds |
-| `port`      | number | `3000`      | Port for development server |
-| `host`      | string | `localhost` | Host to bind server to      |
+| Argument | Type   | Default     | Description                 |
+| -------- | ------ | ----------- | --------------------------- |
+| `port`   | number | `3000`      | Port for development server |
+| `host`   | string | `localhost` | Host to bind server to      |
+
+**Convention:**
+
+- Source directory: `websrc/` (relative to current directory)
+- Output directory: `web/` (sibling of `websrc/`)
 
 **Examples:**
 
@@ -138,17 +137,14 @@ tk develop [sourceDir] [outputDir] [port] [host]
 # Start with defaults
 tk dev
 
-# Custom source and output
-tk dev src dist
-
 # Custom port
-tk dev websrc web 8080
+tk dev 8080
 
 # Bind to all interfaces
-tk dev websrc web 3000 0.0.0.0
+tk dev 3000 0.0.0.0
 
 # Complete custom configuration
-tk develop source output 8080 0.0.0.0
+tk develop 8080 0.0.0.0
 ```
 
 **What It Does:**
@@ -317,7 +313,7 @@ tk init . --force
 cd my-website
 
 # Start development server
-tk dev websrc
+tk dev
 
 # Open http://localhost:3000
 ```
@@ -356,7 +352,7 @@ Quick reference for command shortcuts:
 ```bash
 tk b                    # Same as: tk build
 tk d                    # Same as: tk develop
-tk dev websrc web 8080  # Same as: tk develop websrc web 8080
+tk dev 8080             # Same as: tk develop 8080
 tk i my-site            # Same as: tk init my-site
 ```
 
@@ -430,22 +426,19 @@ Tkeron uses **convention over configuration**. There are no configuration files.
 
 **Project Structure Convention:**
 
-- Source directory: `websrc/` (default)
-- Output directory: `web/` (default)
+- Source directory: `websrc/` (fixed)
+- Output directory: `web/` (fixed)
 - Component files: `*.com.html` and `*.com.ts`
 - Pre-render files: `*.pre.ts`
 - Type definitions: `tkeron.d.ts`
 
 **Customization:**
 
-All customization is done via command-line arguments:
+Server configuration is done via command-line arguments:
 
 ```bash
-# Custom directories
-tk build src dist
-
 # Custom server config
-tk dev src dist 8080 0.0.0.0
+tk dev 8080 0.0.0.0
 ```
 
 ---
@@ -459,8 +452,8 @@ Tkeron doesn't require a `tsconfig.json`, but you can add one for editor support
   "compilerOptions": {
     "target": "ESNext",
     "module": "ESNext",
+    "lib": ["ESNext", "DOM"],
     "moduleResolution": "bundler",
-    "types": ["bun-types"],
     "strict": true,
     "skipLibCheck": true
   },
@@ -580,7 +573,7 @@ Error: Port 3000 is already in use
 
 ```bash
 # Use different port
-tk dev websrc web 3001
+tk dev 3001
 ```
 
 ### Source Directory Not Found
@@ -597,8 +590,8 @@ tk dev websrc web 3001
 # Create directory
 mkdir websrc
 
-# Or use correct path
-tk build src web
+# Or initialize a new project
+tk init .
 ```
 
 ### Permission Denied
@@ -646,7 +639,7 @@ tk
 This document! Also available at:
 
 - [GitHub Repository](https://github.com/tkeron/tkeron)
-- [Documentation Site](https://tkeron.dev/docs)
+- [Documentation Site](https://tkeron.com)
 
 ### Report Issues
 
@@ -668,11 +661,8 @@ tk dev
 # Build for production
 NODE_ENV=production tk build
 
-# Build to custom directory
-tk build websrc dist
-
 # Development on port 8080
-tk dev websrc web 8080
+tk dev 8080
 
 # Initialize in current directory
 tk init .

package/docs/common-issues.md

@@ -125,9 +125,9 @@ blog-post.com.ts      → <blog-post>
 
 ## TypeScript Compilation
 
-### Issue: TypeScript Errors Prevent Build
+### Issue: TypeScript Errors in Source
 
-**Problem:** Type errors block compilation
+**Problem:** TypeScript code has type errors
 
 ```typescript
 // ❌ WRONG
@@ -135,18 +135,24 @@ const user = { name: "Alice" };
 user.age = 30; // Error: Property 'age' does not exist
 ```
 
-**Why this happens:**
+**Why this matters:**
 
-- Tkeron uses Bun's TypeScript transpiler
-- Type errors can prevent successful builds
-- Missing types for global variables
+- Tkeron uses Bun's TypeScript transpiler, which **does NOT type-check** — it only transpiles
+- Type errors won't prevent the build from running
+- However, type errors may indicate real bugs in your code
+- Missing types for global variables can confuse your IDE
 
 **Solution:**
 
+- Run `tsc --noEmit` separately to catch type errors before building
 - Use `tkeron.d.ts` for global type declarations
-- Fix type errors before building
 - Use `any` strategically if types are complex
 
+```bash
+# Check types, then build
+tsc --noEmit && tk build
+```
+
 ```typescript
 // ✅ CORRECT
 const user: { name: string; age?: number } = { name: "Alice" };
@@ -166,16 +172,17 @@ user.age = 30; // OK
 
 **Why this happens:**
 
-- Tkeron searches in 2 locations only:
+- Tkeron searches in 2 ways:
   1. Same directory as HTML file
-  2. Root directory (`websrc/`)
-- Not in subdirectories or parent directories (except root)
+  2. Glob search across the entire source tree
+- If no match is found in either, the element remains unchanged
 
 **Solution:**
-Either place component:
+Place the component file anywhere in the source tree — Tkeron will find it via glob search. For clarity, common locations:
 
-- In `blog/user-card.com.html` (next to `post.html`)
-- Or in `websrc/user-card.com.html` (root, available everywhere)
+- In `blog/user-card.com.html` (next to `post.html` — higher priority)
+- In `websrc/user-card.com.html` (root)
+- In `websrc/components/user-card.com.html` (organized in a subfolder)
 
 ## Build Performance
 

package/docs/components-html.md

@@ -7,7 +7,7 @@ HTML components (`.com.html` files) are the simplest way to create reusable piec
 Create a file named with `.com.html` extension:
 
 ```html
-<!-- button.com.html -->
+<!-- my-button.com.html -->
 <button class="btn">Click me</button>
 ```
 
@@ -15,7 +15,7 @@ Use it with a matching custom element:
 
 ```html
 <!-- index.html -->
-<button></button>
+<my-button></my-button>
 ```
 
 Build, and the custom element is replaced with the component's content.
@@ -36,7 +36,7 @@ Component filenames must:
 | -------------------- | -------------- | ------------------------- |
 | `user-card.com.html` | `<user-card>`  | ✅ Yes                    |
 | `nav-menu.com.html`  | `<nav-menu>`   | ✅ Yes                    |
-| `header.com.html`    | `<header>`     | ❌ No (no hyphen)         |
+| `card.com.html`      | `<card>`       | ❌ No (no hyphen)         |
 | `UserCard.com.html`  | `<user-card>`  | ✅ Yes (case-insensitive) |
 
 ### 2. Component Resolution
@@ -44,23 +44,25 @@ Component filenames must:
 Tkeron looks for components in this order:
 
 1. **Same directory** as the file using it
-2. **Root directory** (`websrc/`)
+2. **Any directory** in the source tree (via glob search)
 
 **Example structure:**
 
 ```
 websrc/
 ├── index.html
-├── header.com.html          # Available to all files
+├── site-header.com.html        # Available to all files
+├── components/
+│   └── blog-comment.com.html   # Also available to all files
 ├── blog/
 │   ├── post.html
-│   └── comment.com.html     # Available only to blog/post.html
+│   └── blog-comment.com.html   # Takes priority for blog/post.html
 ```
 
 In `blog/post.html`:
 
-- `<comment>` → Finds `blog/comment.com.html` first
-- `<header>` → Falls back to `websrc/header.com.html`
+- `<blog-comment>` → Finds `blog/blog-comment.com.html` first (same directory)
+- `<site-header>` → Found via glob search in the source tree
 
 ### 3. Build Process
 

package/docs/components-markdown.md

@@ -50,23 +50,23 @@ Component filenames must:
 Tkeron looks for components in this order:
 
 1. **Same directory** as the file using it
-2. **Root directory** (`websrc/`)
+2. **Any directory** in the source tree (via glob search)
 
 **Example structure:**
 
 ```
 websrc/
 ├── index.html
-├── site-intro.com.md         # Available to all files
+├── site-intro.com.md           # Available to all files
 ├── blog/
 │   ├── post.html
-│   └── post-footer.com.md    # Available only to blog/post.html
+│   └── post-footer.com.md      # Takes priority for blog/post.html
 ```
 
 In `blog/post.html`:
 
-- `<post-footer>` → Finds `blog/post-footer.com.md` first
-- `<site-intro>` → Falls back to `websrc/site-intro.com.md`
+- `<post-footer>` → Finds `blog/post-footer.com.md` first (same directory)
+- `<site-intro>` → Found via glob search in the source tree
 
 ### 3. Component Priority
 

package/docs/components-typescript.md

@@ -84,7 +84,7 @@ Custom elements in HTML must contain at least one hyphen to distinguish them fro
 Same as HTML components:
 
 1. **Same directory** as the file using it
-2. **Root directory** (`websrc/`)
+2. **Any directory** in the source tree (via glob search)
 
 ### IDE Support & IntelliSense
 

package/docs/getting-started.md

@@ -65,22 +65,20 @@ tk init my-website --force
 Build your project to compile it into static files:
 
 ```bash
-tk build websrc web
+tk build
 ```
 
-**Parameters:**
+**Convention:**
 
-- First argument: source directory (default: `websrc`)
-- Second argument: output directory (default: `web`)
+- Source: `websrc/` (relative to current directory)
+- Output: `web/` (sibling of `websrc/`)
 
-**Shorthand:**
+**Using alias:**
 
 ```bash
-tk build
+tk b
 ```
 
-This uses the defaults: `websrc` → `web`
-
 **Output structure:**
 
 ```
@@ -90,7 +88,7 @@ web/
 └── ...              # Other processed files
 ```
 
-Notice that `.com.html`, `.com.ts`, and `.pre.ts` files are **not** copied to output - they're processed and inlined.
+Notice that `.com.html`, `.com.ts`, `.com.md`, and `.pre.ts` files are **not** copied to output - they're processed and inlined.
 
 ## Start Development Server
 
@@ -110,20 +108,18 @@ This will:
 **Custom configuration:**
 
 ```bash
-tk dev websrc web 8080 0.0.0.0
+tk dev 8080 0.0.0.0
 ```
 
 **Parameters:**
 
-- Source directory (default: `websrc`)
-- Output directory (default: `web`)
 - Port (default: `3000`)
 - Host (default: `localhost`)
 
 **Example with custom port:**
 
 ```bash
-tk dev websrc web 8080
+tk dev 8080
 ```
 
 Visit `http://localhost:8080` in your browser.
@@ -202,6 +198,7 @@ Open `web/index.html` in your browser. You'll see the greeting component inlined
 | `.ts` / `.js`       | Scripts for pages     | ✅ Yes (compiled) |
 | `.com.html`         | HTML components       | ❌ No (inlined)   |
 | `.com.ts`           | TypeScript components | ❌ No (inlined)   |
+| `.com.md`           | Markdown components   | ❌ No (inlined)   |
 | `.pre.ts`           | Pre-rendering scripts | ❌ No (executed)  |
 | `.css`              | Stylesheets           | ✅ Yes            |
 | Images, fonts, etc. | Static assets         | ✅ Yes            |
@@ -212,17 +209,14 @@ Open `web/index.html` in your browser. You'll see the greeting component inlined
 # Show help
 tk
 
-# Build with defaults
+# Build the project
 tk build
 
-# Build with custom directories
-tk build src dist
-
 # Start dev server
 tk dev
 
 # Start dev server on port 8080
-tk dev websrc web 8080
+tk dev 8080
 
 # Initialize new project
 tk init my-project
@@ -248,14 +242,14 @@ Now that you have a basic understanding:
 
 ### "Source directory does not exist"
 
-Make sure you're running commands from the right directory:
+Make sure you're running commands from the right directory and that `websrc/` exists:
 
 ```bash
 # Check if websrc exists
 ls websrc
 
-# Or specify the correct path
-tk build path/to/websrc path/to/web
+# Or run tk init to create a new project
+tk init .
 ```
 
 ### "Command not found: tk"
@@ -271,11 +265,11 @@ bun install -g tkeron
 Use a different port:
 
 ```bash
-tk dev websrc web 3001
+tk dev 3001
 ```
 
 ### Components not working
 
 - Component names **must** contain a hyphen: `user-card`, not `usercard`
 - File must be named exactly: `user-card.com.html`
-- Component files must be in `websrc/` or the same directory as the page using them
+- Component files can be anywhere in the source tree — Tkeron searches the same directory first, then the entire source via glob

package/docs/overview.md

@@ -11,6 +11,7 @@ Powered by [Bun](https://bun.sh).
 - Compiles TypeScript to JavaScript
 - Inlines HTML components (`.com.html`)
 - Executes TypeScript components (`.com.ts`) at build time
+- Renders Markdown components (`.com.md`) at build time
 - Runs pre-rendering scripts (`.pre.ts`)
 - Copies assets
 - Dev server with hot reload
@@ -107,11 +108,12 @@ websrc/               Build Steps           web/
 ├── index.html    →  1. .pre.ts        →  ├── index.html
 ├── index.ts         2. .com.ts           ├── index.js
 ├── index.pre.ts     3. .com.html
-├── nav.com.html     4. TypeScript
-└── card.com.ts      5. Assets
+├── nav.com.html     4. .com.md
+├── card.com.ts      5. TypeScript
+└── info.com.md      6. Assets
 ```
 
-Component files (`.com.html`, `.com.ts`, `.pre.ts`) are not copied to output.
+Component files (`.com.html`, `.com.ts`, `.com.md`, `.pre.ts`) are not copied to output.
 
 ---
 

package/docs/pre-rendering.md

@@ -71,10 +71,13 @@ This is the parsed DOM from the corresponding `.html` file.
 
 ```
 1. Run .pre.ts files    → Modify HTML documents
-2. Process .com.ts      → Replace TypeScript components
-3. Process .com.html    → Replace HTML components
-4. Compile .ts to .js   → TypeScript compilation
-5. Copy to output       → Final build
+2. Iterative component processing (up to 10 iterations):
+   a. Process .com.ts   → Replace TypeScript components
+   b. Process .com.html → Replace HTML components
+   c. Process .com.md   → Replace Markdown components
+   d. Repeat until no changes
+3. Compile .ts to .js   → TypeScript compilation
+4. Copy to output       → Final build
 ```
 
 Pre-rendering happens **first**, so you can inject components dynamically.

package/examples/init_sample/tkeron.d.ts

@@ -1,13 +1 @@
-// Augment global scope for .pre.ts files
-declare module "*.pre.ts" {
-  global {
-    const document: Document;
-  }
-}
-
-// Augment global scope for .com.ts files
-declare module "*.com.ts" {
-  global {
-    const com: HTMLElement;
-  }
-}
+declare const com: HTMLElement;

package/index.ts

@@ -15,8 +15,6 @@ getCommands("tkeron", packageJson.version)
   .addCommand("build")
   .addAlias("b")
   .addDescription("Build the project")
-  .addPositionedArgument("sourceDir")
-  .addPositionedArgument("targetDir")
   .setCallback(buildWrapper)
 
   .commands()
@@ -25,8 +23,6 @@ getCommands("tkeron", packageJson.version)
   .addAlias("dev")
   .addAlias("d")
   .addDescription("Start development server")
-  .addPositionedArgument("sourceDir")
-  .addPositionedArgument("targetDir")
   .addPositionedArgument("port")
   .addPositionedArgument("host")
   .setCallback(develop)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tkeron",
-  "version": "4.5.0",
-  "description": "CLI tool for backend-driven frontend development with TypeScript.",
+  "version": "5.0.1",
+  "description": "CLI build tool for vanilla web development with TypeScript.",
   "type": "module",
   "main": "./src/index.ts",
   "exports": {

package/src/buildWrapper.ts

@@ -3,8 +3,6 @@ import type { Logger } from "@tkeron/tools";
 import { logger as defaultLogger } from "@tkeron/tools";
 
 export interface BuildWrapperOptions {
-  sourceDir?: string;
-  targetDir?: string;
   logger?: Logger;
   [key: string]: any;
 }
@@ -13,7 +11,7 @@ export const buildWrapper = async (options: BuildWrapperOptions) => {
   const log = options?.logger || defaultLogger;
 
   try {
-    await build({ ...options, logger: log });
+    await build({ logger: log });
   } catch (error: any) {
     log.error(`\n❌ Build failed: ${error.message}\n`);
     process.exit(1);

package/src/ensureTsconfig.ts

@@ -0,0 +1,68 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+const REQUIRED_INCLUDES = ["websrc/**/*", "tkeron.d.ts"];
+
+const DEFAULT_COMPILER_OPTIONS = {
+  target: "ESNext",
+  module: "ESNext",
+  lib: ["ESNext", "DOM"],
+  moduleResolution: "bundler",
+  strict: true,
+  skipLibCheck: true,
+};
+
+const createFreshTsconfig = () => ({
+  compilerOptions: { ...DEFAULT_COMPILER_OPTIONS },
+  include: [...REQUIRED_INCLUDES],
+});
+
+const mergeIncludes = (existing: string[]): string[] => {
+  const merged = [...existing];
+  for (const entry of REQUIRED_INCLUDES) {
+    if (!merged.includes(entry)) {
+      merged.push(entry);
+    }
+  }
+  return merged;
+};
+
+export const ensureTsconfig = (
+  targetPath: string,
+  previousTsconfig?: Record<string, unknown>,
+) => {
+  const tsconfigPath = join(targetPath, "tsconfig.json");
+
+  if (previousTsconfig) {
+    const existingIncludes = Array.isArray(previousTsconfig.include)
+      ? (previousTsconfig.include as string[])
+      : [];
+    const merged = {
+      ...previousTsconfig,
+      include: mergeIncludes(existingIncludes),
+    };
+    writeFileSync(tsconfigPath, JSON.stringify(merged, null, 2));
+    return;
+  }
+
+  if (existsSync(tsconfigPath)) {
+    try {
+      const content = readFileSync(tsconfigPath, "utf-8");
+      const parsed = JSON.parse(content);
+      const existingIncludes = Array.isArray(parsed.include)
+        ? (parsed.include as string[])
+        : [];
+      const merged = { ...parsed, include: mergeIncludes(existingIncludes) };
+      writeFileSync(tsconfigPath, JSON.stringify(merged, null, 2));
+      return;
+    } catch {
+      writeFileSync(
+        tsconfigPath,
+        JSON.stringify(createFreshTsconfig(), null, 2),
+      );
+      return;
+    }
+  }
+
+  writeFileSync(tsconfigPath, JSON.stringify(createFreshTsconfig(), null, 2));
+};

package/src/init.ts

@@ -4,7 +4,6 @@ import {
   mkdirSync,
   copyFileSync,
   readFileSync,
-  writeFileSync,
   readdirSync,
   rmSync,
 } from "fs";
@@ -12,6 +11,7 @@ import { join, resolve, basename } from "path";
 import type { Logger } from "@tkeron/tools";
 import { silentLogger } from "@tkeron/tools";
 import { promptUser } from "./promptUser";
+import { ensureTsconfig } from "./ensureTsconfig";
 
 export interface InitOptions {
   projectName: string;
@@ -30,6 +30,8 @@ export const init = async (options: InitOptions) => {
   const targetPath = resolve(process.cwd(), projectName);
   const isCurrentDir = projectName === "." || targetPath === process.cwd();
 
+  let skipWebsrc = false;
+
   if (existsSync(targetPath)) {
     if (!isCurrentDir) {
       if (!force) {
@@ -57,18 +59,22 @@ export const init = async (options: InitOptions) => {
             "\nDo you want to overwrite them? (y/N): ",
           );
 
-          if (!shouldContinue) {
-            log.log("\n❌ Operation cancelled.");
-            return;
+          if (shouldContinue) {
+            existingTkeronFiles.forEach((file) => {
+              const filePath = join(targetPath, file);
+              rmSync(filePath, { recursive: true, force: true });
+            });
+            log.log("✓ Cleaned existing tkeron files");
+          } else {
+            skipWebsrc = existingTkeronFiles.includes("websrc");
           }
+        } else {
+          existingTkeronFiles.forEach((file) => {
+            const filePath = join(targetPath, file);
+            rmSync(filePath, { recursive: true, force: true });
+          });
+          log.log("✓ Cleaned existing tkeron files");
         }
-
-        existingTkeronFiles.forEach((file) => {
-          const filePath = join(targetPath, file);
-          rmSync(filePath, { recursive: true, force: true });
-        });
-
-        log.log("✓ Cleaned existing tkeron files");
       }
     }
   }
@@ -91,36 +97,27 @@ export const init = async (options: InitOptions) => {
   }
 
   const tsconfigPath = join(targetPath, "tsconfig.json");
-  let existingTsconfig: Record<string, unknown> | null = null;
-  if (isCurrentDir && existsSync(tsconfigPath)) {
+  let previousTsconfig: Record<string, unknown> | undefined;
+  if (existsSync(tsconfigPath)) {
     try {
-      existingTsconfig = JSON.parse(readFileSync(tsconfigPath, "utf-8"));
+      previousTsconfig = JSON.parse(readFileSync(tsconfigPath, "utf-8"));
     } catch {
-      existingTsconfig = null;
+      previousTsconfig = undefined;
     }
   }
 
   mkdirSync(targetPath, { recursive: true });
-  cpSync(templatePath, targetPath, { recursive: true });
+  const websrcInTemplate = join(templatePath, "websrc");
+  cpSync(templatePath, targetPath, {
+    recursive: true,
+    filter: skipWebsrc
+      ? (src: string) =>
+          src !== websrcInTemplate && !src.startsWith(websrcInTemplate + "/")
+      : undefined,
+  });
   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));
-  }
+  ensureTsconfig(targetPath, previousTsconfig);
 
   const projectDisplayName = isCurrentDir ? basename(targetPath) : projectName;
   log.log(`✓ Created project "${projectDisplayName}"`);

package/src/processComTs.ts

@@ -137,7 +137,9 @@ const processComponentsTs = async (
 
           const elementHTML = (child as any).outerHTML;
 
-          log.info(`Processing component <${tagName}> from ${componentPath}`);
+          log.info(
+            `Processing component <${tagName}> from ${componentPath.replace(rootDir, ".")}`,
+          );
 
           const tempDoc = parseHTML(
             "<html><body>" + elementHTML + "</body></html>",
@@ -199,7 +201,9 @@ ${codeWithoutImports}
               await executeComponent(com);
             }
           } catch (execError: any) {
-            log.error(`\n❌ Error executing component <${tagName}>:`);
+            log.error(
+              `\n❌ Error executing component <${tagName}>: ${componentPath.replace(rootDir, ".")}`,
+            );
             log.error(`   ${execError.message}`);
             throw execError;
           }

package/src/processPre.ts

@@ -7,6 +7,8 @@ const packageJsonPath = join(import.meta.dir, "..", "package.json");
 const packageJson = await Bun.file(packageJsonPath).json();
 const TKERON_VERSION = packageJson.version;
 
+const HTML_PARSER_PATH = import.meta.resolve("@tkeron/html-parser");
+
 const DEFAULT_HTML = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -48,7 +50,7 @@ export const processPre = async (
       : DEFAULT_HTML;
 
     const modifiedCode = `
-        import { parseHTML } from "@tkeron/html-parser";
+        import { parseHTML } from ${JSON.stringify(HTML_PARSER_PATH)};
 
         const htmlPath = ${JSON.stringify(htmlFile)};
         const htmlContent = ${JSON.stringify(htmlContent)};

package/tkeron.d.ts

@@ -1,13 +1 @@
-// Augment global scope for .pre.ts files
-declare module "*.pre.ts" {
-  global {
-    const document: Document;
-  }
-}
-
-// Augment global scope for .com.ts files
-declare module "*.com.ts" {
-  global {
-    const com: HTMLElement;
-  }
-}
+declare const com: HTMLElement;