@evitcastudio/kit 3.1.0 → 3.2.0

package/lib/bundle/cli/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 /*!
- * @evitcastudio/kit@3.1.0 git+https://github.com/EvitcaStudio/Kit.git
- * Compiled Tue, 23 Jun 2026 22:30:34 UTC
+ * @evitcastudio/kit@3.1.1 git+https://github.com/EvitcaStudio/Kit.git
+ * Compiled Wed, 09 Sep 2026 07:29:03 UTC
  * Copyright (c) 2026 Jared Bates, Evitca Studio, "doubleactii"
  *
  * @evitcastudio/kit is licensed under the MIT License.
@@ -1943,8 +1943,8 @@ var {
 } = import__.default;
 
 // src/cli/resource-builder.ts
-import { promises as fs } from "fs";
-import { join, extname, basename } from "path";
+import { promises as fs, watch as fsWatch } from "fs";
+import { join, extname, basename, resolve } from "path";
 
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -2475,19 +2475,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 +2758,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 {
@@ -7999,7 +7999,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] = [];
@@ -8046,8 +8048,14 @@ async function processDirectory(pDirectoryPath) {
     const contents = await fs.readdir(pDirectoryPath);
     for (const item of contents) {
       const itemPath = join(pDirectoryPath, item);
+      if (resolve(itemPath) === resourceOutDirectory) {
+        continue;
+      }
       const stats = await fs.stat(itemPath);
       if (stats.isDirectory()) {
+        if (pDirectoryPath === resourceInDirectory) {
+          subdirectoriesToMirror.push(item);
+        }
         await processDirectory(itemPath);
       } else if (isValidExtension(extname(itemPath).slice(1))) {
         prepareFileForProcessing(itemPath);
@@ -8060,6 +8068,22 @@ async function processDirectory(pDirectoryPath) {
 function isValidExtension(pExtension) {
   return VALID_EXTENSIONS.includes(pExtension);
 }
+async function mirrorDirectory(pSourceDir, pDestDir) {
+  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 mirrorDirectory(srcPath, destPath);
+    } else {
+      const ext = extname(entry.name).slice(1);
+      if (!isValidExtension(ext)) {
+        await fs.copyFile(srcPath, destPath);
+      }
+    }
+  }
+}
 async function processAllFiles() {
   try {
     await clearResourceTypeDirectories(`${resourceOutDirectory}/resources`);
@@ -8074,10 +8098,19 @@ async function processAllFiles() {
       return copyFile(filePath, destination, resourceName);
     });
     await Promise.all(copyOperations);
+    for (const subDir of subdirectoriesToMirror) {
+      const srcPath = join(resourceInDirectory, subDir);
+      const destPath = join(resourceOutDirectory, "resources", subDir);
+      await mirrorDirectory(srcPath, destPath);
+    }
     logVerbose(`[Kit CLI] All resources have been processed.`);
     await saveResourceJSON();
     const boundsData = await buildBoundsJSON();
     await saveBoundsJSON(boundsData);
+    const pointsData = await buildIconPointsJSON();
+    await saveIconPointsJSON(pointsData);
+    const sizesData = await buildSizesJSON();
+    await saveSizesJSON(sizesData);
   } catch (pError) {
     const errorMessage = pError instanceof Error ? pError.message : String(pError);
     logError(`[Error] Processing files in batch: ${errorMessage}`);
@@ -8130,11 +8163,114 @@ async function buildBoundsJSON() {
 async function saveBoundsJSON(pBoundsData) {
   const filePath = "bounds.json";
   try {
-    await fs.writeFile(filePath, JSON.stringify(pBoundsData, null, 4));
+    await fs.writeFile(filePath, JSON.stringify(pBoundsData));
   } catch (pError) {
     logError(`[Error] Saving bounds JSON: ${pError}`);
   }
 }
+async function buildIconPointsJSON() {
+  const pointsData = {};
+  for (const { filePath, type } of resourcesToProcess) {
+    if (type !== "icon")
+      continue;
+    try {
+      const fileBuffer = await fs.readFile(filePath);
+      const vyi = new VYI().parse(fileBuffer);
+      const atlasName = basename(filePath, ".vyi");
+      const atlasEntry = {};
+      for (const icon of vyi.getIcons()) {
+        const iconName = icon.getName();
+        const iconPoints = icon.getIconPointsExport();
+        const hasIconPoints = iconPoints && iconPoints.length > 0;
+        const iconEntry = {};
+        if (hasIconPoints) {
+          const pointsMap = {};
+          for (const pt of iconPoints) {
+            pointsMap[pt.id] = {
+              width: pt.width,
+              height: pt.height,
+              x: pt.x,
+              y: pt.y
+            };
+          }
+          iconEntry.points = pointsMap;
+        }
+        const statesEntry = {};
+        for (const state of icon.getStates()) {
+          const stateName = state.getName();
+          const statePoints = state.getIconPointsExport();
+          if (statePoints && statePoints.length > 0) {
+            const statePointsMap = {};
+            for (const pt of statePoints) {
+              statePointsMap[pt.id] = {
+                width: pt.width,
+                height: pt.height,
+                x: pt.x,
+                y: pt.y
+              };
+            }
+            statesEntry[stateName] = {
+              points: statePointsMap
+            };
+          }
+        }
+        if (Object.keys(statesEntry).length > 0) {
+          iconEntry.states = statesEntry;
+        }
+        if (Object.keys(iconEntry).length > 0) {
+          atlasEntry[iconName] = iconEntry;
+        }
+      }
+      if (Object.keys(atlasEntry).length > 0) {
+        pointsData[atlasName] = atlasEntry;
+      }
+    } catch (pError) {
+      logError(`[Error] Failed to parse icon points from ${filePath}: ${pError}`);
+    }
+  }
+  return pointsData;
+}
+async function saveIconPointsJSON(pPointsData) {
+  const filePath = "icon-points.json";
+  try {
+    await fs.writeFile(filePath, JSON.stringify(pPointsData));
+  } catch (pError) {
+    logError(`[Error] Saving icon points JSON: ${pError}`);
+  }
+}
+async function buildSizesJSON() {
+  const sizesData = {};
+  for (const { filePath, type } of resourcesToProcess) {
+    if (type !== "icon")
+      continue;
+    try {
+      const fileBuffer = await fs.readFile(filePath);
+      const vyi = new VYI().parse(fileBuffer);
+      const atlasName = basename(filePath, ".vyi");
+      const atlasEntry = {};
+      for (const icon of vyi.getIcons()) {
+        atlasEntry[icon.getName()] = {
+          width: icon.getWidth(),
+          height: icon.getHeight()
+        };
+      }
+      if (Object.keys(atlasEntry).length > 0) {
+        sizesData[atlasName] = atlasEntry;
+      }
+    } catch (pError) {
+      logError(`[Error] Failed to parse sizes from ${filePath}: ${pError}`);
+    }
+  }
+  return sizesData;
+}
+async function saveSizesJSON(pSizesData) {
+  const filePath = "sizes.json";
+  try {
+    await fs.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);
@@ -8154,31 +8290,65 @@ async function copyFile(pSource, pDestinationDir, pNewName) {
   }
 }
 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 fs.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;
+async function runBuild() {
   resourceJSON = initializeResourceJSON();
   resourcesToProcess.length = 0;
-  if (!resourceInDirectory || !resourceOutDirectory) {
-    logError("[Error] Input and output directories must be specified");
-    return;
-  }
+  subdirectoriesToMirror.length = 0;
   await processDirectory(resourceInDirectory);
-  if (resourcesToProcess.length > 0) {
+  if (resourcesToProcess.length > 0 || subdirectoriesToMirror.length > 0) {
     await processAllFiles();
   } else {
     logAlert("No resources found!");
     await saveResourceJSON();
     await saveBoundsJSON({});
+    await saveIconPointsJSON({});
+    await saveSizesJSON({});
+  }
+  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 watcher = fsWatch(resourceInDirectory, { recursive: true }, (_eventType, pFilename) => {
+    if (!pFilename)
+      return;
+    if (debounceTimer)
+      clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(async () => {
+      console.log(source_default.dim(`
+Asset changed: ${pFilename}, rebuilding...`));
+      await runBuild();
+    }, 150);
+  });
+  process.on("SIGINT", () => {
+    watcher.close();
+    process.exit(0);
+  });
+}
+async function processResources({ inDirectory, outDirectory, manifestPath, watch, verbose, ignoreSound }) {
+  resourceInDirectory = inDirectory ? resolve(inDirectory) : "";
+  resourceOutDirectory = outDirectory ? resolve(outDirectory) : "";
+  customManifestPath = manifestPath;
+  isVerbose = verbose;
+  ignoringSound = ignoreSound;
+  if (!resourceInDirectory || !resourceOutDirectory) {
+    logError("[Error] Input and output directories must be specified");
+    return;
+  }
+  if (watch) {
+    await runWatch();
+  } else {
+    await runBuild();
   }
 }
 function logVerbose(pMessage) {
@@ -9246,7 +9416,7 @@ import os2 from "node:os";
 // package.json
 var package_default = {
   name: "@evitcastudio/kit",
-  version: "3.1.0",
+  version: "3.1.1",
   author: "doubleactii 56242467+doubleactii@users.noreply.github.com (https://evitcastudio.com)",
   main: "./lib/index.js",
   types: "./lib/index.d.ts",
@@ -9400,7 +9570,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",
@@ -9429,6 +9601,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";
@@ -9441,13 +9620,19 @@ Note: Kit projects cannot build or run without Bun.`);
   }
   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 (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();
@@ -9483,11 +9668,25 @@ Note: Kit projects cannot build or run without Bun.`);
     } catch {
     }
     s.stop(`Project ${source_default.green(projectName)} created!`);
+    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("│")}`);
     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`);
+    if (!shouldInstall) {
+      console.log(`${source_default.cyan("│")}  ${source_default.dim("2.")} bun install`);
+      console.log(`${source_default.cyan("│")}  ${source_default.dim("3.")} bun run build`);
+    } else {
+      console.log(`${source_default.cyan("│")}  ${source_default.dim("2.")} bun run build`);
+    }
     console.log(`${source_default.cyan("│")}`);
     Gt(source_default.green.bold("Happy coding!"));
   } catch (pError) {
@@ -9503,6 +9702,198 @@ Note: Kit projects cannot build or run without Bun.`);
   }
 }
 
+// src/cli/doctor.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join as join2 } from "node: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 = join2(cwd, "package.json");
+  const hasPackageJson = existsSync(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 = join2(cwd, "src", "resources");
+        const hasResources = existsSync(resourcesDir);
+        results.push({
+          category: "Project",
+          title: "Asset Directory (src/resources)",
+          passed: hasResources,
+          details: hasResources ? "Asset directory present" : "src/resources not found"
+        });
+      }
+    } catch {
+      results.push({
+        category: "Project",
+        title: "package.json format",
+        passed: false,
+        details: "package.json is malformed or invalid JSON"
+      });
+    }
+    const buildScript = join2(cwd, "bun-build.ts");
+    const hasBuildScript = existsSync(buildScript);
+    results.push({
+      category: "Project",
+      title: "Build Pipeline (bun-build.ts)",
+      passed: hasBuildScript,
+      details: hasBuildScript ? "Build script present" : "bun-build.ts not found"
+    });
+  } 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("✓") : source_default.red("✗");
+    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 fs3 } from "node:fs";
+import { join as join3 } from "node: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 = join3(process.cwd(), "src", "plugins");
+  const targetPath = join3(pluginsDir, fileName);
+  try {
+    await fs3.mkdir(pluginsDir, { recursive: true });
+    const fileExists = await fs3.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 fs3.writeFile(targetPath, sourceCode, "utf8");
+    console.log(`
+  ${source_default.green("✓")} 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/main.ts
 class KitCLI {
   static async processResources(pProcessOptions) {
@@ -9511,6 +9902,12 @@ class KitCLI {
   static async init(pInitOptions) {
     await processInit(pInitOptions);
   }
+  static async doctor(pDoctorOptions = {}) {
+    return await processDoctor(pDoctorOptions);
+  }
+  static async create(pCreateOptions) {
+    await processCreate(pCreateOptions);
+  }
 }
 
 // bin/cli.ts
@@ -9573,17 +9970,27 @@ 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) {
@@ -9599,9 +10006,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;
@@ -9610,11 +10017,13 @@ 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 from the specified directory").option("-i, --in <path>", "Input directory (required)").option("-o, --out <path>", "Output directory (required)").option("-m, --manifest <path>", "Custom manifest file path").option("-w, --watch", "Watch input directory for changes and rebuild", false).option("-is, --ignore-sound", "Ignore sound files", false).action((pHelp, pCmdOptions) => {
   if (pHelp === "help") {
     console.log(buildCommand.helpInformation());
     return;
@@ -9629,12 +10038,35 @@ var buildCommand = program2.command("build [help]").description("Build resources
   const processOptions = {
     inDirectory: pCmdOptions.in,
     outDirectory: pCmdOptions.out,
+    manifestPath: pCmdOptions.manifest,
+    watch: pCmdOptions.watch || false,
     ignoreSound: pCmdOptions.ignoreSound || 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);
 program2.command("help [command]").description("Display help for a command").action((pCommandName) => {
   if (pCommandName) {
     const cmd = program2.commands.find((c) => c.name() === pCommandName);