@defold-typescript/cli 0.1.0 → 0.2.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

@@ -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;
@@ -208,6 +212,7 @@ function runBuild(opts) {
 // src/init.ts
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
 import * as path5 from "node:path";
+import { fileURLToPath } from "node:url";
 
 // src/script-kind.ts
 var DEFAULT_TYPES_ENTRYPOINT = "@defold-typescript/types";
@@ -332,9 +337,17 @@ embedded_instances {
   scale3 { x: 1.0 y: 1.0 z: 1.0 }
 }
 `;
+function typesVersionSpec() {
+  try {
+    const here = path5.dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync4(path5.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 writeJson(filePath, value) {
@@ -578,7 +591,7 @@ 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)];
@@ -651,20 +664,22 @@ 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] = readFileSync6(path7.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 = path7.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 };
 }
@@ -756,9 +771,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);

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/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,20 +133,22 @@ 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 };
 }
@@ -270,6 +276,7 @@ function runBuild(opts) {
 // 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 } from "node:url";
 
 // src/script-kind.ts
 var DEFAULT_TYPES_ENTRYPOINT = "@defold-typescript/types";
@@ -394,9 +401,17 @@ embedded_instances {
   scale3 { x: 1.0 y: 1.0 z: 1.0 }
 }
 `;
+function typesVersionSpec() {
+  try {
+    const here = path6.dirname(fileURLToPath(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 writeJson(filePath, value) {
@@ -640,7 +655,7 @@ 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)];
@@ -751,9 +766,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);

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@defold-typescript/cli",
-  "version": "0.1.0",
+  "version": "0.2.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.2.0",
+    "@defold-typescript/types": "0.2.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/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,9 +104,27 @@ 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",
 };
 

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);
   }