@defold-typescript/cli 0.5.2 → 0.5.4

package/dist/index.js

@@ -295,6 +295,169 @@ import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFi
 import * as path7 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
+// src/debug-launcher.ts
+var PLATFORM_TARGETS = {
+  darwin: { enginePlatform: "x86_64-darwin", buildFolder: "x86_64-osx", executable: "dmengine" },
+  linux: { enginePlatform: "x86_64-linux", buildFolder: "x86_64-linux", executable: "dmengine" },
+  win32: {
+    enginePlatform: "x86_64-win32",
+    buildFolder: "x86_64-win32",
+    executable: "dmengine.exe"
+  }
+};
+var ENGINE_INFO_URL = "https://d.defold.com/stable/info.json";
+var ENGINE_ARCHIVE_BASE = "https://d.defold.com/archive/stable";
+var DEBUG_LAUNCHER_REL = ".vscode/defold-debug.ts";
+function debugLaunchConfig() {
+  return {
+    name: "Defold: Debug (TypeScript)",
+    type: "lua-local",
+    request: "launch",
+    stopOnEntry: false,
+    verbose: false,
+    internalConsoleOptions: "openOnSessionStart",
+    program: { command: "bun" },
+    args: [DEBUG_LAUNCHER_REL]
+  };
+}
+var VSCODE_LAUNCH_CONTENT = {
+  version: "0.2.0",
+  configurations: [debugLaunchConfig()]
+};
+function renderDebugLauncher() {
+  const targets = JSON.stringify(PLATFORM_TARGETS, null, 2);
+  return `import { chmodSync, copyFileSync, existsSync, mkdirSync } from "node:fs";
+import * as path from "node:path";
+
+// Windows only: paths to OpenAL32.dll and wrap_oal.dll from your Defold SDK
+// (defoldsdk/ext/lib/x86_64-win32/). Leave empty on macOS/Linux.
+const WINDOWS_OPENAL32_PATH = "";
+const WINDOWS_WRAPOAL_PATH = "";
+
+interface EngineTarget {
+  enginePlatform: string;
+  buildFolder: string;
+  executable: string;
+}
+
+const PLATFORM_TARGETS: Record<string, EngineTarget> = ${targets};
+
+const ENGINE_INFO_URL = "${ENGINE_INFO_URL}";
+const ENGINE_ARCHIVE_BASE = "${ENGINE_ARCHIVE_BASE}";
+
+const target = PLATFORM_TARGETS[process.platform];
+if (!target) {
+  console.error(\`Unsupported platform: \${process.platform}\`);
+  process.exit(1);
+}
+
+const here = path.dirname(new URL(import.meta.url).pathname);
+const stockEnginePath = path.join(here, target.executable);
+
+if (!existsSync(stockEnginePath)) {
+  const info = (await (await fetch(ENGINE_INFO_URL)).json()) as { sha1: string };
+  const url = \`\${ENGINE_ARCHIVE_BASE}/\${info.sha1}/engine/\${target.enginePlatform}/\${target.executable}\`;
+  console.log(\`Fetching \${url}\`);
+  const res = await fetch(url);
+  if (!res.ok) {
+    console.error(\`Engine download failed: \${res.status} \${res.statusText}\`);
+    process.exit(1);
+  }
+  await Bun.write(stockEnginePath, res);
+}
+
+const buildFolder = path.join("build", target.buildFolder);
+const buildEnginePath = path.join(buildFolder, target.executable);
+let enginePath = existsSync(buildEnginePath) ? buildEnginePath : stockEnginePath;
+
+if (process.platform === "win32" && enginePath === buildEnginePath) {
+  for (const [src, name] of [
+    [WINDOWS_OPENAL32_PATH, "OpenAL32.dll"],
+    [WINDOWS_WRAPOAL_PATH, "wrap_oal.dll"],
+  ] as const) {
+    const dest = path.join(buildFolder, name);
+    if (src && !existsSync(dest)) {
+      copyFileSync(src, dest);
+    }
+  }
+}
+
+// macOS: a build engine launched in place attaches to the editor process; copy
+// it aside first so it runs standalone.
+if (process.platform === "darwin" && enginePath === buildEnginePath) {
+  const tempEngine = path.join(buildFolder, "temp", target.executable);
+  mkdirSync(path.dirname(tempEngine), { recursive: true });
+  copyFileSync(buildEnginePath, tempEngine);
+  enginePath = tempEngine;
+}
+
+if (process.platform !== "win32") {
+  chmodSync(enginePath, 0o755);
+}
+
+const projectc = path.join("build", "default", "game.projectc");
+console.log(\`Launching \${enginePath} \${projectc}\`);
+const proc = Bun.spawn([enginePath, projectc], {
+  stdio: ["inherit", "inherit", "inherit"],
+});
+process.exit(await proc.exited);
+`;
+}
+var DEBUG_LAUNCHER_SOURCE = renderDebugLauncher();
+
+// src/mise-scaffold.ts
+var MANAGED_MARKER = "# managed by @defold-typescript";
+var MISE_TASKS_TOML = `${MANAGED_MARKER}
+[tasks."defold-typescript:build"]
+description = "Build the TypeScript sources with the installed defold-typescript CLI"
+run = "bunx --no-install defold-typescript build"
+
+${MANAGED_MARKER}
+[tasks."defold-typescript:watch"]
+description = "Watch and rebuild the TypeScript sources with the installed defold-typescript CLI"
+run = "bunx --no-install defold-typescript watch"
+
+${MANAGED_MARKER}
+[tasks."defold-typescript:upgrade"]
+description = "Upgrade the defold-typescript CLI to its latest release and re-pin the types dependency"
+run = ["bunx @defold-typescript/cli@latest init --force", "bun install"]
+`;
+function stripManagedBlocks(text) {
+  const lines = text.split(`
+`);
+  const out = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i] ?? "";
+    if (line.trim() === MANAGED_MARKER) {
+      i += 1;
+      while (i < lines.length && (lines[i] ?? "").trim() !== "") {
+        i += 1;
+      }
+      if (i < lines.length) {
+        i += 1;
+      }
+      continue;
+    }
+    out.push(line);
+    i += 1;
+  }
+  return out.join(`
+`);
+}
+function mergeMiseToml(existing) {
+  if (existing === undefined) {
+    return MISE_TASKS_TOML;
+  }
+  const userContent = stripManagedBlocks(existing).replace(/\s*$/, "");
+  if (userContent === "") {
+    return MISE_TASKS_TOML;
+  }
+  return `${userContent}
+
+${MISE_TASKS_TOML}`;
+}
+
 // src/script-kind.ts
 var DEFAULT_TYPES_ENTRYPOINT = "@defold-typescript/types";
 var KIND_BY_EXT = {
@@ -406,43 +569,64 @@ var BIOME_JSON_CONTENT = {
   }
 };
 var VSCODE_EXTENSIONS_CONTENT = {
-  recommendations: ["sumneko.lua", "astronachos.defold"],
+  recommendations: ["sumneko.lua", "astronachos.defold", "tomblind.local-lua-debugger-vscode"],
   unwantedRecommendations: ["johnnymorganz.luau-lsp"]
 };
 var VSCODE_SETTINGS_CONTENT = {
   "Lua.workspace.ignoreDir": ["src"]
 };
+var HOOK_COMMENTS = {
+  init: "Initialize the component and return its state.",
+  update: "Update the component every frame; `dt` is the time step.",
+  fixed_update: "Update at the fixed physics time step.",
+  late_update: "Update every frame after `update`.",
+  on_message: "Handle an incoming message.",
+  on_input: "Handle input once input focus is acquired.",
+  final: "Clean up when the component is deleted.",
+  on_reload: "React to a hot reload of this script."
+};
+var HOOK_SIGNATURES = {
+  init: "",
+  update: "self, dt",
+  fixed_update: "self, dt",
+  late_update: "self, dt",
+  on_message: "self, message_id, message, sender",
+  on_input: "self, action_id, action",
+  final: "self",
+  on_reload: "self"
+};
+var SNIPPET_HOOK_ORDER = Object.keys(HOOK_SIGNATURES);
+function hookLines(includeOnInput, startTabStop) {
+  const lines = [];
+  let tabStop = startTabStop;
+  for (const hook of SNIPPET_HOOK_ORDER) {
+    if (hook === "init") {
+      continue;
+    }
+    if (hook === "on_input" && !includeOnInput) {
+      continue;
+    }
+    lines.push(`  // ${HOOK_COMMENTS[hook]}`);
+    lines.push(`  ${hook}(${HOOK_SIGNATURES[hook]}) {$${tabStop}},`);
+    tabStop += 1;
+  }
+  return lines;
+}
 function inlineSnippetBody(factory, includeOnInput) {
-  const lines = [
+  return [
     `import { ${factory} } from "@defold-typescript/types";`,
     "",
     `export const script = ${factory}({`,
-    "  // Initialize the component and return its state.",
+    `  // ${HOOK_COMMENTS.init}`,
     "  init() {",
     "    return { $0 };",
     "  },",
-    "  // Update the component every frame; `dt` is the time step.",
-    "  update(self, dt) {$1},",
-    "  // Update at the fixed physics time step.",
-    "  fixed_update(self, dt) {$2},",
-    "  // Update every frame after `update`.",
-    "  late_update(self, dt) {$3},",
-    "  // Handle an incoming message.",
-    "  on_message(self, message_id, message, sender) {$4},"
+    ...hookLines(includeOnInput, 1),
+    "});"
   ];
-  if (includeOnInput) {
-    lines.push("  // Handle input once input focus is acquired.");
-    lines.push("  on_input(self, action_id, action) {$5},");
-  }
-  lines.push("  // Clean up when the component is deleted.");
-  lines.push("  final(self) {$6},");
-  lines.push("  // React to a hot reload of this script.");
-  lines.push("  on_reload(self) {$7},");
-  lines.push("});");
-  return lines;
 }
 function typedSnippetBody(factory, includeOnInput) {
-  const lines = [
+  return [
     `import { ${factory} } from "@defold-typescript/types";`,
     "",
     "type Self = {",
@@ -451,29 +635,13 @@ function typedSnippetBody(factory, includeOnInput) {
     "};",
     "",
     `export const script = ${factory}<Self>({`,
-    "  // Initialize the component and return its state.",
+    `  // ${HOOK_COMMENTS.init}`,
     "  init(): Self {",
     "    return { $0 };",
     "  },",
-    "  // Update the component every frame; `dt` is the time step.",
-    "  update(self, dt) {$2},",
-    "  // Update at the fixed physics time step.",
-    "  fixed_update(self, dt) {$3},",
-    "  // Update every frame after `update`.",
-    "  late_update(self, dt) {$4},",
-    "  // Handle an incoming message.",
-    "  on_message(self, message_id, message, sender) {$5},"
+    ...hookLines(includeOnInput, 2),
+    "});"
   ];
-  if (includeOnInput) {
-    lines.push("  // Handle input once input focus is acquired.");
-    lines.push("  on_input(self, action_id, action) {$6},");
-  }
-  lines.push("  // Clean up when the component is deleted.");
-  lines.push("  final(self) {$7},");
-  lines.push("  // React to a hot reload of this script.");
-  lines.push("  on_reload(self) {$8},");
-  lines.push("});");
-  return lines;
 }
 var VSCODE_SNIPPETS_CONTENT = {
   "Defold script (inferred self)": {
@@ -544,12 +712,15 @@ function typesVersionSpec() {
 }
 var SCAFFOLD_DEV_DEPS = {
   "@defold-typescript/types": typesVersionSpec(),
+  "@defold-typescript/cli": typesVersionSpec(),
   "@biomejs/biome": "^2.2.0"
 };
 function repairManagedDevDeps(devDeps, force = false) {
   delete devDeps["@defold-typescript/transpiler"];
-  if (force || devDeps["@defold-typescript/types"]?.startsWith("workspace:")) {
-    devDeps["@defold-typescript/types"] = typesVersionSpec();
+  for (const name of ["@defold-typescript/types", "@defold-typescript/cli"]) {
+    if (force || devDeps[name]?.startsWith("workspace:")) {
+      devDeps[name] = typesVersionSpec();
+    }
   }
 }
 function writeJson(filePath, value) {
@@ -586,6 +757,12 @@ function writeBiome(cwd, written) {
   writeJson(biomePath, BIOME_JSON_CONTENT);
   written.push("biome.json");
 }
+function writeMiseTasks(cwd, written) {
+  const misePath = path7.join(cwd, "mise.toml");
+  const existing = existsSync2(misePath) ? readFileSync6(misePath, "utf8") : undefined;
+  writeFileSync2(misePath, mergeMiseToml(existing));
+  written.push("mise.toml");
+}
 function parseJsonc(text) {
   let out = "";
   let inString = false;
@@ -707,6 +884,39 @@ function writeVscodeSnippets(cwd, written) {
   writeJson(filePath, VSCODE_SNIPPETS_CONTENT);
   written.push(".vscode/defold-typescript.code-snippets");
 }
+function writeVscodeLaunch(cwd, written) {
+  const dir = path7.join(cwd, ".vscode");
+  const filePath = path7.join(dir, "launch.json");
+  const ours = debugLaunchConfig();
+  if (existsSync2(filePath)) {
+    const existing = readVscodeJson(filePath);
+    if (existing === null) {
+      return;
+    }
+    const configs = Array.isArray(existing.configurations) ? [...existing.configurations] : [];
+    const names = new Set(configs.map((c) => isJsonObject(c) ? c.name : undefined));
+    if (!names.has(ours.name)) {
+      configs.push(ours);
+    }
+    existing.configurations = configs;
+    existing.version ??= VSCODE_LAUNCH_CONTENT.version;
+    writeJson(filePath, existing);
+    return;
+  }
+  mkdirSync2(dir, { recursive: true });
+  writeJson(filePath, VSCODE_LAUNCH_CONTENT);
+  written.push(".vscode/launch.json");
+}
+function writeVscodeDebugLauncher(cwd, written) {
+  const dir = path7.join(cwd, ".vscode");
+  const filePath = path7.join(dir, "defold-debug.ts");
+  if (existsSync2(filePath)) {
+    return;
+  }
+  mkdirSync2(dir, { recursive: true });
+  writeFileSync2(filePath, DEBUG_LAUNCHER_SOURCE);
+  written.push(".vscode/defold-debug.ts");
+}
 function writeTsSurface(cwd, written, force = false) {
   mkdirSync2(path7.join(cwd, "src"), { recursive: true });
   writeFileSync2(path7.join(cwd, "src", "main.ts"), MAIN_TS_CONTENT);
@@ -748,9 +958,12 @@ function writeTsSurface(cwd, written, force = false) {
   writeGitignore(cwd);
   written.push(".gitignore");
   writeBiome(cwd, written);
+  writeMiseTasks(cwd, written);
   writeVscodeExtensions(cwd, written);
   writeVscodeSettings(cwd, written);
   writeVscodeSnippets(cwd, written);
+  writeVscodeLaunch(cwd, written);
+  writeVscodeDebugLauncher(cwd, written);
   return selectScriptKind(kinds);
 }
 function runNewProjectInit(cwd, force = false) {
@@ -833,7 +1046,7 @@ function materializeApiSurface(opts) {
   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 = path8.resolve(sourceGeneratedDir, "..", "src");
-  const overloads = ["msg-overloads.d.ts", "go-overloads.d.ts"].filter((file) => existsSync3(path8.join(srcDir, file)));
+  const overloads = ["msg-overloads.d.ts", "message-guard.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 engineGlobalsSrc = path8.join(srcDir, "engine-globals.d.ts");
@@ -908,12 +1121,16 @@ function ensureMaterializedReference(cwd, materializedDir) {
   const tsconfigPath = path8.join(cwd, "tsconfig.json");
   if (existsSync3(tsconfigPath)) {
     const tsconfig = JSON.parse(readFileSync7(tsconfigPath, "utf8"));
-    tsconfig.compilerOptions = {
-      ...tsconfig.compilerOptions ?? {},
-      typeRoots: [MATERIALIZED_ROOT],
-      types: [surfaceId]
-    };
-    writeJson2(tsconfigPath, tsconfig);
+    const current = tsconfig.compilerOptions ?? {};
+    const alreadyRepointed = JSON.stringify(current.typeRoots) === JSON.stringify([MATERIALIZED_ROOT]) && JSON.stringify(current.types) === JSON.stringify([surfaceId]);
+    if (!alreadyRepointed) {
+      tsconfig.compilerOptions = {
+        ...current,
+        typeRoots: [MATERIALIZED_ROOT],
+        types: [surfaceId]
+      };
+      writeJson2(tsconfigPath, tsconfig);
+    }
   }
   ensureGitignoreLine(cwd, `${MATERIALIZED_ROOT}/`);
 }

package/dist/init.d.ts

@@ -7,5 +7,6 @@ export interface RunInitResult {
     readonly written: string[];
     readonly scriptKind: ScriptKind | null;
 }
+export declare const SCAFFOLD_DEV_DEPS: Record<string, string>;
 export declare function runNewProjectInit(cwd: string, force?: boolean): RunInitResult;
 export declare function runInit(opts: RunInitOptions): RunInitResult;

package/dist/mise-scaffold.d.ts

@@ -0,0 +1,2 @@
+export declare const MISE_TASKS_TOML = "# managed by @defold-typescript\n[tasks.\"defold-typescript:build\"]\ndescription = \"Build the TypeScript sources with the installed defold-typescript CLI\"\nrun = \"bunx --no-install defold-typescript build\"\n\n# managed by @defold-typescript\n[tasks.\"defold-typescript:watch\"]\ndescription = \"Watch and rebuild the TypeScript sources with the installed defold-typescript CLI\"\nrun = \"bunx --no-install defold-typescript watch\"\n\n# managed by @defold-typescript\n[tasks.\"defold-typescript:upgrade\"]\ndescription = \"Upgrade the defold-typescript CLI to its latest release and re-pin the types dependency\"\nrun = [\"bunx @defold-typescript/cli@latest init --force\", \"bun install\"]\n";
+export declare function mergeMiseToml(existing?: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/cli",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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.5.2",
-    "@defold-typescript/types": "0.5.2"
+    "@defold-typescript/transpiler": "0.5.4",
+    "@defold-typescript/types": "0.5.4"
   }
 }

package/src/debug-launcher.ts

@@ -0,0 +1,165 @@
+import * as path from "node:path";
+
+export interface EngineTarget {
+  readonly enginePlatform: string;
+  readonly buildFolder: string;
+  readonly executable: string;
+}
+
+// `enginePlatform` keys the d.defold.com download path; `buildFolder` keys the
+// native-extension build output. They diverge on macOS (`x86_64-darwin` vs
+// `x86_64-osx`), which is why they are tracked separately.
+const PLATFORM_TARGETS: Record<string, EngineTarget> = {
+  darwin: { enginePlatform: "x86_64-darwin", buildFolder: "x86_64-osx", executable: "dmengine" },
+  linux: { enginePlatform: "x86_64-linux", buildFolder: "x86_64-linux", executable: "dmengine" },
+  win32: {
+    enginePlatform: "x86_64-win32",
+    buildFolder: "x86_64-win32",
+    executable: "dmengine.exe",
+  },
+};
+
+const ENGINE_INFO_URL = "https://d.defold.com/stable/info.json";
+const ENGINE_ARCHIVE_BASE = "https://d.defold.com/archive/stable";
+
+export const DEBUG_LAUNCHER_REL = ".vscode/defold-debug.ts";
+
+export function targetPlatform(platform: NodeJS.Platform): EngineTarget {
+  const target = PLATFORM_TARGETS[platform];
+  if (!target) {
+    throw new Error(
+      `defold-typescript debug: unsupported platform "${platform}"; expected one of ${Object.keys(
+        PLATFORM_TARGETS,
+      ).join(", ")}.`,
+    );
+  }
+  return target;
+}
+
+export function engineDownloadUrl(
+  sha1: string,
+  enginePlatform: string,
+  executable: string,
+): string {
+  return `${ENGINE_ARCHIVE_BASE}/${sha1}/engine/${enginePlatform}/${executable}`;
+}
+
+export interface ResolveEngineOptions {
+  readonly cwd: string;
+  readonly target: EngineTarget;
+  readonly stockPath: string;
+  readonly probe: (candidate: string) => boolean;
+}
+
+// Prefer the native-extension build engine when it exists; the stock engine is
+// the fallback for projects without native extensions.
+export function resolveEnginePath(opts: ResolveEngineOptions): string {
+  const { cwd, target, stockPath, probe } = opts;
+  const buildEnginePath = path.join(cwd, "build", target.buildFolder, target.executable);
+  return probe(buildEnginePath) ? buildEnginePath : stockPath;
+}
+
+export function debugLaunchConfig() {
+  return {
+    name: "Defold: Debug (TypeScript)",
+    type: "lua-local",
+    request: "launch",
+    stopOnEntry: false,
+    verbose: false,
+    internalConsoleOptions: "openOnSessionStart",
+    program: { command: "bun" },
+    args: [DEBUG_LAUNCHER_REL],
+  };
+}
+
+export const VSCODE_LAUNCH_CONTENT = {
+  version: "0.2.0",
+  configurations: [debugLaunchConfig()],
+};
+
+// The scaffolded launcher embeds the same platform table and archive endpoints
+// the helpers above use, so the self-contained `.vscode/defold-debug.ts` and the
+// unit-tested logic stay in lockstep. It is a Bun script: `process.platform` for
+// the OS, `fetch` for the engine download, `Bun.spawn` with inherited stdio for
+// the run (the pipe Local Lua Debugger attaches over). No shell, no Git Bash.
+function renderDebugLauncher(): string {
+  const targets = JSON.stringify(PLATFORM_TARGETS, null, 2);
+  return `import { chmodSync, copyFileSync, existsSync, mkdirSync } from "node:fs";
+import * as path from "node:path";
+
+// Windows only: paths to OpenAL32.dll and wrap_oal.dll from your Defold SDK
+// (defoldsdk/ext/lib/x86_64-win32/). Leave empty on macOS/Linux.
+const WINDOWS_OPENAL32_PATH = "";
+const WINDOWS_WRAPOAL_PATH = "";
+
+interface EngineTarget {
+  enginePlatform: string;
+  buildFolder: string;
+  executable: string;
+}
+
+const PLATFORM_TARGETS: Record<string, EngineTarget> = ${targets};
+
+const ENGINE_INFO_URL = "${ENGINE_INFO_URL}";
+const ENGINE_ARCHIVE_BASE = "${ENGINE_ARCHIVE_BASE}";
+
+const target = PLATFORM_TARGETS[process.platform];
+if (!target) {
+  console.error(\`Unsupported platform: \${process.platform}\`);
+  process.exit(1);
+}
+
+const here = path.dirname(new URL(import.meta.url).pathname);
+const stockEnginePath = path.join(here, target.executable);
+
+if (!existsSync(stockEnginePath)) {
+  const info = (await (await fetch(ENGINE_INFO_URL)).json()) as { sha1: string };
+  const url = \`\${ENGINE_ARCHIVE_BASE}/\${info.sha1}/engine/\${target.enginePlatform}/\${target.executable}\`;
+  console.log(\`Fetching \${url}\`);
+  const res = await fetch(url);
+  if (!res.ok) {
+    console.error(\`Engine download failed: \${res.status} \${res.statusText}\`);
+    process.exit(1);
+  }
+  await Bun.write(stockEnginePath, res);
+}
+
+const buildFolder = path.join("build", target.buildFolder);
+const buildEnginePath = path.join(buildFolder, target.executable);
+let enginePath = existsSync(buildEnginePath) ? buildEnginePath : stockEnginePath;
+
+if (process.platform === "win32" && enginePath === buildEnginePath) {
+  for (const [src, name] of [
+    [WINDOWS_OPENAL32_PATH, "OpenAL32.dll"],
+    [WINDOWS_WRAPOAL_PATH, "wrap_oal.dll"],
+  ] as const) {
+    const dest = path.join(buildFolder, name);
+    if (src && !existsSync(dest)) {
+      copyFileSync(src, dest);
+    }
+  }
+}
+
+// macOS: a build engine launched in place attaches to the editor process; copy
+// it aside first so it runs standalone.
+if (process.platform === "darwin" && enginePath === buildEnginePath) {
+  const tempEngine = path.join(buildFolder, "temp", target.executable);
+  mkdirSync(path.dirname(tempEngine), { recursive: true });
+  copyFileSync(buildEnginePath, tempEngine);
+  enginePath = tempEngine;
+}
+
+if (process.platform !== "win32") {
+  chmodSync(enginePath, 0o755);
+}
+
+const projectc = path.join("build", "default", "game.projectc");
+console.log(\`Launching \${enginePath} \${projectc}\`);
+const proc = Bun.spawn([enginePath, projectc], {
+  stdio: ["inherit", "inherit", "inherit"],
+});
+process.exit(await proc.exited);
+`;
+}
+
+export const DEBUG_LAUNCHER_SOURCE = renderDebugLauncher();