@defold-typescript/cli 0.2.0 → 0.3.0

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";
@@ -209,10 +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";
@@ -339,8 +356,8 @@ embedded_instances {
 `;
 function typesVersionSpec() {
   try {
-    const here = path5.dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(readFileSync4(path5.join(here, "..", "package.json"), "utf8"));
+    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";
@@ -350,14 +367,20 @@ var SCAFFOLD_DEV_DEPS = {
   "@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));
@@ -377,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;
   }
@@ -385,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 = {
@@ -396,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 },
@@ -433,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.`);
       }
     }
@@ -481,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)}
@@ -500,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) {
@@ -518,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)) {
@@ -566,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],
@@ -581,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;
@@ -595,17 +619,17 @@ async function materializeRefDocSurface(opts) {
     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 };
@@ -615,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";
@@ -658,7 +682,7 @@ 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);
@@ -668,14 +692,14 @@ function createBuildSession(opts) {
     const sourceRemoved = removed.filter(isTranspilerSource);
     const changes = {};
     for (const rel of sourceChanged) {
-      changes[rel] = readFileSync6(path7.join(cwd, rel), "utf8");
+      changes[rel] = readFileSync7(path8.join(cwd, rel), "utf8");
     }
     for (const rel of sourceRemoved) {
       changes[rel] = null;
     }
     const result = session.update(changes);
     for (const rel of sourceRemoved) {
-      const luaAbs = path7.join(cwd, computeLuaRel(rel, config));
+      const luaAbs = path8.join(cwd, computeLuaRel(rel, config));
       rmSync2(luaAbs, { force: true });
       rmSync2(`${luaAbs}.map`, { force: true });
     }
@@ -727,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;
@@ -751,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);
@@ -852,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/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

@@ -153,8 +153,8 @@ function createBuildSession(opts) {
   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";
@@ -273,10 +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";
@@ -403,8 +420,8 @@ embedded_instances {
 `;
 function typesVersionSpec() {
   try {
-    const here = path6.dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(readFileSync5(path6.join(here, "..", "package.json"), "utf8"));
+    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";
@@ -414,14 +431,20 @@ var SCAFFOLD_DEV_DEPS = {
   "@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));
@@ -441,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;
   }
@@ -449,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 = {
@@ -460,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 },
@@ -497,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.`);
       }
     }
@@ -545,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)}
@@ -564,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) {
@@ -582,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)) {
@@ -630,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],
@@ -645,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;
@@ -659,17 +683,17 @@ async function materializeRefDocSurface(opts) {
     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 };
@@ -679,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) => {
@@ -722,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;
@@ -746,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);
@@ -847,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,6 +1,6 @@
 {
   "name": "@defold-typescript/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "End-user CLI for scaffolding and building Defold projects written in TypeScript.",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@defold-typescript/transpiler": "0.2.0",
-    "@defold-typescript/types": "0.2.0"
+    "@defold-typescript/transpiler": "0.3.0",
+    "@defold-typescript/types": "0.3.0"
   }
 }

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

@@ -128,6 +128,20 @@ const SCAFFOLD_DEV_DEPS: Record<string, string> = {
   "@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`);
 }
@@ -182,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);