lecodes-cli 2.4.9 → 2.4.10

package/dist/index.js

@@ -64,7 +64,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "lecodes-cli",
-    version: "2.4.9",
+    version: "2.4.10",
     dependencies: {
       "@letary/chisel": "^0.15.0",
       jimp: "^1.6.1",
@@ -89,9 +89,9 @@ var init_package = __esm(() => {
     },
     peerDependencies: {
       "lecodes-design": "^0.11.0",
-      "lecodes-headless": "^2.4.9",
+      "lecodes-headless": "^2.4.10",
       "lecodes-3d-editor": "^0.9.0",
-      "lecodes-assets": "^0.2.1",
+      "lecodes-assets": "^2.4.10",
       "heic-decode": "^2.1.0",
       "marcidb-embedded": "^0.15.0",
       sharp: "^0.35.2",
@@ -159,7 +159,7 @@ var init_package = __esm(() => {
 });
 
 // ../../sdk/src/version.ts
-var SDK_VERSION = "2.4.9";
+var SDK_VERSION = "2.4.10";
 
 // src/cli/args.ts
 var isNegativeNumber = (s) => /^-(\d|\.\d)/.test(s), isValue = (s) => !s.startsWith("-") || isNegativeNumber(s), parseArgv = (argv, booleans = new Set) => {
@@ -651,6 +651,94 @@ var init_peers = __esm(() => {
   ];
 });
 
+// src/hosts/releases.ts
+import { createHash } from "node:crypto";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, mkdtempSync, readFileSync as readFileSync3, renameSync, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { join as join4 } from "node:path";
+import { spawnSync } from "node:child_process";
+var MANIFEST_URL = "https://storage.yandexcloud.net/le-codes/releases/versions.json", ARTIFACT_STAMP = ".lecodes-artifact.json", cachedArtifactSha = (dir) => {
+  try {
+    return JSON.parse(readFileSync3(join4(dir, ARTIFACT_STAMP), "utf8")).sha256 ?? null;
+  } catch {
+    return null;
+  }
+}, macPlatformKey = () => process.arch === "arm64" ? "macos-arm64" : "macos-x64", semverNewer = (a, b) => {
+  const pa = a.split(/[.-]/).map(Number), pb = b.split(/[.-]/).map(Number);
+  for (let i = 0;i < 3; i++)
+    if ((pb[i] ?? 0) !== (pa[i] ?? 0))
+      return (pb[i] ?? 0) - (pa[i] ?? 0);
+  return 0;
+}, newestForPlatform = (versions, key) => {
+  const carrying = versions.filter((v) => v.files[key]).sort((a, b) => semverNewer(a.version, b.version));
+  const newest = carrying[0];
+  return newest ? { version: newest.version, file: newest.files[key] } : null;
+}, fetchReleaseProduct = async (product, label) => {
+  let manifest;
+  try {
+    const res = await fetch(MANIFEST_URL);
+    if (!res.ok)
+      throw new Error(`HTTP ${res.status}`);
+    manifest = await res.json();
+  } catch (e) {
+    throw new CliError(`Can't fetch the release manifest (${MANIFEST_URL}): ${e instanceof Error ? e.message : String(e)}`);
+  }
+  const entry = manifest.products?.[product];
+  if (!entry)
+    throw new CliError(`The release manifest has no ${label} product.`);
+  return entry;
+}, downloadReleaseArchive = async (file, opts) => {
+  let bytes;
+  try {
+    const res = await fetch(file.url);
+    if (!res.ok)
+      throw new Error(`HTTP ${res.status}`);
+    bytes = Buffer.from(await res.arrayBuffer());
+  } catch (e) {
+    throw new CliError(`Download failed (${file.url}): ${e instanceof Error ? e.message : String(e)}`);
+  }
+  const sha = createHash("sha256").update(bytes).digest("hex");
+  if (sha !== file.sha256)
+    throw new CliError(`Downloaded archive is corrupt (sha256 mismatch) — try again.`);
+  mkdirSync2(opts.cacheRoot, { recursive: true });
+  const stage = mkdtempSync(join4(opts.cacheRoot, "dl-"));
+  try {
+    const archiveName = file.url.split("/").pop() ?? "archive";
+    const archive = join4(stage, archiveName);
+    writeFileSync2(archive, bytes);
+    if (opts.extract) {
+      opts.extract(archive, stage);
+    } else {
+      const winTar = join4(process.env.SystemRoot ?? "C:\\Windows", "System32", "tar.exe");
+      const tarExe = process.platform === "win32" && existsSync4(winTar) ? winTar : "tar";
+      const tar = spawnSync(tarExe, ["-xf", archiveName], { cwd: stage, stdio: ["ignore", "ignore", "pipe"] });
+      if (tar.status !== 0)
+        throw new CliError(`Couldn't extract the archive: ${tar.stderr?.toString() ?? "tar failed"}`);
+    }
+    rmSync(archive);
+    const bad = opts.validate(stage);
+    if (bad)
+      throw new CliError(bad);
+    writeFileSync2(join4(stage, ARTIFACT_STAMP), JSON.stringify({ sha256: file.sha256, url: file.url }, null, 2));
+    try {
+      renameSync(stage, opts.dest);
+    } catch {
+      let destBad;
+      try {
+        destBad = opts.validate(opts.dest);
+      } catch {
+        destBad = "missing";
+      }
+      if (destBad)
+        throw new CliError(`Couldn't move the download into ${opts.dest}.`);
+    }
+  } finally {
+    rmSync(stage, { recursive: true, force: true });
+  }
+};
+var init_releases = __esm(() => {
+  init_cli();
+});
+
 // src/hosts/archives.ts
 var ARCHIVED_PEERS, BASE = "https://storage.yandexcloud.net/le-codes/releases/packages", packagesBase = () => (process.env.LECODES_PACKAGES_URL || BASE).replace(/\/$/, ""), archiveUrl = (name, version) => `${packagesBase()}/${name}/${name}-${version}.tgz`, numbers = (version) => version.split(/[.-]/).slice(0, 3).map(Number), byVersion = (a, b) => {
   const pa = numbers(a), pb = numbers(b);
@@ -699,17 +787,17 @@ var init_archives = __esm(() => {
 });
 
 // src/hosts/packageManager.ts
-import { spawnSync } from "node:child_process";
+import { spawnSync as spawnSync2 } from "node:child_process";
 import { homedir as homedir2 } from "node:os";
-import { join as join4, resolve as resolve2, sep } from "node:path";
+import { join as join5, resolve as resolve2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var onPath = (cmd) => {
   try {
-    return spawnSync(cmd, ["--version"], { stdio: "ignore", shell: process.platform === "win32" }).status === 0;
+    return spawnSync2(cmd, ["--version"], { stdio: "ignore", shell: process.platform === "win32" }).status === 0;
   } catch {
     return false;
   }
-}, bunGlobalDir = () => join4(process.env.BUN_INSTALL ? resolve2(process.env.BUN_INSTALL) : join4(homedir2(), ".bun"), "install", "global"), ownManager = (file = fileURLToPath2(import.meta.url)) => {
+}, bunGlobalDir = () => join5(process.env.BUN_INSTALL ? resolve2(process.env.BUN_INSTALL) : join5(homedir2(), ".bun"), "install", "global"), ownManager = (file = fileURLToPath2(import.meta.url)) => {
   const norm = (p) => process.platform === "win32" ? p.toLowerCase() : p;
   return norm(resolve2(file)).startsWith(norm(bunGlobalDir()) + sep) ? "bun" : "npm";
 }, pickManager = () => {
@@ -720,12 +808,16 @@ var onPath = (cmd) => {
 var init_packageManager = () => {};
 
 // src/hosts/peerInstall.ts
-import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join5 } from "node:path";
+import { spawnSync as spawnSync3 } from "node:child_process";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join6 } from "node:path";
 import { pathToFileURL } from "node:url";
 async function loadPeer(name, subpath, opts) {
   const spec = subpath ? `${name}/${subpath}` : name;
+  const byHand = peerVersionGlobal(name, spec);
+  if (olderThanCli(name, byHand)) {
+    throw new CliError(`${name} ${byHand} (installed by hand) is older than this CLI (${package_default.version}) needs — update it: ${commandLine(ownManager(), installGlobalArgv(ownManager(), [await peerSpec(name)]))}`);
+  }
   try {
     return await import(spec);
   } catch (e) {
@@ -733,18 +825,22 @@ async function loadPeer(name, subpath, opts) {
       throw e;
   }
   const dir = peerDirInPrefix(name);
-  if (!existsSync4(join5(dir, "package.json"))) {
+  const installed = peerVersionPrefix(name);
+  const stale = olderThanCli(name, installed);
+  if (installed === null || stale) {
     if (opts.install === false)
       return null;
-    if (peerVersionGlobal(name, spec) !== null)
+    if (installed === null && peerVersionGlobal(name, spec) !== null)
       throw new CliError(`${name} is installed but "${spec}" can't be loaded from it — reinstall it: ${commandLine(ownManager(), installGlobalArgv(ownManager(), [await peerSpec(name)]))}`);
+    if (stale)
+      note(`${name} ${installed} in ${peersDir()} is older than this CLI (${package_default.version}) — installing the one it needs`);
     await installPeers(companions(name), opts.for);
   }
   return await import(pathToFileURL(resolveEntry(dir, subpath)).href);
 }
 var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
   try {
-    return JSON.parse(readFileSync3(path, "utf8"));
+    return JSON.parse(readFileSync4(path, "utf8"));
   } catch {
     return null;
   }
@@ -753,7 +849,7 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
   if (archive)
     return archive;
   if (name === "@napi-rs/canvas") {
-    const renderer = readJson(join5(peerDirInPrefix("lecodes-headless"), "package.json"));
+    const renderer = readJson(join6(peerDirInPrefix("lecodes-headless"), "package.json"));
     const range = renderer?.peerDependencies?.["@napi-rs/canvas"] ?? renderer?.optionalDependencies?.["@napi-rs/canvas"] ?? CANVAS_RANGE_FALLBACK;
     return `@napi-rs/canvas@${range}`;
   }
@@ -761,10 +857,10 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
   return range ? `${name}@${range}` : `${name}@latest`;
 }, companions = (name) => name === "lecodes-headless" ? ["lecodes-headless", "@napi-rs/canvas"] : name === "sharp" ? ["sharp", "heic-decode"] : [name], manualCommand = (dir, specs) => commandLine(ownManager(), installIntoArgv(ownManager(), dir, specs)), installPeers = async (names, why, opts = {}) => {
   const dir = peersDir();
-  mkdirSync2(dir, { recursive: true });
-  const manifest = join5(dir, "package.json");
-  if (!existsSync4(manifest)) {
-    writeFileSync2(manifest, JSON.stringify({
+  mkdirSync3(dir, { recursive: true });
+  const manifest = join6(dir, "package.json");
+  if (!existsSync5(manifest)) {
+    writeFileSync3(manifest, JSON.stringify({
       name: "lecodes-peers",
       private: true,
       description: "Optional lecodes-cli peers, installed on first use. Safe to delete — the CLI re-installs what a command needs."
@@ -792,16 +888,16 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
     const spec = await peerSpec(name);
     const argv = installIntoArgv(tool, dir, [spec]);
     note(`$ ${tool} ${argv.join(" ")}`);
-    const r = spawnSync2(tool, argv, { stdio: "inherit", shell: process.platform === "win32", timeout: 10 * 60000 });
+    const r = spawnSync3(tool, argv, { stdio: "inherit", shell: process.platform === "win32", timeout: 10 * 60000 });
     if (r.error)
       throw new CliError(`${tool} could not run: ${r.error.message}`);
     if (r.status !== 0)
       throw new CliError(`${tool} exited with ${r.status ?? "a signal"} while installing ${spec}. By hand:  ${manualCommand(dir, [spec])}`);
-    if (!existsSync4(join5(peerDirInPrefix(name), "package.json")))
+    if (!existsSync5(join6(peerDirInPrefix(name), "package.json")))
       throw new CliError(`${name} did not land in ${dir} — the installer finished but the package is missing`);
   }
 }, resolveEntry = (pkgDir, subpath) => {
-  const manifest = readJson(join5(pkgDir, "package.json"));
+  const manifest = readJson(join6(pkgDir, "package.json"));
   if (!manifest)
     throw new CliError(`${pkgDir} holds no package.json`);
   const key = subpath ? `./${subpath}` : ".";
@@ -829,8 +925,8 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
     rel = typeof manifest.main === "string" ? manifest.main : "index.js";
   if (!rel)
     throw new CliError(`${manifest.name} has no export "${key}"`);
-  return join5(pkgDir, rel);
-}, isNotFound = (e, spec) => {
+  return join6(pkgDir, rel);
+}, SET_ON_NPM, olderThanCli = (name, version) => SET_ON_NPM.has(name) && version !== null && semverNewer(version, package_default.version) > 0, isNotFound = (e, spec) => {
   const code = e?.code;
   const msg = e instanceof Error ? e.message : String(e);
   return (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || /Cannot find (module|package)/i.test(msg)) && msg.includes(spec.split("/")[0]);
@@ -838,9 +934,11 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson = (path) => {
 var init_peerInstall = __esm(() => {
   init_package();
   init_peers();
+  init_releases();
   init_archives();
   init_packageManager();
   init_cli();
+  SET_ON_NPM = new Set(["lecodes-assets"]);
 });
 
 // ../../sdk/src/compile/resourceSlots.ts
@@ -2041,18 +2139,18 @@ var init_chisel = __esm(() => {
 });
 
 // ../../sdk/src/compile/bundler.ts
-import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync4, statSync } from "node:fs";
-import { spawnSync as spawnSync3 } from "node:child_process";
+import { existsSync as existsSync6, readdirSync, readFileSync as readFileSync5, statSync } from "node:fs";
+import { spawnSync as spawnSync4 } from "node:child_process";
 import { createRequire as createRequire3 } from "node:module";
-import { dirname as dirname4, join as join6, relative } from "node:path";
+import { dirname as dirname4, join as join7, relative } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var resolveInject = () => {
   const override = process.env.LECODES_SDK_INJECT;
-  if (override && existsSync5(override))
+  if (override && existsSync6(override))
     return override;
   const here = dirname4(fileURLToPath3(import.meta.url));
-  const src = join6(here, "..", "inject.ts");
-  if (existsSync5(src))
+  const src = join7(here, "..", "inject.ts");
+  if (existsSync6(src))
     return src;
   throw new Error("sdk: could not locate the inject source (LECODES_SDK_INJECT / src/inject.ts)");
 }, normalize2 = (path) => {
@@ -2068,7 +2166,7 @@ var resolveInject = () => {
   return "/" + parts.join("/");
 }, CHISEL_DEFINE, CHISEL_KEEP, CLIENT_INJECT = "/__sdk/inject.ts", SERVER_INJECT = "/__sdk/server/inject.ts", EDITOR_INJECT = "/__sdk/inject.editor.ts", readInjectSources = () => {
   const client = resolveInject();
-  return { client: readFileSync4(client, "utf8"), server: readFileSync4(join6(dirname4(client), "server", "inject.ts"), "utf8") };
+  return { client: readFileSync5(client, "utf8"), server: readFileSync5(join7(dirname4(client), "server", "inject.ts"), "utf8") };
 }, resolveSdkSrc = () => {
   const inject = resolveInject();
   if (!inject.endsWith("inject.ts")) {
@@ -2082,11 +2180,11 @@ var resolveInject = () => {
   const out = {};
   const walk = (dir) => {
     for (const name of readdirSync(dir)) {
-      const p = join6(dir, name);
+      const p = join7(dir, name);
       if (statSync(p).isDirectory())
         walk(p);
       else if (isSdkSource(p))
-        out["/__sdk/" + relative(sdkSrc, p).split("\\").join("/")] = readFileSync4(p, "utf8");
+        out["/__sdk/" + relative(sdkSrc, p).split("\\").join("/")] = readFileSync5(p, "utf8");
     }
   };
   walk(sdkSrc);
@@ -2095,13 +2193,13 @@ var resolveInject = () => {
 }, resolveChiselBin = () => {
   const override = process.env.LECODES_CHISEL_BIN;
   if (override) {
-    if (existsSync5(override))
+    if (existsSync6(override))
       return override;
     throw new Error(`LECODES_CHISEL_BIN points at a missing file: ${override}`);
   }
   try {
     const bin = createRequire3(import.meta.url)("@letary/chisel").binaryPath();
-    if (bin && existsSync5(bin))
+    if (bin && existsSync6(bin))
       return bin;
   } catch {}
   throw new Error("chisel binary not found. Install @letary/chisel, or set LECODES_CHISEL_BIN.");
@@ -2113,7 +2211,7 @@ var resolveInject = () => {
     return null;
   }
   const input = JSON.stringify({ scan: true, files });
-  const r = spawnSync3(bin, [], { input, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
+  const r = spawnSync4(bin, [], { input, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
   if (r.status !== 0 || r.error)
     return null;
   try {
@@ -2243,7 +2341,7 @@ var resolveInject = () => {
     vocab: chiselVocab
   });
   const bin = resolveChiselBin();
-  const r = spawnSync3(bin, [], { input, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
+  const r = spawnSync4(bin, [], { input, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
   if (r.status === 2 || r.error) {
     throw new Error(`chisel failed: ${r.error?.message ?? r.stderr ?? "unknown error"}`);
   }
@@ -172350,15 +172448,15 @@ var init_compile = __esm(() => {
 });
 
 // src/compile/projectCompile.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
 import { createRequire as createRequire4 } from "node:module";
-import { dirname as dirname6, join as join7 } from "node:path";
+import { dirname as dirname6, join as join8 } from "node:path";
 var resolveSdkInject = () => {
   try {
     return createRequire4(import.meta.url).resolve("lecodes-sdk/inject");
   } catch {}
-  const vendored = join7(distRoot, "runtime", "sdk", "inject.ts");
-  return existsSync6(vendored) ? vendored : null;
+  const vendored = join8(distRoot, "runtime", "sdk", "inject.ts");
+  return existsSync7(vendored) ? vendored : null;
 }, sdkInject, sdkSourceDir, resolveChiselBin2 = () => {
   if (process.env.LECODES_CHISEL_BIN)
     return process.env.LECODES_CHISEL_BIN;
@@ -172367,8 +172465,8 @@ var resolveSdkInject = () => {
     if (fromPkg)
       return fromPkg;
   } catch {}
-  const local = join7(dirname6(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel");
-  return existsSync6(local) ? local : null;
+  const local = join8(dirname6(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel");
+  return existsSync7(local) ? local : null;
 }, chiselBin, ambiguousEntryWarning = (entries) => {
   const { entry, roots } = detectEntry(entries, scanModulesChisel);
   if (!entry || roots.length < 2 || roots.includes(ENTRY_CONVENTION))
@@ -172381,7 +172479,7 @@ var resolveSdkInject = () => {
     if (e?.text !== undefined)
       return e.text;
     try {
-      return e?.absPath ? readFileSync5(e.absPath, "utf8") : null;
+      return e?.absPath ? readFileSync6(e.absPath, "utf8") : null;
     } catch {
       return null;
     }
@@ -172417,15 +172515,15 @@ ${inlineSourceMapComment(map)}` : code, bakes };
   };
   const dir = peerDirInPrefix("typescript");
   const peer = () => {
-    if (!existsSync6(join7(dir, "package.json")))
+    if (!existsSync7(join8(dir, "package.json")))
       return null;
     try {
-      return api(createRequire4(import.meta.url)(join7(dir, "lib", "typescript.js")));
+      return api(createRequire4(import.meta.url)(join8(dir, "lib", "typescript.js")));
     } catch {
       return null;
     }
   };
-  const found = from(join7(root, "package.json")) ?? from(import.meta.url) ?? peer();
+  const found = from(join8(root, "package.json")) ?? from(import.meta.url) ?? peer();
   if (found)
     return found;
   await installPeers(["typescript"], "The project's server code (*.server.ts)");
@@ -172610,8 +172708,8 @@ var init_assetName = __esm(() => {
 });
 
 // src/project/paths.ts
-import { createHash } from "node:crypto";
-var sha256 = (data) => createHash("sha256").update(data).digest("hex"), toKey = (path) => {
+import { createHash as createHash2 } from "node:crypto";
+var sha256 = (data) => createHash2("sha256").update(data).digest("hex"), toKey = (path) => {
   const parts = path.replace(/\\/g, "/").split("/").map((p) => p.trim()).filter((p) => p && p !== ".");
   if (parts.some((p) => p === ".."))
     throw new CliError(`Unsafe path: ${path}`);
@@ -172626,8 +172724,8 @@ var init_paths = __esm(() => {
 });
 
 // src/project/ignore.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join11 } from "node:path";
 var BUILTIN_PATTERNS, DEFAULT_IGNORE_FILE = `# Files matched here are NOT pushed to LeCodes.
 # Only untracked files are affected — assets already in the project stay tracked
 # even if they match a pattern. Built-in defaults (node_modules, _*, *.log, .artifacts)
@@ -172708,18 +172806,18 @@ design/comments/
   return (path) => match(path.startsWith("/") ? path : "/" + path, false);
 }, loadIgnore = (root) => {
   const lines = [...BUILTIN_PATTERNS];
-  const file = join10(root, ".lecodesignore");
-  if (existsSync9(file)) {
+  const file = join11(root, ".lecodesignore");
+  if (existsSync10(file)) {
     try {
-      lines.push(...readFileSync8(file, "utf8").split(/\r?\n/));
+      lines.push(...readFileSync9(file, "utf8").split(/\r?\n/));
     } catch {}
   }
   const rules = lines.map(compile).filter((r) => r !== null);
   return buildMatcher(rules);
 }, writeDefaultIgnore = (root) => {
-  const file = join10(root, ".lecodesignore");
-  if (!existsSync9(file))
-    writeFileSync3(file, DEFAULT_IGNORE_FILE);
+  const file = join11(root, ".lecodesignore");
+  if (!existsSync10(file))
+    writeFileSync4(file, DEFAULT_IGNORE_FILE);
 }, DEFAULT_GITIGNORE = `# LeCodes per-checkout state: generated IDE types + this machine's sync cursor
 # (.lecodes/manifest.json). Regenerate with \`lecodes update\` / re-attach with \`lecodes link\`.
 .lecodes/
@@ -172734,19 +172832,19 @@ node_modules/
 
 dist/
 `, ensureGitignore = (root) => {
-  const file = join10(root, ".gitignore");
-  if (!existsSync9(file)) {
-    writeFileSync3(file, DEFAULT_GITIGNORE);
+  const file = join11(root, ".gitignore");
+  if (!existsSync10(file)) {
+    writeFileSync4(file, DEFAULT_GITIGNORE);
     return "created";
   }
-  const text = readFileSync8(file, "utf8");
+  const text = readFileSync9(file, "utf8");
   const covered = text.split(/\r?\n/).some((l) => /^\/?\.lecodes\/?\s*$/.test(l.trim()));
   if (covered)
     return null;
   const sep = text.length === 0 || text.endsWith(`
 `) ? "" : `
 `;
-  writeFileSync3(file, `${text}${sep}
+  writeFileSync4(file, `${text}${sep}
 # LeCodes per-checkout state (generated types + sync cursor) — not source
 .lecodes/
 `);
@@ -172757,8 +172855,8 @@ var init_ignore = __esm(() => {
 });
 
 // src/project/localFiles.ts
-import { existsSync as existsSync10, readdirSync as readdirSync3, readFileSync as readFileSync9 } from "node:fs";
-import { basename, dirname as dirname7, join as join11, relative as relative3 } from "node:path";
+import { existsSync as existsSync11, readdirSync as readdirSync3, readFileSync as readFileSync10 } from "node:fs";
+import { basename, dirname as dirname7, join as join12, relative as relative3 } from "node:path";
 var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
   const i = name.lastIndexOf(".");
   return i < 0 ? "" : name.slice(i + 1).toLowerCase();
@@ -172776,14 +172874,14 @@ var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
       continue;
     let folder;
     try {
-      folder = JSON.parse(readFileSync9(file.absPath, "utf8").replace(/^\uFEFF/, "")).web?.static;
+      folder = JSON.parse(readFileSync10(file.absPath, "utf8").replace(/^\uFEFF/, "")).web?.static;
     } catch {
       continue;
     }
     if (typeof folder !== "string" || folder.trim() === "")
       continue;
     try {
-      folders.push(toKey(relative3(root, join11(dirname7(file.absPath), folder))) + "/");
+      folders.push(toKey(relative3(root, join12(dirname7(file.absPath), folder))) + "/");
     } catch {}
   }
   return folders;
@@ -172804,7 +172902,7 @@ var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
   };
   const walk = (dir, parentIgnored) => {
     for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-      const abs = join11(dir, entry.name);
+      const abs = join12(dir, entry.name);
       const key = toKey(relative3(root, abs));
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name))
@@ -172824,7 +172922,7 @@ var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
           ignored.push(key);
           continue;
         }
-        found.push({ path: key, absPath: abs, sha: sha256(readFileSync9(abs)) });
+        found.push({ path: key, absPath: abs, sha: sha256(readFileSync10(abs)) });
       }
     }
   };
@@ -172836,8 +172934,8 @@ var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
   }));
   return { files, dirs, ignored };
 }, resolveLocalPath = (root, key) => {
-  const direct = join11(root, key.slice(1));
-  if (existsSync10(direct))
+  const direct = join12(root, key.slice(1));
+  if (existsSync11(direct))
     return direct;
   let dir = root;
   try {
@@ -172845,7 +172943,7 @@ var SKIP_DIRS, SKIP_FILES, TEXT_EXTS, ext = (name) => {
       const match = readdirSync3(dir).find((entry) => entry === name || sanitizeAssetName2(entry) === name);
       if (!match)
         return null;
-      dir = join11(dir, match);
+      dir = join12(dir, match);
     }
   } catch {
     return null;
@@ -172904,9 +173002,9 @@ var init_localFiles = __esm(() => {
 });
 
 // src/compile/fonts.ts
-import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync11, mkdirSync as mkdirSync4, readFileSync as readFileSync12, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname9, join as join13 } from "node:path";
+import { createHash as createHash3 } from "node:crypto";
+import { existsSync as existsSync12, mkdirSync as mkdirSync5, readFileSync as readFileSync13, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname9, join as join14 } from "node:path";
 var applyProjectFonts = async (entries, opts) => {
   const registry = (opts.registry ?? fontRegistryBase()).replace(/\/+$/, "");
   const byPath = () => new Map(entries.map((e) => [e.path.replace(/^\//, ""), e]));
@@ -172915,9 +173013,9 @@ var applyProjectFonts = async (entries, opts) => {
     registryBase: registry,
     readBytes: (entryPath) => {
       const entry = byPath().get(entryPath);
-      const abs = entry?.absPath ?? join13(opts.root, entryPath);
+      const abs = entry?.absPath ?? join14(opts.root, entryPath);
       try {
-        return new Uint8Array(readFileSync12(abs));
+        return new Uint8Array(readFileSync13(abs));
       } catch {
         return null;
       }
@@ -172925,9 +173023,9 @@ var applyProjectFonts = async (entries, opts) => {
     vendorFace: opts.mode === "vendor" ? async (face) => {
       const vendorDir = opts.vendorDir ?? opts.root;
       const rel = `assets/fonts/${face.fileName}`;
-      const abs = join13(vendorDir, rel);
+      const abs = join14(vendorDir, rel);
       const entryPath = `${opts.vendorPrefix ?? ""}/${rel}`;
-      if (!existsSync11(abs))
+      if (!existsSync12(abs))
         await downloadFace(registry, vendorDir, face, rel, abs);
       if (!byPath().has(entryPath.replace(/^\//, ""))) {
         entries.push(opts.makeResourceEntry?.(entryPath, abs) ?? { path: entryPath, type: "resource", absPath: abs });
@@ -172943,19 +173041,19 @@ var applyProjectFonts = async (entries, opts) => {
     const fileSrc = byPath().get(path.replace(/^\//, ""))?.fileSrc;
     return fileSrc ? (opts.publicUrl ?? "") + fileSrc : null;
   }) || undefined;
-}, isHttp = (s) => /^https?:/i.test(s), sha12 = (b) => createHash2("sha256").update(b).digest("hex").slice(0, 12), registryHome = (registry) => registry.replace(/\/v\d+$/, ""), readRegistry = async (registry, rel) => {
+}, isHttp = (s) => /^https?:/i.test(s), sha12 = (b) => createHash3("sha256").update(b).digest("hex").slice(0, 12), registryHome = (registry) => registry.replace(/\/v\d+$/, ""), readRegistry = async (registry, rel) => {
   if (isHttp(registry)) {
     const res = await fetch(`${registry}/${rel}`);
     return res.ok ? new Uint8Array(await res.arrayBuffer()) : null;
   }
   try {
-    return new Uint8Array(readFileSync12(join13(registry, rel)));
+    return new Uint8Array(readFileSync13(join14(registry, rel)));
   } catch {
     return null;
   }
 }, readLock = (path) => {
   try {
-    const lock = JSON.parse(readFileSync12(path, "utf8"));
+    const lock = JSON.parse(readFileSync13(path, "utf8"));
     if (lock && typeof lock === "object" && lock.faces && lock.families)
       return lock;
   } catch {}
@@ -172987,10 +173085,10 @@ var applyProjectFonts = async (entries, opts) => {
 `);
 }, writeIfChanged = (path, text) => {
   try {
-    if (readFileSync12(path, "utf8") === text)
+    if (readFileSync13(path, "utf8") === text)
       return;
   } catch {}
-  writeFileSync5(path, text);
+  writeFileSync6(path, text);
 }, downloadFace = async (registry, vendorDir, face, rel, abs) => {
   const licRaw = await readRegistry(registry, "licenses.json");
   if (!licRaw)
@@ -173002,15 +173100,15 @@ var applyProjectFonts = async (entries, opts) => {
   const bytes = await readRegistry(registry, `${face.id}/${face.fileName}`);
   if (!bytes)
     throw new Error(`font("${face.id}"): face "${face.fileName}" not found in the registry (${registryHome(registry)}).`);
-  mkdirSync4(dirname9(abs), { recursive: true });
-  writeFileSync5(abs, bytes);
-  const lockPath = join13(vendorDir, "fonts.lock.json");
+  mkdirSync5(dirname9(abs), { recursive: true });
+  writeFileSync6(abs, bytes);
+  const lockPath = join14(vendorDir, "fonts.lock.json");
   const lock = readLock(lockPath) ?? { registry, faces: {}, families: {} };
   lock.registry = registry;
   lock.faces[`${face.id}@${face.weight}${face.italic ? "i" : ""}`] = { id: face.id, family: face.family, weight: face.weight, italic: face.italic, hash: sha12(bytes), spdx: lic.spdx, path: rel };
   lock.families[face.id] = lic;
   writeIfChanged(lockPath, serializeLock(lock));
-  writeIfChanged(join13(vendorDir, "FONT-NOTICES.md"), renderNotices(lock));
+  writeIfChanged(join14(vendorDir, "FONT-NOTICES.md"), renderNotices(lock));
 };
 var init_fonts = __esm(() => {
   init_compile();
@@ -227346,27 +227444,27 @@ import { homedir as homedir10 } from "node:os";
 import { basename as basename10, dirname as dirname17, join as join27, resolve as resolve14 } from "node:path";
 
 // src/plugin/manifest.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, statSync as statSync2 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join9 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync8, statSync as statSync2 } from "node:fs";
+import { isAbsolute as isAbsolute2, join as join10 } from "node:path";
 
 // src/plugin/firstParty.ts
 init_projectCompile();
-import { existsSync as existsSync7, readFileSync as readFileSync6, readdirSync as readdirSync2 } from "node:fs";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync7, readdirSync as readdirSync2 } from "node:fs";
+import { join as join9 } from "node:path";
 var ID = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 var firstPartyContractFile = (id) => {
   if (!sdkSourceDir || !ID.test(id))
     return null;
-  const file = join8(sdkSourceDir, "plugins", "gen", id, "contract.d.ts");
-  return existsSync7(file) ? file : null;
+  const file = join9(sdkSourceDir, "plugins", "gen", id, "contract.d.ts");
+  return existsSync8(file) ? file : null;
 };
 var firstPartyIds = () => {
   if (!sdkSourceDir)
     return [];
-  const gen = join8(sdkSourceDir, "plugins", "gen");
-  return existsSync7(gen) ? readdirSync2(gen).filter((id) => existsSync7(join8(gen, id, "contract.d.ts"))).sort() : [];
+  const gen = join9(sdkSourceDir, "plugins", "gen");
+  return existsSync8(gen) ? readdirSync2(gen).filter((id) => existsSync8(join9(gen, id, "contract.d.ts"))).sort() : [];
 };
-var firstPartyContractText = (file) => readFileSync6(file, "utf8").replace(/from "(?:\.\.\/)+plugin"/g, `from "lecodes-sdk/plugin"`);
+var firstPartyContractText = (file) => readFileSync7(file, "utf8").replace(/from "(?:\.\.\/)+plugin"/g, `from "lecodes-sdk/plugin"`);
 
 // src/plugin/manifest.ts
 var MANIFEST_FILE = "lecodes-plugin.json";
@@ -227399,15 +227497,15 @@ var BRANCH = {
   web: new Set(["register", "dependencies", "resources", "static"])
 };
 var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var isFolder = (path) => existsSync8(path) && statSync2(path).isDirectory();
+var isFolder = (path) => existsSync9(path) && statSync2(path).isDirectory();
 var pascal = (id) => id.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
 var XCFRAMEWORK = ".xcframework";
 var binaryName = (path) => path.split(/[\\/]/).pop().slice(0, -XCFRAMEWORK.length);
 var readManifest3 = (dir, id) => {
-  const file = join9(dir, MANIFEST_FILE);
+  const file = join10(dir, MANIFEST_FILE);
   let raw;
   try {
-    raw = JSON.parse(readFileSync7(file, "utf8").replace(/^/, ""));
+    raw = JSON.parse(readFileSync8(file, "utf8").replace(/^/, ""));
   } catch (e) {
     throw new ManifestError(file, [`not JSON: ${e instanceof Error ? e.message : String(e)}`]);
   }
@@ -227446,14 +227544,14 @@ var readManifest3 = (dir, id) => {
       problems.push(`implements: the id of the first-party plugin whose contract the folder implements ("ar")`);
     else if (!firstPartyContractFile(impl))
       problems.push(`implements: "${impl}" is no first-party plugin of this SDK (${firstPartyIds().join(", ") || "it carries none"})`);
-    if (existsSync8(join9(dir, CONTRACT_FILE)))
+    if (existsSync9(join10(dir, CONTRACT_FILE)))
       problems.push(`implements: the folder implements another plugin's contract — it has no ${CONTRACT_FILE} of its own`);
-    if (isFolder(join9(dir, "sdk")))
+    if (isFolder(join10(dir, "sdk")))
       problems.push("implements: the folder implements another plugin — its app side is the SDK's, it has no sdk/ of its own");
   }
   for (const platform of PLATFORMS) {
     const branch = raw[platform];
-    const folder = isFolder(join9(dir, platform));
+    const folder = isFolder(join10(dir, platform));
     if (branch === undefined) {
       problems.push(`${platform}: missing — an object, or null where the plugin has no ${platform} half`);
       continue;
@@ -227484,7 +227582,7 @@ var readManifest3 = (dir, id) => {
     if (platform === "web" && register !== undefined) {
       if (!register.startsWith("web/"))
         problems.push(`web.register: "${register}" — a module of the web/ folder`);
-      else if (!existsSync8(join9(dir, register)))
+      else if (!existsSync9(join10(dir, register)))
         problems.push(`web.register: ${register} is not there`);
     }
   }
@@ -227524,7 +227622,7 @@ var readManifest3 = (dir, id) => {
             problems.push(`ios.binaries[${i}]: ${path} is in ios/, the half's sources — a binary stands beside them ("binaries/ios/X.xcframework")`);
           else if (!/^[A-Za-z_]\w*$/.test(binaryName(path)))
             problems.push(`ios.binaries[${i}]: "${path}" — the folder's name is its binary target's: a Swift name before ${XCFRAMEWORK}`);
-          else if (!isFolder(join9(dir, path)))
+          else if (!isFolder(join10(dir, path)))
             problems.push(`ios.binaries[${i}]: ${path} is not a folder of the plugin`);
           else if (named.has(binaryName(path)))
             problems.push(`ios.binaries[${i}]: ${path} is named "${binaryName(path)}" like ${named.get(binaryName(path))} — a name is one binary target`);
@@ -227565,7 +227663,7 @@ var readManifest3 = (dir, id) => {
       const segments = typeof folder === "string" ? folder.split(/[\\/]/) : [];
       if (typeof folder !== "string" || folder.trim() === "" || isAbsolute2(folder) || segments.some((s) => s === ".." || s === "." || s === "")) {
         problems.push(`web.static: a folder of the plugin, by its path in it ("xr-runtime")`);
-      } else if (!isFolder(join9(dir, folder)))
+      } else if (!isFolder(join10(dir, folder)))
         problems.push(`web.static: ${folder} is not a folder of the plugin`);
       else if (folder === "index.js")
         problems.push(`web.static: "index.js" is the built module's name`);
@@ -227575,7 +227673,7 @@ var readManifest3 = (dir, id) => {
     throw new ManifestError(file, problems);
   return raw;
 };
-var readManifestIfAny = (dir, id) => existsSync8(join9(dir, MANIFEST_FILE)) ? readManifest3(dir, id) : null;
+var readManifestIfAny = (dir, id) => existsSync9(join10(dir, MANIFEST_FILE)) ? readManifest3(dir, id) : null;
 
 // src/commands/compile.ts
 init_api();
@@ -227586,15 +227684,15 @@ import { basename as basename6, resolve as resolve6 } from "node:path";
 // src/compile/collect.ts
 init_localFiles();
 init_ignore();
-import { readFileSync as readFileSync10 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 
 // src/project/materialize.ts
 init_api();
 init_paths();
-import { dirname as dirname8, join as join12 } from "node:path";
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname8, join as join13 } from "node:path";
+import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "node:fs";
 var kindOf = (type) => type === "file" ? "resource" : type;
-var absOf = (root, key) => join12(root, ...key.replace(/^\//, "").split("/"));
+var absOf = (root, key) => join13(root, ...key.replace(/^\//, "").split("/"));
 var buildPaths = (assets) => {
   const pathById = new Map;
   for (const asset of assets) {
@@ -227612,20 +227710,20 @@ var materializeAssets = async (root, project, apiUrl, token, onProgress) => {
     const key = pathById.get(asset.id);
     const abs = absOf(root, key);
     if (asset.type === "folder") {
-      mkdirSync3(abs, { recursive: true });
+      mkdirSync4(abs, { recursive: true });
       continue;
     }
-    mkdirSync3(dirname8(abs), { recursive: true });
+    mkdirSync4(dirname8(abs), { recursive: true });
     let sha;
     if (asset.type === "file") {
       if (!asset.file?.src)
         continue;
       const bytes = await downloadBlob(apiUrl, asset.file.src);
-      writeFileSync4(abs, bytes);
+      writeFileSync5(abs, bytes);
       sha = sha256(bytes);
     } else {
       const text = asset.text ?? "";
-      writeFileSync4(abs, text);
+      writeFileSync5(abs, text);
       sha = sha256(text);
     }
     files[key] = { id: asset.id, type: kindOf(asset.type), sha };
@@ -227659,7 +227757,7 @@ var collectEntries = (root, manifest, project, opts = {}) => {
         warnings.push(`No compiled shader for ${file.path} — push it to compile the shader.`);
       entries.push({ path: file.path, type, shaders, absPath: file.absPath });
     } else {
-      entries.push({ path: file.path, type, text: readFileSync10(file.absPath, "utf8") });
+      entries.push({ path: file.path, type, text: readFileSync11(file.absPath, "utf8") });
     }
   }
   return { entries, warnings };
@@ -227668,11 +227766,11 @@ var collectEntries = (root, manifest, project, opts = {}) => {
 // src/compile/collectLocal.ts
 init_localFiles();
 init_ignore();
-import { readFileSync as readFileSync11 } from "node:fs";
+import { readFileSync as readFileSync12 } from "node:fs";
 import { basename as basename2 } from "node:path";
 var isHalfManifest = (abs) => {
   try {
-    return typeof JSON.parse(readFileSync11(abs, "utf8").replace(/^/, "")).implements === "string";
+    return typeof JSON.parse(readFileSync12(abs, "utf8").replace(/^/, "")).implements === "string";
   } catch {
     return false;
   }
@@ -227694,7 +227792,7 @@ var collectLocalEntries = (root, manifest, assetBase, opts = {}) => {
       }
       entries.push({ path: file.path, type, shaders: [], absPath: file.absPath });
     } else {
-      entries.push({ path: file.path, type, text: readFileSync11(file.absPath, "utf8") });
+      entries.push({ path: file.path, type, text: readFileSync12(file.absPath, "utf8") });
     }
   }
   return { entries, warnings };
@@ -227713,105 +227811,11 @@ import { tmpdir } from "node:os";
 import { basename as basename3, join as join16 } from "node:path";
 
 // src/hosts/matcTool.ts
+init_releases();
+init_cli();
 import { existsSync as existsSync13, readdirSync as readdirSync4 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join15, resolve as resolve4 } from "node:path";
-
-// src/hosts/releases.ts
-init_cli();
-import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync12, mkdirSync as mkdirSync5, mkdtempSync, readFileSync as readFileSync13, renameSync, rmSync, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join14 } from "node:path";
-import { spawnSync as spawnSync4 } from "node:child_process";
-var MANIFEST_URL = "https://storage.yandexcloud.net/le-codes/releases/versions.json";
-var ARTIFACT_STAMP = ".lecodes-artifact.json";
-var cachedArtifactSha = (dir) => {
-  try {
-    return JSON.parse(readFileSync13(join14(dir, ARTIFACT_STAMP), "utf8")).sha256 ?? null;
-  } catch {
-    return null;
-  }
-};
-var macPlatformKey = () => process.arch === "arm64" ? "macos-arm64" : "macos-x64";
-var semverNewer = (a, b) => {
-  const pa = a.split(/[.-]/).map(Number), pb = b.split(/[.-]/).map(Number);
-  for (let i = 0;i < 3; i++)
-    if ((pb[i] ?? 0) !== (pa[i] ?? 0))
-      return (pb[i] ?? 0) - (pa[i] ?? 0);
-  return 0;
-};
-var newestForPlatform = (versions, key) => {
-  const carrying = versions.filter((v) => v.files[key]).sort((a, b) => semverNewer(a.version, b.version));
-  const newest = carrying[0];
-  return newest ? { version: newest.version, file: newest.files[key] } : null;
-};
-var fetchReleaseProduct = async (product, label) => {
-  let manifest;
-  try {
-    const res = await fetch(MANIFEST_URL);
-    if (!res.ok)
-      throw new Error(`HTTP ${res.status}`);
-    manifest = await res.json();
-  } catch (e) {
-    throw new CliError(`Can't fetch the release manifest (${MANIFEST_URL}): ${e instanceof Error ? e.message : String(e)}`);
-  }
-  const entry = manifest.products?.[product];
-  if (!entry)
-    throw new CliError(`The release manifest has no ${label} product.`);
-  return entry;
-};
-var downloadReleaseArchive = async (file, opts) => {
-  let bytes;
-  try {
-    const res = await fetch(file.url);
-    if (!res.ok)
-      throw new Error(`HTTP ${res.status}`);
-    bytes = Buffer.from(await res.arrayBuffer());
-  } catch (e) {
-    throw new CliError(`Download failed (${file.url}): ${e instanceof Error ? e.message : String(e)}`);
-  }
-  const sha = createHash3("sha256").update(bytes).digest("hex");
-  if (sha !== file.sha256)
-    throw new CliError(`Downloaded archive is corrupt (sha256 mismatch) — try again.`);
-  mkdirSync5(opts.cacheRoot, { recursive: true });
-  const stage = mkdtempSync(join14(opts.cacheRoot, "dl-"));
-  try {
-    const archiveName = file.url.split("/").pop() ?? "archive";
-    const archive = join14(stage, archiveName);
-    writeFileSync6(archive, bytes);
-    if (opts.extract) {
-      opts.extract(archive, stage);
-    } else {
-      const winTar = join14(process.env.SystemRoot ?? "C:\\Windows", "System32", "tar.exe");
-      const tarExe = process.platform === "win32" && existsSync12(winTar) ? winTar : "tar";
-      const tar = spawnSync4(tarExe, ["-xf", archiveName], { cwd: stage, stdio: ["ignore", "ignore", "pipe"] });
-      if (tar.status !== 0)
-        throw new CliError(`Couldn't extract the archive: ${tar.stderr?.toString() ?? "tar failed"}`);
-    }
-    rmSync(archive);
-    const bad = opts.validate(stage);
-    if (bad)
-      throw new CliError(bad);
-    writeFileSync6(join14(stage, ARTIFACT_STAMP), JSON.stringify({ sha256: file.sha256, url: file.url }, null, 2));
-    try {
-      renameSync(stage, opts.dest);
-    } catch {
-      let destBad;
-      try {
-        destBad = opts.validate(opts.dest);
-      } catch {
-        destBad = "missing";
-      }
-      if (destBad)
-        throw new CliError(`Couldn't move the download into ${opts.dest}.`);
-    }
-  } finally {
-    rmSync(stage, { recursive: true, force: true });
-  }
-};
-
-// src/hosts/matcTool.ts
-init_cli();
 var matcName = () => process.platform === "win32" ? "matc.exe" : "matc";
 var platformKey = () => {
   if (process.platform === "win32")
@@ -232591,11 +232595,12 @@ import { cpSync as cpSync3, existsSync as existsSync24, mkdirSync as mkdirSync15
 import { basename as basename9, dirname as dirname16, join as join26, resolve as resolve13 } from "node:path";
 
 // src/hosts/desktopRenderer.ts
+init_releases();
+init_cli();
 import { execFileSync as execFileSync3, spawn as spawn2, spawnSync as spawnSync6 } from "node:child_process";
 import { copyFileSync, existsSync as existsSync22, mkdirSync as mkdirSync13, mkdtempSync as mkdtempSync2, readdirSync as readdirSync7, readFileSync as readFileSync23, rmSync as rmSync5, statSync as statSync6, writeFileSync as writeFileSync16, linkSync } from "node:fs";
 import { homedir as homedir9, tmpdir as tmpdir2 } from "node:os";
 import { delimiter, join as join24, resolve as resolve11 } from "node:path";
-init_cli();
 
 // ../../renderers/web-shared/src/sourcemapError.ts
 var B64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
@@ -234694,10 +234699,11 @@ var app_default = defineCommand({
 init_cli();
 
 // src/hosts/cmgenTool.ts
+init_releases();
+init_cli();
 import { existsSync as existsSync26, readdirSync as readdirSync11 } from "node:fs";
 import { homedir as homedir11 } from "node:os";
 import { join as join28, resolve as resolve15 } from "node:path";
-init_cli();
 var exeName2 = () => process.platform === "win32" ? "cmgen.exe" : "cmgen";
 var platformKey3 = () => {
   if (process.platform === "win32")
@@ -237697,6 +237703,9 @@ var unwrapReferenced = async (js, resources, root, texel) => {
   }
   note(`Unwrapping ${raw.length} of the ${glbs.length} GLB(s) the app references — no lightmap uvs; written in place (--no-unwrap skips)…`);
   const assets = await loadPeer("lecodes-assets", "cli", { for: "lecodes lightmap bake (lightmap uvs)" });
+  if (typeof assets.unwrapGlbFiles !== "function") {
+    throw new CliError("The lecodes-assets this CLI loaded has no unwrapGlbFiles (it predates the bake's unwrap) — `lecodes update` moves it forward; --no-unwrap bakes the GLBs as they are.");
+  }
   const t0 = performance.now();
   const rel = (f) => relative7(root, f).replace(/\\/g, "/");
   const reports = await assets.unwrapGlbFiles(raw, {
@@ -244756,6 +244765,7 @@ var serve_default = defineCommand({
 // src/commands/shaders/index.ts
 import { readFileSync as readFileSync46 } from "node:fs";
 import { relative as relative13 } from "node:path";
+init_releases();
 init_cli();
 init_shared();