@defold-typescript/cli 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 king8fisher (Anton Veretennikov)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# defold-typescript
+
+The end-user CLI for scaffolding and building [Defold](https://defold.com/)
+projects written in TypeScript, transpiled to Lua.
+
+```sh
+bunx @defold-typescript/cli init    # add TypeScript to a Defold project, or scaffold a new one
+bunx @defold-typescript/cli build   # transpile src/ to Lua alongside your Defold sources
+bunx @defold-typescript/cli watch   # rebuild on change
+```
+
+The package name is scoped (`@defold-typescript/cli`); `bunx defold-typescript`
+without the scope resolves a different, nonexistent package. Install it to get
+the shorter `defold-typescript` binary on your `PATH` and pin the version:
+
+```sh
+npm i -D @defold-typescript/cli   # then: bunx defold-typescript <command>
+```
+
+See the repository [README](https://github.com/king8fisher/defold-typescript#readme)
+and [`docs/guide/`](https://github.com/king8fisher/defold-typescript/tree/main/docs/guide)
+for the full workflow.
+
+## License
+
+MIT

package/dist/bin.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/dispatch.ts
-import { existsSync as existsSync5, readFileSync as readFileSync7 } from "node:fs";
-import * as path9 from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync8 } from "node:fs";
+import * as path10 from "node:path";
 
 // src/api-registry.ts
 import { existsSync, readFileSync } from "node:fs";
@@ -94,6 +94,10 @@ var PROJECT_BUCKET = "<project>";
 function toPosix(p, sep2 = path2.sep) {
   return p.split(sep2).join("/");
 }
+var TRANSPILER_SOURCE_RE = /\.(ts|tsx|cts|mts)$/;
+function isTranspilerSource(rel) {
+  return TRANSPILER_SOURCE_RE.test(toPosix(rel));
+}
 function readBuildConfig(cwd) {
   const tsconfigPath = path2.join(cwd, "tsconfig.json");
   let raw;
@@ -205,9 +209,27 @@ function runBuild(opts) {
   return { written };
 }
 
-// src/init.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+// src/cli-version.ts
+import { readFileSync as readFileSync4 } from "node:fs";
 import * as path5 from "node:path";
+import { fileURLToPath } from "node:url";
+var VERSION_FALLBACK = "0.0.0";
+function defaultPackageRoot() {
+  return path5.join(path5.dirname(fileURLToPath(import.meta.url)), "..");
+}
+function readCliVersion(packageRoot = defaultPackageRoot()) {
+  try {
+    const pkg = JSON.parse(readFileSync4(path5.join(packageRoot, "package.json"), "utf8"));
+    return typeof pkg.version === "string" ? pkg.version : VERSION_FALLBACK;
+  } catch {
+    return VERSION_FALLBACK;
+  }
+}
+
+// src/init.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "node:fs";
+import * as path6 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/script-kind.ts
 var DEFAULT_TYPES_ENTRYPOINT = "@defold-typescript/types";
@@ -332,19 +354,33 @@ embedded_instances {
   scale3 { x: 1.0 y: 1.0 z: 1.0 }
 }
 `;
+function typesVersionSpec() {
+  try {
+    const here = path6.dirname(fileURLToPath2(import.meta.url));
+    const pkg = JSON.parse(readFileSync5(path6.join(here, "..", "package.json"), "utf8"));
+    return pkg.version ? `^${pkg.version}` : "latest";
+  } catch {
+    return "latest";
+  }
+}
 var SCAFFOLD_DEV_DEPS = {
-  "@defold-typescript/transpiler": "workspace:*",
-  "@defold-typescript/types": "workspace:*",
+  "@defold-typescript/types": typesVersionSpec(),
   "@biomejs/biome": "^2.2.0"
 };
+function repairManagedDevDeps(devDeps) {
+  delete devDeps["@defold-typescript/transpiler"];
+  if (devDeps["@defold-typescript/types"]?.startsWith("workspace:")) {
+    devDeps["@defold-typescript/types"] = typesVersionSpec();
+  }
+}
 function writeJson(filePath, value) {
   writeFileSync2(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
 function writeGitignore(cwd) {
-  const gitignorePath = path5.join(cwd, ".gitignore");
+  const gitignorePath = path6.join(cwd, ".gitignore");
   if (existsSync2(gitignorePath)) {
-    const existing = readFileSync4(gitignorePath, "utf8");
+    const existing = readFileSync5(gitignorePath, "utf8");
     const present = new Set(existing.split(`
 `).map((line) => line.trim()));
     const missing = GITIGNORE_LINES.filter((line) => !present.has(line));
@@ -364,7 +400,7 @@ function writeGitignore(cwd) {
   }
 }
 function writeBiome(cwd, written) {
-  const biomePath = path5.join(cwd, "biome.json");
+  const biomePath = path6.join(cwd, "biome.json");
   if (existsSync2(biomePath)) {
     return;
   }
@@ -372,8 +408,8 @@ function writeBiome(cwd, written) {
   written.push("biome.json");
 }
 function writeTsSurface(cwd, written) {
-  mkdirSync2(path5.join(cwd, "src"), { recursive: true });
-  writeFileSync2(path5.join(cwd, "src", "main.ts"), MAIN_TS_CONTENT);
+  mkdirSync2(path6.join(cwd, "src"), { recursive: true });
+  writeFileSync2(path6.join(cwd, "src", "main.ts"), MAIN_TS_CONTENT);
   written.push("src/main.ts");
   const kinds = detectScriptKinds(cwd);
   const tsconfig = {
@@ -383,23 +419,24 @@ function writeTsSurface(cwd, written) {
     },
     include: ["src/**/*.ts"]
   };
-  writeJson(path5.join(cwd, "tsconfig.json"), tsconfig);
+  writeJson(path6.join(cwd, "tsconfig.json"), tsconfig);
   written.push("tsconfig.json");
-  const pkgPath = path5.join(cwd, "package.json");
+  const pkgPath = path6.join(cwd, "package.json");
   if (existsSync2(pkgPath)) {
-    const existing = JSON.parse(readFileSync4(pkgPath, "utf8"));
+    const existing = JSON.parse(readFileSync5(pkgPath, "utf8"));
     const devDeps = { ...existing.devDependencies ?? {} };
     for (const [name, version] of Object.entries(SCAFFOLD_DEV_DEPS)) {
       if (!(name in devDeps)) {
         devDeps[name] = version;
       }
     }
+    repairManagedDevDeps(devDeps);
     existing.devDependencies = devDeps;
     existing["defold-typescript"] ??= { "defold-version": CURRENT_STABLE_DEFOLD_VERSION };
     writeJson(pkgPath, existing);
   } else {
     const fresh = {
-      name: path5.basename(cwd),
+      name: path6.basename(cwd),
       version: "0.0.0",
       type: "module",
       devDependencies: { ...SCAFFOLD_DEV_DEPS },
@@ -420,27 +457,27 @@ function runNewProjectInit(cwd, force = false) {
     throw new Error(`defold-typescript init: refusing to synthesize a new Defold project into non-empty directory ${cwd}. Pass --force to proceed.`);
   }
   const written = [];
-  writeFileSync2(path5.join(cwd, "game.project"), `[project]
-title = ${path5.basename(cwd)}
+  writeFileSync2(path6.join(cwd, "game.project"), `[project]
+title = ${path6.basename(cwd)}
 main_collection = /main/main.collectionc
 `);
   written.push("game.project");
-  mkdirSync2(path5.join(cwd, "main"), { recursive: true });
-  writeFileSync2(path5.join(cwd, "main", "main.collection"), MAIN_COLLECTION_CONTENT);
+  mkdirSync2(path6.join(cwd, "main"), { recursive: true });
+  writeFileSync2(path6.join(cwd, "main", "main.collection"), MAIN_COLLECTION_CONTENT);
   written.push("main/main.collection");
-  writeFileSync2(path5.join(cwd, "main", "main.script"), MAIN_SCRIPT_CONTENT);
+  writeFileSync2(path6.join(cwd, "main", "main.script"), MAIN_SCRIPT_CONTENT);
   written.push("main/main.script");
   const scriptKind = writeTsSurface(cwd, written);
   return { written, scriptKind };
 }
 function runInit(opts) {
   const { cwd, force = false } = opts;
-  if (!existsSync2(path5.join(cwd, "game.project"))) {
+  if (!existsSync2(path6.join(cwd, "game.project"))) {
     return runNewProjectInit(cwd, force);
   }
   if (!force) {
     for (const rel of CONFLICTING_TS_CONFIGS) {
-      if (existsSync2(path5.join(cwd, rel))) {
+      if (existsSync2(path6.join(cwd, rel))) {
         throw new Error(`defold-typescript init: refusing to overwrite existing TS config: ${rel}. Pass --force to overwrite.`);
       }
     }
@@ -468,11 +505,11 @@ import {
   existsSync as existsSync3,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   rmSync,
   writeFileSync as writeFileSync3
 } from "node:fs";
-import * as path6 from "node:path";
+import * as path7 from "node:path";
 var MATERIALIZED_ROOT = ".defold-types";
 function writeJson2(filePath, value) {
   writeFileSync3(filePath, `${JSON.stringify(value, null, 2)}
@@ -487,14 +524,14 @@ function materializeApiSurface(opts) {
     return { materializedDir: null, active: null };
   }
   const { surfaceId } = surface;
-  const relDir = path6.posix.join(MATERIALIZED_ROOT, surfaceId);
-  const absDir = path6.join(cwd, MATERIALIZED_ROOT, surfaceId);
+  const relDir = path7.posix.join(MATERIALIZED_ROOT, surfaceId);
+  const absDir = path7.join(cwd, MATERIALIZED_ROOT, surfaceId);
   mkdirSync3(absDir, { recursive: true });
   const excluded = excludedModulesForKind(opts.scriptKind ?? null);
   const sources = listDts(sourceGeneratedDir).filter((file) => file !== "index.d.ts").filter((file) => !excluded.has(file.replace(/\.d\.ts$/, "")));
-  const srcDir = path6.resolve(sourceGeneratedDir, "..", "src");
-  const overloads = ["msg-overloads.d.ts", "go-overloads.d.ts"].filter((file) => existsSync3(path6.join(srcDir, file)));
-  const coreTypesSrc = path6.join(srcDir, "core-types.ts");
+  const srcDir = path7.resolve(sourceGeneratedDir, "..", "src");
+  const overloads = ["msg-overloads.d.ts", "go-overloads.d.ts"].filter((file) => existsSync3(path7.join(srcDir, file)));
+  const coreTypesSrc = path7.join(srcDir, "core-types.ts");
   const includeCoreTypes = overloads.length > 0 && existsSync3(coreTypesSrc);
   const wanted = new Set(sources);
   for (const file of overloads) {
@@ -505,39 +542,39 @@ function materializeApiSurface(opts) {
   }
   for (const existing of readdirSync2(absDir)) {
     if (existing.endsWith(".d.ts") && existing !== "index.d.ts" && !wanted.has(existing)) {
-      rmSync(path6.join(absDir, existing));
+      rmSync(path7.join(absDir, existing));
     }
   }
   for (const file of sources) {
-    writeFileSync3(path6.join(absDir, file), readFileSync5(path6.join(sourceGeneratedDir, file), "utf8"));
+    writeFileSync3(path7.join(absDir, file), readFileSync6(path7.join(sourceGeneratedDir, file), "utf8"));
   }
   if (includeCoreTypes) {
-    writeFileSync3(path6.join(absDir, "core-types.d.ts"), readFileSync5(coreTypesSrc, "utf8"));
+    writeFileSync3(path7.join(absDir, "core-types.d.ts"), readFileSync6(coreTypesSrc, "utf8"));
   }
   for (const file of overloads) {
-    writeFileSync3(path6.join(absDir, file), readFileSync5(path6.join(srcDir, file), "utf8"));
+    writeFileSync3(path7.join(absDir, file), readFileSync6(path7.join(srcDir, file), "utf8"));
   }
   const modules = [...sources, ...overloads].map((file) => file.replace(/\.d\.ts$/, ""));
   const imports = modules.map((mod) => `import "./${mod}";`).join(`
 `);
-  writeFileSync3(path6.join(absDir, "index.d.ts"), `${imports}
+  writeFileSync3(path7.join(absDir, "index.d.ts"), `${imports}
 
 export {};
 `);
-  writeJson2(path6.join(absDir, "package.json"), {
+  writeJson2(path7.join(absDir, "package.json"), {
     name: `@defold-typescript/materialized-${surfaceId}`,
     types: "index.d.ts"
   });
   return { materializedDir: relDir, active: surfaceId };
 }
 function ensureGitignoreLine(cwd, line) {
-  const gitignorePath = path6.join(cwd, ".gitignore");
+  const gitignorePath = path7.join(cwd, ".gitignore");
   if (!existsSync3(gitignorePath)) {
     writeFileSync3(gitignorePath, `${line}
 `);
     return;
   }
-  const existing = readFileSync5(gitignorePath, "utf8");
+  const existing = readFileSync6(gitignorePath, "utf8");
   const present = new Set(existing.split(`
 `).map((entry) => entry.trim()));
   if (present.has(line)) {
@@ -553,10 +590,10 @@ function ensureMaterializedReference(cwd, materializedDir) {
   if (materializedDir === null) {
     return;
   }
-  const surfaceId = path6.posix.basename(materializedDir);
-  const tsconfigPath = path6.join(cwd, "tsconfig.json");
+  const surfaceId = path7.posix.basename(materializedDir);
+  const tsconfigPath = path7.join(cwd, "tsconfig.json");
   if (existsSync3(tsconfigPath)) {
-    const tsconfig = JSON.parse(readFileSync5(tsconfigPath, "utf8"));
+    const tsconfig = JSON.parse(readFileSync6(tsconfigPath, "utf8"));
     tsconfig.compilerOptions = {
       ...tsconfig.compilerOptions ?? {},
       typeRoots: [MATERIALIZED_ROOT],
@@ -568,7 +605,7 @@ function ensureMaterializedReference(cwd, materializedDir) {
 }
 function resolveCurrentSurfaceGeneratedDir() {
   const root = resolveTypesPackageRoot();
-  return root === null ? null : path6.join(root, "generated");
+  return root === null ? null : path7.join(root, "generated");
 }
 async function materializeRefDocSurface(opts) {
   const { cwd, surfaceId, resolveOpts } = opts;
@@ -578,21 +615,21 @@ async function materializeRefDocSurface(opts) {
   }
   const registry = opts.registry ?? loadApiTargetsRegistry();
   const target = registry.find((t) => t.id === surfaceId);
-  if (!target || target.source?.kind !== "ref-doc") {
+  if (target?.source?.kind !== "ref-doc") {
     return { materializedDir: null, active: null };
   }
   const excludeModules = [...excludedModulesForKind(opts.scriptKind ?? null)];
-  const relDir = path6.posix.join(MATERIALIZED_ROOT, surfaceId);
-  const absDir = path6.join(cwd, MATERIALIZED_ROOT, surfaceId);
+  const relDir = path7.posix.join(MATERIALIZED_ROOT, surfaceId);
+  const absDir = path7.join(cwd, MATERIALIZED_ROOT, surfaceId);
   try {
-    const mod = await import(path6.join(root, "scripts", "materialize-version.ts"));
+    const mod = await import(path7.join(root, "scripts", "materialize-version.ts"));
     const selfContained = { ...target, coreTypesImport: "./core-types" };
     await mod.materializeVersionedSurface(selfContained, {
       destDir: absDir,
       ...resolveOpts ? { resolveOpts } : {},
       ...excludeModules.length > 0 ? { excludeModules } : {}
     });
-    copyFileSync(path6.join(root, "src", "core-types.ts"), path6.join(absDir, "core-types.d.ts"));
+    copyFileSync(path7.join(root, "src", "core-types.ts"), path7.join(absDir, "core-types.d.ts"));
   } catch {
     rmSync(absDir, { recursive: true, force: true });
     return { materializedDir: null, active: null };
@@ -602,11 +639,11 @@ async function materializeRefDocSurface(opts) {
 
 // src/watch.ts
 import { existsSync as existsSync4, watch as fsWatch } from "node:fs";
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 
 // src/build-session.ts
-import { readFileSync as readFileSync6, rmSync as rmSync2 } from "node:fs";
-import * as path7 from "node:path";
+import { readFileSync as readFileSync7, rmSync as rmSync2 } from "node:fs";
+import * as path8 from "node:path";
 import {
   createTranspileSession
 } from "@defold-typescript/transpiler";
@@ -645,26 +682,28 @@ function createBuildSession(opts) {
     }
     const files = {};
     for (const rel of sources) {
-      files[rel] = readFileSync6(path7.join(cwd, rel), "utf8");
+      files[rel] = readFileSync7(path8.join(cwd, rel), "utf8");
     }
     const result = session.update(files);
     return writeOutputs(result, sources);
   }
   function applyEvents(changed, removed) {
+    const sourceChanged = changed.filter(isTranspilerSource);
+    const sourceRemoved = removed.filter(isTranspilerSource);
     const changes = {};
-    for (const rel of changed) {
-      changes[rel] = readFileSync6(path7.join(cwd, rel), "utf8");
+    for (const rel of sourceChanged) {
+      changes[rel] = readFileSync7(path8.join(cwd, rel), "utf8");
     }
-    for (const rel of removed) {
+    for (const rel of sourceRemoved) {
       changes[rel] = null;
     }
     const result = session.update(changes);
-    for (const rel of removed) {
-      const luaAbs = path7.join(cwd, computeLuaRel(rel, config));
+    for (const rel of sourceRemoved) {
+      const luaAbs = path8.join(cwd, computeLuaRel(rel, config));
       rmSync2(luaAbs, { force: true });
       rmSync2(`${luaAbs}.map`, { force: true });
     }
-    return writeOutputs(result, changed);
+    return writeOutputs(result, sourceChanged);
   }
   return { buildAll, applyEvents };
 }
@@ -712,7 +751,7 @@ function runWatch(opts) {
       waitForIdle: () => Promise.resolve()
     };
   }
-  const srcDir = path8.join(cwd, "src");
+  const srcDir = path9.join(cwd, "src");
   let scheduled = null;
   let syncScheduled = null;
   let rebuildBusy = false;
@@ -736,7 +775,7 @@ function runWatch(opts) {
     const removed = [];
     for (const rel of drained) {
       const key = `src/${toPosix(rel)}`;
-      if (existsSync4(path8.join(srcDir, rel))) {
+      if (existsSync4(path9.join(srcDir, rel))) {
         changed.push(key);
       } else {
         removed.push(key);
@@ -756,9 +795,10 @@ function runWatch(opts) {
   function onEvent(e) {
     if (stopped)
       return;
+    if (!e.path || !isTranspilerSource(e.path))
+      return;
     rebuildBusy = true;
-    if (e.path)
-      pending.add(e.path);
+    pending.add(e.path);
     if (scheduled)
       clearTimeout(scheduled);
     scheduled = setTimeout(rebuild, debounceMs);
@@ -836,23 +876,30 @@ function parseDefoldVersionFlag(argv) {
   return { flag, rest };
 }
 function readProjectPin(cwd) {
-  const pkgPath = path9.join(cwd, "package.json");
+  const pkgPath = path10.join(cwd, "package.json");
   if (!existsSync5(pkgPath)) {
     return;
   }
   try {
-    return readDefoldVersionPin(JSON.parse(readFileSync7(pkgPath, "utf8")));
+    return readDefoldVersionPin(JSON.parse(readFileSync8(pkgPath, "utf8")));
   } catch {
     return;
   }
 }
 function dispatch(argv, io, internals) {
   const json = argv.includes("--json");
+  if (argv.includes("--version") || argv.includes("-v")) {
+    const version = internals?.cliVersion ?? readCliVersion();
+    io.stdout.write(json ? `{"command":"version","ok":true,"version":${JSON.stringify(version)}}
+` : `defold-typescript ${version}
+`);
+    return 0;
+  }
   const force = argv.includes("--force");
   const { flag: defoldVersionFlag, rest: nonFlagArgs } = parseDefoldVersionFlag(argv);
   const positional = nonFlagArgs.filter((a) => a !== "--json" && a !== "--force");
   const [command, ...rest] = positional;
-  const cwd = rest[0] ? path9.resolve(rest[0]) : process.cwd();
+  const cwd = rest[0] ? path10.resolve(rest[0]) : process.cwd();
   const pin = readProjectPin(cwd);
   const resolvedVersion = resolveDefoldVersion({
     ...defoldVersionFlag !== undefined ? { flag: defoldVersionFlag } : {},

package/dist/build-output.d.ts

@@ -4,6 +4,7 @@ export interface BuildConfig {
     readonly include: string[];
 }
 export declare function toPosix(p: string, sep?: string): string;
+export declare function isTranspilerSource(rel: string): boolean;
 export declare function readBuildConfig(cwd: string): BuildConfig;
 export declare function computeLuaRel(rel: string, config: BuildConfig): string;
 export declare function collectFailures(diagnostics: readonly TranspileDiagnostic[]): Map<string, string[]>;

package/dist/cli-version.d.ts

@@ -0,0 +1 @@
+export declare function readCliVersion(packageRoot?: string): string;

package/dist/dispatch.d.ts

@@ -13,5 +13,6 @@ export interface DispatchInternals {
     readonly sourceGeneratedDir?: string;
     readonly resolveOpts?: RefDocResolveOptions;
     readonly refDocRegistry?: readonly RegistryTarget[];
+    readonly cliVersion?: string;
 }
 export declare function dispatch(argv: string[], io: DispatchIo, internals?: DispatchInternals): number | Promise<number>;

package/dist/index.js

@@ -13,6 +13,10 @@ var PROJECT_BUCKET = "<project>";
 function toPosix(p, sep2 = path.sep) {
   return p.split(sep2).join("/");
 }
+var TRANSPILER_SOURCE_RE = /\.(ts|tsx|cts|mts)$/;
+function isTranspilerSource(rel) {
+  return TRANSPILER_SOURCE_RE.test(toPosix(rel));
+}
 function readBuildConfig(cwd) {
   const tsconfigPath = path.join(cwd, "tsconfig.json");
   let raw;
@@ -129,26 +133,28 @@ function createBuildSession(opts) {
     return writeOutputs(result, sources);
   }
   function applyEvents(changed, removed) {
+    const sourceChanged = changed.filter(isTranspilerSource);
+    const sourceRemoved = removed.filter(isTranspilerSource);
     const changes = {};
-    for (const rel of changed) {
+    for (const rel of sourceChanged) {
       changes[rel] = readFileSync2(path3.join(cwd, rel), "utf8");
     }
-    for (const rel of removed) {
+    for (const rel of sourceRemoved) {
       changes[rel] = null;
     }
     const result = session.update(changes);
-    for (const rel of removed) {
+    for (const rel of sourceRemoved) {
       const luaAbs = path3.join(cwd, computeLuaRel(rel, config));
       rmSync(luaAbs, { force: true });
       rmSync(`${luaAbs}.map`, { force: true });
     }
-    return writeOutputs(result, changed);
+    return writeOutputs(result, sourceChanged);
   }
   return { buildAll, applyEvents };
 }
 // src/dispatch.ts
-import { existsSync as existsSync5, readFileSync as readFileSync7 } from "node:fs";
-import * as path9 from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync8 } from "node:fs";
+import * as path10 from "node:path";
 
 // src/api-registry.ts
 import { existsSync, readFileSync as readFileSync3 } from "node:fs";
@@ -267,9 +273,27 @@ function runBuild(opts) {
   return { written };
 }
 
-// src/init.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "node:fs";
+// src/cli-version.ts
+import { readFileSync as readFileSync5 } from "node:fs";
 import * as path6 from "node:path";
+import { fileURLToPath } from "node:url";
+var VERSION_FALLBACK = "0.0.0";
+function defaultPackageRoot() {
+  return path6.join(path6.dirname(fileURLToPath(import.meta.url)), "..");
+}
+function readCliVersion(packageRoot = defaultPackageRoot()) {
+  try {
+    const pkg = JSON.parse(readFileSync5(path6.join(packageRoot, "package.json"), "utf8"));
+    return typeof pkg.version === "string" ? pkg.version : VERSION_FALLBACK;
+  } catch {
+    return VERSION_FALLBACK;
+  }
+}
+
+// src/init.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "node:fs";
+import * as path7 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/script-kind.ts
 var DEFAULT_TYPES_ENTRYPOINT = "@defold-typescript/types";
@@ -394,19 +418,33 @@ embedded_instances {
   scale3 { x: 1.0 y: 1.0 z: 1.0 }
 }
 `;
+function typesVersionSpec() {
+  try {
+    const here = path7.dirname(fileURLToPath2(import.meta.url));
+    const pkg = JSON.parse(readFileSync6(path7.join(here, "..", "package.json"), "utf8"));
+    return pkg.version ? `^${pkg.version}` : "latest";
+  } catch {
+    return "latest";
+  }
+}
 var SCAFFOLD_DEV_DEPS = {
-  "@defold-typescript/transpiler": "workspace:*",
-  "@defold-typescript/types": "workspace:*",
+  "@defold-typescript/types": typesVersionSpec(),
   "@biomejs/biome": "^2.2.0"
 };
+function repairManagedDevDeps(devDeps) {
+  delete devDeps["@defold-typescript/transpiler"];
+  if (devDeps["@defold-typescript/types"]?.startsWith("workspace:")) {
+    devDeps["@defold-typescript/types"] = typesVersionSpec();
+  }
+}
 function writeJson(filePath, value) {
   writeFileSync2(filePath, `${JSON.stringify(value, null, 2)}
 `);
 }
 function writeGitignore(cwd) {
-  const gitignorePath = path6.join(cwd, ".gitignore");
+  const gitignorePath = path7.join(cwd, ".gitignore");
   if (existsSync2(gitignorePath)) {
-    const existing = readFileSync5(gitignorePath, "utf8");
+    const existing = readFileSync6(gitignorePath, "utf8");
     const present = new Set(existing.split(`
 `).map((line) => line.trim()));
     const missing = GITIGNORE_LINES.filter((line) => !present.has(line));
@@ -426,7 +464,7 @@ function writeGitignore(cwd) {
   }
 }
 function writeBiome(cwd, written) {
-  const biomePath = path6.join(cwd, "biome.json");
+  const biomePath = path7.join(cwd, "biome.json");
   if (existsSync2(biomePath)) {
     return;
   }
@@ -434,8 +472,8 @@ function writeBiome(cwd, written) {
   written.push("biome.json");
 }
 function writeTsSurface(cwd, written) {
-  mkdirSync2(path6.join(cwd, "src"), { recursive: true });
-  writeFileSync2(path6.join(cwd, "src", "main.ts"), MAIN_TS_CONTENT);
+  mkdirSync2(path7.join(cwd, "src"), { recursive: true });
+  writeFileSync2(path7.join(cwd, "src", "main.ts"), MAIN_TS_CONTENT);
   written.push("src/main.ts");
   const kinds = detectScriptKinds(cwd);
   const tsconfig = {
@@ -445,23 +483,24 @@ function writeTsSurface(cwd, written) {
     },
     include: ["src/**/*.ts"]
   };
-  writeJson(path6.join(cwd, "tsconfig.json"), tsconfig);
+  writeJson(path7.join(cwd, "tsconfig.json"), tsconfig);
   written.push("tsconfig.json");
-  const pkgPath = path6.join(cwd, "package.json");
+  const pkgPath = path7.join(cwd, "package.json");
   if (existsSync2(pkgPath)) {
-    const existing = JSON.parse(readFileSync5(pkgPath, "utf8"));
+    const existing = JSON.parse(readFileSync6(pkgPath, "utf8"));
     const devDeps = { ...existing.devDependencies ?? {} };
     for (const [name, version] of Object.entries(SCAFFOLD_DEV_DEPS)) {
       if (!(name in devDeps)) {
         devDeps[name] = version;
       }
     }
+    repairManagedDevDeps(devDeps);
     existing.devDependencies = devDeps;
     existing["defold-typescript"] ??= { "defold-version": CURRENT_STABLE_DEFOLD_VERSION };
     writeJson(pkgPath, existing);
   } else {
     const fresh = {
-      name: path6.basename(cwd),
+      name: path7.basename(cwd),
       version: "0.0.0",
       type: "module",
       devDependencies: { ...SCAFFOLD_DEV_DEPS },
@@ -482,27 +521,27 @@ function runNewProjectInit(cwd, force = false) {
     throw new Error(`defold-typescript init: refusing to synthesize a new Defold project into non-empty directory ${cwd}. Pass --force to proceed.`);
   }
   const written = [];
-  writeFileSync2(path6.join(cwd, "game.project"), `[project]
-title = ${path6.basename(cwd)}
+  writeFileSync2(path7.join(cwd, "game.project"), `[project]
+title = ${path7.basename(cwd)}
 main_collection = /main/main.collectionc
 `);
   written.push("game.project");
-  mkdirSync2(path6.join(cwd, "main"), { recursive: true });
-  writeFileSync2(path6.join(cwd, "main", "main.collection"), MAIN_COLLECTION_CONTENT);
+  mkdirSync2(path7.join(cwd, "main"), { recursive: true });
+  writeFileSync2(path7.join(cwd, "main", "main.collection"), MAIN_COLLECTION_CONTENT);
   written.push("main/main.collection");
-  writeFileSync2(path6.join(cwd, "main", "main.script"), MAIN_SCRIPT_CONTENT);
+  writeFileSync2(path7.join(cwd, "main", "main.script"), MAIN_SCRIPT_CONTENT);
   written.push("main/main.script");
   const scriptKind = writeTsSurface(cwd, written);
   return { written, scriptKind };
 }
 function runInit(opts) {
   const { cwd, force = false } = opts;
-  if (!existsSync2(path6.join(cwd, "game.project"))) {
+  if (!existsSync2(path7.join(cwd, "game.project"))) {
     return runNewProjectInit(cwd, force);
   }
   if (!force) {
     for (const rel of CONFLICTING_TS_CONFIGS) {
-      if (existsSync2(path6.join(cwd, rel))) {
+      if (existsSync2(path7.join(cwd, rel))) {
         throw new Error(`defold-typescript init: refusing to overwrite existing TS config: ${rel}. Pass --force to overwrite.`);
       }
     }
@@ -530,11 +569,11 @@ import {
   existsSync as existsSync3,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   rmSync as rmSync2,
   writeFileSync as writeFileSync3
 } from "node:fs";
-import * as path7 from "node:path";
+import * as path8 from "node:path";
 var MATERIALIZED_ROOT = ".defold-types";
 function writeJson2(filePath, value) {
   writeFileSync3(filePath, `${JSON.stringify(value, null, 2)}
@@ -549,14 +588,14 @@ function materializeApiSurface(opts) {
     return { materializedDir: null, active: null };
   }
   const { surfaceId } = surface;
-  const relDir = path7.posix.join(MATERIALIZED_ROOT, surfaceId);
-  const absDir = path7.join(cwd, MATERIALIZED_ROOT, surfaceId);
+  const relDir = path8.posix.join(MATERIALIZED_ROOT, surfaceId);
+  const absDir = path8.join(cwd, MATERIALIZED_ROOT, surfaceId);
   mkdirSync3(absDir, { recursive: true });
   const excluded = excludedModulesForKind(opts.scriptKind ?? null);
   const sources = listDts(sourceGeneratedDir).filter((file) => file !== "index.d.ts").filter((file) => !excluded.has(file.replace(/\.d\.ts$/, "")));
-  const srcDir = path7.resolve(sourceGeneratedDir, "..", "src");
-  const overloads = ["msg-overloads.d.ts", "go-overloads.d.ts"].filter((file) => existsSync3(path7.join(srcDir, file)));
-  const coreTypesSrc = path7.join(srcDir, "core-types.ts");
+  const srcDir = path8.resolve(sourceGeneratedDir, "..", "src");
+  const overloads = ["msg-overloads.d.ts", "go-overloads.d.ts"].filter((file) => existsSync3(path8.join(srcDir, file)));
+  const coreTypesSrc = path8.join(srcDir, "core-types.ts");
   const includeCoreTypes = overloads.length > 0 && existsSync3(coreTypesSrc);
   const wanted = new Set(sources);
   for (const file of overloads) {
@@ -567,39 +606,39 @@ function materializeApiSurface(opts) {
   }
   for (const existing of readdirSync2(absDir)) {
     if (existing.endsWith(".d.ts") && existing !== "index.d.ts" && !wanted.has(existing)) {
-      rmSync2(path7.join(absDir, existing));
+      rmSync2(path8.join(absDir, existing));
     }
   }
   for (const file of sources) {
-    writeFileSync3(path7.join(absDir, file), readFileSync6(path7.join(sourceGeneratedDir, file), "utf8"));
+    writeFileSync3(path8.join(absDir, file), readFileSync7(path8.join(sourceGeneratedDir, file), "utf8"));
   }
   if (includeCoreTypes) {
-    writeFileSync3(path7.join(absDir, "core-types.d.ts"), readFileSync6(coreTypesSrc, "utf8"));
+    writeFileSync3(path8.join(absDir, "core-types.d.ts"), readFileSync7(coreTypesSrc, "utf8"));
   }
   for (const file of overloads) {
-    writeFileSync3(path7.join(absDir, file), readFileSync6(path7.join(srcDir, file), "utf8"));
+    writeFileSync3(path8.join(absDir, file), readFileSync7(path8.join(srcDir, file), "utf8"));
   }
   const modules = [...sources, ...overloads].map((file) => file.replace(/\.d\.ts$/, ""));
   const imports = modules.map((mod) => `import "./${mod}";`).join(`
 `);
-  writeFileSync3(path7.join(absDir, "index.d.ts"), `${imports}
+  writeFileSync3(path8.join(absDir, "index.d.ts"), `${imports}
 
 export {};
 `);
-  writeJson2(path7.join(absDir, "package.json"), {
+  writeJson2(path8.join(absDir, "package.json"), {
     name: `@defold-typescript/materialized-${surfaceId}`,
     types: "index.d.ts"
   });
   return { materializedDir: relDir, active: surfaceId };
 }
 function ensureGitignoreLine(cwd, line) {
-  const gitignorePath = path7.join(cwd, ".gitignore");
+  const gitignorePath = path8.join(cwd, ".gitignore");
   if (!existsSync3(gitignorePath)) {
     writeFileSync3(gitignorePath, `${line}
 `);
     return;
   }
-  const existing = readFileSync6(gitignorePath, "utf8");
+  const existing = readFileSync7(gitignorePath, "utf8");
   const present = new Set(existing.split(`
 `).map((entry) => entry.trim()));
   if (present.has(line)) {
@@ -615,10 +654,10 @@ function ensureMaterializedReference(cwd, materializedDir) {
   if (materializedDir === null) {
     return;
   }
-  const surfaceId = path7.posix.basename(materializedDir);
-  const tsconfigPath = path7.join(cwd, "tsconfig.json");
+  const surfaceId = path8.posix.basename(materializedDir);
+  const tsconfigPath = path8.join(cwd, "tsconfig.json");
   if (existsSync3(tsconfigPath)) {
-    const tsconfig = JSON.parse(readFileSync6(tsconfigPath, "utf8"));
+    const tsconfig = JSON.parse(readFileSync7(tsconfigPath, "utf8"));
     tsconfig.compilerOptions = {
       ...tsconfig.compilerOptions ?? {},
       typeRoots: [MATERIALIZED_ROOT],
@@ -630,7 +669,7 @@ function ensureMaterializedReference(cwd, materializedDir) {
 }
 function resolveCurrentSurfaceGeneratedDir() {
   const root = resolveTypesPackageRoot();
-  return root === null ? null : path7.join(root, "generated");
+  return root === null ? null : path8.join(root, "generated");
 }
 async function materializeRefDocSurface(opts) {
   const { cwd, surfaceId, resolveOpts } = opts;
@@ -640,21 +679,21 @@ async function materializeRefDocSurface(opts) {
   }
   const registry = opts.registry ?? loadApiTargetsRegistry();
   const target = registry.find((t) => t.id === surfaceId);
-  if (!target || target.source?.kind !== "ref-doc") {
+  if (target?.source?.kind !== "ref-doc") {
     return { materializedDir: null, active: null };
   }
   const excludeModules = [...excludedModulesForKind(opts.scriptKind ?? null)];
-  const relDir = path7.posix.join(MATERIALIZED_ROOT, surfaceId);
-  const absDir = path7.join(cwd, MATERIALIZED_ROOT, surfaceId);
+  const relDir = path8.posix.join(MATERIALIZED_ROOT, surfaceId);
+  const absDir = path8.join(cwd, MATERIALIZED_ROOT, surfaceId);
   try {
-    const mod = await import(path7.join(root, "scripts", "materialize-version.ts"));
+    const mod = await import(path8.join(root, "scripts", "materialize-version.ts"));
     const selfContained = { ...target, coreTypesImport: "./core-types" };
     await mod.materializeVersionedSurface(selfContained, {
       destDir: absDir,
       ...resolveOpts ? { resolveOpts } : {},
       ...excludeModules.length > 0 ? { excludeModules } : {}
     });
-    copyFileSync(path7.join(root, "src", "core-types.ts"), path7.join(absDir, "core-types.d.ts"));
+    copyFileSync(path8.join(root, "src", "core-types.ts"), path8.join(absDir, "core-types.d.ts"));
   } catch {
     rmSync2(absDir, { recursive: true, force: true });
     return { materializedDir: null, active: null };
@@ -664,7 +703,7 @@ async function materializeRefDocSurface(opts) {
 
 // src/watch.ts
 import { existsSync as existsSync4, watch as fsWatch } from "node:fs";
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 var DEFAULT_DEBOUNCE_MS = 50;
 var recursiveWatcherFactory = (srcDir, onEvent) => {
   const w = fsWatch(srcDir, { recursive: true }, (eventType, filename) => {
@@ -707,7 +746,7 @@ function runWatch(opts) {
       waitForIdle: () => Promise.resolve()
     };
   }
-  const srcDir = path8.join(cwd, "src");
+  const srcDir = path9.join(cwd, "src");
   let scheduled = null;
   let syncScheduled = null;
   let rebuildBusy = false;
@@ -731,7 +770,7 @@ function runWatch(opts) {
     const removed = [];
     for (const rel of drained) {
       const key = `src/${toPosix(rel)}`;
-      if (existsSync4(path8.join(srcDir, rel))) {
+      if (existsSync4(path9.join(srcDir, rel))) {
         changed.push(key);
       } else {
         removed.push(key);
@@ -751,9 +790,10 @@ function runWatch(opts) {
   function onEvent(e) {
     if (stopped)
       return;
+    if (!e.path || !isTranspilerSource(e.path))
+      return;
     rebuildBusy = true;
-    if (e.path)
-      pending.add(e.path);
+    pending.add(e.path);
     if (scheduled)
       clearTimeout(scheduled);
     scheduled = setTimeout(rebuild, debounceMs);
@@ -831,23 +871,30 @@ function parseDefoldVersionFlag(argv) {
   return { flag, rest };
 }
 function readProjectPin(cwd) {
-  const pkgPath = path9.join(cwd, "package.json");
+  const pkgPath = path10.join(cwd, "package.json");
   if (!existsSync5(pkgPath)) {
     return;
   }
   try {
-    return readDefoldVersionPin(JSON.parse(readFileSync7(pkgPath, "utf8")));
+    return readDefoldVersionPin(JSON.parse(readFileSync8(pkgPath, "utf8")));
   } catch {
     return;
   }
 }
 function dispatch(argv, io, internals) {
   const json = argv.includes("--json");
+  if (argv.includes("--version") || argv.includes("-v")) {
+    const version = internals?.cliVersion ?? readCliVersion();
+    io.stdout.write(json ? `{"command":"version","ok":true,"version":${JSON.stringify(version)}}
+` : `defold-typescript ${version}
+`);
+    return 0;
+  }
   const force = argv.includes("--force");
   const { flag: defoldVersionFlag, rest: nonFlagArgs } = parseDefoldVersionFlag(argv);
   const positional = nonFlagArgs.filter((a) => a !== "--json" && a !== "--force");
   const [command, ...rest] = positional;
-  const cwd = rest[0] ? path9.resolve(rest[0]) : process.cwd();
+  const cwd = rest[0] ? path10.resolve(rest[0]) : process.cwd();
   const pin = readProjectPin(cwd);
   const resolvedVersion = resolveDefoldVersion({
     ...defoldVersionFlag !== undefined ? { flag: defoldVersionFlag } : {},

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@defold-typescript/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "End-user CLI for scaffolding and building Defold projects written in TypeScript.",
+  "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -30,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@defold-typescript/transpiler": "0.1.0",
-    "@defold-typescript/types": "0.1.0"
+    "@defold-typescript/transpiler": "0.3.0",
+    "@defold-typescript/types": "0.3.0"
   }
 }

package/src/build-output.ts

@@ -21,6 +21,12 @@ export function toPosix(p: string, sep: string = path.sep): string {
   return p.split(sep).join("/");
 }
 
+const TRANSPILER_SOURCE_RE = /\.(ts|tsx|cts|mts)$/;
+
+export function isTranspilerSource(rel: string): boolean {
+  return TRANSPILER_SOURCE_RE.test(toPosix(rel));
+}
+
 export function readBuildConfig(cwd: string): BuildConfig {
   const tsconfigPath = path.join(cwd, "tsconfig.json");
   let raw: string;

package/src/build-session.ts

@@ -9,6 +9,7 @@ import {
   type BuildConfig,
   collectFailures,
   computeLuaRel,
+  isTranspilerSource,
   readBuildConfig,
   throwIfFailures,
   toPosix,
@@ -75,23 +76,25 @@ export function createBuildSession(opts: CreateBuildSessionOptions): BuildSessio
   }
 
   function applyEvents(changed: string[], removed: string[]): BuildResult {
+    const sourceChanged = changed.filter(isTranspilerSource);
+    const sourceRemoved = removed.filter(isTranspilerSource);
     const changes: Record<string, string | null> = {};
-    for (const rel of changed) {
+    for (const rel of sourceChanged) {
       changes[rel] = readFileSync(path.join(cwd, rel), "utf8");
     }
-    for (const rel of removed) {
+    for (const rel of sourceRemoved) {
       changes[rel] = null;
     }
 
     const result = session.update(changes);
 
-    for (const rel of removed) {
+    for (const rel of sourceRemoved) {
       const luaAbs = path.join(cwd, computeLuaRel(rel, config));
       rmSync(luaAbs, { force: true });
       rmSync(`${luaAbs}.map`, { force: true });
     }
 
-    return writeOutputs(result, changed);
+    return writeOutputs(result, sourceChanged);
   }
 
   return { buildAll, applyEvents };

package/src/cli-version.ts

@@ -0,0 +1,26 @@
+import { readFileSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const VERSION_FALLBACK = "0.0.0";
+
+// Anchor on the module URL, not `import.meta.dir` — the latter is a Bun-only
+// property and is undefined when the bundled CLI runs under node (the `npx`
+// path), which would silently anchor at the cwd. The bundled bin (`dist/bin.js`)
+// and the in-repo `src/` loop both sit one level below the package root, so
+// `package.json` is always `../package.json` from this module's directory. A
+// missing or malformed manifest reports the fallback rather than throwing.
+function defaultPackageRoot(): string {
+  return path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+
+export function readCliVersion(packageRoot: string = defaultPackageRoot()): string {
+  try {
+    const pkg = JSON.parse(readFileSync(path.join(packageRoot, "package.json"), "utf8")) as {
+      version?: unknown;
+    };
+    return typeof pkg.version === "string" ? pkg.version : VERSION_FALLBACK;
+  } catch {
+    return VERSION_FALLBACK;
+  }
+}

package/src/dispatch.ts

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import type { RegistryTarget } from "./api-registry";
 import { CURRENT_STABLE_SURFACE_ID, selectApiSurface } from "./api-surface";
 import { runBuild } from "./build";
+import { readCliVersion } from "./cli-version";
 import { readDefoldVersionPin, resolveDefoldVersion } from "./defold-version";
 import { runInit } from "./init";
 import { renderResult } from "./json-output";
@@ -35,6 +36,7 @@ export interface DispatchInternals {
   readonly sourceGeneratedDir?: string;
   readonly resolveOpts?: RefDocResolveOptions;
   readonly refDocRegistry?: readonly RegistryTarget[];
+  readonly cliVersion?: string;
 }
 
 const USAGE = "Usage: defold-typescript <init|build|watch> [path]\n";
@@ -74,6 +76,17 @@ export function dispatch(
   internals?: DispatchInternals,
 ): number | Promise<number> {
   const json = argv.includes("--json");
+
+  if (argv.includes("--version") || argv.includes("-v")) {
+    const version = internals?.cliVersion ?? readCliVersion();
+    io.stdout.write(
+      json
+        ? `{"command":"version","ok":true,"version":${JSON.stringify(version)}}\n`
+        : `defold-typescript ${version}\n`,
+    );
+    return 0;
+  }
+
   const force = argv.includes("--force");
   const { flag: defoldVersionFlag, rest: nonFlagArgs } = parseDefoldVersionFlag(argv);
   const positional = nonFlagArgs.filter((a) => a !== "--json" && a !== "--force");

package/src/init.ts

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import * as path from "node:path";
+import { fileURLToPath } from "node:url";
 import { CURRENT_STABLE_DEFOLD_VERSION } from "./defold-version";
 import {
   detectScriptKinds,
@@ -103,12 +104,44 @@ interface PackageJson {
   [key: string]: unknown;
 }
 
+function typesVersionSpec(): string {
+  try {
+    // Anchor on the module URL, not `import.meta.dir` — the latter is a
+    // Bun-only property and is undefined when the bundled CLI runs under node
+    // (the `npx` path), which would silently fall back to "latest".
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(path.join(here, "..", "package.json"), "utf8")) as {
+      version?: string;
+    };
+    return pkg.version ? `^${pkg.version}` : "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+// Only @defold-typescript/types ships into the consumer (type-only, for the
+// editor). The transpiler is a dependency of the CLI itself, pulled in when the
+// user runs `build`/`watch`; the scaffold must not duplicate it. Pin types to
+// this CLI's own version so the coordinated-release set stays in lockstep.
 const SCAFFOLD_DEV_DEPS: Record<string, string> = {
-  "@defold-typescript/transpiler": "workspace:*",
-  "@defold-typescript/types": "workspace:*",
+  "@defold-typescript/types": typesVersionSpec(),
   "@biomejs/biome": "^2.2.0",
 };
 
+// Older scaffolds wrote both managed `@defold-typescript/*` devDeps as
+// `workspace:*`, which only resolves inside this monorepo and breaks
+// `bun install` in consumers. The additive merge in `writeTsSurface` never
+// repairs an entry it didn't itself create, so repair them explicitly: the
+// transpiler is CLI-internal and must not be a consumer dep at all, and a
+// `workspace:` types pin must become a concrete published version. A concrete
+// user-chosen types pin is left alone.
+function repairManagedDevDeps(devDeps: Record<string, string>): void {
+  delete devDeps["@defold-typescript/transpiler"];
+  if (devDeps["@defold-typescript/types"]?.startsWith("workspace:")) {
+    devDeps["@defold-typescript/types"] = typesVersionSpec();
+  }
+}
+
 function writeJson(filePath: string, value: unknown): void {
   writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
 }
@@ -163,6 +196,7 @@ function writeTsSurface(cwd: string, written: string[]): ScriptKind | null {
         devDeps[name] = version;
       }
     }
+    repairManagedDevDeps(devDeps);
     existing.devDependencies = devDeps;
     existing["defold-typescript"] ??= { "defold-version": CURRENT_STABLE_DEFOLD_VERSION };
     writeJson(pkgPath, existing);

package/src/materialize.ts

@@ -198,7 +198,7 @@ export async function materializeRefDocSurface(
   }
   const registry = opts.registry ?? loadApiTargetsRegistry();
   const target = registry.find((t) => t.id === surfaceId);
-  if (!target || target.source?.kind !== "ref-doc") {
+  if (target?.source?.kind !== "ref-doc") {
     return { materializedDir: null, active: null };
   }
   const excludeModules = [...excludedModulesForKind(opts.scriptKind ?? null)];

package/src/watch.ts

@@ -1,6 +1,6 @@
 import { existsSync, watch as fsWatch } from "node:fs";
 import * as path from "node:path";
-import { toPosix } from "./build-output";
+import { isTranspilerSource, toPosix } from "./build-output";
 import { type BuildSession, createBuildSession } from "./build-session";
 import { isComponentPath, isSkipped } from "./script-kind";
 
@@ -123,8 +123,9 @@ export function runWatch(opts: RunWatchOptions): RunWatchHandle {
 
   function onEvent(e: WatchEvent): void {
     if (stopped) return;
+    if (!e.path || !isTranspilerSource(e.path)) return;
     rebuildBusy = true;
-    if (e.path) pending.add(e.path);
+    pending.add(e.path);
     if (scheduled) clearTimeout(scheduled);
     scheduled = setTimeout(rebuild, debounceMs);
   }