@evitcastudio/kit 3.1.1 → 3.2.1

package/lib/bundle/cli/cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
+// @bun
 
 /*!
- * @evitcastudio/kit@3.1.1 git+https://github.com/EvitcaStudio/Kit.git
- * Compiled Fri, 26 Jun 2026 23:30:10 UTC
+ * @evitcastudio/kit@3.2.1 git+https://github.com/EvitcaStudio/Kit.git
+ * Compiled Wed, 09 Sep 2026 08:34:23 UTC
  * Copyright (c) 2026 Jared Bates, Evitca Studio, "doubleactii"
  *
  * @evitcastudio/kit is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
  */
-import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
@@ -26,7 +26,6 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
@@ -351,7 +350,7 @@ var require_help = __commonJS((exports) => {
       return Math.max(helper.longestOptionTermLength(cmd, helper), helper.longestGlobalOptionTermLength(cmd, helper), helper.longestSubcommandTermLength(cmd, helper), helper.longestArgumentTermLength(cmd, helper));
     }
     wrap(str, width, indent, minColumnWidth = 40) {
-      const indents = " \\f\\t\\v   -   　\uFEFF";
+      const indents = " \\f\\t\\v\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF";
       const manualIndent = new RegExp(`[\\n][${indents}]+`);
       if (str.match(manualIndent))
         return str;
@@ -363,7 +362,7 @@ var require_help = __commonJS((exports) => {
 `, `
 `);
       const indentString = " ".repeat(indent);
-      const zeroWidthSpace = "​";
+      const zeroWidthSpace = "\u200B";
       const breaks = `\\s${zeroWidthSpace}`;
       const regex = new RegExp(`
 |.{1,${columnWidth - 1}}([${breaks}]|$)|[^${breaks}]+?([${breaks}]|$)`, "g");
@@ -606,11 +605,11 @@ var require_suggestSimilar = __commonJS((exports) => {
 
 // node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
-  var EventEmitter = __require("node:events").EventEmitter;
-  var childProcess = __require("node:child_process");
-  var path = __require("node:path");
-  var fs = __require("node:fs");
-  var process2 = __require("node:process");
+  var EventEmitter = import.meta.require("events").EventEmitter;
+  var childProcess = import.meta.require("child_process");
+  var path = import.meta.require("path");
+  var fs = import.meta.require("fs");
+  var process2 = import.meta.require("process");
   var { Argument, humanReadableArgName } = require_argument();
   var { CommanderError } = require_error();
   var { Help } = require_help();
@@ -1943,8 +1942,8 @@ var {
 } = import__.default;
 
 // src/cli/resource-builder.ts
-import { promises as fs } from "fs";
-import { join, extname, basename } from "path";
+import { promises as fs2, watch as fsWatch, existsSync as existsSync2 } from "fs";
+import { join as join2, extname as extname2, basename, resolve } from "path";
 
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -2124,9 +2123,9 @@ var ansiStyles = assembleStyles();
 var ansi_styles_default = ansiStyles;
 
 // node_modules/chalk/source/vendor/supports-color/index.js
-import process2 from "node:process";
-import os from "node:os";
-import tty from "node:tty";
+import process2 from "process";
+import os from "os";
+import tty from "tty";
 function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process2.argv) {
   const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
   const position = argv.indexOf(prefix + flag);
@@ -2475,19 +2474,19 @@ function v4(options, buf, offset) {
 }
 var v4_default = v4;
 // src/vendor/vyi/index.js
-/*!
- * vyi@4.1.0 https://github.com/EvitcaStudio/vyi
- * Compiled Sun, 21 Jun 2026 10:57:24 UTC
- * Copyright (c) 2026 Evitca Studio, "doubleactii"
- *
- * vyi is privately licensed.
+/*!
+ * vyi@4.1.0 https://github.com/EvitcaStudio/vyi
+ * Compiled Sun, 21 Jun 2026 10:57:24 UTC
+ * Copyright (c) 2026 Evitca Studio, "doubleactii"
+ *
+ * vyi is privately licensed.
  */
-/*!
- * logger@1.0.0 https://github.com/EvitcaStudio/Logger
- * Compiled Mon, 10 Nov 2025 05:36:23 UTC
- * Copyright (c) 2025 Evitca Studio, "doubleactii"
- *
- * logger is privately licensed.
+/*!
+ * logger@1.0.0 https://github.com/EvitcaStudio/Logger
+ * Compiled Mon, 10 Nov 2025 05:36:23 UTC
+ * Copyright (c) 2025 Evitca Studio, "doubleactii"
+ *
+ * logger is privately licensed.
  */
 
 class Logger {
@@ -2758,19 +2757,19 @@ class Frame {
     return frameData;
   }
 }
-/*!
- * icon-point@2.1.0 https://github.com/EvitcaStudio/IconPoint
- * Compiled Mon, 10 Nov 2025 09:52:21 UTC
- * Copyright (c) 2025 Evitca Studio, "doubleactii"
- *
- * icon-point is privately licensed.
+/*!
+ * icon-point@2.1.0 https://github.com/EvitcaStudio/IconPoint
+ * Compiled Mon, 10 Nov 2025 09:52:21 UTC
+ * Copyright (c) 2025 Evitca Studio, "doubleactii"
+ *
+ * icon-point is privately licensed.
  */
-/*!
- * logger@1.0.0 https://github.com/EvitcaStudio/Logger
- * Compiled Mon, 10 Nov 2025 05:36:23 UTC
- * Copyright (c) 2025 Evitca Studio, "doubleactii"
- *
- * logger is privately licensed.
+/*!
+ * logger@1.0.0 https://github.com/EvitcaStudio/Logger
+ * Compiled Mon, 10 Nov 2025 05:36:23 UTC
+ * Copyright (c) 2025 Evitca Studio, "doubleactii"
+ *
+ * logger is privately licensed.
  */
 
 class Logger2 {
@@ -7987,6 +7986,209 @@ class WorkerPool {
   }
 }
 
+// src/cli/app-bundler.ts
+import { promises as fs, existsSync } from "fs";
+import { join, dirname, extname } from "path";
+var Bun2 = globalThis.Bun;
+function detectArchitecture(pSrcDir) {
+  const hasClientEntry = existsSync(join(pSrcDir, "client", "index.ts"));
+  const hasServerEntry = existsSync(join(pSrcDir, "server", "index.ts"));
+  const hasSingleEntry = existsSync(join(pSrcDir, "index.ts"));
+  if (hasClientEntry || hasServerEntry) {
+    return "multi";
+  }
+  if (hasSingleEntry) {
+    return "single";
+  }
+  return "none";
+}
+async function copyDirectoryRecursive(pSourceDir, pDestDir) {
+  if (!existsSync(pSourceDir))
+    return;
+  const entries = await fs.readdir(pSourceDir, { withFileTypes: true });
+  await fs.mkdir(pDestDir, { recursive: true });
+  for (const entry of entries) {
+    const srcPath = join(pSourceDir, entry.name);
+    const destPath = join(pDestDir, entry.name);
+    if (entry.isDirectory()) {
+      await copyDirectoryRecursive(srcPath, destPath);
+    } else {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+async function copyStaticWebFiles(pSourceDir, pDestDir, pBaseDir) {
+  if (!existsSync(pSourceDir))
+    return;
+  const entries = await fs.readdir(pSourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = join(pSourceDir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "vendor" || entry.name === "resources" || entry.name === "node_modules") {
+        continue;
+      }
+      await copyStaticWebFiles(fullPath, pDestDir, pBaseDir);
+    } else {
+      const ext = extname(entry.name).toLowerCase();
+      if ([".html", ".css", ".ico"].includes(ext)) {
+        const relativePath = fullPath.slice(pBaseDir.length).replace(/^[/\\]+/, "");
+        const targetPath = join(pDestDir, relativePath);
+        await fs.mkdir(dirname(targetPath), { recursive: true });
+        await fs.copyFile(fullPath, targetPath);
+      }
+    }
+  }
+}
+async function bundleApp(pProjectRoot, pOutDir, pOptions = {}) {
+  const srcDir = join(pProjectRoot, "src");
+  const architecture = detectArchitecture(srcDir);
+  const isVerbose = Boolean(pOptions.verbose);
+  if (architecture === "none") {
+    if (isVerbose) {
+      console.log(source_default.yellow("[Kit CLI] No application entrypoint detected (src/index.ts or src/client/index.ts). Skipping code bundle."));
+    }
+    return { architecture: "none", success: true };
+  }
+  const isProd = Boolean(pOptions.prod);
+  const shouldMinify = isProd || Boolean(pOptions.minify);
+  const shouldObfuscate = isProd || Boolean(pOptions.obfuscate);
+  const sourcemapMode = pOptions.sourcemap ?? (isProd ? "none" : "linked");
+  let banner = "";
+  const pkgPath = join(pProjectRoot, "package.json");
+  if (existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(await fs.readFile(pkgPath, "utf8"));
+      banner = [
+        "/*!",
+        ` * ${pkg.name || "game"}@${pkg.version || "1.0.0"}`,
+        ` * Compiled ${new Date().toUTCString().replace(/GMT/g, "UTC")}`,
+        " *",
+        ` * ${pkg.name || "game"} is privately licensed. All rights reserved.`,
+        ` * Author: ${pkg.author ?? "Unnamed"}`,
+        " */"
+      ].join(`
+`);
+    } catch {
+    }
+  }
+  try {
+    if (architecture === "single") {
+      const startStamp = Date.now();
+      const clientResult = await Bun2.build({
+        entrypoints: [join(srcDir, "index.ts")],
+        naming: "index.js",
+        outdir: pOutDir,
+        target: "browser",
+        banner,
+        sourcemap: sourcemapMode,
+        minify: shouldMinify ? {
+          identifiers: shouldObfuscate,
+          syntax: true,
+          whitespace: true
+        } : false
+      });
+      if (!clientResult.success) {
+        console.error(clientResult.logs);
+        throw new AggregateError(clientResult.logs, "Client build failed");
+      }
+      await copyStaticWebFiles(srcDir, pOutDir, srcDir);
+      const rootFavicon = join(pProjectRoot, "favicon.ico");
+      if (existsSync(rootFavicon)) {
+        await fs.copyFile(rootFavicon, join(pOutDir, "favicon.ico"));
+      }
+      const vendorDir = join(srcDir, "vendor");
+      if (existsSync(vendorDir)) {
+        await copyDirectoryRecursive(vendorDir, join(pOutDir, "vendor"));
+      }
+      const elapsed = Date.now() - startStamp;
+      if (isVerbose) {
+        console.log(source_default.hex("#ffa552")(`[Kit CLI] Singleplayer Client Build took: ${elapsed}ms`));
+      }
+      return { architecture: "single", clientBuildTime: elapsed, success: true };
+    }
+    if (architecture === "multi") {
+      const clientEntry = join(srcDir, "client", "index.ts");
+      const serverEntry = join(srcDir, "server", "index.ts");
+      let clientElapsed = 0;
+      let serverElapsed = 0;
+      if (existsSync(clientEntry)) {
+        const clientStart = Date.now();
+        const clientResult = await Bun2.build({
+          entrypoints: [clientEntry],
+          naming: "index.js",
+          outdir: pOutDir,
+          target: "browser",
+          banner,
+          sourcemap: sourcemapMode,
+          minify: shouldMinify ? {
+            identifiers: shouldObfuscate,
+            syntax: true,
+            whitespace: true
+          } : false
+        });
+        if (!clientResult.success) {
+          console.error(clientResult.logs);
+          throw new AggregateError(clientResult.logs, "Multiplayer client build failed");
+        }
+        const clientSrc = join(srcDir, "client");
+        await copyStaticWebFiles(clientSrc, pOutDir, clientSrc);
+        const clientVendor = join(clientSrc, "vendor");
+        if (existsSync(clientVendor)) {
+          await copyDirectoryRecursive(clientVendor, join(pOutDir, "vendor"));
+        }
+        clientElapsed = Date.now() - clientStart;
+      }
+      if (existsSync(serverEntry)) {
+        const serverStart = Date.now();
+        const serverResult = await Bun2.build({
+          entrypoints: [serverEntry],
+          naming: "server.js",
+          outdir: pOutDir,
+          target: "node",
+          banner,
+          sourcemap: sourcemapMode,
+          minify: shouldMinify ? {
+            identifiers: shouldObfuscate,
+            syntax: true,
+            whitespace: true
+          } : false
+        });
+        if (!serverResult.success) {
+          console.error(serverResult.logs);
+          throw new AggregateError(serverResult.logs, "Multiplayer server build failed");
+        }
+        const settingsFile = join(srcDir, "server", "settings.json");
+        if (existsSync(settingsFile)) {
+          await fs.copyFile(settingsFile, join(pOutDir, "settings.json"));
+        }
+        serverElapsed = Date.now() - serverStart;
+      }
+      const rootFavicon = join(pProjectRoot, "favicon.ico");
+      if (existsSync(rootFavicon)) {
+        await fs.copyFile(rootFavicon, join(pOutDir, "favicon.ico"));
+      }
+      if (isVerbose) {
+        if (clientElapsed) {
+          console.log(source_default.hex("#ffa552")(`[Kit CLI] Multiplayer Client Build took: ${clientElapsed}ms`));
+        }
+        if (serverElapsed) {
+          console.log(source_default.hex("#ffa552")(`[Kit CLI] Multiplayer Server Build took: ${serverElapsed}ms`));
+        }
+      }
+      return {
+        architecture: "multi",
+        clientBuildTime: clientElapsed,
+        serverBuildTime: serverElapsed,
+        success: true
+      };
+    }
+    return { architecture: "none", success: true };
+  } catch (pError) {
+    console.error(source_default.hex("#c42847")(`[Kit CLI Build Error] ${pError}`));
+    return { architecture, success: false };
+  }
+}
+
 // src/cli/resource-builder.ts
 var log = console.log;
 var info = source_default.hex("#ffa552");
@@ -7999,7 +8201,9 @@ var isVerbose = false;
 var ignoringSound = false;
 var resourceInDirectory = "";
 var resourceOutDirectory = "";
+var customManifestPath = undefined;
 var resourcesToProcess = [];
+var subdirectoriesToMirror = [];
 function initializeResourceJSON() {
   return RESOURCE_TYPES.reduce((acc, type) => {
     acc[type] = [];
@@ -8007,7 +8211,7 @@ function initializeResourceJSON() {
   }, {});
 }
 function prepareFileForProcessing(pFilePath) {
-  const extension = extname(pFilePath).slice(1);
+  const extension = extname2(pFilePath).slice(1);
   const fileName = basename(pFilePath);
   const resourceIdentifier = `${v4_default()}.vyr`;
   const type = getResourceType(extension);
@@ -8043,13 +8247,19 @@ function getResourceType(pExtension) {
 }
 async function processDirectory(pDirectoryPath) {
   try {
-    const contents = await fs.readdir(pDirectoryPath);
+    const contents = await fs2.readdir(pDirectoryPath);
     for (const item of contents) {
-      const itemPath = join(pDirectoryPath, item);
-      const stats = await fs.stat(itemPath);
+      const itemPath = join2(pDirectoryPath, item);
+      if (resolve(itemPath) === resourceOutDirectory) {
+        continue;
+      }
+      const stats = await fs2.stat(itemPath);
       if (stats.isDirectory()) {
+        if (pDirectoryPath === resourceInDirectory) {
+          subdirectoriesToMirror.push(item);
+        }
         await processDirectory(itemPath);
-      } else if (isValidExtension(extname(itemPath).slice(1))) {
+      } else if (isValidExtension(extname2(itemPath).slice(1))) {
         prepareFileForProcessing(itemPath);
       }
     }
@@ -8060,6 +8270,22 @@ async function processDirectory(pDirectoryPath) {
 function isValidExtension(pExtension) {
   return VALID_EXTENSIONS.includes(pExtension);
 }
+async function mirrorDirectory(pSourceDir, pDestDir) {
+  const entries = await fs2.readdir(pSourceDir, { withFileTypes: true });
+  await fs2.mkdir(pDestDir, { recursive: true });
+  for (const entry of entries) {
+    const srcPath = join2(pSourceDir, entry.name);
+    const destPath = join2(pDestDir, entry.name);
+    if (entry.isDirectory()) {
+      await mirrorDirectory(srcPath, destPath);
+    } else {
+      const ext = extname2(entry.name).slice(1);
+      if (!isValidExtension(ext)) {
+        await fs2.copyFile(srcPath, destPath);
+      }
+    }
+  }
+}
 async function processAllFiles() {
   try {
     await clearResourceTypeDirectories(`${resourceOutDirectory}/resources`);
@@ -8069,11 +8295,16 @@ async function processAllFiles() {
       if (!resource) {
         throw new Error(`Resource not found for file: ${fileName}`);
       }
-      const destination = join(resourceOutDirectory, "resources");
+      const destination = join2(resourceOutDirectory, "resources");
       const resourceName = resource.resourceIdentifier;
       return copyFile(filePath, destination, resourceName);
     });
     await Promise.all(copyOperations);
+    for (const subDir of subdirectoriesToMirror) {
+      const srcPath = join2(resourceInDirectory, subDir);
+      const destPath = join2(resourceOutDirectory, "resources", subDir);
+      await mirrorDirectory(srcPath, destPath);
+    }
     logVerbose(`[Kit CLI] All resources have been processed.`);
     await saveResourceJSON();
     const boundsData = await buildBoundsJSON();
@@ -8093,7 +8324,7 @@ async function buildBoundsJSON() {
     if (type !== "icon")
       continue;
     try {
-      const fileBuffer = await fs.readFile(filePath);
+      const fileBuffer = await fs2.readFile(filePath);
       const vyi = new VYI().parse(fileBuffer);
       const atlasName = basename(filePath, ".vyi");
       const atlasEntry = {};
@@ -8134,7 +8365,7 @@ async function buildBoundsJSON() {
 async function saveBoundsJSON(pBoundsData) {
   const filePath = "bounds.json";
   try {
-    await fs.writeFile(filePath, JSON.stringify(pBoundsData));
+    await fs2.writeFile(filePath, JSON.stringify(pBoundsData));
   } catch (pError) {
     logError(`[Error] Saving bounds JSON: ${pError}`);
   }
@@ -8145,7 +8376,7 @@ async function buildIconPointsJSON() {
     if (type !== "icon")
       continue;
     try {
-      const fileBuffer = await fs.readFile(filePath);
+      const fileBuffer = await fs2.readFile(filePath);
       const vyi = new VYI().parse(fileBuffer);
       const atlasName = basename(filePath, ".vyi");
       const atlasEntry = {};
@@ -8204,7 +8435,7 @@ async function buildIconPointsJSON() {
 async function saveIconPointsJSON(pPointsData) {
   const filePath = "icon-points.json";
   try {
-    await fs.writeFile(filePath, JSON.stringify(pPointsData));
+    await fs2.writeFile(filePath, JSON.stringify(pPointsData));
   } catch (pError) {
     logError(`[Error] Saving icon points JSON: ${pError}`);
   }
@@ -8215,7 +8446,7 @@ async function buildSizesJSON() {
     if (type !== "icon")
       continue;
     try {
-      const fileBuffer = await fs.readFile(filePath);
+      const fileBuffer = await fs2.readFile(filePath);
       const vyi = new VYI().parse(fileBuffer);
       const atlasName = basename(filePath, ".vyi");
       const atlasEntry = {};
@@ -8237,16 +8468,16 @@ async function buildSizesJSON() {
 async function saveSizesJSON(pSizesData) {
   const filePath = "sizes.json";
   try {
-    await fs.writeFile(filePath, JSON.stringify(pSizesData));
+    await fs2.writeFile(filePath, JSON.stringify(pSizesData));
   } catch (pError) {
     logError(`[Error] Saving sizes JSON: ${pError}`);
   }
 }
 async function clearResourceTypeDirectories(pBaseDirectory) {
   try {
-    const directoryExists = await fs.stat(pBaseDirectory).then((stat) => stat.isDirectory()).catch(() => false);
+    const directoryExists = await fs2.stat(pBaseDirectory).then((stat) => stat.isDirectory()).catch(() => false);
     if (directoryExists) {
-      await fs.rm(pBaseDirectory, { recursive: true });
+      await fs2.rm(pBaseDirectory, { recursive: true });
     }
   } catch (pError) {
     log(`${error(`[Error]`)} clearing resource directory: ${pError}`);
@@ -8254,33 +8485,32 @@ async function clearResourceTypeDirectories(pBaseDirectory) {
 }
 async function copyFile(pSource, pDestinationDir, pNewName) {
   try {
-    await fs.mkdir(pDestinationDir, { recursive: true });
-    await fs.copyFile(pSource, join(pDestinationDir, pNewName));
+    await fs2.mkdir(pDestinationDir, { recursive: true });
+    await fs2.copyFile(pSource, join2(pDestinationDir, pNewName));
   } catch (pError) {
     logError(`[Error] Copying file ${pSource}: ${pError}`);
   }
 }
 async function saveResourceJSON() {
-  const filePath = "resource.json";
+  const jsonContent = JSON.stringify(resourceJSON, null, 4);
+  const targetPath = customManifestPath || "resource.json";
   try {
-    await fs.writeFile(filePath, JSON.stringify(resourceJSON, null, 4));
+    await fs2.writeFile(targetPath, jsonContent, "utf8");
   } catch (pError) {
-    logError(`[Error] Saving resource JSON: ${pError}`);
+    logError(`[Error] Saving resource JSON to ${targetPath}: ${pError}`);
   }
 }
-async function processResources({ inDirectory, outDirectory, verbose, ignoreSound }) {
-  resourceInDirectory = inDirectory;
-  resourceOutDirectory = outDirectory;
-  isVerbose = verbose;
-  ignoringSound = ignoreSound;
+var shouldBundleApp = false;
+var projectRootDirectory = "";
+var appBundleOptions = {};
+async function runBuild() {
   resourceJSON = initializeResourceJSON();
   resourcesToProcess.length = 0;
-  if (!resourceInDirectory || !resourceOutDirectory) {
-    logError("[Error] Input and output directories must be specified");
-    return;
+  subdirectoriesToMirror.length = 0;
+  if (existsSync2(resourceInDirectory)) {
+    await processDirectory(resourceInDirectory);
   }
-  await processDirectory(resourceInDirectory);
-  if (resourcesToProcess.length > 0) {
+  if (resourcesToProcess.length > 0 || subdirectoriesToMirror.length > 0) {
     await processAllFiles();
   } else {
     logAlert("No resources found!");
@@ -8289,6 +8519,79 @@ async function processResources({ inDirectory, outDirectory, verbose, ignoreSoun
     await saveIconPointsJSON({});
     await saveSizesJSON({});
   }
+  if (shouldBundleApp && projectRootDirectory) {
+    await bundleApp(projectRootDirectory, resourceOutDirectory, {
+      ...appBundleOptions,
+      verbose: Boolean(isVerbose)
+    });
+  }
+  logVerbose(`[Kit CLI] Resources built successfully.`);
+}
+async function runWatch() {
+  await runBuild();
+  console.log(source_default.cyan(`
+\uD83D\uDC40 Watching for changes in: ${source_default.bold(resourceInDirectory)}`));
+  let debounceTimer = null;
+  const triggerRebuild = (pFilename) => {
+    if (debounceTimer)
+      clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(async () => {
+      console.log(source_default.dim(`
+File changed: ${pFilename}, rebuilding...`));
+      await runBuild();
+    }, 150);
+  };
+  const watchers = [];
+  if (existsSync2(resourceInDirectory)) {
+    const resWatcher = fsWatch(resourceInDirectory, { recursive: true }, (_eventType, pFilename) => {
+      if (pFilename)
+        triggerRebuild(pFilename);
+    });
+    watchers.push(resWatcher);
+  }
+  const srcDir = join2(projectRootDirectory, "src");
+  if (shouldBundleApp && existsSync2(srcDir) && srcDir !== resourceInDirectory) {
+    const srcWatcher = fsWatch(srcDir, { recursive: true }, (_eventType, pFilename) => {
+      if (!pFilename)
+        return;
+      if (pFilename.startsWith("resources"))
+        return;
+      triggerRebuild(pFilename);
+    });
+    watchers.push(srcWatcher);
+  }
+  process.on("SIGINT", () => {
+    for (const w of watchers)
+      w.close();
+    process.exit(0);
+  });
+}
+async function processResources({ inDirectory, outDirectory, manifestPath, watch, verbose, ignoreSound, app, minify, obfuscate, sourcemap, prod }) {
+  projectRootDirectory = process.cwd();
+  const resolvedIn = inDirectory || (existsSync2(join2(projectRootDirectory, "src", "resources")) ? "src/resources" : "");
+  const resolvedOut = outDirectory || "dist";
+  resourceInDirectory = resolvedIn ? resolve(resolvedIn) : "";
+  resourceOutDirectory = resolvedOut ? resolve(resolvedOut) : "";
+  customManifestPath = manifestPath;
+  isVerbose = verbose;
+  ignoringSound = ignoreSound;
+  appBundleOptions = {
+    minify,
+    obfuscate,
+    sourcemap,
+    prod
+  };
+  const hasAppEntry = existsSync2(join2(projectRootDirectory, "src", "index.ts")) || existsSync2(join2(projectRootDirectory, "src", "client", "index.ts")) || existsSync2(join2(projectRootDirectory, "src", "server", "index.ts"));
+  shouldBundleApp = app !== undefined ? app : hasAppEntry;
+  if (!resourceInDirectory || !resourceOutDirectory) {
+    logError("[Error] Input and output directories must be specified");
+    return;
+  }
+  if (watch) {
+    await runWatch();
+  } else {
+    await runBuild();
+  }
 }
 function logVerbose(pMessage) {
   if (isVerbose)
@@ -8303,11 +8606,11 @@ function logAlert(pMessage) {
 
 // node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
-import { styleText as D } from "node:util";
-import { stdout as R, stdin as q } from "node:process";
-import * as k from "node:readline";
-import ot from "node:readline";
-import { ReadStream as J } from "node:tty";
+import { styleText as D } from "util";
+import { stdout as R, stdin as q } from "process";
+import * as k from "readline";
+import ot from "readline";
+import { ReadStream as J } from "tty";
 function x(t, e, s) {
   if (!s.some((u) => !u.disabled))
     return t;
@@ -8391,7 +8694,7 @@ var X = (t, e = {}, s = {}) => {
 var pt = { limit: 1 / 0, ellipsis: "", ellipsisWidth: 0 };
 var S = (t, e = {}) => X(t, pt, e).width;
 var T = "\x1B";
-var Z = "›";
+var Z = "\x9B";
 var Ft = 39;
 var j = "\x07";
 var Q = "[";
@@ -8712,7 +9015,7 @@ class Vt extends B {
     if (!this.userInput)
       return D(["inverse", "hidden"], "_");
     if (this._cursor >= this.userInput.length)
-      return `${this.userInput}█`;
+      return `${this.userInput}\u2588`;
     const e = this.userInput.slice(0, this._cursor), [s, ...i] = this.userInput.slice(this._cursor);
     return `${e}${D("inverse", s)}${i.join("")}`;
   }
@@ -8855,7 +9158,7 @@ class $t extends B {
       return this.userInput;
     const e = this.userInput;
     if (this.cursor >= e.length)
-      return `${this.userInput}█`;
+      return `${this.userInput}\u2588`;
     const s = e.slice(0, this.cursor), [i, ...r] = e.slice(this.cursor);
     return `${s}${D("inverse", i)}${r.join("")}`;
   }
@@ -8872,8 +9175,8 @@ class $t extends B {
 }
 
 // node_modules/@clack/prompts/dist/index.mjs
-import { styleText as t, stripVTControlCharacters as ue } from "node:util";
-import N2 from "node:process";
+import { styleText as t, stripVTControlCharacters as ue } from "util";
+import N2 from "process";
 var import_sisteransi2 = __toESM(require_src(), 1);
 function pt2() {
   return N2.platform !== "win32" ? N2.env.TERM !== "linux" : !!N2.env.CI || !!N2.env.WT_SESSION || !!N2.env.TERMINUS_SUBLIME || N2.env.ConEmuTask === "{cmd::Cmder}" || N2.env.TERM_PROGRAM === "Terminus-Sublime" || N2.env.TERM_PROGRAM === "vscode" || N2.env.TERM === "xterm-256color" || N2.env.TERM === "alacritty" || N2.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
@@ -8881,31 +9184,31 @@ function pt2() {
 var ee = pt2();
 var ce = () => process.env.CI === "true";
 var I2 = (e, r) => ee ? e : r;
-var Re = I2("◆", "*");
-var $e = I2("■", "x");
-var de = I2("▲", "x");
-var V = I2("◇", "o");
-var he = I2("┌", "T");
-var h = I2("│", "|");
-var x2 = I2("└", "—");
-var Oe = I2("┐", "T");
-var Pe = I2("┘", "—");
-var z2 = I2("●", ">");
-var H2 = I2("○", " ");
-var te = I2("◻", "[•]");
-var U2 = I2("◼", "[+]");
-var q2 = I2("◻", "[ ]");
-var Ne = I2("▪", "•");
-var se = I2("─", "-");
-var pe = I2("╮", "+");
-var We = I2("├", "+");
-var me = I2("╯", "+");
-var ge = I2("╰", "+");
-var Ge = I2("╭", "+");
-var fe = I2("●", "•");
-var Fe = I2("◆", "*");
-var ye = I2("▲", "!");
-var Ee = I2("■", "x");
+var Re = I2("\u25C6", "*");
+var $e = I2("\u25A0", "x");
+var de = I2("\u25B2", "x");
+var V = I2("\u25C7", "o");
+var he = I2("\u250C", "T");
+var h = I2("\u2502", "|");
+var x2 = I2("\u2514", "\u2014");
+var Oe = I2("\u2510", "T");
+var Pe = I2("\u2518", "\u2014");
+var z2 = I2("\u25CF", ">");
+var H2 = I2("\u25CB", " ");
+var te = I2("\u25FB", "[\u2022]");
+var U2 = I2("\u25FC", "[+]");
+var q2 = I2("\u25FB", "[ ]");
+var Ne = I2("\u25AA", "\u2022");
+var se = I2("\u2500", "-");
+var pe = I2("\u256E", "+");
+var We = I2("\u251C", "+");
+var me = I2("\u256F", "+");
+var ge = I2("\u2570", "+");
+var Ge = I2("\u256D", "+");
+var fe = I2("\u25CF", "\u2022");
+var Fe = I2("\u25C6", "*");
+var ye = I2("\u25B2", "!");
+var Ee = I2("\u25A0", "x");
 var W2 = (e) => {
   switch (e) {
     case "initial":
@@ -9009,7 +9312,7 @@ var Le = (e, r = {}, s = {}) => {
 var Et2 = { limit: 1 / 0, ellipsis: "", ellipsisWidth: 0 };
 var D2 = (e, r = {}) => Le(e, Et2, r).width;
 var ae = "\x1B";
-var je = "›";
+var je = "\x9B";
 var vt2 = 39;
 var Ce = "\x07";
 var ke = "[";
@@ -9212,7 +9515,7 @@ ${t("gray", f + se.repeat(n + 2) + me)}
 `);
 };
 var Kt = (e) => t("magenta", e);
-var be = ({ indicator: e = "dots", onCancel: r, output: s = process.stdout, cancelMessage: i, errorMessage: a, frames: o = ee ? ["◒", "◐", "◓", "◑"] : ["•", "o", "O", "0"], delay: u = ee ? 80 : 120, signal: l, ...n } = {}) => {
+var be = ({ indicator: e = "dots", onCancel: r, output: s = process.stdout, cancelMessage: i, errorMessage: a, frames: o = ee ? ["\u25D2", "\u25D0", "\u25D3", "\u25D1"] : ["\u2022", "o", "O", "0"], delay: u = ee ? 80 : 120, signal: l, ...n } = {}) => {
   const c = ce();
   let p, f, g = false, E = false, $ = "", m, d = performance.now();
   const F = rt(s), y2 = n?.styleFrame ?? Kt, v = (B2) => {
@@ -9269,7 +9572,7 @@ var be = ({ indicator: e = "dots", onCancel: r, output: s = process.stdout, canc
     return E;
   } };
 };
-var ze = { light: I2("─", "-"), heavy: I2("━", "="), block: I2("█", "#") };
+var ze = { light: I2("\u2500", "-"), heavy: I2("\u2501", "="), block: I2("\u2588", "#") };
 var oe = (e, r) => e.includes(`
 `) ? e.split(`
 `).map((s) => r(s)).join(`
@@ -9347,15 +9650,15 @@ ${l}
 } }).prompt();
 
 // src/cli/init.ts
-import fs2 from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync, execSync } from "node:child_process";
-import os2 from "node:os";
+import fs3 from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { spawnSync, execSync } from "child_process";
+import os2 from "os";
 // package.json
 var package_default = {
   name: "@evitcastudio/kit",
-  version: "3.1.1",
+  version: "3.2.1",
   author: "doubleactii 56242467+doubleactii@users.noreply.github.com (https://evitcastudio.com)",
   main: "./lib/index.js",
   types: "./lib/index.d.ts",
@@ -9455,15 +9758,15 @@ function installBun() {
   }
 }
 function copyTemplate(pSrc, pDest, pProjectName, pVersion, pAuthor) {
-  if (!fs2.existsSync(pDest)) {
-    fs2.mkdirSync(pDest, { recursive: true });
+  if (!fs3.existsSync(pDest)) {
+    fs3.mkdirSync(pDest, { recursive: true });
   }
-  const files = fs2.readdirSync(pSrc);
+  const files = fs3.readdirSync(pSrc);
   for (const file of files) {
     const srcPath = path.join(pSrc, file);
     const destFile = file === "_gitignore" ? ".gitignore" : file;
     const destPath = path.join(pDest, destFile);
-    const stats = fs2.statSync(srcPath);
+    const stats = fs3.statSync(srcPath);
     if (stats.isDirectory()) {
       if (file === ".git")
         continue;
@@ -9472,13 +9775,13 @@ function copyTemplate(pSrc, pDest, pProjectName, pVersion, pAuthor) {
       const ext = path.extname(file).toLowerCase();
       const textExtensions = [".ts", ".js", ".json", ".html", ".css", ".md", ".txt"];
       if (textExtensions.includes(ext)) {
-        let content = fs2.readFileSync(srcPath, "utf8");
+        let content = fs3.readFileSync(srcPath, "utf8");
         content = content.replace(/{{PROJECT_NAME}}/g, pProjectName);
         content = content.replace(/{{VERSION}}/g, pVersion);
         content = content.replace(/{{PROJECT_AUTHOR}}/g, pAuthor);
-        fs2.writeFileSync(destPath, content);
+        fs3.writeFileSync(destPath, content);
       } else {
-        fs2.copyFileSync(srcPath, destPath);
+        fs3.copyFileSync(srcPath, destPath);
       }
     }
   }
@@ -9509,7 +9812,9 @@ Note: Kit projects cannot build or run without Bun.`);
   }
   let projectName = pOptions.projectName;
   let gameType = "single";
-  if (!pOptions.single && !pOptions.multi && !projectName) {
+  let shouldInstall = Boolean(pOptions.install);
+  const isInteractive = !pOptions.single && !pOptions.multi && !projectName;
+  if (isInteractive) {
     const name = await Zt({
       message: "What is the name of your project?",
       placeholder: "my-amazing-project",
@@ -9538,6 +9843,13 @@ Note: Kit projects cannot build or run without Bun.`);
       process.exit(0);
     }
     gameType = type;
+    const installChoice = await Rt({
+      message: "Install dependencies with Bun now?",
+      initialValue: true
+    });
+    if (!Ct(installChoice)) {
+      shouldInstall = Boolean(installChoice);
+    }
   } else {
     if (pOptions.single)
       gameType = "single";
@@ -9549,32 +9861,38 @@ Note: Kit projects cannot build or run without Bun.`);
       projectName = "kit-project";
   }
   const projectDir = path.join(process.cwd(), projectName);
-  if (fs2.existsSync(projectDir)) {
-    const overwrite = await Rt({
-      message: `Directory ${source_default.cyan(projectName)} already exists. Overwrite?`,
-      initialValue: false
-    });
-    if (Ct(overwrite) || !overwrite) {
-      Nt("Installation aborted.");
-      process.exit(0);
+  if (fs3.existsSync(projectDir)) {
+    if (isInteractive) {
+      const overwrite = await Rt({
+        message: `Directory ${source_default.cyan(projectName)} already exists. Overwrite?`,
+        initialValue: false
+      });
+      if (Ct(overwrite) || !overwrite) {
+        Nt("Installation aborted.");
+        process.exit(0);
+      }
+    } else if (!pOptions.force) {
+      console.error(source_default.red(`
+Error: Destination directory '${projectName}' already exists. Use --force (-f) to overwrite.`));
+      process.exit(1);
     }
   }
   const s = be();
   s.start(`Scaffolding ${source_default.cyan(projectName)}...`);
   try {
     const projectPath = path.join(process.cwd(), projectName);
-    if (fs2.existsSync(projectPath)) {
-      fs2.rmSync(projectPath, { recursive: true, force: true });
+    if (fs3.existsSync(projectPath)) {
+      fs3.rmSync(projectPath, { recursive: true, force: true });
     }
-    fs2.mkdirSync(projectPath, { recursive: true });
+    fs3.mkdirSync(projectPath, { recursive: true });
     let templateType = gameType;
     if (gameType === "both")
       templateType = "multi";
     const templatesDir = path.join(path.dirname(fileURLToPath(import.meta.url)), "kit-game-templates", templateType);
     const author = getGitUser();
-    if (!fs2.existsSync(templatesDir)) {
+    if (!fs3.existsSync(templatesDir)) {
       const localTemplatesDir = path.join(process.cwd(), "kit-game-templates", templateType);
-      if (!fs2.existsSync(localTemplatesDir)) {
+      if (!fs3.existsSync(localTemplatesDir)) {
         console.error(source_default.red(`Error: Templates not found at ${templatesDir} or ${localTemplatesDir}`));
         process.exit(1);
       }
@@ -9592,19 +9910,33 @@ Note: Kit projects cannot build or run without Bun.`);
     } catch {
     }
     s.stop(`Project ${source_default.green(projectName)} created!`);
-    console.log(`${source_default.cyan("│")}`);
-    console.log(`${source_default.cyan("│")}  ${source_default.white.bold("Next steps:")}`);
-    console.log(`${source_default.cyan("│")}  ${source_default.dim("1.")} cd ${source_default.cyan(projectName)}`);
-    console.log(`${source_default.cyan("│")}  ${source_default.dim("2.")} bun install`);
-    console.log(`${source_default.cyan("│")}  ${source_default.dim("3.")} bun run build`);
-    console.log(`${source_default.cyan("│")}`);
+    if (shouldInstall) {
+      const installSpinner = be();
+      installSpinner.start("Installing project dependencies with Bun...");
+      const installResult = spawnSync("bun", ["install"], { cwd: projectPath, stdio: "ignore", shell: true });
+      if (installResult.status === 0) {
+        installSpinner.stop(source_default.green("Dependencies installed successfully!"));
+      } else {
+        installSpinner.stop(source_default.yellow("Dependency installation finished with warnings."));
+      }
+    }
+    console.log(`${source_default.cyan("\u2502")}`);
+    console.log(`${source_default.cyan("\u2502")}  ${source_default.white.bold("Next steps:")}`);
+    console.log(`${source_default.cyan("\u2502")}  ${source_default.dim("1.")} cd ${source_default.cyan(projectName)}`);
+    if (!shouldInstall) {
+      console.log(`${source_default.cyan("\u2502")}  ${source_default.dim("2.")} bun install`);
+      console.log(`${source_default.cyan("\u2502")}  ${source_default.dim("3.")} bun run build`);
+    } else {
+      console.log(`${source_default.cyan("\u2502")}  ${source_default.dim("2.")} bun run build`);
+    }
+    console.log(`${source_default.cyan("\u2502")}`);
     Gt(source_default.green.bold("Happy coding!"));
   } catch (pError) {
     s.stop(source_default.red("Scaffolding failed."));
     if (projectName) {
       const projectPath = path.join(process.cwd(), projectName);
-      if (fs2.existsSync(projectPath)) {
-        fs2.rmSync(projectPath, { recursive: true, force: true });
+      if (fs3.existsSync(projectPath)) {
+        fs3.rmSync(projectPath, { recursive: true, force: true });
       }
     }
     console.error(pError);
@@ -9612,6 +9944,361 @@ Note: Kit projects cannot build or run without Bun.`);
   }
 }
 
+// src/cli/doctor.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync3, readFileSync } from "fs";
+import { join as join3 } from "path";
+async function processDoctor(pOptions = {}) {
+  const isVerbose2 = Boolean(pOptions.verbose);
+  const results = [];
+  console.log(`
+  ${source_default.cyan.bold("Kit Doctor")} ${source_default.dim("-")} Environment & Project Health Check
+`);
+  const bunCheck = spawnSync2("bun", ["--version"], { encoding: "utf8", shell: true });
+  if (!bunCheck.error && bunCheck.status === 0) {
+    results.push({
+      category: "Runtime",
+      title: "Bun Runtime",
+      passed: true,
+      details: `Installed version v${bunCheck.stdout.trim()}`
+    });
+  } else {
+    results.push({
+      category: "Runtime",
+      title: "Bun Runtime",
+      passed: false,
+      details: "Bun is not installed or not in PATH. Download at https://bun.sh/"
+    });
+  }
+  const gitCheck = spawnSync2("git", ["--version"], { encoding: "utf8", shell: true });
+  if (!gitCheck.error && gitCheck.status === 0) {
+    results.push({
+      category: "VCS",
+      title: "Git Installation",
+      passed: true,
+      details: gitCheck.stdout.trim()
+    });
+  } else {
+    results.push({
+      category: "VCS",
+      title: "Git Installation",
+      passed: false,
+      details: "Git was not found in your PATH."
+    });
+  }
+  const cwd = process.cwd();
+  const pkgPath = join3(cwd, "package.json");
+  const hasPackageJson = existsSync3(pkgPath);
+  if (hasPackageJson) {
+    try {
+      const rawPkg = readFileSync(pkgPath, "utf8");
+      const pkg = JSON.parse(rawPkg);
+      const hasKitDependency = Boolean(pkg.dependencies && pkg.dependencies["@evitcastudio/kit"] || pkg.devDependencies && pkg.devDependencies["@evitcastudio/kit"] || pkg.name === "@evitcastudio/kit");
+      results.push({
+        category: "Project",
+        title: "package.json configuration",
+        passed: true,
+        details: `Project name: ${pkg.name || "unnamed"}`
+      });
+      results.push({
+        category: "Project",
+        title: "Kit framework dependency",
+        passed: hasKitDependency,
+        details: hasKitDependency ? "Found @evitcastudio/kit in project configuration" : "Missing @evitcastudio/kit dependency in package.json"
+      });
+      const isKitCoreRepo = pkg.name === "@evitcastudio/kit";
+      if (!isKitCoreRepo) {
+        const resourcesDir = join3(cwd, "src", "resources");
+        const hasResources = existsSync3(resourcesDir);
+        results.push({
+          category: "Project",
+          title: "Asset Directory (src/resources)",
+          passed: hasResources,
+          details: hasResources ? "Asset directory present" : "src/resources not found"
+        });
+      }
+      const hasClientEntry = existsSync3(join3(cwd, "src", "client", "index.ts"));
+      const hasServerEntry = existsSync3(join3(cwd, "src", "server", "index.ts"));
+      const hasSingleEntry = existsSync3(join3(cwd, "src", "index.ts"));
+      let projectType = "Unknown";
+      if (hasClientEntry && hasServerEntry) {
+        projectType = "Multiplayer (Client & Server)";
+      } else if (hasClientEntry) {
+        projectType = "Multiplayer (Client)";
+      } else if (hasServerEntry) {
+        projectType = "Dedicated Server";
+      } else if (hasSingleEntry) {
+        projectType = "Singleplayer";
+      }
+      results.push({
+        category: "Project",
+        title: "Project Architecture",
+        passed: projectType !== "Unknown" || isKitCoreRepo,
+        details: isKitCoreRepo ? "Kit Core Framework Repository" : `Detected Type: ${projectType}`
+      });
+    } catch {
+      results.push({
+        category: "Project",
+        title: "package.json format",
+        passed: false,
+        details: "package.json is malformed or invalid JSON"
+      });
+    }
+    const buildScript = join3(cwd, "bun-build.ts");
+    const hasBuildScript = existsSync3(buildScript);
+    let hasKitBuildScript = false;
+    try {
+      const rawPkg = readFileSync(pkgPath, "utf8");
+      const pkg = JSON.parse(rawPkg);
+      if (pkg.scripts && typeof pkg.scripts.build === "string" && pkg.scripts.build.includes("kit build")) {
+        hasKitBuildScript = true;
+      }
+    } catch {
+    }
+    const buildPipelinePassed = hasBuildScript || hasKitBuildScript;
+    let buildDetails = "No build pipeline configured";
+    if (hasKitBuildScript && hasBuildScript) {
+      buildDetails = "Kit CLI build pipeline with bun-build.ts present";
+    } else if (hasKitBuildScript) {
+      buildDetails = "Kit CLI native build pipeline configured";
+    } else if (hasBuildScript) {
+      buildDetails = "Legacy bun-build.ts present";
+    }
+    results.push({
+      category: "Project",
+      title: "Build Pipeline",
+      passed: buildPipelinePassed,
+      details: buildDetails
+    });
+  } else {
+    results.push({
+      category: "Project",
+      title: "Project Context",
+      passed: true,
+      details: "Not currently executed inside a Node/Bun project root."
+    });
+  }
+  let allPassed = true;
+  for (const res of results) {
+    const icon = res.passed ? source_default.green("\u2713") : source_default.red("\u2717");
+    const titleText = res.passed ? source_default.white(res.title) : source_default.red.bold(res.title);
+    console.log(`  ${icon} [${source_default.cyan(res.category)}] ${titleText}`);
+    if (res.details && (!res.passed || isVerbose2)) {
+      console.log(`    ${source_default.dim(res.details)}`);
+    }
+    if (!res.passed) {
+      allPassed = false;
+    }
+  }
+  console.log(`
+`);
+  if (allPassed) {
+    console.log(`  ${source_default.green.bold("All doctor diagnostics passed!")}
+`);
+  } else {
+    console.log(`  ${source_default.yellow.bold("Some issues were detected. Check the items above.")}
+`);
+  }
+  return allPassed;
+}
+
+// src/cli/create.ts
+import { promises as fs4 } from "fs";
+import { join as join4 } from "path";
+function toPascalCase(pName) {
+  return pName.replace(/[-_](\w)/g, (_2, c) => c.toUpperCase()).replace(/^\w/, (c) => c.toUpperCase());
+}
+function toKebabCase(pName) {
+  return pName.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+}
+function generatePluginSource(pClassName, pPluginName) {
+  return `import { KitPlugin } from '@evitcastudio/kit';
+
+/**
+ * ${pClassName} plugin for the Kit framework.
+ */
+export class ${pClassName} extends KitPlugin {
+    /**
+     * Unique name identifier of the plugin.
+     */
+    readonly name = '${pPluginName}';
+
+    /**
+     * Entry point for custom initialization when the plugin is registered with Kit.
+     */
+    onRegistered(): void {
+        // Initialize plugin logic
+    }
+}
+`;
+}
+async function processCreate(pOptions) {
+  const { type, name, verbose } = pOptions;
+  if (!type || !name) {
+    console.error(source_default.red(`
+Error: Both type and name are required. Usage: kit create <type> <name>`));
+    process.exit(1);
+  }
+  const normalizedType = type.toLowerCase();
+  if (normalizedType !== "plugin") {
+    console.error(source_default.red(`
+Error: Unknown create type '${type}'. Supported types: 'plugin'`));
+    process.exit(1);
+  }
+  const className = toPascalCase(name);
+  const fileName = `${toKebabCase(name)}.ts`;
+  const pluginsDir = join4(process.cwd(), "src", "plugins");
+  const targetPath = join4(pluginsDir, fileName);
+  try {
+    await fs4.mkdir(pluginsDir, { recursive: true });
+    const fileExists = await fs4.stat(targetPath).then(() => true).catch(() => false);
+    if (fileExists) {
+      console.error(source_default.red(`
+Error: File already exists at ${targetPath}`));
+      process.exit(1);
+    }
+    const sourceCode = generatePluginSource(className, className);
+    await fs4.writeFile(targetPath, sourceCode, "utf8");
+    console.log(`
+  ${source_default.green("\u2713")} Created plugin ${source_default.cyan(className)} at ${source_default.dim(targetPath)}
+`);
+    if (verbose) {
+      console.log(source_default.dim(sourceCode));
+    }
+  } catch (pError) {
+    const message = pError instanceof Error ? pError.message : String(pError);
+    console.error(source_default.red(`
+Error creating plugin: ${message}`));
+    process.exit(1);
+  }
+}
+
+// src/cli/host.ts
+import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
+import { join as join5, resolve as resolve2 } from "path";
+import { networkInterfaces } from "os";
+function getNetworkAddress() {
+  const interfaces = networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    const netList = interfaces[name];
+    if (!netList)
+      continue;
+    for (const net of netList) {
+      if (net.family === "IPv4" && !net.internal) {
+        return net.address;
+      }
+    }
+  }
+  return "localhost";
+}
+async function processHost(pOptions = {}) {
+  const cwd = process.cwd();
+  const defaultPort = 8090;
+  const port = pOptions.port || defaultPort;
+  const distDir = pOptions.directory ? resolve2(pOptions.directory) : join5(cwd, "dist");
+  const architecture = detectArchitecture(join5(cwd, "src"));
+  if (!existsSync4(distDir)) {
+    const message = `Target directory "${distDir}" does not exist. Run "kit build" or use "kit host -b" first.`;
+    console.error(source_default.red(`
+[Kit Host] ${message}
+`));
+    return { success: false, message };
+  }
+  if (architecture === "multi") {
+    const serverJsPath = join5(distDir, "server.js");
+    if (!existsSync4(serverJsPath)) {
+      const message = `Cannot host multiplayer project: "${serverJsPath}" was not found. Please compile the server first using "kit build".`;
+      console.error(source_default.red(`
+[Kit Host] ${message}
+`));
+      return { success: false, message };
+    }
+    console.log(source_default.cyan(`
+\uD83C\uDFAE Starting Multiplayer Server from ${source_default.bold(distDir)}...
+`));
+    let serverSettingsPort = port;
+    const settingsPath = join5(distDir, "settings.json");
+    if (existsSync4(settingsPath)) {
+      try {
+        const settings = JSON.parse(readFileSync2(settingsPath, "utf8"));
+        if (settings.port)
+          serverSettingsPort = Number(settings.port);
+      } catch {
+      }
+    }
+    const proc = Bun.spawn(["node", "server.js"], {
+      cwd: distDir,
+      stdout: "inherit",
+      stderr: "inherit",
+      stdin: "inherit"
+    });
+    console.log(source_default.green(`\u2713 Multiplayer server process spawned (configured port: ${serverSettingsPort})`));
+    process.on("SIGINT", () => {
+      proc.kill();
+      process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+      proc.kill();
+      process.exit(0);
+    });
+    await proc.exited;
+    return { success: true, message: "Multiplayer server finished running." };
+  }
+  const indexPath = join5(distDir, "index.html");
+  if (!existsSync4(indexPath)) {
+    const message = `Missing entrypoint: "${indexPath}" was not found in dist. Run "kit build" or use "kit host -b" to compile.`;
+    console.error(source_default.red(`
+[Kit Host] ${message}
+`));
+    return { success: false, message };
+  }
+  const lanIp = getNetworkAddress();
+  const server = Bun.serve({
+    port,
+    async fetch(pReq) {
+      const path2 = new URL(pReq.url).pathname;
+      const target = path2 === "/" ? "/index.html" : decodeURIComponent(path2);
+      const file = Bun.file(join5(distDir, target));
+      if (!await file.exists()) {
+        if (pOptions.verbose) {
+          console.warn(source_default.yellow(`[Kit Host] 404 Not Found: ${target}`));
+        }
+        return new Response("Not Found", { status: 404 });
+      }
+      return new Response(file);
+    }
+  });
+  console.log(source_default.cyan(`
+\uD83C\uDFAE Kit Game Host Server
+`));
+  console.log(`  ${source_default.bold("Local:")}    ${source_default.green(`http://localhost:${server.port}`)}`);
+  if (lanIp !== "localhost") {
+    console.log(`  ${source_default.bold("Network:")}  ${source_default.green(`http://${lanIp}:${server.port}`)}`);
+  }
+  console.log(source_default.dim(`
+Serving files from: ${distDir}`));
+  console.log(source_default.dim(`Press Ctrl+C to stop the server
+`));
+  process.on("SIGINT", () => {
+    console.log(source_default.yellow(`
+Shutting down host server...`));
+    server.stop();
+    process.exit(0);
+  });
+  process.on("SIGTERM", () => {
+    server.stop();
+    process.exit(0);
+  });
+  return {
+    success: true,
+    message: `Serving files on port ${server.port}`,
+    server: {
+      stop: () => server.stop(),
+      port: server.port
+    }
+  };
+}
+
 // src/cli/main.ts
 class KitCLI {
   static async processResources(pProcessOptions) {
@@ -9620,6 +10307,15 @@ class KitCLI {
   static async init(pInitOptions) {
     await processInit(pInitOptions);
   }
+  static async doctor(pDoctorOptions = {}) {
+    return await processDoctor(pDoctorOptions);
+  }
+  static async create(pCreateOptions) {
+    await processCreate(pCreateOptions);
+  }
+  static async host(pHostOptions = {}) {
+    return await processHost(pHostOptions);
+  }
 }
 
 // bin/cli.ts
@@ -9682,17 +10378,33 @@ var formatHelp = (pCmd) => {
     }
   }
   const name = pCmd.name();
-  if (isRoot || name === "init" || name === "build") {
+  if (isRoot || name === "init" || name === "build" || name === "create" || name === "doctor") {
     output += `  ${source_default.white.bold("Examples:")}
 `;
     if (isRoot || name === "init") {
       output += `    ${source_default.cyan("kit init")}
 `;
-      output += `    ${source_default.cyan("kit init my-game --single")}
+      output += `    ${source_default.cyan("kit init my-game --single --install")}
 `;
     }
     if (isRoot || name === "build") {
-      output += `    ${source_default.cyan("kit build --in ./src --out ./dist")}
+      output += `    ${source_default.cyan("kit build --in ./src/resources --out ./dist")}
+`;
+      output += `    ${source_default.cyan("kit build --in ./src/resources --out ./dist --watch")}
+`;
+    }
+    if (isRoot || name === "create") {
+      output += `    ${source_default.cyan("kit create plugin Inventory")}
+`;
+    }
+    if (isRoot || name === "doctor") {
+      output += `    ${source_default.cyan("kit doctor")}
+`;
+    }
+    if (isRoot || name === "host") {
+      output += `    ${source_default.cyan("kit host")}
+`;
+      output += `    ${source_default.cyan("kit host -p 8080 -b")}
 `;
     }
     if (isRoot) {
@@ -9708,9 +10420,9 @@ var formatHelp = (pCmd) => {
   }
   return output;
 };
-program2.name("cli").version(`${package_default.version}`).description(package_default["cli-description"]).option("-v, --verbose", "Enable verbose mode for debugging", false);
+program2.name("kit").version(`${package_default.version}`).description(package_default["cli-description"]).option("-v, --verbose", "Enable verbose mode for debugging", false);
 program2.helpInformation = () => formatHelp(program2);
-var initCommand = program2.command("init [name]").description("Initialize a new Kit project").option("-s, --single", "Quick-start a single player project").option("-m, --multi", "Quick-start a multiplayer project").action(async (pName, pCmdOptions) => {
+var initCommand = program2.command("init [name]").description("Initialize a new Kit project").option("-s, --single", "Quick-start a single player project").option("-m, --multi", "Quick-start a multiplayer project").option("-f, --force", "Force overwrite if destination already exists", false).option("-i, --install", "Automatically install dependencies using Bun", false).action(async (pName, pCmdOptions) => {
   if (pName === "help") {
     console.log(initCommand.helpInformation());
     return;
@@ -9719,31 +10431,70 @@ var initCommand = program2.command("init [name]").description("Initialize a new
     projectName: pName,
     single: pCmdOptions.single,
     multi: pCmdOptions.multi,
+    force: pCmdOptions.force,
+    install: pCmdOptions.install,
     verbose: program2.opts().verbose
   });
 });
 initCommand.helpInformation = () => formatHelp(initCommand);
-var buildCommand = program2.command("build [help]").description("Build resources from the specified directory").option("-i, --in <path>", "Input directory (required)").option("-o, --out <path>", "Output directory (required)").option("-is, --ignore-sound", "Ignore sound files", false).action((pHelp, pCmdOptions) => {
+var buildCommand = program2.command("build [help]").description("Build resources and bundle game application").option("-i, --in <path>", "Input directory (defaults to ./src/resources)").option("-o, --out <path>", "Output directory (defaults to ./dist)").option("-m, --manifest <path>", "Custom manifest file path").option("-w, --watch", "Watch files for changes and rebuild automatically", false).option("-is, --ignore-sound", "Ignore sound files", false).option("--app", "Bundle game code and static assets (enabled by default when project entrypoints exist)").option("--no-app", "Disable game code bundling and only process resources").option("-p, --prod", "Production build: enables minification, identifier obfuscation, and strips sourcemaps", false).option("--minify", "Minify bundled JavaScript syntax, whitespace, and identifiers", false).option("--obfuscate", "Mangle and obfuscate variable and property identifiers", false).option("--sourcemap <mode>", "Sourcemap generation mode (none, linked, inline, external)").action((pHelp, pCmdOptions) => {
   if (pHelp === "help") {
     console.log(buildCommand.helpInformation());
     return;
   }
   const verbose = program2.opts().verbose;
-  if (!pCmdOptions.in || !pCmdOptions.out) {
-    console.error(source_default.red(`
-  Error: --in and --out are required flags for the build command.`));
-    console.log(buildCommand.helpInformation());
-    process.exit(1);
-  }
   const processOptions = {
     inDirectory: pCmdOptions.in,
     outDirectory: pCmdOptions.out,
+    manifestPath: pCmdOptions.manifest,
+    watch: pCmdOptions.watch || false,
     ignoreSound: pCmdOptions.ignoreSound || false,
+    app: pCmdOptions.app,
+    minify: pCmdOptions.minify || false,
+    obfuscate: pCmdOptions.obfuscate || false,
+    sourcemap: pCmdOptions.sourcemap,
+    prod: pCmdOptions.prod || false,
     verbose: verbose || false
   };
   KitCLI.processResources(processOptions);
 });
 buildCommand.helpInformation = () => formatHelp(buildCommand);
+var createCommand2 = program2.command("create [type] [name]").description("Generate boilerplate files (e.g. plugin)").action(async (pType, pName) => {
+  if (pType === "help" || !pType || !pName) {
+    console.log(createCommand2.helpInformation());
+    return;
+  }
+  await KitCLI.create({
+    type: pType,
+    name: pName,
+    verbose: program2.opts().verbose
+  });
+});
+createCommand2.helpInformation = () => formatHelp(createCommand2);
+var doctorCommand = program2.command("doctor").description("Inspect environment and game project diagnostics").action(async () => {
+  const allPassed = await KitCLI.doctor({
+    verbose: program2.opts().verbose
+  });
+  if (!allPassed) {
+    process.exitCode = 1;
+  }
+});
+doctorCommand.helpInformation = () => formatHelp(doctorCommand);
+var hostCommand = program2.command("host").description("Host the game application locally").option("-p, --port <number>", "Port to run host server on (default: 8090)", "8090").option("-d, --dir <path>", "Directory to serve (default: ./dist)").option("-b, --build", "Build the project before hosting", false).action(async (pCmdOptions) => {
+  const verbose = program2.opts().verbose;
+  if (pCmdOptions.build) {
+    await KitCLI.processResources({ verbose });
+  }
+  const result = await KitCLI.host({
+    port: Number(pCmdOptions.port) || 8090,
+    directory: pCmdOptions.dir,
+    verbose
+  });
+  if (!result.success) {
+    process.exitCode = 1;
+  }
+});
+hostCommand.helpInformation = () => formatHelp(hostCommand);
 program2.command("help [command]").description("Display help for a command").action((pCommandName) => {
   if (pCommandName) {
     const cmd = program2.commands.find((c) => c.name() === pCommandName);