lecodes-cli 0.19.0 → 0.20.0

package/dist/index.js

@@ -389,7 +389,7 @@ design/comments/
   if (!existsSync2(file))
     writeFileSync3(file, DEFAULT_IGNORE_FILE);
 }, DEFAULT_GITIGNORE = `# LeCodes per-checkout state: generated IDE types + this machine's sync cursor
-# (.lecodes/manifest.json). Regenerate with \`lecodes types\` / re-attach with \`lecodes link\`.
+# (.lecodes/manifest.json). Regenerate with \`lecodes update\` / re-attach with \`lecodes link\`.
 .lecodes/
 
 # Render / preview outputs and test failure frames
@@ -3177,7 +3177,7 @@ var require_source_map_support = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/typescript@5.8.3/node_modules/typescript/lib/typescript.js
 var require_typescript = __commonJS((exports, module) => {
-  var __dirname = "C:\\Users\\Den\\Desktop\\LeCodes\\lecodes\\node_modules\\.bun\\typescript@5.8.3\\node_modules\\typescript\\lib", __filename = "C:\\Users\\Den\\Desktop\\LeCodes\\lecodes\\node_modules\\.bun\\typescript@5.8.3\\node_modules\\typescript\\lib\\typescript.js";
+  var __dirname = "/Users/den/Desktop/Ingenuity/le-codes/node_modules/.bun/typescript@5.8.3/node_modules/typescript/lib", __filename = "/Users/den/Desktop/Ingenuity/le-codes/node_modules/.bun/typescript@5.8.3/node_modules/typescript/lib/typescript.js";
   /*! *****************************************************************************
   Copyright (c) Microsoft Corporation. All rights reserved.
   Licensed under the Apache License, Version 2.0 (the "License"); you may not use
@@ -171654,10 +171654,7 @@ var init_detectEntry = __esm(() => {
 });
 
 // ../sdk/src/compile/shaderTargets.ts
-var externalSamplerReg, PLATFORM_BUILD, LOCAL_PLATFORM_BUILD, ALL_PLATFORM_BUILD, LOCAL_ONLY_PLATFORMS, TARGET_MATRIX_GENERATION = 1, matcPlatformsFor = (text) => {
-  externalSamplerReg.lastIndex = 0;
-  return externalSamplerReg.test(text) ? ["opengl", "metal", "webgl", "desktop"] : ["opengl", "metal", "desktop"];
-}, matcArgs = (platform, outPath, inPath) => {
+var externalSamplerReg, PLATFORM_BUILD, LOCAL_PLATFORM_BUILD, ALL_PLATFORM_BUILD, LOCAL_ONLY_PLATFORMS, TARGET_MATRIX_GENERATION = 1, MATC_PLATFORMS, matcArgs = (platform, outPath, inPath) => {
   const build = ALL_PLATFORM_BUILD[platform];
   return ["-p", build.profile, "--no-essl1", "-a", build.api, "-o", outPath, inPath];
 };
@@ -171666,7 +171663,6 @@ var init_shaderTargets = __esm(() => {
   PLATFORM_BUILD = {
     opengl: { profile: "mobile", api: "opengl", replaceExternal: false },
     metal: { profile: "mobile", api: "metal", replaceExternal: false },
-    webgl: { profile: "mobile", api: "opengl", replaceExternal: true },
     desktop: { profile: "desktop", api: "opengl", replaceExternal: true }
   };
   LOCAL_PLATFORM_BUILD = {
@@ -171674,6 +171670,7 @@ var init_shaderTargets = __esm(() => {
   };
   ALL_PLATFORM_BUILD = { ...PLATFORM_BUILD, ...LOCAL_PLATFORM_BUILD };
   LOCAL_ONLY_PLATFORMS = ["desktop-vulkan"];
+  MATC_PLATFORMS = ["opengl", "metal", "desktop"];
 });
 
 // ../sdk/src/compile/liteMaterial.ts
@@ -172189,8 +172186,6 @@ var compileProject = async (opts) => {
         const name = shaders[0].src.split(/[\\/]/).pop() ?? "";
         const [prefix, suffix = ".filamat"] = name.split("_opengl");
         files[e.path] = `export default ("id:" + _creatorUtils.fetchLocal(${JSON.stringify(prefix + "_")} + _creator.backend + ${JSON.stringify(suffix)}))`;
-      } else if (shaders.length > 2) {
-        files[e.path] = `export default \`${opts.publicUrl}${shaders[0].src.replace("_opengl", "_${_creator.subBackend ?? _creator.backend}")}\``;
       } else if (shaders.length > 0) {
         files[e.path] = `export default \`${opts.publicUrl}${shaders[0].src.replace("_opengl", "_${_creator.backend}")}\``;
       } else {
@@ -172198,6 +172193,8 @@ var compileProject = async (opts) => {
       }
     } else if (e.path.toLowerCase().endsWith(".svg")) {
       files[e.path] = `export default SvgSource(\`${e.text ?? ""}\`)`;
+    } else if (e.path.toLowerCase().endsWith(".json")) {
+      files[e.path] = `export default ${e.text?.trim() || "null"}`;
     } else {
       files[e.path] = e.text ?? "";
     }
@@ -173137,7 +173134,6 @@ __export(exports_compile, {
   parseSfnt: () => parseSfnt,
   parseJsonish: () => parseJsonish,
   offsetSourceMap: () => offsetSourceMap,
-  matcPlatformsFor: () => matcPlatformsFor,
   matcArgs: () => matcArgs,
   loadSceneHarness: () => loadSceneHarness,
   isServerPath: () => isServerPath,
@@ -173168,6 +173164,7 @@ __export(exports_compile, {
   SCENE_HARNESS_DIR: () => SCENE_HARNESS_DIR,
   SCENE_ENTRY_PATH: () => SCENE_ENTRY_PATH,
   PLATFORM_BUILD: () => PLATFORM_BUILD,
+  MATC_PLATFORMS: () => MATC_PLATFORMS,
   LOCAL_PLATFORM_BUILD: () => LOCAL_PLATFORM_BUILD,
   LOCAL_ONLY_PLATFORMS: () => LOCAL_ONLY_PLATFORMS,
   ICON_ID: () => ICON_ID,
@@ -173198,7 +173195,13 @@ var init_compile = __esm(() => {
 import { existsSync as existsSync7 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname5, join as join9 } from "node:path";
-var vendoredInject, resolveChiselBin2 = () => {
+var resolveSdkInject = () => {
+  try {
+    return createRequire3(import.meta.url).resolve("lecodes-sdk/inject");
+  } catch {}
+  const vendored = join9(distRoot, "runtime", "sdk", "inject.ts");
+  return existsSync7(vendored) ? vendored : null;
+}, sdkInject, resolveChiselBin2 = () => {
   if (process.env.LECODES_CHISEL_BIN)
     return process.env.LECODES_CHISEL_BIN;
   try {
@@ -173230,9 +173233,9 @@ var vendoredInject, resolveChiselBin2 = () => {
 var init_projectCompile = __esm(() => {
   init_distRoot();
   init_compile();
-  vendoredInject = join9(distRoot, "runtime", "sdk", "inject.ts");
-  if (existsSync7(vendoredInject))
-    process.env.LECODES_SDK_INJECT = vendoredInject;
+  sdkInject = resolveSdkInject();
+  if (sdkInject)
+    process.env.LECODES_SDK_INJECT = sdkInject;
   chiselBin = resolveChiselBin2();
   if (chiselBin)
     process.env.LECODES_CHISEL_BIN = chiselBin;
@@ -214124,25 +214127,26 @@ var init_esm30 = __esm(() => {
 
 // src/types.ts
 import { dirname as dirname13, join as join22, relative as relative3, sep } from "node:path";
-import { existsSync as existsSync21, mkdirSync as mkdirSync15, readdirSync as readdirSync10, readFileSync as readFileSync18, rmSync as rmSync8, statSync as statSync8, writeFileSync as writeFileSync17 } from "node:fs";
+import { existsSync as existsSync21, mkdirSync as mkdirSync15, readdirSync as readdirSync11, readFileSync as readFileSync18, rmSync as rmSync8, statSync as statSync9, writeFileSync as writeFileSync17 } from "node:fs";
+import { createRequire as createRequire4 } from "node:module";
 var TSCONFIG, listBundleFiles = (dir, base = dir) => {
   if (!existsSync21(dir))
     return [];
   const out = [];
-  for (const name of readdirSync10(dir)) {
+  for (const name of readdirSync11(dir)) {
     const path2 = join22(dir, name);
-    if (statSync8(path2).isDirectory())
+    if (statSync9(path2).isDirectory())
       out.push(...listBundleFiles(path2, base));
     else
       out.push(relative3(base, path2).split(sep).join("/"));
   }
   return out;
 }, pruneEmptyDirs = (dir, root) => {
-  if (!existsSync21(dir) || !statSync8(dir).isDirectory())
+  if (!existsSync21(dir) || !statSync9(dir).isDirectory())
     return;
-  for (const name of readdirSync10(dir))
+  for (const name of readdirSync11(dir))
     pruneEmptyDirs(join22(dir, name), root);
-  if (dir !== root && readdirSync10(dir).length === 0)
+  if (dir !== root && readdirSync11(dir).length === 0)
     rmSync8(dir, { recursive: true });
 }, writeTypeBundle = (root, bundle) => {
   const typesDir = join22(root, LECODES_DIR, "types");
@@ -214174,8 +214178,16 @@ var TSCONFIG, listBundleFiles = (dir, base = dir) => {
     bundle[path2] = readFileSync18(join22(typesDir, path2), "utf8");
   return bundle;
 }, materializeTypes = async (root, apiUrl) => writeTypeBundle(root, await getTypes(apiUrl)), readLocalTypeBundle = () => {
+  const fromPackage = (() => {
+    try {
+      return createRequire4(import.meta.url).resolve("lecodes-sdk/types.json");
+    } catch {
+      return null;
+    }
+  })();
   const candidates = [
     join22(distRoot, "runtime", "sdk-types.json"),
+    ...fromPackage ? [fromPackage] : [],
     join22(distRoot, "..", "sdk", "dist", "types.json")
   ];
   for (const path2 of candidates) {
@@ -214220,13 +214232,13 @@ var init_types4 = __esm(() => {
 
 // src/compile/designCompile.ts
 import { readFileSync as readFileSync19 } from "node:fs";
-import { basename as basename9 } from "node:path";
+import { basename as basename10 } from "node:path";
 var LOCAL_ASSET_SCHEME = "lecodesfile://", compileDesignScreen = async (opts) => {
   const { root, manifest, designDir, designKey, screenId, state } = opts;
   const entries = [];
   const scan2 = scanLocal(root, { ignore: loadIgnore(root), tracked: new Set(Object.keys(manifest?.files ?? {})) });
   for (const file of scan2.files) {
-    const type = manifest?.files[file.path]?.type ?? classifyKind(basename9(file.path));
+    const type = manifest?.files[file.path]?.type ?? classifyKind(basename10(file.path));
     if (type === "resource") {
       entries.push({
         path: file.path,
@@ -214358,7 +214370,7 @@ var init_browserAuth = __esm(() => {
   init_util();
 });
 
-// ../lecodes-design/src/core/concept.ts
+// ../../../lecodes-tools/packages/lecodes-design/src/core/concept.ts
 var SPEC_TEMPLATE = `# Concept
 
 The narrative half of this design. \`meta.json\` + the canvas hold the *visual/flow* half (screens,
@@ -214394,7 +214406,7 @@ Behaviour that isn't visible in a single screen — validation, permissions, not
 cases — and the decisions you've made and why, so they aren't re-litigated later.
 `;
 
-// ../lecodes-design/src/templates.ts
+// ../../../lecodes-tools/packages/lecodes-design/src/templates.ts
 var SPEC_MD, META_JSON = `{
   "screens": {
     "home": { "pos": [0, 0], "desc": "Example screen — replace me", "role": "list" }
@@ -214862,8 +214874,8 @@ __export(exports_design, {
   flushDesignComments: () => flushDesignComments,
   design: () => design
 });
-import { existsSync as existsSync24, mkdirSync as mkdirSync18, readFileSync as readFileSync21, readdirSync as readdirSync13, writeFileSync as writeFileSync19, appendFileSync } from "node:fs";
-import { basename as basename10, join as join25 } from "node:path";
+import { existsSync as existsSync24, mkdirSync as mkdirSync18, readFileSync as readFileSync21, readdirSync as readdirSync14, writeFileSync as writeFileSync19, appendFileSync } from "node:fs";
+import { basename as basename11, join as join25 } from "node:path";
 var DEFAULT_DIR = "design", DEFAULT_PORT = 4477, getContext = (args) => {
   let root;
   let manifest;
@@ -214878,7 +214890,7 @@ var DEFAULT_DIR = "design", DEFAULT_PORT = 4477, getContext = (args) => {
   return {
     root,
     manifest,
-    name: manifest?.name ?? basename10(root),
+    name: manifest?.name ?? basename11(root),
     dirName,
     designDir: join25(root, dirName),
     designKey: "/" + dirName.replace(/\\/g, "/")
@@ -214919,7 +214931,7 @@ var DEFAULT_DIR = "design", DEFAULT_PORT = 4477, getContext = (args) => {
   const dir = join25(designDir, "screens");
   if (!existsSync24(dir))
     return [];
-  return readdirSync13(dir).filter((f3) => f3.endsWith(".ts") && !f3.startsWith(".")).map((f3) => f3.slice(0, -3)).sort();
+  return readdirSync14(dir).filter((f3) => f3.endsWith(".ts") && !f3.startsWith(".")).map((f3) => f3.slice(0, -3)).sort();
 }, writeMcpConfig = (ctx, port) => {
   const path2 = join25(ctx.root, ".mcp.json");
   const entry = { type: "http", url: `http://localhost:${port}/mcp` };
@@ -216529,26 +216541,26 @@ var require_main = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "lecodes-cli",
-  version: "0.19.0",
+  version: "0.20.0",
   dependencies: {
     "@letary/chisel": "^0.10.0",
-    jimp: "^1.6.1"
+    jimp: "^1.6.1",
+    "lecodes-sdk": "workspace:*"
   },
   devDependencies: {
-    "lecodes-design": "workspace:*",
+    "lecodes-design": "link:lecodes-design",
     "lecodes-renderer": "workspace:*",
     "qrcode-terminal": "^0.12.0",
-    "lecodes-3d-editor": "workspace:*",
+    "lecodes-3d-editor": "link:lecodes-3d-editor",
     "lecodes-assets": "workspace:*",
-    "creator-nav": "workspace:*",
-    sdk: "workspace:*",
-    "viewer-lite": "workspace:*"
+    "lecodes-creator-nav": "workspace:*",
+    "lecodes-viewer-lite": "workspace:*"
   },
   peerDependencies: {
-    "lecodes-design": "^0.8.1",
-    "lecodes-renderer": "^0.8.9",
-    "lecodes-3d-editor": "^0.6.0",
-    "lecodes-assets": "^0.1.0"
+    "lecodes-design": "^0.9.0",
+    "lecodes-renderer": "^0.20.0",
+    "lecodes-3d-editor": "^0.7.0",
+    "lecodes-assets": "^0.2.1"
   },
   bin: {
     lecodes: "dist/index.js"
@@ -216559,6 +216571,7 @@ var package_default = {
   },
   files: [
     "dist",
+    "src",
     "runtime",
     "README.md"
   ],
@@ -216598,7 +216611,7 @@ var package_default = {
 init_manifest();
 init_config();
 import { execFileSync as execFileSync6 } from "node:child_process";
-import { cpSync as cpSync4, existsSync as existsSync20, mkdirSync as mkdirSync14, readFileSync as readFileSync17, readdirSync as readdirSync9, rmSync as rmSync7, statSync as statSync7, writeFileSync as writeFileSync16 } from "node:fs";
+import { cpSync as cpSync4, existsSync as existsSync20, mkdirSync as mkdirSync14, readFileSync as readFileSync17, readdirSync as readdirSync10, rmSync as rmSync7, statSync as statSync8, writeFileSync as writeFileSync16 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { basename as basename8, dirname as dirname12, join as join21, resolve as resolve8 } from "node:path";
 
@@ -216725,7 +216738,7 @@ init_fonts();
 init_compile();
 import { execFile } from "node:child_process";
 import { createHash as createHash4, randomBytes } from "node:crypto";
-import { copyFileSync, existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync11, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync7 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync11, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync7 } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename as basename3, join as join13 } from "node:path";
 
@@ -216918,17 +216931,14 @@ var matcIdentity = (exe) => {
   return `${stat.size}:${Math.trunc(stat.mtimeMs)}`;
 };
 var shaderHash = (text, matcId) => createHash4("sha256").update(`${TARGET_MATRIX_GENERATION}\x00${matcId}\x00${text}`).digest("hex").slice(0, 16);
-var artifactFamily = (text) => {
-  const matcPlatforms = [...matcPlatformsFor(text), ...LOCAL_ONLY_PLATFORMS];
-  return [...matcPlatforms, ...matcPlatforms.includes("webgl") ? [] : ["webgl"], "webgl-lite"];
-};
+var artifactFamily = () => [...MATC_PLATFORMS, ...LOCAL_ONLY_PLATFORMS, "webgl-lite"];
 var shaderIsCompiled = (root, text, matcId) => {
   const hash = shaderHash(text, matcId);
-  return artifactFamily(text).every((p) => existsSync11(join13(shadersCacheDir(root), `${hash}_${p}.filamat`)));
+  return artifactFamily().every((p) => existsSync11(join13(shadersCacheDir(root), `${hash}_${p}.filamat`)));
 };
 var shaderCompiledPlatforms = (root, text, matcId) => {
   const hash = shaderHash(text, matcId);
-  return artifactFamily(text).filter((p) => existsSync11(join13(shadersCacheDir(root), `${hash}_${p}.filamat`)));
+  return artifactFamily().filter((p) => existsSync11(join13(shadersCacheDir(root), `${hash}_${p}.filamat`)));
 };
 var localShaderArtifact = (root, text, platform) => {
   const matcExe = resolveMatcExeCached();
@@ -216973,15 +216983,12 @@ var applyLocalShaders = async (entries, opts) => {
   for (const entry of shaderEntries) {
     const text = readFileSync11(entry.absPath, "utf8");
     const hash = shaderHash(text, matcId);
-    const family = artifactFamily(text);
+    const family = artifactFamily();
     const artifact = (platform) => `${hash}_${platform}.filamat`;
     const has = (platform) => existsSync11(join13(cacheDir, artifact(platform)));
     const wanted = opts.platforms ? family.filter((p) => opts.platforms.includes(p)) : family;
-    if (wanted.includes("webgl") && !matcPlatformsFor(text).includes("webgl") && !wanted.includes("opengl")) {
-      wanted.push("opengl");
-    }
     const missing = wanted.filter((p) => !has(p));
-    const matcMissing = missing.filter((p) => p !== "webgl-lite" && !(p === "webgl" && !matcPlatformsFor(text).includes("webgl")));
+    const matcMissing = missing.filter((p) => p !== "webgl-lite");
     if (matcMissing.length > 0) {
       const tempName = `lecodes-matc-${randomBytes(6).toString("hex")}.mat`;
       const tempFile = join13(tmpdir(), tempName);
@@ -217001,9 +217008,6 @@ ${cleanMatcOutput(stderr, tempName, basename3(entry.path))}`);
         rmSync2(tempFile, { force: true });
       }
     }
-    if (missing.includes("webgl") && !matcPlatformsFor(text).includes("webgl")) {
-      copyFileSync(join13(cacheDir, artifact("opengl")), join13(cacheDir, artifact("webgl")));
-    }
     if (missing.includes("webgl-lite")) {
       writeFileSync7(join13(cacheDir, artifact("webgl-lite")), JSON.stringify(buildLiteMaterialArtifact(text)));
     }
@@ -217018,7 +217022,7 @@ ${cleanMatcOutput(stderr, tempName, basename3(entry.path))}`);
         artifacts.push({ name: artifact(platform), absPath: join13(cacheDir, artifact(platform)) });
       }
     } else {
-      const order = ["opengl", "metal", "desktop", "webgl", "webgl-lite"];
+      const order = ["opengl", "metal", "desktop", "webgl-lite"];
       entry.shaders = order.map((platform) => ({ platform, src: `${opts.srcPrefix}/${artifact(platform)}` }));
     }
   }
@@ -217034,12 +217038,13 @@ init_manifest();
 init_ignore();
 init_util();
 import { execFileSync } from "node:child_process";
-import { existsSync as existsSync13, mkdirSync as mkdirSync8, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "node:fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync8, readdirSync as readdirSync5, readFileSync as readFileSync13, statSync as statSync3, writeFileSync as writeFileSync9 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { dirname as dirname8, join as join15, resolve as resolve2 } from "node:path";
 var FIRST_PARTY_PLUGINS = {
   camera: "letary/lecodes-plugins",
   "qr-scanner": "letary/lecodes-plugins",
+  map: "letary/lecodes-plugins",
   geolocation: "letary/lecodes-plugins",
   push: "letary/lecodes-plugins"
 };
@@ -217070,6 +217075,7 @@ var desktopDefaultViewport = (root) => {
     height: cfg.desktop.window?.height ?? DESKTOP_DEFAULT_WINDOW.height
   };
 };
+var swiftPackageName = (url) => (url.replace(/\/+$/, "").split("/").pop() ?? url).replace(/\.git$/, "");
 var readJson = (path) => {
   if (!existsSync13(path))
     return null;
@@ -217223,7 +217229,8 @@ var ensureRepo = (repo, wantTag, lock) => {
   git(cache, "checkout", "--quiet", "--detach", commit);
   return { dir: cache, tag: tag ?? "unknown", commit };
 };
-var resolvePlugin = (id, spec, lock, platform) => {
+var PLUGIN_PLATFORM_LABEL = { ios: "iOS", android: "Android", desktop: "desktop" };
+function resolvePlugin(id, spec, lock, platform, opts) {
   let repo;
   let subdir;
   let wantTag = null;
@@ -217247,7 +217254,9 @@ var resolvePlugin = (id, spec, lock, platform) => {
   if (manifest.id !== id)
     throw new CliError(`Plugin "${id}": manifest declares id "${manifest.id}"`);
   if (!manifest[platform]) {
-    throw new CliError(`Plugin "${id}" does not support ${platform === "ios" ? "iOS" : "Android"} (manifest "${platform}" is null)`);
+    if (opts?.optional)
+      return null;
+    throw new CliError(`Plugin "${id}" does not support ${PLUGIN_PLATFORM_LABEL[platform]} (manifest "${platform}" is null)`);
   }
   if (spec.startsWith("github:")) {
     const names = [...manifest.provides?.views ?? [], ...manifest.provides?.services ?? []];
@@ -217262,7 +217271,7 @@ var resolvePlugin = (id, spec, lock, platform) => {
     manifest,
     lock: { repo, tag: checkout.tag, commit: checkout.commit, version: manifest.version ?? "unknown" }
   };
-};
+}
 var latestPluginTag = (repo) => {
   try {
     return ensureRepo(repo, null, undefined).tag;
@@ -217270,6 +217279,55 @@ var latestPluginTag = (repo) => {
     return null;
   }
 };
+var desktopPluginTarget = () => `${process.platform}-${process.arch}`;
+var isDesktopPluginLibrary = (name) => {
+  const n = name.toLowerCase();
+  return process.platform === "win32" ? n.endsWith(".dll") : n.endsWith(".so");
+};
+var desktopPluginLibraries = (root, opts = {}) => {
+  const dirs = [];
+  const files = [];
+  const local = join15(root, "plugins");
+  if (existsSync13(local) && statSync3(local).isDirectory()) {
+    dirs.push(local);
+    for (const f2 of readdirSync5(local))
+      if (isDesktopPluginLibrary(f2))
+        files.push(join15(local, f2));
+  }
+  const config = readJson(join15(root, "app.json"));
+  const specs = Object.entries(config?.plugins ?? {});
+  if (specs.length === 0)
+    return { dirs, files };
+  const lock = readJson(join15(root, "plugins.lock.json"))?.plugins ?? {};
+  const target = desktopPluginTarget();
+  for (const [id, spec] of specs) {
+    let plugin;
+    try {
+      plugin = resolvePlugin(id, spec, lock[id], "desktop", { optional: true });
+    } catch (e) {
+      if (opts.strict)
+        throw e;
+      warn(`Plugin "${id}": ${e.message} — skipped for this desktop run`);
+      continue;
+    }
+    const rel = plugin?.manifest.desktop?.library?.[target];
+    if (!plugin || !rel)
+      continue;
+    const abs = resolve2(plugin.dir, rel);
+    if (!existsSync13(abs)) {
+      const msg = `Plugin "${id}": desktop library ${abs} is missing (manifest desktop.library["${target}"])`;
+      if (opts.strict)
+        throw new CliError(msg);
+      warn(`${msg} — skipped for this desktop run`);
+      continue;
+    }
+    files.push(abs);
+    const dir = dirname8(abs);
+    if (!dirs.includes(dir))
+      dirs.push(dir);
+  }
+  return { dirs, files };
+};
 
 // src/commands/compile.ts
 init_util();
@@ -218074,13 +218132,31 @@ var APP_ICON_JSON = `{
 `;
 var runtimePackageTemplate = (sdkVersion, variant, plugins) => {
   const product = `LeCodesSDK-${variant}`;
-  const pluginTargets = plugins.map((p) => `
+  const packages = new Map;
+  for (const p of plugins) {
+    for (const pkg of p.packages ?? []) {
+      const prior = packages.get(pkg.url);
+      if (prior && (prior.exact !== pkg.exact || prior.from !== pkg.from)) {
+        throw new Error(`Plugin "${p.id}" pins ${pkg.url} at ${pkg.exact ?? `from ${pkg.from}`} but another plugin pins ${prior.exact ?? `from ${prior.from}`} — the shell can link one version.`);
+      }
+      packages.set(pkg.url, pkg);
+    }
+  }
+  const packageDecls = [...packages.values()].map((pkg) => `
+        .package(url: "${pkg.url}", ${pkg.exact ? `exact: "${pkg.exact}"` : `from: "${pkg.from}"`}),`).join("");
+  const pluginTargets = plugins.map((p) => {
+    const deps = [
+      `.product(name: "${product}", package: "lecodes-ios-sdk")`,
+      ...(p.packages ?? []).flatMap((pkg) => pkg.products.map((name) => `.product(name: "${name}", package: "${swiftPackageName(pkg.url)}")`))
+    ];
+    return `
         // plugin: ${p.id} (vendored — see plugins.lock.json)
         .target(
             name: "${p.module}",
-            dependencies: [.product(name: "${product}", package: "lecodes-ios-sdk")],
+            dependencies: [${deps.join(", ")}],
             path: "Sources/${p.module}"
-        ),`).join("");
+        ),`;
+  }).join("");
   const runtimeDeps = [`.product(name: "${product}", package: "lecodes-ios-sdk")`, ...plugins.map((p) => `"${p.module}"`)];
   return `// swift-tools-version:5.9
 //
@@ -218099,7 +218175,7 @@ let package = Package(
         .library(name: "LeCodesRuntime", targets: ["LeCodesRuntime"]),
     ],
     dependencies: [
-        .package(url: "https://github.com/letary/lecodes-ios-sdk.git", exact: "${sdkVersion}"),
+        .package(url: "https://github.com/letary/lecodes-ios-sdk.git", exact: "${sdkVersion}"),${packageDecls}
     ],
     targets: [
         .target(
@@ -218245,7 +218321,7 @@ buildNumber) — edit it there, then re-run \`lecodes app sync\`. Plugins are ma
 init_manifest();
 import { execFileSync as execFileSync2, spawn, spawnSync as spawnSync3 } from "node:child_process";
 import { createHash as createHash6 } from "node:crypto";
-import { chmodSync, cpSync, existsSync as existsSync16, mkdirSync as mkdirSync10, readFileSync as readFileSync15, readdirSync as readdirSync5, renameSync as renameSync2, rmSync as rmSync3, statSync as statSync3, writeFileSync as writeFileSync12 } from "node:fs";
+import { chmodSync, cpSync, existsSync as existsSync16, mkdirSync as mkdirSync10, readFileSync as readFileSync15, readdirSync as readdirSync6, renameSync as renameSync2, rmSync as rmSync3, statSync as statSync4, writeFileSync as writeFileSync12 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { basename as basename5, dirname as dirname10, join as join17 } from "node:path";
 init_util();
@@ -218630,6 +218706,12 @@ Sync links the smallest SDK artifact covering the engines the compiled bundle ac
 engine, sync switches automatically on the next run; set \`android.variant\` in \`../app.json\`
 to force one (needs lecodes-android-sdk >= 1.3.0; older releases ship only the full AAR).
 
+Physics, navigation meshes and multiplayer ship in \`lecodes-sdk\` (full) ONLY —
+\`lecodes-sdk-3d\` is 3D rendering without the game stack. Auto-selection reads which RENDERING
+engines the bundle uses and cannot see those, so a project using \`Physics\`,
+\`CharacterController\`, \`NavMesh\` or networking must set \`android.variant: "full"\` in
+\`../app.json\` — otherwise those aspects silently do nothing on device.
+
 ## App-local native code
 
 Drop Kotlin files into \`app/src/main/java/\` and register them in \`MainActivity\` after the
@@ -219486,7 +219568,7 @@ var syncAndroid = async (root, config, prior) => {
     }
     const namespace = register.split(".").slice(0, -1).join(".");
     const libsDir = join17(dest, "libs");
-    const aarNames = existsSync16(libsDir) ? readdirSync5(libsDir).filter((f3) => f3.endsWith(".aar")) : [];
+    const aarNames = existsSync16(libsDir) ? readdirSync6(libsDir).filter((f3) => f3.endsWith(".aar")) : [];
     for (const aar of aarNames) {
       const base = aar.replace(/\.aar$/, "");
       const wrapDir = join17(libsDir, base);
@@ -219502,8 +219584,8 @@ var syncAndroid = async (root, config, prior) => {
     log(`${c.green("plugin")}    ${id}@${plugin.lock.version} (${plugin.lock.tag} → plugins/${module})`);
   }
   const keep = new Set(runtimePlugins.map((p2) => p2.module));
-  for (const entry of existsSync16(pluginsDir) ? readdirSync5(pluginsDir) : []) {
-    if (!keep.has(entry) && statSync3(join17(pluginsDir, entry)).isDirectory()) {
+  for (const entry of existsSync16(pluginsDir) ? readdirSync6(pluginsDir) : []) {
+    if (!keep.has(entry) && statSync4(join17(pluginsDir, entry)).isDirectory()) {
       rmrf(join17(pluginsDir, entry));
       log(`${c.yellow("removed")}   android/plugins/${entry}  (plugin uninstalled)`);
     }
@@ -219668,7 +219750,7 @@ var buildAndroid = async (args) => {
   for (const dir of [apkDir, aabDir]) {
     if (!existsSync16(dir))
       continue;
-    for (const f3 of readdirSync5(dir)) {
+    for (const f3 of readdirSync6(dir)) {
       if (f3.endsWith(".apk") || f3.endsWith(".aab"))
         outputs.push(join17(dir, f3));
     }
@@ -219725,7 +219807,7 @@ var doctorAndroidChecks = async (root, config, check) => {
   const validVariant = requestedVariant === "auto" || SDK_VARIANTS.includes(requestedVariant);
   check(validVariant, `android.variant "${requestedVariant}"`, `use "auto" or one of ${SDK_VARIANTS.join(", ")}`);
   const wrapperJar = join17(androidDir, "gradle", "wrapper", "gradle-wrapper.jar");
-  check(existsSync16(wrapperJar) && statSync3(wrapperJar).size > 0, "Gradle wrapper jar", `run \`gradle wrapper --gradle-version ${GRADLE_VERSION}\` in android/ (or let Android Studio repair it)`);
+  check(existsSync16(wrapperJar) && statSync4(wrapperJar).size > 0, "Gradle wrapper jar", `run \`gradle wrapper --gradle-version ${GRADLE_VERSION}\` in android/ (or let Android Studio repair it)`);
   check(existsSync16(join17(androidDir, "app", "src", "main", "assets", "app.js")), "Bundled app.js", "run `lecodes app sync`");
   const linked = shellSdkVersionAndroid(androidDir);
   const pin = config.android?.sdk ?? "latest";
@@ -219748,14 +219830,14 @@ var doctorAndroidChecks = async (root, config, check) => {
 
 // src/commands/appDesktop.ts
 import { execFileSync as execFileSync5, spawn as spawn4 } from "node:child_process";
-import { cpSync as cpSync3, existsSync as existsSync19, mkdirSync as mkdirSync13, readdirSync as readdirSync8, rmSync as rmSync6, statSync as statSync6, writeFileSync as writeFileSync15 } from "node:fs";
+import { cpSync as cpSync3, existsSync as existsSync19, mkdirSync as mkdirSync13, readdirSync as readdirSync9, rmSync as rmSync6, statSync as statSync7, writeFileSync as writeFileSync15 } from "node:fs";
 import { basename as basename7, dirname as dirname11, join as join20, resolve as resolve7 } from "node:path";
 
 // src/desktopRenderer.ts
 import { execFileSync as execFileSync3, spawn as spawn2, spawnSync as spawnSync4 } from "node:child_process";
-import { copyFileSync as copyFileSync2, existsSync as existsSync17, mkdirSync as mkdirSync11, mkdtempSync as mkdtempSync2, readdirSync as readdirSync6, readFileSync as readFileSync16, rmSync as rmSync4, statSync as statSync4, writeFileSync as writeFileSync13 } from "node:fs";
+import { copyFileSync, existsSync as existsSync17, mkdirSync as mkdirSync11, mkdtempSync as mkdtempSync2, readdirSync as readdirSync7, readFileSync as readFileSync16, rmSync as rmSync4, statSync as statSync5, writeFileSync as writeFileSync13 } from "node:fs";
 import { homedir as homedir6, tmpdir as tmpdir2 } from "node:os";
-import { join as join18, resolve as resolve5 } from "node:path";
+import { delimiter, join as join18, resolve as resolve5 } from "node:path";
 init_util();
 
 // ../viewer-lite/src/sourcemapError.ts
@@ -219875,7 +219957,7 @@ var isMac = () => process.platform === "darwin";
 var exeName = () => process.platform === "win32" ? "lecodes-desktop.exe" : isMac() ? "lecodes-app" : "lecodes-desktop";
 var findExe = (dir) => {
   const name = exeName();
-  for (const entry of readdirSync6(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync7(dir, { withFileTypes: true })) {
     const p2 = join18(dir, entry.name);
     if (entry.isFile() && entry.name === name)
       return p2;
@@ -219891,7 +219973,7 @@ var cacheRoot2 = () => join18(homedir6(), ".lecodes", "renderer");
 var currentFile = () => join18(cacheRoot2(), "current.json");
 var installedDesktopVersions = () => {
   try {
-    return readdirSync6(cacheRoot2(), { withFileTypes: true }).filter((e2) => e2.isDirectory() && e2.name.startsWith("desktop-")).map((e2) => e2.name.slice("desktop-".length)).filter((v) => findExe(join18(cacheRoot2(), `desktop-${v}`)) !== null).sort(semverNewer);
+    return readdirSync7(cacheRoot2(), { withFileTypes: true }).filter((e2) => e2.isDirectory() && e2.name.startsWith("desktop-")).map((e2) => e2.name.slice("desktop-".length)).filter((v) => findExe(join18(cacheRoot2(), `desktop-${v}`)) !== null).sort(semverNewer);
   } catch {
     return [];
   }
@@ -219916,7 +219998,7 @@ var extractDmg = (archive, stage) => {
   mkdirSync11(mount, { recursive: true });
   execFileSync3("hdiutil", ["attach", "-nobrowse", "-readonly", "-quiet", "-mountpoint", mount, archive]);
   try {
-    const app = readdirSync6(mount).find((n2) => n2.endsWith(".app"));
+    const app = readdirSync7(mount).find((n2) => n2.endsWith(".app"));
     if (!app)
       throw new CliError("The downloaded DMG holds no .app bundle.");
     execFileSync3("cp", ["-R", join18(mount, app), join18(stage, app)]);
@@ -220037,8 +220119,12 @@ var updateDesktop = async () => {
   else
     note(`Desktop renderer set to ${latest} (was ${before}).`);
 };
+var pluginEnv = (dirs) => {
+  const all = [...dirs ?? [], ...process.env.CREATOR_PLUGIN_DIRS ? [process.env.CREATOR_PLUGIN_DIRS] : []];
+  return all.length > 0 ? { CREATOR_PLUGIN_DIRS: all.join(delimiter) } : {};
+};
 var windowEnv = (opts) => {
-  const env = {};
+  const env = { ...pluginEnv(opts.pluginDirs) };
   const width = opts.width ?? (opts.height !== undefined ? 1280 : undefined);
   const height = opts.height ?? (opts.width !== undefined ? 720 : undefined);
   if (width && height)
@@ -220082,8 +220168,8 @@ var stageBundle = (js, resources) => {
   const runDir = mkdtempSync2(join18(tmpdir2(), "lecodes-render-"));
   writeFileSync13(join18(runDir, "app.js"), js);
   for (const r2 of resources) {
-    if (r2.absPath && existsSync17(r2.absPath) && statSync4(r2.absPath).isFile()) {
-      copyFileSync2(r2.absPath, join18(runDir, r2.name));
+    if (r2.absPath && existsSync17(r2.absPath) && statSync5(r2.absPath).isFile()) {
+      copyFileSync(r2.absPath, join18(runDir, r2.name));
     }
   }
   return runDir;
@@ -220126,7 +220212,16 @@ var runDesktopApp = async (js, resources, opts = {}) => {
       });
     });
   } finally {
-    rmSync4(runDir, { recursive: true, force: true });
+    for (let attempt = 0;; attempt++) {
+      try {
+        rmSync4(runDir, { recursive: true, force: true });
+        break;
+      } catch {
+        if (attempt >= 5)
+          break;
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200);
+      }
+    }
   }
 };
 var runDesktopDev = async (url, opts = {}) => {
@@ -220165,6 +220260,7 @@ var runDesktopRender = async (js, resources, opts) => {
       env.CREATOR_CAMERA = opts.camera;
     if (opts.view)
       env.CREATOR_VIEW = opts.view;
+    Object.assign(env, pluginEnv(opts.pluginDirs));
     const demangle = makeStackDemangler(js) ?? ((text) => text);
     return await new Promise((done, fail) => {
       const child = spawn2(exe, [appJs], { cwd: runDir, env, stdio: ["ignore", "pipe", "pipe"] });
@@ -220204,7 +220300,16 @@ ${tail}` : "";
       });
     });
   } finally {
-    rmSync4(runDir, { recursive: true, force: true });
+    for (let attempt = 0;; attempt++) {
+      try {
+        rmSync4(runDir, { recursive: true, force: true });
+        break;
+      } catch {
+        if (attempt >= 5)
+          break;
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200);
+      }
+    }
   }
 };
 
@@ -220214,13 +220319,13 @@ init_util();
 // src/commands/appDesktopMac.ts
 init_util();
 import { execFileSync as execFileSync4, spawn as spawn3, spawnSync as spawnSync5 } from "node:child_process";
-import { cpSync as cpSync2, existsSync as existsSync18, mkdirSync as mkdirSync12, mkdtempSync as mkdtempSync3, readdirSync as readdirSync7, rmSync as rmSync5, statSync as statSync5, writeFileSync as writeFileSync14 } from "node:fs";
+import { cpSync as cpSync2, existsSync as existsSync18, mkdirSync as mkdirSync12, mkdtempSync as mkdtempSync3, readdirSync as readdirSync8, rmSync as rmSync5, statSync as statSync6, symlinkSync, writeFileSync as writeFileSync14 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { basename as basename6, join as join19, resolve as resolve6 } from "node:path";
 var mb = (bytes) => `${(bytes / 1024 / 1024).toFixed(1)} MB`;
-var dirSize = (dir) => readdirSync7(dir, { withFileTypes: true }).reduce((sum, e2) => {
+var dirSize = (dir) => readdirSync8(dir, { withFileTypes: true }).reduce((sum, e2) => {
   const p2 = join19(dir, e2.name);
-  return sum + (e2.isDirectory() ? dirSize(p2) : e2.isSymbolicLink() ? 0 : statSync5(p2).size);
+  return sum + (e2.isDirectory() ? dirSize(p2) : e2.isSymbolicLink() ? 0 : statSync6(p2).size);
 }, 0);
 var cleanBundleName = (name) => name.replace(/[/:]/g, "").trim() || "App";
 var macHostAppOf = (exe) => {
@@ -220233,7 +220338,7 @@ var macHostAppOf = (exe) => {
 var macHostProvidedNames = (exe) => {
   const names3 = new Set;
   const walk = (dir) => {
-    for (const e2 of readdirSync7(dir, { withFileTypes: true })) {
+    for (const e2 of readdirSync8(dir, { withFileTypes: true })) {
       if (e2.isDirectory())
         walk(join19(dir, e2.name));
       else
@@ -220336,11 +220441,12 @@ var signApp = async (app, signing, hostApp, tmp) => {
     throw new CliError(`The signature doesn't verify:
 ${(verify.stdout + verify.stderr).trim()}`);
 };
-var notarizeApp = (app, profile, tmp) => {
-  const zip = join19(tmp, `${basename6(app, ".app")}.zip`);
-  execFileSync4("ditto", ["-c", "-k", "--keepParent", app, zip]);
-  note(`Notarizing with profile "${profile}" — this waits on Apple (usually 1–5 minutes)…`);
-  const r2 = spawnSync5("xcrun", ["notarytool", "submit", zip, "--keychain-profile", profile, "--wait"], { encoding: "utf8" });
+var notarize = (target, profile, tmp, what) => {
+  const submission = target.endsWith(".app") ? join19(tmp, `${basename6(target, ".app")}.zip`) : target;
+  if (submission !== target)
+    execFileSync4("ditto", ["-c", "-k", "--keepParent", target, submission]);
+  note(`Notarizing the ${what} with profile "${profile}" — this waits on Apple (usually 1–5 minutes)…`);
+  const r2 = spawnSync5("xcrun", ["notarytool", "submit", submission, "--keychain-profile", profile, "--wait"], { encoding: "utf8" });
   const out = (r2.stdout + `
 ` + r2.stderr).trim();
   const id = /id: ([0-9a-f-]{36})/.exec(out)?.[1];
@@ -220349,11 +220455,44 @@ var notarizeApp = (app, profile, tmp) => {
 ${out}
 ` + (id ? `  Details: xcrun notarytool log ${id} --keychain-profile ${profile}` : ""));
   }
-  const staple = spawnSync5("xcrun", ["stapler", "staple", app], { encoding: "utf8" });
+  const staple = spawnSync5("xcrun", ["stapler", "staple", target], { encoding: "utf8" });
   if (staple.status !== 0)
     throw new CliError(`Stapling failed:
 ${(staple.stdout + staple.stderr).trim()}`);
-  success("Notarized + stapled.");
+  success(`Notarized + stapled (${what}).`);
+};
+var buildDmg = async (app, out, appName, signing, tmp) => {
+  const dmg = join19(out, `${appName}.dmg`);
+  rmSync5(dmg, { force: true });
+  const stage = join19(tmp, "dmg");
+  rmSync5(stage, { recursive: true, force: true });
+  mkdirSync12(stage, { recursive: true });
+  note("Building the disk image…");
+  execFileSync4("cp", ["-R", app, join19(stage, basename6(app))]);
+  symlinkSync("/Applications", join19(stage, "Applications"));
+  const r2 = spawnSync5("hdiutil", [
+    "create",
+    "-volname",
+    appName,
+    "-srcfolder",
+    stage,
+    "-fs",
+    "HFS+",
+    "-format",
+    "UDZO",
+    "-ov",
+    dmg
+  ], { encoding: "utf8" });
+  rmSync5(stage, { recursive: true, force: true });
+  if (r2.status !== 0)
+    throw new CliError(`hdiutil failed:
+${(r2.stdout + r2.stderr).trim()}`);
+  if (signing.identity !== "-") {
+    await codesignRetrying(["--force", "--timestamp", "--sign", signing.identity, dmg]);
+    if (signing.notaryProfile)
+      notarize(dmg, signing.notaryProfile, tmp, "disk image");
+  }
+  success(`DMG: ${dmg} (${mb(statSync6(dmg).size)})`);
 };
 var gatekeeperVerdict = (app) => {
   const r2 = spawnSync5("spctl", ["-a", "-t", "exec", "-vv", app], { encoding: "utf8" });
@@ -220454,12 +220593,12 @@ var buildMacApp = async (input) => {
     writeFileSync14(join19(proj, "app.js"), js);
     let assetBytes = 0, assetCount = 0;
     for (const r2 of shipped) {
-      if (!r2.absPath || !existsSync18(r2.absPath) || !statSync5(r2.absPath).isFile()) {
+      if (!r2.absPath || !existsSync18(r2.absPath) || !statSync6(r2.absPath).isFile()) {
         warn(`asset "${r2.name}" (${r2.path}) has no local file — skipped`);
         continue;
       }
       cpSync2(r2.absPath, join19(proj, "assets", r2.name));
-      assetBytes += statSync5(r2.absPath).size;
+      assetBytes += statSync6(r2.absPath).size;
       assetCount++;
     }
     note(`  assets: ${assetCount} files, ${mb(assetBytes)} → Contents/Resources/project/assets/`);
@@ -220487,7 +220626,7 @@ var buildMacApp = async (input) => {
     }, developerIdInKeychain);
     await signApp(app, signing, hostApp, tmp);
     if (signing.notaryProfile) {
-      notarizeApp(app, signing.notaryProfile, tmp);
+      notarize(app, signing.notaryProfile, tmp, "app");
     } else if (signing.identity !== "-") {
       warn("Signed with Developer ID but NOT notarized — Gatekeeper refuses a downloaded copy on every other Mac.");
       warn("  Set desktop.macos.notarize.profile in app.json (a `xcrun notarytool store-credentials` profile) or pass --notarize <profile>.");
@@ -220499,15 +220638,17 @@ var buildMacApp = async (input) => {
     }
     writeFileSync14(join19(out, "README.txt"), readmeText(appName, !!signing.notaryProfile, signing.identity !== "-"));
     success(`App: ${app}  (${mb(dirSize(app))})`);
+    if (flagBool(args, "dmg"))
+      await buildDmg(app, out, appName, signing, tmp);
     if (flagBool(args, "probe"))
       await probeMacApp(app, out, args);
     if (flagBool(args, "zip")) {
       const zip = join19(out, `${appName}.zip`);
       rmSync5(zip, { force: true });
       execFileSync4("ditto", ["-c", "-k", "--keepParent", app, zip]);
-      success(`Zip: ${zip} (${mb(statSync5(zip).size)})`);
-    } else {
-      note("Tip: --zip packs the .app for sending (ditto, structure-preserving).");
+      success(`Zip: ${zip} (${mb(statSync6(zip).size)})`);
+    } else if (!flagBool(args, "dmg")) {
+      note("Tip: --zip packs the .app for sending; --dmg wraps it in a drag-to-Applications image.");
     }
   } finally {
     rmSync5(tmp, { recursive: true, force: true });
@@ -220529,9 +220670,9 @@ or remove the quarantine flag in Terminal:  xattr -dr com.apple.quarantine "` +
 
 // src/commands/appDesktop.ts
 var mb2 = (bytes) => `${(bytes / 1024 / 1024).toFixed(1)} MB`;
-var dirSize2 = (dir) => readdirSync8(dir, { withFileTypes: true }).reduce((sum, e2) => {
+var dirSize2 = (dir) => readdirSync9(dir, { withFileTypes: true }).reduce((sum, e2) => {
   const p2 = join20(dir, e2.name);
-  return sum + (e2.isDirectory() ? dirSize2(p2) : statSync6(p2).size);
+  return sum + (e2.isDirectory() ? dirSize2(p2) : statSync7(p2).size);
 }, 0);
 var initDesktop = async (args) => {
   const root = projectRoot();
@@ -220560,7 +220701,7 @@ var buildDesktop = async (args) => {
   const slug = flagStr(args, "slug") ?? cleanFileName(name);
   const out = resolve7(root, flagStr(args, "o", "out") ?? join20(root, "dist", slug));
   if (existsSync19(out)) {
-    const entries = readdirSync8(out);
+    const entries = readdirSync9(out);
     const looksLikeBuild = entries.length === 0 || entries.includes("app.js") || entries.some((e2) => e2.endsWith(".app"));
     if (!looksLikeBuild) {
       throw new CliError(`${out} exists and doesn't look like a previous desktop build — pick another -o or clear it yourself.`);
@@ -220597,7 +220738,7 @@ var buildDesktop = async (args) => {
   const hostProvided = mac ? macHostProvidedNames(exe) : new Set;
   if (!mac) {
     try {
-      for (const f3 of readdirSync8(join20(hostDir, "assets")))
+      for (const f3 of readdirSync9(join20(hostDir, "assets")))
         hostProvided.add(f3);
     } catch {}
   }
@@ -220608,10 +220749,12 @@ var buildDesktop = async (args) => {
   }
   if (mac)
     return buildMacApp({ root, config, name, slug, out, js, shipped, hostExe: exe, args });
+  if (flagBool(args, "dmg"))
+    warn("--dmg is a macOS format — ignored on this platform.");
   const version = process.env.LECODES_DESKTOP_EXE ? "local build" : selectedDesktopVersion();
   rmSync6(out, { recursive: true, force: true });
   mkdirSync13(out, { recursive: true });
-  for (const entry of readdirSync8(hostDir, { withFileTypes: true })) {
+  for (const entry of readdirSync9(hostDir, { withFileTypes: true })) {
     if (entry.isFile() && entry.name.toLowerCase().endsWith(".dll")) {
       cpSync3(join20(hostDir, entry.name), join20(out, entry.name));
     } else if (entry.isDirectory() && entry.name === "assets") {
@@ -220631,12 +220774,12 @@ var buildDesktop = async (args) => {
   if (shipped.length > 0)
     mkdirSync13(join20(out, ASSETS_DIR), { recursive: true });
   for (const r2 of shipped) {
-    if (!r2.absPath || !existsSync19(r2.absPath) || !statSync6(r2.absPath).isFile()) {
+    if (!r2.absPath || !existsSync19(r2.absPath) || !statSync7(r2.absPath).isFile()) {
       warn(`asset "${r2.name}" (${r2.path}) has no local file — skipped`);
       continue;
     }
     cpSync3(r2.absPath, join20(out, ASSETS_DIR, r2.name));
-    assetBytes += statSync6(r2.absPath).size;
+    assetBytes += statSync7(r2.absPath).size;
     assetCount++;
   }
   note(`  assets: ${assetCount} files, ${mb2(assetBytes)} → ${ASSETS_DIR}/`);
@@ -220645,6 +220788,15 @@ var buildDesktop = async (args) => {
     await writeIco(root, config, join20(out, "app.ico"));
     note("  app.ico rendered from " + config.icon);
   }
+  {
+    const { files } = desktopPluginLibraries(root, { strict: true });
+    if (files.length > 0) {
+      mkdirSync13(join20(out, "plugins"), { recursive: true });
+      for (const f3 of files)
+        cpSync3(f3, join20(out, "plugins", basename7(f3)));
+      note(`  plugins: ${files.map((f3) => basename7(f3)).join(", ")} → plugins/`);
+    }
+  }
   writeFileSync15(join20(out, "README.txt"), "\uFEFF" + readmeText2(name, exeName2, version));
   success(`Portable build: ${out}  (${mb2(dirSize2(out))})`);
   if (flagBool(args, "probe"))
@@ -220744,7 +220896,7 @@ var zipBuild = (out) => {
   } else {
     execFileSync5("zip", ["-rq", zip, basename7(out)], { cwd: dirname11(out) });
   }
-  success(`Zip: ${zip} (${mb2(statSync6(zip).size)})`);
+  success(`Zip: ${zip} (${mb2(statSync7(zip).size)})`);
 };
 var readmeText2 = (name, exeName2, version) => `${name}
 ${"=".repeat(Math.max(name.length, 4))}
@@ -220951,13 +221103,18 @@ var syncIos = async (root, config) => {
     for (const [key, value] of Object.entries(ios.entitlements ?? {})) {
       (entitlementValues[key] ??= []).push(value);
     }
-    runtimePlugins.push({ id, module, register });
+    for (const pkg of ios.packages ?? []) {
+      if (!pkg.url || !Array.isArray(pkg.products) || pkg.products.length === 0 || !pkg.exact && !pkg.from || pkg.exact && pkg.from) {
+        throw new CliError(`Plugin "${id}": manifest ios.packages entries need { url, exact | from, products: [...] } — got ${JSON.stringify(pkg)}`);
+      }
+    }
+    runtimePlugins.push({ id, module, register, packages: ios.packages });
     newLock[id] = plugin.lock;
     log(`${c.green("plugin")}    ${id}@${plugin.lock.version} (${plugin.lock.tag} → Sources/${module})`);
   }
   const keep = new Set(["LeCodesRuntime", ...runtimePlugins.map((p2) => p2.module)]);
-  for (const entry of existsSync20(sourcesDir) ? readdirSync9(sourcesDir) : []) {
-    if (!keep.has(entry) && statSync7(join21(sourcesDir, entry)).isDirectory()) {
+  for (const entry of existsSync20(sourcesDir) ? readdirSync10(sourcesDir) : []) {
+    if (!keep.has(entry) && statSync8(join21(sourcesDir, entry)).isDirectory()) {
       rmSync7(join21(sourcesDir, entry), { recursive: true });
       log(`${c.yellow("removed")}   ios/LeCodesRuntime/Sources/${entry}  (plugin uninstalled)`);
     }
@@ -220985,7 +221142,7 @@ var syncIos = async (root, config) => {
   if (variant === "3d" || variant === "full") {
     const sdkResources = await ensureSdkResourcesBundle(sdkVersion);
     cpSync4(sdkResources, join21(resourcesDir, "LeCodesSDKResources.bundle"), { recursive: true });
-    for (const f3 of readdirSync9(sdkResources))
+    for (const f3 of readdirSync10(sdkResources))
       if (f3 !== "Info.plist")
         sdkProvided.add(f3);
     log(`${c.green("resources")} LeCodesSDKResources.bundle (filament) → ios/App/Resources/`);
@@ -221323,7 +221480,7 @@ var doctorIosChecks = async (root, config, check) => {
   check(xcodeVersion !== "", `Xcode CLI (${xcodeVersion || "not found"})`, "install Xcode + command line tools");
   check(!!config.ios.teamId, "Development team set", "lecodes app init wrote app.json — fill ios.teamId", false);
   const iconDir = join21(root, "ios", "App", "Assets.xcassets", "AppIcon.appiconset");
-  const hasIcon = existsSync20(iconDir) && readdirSync9(iconDir).some((f3) => f3.endsWith(".png"));
+  const hasIcon = existsSync20(iconDir) && readdirSync10(iconDir).some((f3) => f3.endsWith(".png"));
   check(hasIcon, "App icon present", "drop a 1024×1024 PNG into ios/App/Assets.xcassets/AppIcon.appiconset/ (App Store requires it)", false);
   const bundle = join21(root, "ios", "App", "Resources", "app.js");
   check(existsSync20(bundle), "Bundled app.js", "run `lecodes app sync`");
@@ -221366,7 +221523,7 @@ var doctorIosChecks = async (root, config, check) => {
     const plist = readFileSync17(join21(root, "ios", "App", "Info.plist"), "utf8");
     check(plist.includes("<key>LeCodesUpdateURL</key>"), "OTA update URL in Info.plist", "run `lecodes app sync`", false);
     const appDir = join21(root, "ios", "App");
-    const callsUpdater = readdirSync9(appDir).some((f3) => f3.endsWith(".swift") && readFileSync17(join21(appDir, f3), "utf8").includes("LeCodesUpdater.activeBundle"));
+    const callsUpdater = readdirSync10(appDir).some((f3) => f3.endsWith(".swift") && readFileSync17(join21(appDir, f3), "utf8").includes("LeCodesUpdater.activeBundle"));
     check(callsUpdater, "App code launches via LeCodesUpdater", `no App/*.swift calls LeCodesUpdater.activeBundle() — downloaded updates would never run; see "Over-the-air updates" in ios/README.md for the ViewController snippet`, false);
   }
   const asc = readJson(join21(homedir7(), ".lecodes", "asc.json"));
@@ -221519,7 +221676,7 @@ var app = async (args) => {
 init_api();
 init_config();
 init_manifest();
-import { existsSync as existsSync22, mkdirSync as mkdirSync16, readdirSync as readdirSync11 } from "node:fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync16, readdirSync as readdirSync12 } from "node:fs";
 import { resolve as resolve9 } from "node:path";
 init_types4();
 init_ignore();
@@ -221542,7 +221699,7 @@ var clone3 = async (args) => {
   const project = await getProject(apiUrl, token, uuid);
   const dir = args._[1] ?? slug(project.name);
   const root = resolve9(dir);
-  if (existsSync22(root) && readdirSync11(root).length > 0) {
+  if (existsSync22(root) && readdirSync12(root).length > 0) {
     throw new CliError(`Directory "${dir}" already exists and is not empty.`);
   }
   mkdirSync16(root, { recursive: true });
@@ -221568,7 +221725,7 @@ init_config();
 init_manifest();
 init_types4();
 init_ignore();
-import { existsSync as existsSync23, mkdirSync as mkdirSync17, readdirSync as readdirSync12, writeFileSync as writeFileSync18 } from "node:fs";
+import { existsSync as existsSync23, mkdirSync as mkdirSync17, readdirSync as readdirSync13, writeFileSync as writeFileSync18 } from "node:fs";
 import { join as join23, resolve as resolve10 } from "node:path";
 
 // src/commands/projectTemplates.ts
@@ -221591,7 +221748,7 @@ lecodes render src/screens/cart.ts   # ONE screen module, without booting the ap
                                   # --state <name> picks the branch). Same flags as above.
 lecodes render --desktop --png shot.png  # NATIVE render: real Filament 3D + UI + 2D composited —
                                   # use this to SEE 3D scenes / procedural geometry (headless
-                                  # renders record 3D as JSON only). Windows/Linux; downloads
+                                  # renders record 3D as JSON — simulated, not drawn). Windows/Linux; downloads
                                   # the renderer on first use. --frames <n> for slow loads.
 lecodes render --script <file>    # drive the app through a scenario (format below)
 lecodes render --desktop --view iso --png iso.png   # 3D: inspection camera fitted to the WHOLE
@@ -221640,8 +221797,9 @@ advance in fixed 1/60 steps driven by \`wait\`/\`frames\`/\`drag\`/\`key\` — n
 so a flow that passes once passes every time. \`Input.key(code)\` reads the keys a flow holds and
 \`Input.on('keydown' | 'keyup', e => e.code)\` fires for each \`key\`/\`keyDown\`/\`keyUp\` step
 (events land before the next loop tick); \`stick\` values are what \`Input.gamepad(0).axis()\` reads.
-Headless draws UI + the 2D scene (sprites, tilemaps, Box2D); 3D is captured as JSON and Jolt does
-not simulate — use \`--desktop\` for 3D pixels. \`console.log\` + \`expect.log\` is the assertion
+Headless draws UI + the 2D scene (sprites, tilemaps, Box2D); 3D is captured as JSON with REAL Jolt
+physics (bodies fall, characters collide, triggers fire, ragdolls drop — a character with no ground
+under it falls, like on device) — use \`--desktop\` for 3D pixels. \`console.log\` + \`expect.log\` is the assertion
 channel for game state that has no UI.
 
 ## Make the app testable
@@ -221660,7 +221818,7 @@ channel for game state that has no UI.
 ## SDK documentation
 
 \`.lecodes/types/\` is the exact API surface (signatures only; generated and gitignored — run
-\`lecodes types\` if it's missing, never commit \`.lecodes/\`). For semantics and examples,
+\`lecodes update\` if it's missing, never commit \`.lecodes/\`). For semantics and examples,
 fetch the docs — they are served as raw markdown for AI tools:
 
 - https://le.codes/llms.txt — the docs map; fetch it first to find the right page
@@ -221710,7 +221868,7 @@ var create = async (args) => {
     throw new CliError("Usage: lecodes create <name> [directory]");
   const dir = args._[1] ?? slug2(name);
   const root = resolve10(dir);
-  if (existsSync23(root) && readdirSync12(root).length > 0) {
+  if (existsSync23(root) && readdirSync13(root).length > 0) {
     throw new CliError(`Directory "${dir}" already exists and is not empty.`);
   }
   mkdirSync17(root, { recursive: true });
@@ -221733,6 +221891,7 @@ var create = async (args) => {
 // src/commands/desktop.ts
 init_util();
 init_manifest();
+import { basename as basename9 } from "node:path";
 var resolveScale = (flag, cfg) => {
   const raw = flag ?? cfg;
   if (raw === undefined || raw === "system")
@@ -221766,9 +221925,13 @@ var run = async (args) => {
   const renderer = resolveDesktopRenderer(root, args);
   const { js, resources } = await buildBundle(args, undefined, { localAssets: true, desktopRenderer: renderer });
   assertRendererSupportsBundle(renderer, js);
+  const { dirs: pluginDirs, files: pluginFiles } = desktopPluginLibraries(root);
+  if (pluginFiles.length > 0)
+    note(`Native plugins: ${pluginFiles.map((f3) => basename9(f3)).join(", ")}`);
   note(`Launching LeCodes Desktop${renderer === "vulkan" ? " (Vulkan)" : ""}… (close the window to return)`);
   await runDesktopApp(js, resources, {
     renderer,
+    pluginDirs,
     width: Number(flagStr(args, "width")) || win?.width,
     height: Number(flagStr(args, "height")) || win?.height,
     minWidth: win?.minWidth,
@@ -221822,15 +221985,15 @@ init_design();
 // src/commands/dev.ts
 init_manifest();
 init_ignore();
-import { existsSync as existsSync25, mkdirSync as mkdirSync19, readFileSync as readFileSync22, watch, writeFileSync as writeFileSync20 } from "node:fs";
+import { existsSync as existsSync26, mkdirSync as mkdirSync19, readFileSync as readFileSync22, watch, writeFileSync as writeFileSync20 } from "node:fs";
 import { randomBytes as randomBytes3 } from "node:crypto";
 import { networkInterfaces } from "node:os";
-import { basename as basename11, join as join27 } from "node:path";
+import { basename as basename12, join as join28 } from "node:path";
 
 // src/dev/devServer.ts
 init_localFiles();
 import { createServer as createServer2 } from "node:http";
-import { createReadStream, statSync as statSync9 } from "node:fs";
+import { createReadStream, statSync as statSync10 } from "node:fs";
 import { join as join26 } from "node:path";
 init_projectCompile();
 init_fonts();
@@ -222094,7 +222257,12 @@ var MIME = {
   woff2: "font/woff2",
   json: "application/json",
   txt: "text/plain",
-  js: "text/javascript"
+  js: "text/javascript",
+  mjs: "text/javascript",
+  css: "text/css",
+  html: "text/html",
+  wasm: "application/wasm",
+  map: "application/json"
 };
 var contentType = (path2) => {
   const i2 = path2.lastIndexOf(".");
@@ -222189,22 +222357,58 @@ var startDevServer = async (options) => {
     else if (m.type === "error")
       log2(`[device:error] ${demangle(m.text ?? "")}`);
   };
-  const transportOf = (url) => url.searchParams.get("t") === "poll" ? "poll" : "ws";
+  const transportOf = (url) => {
+    const t2 = url.searchParams.get("t");
+    return t2 === "poll" ? "poll" : t2 === "web" ? "web" : "ws";
+  };
+  const withPrelude = (js, url, v2) => {
+    const transport = transportOf(url);
+    return transport === "web" ? js : js + `
+` + renderPrelude({ origin, base, transport, v: v2 });
+  };
+  const webDir = options.webDir ?? null;
   const handle = async (req, res) => {
     const url = new URL(req.url ?? "/", origin);
     const path2 = url.pathname;
+    if (path2 === "/favicon.ico") {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
     if (!path2.startsWith(base + "/"))
       return sendText(res, 404, "text/plain", "Not found");
     const route = path2.slice(base.length);
     if (route === "/dev.js") {
-      return sendText(res, 200, "text/javascript", devJs + `
-` + renderPrelude({ origin, base, transport: transportOf(url), v: -1 }));
+      return sendText(res, 200, "text/javascript", withPrelude(devJs, url, -1));
     }
     if (route === "/bundle.js") {
       if (bundleJs === null)
         return sendText(res, 503, "text/plain", "No successful compile yet — check the terminal.");
-      return sendText(res, 200, "text/javascript", bundleJs + `
-` + renderPrelude({ origin, base, transport: transportOf(url), v }));
+      res.setHeader("x-lecodes-v", String(v));
+      return sendText(res, 200, "text/javascript", withPrelude(bundleJs, url, v));
+    }
+    if (route === "/web") {
+      res.writeHead(302, { location: `${base}/web/${url.search}` });
+      res.end();
+      return;
+    }
+    if (route.startsWith("/web/")) {
+      if (!webDir)
+        return sendText(res, 404, "text/plain", "No Web Lite runner vendored with this CLI (lecodes-viewer-lite dist-embed).");
+      const rel = route === "/web/" ? "embed.html" : route.slice("/web/".length);
+      if (rel.split("/").some((seg) => seg === ".." || seg === "" || seg === "."))
+        return sendText(res, 400, "text/plain", "Bad path");
+      const abs = join26(webDir, ...rel.split("/"));
+      try {
+        if (!statSync10(abs).isFile())
+          throw new Error("not a file");
+      } catch {
+        return sendText(res, 404, "text/plain", "Not found");
+      }
+      const hashed = rel.startsWith("assets/");
+      res.writeHead(200, { "content-type": contentType(rel), "cache-control": hashed ? "max-age=31536000, immutable" : "no-store" });
+      createReadStream(abs).pipe(res);
+      return;
     }
     if (route === "/version") {
       return sendJson(res, 200, { v });
@@ -222219,7 +222423,7 @@ var startDevServer = async (options) => {
         return sendText(res, 400, "text/plain", "Bad path");
       const abs = join26(shadersCacheDir(root), name2);
       try {
-        if (!statSync9(abs).isFile())
+        if (!statSync10(abs).isFile())
           throw new Error("not a file");
       } catch {
         return sendText(res, 404, "text/plain", "Not found");
@@ -222236,7 +222440,7 @@ var startDevServer = async (options) => {
         return sendText(res, 400, "text/plain", "Bad path");
       }
       const abs = resolveLocalPath(root, key);
-      if (!abs || !statSync9(abs).isFile())
+      if (!abs || !statSync10(abs).isFile())
         return sendText(res, 404, "text/plain", "Not found");
       res.writeHead(200, { "content-type": contentType(key), "cache-control": "no-store" });
       createReadStream(abs).pipe(res);
@@ -222290,6 +222494,7 @@ var startDevServer = async (options) => {
   const boundPort = typeof address === "object" && address !== null ? address.port : options.port;
   return {
     url: `${origin}${base}/dev.js`,
+    webUrl: webDir ? `${origin}${base}/web/` : null,
     base,
     port: boundPort,
     v: () => v,
@@ -222303,7 +222508,25 @@ var startDevServer = async (options) => {
   };
 };
 
+// src/dev/webRunner.ts
+init_distRoot();
+import { existsSync as existsSync25 } from "node:fs";
+import { createRequire as createRequire5 } from "node:module";
+import { dirname as dirname14, join as join27 } from "node:path";
+var resolveWebRunnerDir = () => {
+  const candidates = [join27(distRoot, "runtime", "web")];
+  try {
+    const pkg = createRequire5(import.meta.url).resolve("lecodes-viewer-lite/package.json");
+    candidates.push(join27(dirname14(pkg), "dist-embed"));
+  } catch {}
+  for (const dir of candidates)
+    if (existsSync25(join27(dir, "embed.html")) && existsSync25(join27(dir, "embed.js")))
+      return dir;
+  return null;
+};
+
 // src/commands/dev.ts
+init_browserAuth();
 init_util();
 var DEFAULT_PORT2 = 4499;
 var DEBOUNCE_MS = 120;
@@ -222331,14 +222554,14 @@ var lanCandidates = () => {
   return out.sort((x2, y2) => x2.rank - y2.rank).map(({ address, iface }) => ({ address, iface }));
 };
 var loadDevToken = (root) => {
-  const path2 = join27(root, LECODES_DIR, "dev.json");
+  const path2 = join28(root, LECODES_DIR, "dev.json");
   try {
     const token2 = JSON.parse(readFileSync22(path2, "utf8")).token;
     if (token2 && /^[a-z0-9]{8,}$/.test(token2))
       return token2;
   } catch {}
   const token = randomBytes3(6).toString("hex");
-  mkdirSync19(join27(root, LECODES_DIR), { recursive: true });
+  mkdirSync19(join28(root, LECODES_DIR), { recursive: true });
   writeFileSync20(path2, JSON.stringify({ token }, null, 2) + `
 `);
   return token;
@@ -222364,7 +222587,7 @@ var dev = async (args) => {
     root = process.cwd();
     manifest = null;
   }
-  const name = manifest?.name ?? basename11(root);
+  const name = manifest?.name ?? basename12(root);
   if (typeof globalThis.Bun !== "undefined") {
     warnErr("Running under Bun: the websocket reload channel doesn't work here — run `lecodes dev` with Node (or use ?t=poll on the device URL).");
   }
@@ -222376,6 +222599,10 @@ var dev = async (args) => {
   const alternatives = candidates.filter((c4) => c4.address !== host);
   const origin = `http://${host}:${port}`;
   const token = loadDevToken(root);
+  const webDir = resolveWebRunnerDir();
+  if (flagBool(args, "web") && !webDir) {
+    throw new CliError("No Web Lite runner found for --web: this CLI has no runtime/web (a monorepo checkout needs `bun run build:embed` in packages/viewer-lite).");
+  }
   const server2 = await startDevServer({
     root,
     manifest,
@@ -222384,6 +222611,7 @@ var dev = async (args) => {
     port,
     token,
     entryOverride: flagStr(args, "entry"),
+    webDir,
     log: note
   }).catch((e2) => {
     const msg = e2 instanceof Error ? e2.message : String(e2);
@@ -222452,14 +222680,21 @@ ${result.error}`);
   if (!flagBool(args, "no-qr"))
     await printQr(server2.url);
   log(`Scan the QR with the LeCodes app, or open:  ${c.bold(server2.url)}`);
+  const webLocal = server2.webUrl ? server2.webUrl.replace(`http://${host}:`, "http://localhost:") : null;
+  if (server2.webUrl && webLocal)
+    log(`In the browser (Web Lite):                  ${c.bold(webLocal)}   (LAN: ${server2.webUrl})`);
   note(`Older desktop builds (no websocket bridge): ${server2.url}?t=poll`);
   if (alternatives.length > 0) {
     note(`Device can't reach it? This machine also has ${alternatives.map((a2) => `${a2.address} (${a2.iface})`).join(", ")} — retry with --host <ip>.`);
   }
-  if (existsSync25(join27(root, LECODES_DIR, "manifest.json")))
+  if (existsSync26(join28(root, LECODES_DIR, "manifest.json")))
     note(`Token stored in ${LECODES_DIR}/dev.json (delete it to rotate the URL).`);
   log("");
   log(`Watching ${root} — save a file to hot-reload. Ctrl+C to stop.`);
+  if (flagBool(args, "web") && webLocal) {
+    note("Opening the browser…");
+    openBrowser(webLocal);
+  }
   if (flagBool(args, "desktop")) {
     const appCfg = readAppConfigAt(root);
     const win = appCfg?.desktop?.window;
@@ -222486,7 +222721,7 @@ init_localFiles();
 // src/serverDiff.ts
 init_localFiles();
 import { readFileSync as readFileSync23 } from "node:fs";
-import { basename as basename12 } from "node:path";
+import { basename as basename13 } from "node:path";
 var isTextAsset = (t2) => t2 === "text" || t2 === "shader" || t2 === "scene";
 var computeServerDiff = (project, scan2) => {
   const pathById = buildPaths(project.assets);
@@ -222503,7 +222738,7 @@ var computeServerDiff = (project, scan2) => {
     const server2 = serverByPath.get(path2);
     const local = localByPath.get(path2);
     if (local && !server2) {
-      const text = isTextKind(classifyKind(basename12(path2)));
+      const text = isTextKind(classifyKind(basename13(path2)));
       entries.push({ path: path2, status: "added", binary: !text, serverText: "", localText: text ? readFileSync23(local.absPath, "utf8") : undefined });
       continue;
     }
@@ -222678,8 +222913,8 @@ var statusLabel = (e2) => e2.status === "added" ? c.green("  added    ") : e2.st
 init_manifest();
 init_types4();
 init_ignore();
-import { existsSync as existsSync26, mkdirSync as mkdirSync20, writeFileSync as writeFileSync21 } from "node:fs";
-import { basename as basename13, dirname as dirname14, join as join28, resolve as resolve11 } from "node:path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync20, writeFileSync as writeFileSync21 } from "node:fs";
+import { basename as basename14, dirname as dirname15, join as join29, resolve as resolve11 } from "node:path";
 init_util();
 var STARTER2 = `// Welcome to LeCodes — the whole SDK is available as globals, no imports needed.
 // Run it live on a device with \`lecodes dev\`, or bundle it with \`lecodes compile -o app.js\`.
@@ -222777,9 +223012,9 @@ lecodes app open             # open it in Xcode, build & run
 - \`CLAUDE.md\` — guidance for AI assistants (the headless feedback loop + testability conventions)
 - \`assets/\` — images/fonts the app references (created on demand)
 - \`tsconfig.json\` + \`.lecodes/types/\` — generated IDE types (rewritten by the CLI; don't edit).
-  They come from the SDK bundled in the CLI; \`lecodes types\` refreshes them from the platform.
+  They come from the SDK bundled in the CLI; \`lecodes update\` refreshes them from the platform.
 - \`.lecodes/\` is gitignored — per-checkout state (those types + \`manifest.json\`, this machine's
-  sync cursor once linked). After a fresh git clone: \`lecodes types\`, then
+  sync cursor once linked). After a fresh git clone: \`lecodes update\`, then
   \`lecodes link --project <uuid>\` to re-attach.
 - \`.lecodesignore\` — files a future \`lecodes push\` would skip
 
@@ -222788,16 +223023,16 @@ Full command list: \`lecodes --help\`.
 var init2 = async (args) => {
   const dirArg = (args._[0] ?? ".").replace(/[/\\]+$/, "") || ".";
   const root = resolve11(dirArg);
-  const name = basename13(root);
+  const name = basename14(root);
   mkdirSync20(root, { recursive: true });
   let created = 0;
   const write = (rel, content) => {
-    const abs = join28(root, rel);
-    if (existsSync26(abs)) {
+    const abs = join29(root, rel);
+    if (existsSync27(abs)) {
       note(`kept      ${rel}`);
       return;
     }
-    mkdirSync20(dirname14(abs), { recursive: true });
+    mkdirSync20(dirname15(abs), { recursive: true });
     writeFileSync21(abs, content);
     log(`${c.green("created")}   ${rel}`);
     created++;
@@ -222845,8 +223080,8 @@ init_config();
 init_ignore();
 init_localFiles();
 init_manifest();
-import { existsSync as existsSync27 } from "node:fs";
-import { basename as basename15, join as join29, resolve as resolve12 } from "node:path";
+import { existsSync as existsSync28 } from "node:fs";
+import { basename as basename16, join as join30, resolve as resolve12 } from "node:path";
 init_types4();
 init_util();
 
@@ -222855,7 +223090,7 @@ init_api();
 init_config();
 init_manifest();
 init_localFiles();
-import { basename as basename14 } from "node:path";
+import { basename as basename15 } from "node:path";
 import { readFileSync as readFileSync24 } from "node:fs";
 init_util();
 var push = async (args) => {
@@ -222912,14 +223147,14 @@ var push = async (args) => {
   let uploaded = 0;
   for (const file of scan2.files) {
     const source = sourceFor(file.path);
-    const kind = source?.type ?? classifyKind(basename14(file.path));
+    const kind = source?.type ?? classifyKind(basename15(file.path));
     const entry = { path: file.path, type: kind };
     if (source)
       entry.assetId = source.id;
     if (isTextKind(kind)) {
       entry.text = readFileSync24(file.absPath, "utf8");
     } else if (!source || source.sha !== file.sha) {
-      const blob = await uploadBlob(apiUrl, token, manifest.uuid, basename14(file.path), readFileSync24(file.absPath));
+      const blob = await uploadBlob(apiUrl, token, manifest.uuid, basename15(file.path), readFileSync24(file.absPath));
       entry.blobFileId = blob.id;
       uploaded++;
     }
@@ -223027,9 +223262,9 @@ var link = async (args) => {
   const token = requireToken(config);
   const dirArg = args._[0];
   const root = dirArg ? resolve12(dirArg) : process.cwd();
-  if (!existsSync27(root))
+  if (!existsSync28(root))
     throw new CliError(`No such directory: ${root}`);
-  if (existsSync27(join29(root, LECODES_DIR, "manifest.json")) && !flagBool(args, "force")) {
+  if (existsSync28(join30(root, LECODES_DIR, "manifest.json")) && !flagBool(args, "force")) {
     throw new CliError("This folder is already linked (.lecodes/manifest.json exists) — use `lecodes push`, or `lecodes link --force` to re-link it to another project.");
   }
   let enclosing = null;
@@ -223056,7 +223291,7 @@ var link = async (args) => {
     }
     name = project.name;
   } else {
-    name = flagStr(args, "name") ?? basename15(root);
+    name = flagStr(args, "name") ?? basename16(root);
     info(c.dim(`Creating project ${c.bold(name)}…`));
     uuid = (await createProject(apiUrl, token, name, flagStr(args, "team"))).uuid;
     files = {};
@@ -223093,10 +223328,10 @@ var link = async (args) => {
 
 // src/commands/lightmap.ts
 init_manifest();
-import { existsSync as existsSync28, mkdirSync as mkdirSync21, mkdtempSync as mkdtempSync4, rmSync as rmSync9, statSync as statSync10, unlinkSync, writeFileSync as writeFileSync22 } from "node:fs";
-import { spawnSync as spawnSync6 } from "node:child_process";
+import { existsSync as existsSync29, mkdirSync as mkdirSync21, mkdtempSync as mkdtempSync4, readFileSync as readFileSync25, renameSync as renameSync3, rmSync as rmSync9, statSync as statSync11, unlinkSync, writeFileSync as writeFileSync22 } from "node:fs";
+import { spawn as spawn6, spawnSync as spawnSync6 } from "node:child_process";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join30, relative as relative4, resolve as resolve13 } from "node:path";
+import { join as join31, relative as relative4, resolve as resolve13 } from "node:path";
 init_util();
 var num = (args, key, fallback, min, max) => {
   const raw = flagStr(args, key);
@@ -223109,13 +223344,13 @@ var num = (args, key, fallback, min, max) => {
 };
 var findToktx = () => {
   const env = process.env.KTX_TOKTX;
-  if (env && existsSync28(env))
+  if (env && existsSync29(env))
     return env;
-  for (const base of [process.env.LOCALAPPDATA && join30(process.env.LOCALAPPDATA, "Programs"), process.env.ProgramFiles]) {
+  for (const base of [process.env.LOCALAPPDATA && join31(process.env.LOCALAPPDATA, "Programs"), process.env.ProgramFiles]) {
     if (!base)
       continue;
-    const guess = join30(base, "KTX-Software", "bin", "toktx.exe");
-    if (existsSync28(guess))
+    const guess = join31(base, "KTX-Software", "bin", "toktx.exe");
+    if (existsSync29(guess))
       return guess;
   }
   return "toktx";
@@ -223136,14 +223371,26 @@ var requireToktx = () => {
   }
   return toktx;
 };
-var encodeKtx2 = (toktx, png2, ktx2) => {
+var encodeKtx2 = (toktx, png2, ktx2) => new Promise((resolve14, reject) => {
   const args = ["--t2", "--encode", "uastc", "--uastc_quality", "2", "--zcmp", "18", "--genmipmap", "--assign_oetf", "srgb", ktx2, png2];
-  const p2 = spawnSync6(toktx, args, { encoding: "utf8" });
-  if (p2.status !== 0) {
-    throw new CliError(`toktx failed (${p2.status ?? p2.error?.message ?? "?"}) while encoding ${ktx2}:
-${(p2.stderr || p2.stdout || "").trim()}`);
-  }
-};
+  const p2 = spawn6(toktx, args, { stdio: ["ignore", "pipe", "pipe"] });
+  let out = "";
+  p2.stdout.on("data", (d) => {
+    out += String(d);
+  });
+  p2.stderr.on("data", (d) => {
+    out += String(d);
+  });
+  p2.on("error", (e2) => reject(new CliError(`toktx failed (${e2.message}) while encoding ${ktx2}`)));
+  p2.on("close", (status2) => {
+    if (status2 === 0)
+      resolve14();
+    else
+      reject(new CliError(`toktx failed (${status2 ?? "?"}) while encoding ${ktx2}:
+${out.trim()}`));
+  });
+});
+var pageFile = (stem, page, light, ext2 = ".ktx2") => `${stem}${light ? "-light" : ""}${page > 0 ? `_${page}` : ""}${ext2}`;
 var bake = async (args) => {
   let root;
   try {
@@ -223153,20 +223400,31 @@ var bake = async (args) => {
   }
   const toktx = requireToktx();
   const outDir = resolve13(root, flagStr(args, "out") ?? "assets/lightmap");
+  const stem = flagStr(args, "name") ?? "lightmap";
+  if (!/^[A-Za-z0-9_-]+$/.test(stem))
+    throw new CliError(`--name wants a plain file stem (letters, digits, - and _), got "${stem}".`);
   const entryFlag = flagStr(args, "entry");
   const entryFile = entryFlag ?? "main.ts";
-  if (!existsSync28(resolve13(root, entryFile))) {
+  if (!existsSync29(resolve13(root, entryFile))) {
     throw new CliError(`No ${entryFile} in ${root} — pass --entry <file> (the file that builds the scene and calls Lightmap.load).`);
   }
   const cfg = {
     outDir: outDir.replace(/\\/g, "/"),
     size: num(args, "size", 4096, 256, 16384),
     texel: num(args, "texel", 0.02, 0.001, 2),
+    pages: num(args, "pages", 4, 1, 16),
     sunRays: num(args, "sun-rays", 32, 1, 1024),
     aoRays: num(args, "ao-rays", 64, 1, 4096),
     aoDistance: num(args, "ao-distance", 2, 0.01, 1000),
     bias: num(args, "bias", 0.02, 0.0001, 1),
     sunAngle: num(args, "sun-angle", 0.5, 0.01, 30),
+    lightRays: num(args, "light-rays", 16, 1, 256),
+    lightRadius: num(args, "light-radius", 0.1, 0.001, 5),
+    bounce: num(args, "bounce", 0, 0, 1),
+    bounceDistance: num(args, "bounce-distance", 8, 0.5, 100),
+    bounceRays: num(args, "bounce-rays", 1, 1, 32),
+    coplanarSkip: num(args, "coplanar-skip", 0.05, 0, 1),
+    denoise: num(args, "denoise", 2, 0, 4),
     volumeCell: flagBool(args, "no-volume") ? 0 : num(args, "cell", 0.5, 0.05, 20)
   };
   const frames = num(args, "frames", 900, 30, 1e5);
@@ -223180,7 +223438,7 @@ var bake = async (args) => {
 import ${JSON.stringify(importPath)}
 `;
   mkdirSync21(outDir, { recursive: true });
-  ensurePlaceholders(outDir);
+  ensurePlaceholders(outDir, stem);
   const desktopRenderer = resolveDesktopRenderer(root, args);
   const { js, resources } = await buildBundle(args, undefined, {
     localAssets: true,
@@ -223188,12 +223446,12 @@ import ${JSON.stringify(importPath)}
     extraEntries: [{ path: entryPath, type: "text", text: entryText }],
     entryOverride: entryPath
   });
-  const scratch = mkdtempSync4(join30(tmpdir4(), "lecodes-lightmap-"));
-  const outPng = join30(scratch, "frame.png");
-  note(`Baking ${cfg.size}² at ${(cfg.texel * 100).toFixed(1)} cm texels (${cfg.sunRays} sun + ${cfg.aoRays} AO rays)${cfg.volumeCell ? ` + a ${cfg.volumeCell} m light volume` : ""} → ${relative4(root, outDir) || "."}…`);
+  const scratch = mkdtempSync4(join31(tmpdir4(), "lecodes-lightmap-"));
+  const outPng = join31(scratch, "frame.png");
+  note(`Baking up to ${cfg.pages} × ${cfg.size}² at ${(cfg.texel * 100).toFixed(1)} cm texels (${cfg.sunRays} sun + ${cfg.aoRays} AO + ${cfg.lightRays} light rays)${cfg.volumeCell ? ` + a ${cfg.volumeCell} m light volume` : ""} → ${relative4(root, outDir) || "."}/${stem}.*…`);
   let output = "";
   try {
-    const timeoutMs = Number(flagStr(args, "timeout")) || 600000;
+    const timeoutMs = Number(flagStr(args, "timeout")) || 24 * 3600 * 1000;
     const res = await runDesktopRender(js, resources, {
       renderer: desktopRenderer,
       width,
@@ -223211,28 +223469,76 @@ import ${JSON.stringify(importPath)}
       throw e2;
     output = msg;
   } finally {
-    rmSync9(scratch, { recursive: true, force: true });
+    try {
+      rmSync9(scratch, { recursive: true, force: true });
+    } catch {}
   }
   const lines = output.split(/\r?\n/).filter((l2) => l2.startsWith("[lightmap]"));
   for (const l2 of lines) {
     const text = l2.slice("[lightmap]".length).trim();
     if (text === "done")
       continue;
-    logErr(text.startsWith("error") ? c.red(`✗ ${text}`) : c.dim(`  ${text}`));
+    logErr(text.startsWith("error") ? c.red(`✗ ${text}`) : text.startsWith("warning") ? c.yellow(`  ${text}`) : c.dim(`  ${text}`));
   }
   if (/\[lightmap\] done/.test(output)) {
-    const png2 = join30(outDir, "lightmap.png");
-    const ktx2 = join30(outDir, "lightmap.ktx2");
-    if (!existsSync28(png2))
-      throw new CliError(`The host reported a bake but ${png2} is missing.`);
+    const bakePath = join31(outDir, "lightmap.bake");
+    if (!existsSync29(bakePath))
+      throw new CliError(`The host reported a bake but ${bakePath} is missing.`);
+    const data = JSON.parse(readFileSync25(bakePath, "utf8"));
+    const pages = Math.max(1, data.pages ?? 1);
+    const hasLight = !!data.lightTextures?.length;
     const t0 = Date.now();
-    encodeKtx2(toktx, png2, ktx2);
-    const pngKb = Math.round(statSync10(png2).size / 1024), ktxKb = Math.round(statSync10(ktx2).size / 1024);
-    unlinkSync(png2);
-    logErr(c.dim(`  encoded lightmap.ktx2 (UASTC + mips, ${ktxKb} KB from a ${pngKb} KB raster) in ${((Date.now() - t0) / 1000).toFixed(1)} s`));
-    const hasVolume = cfg.volumeCell > 0 && existsSync28(join30(outDir, "lightmap.volume"));
-    logErr(c.green(`✓ baked → ${relative4(root, outDir) || "."}/lightmap.ktx2 + lightmap.bake${hasVolume ? " + lightmap.volume" : ""}`));
-    logErr(c.dim(`  apply it with Lightmap.load(scene, { data: asset('<rel>/${relative4(root, join30(outDir, "lightmap.bake")).replace(/\\/g, "/")}'), texture: asset('<rel>/${relative4(root, ktx2).replace(/\\/g, "/")}')${hasVolume ? `, volume: asset('<rel>/${relative4(root, join30(outDir, "lightmap.volume")).replace(/\\/g, "/")}')` : ""} })  — asset() paths are relative to the calling file`));
+    let pngKb = 0, ktxKb = 0;
+    const encodePage = async (page, light) => {
+      const png2 = join31(outDir, pageFile("lightmap", page, light, ".png"));
+      const ktx2 = join31(outDir, pageFile(stem, page, light));
+      if (!existsSync29(png2))
+        throw new CliError(`The host reported a bake but ${png2} is missing.`);
+      await encodeKtx2(toktx, png2, ktx2);
+      pngKb += statSync11(png2).size / 1024;
+      ktxKb += statSync11(ktx2).size / 1024;
+      unlinkSync(png2);
+    };
+    const encodes = [];
+    for (let p2 = 0;p2 < pages; p2++) {
+      encodes.push(encodePage(p2, false));
+      if (hasLight)
+        encodes.push(encodePage(p2, true));
+    }
+    await Promise.all(encodes);
+    for (let p2 = pages;p2 < 16; p2++) {
+      for (const light of [false, true]) {
+        const stale = join31(outDir, pageFile(stem, p2, light));
+        if (existsSync29(stale) && statSync11(stale).size !== PLACEHOLDER_KTX2.length)
+          writeFileSync22(stale, PLACEHOLDER_KTX2);
+      }
+    }
+    if (!hasLight) {
+      const light = join31(outDir, pageFile(stem, 0, true));
+      if (existsSync29(light) && statSync11(light).size !== PLACEHOLDER_KTX2.length)
+        writeFileSync22(light, PLACEHOLDER_KTX2);
+    }
+    data.texture = pageFile(stem, 0, false);
+    data.textures = Array.from({ length: pages }, (_, p2) => pageFile(stem, p2, false));
+    if (hasLight)
+      data.lightTextures = Array.from({ length: pages }, (_, p2) => pageFile(stem, p2, true));
+    if (data.volume)
+      data.volume.file = `${stem}.volume`;
+    writeFileSync22(join31(outDir, `${stem}.bake`), JSON.stringify(data, null, 1) + `
+`);
+    if (stem !== "lightmap")
+      unlinkSync(bakePath);
+    const volumeSrc = join31(outDir, "lightmap.volume");
+    const hasVolume = cfg.volumeCell > 0 && existsSync29(volumeSrc);
+    if (hasVolume && stem !== "lightmap") {
+      rmSync9(join31(outDir, `${stem}.volume`), { force: true });
+      renameSync3(volumeSrc, join31(outDir, `${stem}.volume`));
+    }
+    logErr(c.dim(`  encoded ${pages} page(s)${hasLight ? " + the light atlas" : ""} (UASTC + mips, ${Math.round(ktxKb)} KB from ${Math.round(pngKb)} KB of rasters) in ${((Date.now() - t0) / 1000).toFixed(1)} s`));
+    logErr(c.green(`✓ baked → ${relative4(root, outDir) || "."}/${stem}.bake + ${data.textures.join(", ")}${hasLight ? ` + ${data.lightTextures.join(", ")}` : ""}${hasVolume ? ` + ${stem}.volume` : ""}`));
+    const rel = (f3) => relative4(root, join31(outDir, f3)).replace(/\\/g, "/");
+    const assets = (files) => files.length === 1 ? `asset('<rel>/${rel(files[0])}')` : `[${files.map((f3) => `asset('<rel>/${rel(f3)}')`).join(", ")}]`;
+    logErr(c.dim(`  scene file: env.lightmap: { data: asset('<rel>/${rel(`${stem}.bake`)}'), texture: ${assets(data.textures)}${hasLight ? `, light: ${assets(data.lightTextures)}` : ""}${hasVolume ? `, volume: asset('<rel>/${rel(`${stem}.volume`)}')` : ""} }  — asset() paths are relative to the scene file`));
     return;
   }
   if (lines.some((l2) => /no bake module/.test(l2))) {
@@ -223259,30 +223565,34 @@ var placeholderVolume = () => {
   b[37] = 255;
   return b;
 };
-var ensurePlaceholders = (outDir) => {
-  const bake2 = join30(outDir, "lightmap.bake");
-  const ktx2 = join30(outDir, "lightmap.ktx2");
-  const volume = join30(outDir, "lightmap.volume");
-  if (!existsSync28(bake2))
-    writeFileSync22(bake2, JSON.stringify({ version: 1, placeholder: true, size: 1, texel: 0, instances: [] }) + `
+var ensurePlaceholders = (outDir, stem) => {
+  const missing = (f3) => !existsSync29(f3) || statSync11(f3).size === 0;
+  const bake2 = join31(outDir, `${stem}.bake`);
+  const ktx2 = join31(outDir, pageFile(stem, 0, false));
+  const light = join31(outDir, pageFile(stem, 0, true));
+  const volume = join31(outDir, `${stem}.volume`);
+  if (missing(bake2))
+    writeFileSync22(bake2, JSON.stringify({ version: 2, placeholder: true, size: 1, texel: 0, pages: 1, instances: [] }) + `
 `);
-  if (!existsSync28(ktx2))
+  if (missing(ktx2))
     writeFileSync22(ktx2, PLACEHOLDER_KTX2);
-  if (!existsSync28(volume))
+  if (missing(light))
+    writeFileSync22(light, PLACEHOLDER_KTX2);
+  if (missing(volume))
     writeFileSync22(volume, placeholderVolume());
 };
 var lightmap = async (args) => {
   const sub = args._[0];
   if (sub === "bake")
     return bake({ ...args, _: args._.slice(1) });
-  throw new CliError("Usage: lecodes lightmap bake [--out assets/lightmap] [--size 4096] [--texel 0.02] [--sun-rays 32] [--ao-rays 64] [--ao-distance 2] [--bias 0.02] [--sun-angle 0.5] [--cell 0.5 | --no-volume] [--frames 900] [--entry main.ts] [--logs]   (needs KTX-Software's toktx)");
+  throw new CliError("Usage: lecodes lightmap bake [--out assets/lightmap] [--name lightmap] [--size 4096] [--pages 4] [--texel 0.02] [--sun-rays 32] [--ao-rays 64] [--ao-distance 2] [--bias 0.02] [--sun-angle 0.5] [--light-rays 16] [--light-radius 0.1] [--bounce 0..1] [--denoise 2] [--cell 0.5 | --no-volume] [--frames 900] [--timeout <ms>] [--entry main.ts] [--logs]   (needs KTX-Software's toktx)");
 };
 
 // src/commands/navmesh.ts
 init_manifest();
-import { existsSync as existsSync29, mkdirSync as mkdirSync22, mkdtempSync as mkdtempSync5, readdirSync as readdirSync14, readFileSync as readFileSync25, rmSync as rmSync10, statSync as statSync11, unlinkSync as unlinkSync2, writeFileSync as writeFileSync23 } from "node:fs";
+import { existsSync as existsSync30, mkdirSync as mkdirSync22, mkdtempSync as mkdtempSync5, readdirSync as readdirSync15, readFileSync as readFileSync26, rmSync as rmSync10, statSync as statSync12, unlinkSync as unlinkSync2, writeFileSync as writeFileSync23 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { basename as basename16, join as join31, relative as relative5, resolve as resolve14 } from "node:path";
+import { basename as basename17, join as join32, relative as relative5, resolve as resolve14 } from "node:path";
 init_util();
 
 // ../creator-nav/dist/creatorNav.js
@@ -223299,8 +223609,8 @@ var createCreatorNav = (() => {
     var ENVIRONMENT_IS_WORKER = typeof WorkerGlobalScope != "undefined";
     var ENVIRONMENT_IS_NODE = typeof process == "object" && process.versions?.node && process.type != "renderer";
     if (ENVIRONMENT_IS_NODE) {
-      const { createRequire: createRequire4 } = await import("module");
-      var require2 = createRequire4(import.meta.url);
+      const { createRequire: createRequire6 } = await import("module");
+      var require2 = createRequire6(import.meta.url);
     }
     var arguments_ = [];
     var thisProgram = "./this.program";
@@ -224079,13 +224389,13 @@ var num2 = (args, key, fallback, min, max) => {
   return n2;
 };
 var guessName = (root) => {
-  const dirs = [join31(root, "src"), root];
+  const dirs = [join32(root, "src"), root];
   for (const dir of dirs) {
-    if (!existsSync29(dir))
+    if (!existsSync30(dir))
       continue;
     let entries;
     try {
-      entries = readdirSync14(dir);
+      entries = readdirSync15(dir);
     } catch {
       continue;
     }
@@ -224093,7 +224403,7 @@ var guessName = (root) => {
       if (!f3.endsWith(".scene.ts"))
         continue;
       try {
-        if (/\bnavmesh\s*:/.test(readFileSync25(join31(dir, f3), "utf8")))
+        if (/\bnavmesh\s*:/.test(readFileSync26(join32(dir, f3), "utf8")))
           return f3.slice(0, -".scene.ts".length);
       } catch {}
     }
@@ -224136,7 +224446,7 @@ var bake2 = async (args) => {
   const outDir = resolve14(root, flagStr(args, "out") ?? "assets/nav");
   const entryFlag = flagStr(args, "entry");
   const entryFile = entryFlag ?? "main.ts";
-  if (!existsSync29(resolve14(root, entryFile))) {
+  if (!existsSync30(resolve14(root, entryFile))) {
     throw new CliError(`No ${entryFile} in ${root} — pass --entry <file> (the file that builds the level: a scene file with env.navmesh, or code calling NavMesh.load).`);
   }
   const name = flagStr(args, "name") ?? guessName(root) ?? "scene";
@@ -224148,8 +224458,8 @@ var bake2 = async (args) => {
   const keepGeometry = flagBool(args, "keep-geometry");
   const obj = flagBool(args, "obj");
   mkdirSync22(outDir, { recursive: true });
-  const navmeshPath = join31(outDir, `${name}.navmesh`);
-  if (!existsSync29(navmeshPath))
+  const navmeshPath = join32(outDir, `${name}.navmesh`);
+  if (!existsSync30(navmeshPath))
     writeFileSync23(navmeshPath, placeholderLnav());
   const importPath = "./" + entryFile.replace(/\\/g, "/").replace(/\.tsx?$/, "");
   const entryPath = "/.navmesh-entry.ts";
@@ -224164,8 +224474,8 @@ import ${JSON.stringify(importPath)}
     extraEntries: [{ path: entryPath, type: "text", text: entryText }],
     entryOverride: entryPath
   });
-  const scratch = mkdtempSync5(join31(tmpdir5(), "lecodes-navmesh-"));
-  const outPng = join31(scratch, "frame.png");
+  const scratch = mkdtempSync5(join32(tmpdir5(), "lecodes-navmesh-"));
+  const outPng = join32(scratch, "frame.png");
   note(`Dumping the level's static collision geometry through the desktop host → ${relative5(root, outDir) || "."}/${name}.navgeo…`);
   let output = "";
   try {
@@ -224218,10 +224528,10 @@ import ${JSON.stringify(importPath)}
   }
   if (!config)
     throw new CliError("The host reported a dump but no `[navmesh] config` line — SDK/host mismatch?");
-  const geoPath = join31(outDir, `${name}.navgeo`);
-  if (!existsSync29(geoPath))
+  const geoPath = join32(outDir, `${name}.navgeo`);
+  if (!existsSync30(geoPath))
     throw new CliError(`The host reported a dump but ${geoPath} is missing.`);
-  const geo = readNgeo(new Uint8Array(readFileSync25(geoPath)));
+  const geo = readNgeo(new Uint8Array(readFileSync26(geoPath)));
   const params = {
     agentRadius: num2(args, "radius", config.agent.radius, 0.05, 10),
     agentHeight: num2(args, "height", config.agent.height, 0.1, 20),
@@ -224269,18 +224579,18 @@ import ${JSON.stringify(importPath)}
   }
   writeFileSync23(navmeshPath, result.data);
   if (obj) {
-    const objPath = join31(outDir, `${name}.navmesh.obj`);
+    const objPath = join32(outDir, `${name}.navmesh.obj`);
     writeObj(objPath, navMeshTriangles(mod, result.data));
     logErr(c.dim(`  wrote ${relative5(root, objPath)} (the polygon mesh, for inspection)`));
   }
   if (!keepGeometry)
     unlinkSync2(geoPath);
-  const kb = Math.round(statSync11(navmeshPath).size / 1024);
+  const kb = Math.round(statSync12(navmeshPath).size / 1024);
   const b = result.bounds;
   logErr(c.dim(`  ${result.tiles} tiles, ${result.polys} polygons, ${(b.max[0] - b.min[0]).toFixed(0)} × ${(b.max[2] - b.min[2]).toFixed(0)} m, ${result.time.toFixed(1)} s`));
   logErr(c.green(`✓ baked → ${relative5(root, navmeshPath).replace(/\\/g, "/")} (${kb} KB)`));
   if (!config.data) {
-    logErr(c.dim(`  load it with env.navmesh: { data: asset('<rel>/${basename16(navmeshPath)}') } in the scene file, or NavMesh.load(scene, { data: asset(...) })`));
+    logErr(c.dim(`  load it with env.navmesh: { data: asset('<rel>/${basename17(navmeshPath)}') } in the scene file, or NavMesh.load(scene, { data: asset(...) })`));
   }
 };
 var navmesh = async (args) => {
@@ -224307,7 +224617,7 @@ var login = async (args) => {
 
 // src/commands/shaders.ts
 init_manifest();
-import { readFileSync as readFileSync26 } from "node:fs";
+import { readFileSync as readFileSync27 } from "node:fs";
 init_util();
 init_compile();
 var collectShaders = () => {
@@ -224339,7 +224649,7 @@ var status2 = async () => {
       if (matcId === null)
         state = c.dim("unknown (matc not downloaded)");
       else {
-        const text = readFileSync26(shader.absPath, "utf8");
+        const text = readFileSync27(shader.absPath, "utf8");
         if (shaderIsCompiled(root, text, matcId))
           state = "compiled";
         else {
@@ -224348,7 +224658,7 @@ var status2 = async () => {
         }
       }
       log(`  ${shader.path.padEnd(width)}  ${state}`);
-      const schema = parseShaderSchema(readFileSync26(shader.absPath, "utf8"));
+      const schema = parseShaderSchema(readFileSync27(shader.absPath, "utf8"));
       for (const p2 of schema.params) {
         const range = p2.min !== undefined ? ` [${p2.min}..${p2.max}]` : "";
         const def = p2.default !== null && p2.default !== undefined ? ` = ${JSON.stringify(p2.default)}` : "";
@@ -224391,7 +224701,7 @@ var compile3 = async (args) => {
   }
   const matcExe = await resolveMatcExe();
   const matcId = matcIdentity(matcExe);
-  const wasCompiled = new Map(shaders.map((s2) => [s2.path, shaderIsCompiled(root, readFileSync26(s2.absPath, "utf8"), matcId)]));
+  const wasCompiled = new Map(shaders.map((s2) => [s2.path, shaderIsCompiled(root, readFileSync27(s2.absPath, "utf8"), matcId)]));
   const errors2 = [];
   for (const shader of shaders) {
     try {
@@ -224425,8 +224735,8 @@ var shaders = async (args) => {
 };
 
 // src/commands/render.ts
-import { mkdirSync as mkdirSync23, readFileSync as readFileSync28, writeFileSync as writeFileSync24 } from "node:fs";
-import { dirname as dirname15, resolve as resolve17 } from "node:path";
+import { mkdirSync as mkdirSync23, readFileSync as readFileSync29, writeFileSync as writeFileSync24 } from "node:fs";
+import { dirname as dirname16, resolve as resolve17 } from "node:path";
 
 // src/compile/headlessBundle.ts
 init_api();
@@ -224510,8 +224820,8 @@ var compileHeadlessBundle = async (args, opts = {}) => {
 // src/compile/screenEntry.ts
 init_designMeta();
 init_util();
-import { existsSync as existsSync30, readFileSync as readFileSync27, statSync as statSync12 } from "node:fs";
-import { isAbsolute, join as join32, relative as relative6, resolve as resolve15 } from "node:path";
+import { existsSync as existsSync31, readFileSync as readFileSync28, statSync as statSync13 } from "node:fs";
+import { isAbsolute, join as join33, relative as relative6, resolve as resolve15 } from "node:path";
 var SCREEN_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs"];
 var SCREEN_ENTRY_PATH = "/.screen-entry.ts";
 var DEFAULT_DESIGN_DIR = "design";
@@ -224520,13 +224830,13 @@ var hasSeparator = (file) => file.includes("/") || file.includes("\\");
 var findScreenFile = (root, file, dirFlag) => {
   const candidates = [resolve15(process.cwd(), file)];
   if (!hasSeparator(file)) {
-    candidates.push(join32(root, (dirFlag ?? DEFAULT_DESIGN_DIR).replace(/[/\\]+$/, ""), "screens", file));
+    candidates.push(join33(root, (dirFlag ?? DEFAULT_DESIGN_DIR).replace(/[/\\]+$/, ""), "screens", file));
   }
   for (const base of candidates) {
-    if (existsSync30(base) && statSync12(base).isFile())
+    if (existsSync31(base) && statSync13(base).isFile())
       return base;
     for (const ext2 of SCREEN_EXTS)
-      if (existsSync30(base + ext2))
+      if (existsSync31(base + ext2))
         return base + ext2;
   }
   throw new CliError(`No screen file at "${file}".` + (hasSeparator(file) ? "" : ` Pass a path, or a screen id that exists in ${dirFlag ?? DEFAULT_DESIGN_DIR}/screens/.`));
@@ -224535,8 +224845,8 @@ var designDirOf = (root, key) => {
   const m = /^\/(.*)screens\/([^/]+)\.[^./]+$/.exec(key);
   if (!m)
     return null;
-  const dir = join32(root, m[1]);
-  return existsSync30(join32(dir, "meta.json")) ? { dir, id: m[2] } : null;
+  const dir = join33(root, m[1]);
+  return existsSync31(join33(dir, "meta.json")) ? { dir, id: m[2] } : null;
 };
 var resolveScreenTarget = (root, file, opts = {}) => {
   const abs = findScreenFile(root, file, opts.dir);
@@ -224545,7 +224855,7 @@ var resolveScreenTarget = (root, file, opts = {}) => {
     throw new CliError(`"${file}" is outside the project (${root}) — a screen renders as part of its project, so its ` + `imports and asset() files resolve from the same tree.`);
   }
   const key = toKey(rel);
-  if (!/^\s*export\s+default\b/m.test(readFileSync27(abs, "utf8"))) {
+  if (!/^\s*export\s+default\b/m.test(readFileSync28(abs, "utf8"))) {
     throw new CliError(`${key.slice(1)} has no default export. A screen file ends with ` + `\`export default UIScreen([...])\` — or \`export default (state) => UIScreen([...])\` for screen states.`);
   }
   const invoke = opts.state !== undefined ? `screen(${JSON.stringify(opts.state)})` : "screen()";
@@ -224852,7 +225162,7 @@ var evaluateDesktopRun = (plan, output) => {
     if (!error && st.expectLog !== undefined) {
       const seen = consoleLines.slice(0, cutoff);
       if (!seen.some((l2) => l2.includes(st.expectLog))) {
-        const tail = seen.filter((l2) => l2.startsWith("[DEBUG]") || l2.startsWith("[INFO]") || l2.startsWith("[WARN]") || l2.startsWith("[ERROR]")).slice(-3);
+        const tail = seen.filter((l2) => l2.startsWith("[DEBUG]") || l2.startsWith("[INFO]") || l2.startsWith("[WARN]") || l2.startsWith("[ERROR]")).slice(-8);
         error = `expected a console line containing "${st.expectLog}" — ${tail.length === 0 ? "the app logged nothing" : `last lines: ${tail.map((l2) => `"${l2}"`).join(", ")}`}`;
       }
     }
@@ -224895,7 +225205,7 @@ var requireRenderer = async () => {
 var fileScenarioIO = (dir) => ({
   write: (relPath, data) => {
     const abs = resolve17(dir, relPath);
-    mkdirSync23(dirname15(abs), { recursive: true });
+    mkdirSync23(dirname16(abs), { recursive: true });
     writeFileSync24(abs, data);
   }
 });
@@ -224906,7 +225216,7 @@ var resolveFixtures = (value, baseDir) => {
   if (typeof value === "string") {
     const abs = resolve17(baseDir, value);
     try {
-      map = JSON.parse(readFileSync28(abs, "utf8"));
+      map = JSON.parse(readFileSync29(abs, "utf8"));
     } catch (e2) {
       throw new CliError(`Can't read fixtures "${value}": ${e2 instanceof Error ? e2.message : String(e2)}`);
     }
@@ -224919,7 +225229,7 @@ var resolveFixtures = (value, baseDir) => {
 var readScenarioFile = (path2) => {
   let raw;
   try {
-    raw = JSON.parse(readFileSync28(resolve17(path2), "utf8"));
+    raw = JSON.parse(readFileSync29(resolve17(path2), "utf8"));
   } catch (e2) {
     throw new CliError(`Can't read scenario "${path2}": ${e2 instanceof Error ? e2.message : String(e2)}`);
   }
@@ -224970,23 +225280,25 @@ var renderDesktop = async (args) => {
   if ((camera || view) && scenario)
     throw new CliError('--camera/--view apply to a plain render; in a --script run use a { "view": "iso" } or { "camera": { "at", "lookAt" } } step before the screenshot.');
   const desktopRenderer = resolveDesktopRenderer(root, args);
+  const { dirs: pluginDirs } = desktopPluginLibraries(root);
   const { js, resources } = await buildBundle(args, undefined, {
     localAssets: true,
     desktopRenderer,
     extraEntries: screen2 ? [screen2.entry] : undefined,
     entryOverride: screen2?.entryPath
   });
-  mkdirSync23(dirname15(resolve17(pngFlag)), { recursive: true });
+  mkdirSync23(dirname16(resolve17(pngFlag)), { recursive: true });
   if (scenario) {
     const outDir = flagStr(args, "out-dir") ?? ".";
     const plan = translateScenario(scenario.steps, { outDir, headroomFrames: frames });
     for (const st of plan.steps)
       if (st.screenshot)
-        mkdirSync23(dirname15(st.screenshot), { recursive: true });
+        mkdirSync23(dirname16(st.screenshot), { recursive: true });
     const timeoutMs2 = Number(flagStr(args, "timeout")) || 60000 + plan.steps.length * 5000;
     note(`Running ${plan.steps.length} step${plan.steps.length === 1 ? "" : "s"} (native)…`);
     const { output } = await runDesktopRender(js, resources, {
       renderer: desktopRenderer,
+      pluginDirs,
       width,
       height,
       frames: plan.frameCap,
@@ -225019,6 +225331,7 @@ var renderDesktop = async (args) => {
   note(screen2 ? `Rendering ${screen2.label} (native)…` : "Rendering (native)…");
   await runDesktopRender(js, resources, {
     renderer: desktopRenderer,
+    pluginDirs,
     width,
     height,
     frames,
@@ -225086,7 +225399,7 @@ var render = async (args) => {
   const settleStr = flagStr(args, "settle") ?? (scenario?.settle !== undefined ? String(scenario.settle) : undefined);
   const timeStr = flagStr(args, "time");
   const onConsole = flagBool(args, "logs") ? (level, text2) => logErr(`${c.dim(`[${level}]`)} ${text2}`) : undefined;
-  const envelopeFixtures = resolveFixtures(scenario?.fixtures, scriptFlag !== undefined ? dirname15(resolve17(scriptFlag)) : ".");
+  const envelopeFixtures = resolveFixtures(scenario?.fixtures, scriptFlag !== undefined ? dirname16(resolve17(scriptFlag)) : ".");
   const flagFixtures = resolveFixtures(flagStr(args, "fixtures"), ".");
   const fixtures = envelopeFixtures || flagFixtures ? { ...envelopeFixtures, ...flagFixtures } : undefined;
   if (fixtures) {
@@ -225133,6 +225446,26 @@ var render = async (args) => {
       session.dispose();
     }
   }
+  const mapFlag = flagStr(args, "map") ?? (flagBool(args, "map") ? "map.png" : undefined);
+  if (mapFlag !== undefined) {
+    note(`Rendering map…`);
+    const title = root.split(/[\\/]/).pop();
+    const { png: png2, data, warnings: mapWarnings } = await renderer.renderToMap(js, {
+      ...timing,
+      maxPx: Number(flagStr(args, "max-px")) || undefined,
+      title,
+      labelAll: flagBool(args, "label-all")
+    });
+    for (const w of [...warnings, ...mapWarnings])
+      warnErr(w);
+    const pngPath = mapFlag.endsWith(".png") ? mapFlag : mapFlag + ".png";
+    mkdirSync23(dirname16(resolve17(pngPath)), { recursive: true });
+    writeFileSync24(resolve17(pngPath), png2);
+    const jsonPath = pngPath.slice(0, -4) + ".json";
+    writeFileSync24(resolve17(jsonPath), JSON.stringify(data, null, 2));
+    note(`Wrote ${pngPath} + ${jsonPath}`);
+    return done((cb) => cb());
+  }
   const pngFlag = flagStr(args, "png") ?? (flagBool(args, "png") ? "screenshot.png" : undefined);
   if (pngFlag !== undefined) {
     note(screen2 ? `Rendering ${screen2.label} (PNG)…` : "Rendering PNG…");
@@ -225149,7 +225482,7 @@ var render = async (args) => {
     if (isNullSink(pngFlag)) {
       note(`Discarded PNG (${pngFlag})`);
     } else {
-      mkdirSync23(dirname15(resolve17(pngFlag)), { recursive: true });
+      mkdirSync23(dirname16(resolve17(pngFlag)), { recursive: true });
       writeFileSync24(resolve17(pngFlag), png2);
       note(`Wrote ${pngFlag} (${png2.length} bytes, ${outW}x${outH}${clip !== undefined ? ", clipped" : ""})`);
     }
@@ -225180,8 +225513,8 @@ init_api();
 init_config();
 init_manifest();
 init_util();
-import { appendFileSync as appendFileSync2, existsSync as existsSync31, readFileSync as readFileSync29, writeFileSync as writeFileSync25 } from "node:fs";
-import { join as join33 } from "node:path";
+import { appendFileSync as appendFileSync2, existsSync as existsSync32, readFileSync as readFileSync30, writeFileSync as writeFileSync25 } from "node:fs";
+import { join as join34 } from "node:path";
 var ENV_VAR = "LECODES_PUSH_KEY";
 var context = () => {
   const root = findProjectRoot(process.cwd());
@@ -225325,9 +225658,9 @@ var pnKeysList = async (ctx) => {
 };
 var writeEnv = (root, key) => {
   const touched = [];
-  const envPath = join33(root, ".env");
+  const envPath = join34(root, ".env");
   const line = `${ENV_VAR}=${key}`;
-  const existing = existsSync31(envPath) ? readFileSync29(envPath, "utf8") : "";
+  const existing = existsSync32(envPath) ? readFileSync30(envPath, "utf8") : "";
   if (new RegExp(`^${ENV_VAR}=`, "m").test(existing)) {
     writeFileSync25(envPath, existing.replace(new RegExp(`^${ENV_VAR}=.*$`, "m"), line));
   } else {
@@ -225338,8 +225671,8 @@ var writeEnv = (root, key) => {
 `);
   }
   touched.push(".env");
-  const ignorePath = join33(root, ".gitignore");
-  const ignore = existsSync31(ignorePath) ? readFileSync29(ignorePath, "utf8") : "";
+  const ignorePath = join34(root, ".gitignore");
+  const ignore = existsSync32(ignorePath) ? readFileSync30(ignorePath, "utf8") : "";
   if (!ignore.split(`
 `).some((l2) => l2.trim() === ".env")) {
     const separator = !ignore || ignore.endsWith(`
@@ -225438,8 +225771,8 @@ var pn = async (args) => {
 init_api();
 init_config();
 init_manifest();
-import { existsSync as existsSync32, mkdirSync as mkdirSync24, rmSync as rmSync11, writeFileSync as writeFileSync26 } from "node:fs";
-import { dirname as dirname16, join as join34 } from "node:path";
+import { existsSync as existsSync33, mkdirSync as mkdirSync24, rmSync as rmSync11, writeFileSync as writeFileSync26 } from "node:fs";
+import { dirname as dirname17, join as join35 } from "node:path";
 init_types4();
 init_localFiles();
 init_util();
@@ -225462,8 +225795,8 @@ var pull = async (args) => {
   const remotePaths = new Set([...buildPaths(project.assets).entries()].filter(([id]) => project.assets.find((a2) => a2.id === id)?.type !== "folder").map(([, path2]) => path2));
   for (const path2 of Object.keys(manifest.files)) {
     if (!remotePaths.has(path2)) {
-      const abs = join34(root, ...path2.replace(/^\//, "").split("/"));
-      if (existsSync32(abs))
+      const abs = join35(root, ...path2.replace(/^\//, "").split("/"));
+      if (existsSync33(abs))
         rmSync11(abs);
     }
   }
@@ -225501,8 +225834,8 @@ var pullPaths = async (root, manifest, project, paths, apiUrl, token) => {
   const files = { ...manifest.files };
   for (const asset of targets) {
     const key = pathById.get(asset.id);
-    const abs = join34(root, ...key.replace(/^\//, "").split("/"));
-    mkdirSync24(dirname16(abs), { recursive: true });
+    const abs = join35(root, ...key.replace(/^\//, "").split("/"));
+    mkdirSync24(dirname17(abs), { recursive: true });
     let sha;
     if (asset.type === "file") {
       if (!asset.file?.src)
@@ -225525,8 +225858,8 @@ var pullPaths = async (root, manifest, project, paths, apiUrl, token) => {
 
 // src/commands/scene.ts
 init_manifest();
-import { existsSync as existsSync34, readFileSync as readFileSync31, readdirSync as readdirSync15, statSync as statSync13, writeFileSync as writeFileSync28 } from "node:fs";
-import { basename as basename17, dirname as dirname17, join as join36, resolve as resolve18 } from "node:path";
+import { existsSync as existsSync35, readFileSync as readFileSync32, readdirSync as readdirSync16, statSync as statSync14, writeFileSync as writeFileSync28 } from "node:fs";
+import { basename as basename18, dirname as dirname18, join as join37, resolve as resolve18 } from "node:path";
 
 // src/compile/sceneCompile.ts
 init_localFiles();
@@ -225535,18 +225868,18 @@ init_distRoot();
 init_util();
 init_projectCompile();
 import { createHash as createHash8 } from "node:crypto";
-import { existsSync as existsSync33, mkdirSync as mkdirSync25, readFileSync as readFileSync30, writeFileSync as writeFileSync27 } from "node:fs";
-import { join as join35 } from "node:path";
+import { existsSync as existsSync34, mkdirSync as mkdirSync25, readFileSync as readFileSync31, writeFileSync as writeFileSync27 } from "node:fs";
+import { join as join36 } from "node:path";
 var TEXT_EXT = /\.(ts|js|json|svg|txt|md)$/i;
 var rel = (key) => key.replace(/^\//, "");
 var resolveHarness = (loadSceneHarness2) => {
-  const inRepo = join35(distRoot, "..", "projects", "src", "scene-editor");
+  const inRepo = join36(distRoot, "..", "projects", "src", "scene-editor");
   try {
-    return loadSceneHarness2(existsSync33(inRepo) ? inRepo : undefined);
+    return loadSceneHarness2(existsSync34(inRepo) ? inRepo : undefined);
   } catch {
-    const vendored = join35(distRoot, "runtime", "scene-harness.json");
-    if (existsSync33(vendored))
-      return JSON.parse(readFileSync30(vendored, "utf8"));
+    const vendored = join36(distRoot, "runtime", "scene-harness.json");
+    if (existsSync34(vendored))
+      return JSON.parse(readFileSync31(vendored, "utf8"));
     throw new CliError("scene-editor harness sources not found — reinstall the CLI or set LECODES_SCENE_HARNESS_DIR.");
   }
 };
@@ -225558,16 +225891,16 @@ var compileSceneEditor = async (opts) => {
   for (const file of scan2.files) {
     const path2 = "./" + rel(file.path);
     if (TEXT_EXT.test(path2)) {
-      entries.push({ path: path2, type: "text", text: readFileSync30(file.absPath, "utf8") });
+      entries.push({ path: path2, type: "text", text: readFileSync31(file.absPath, "utf8") });
     } else if (/\.mat$/i.test(path2)) {
-      entries.push({ path: path2, type: "shader", text: readFileSync30(file.absPath, "utf8"), absPath: file.absPath });
+      entries.push({ path: path2, type: "shader", text: readFileSync31(file.absPath, "utf8"), absPath: file.absPath });
     } else {
       entries.push({ path: path2, type: "resource", fileSrc: "/project/" + rel(file.path) });
     }
   }
   const shaderEntries = entries.filter((e2) => e2.type === "shader");
   if (shaderEntries.length > 0) {
-    const { warnings } = await applyLocalShaders(shaderEntries, { root, srcPrefix: "/project/.lecodes/shaders", platforms: ["webgl", "webgl-lite"] });
+    const { warnings } = await applyLocalShaders(shaderEntries, { root, srcPrefix: "/project/.lecodes/shaders", platforms: ["opengl", "webgl-lite"] });
     for (const w of warnings)
       warnErr(w);
     const { buildLiteMaterialArtifact: buildLiteMaterialArtifact2 } = await Promise.resolve().then(() => (init_compile(), exports_compile));
@@ -225578,10 +225911,10 @@ var compileSceneEditor = async (opts) => {
       const dir = shadersCacheDir(root);
       mkdirSync25(dir, { recursive: true });
       const liteName = `${hash}_webgl-lite.filamat`;
-      if (!existsSync33(join35(dir, liteName)))
-        writeFileSync27(join35(dir, liteName), JSON.stringify(buildLiteMaterialArtifact2(e2.text ?? "")));
+      if (!existsSync34(join36(dir, liteName)))
+        writeFileSync27(join36(dir, liteName), JSON.stringify(buildLiteMaterialArtifact2(e2.text ?? "")));
       const src = `/project/.lecodes/shaders/${hash}_opengl.filamat`;
-      e2.shaders = ["opengl", "webgl", "webgl-lite"].map((platform) => ({ platform, src }));
+      e2.shaders = ["opengl", "webgl-lite"].map((platform) => ({ platform, src }));
     }
   }
   const scene = scenePath.startsWith("./") ? scenePath : "./" + rel(scenePath);
@@ -225613,14 +225946,21 @@ var DEFAULT_PORT3 = 4488;
 var findAppRoot = (start) => {
   let dir = start;
   while (true) {
-    if (existsSync34(join36(dir, "app.json")))
+    if (existsSync35(join37(dir, "app.json")))
       return dir;
-    const parent = dirname17(dir);
+    const parent = dirname18(dir);
     if (parent === dir)
       return null;
     dir = parent;
   }
 };
+var projectRootOf = (dir) => {
+  try {
+    return findProjectRoot(dir);
+  } catch {
+    return findAppRoot(dir) ?? dir;
+  }
+};
 var getContext2 = (args) => {
   let root;
   let manifest;
@@ -225633,25 +225973,25 @@ var getContext2 = (args) => {
     const pathArg = args._[0];
     if (pathArg) {
       const abs = resolve18(process.cwd(), pathArg);
-      if (existsSync34(abs) && statSync13(abs).isDirectory())
+      if (existsSync35(abs) && statSync14(abs).isDirectory())
         root = abs;
-      else if (abs.endsWith(".scene.ts") && existsSync34(abs))
-        root = findAppRoot(dirname17(abs)) ?? dirname17(abs);
+      else if (abs.endsWith(".scene.ts") && existsSync35(abs))
+        root = findAppRoot(dirname18(abs)) ?? dirname18(abs);
       else
         throw new CliError(`No such folder or .scene.ts: ${pathArg}`);
     } else {
       root = findAppRoot(root) ?? root;
     }
   }
-  return { root, manifest, name: manifest?.name ?? basename17(root) };
+  return { root, manifest, name: manifest?.name ?? basename18(root) };
 };
 var writeMcpConfig2 = (root, port) => {
-  const path2 = join36(root, ".mcp.json");
+  const path2 = join37(root, ".mcp.json");
   const entry = { type: "http", url: `http://localhost:${port}/mcp` };
   let config = {};
-  if (existsSync34(path2)) {
+  if (existsSync35(path2)) {
     try {
-      config = JSON.parse(readFileSync31(path2, "utf8"));
+      config = JSON.parse(readFileSync32(path2, "utf8"));
     } catch {
       warnErr(".mcp.json exists but isn't valid JSON — left it untouched. Add the lecodes-scene server by hand.");
       return;
@@ -225670,11 +226010,11 @@ var writeMcpConfig2 = (root, port) => {
 };
 var countScenes = (dir) => {
   let n2 = 0;
-  for (const name of readdirSync15(dir)) {
+  for (const name of readdirSync16(dir)) {
     if (name === "node_modules" || name.startsWith("."))
       continue;
-    const full = join36(dir, name);
-    if (statSync13(full).isDirectory())
+    const full = join37(dir, name);
+    if (statSync14(full).isDirectory())
       n2 += countScenes(full);
     else if (name.endsWith(".scene.ts"))
       n2++;
@@ -225715,13 +226055,170 @@ var scene = async (args) => {
     openBrowser(server2.url);
 };
 
+// src/commands/thumbs.ts
+import { createRequire as createRequire6 } from "node:module";
+import { execFileSync as execFileSync7 } from "node:child_process";
+import { existsSync as existsSync36, mkdtempSync as mkdtempSync6, readdirSync as readdirSync17, rmSync as rmSync12, statSync as statSync15 } from "node:fs";
+import { tmpdir as tmpdir6 } from "node:os";
+import { extname, join as join38, relative as relative7, resolve as resolve19 } from "node:path";
+init_util();
+var DEFAULT_SIZE = 256;
+var IMAGE_EXT = /\.(png|jpe?g|webp|bmp|gif|tiff?|ktx2)$/i;
+var RENDERED_EXT = /\.(glb|gltf|material\.ts|scene\.ts)$/i;
+var findKtx = () => {
+  const exe = process.platform === "win32" ? "ktx.exe" : "ktx";
+  const candidates = [
+    process.env.LECODES_KTX,
+    process.env.KTX_CLI,
+    process.env.KTX_TOKTX?.replace(/toktx(\.exe)?$/i, exe),
+    process.platform === "win32" ? join38(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
+    process.platform === "win32" ? join38(process.env.ProgramFiles ?? "", "KTX-Software", "bin", exe) : null,
+    "/usr/local/bin/ktx",
+    "/opt/homebrew/bin/ktx"
+  ].filter((p2) => !!p2);
+  for (const path2 of candidates) {
+    if (existsSync36(path2))
+      return path2;
+  }
+  try {
+    execFileSync7(exe, ["--version"], { stdio: "ignore" });
+    return exe;
+  } catch {
+    return null;
+  }
+};
+var sharpResizer = () => {
+  try {
+    const req = createRequire6(import.meta.url);
+    const sharp = createRequire6(req.resolve("lecodes-assets/cli"))("sharp");
+    return async (file, size) => sharp(file).resize({ width: size, height: size, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+  } catch {
+    return null;
+  }
+};
+var jimpResizer = () => async (file, size) => {
+  const { Jimp: Jimp2 } = await Promise.resolve().then(() => (init_esm30(), exports_esm2));
+  const img = await Jimp2.read(file);
+  if (Math.max(img.width, img.height) > size)
+    img.scaleToFit({ w: size, h: size });
+  return await img.getBuffer("image/png");
+};
+var ktxToPng = (ktx, file, out) => {
+  const run2 = (args) => execFileSync7(ktx, args, { stdio: ["ignore", "ignore", "pipe"], encoding: "utf8" });
+  try {
+    run2(["extract", "--transcode", "rgba8", "--level", "0", file, out]);
+  } catch (e2) {
+    run2(["extract", "--level", "0", file, out]);
+    if (!existsSync36(out))
+      throw e2;
+  }
+};
+var collect = (dir) => {
+  const out = [];
+  for (const name of readdirSync17(dir)) {
+    if (name === "node_modules" || name.startsWith("."))
+      continue;
+    const full = join38(dir, name);
+    if (statSync15(full).isDirectory())
+      out.push(...collect(full));
+    else if (IMAGE_EXT.test(name))
+      out.push(full);
+  }
+  return out;
+};
+var thumbs = async (args) => {
+  const root = projectRootOf(process.cwd());
+  let sceneServer;
+  try {
+    sceneServer = await import("lecodes-3d-editor/server");
+  } catch {
+    throw new CliError("The scene editor isn't installed (it owns the preview cache). Run:  npm install -g lecodes-3d-editor");
+  }
+  const size = Number(flagStr(args, "size")) || DEFAULT_SIZE;
+  const force = flagBool(args, "force");
+  let files = [];
+  const rendered = [];
+  if (args._.length > 0) {
+    for (const arg of args._) {
+      const abs = resolve19(process.cwd(), arg);
+      if (!existsSync36(abs))
+        throw new CliError(`No such file or folder: ${arg}`);
+      if (statSync15(abs).isDirectory())
+        files.push(...collect(abs));
+      else if (IMAGE_EXT.test(abs))
+        files.push(abs);
+      else if (RENDERED_EXT.test(abs))
+        rendered.push(arg);
+      else
+        throw new CliError(`Not a previewable asset: ${arg}`);
+    }
+  } else {
+    files = collect(root);
+  }
+  files = [...new Set(files)];
+  if (files.length === 0 && rendered.length === 0) {
+    log("No images to thumbnail.");
+    return;
+  }
+  const ktx = files.some((f3) => f3.toLowerCase().endsWith(".ktx2")) ? findKtx() : null;
+  const sharp = sharpResizer();
+  const resize = sharp ?? jimpResizer();
+  const tmp = mkdtempSync6(join38(tmpdir6(), "lecodes-thumbs-"));
+  let made = 0, fresh = 0;
+  const skipped = [];
+  try {
+    for (const [i2, file] of files.entries()) {
+      const asset = "./" + toKey(relative7(root, file));
+      progress(i2, files.length, asset);
+      const hash = sceneServer.hashAsset(root, asset);
+      if (!hash)
+        continue;
+      if (!force && sceneServer.previewIsCurrent(root, asset, hash)) {
+        fresh++;
+        continue;
+      }
+      const ext2 = extname(file).toLowerCase();
+      if (ext2 === ".webp" && !sharp) {
+        skipped.push(`${asset} (webp needs sharp — npm install -g lecodes-assets)`);
+        continue;
+      }
+      try {
+        let source = file;
+        if (ext2 === ".ktx2") {
+          if (!ktx) {
+            skipped.push(`${asset} (KTX2 needs KTX-Software's \`ktx\` — set LECODES_KTX or put it on PATH)`);
+            continue;
+          }
+          source = join38(tmp, `${i2}.png`);
+          ktxToPng(ktx, file, source);
+        }
+        sceneServer.writePreviewFile(root, asset, await resize(source, size));
+        made++;
+      } catch (e2) {
+        skipped.push(`${asset} (${(e2?.message ?? String(e2)).split(`
+`)[0]})`);
+      }
+    }
+  } finally {
+    endProgress();
+    rmSync12(tmp, { recursive: true, force: true });
+  }
+  log(`${c.bold(String(made))} generated · ${fresh} already current${skipped.length > 0 ? ` · ${skipped.length} skipped` : ""}`);
+  for (const s2 of skipped)
+    warnErr(s2);
+  if (rendered.length > 0) {
+    warnErr(`Models, materials and prefabs are RENDERED, not decoded — the scene editor does those: ${rendered.join(", ")}`);
+  }
+  note(`Cache: ${join38(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`);
+};
+
 // src/commands/assets.ts
 init_util();
 
 // src/cmgenTool.ts
-import { existsSync as existsSync35, readdirSync as readdirSync16 } from "node:fs";
+import { existsSync as existsSync37, readdirSync as readdirSync18 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import { join as join37, resolve as resolve19 } from "node:path";
+import { join as join39, resolve as resolve20 } from "node:path";
 init_util();
 var exeName2 = () => process.platform === "win32" ? "cmgen.exe" : "cmgen";
 var platformKey3 = () => {
@@ -225731,10 +226228,10 @@ var platformKey3 = () => {
     return "linux-x64";
   throw new CliError(process.platform === "darwin" ? "cmgen isn't published for macOS yet — build filament's host tools locally and set LECODES_CMGEN." : `cmgen isn't published for ${process.platform}.`);
 };
-var cacheRoot3 = () => join37(homedir8(), ".lecodes", "cmgen");
+var cacheRoot3 = () => join39(homedir8(), ".lecodes", "cmgen");
 var findCmgenIn = (dir) => {
-  for (const entry of readdirSync16(dir, { withFileTypes: true })) {
-    const p2 = join37(dir, entry.name);
+  for (const entry of readdirSync18(dir, { withFileTypes: true })) {
+    const p2 = join39(dir, entry.name);
     if (entry.isFile() && entry.name === exeName2())
       return p2;
     if (entry.isDirectory()) {
@@ -225747,7 +226244,7 @@ var findCmgenIn = (dir) => {
 };
 var installedCmgenVersions = () => {
   try {
-    return readdirSync16(cacheRoot3(), { withFileTypes: true }).filter((e2) => e2.isDirectory() && e2.name.startsWith("cmgen-")).map((e2) => e2.name.slice("cmgen-".length)).filter((v) => findCmgenIn(join37(cacheRoot3(), `cmgen-${v}`)) !== null).sort(semverNewer);
+    return readdirSync18(cacheRoot3(), { withFileTypes: true }).filter((e2) => e2.isDirectory() && e2.name.startsWith("cmgen-")).map((e2) => e2.name.slice("cmgen-".length)).filter((v) => findCmgenIn(join39(cacheRoot3(), `cmgen-${v}`)) !== null).sort(semverNewer);
   } catch {
     return [];
   }
@@ -225769,19 +226266,19 @@ var downloadCmgen = async (version, versions, dest) => {
 var resolveCmgenExeCached = () => {
   const override = process.env.LECODES_CMGEN;
   if (override) {
-    if (!existsSync35(override))
+    if (!existsSync37(override))
       throw new CliError(`LECODES_CMGEN points at "${override}" which doesn't exist.`);
-    return resolve19(override);
+    return resolve20(override);
   }
   const cached = installedCmgenVersions()[0];
-  return cached ? findCmgenIn(join37(cacheRoot3(), `cmgen-${cached}`)) : null;
+  return cached ? findCmgenIn(join39(cacheRoot3(), `cmgen-${cached}`)) : null;
 };
 var resolveCmgenExe = async () => {
   const cached = resolveCmgenExeCached();
   if (cached)
     return cached;
   const { latest, versions } = await fetchCmgenManifest();
-  const dir = join37(cacheRoot3(), `cmgen-${latest}`);
+  const dir = join39(cacheRoot3(), `cmgen-${latest}`);
   await downloadCmgen(latest, versions, dir);
   const exe = findCmgenIn(dir);
   if (!exe)
@@ -225839,8 +226336,8 @@ var status3 = async (_args) => {
 };
 
 // src/commands/test.ts
-import { existsSync as existsSync36, mkdirSync as mkdirSync26, readFileSync as readFileSync32, readdirSync as readdirSync17 } from "node:fs";
-import { dirname as dirname18, resolve as resolve20 } from "node:path";
+import { existsSync as existsSync38, mkdirSync as mkdirSync26, readFileSync as readFileSync33, readdirSync as readdirSync19 } from "node:fs";
+import { dirname as dirname19, resolve as resolve21 } from "node:path";
 init_manifest();
 init_util();
 var deriveDesignFlows = (meta, entryScreen) => {
@@ -225903,7 +226400,7 @@ var slug3 = (s2) => s2.replace(/[^a-zA-Z0-9-_]+/g, "-").replace(/^-+|-+$/g, "").
 var readFlowFile = (abs, displayName) => {
   let raw;
   try {
-    raw = JSON.parse(readFileSync32(abs, "utf8"));
+    raw = JSON.parse(readFileSync33(abs, "utf8"));
   } catch (e2) {
     throw new CliError(`Can't read "${displayName}": ${e2 instanceof Error ? e2.message : String(e2)}`);
   }
@@ -225917,7 +226414,7 @@ var readFlowFile = (abs, displayName) => {
     name: file.name ?? displayName,
     kind: "file",
     steps: file.steps,
-    fixtures: resolveFixtures(file.fixtures, dirname18(abs)),
+    fixtures: resolveFixtures(file.fixtures, dirname19(abs)),
     width: file.width,
     height: file.height,
     settle: file.settle,
@@ -225958,40 +226455,40 @@ var test = async (args) => {
   if (!Number.isFinite(nativeFixedDt) || nativeFixedDt < 0 || nativeFixedDt > 1000)
     throw new CliError(`--fixed-dt wants a number of ms (0 = wall clock, max 1000), got "${fixedDtFlag}".`);
   const projectViewport = desktopDefaultViewport(root);
-  const testsDir = resolve20(root, flagStr(args, "dir") ?? "tests");
-  const designMetaPath = resolve20(root, flagStr(args, "design-dir") ?? "design", "meta.json");
+  const testsDir = resolve21(root, flagStr(args, "dir") ?? "tests");
+  const designMetaPath = resolve21(root, flagStr(args, "design-dir") ?? "design", "meta.json");
   const asJson = flagBool(args, "json");
   const out = asJson ? logErr : log;
   const cases = [];
   if (args._.length > 0) {
     for (const given of args._) {
-      const candidates = [resolve20(given), resolve20(testsDir, given), resolve20(testsDir, `${given}.flow.json`)];
-      const abs = candidates.find((p2) => existsSync36(p2));
+      const candidates = [resolve21(given), resolve21(testsDir, given), resolve21(testsDir, `${given}.flow.json`)];
+      const abs = candidates.find((p2) => existsSync38(p2));
       if (!abs)
         throw new CliError(`No such test: "${given}" (looked in ${testsDir}).`);
       cases.push(readFlowFile(abs, given));
     }
-  } else if (existsSync36(testsDir)) {
-    for (const f3 of readdirSync17(testsDir).filter((f4) => f4.endsWith(".flow.json")).sort()) {
-      cases.push(readFlowFile(resolve20(testsDir, f3), f3));
+  } else if (existsSync38(testsDir)) {
+    for (const f3 of readdirSync19(testsDir).filter((f4) => f4.endsWith(".flow.json")).sort()) {
+      cases.push(readFlowFile(resolve21(testsDir, f3), f3));
     }
   }
   const fixturesFlag = flagStr(args, "fixtures");
-  const defaultPack = resolve20(testsDir, "fixtures.json");
-  const flowFixtures = fixturesFlag !== undefined ? resolveFixtures(fixturesFlag, ".") : existsSync36(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
+  const defaultPack = resolve21(testsDir, "fixtures.json");
+  const flowFixtures = fixturesFlag !== undefined ? resolveFixtures(fixturesFlag, ".") : existsSync38(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
   const flowsOnly = flagBool(args, "flows");
   const wantFlows = !flagBool(args, "no-flows") && args._.length === 0;
   if (flowsOnly)
     cases.length = 0;
   let skipped = [];
   let entryScreen = null;
-  if (desktop2 && wantFlows && existsSync36(designMetaPath)) {
+  if (desktop2 && wantFlows && existsSync38(designMetaPath)) {
     note("Design-derived flows skipped with --desktop (they tap by name; run `lecodes test` headless for them).");
   }
-  if (!desktop2 && (wantFlows || flowsOnly) && existsSync36(designMetaPath)) {
+  if (!desktop2 && (wantFlows || flowsOnly) && existsSync38(designMetaPath)) {
     let meta;
     try {
-      meta = JSON.parse(readFileSync32(designMetaPath, "utf8"));
+      meta = JSON.parse(readFileSync33(designMetaPath, "utf8"));
     } catch (e2) {
       throw new CliError(`Can't read ${designMetaPath}: ${e2 instanceof Error ? e2.message : String(e2)}`);
     }
@@ -226023,18 +226520,19 @@ var test = async (args) => {
   }, timeoutMs);
   killer.unref?.();
   const onConsole = flagBool(args, "logs") ? (level, text) => logErr(`${c.dim(`[${level}]`)} ${text}`) : undefined;
-  const artifactsRoot = resolve20(root, flagStr(args, "artifacts") ?? resolve20(testsDir, ".artifacts"));
+  const artifactsRoot = resolve21(root, flagStr(args, "artifacts") ?? resolve21(testsDir, ".artifacts"));
   const results = [];
   const runNativeCase = async (kase) => {
-    const caseDir = resolve20(artifactsRoot, slug3(kase.name));
+    const caseDir = resolve21(artifactsRoot, slug3(kase.name));
     const plan = translateScenario(kase.steps, { outDir: caseDir, headroomFrames: nativeFrames });
     for (const st of plan.steps)
       if (st.screenshot)
-        mkdirSync26(dirname18(st.screenshot), { recursive: true });
+        mkdirSync26(dirname19(st.screenshot), { recursive: true });
     mkdirSync26(caseDir, { recursive: true });
-    const finalPng = resolve20(caseDir, "final.png");
+    const finalPng = resolve21(caseDir, "final.png");
     const { output } = await runDesktopRender(native.js, native.resources, {
       renderer: desktopRenderer,
+      pluginDirs: desktopPluginLibraries(root).dirs,
       width: Number(flagStr(args, "width")) || kase.width || projectViewport?.width || 390,
       height: Number(flagStr(args, "height")) || kase.height || projectViewport?.height || 844,
       frames: plan.frameCap,
@@ -226084,14 +226582,14 @@ var test = async (args) => {
         onConsole
       });
       try {
-        const io = fileScenarioIO(resolve20(artifactsRoot, slug3(kase.name)));
+        const io = fileScenarioIO(resolve21(artifactsRoot, slug3(kase.name)));
         const outcome = await renderer.runScenario(session, steps, io);
         result = {
           name: kase.name,
           kind: kase.kind,
           ok: outcome.ok,
           steps: outcome.steps.map((s2) => ({ desc: s2.desc, ok: s2.ok, error: s2.error })),
-          artifacts: outcome.failureArtifacts.map((p2) => resolve20(artifactsRoot, slug3(kase.name), p2))
+          artifacts: outcome.failureArtifacts.map((p2) => resolve21(artifactsRoot, slug3(kase.name), p2))
         };
       } finally {
         session.dispose();
@@ -226153,17 +226651,54 @@ var test = async (args) => {
   process.exit(failed > 0 ? 1 : 0);
 };
 
+// src/commands/update.ts
+import { spawnSync as spawnSync7 } from "node:child_process";
+import { existsSync as existsSync40, readdirSync as readdirSync20 } from "node:fs";
+import { homedir as homedir9 } from "node:os";
+import { dirname as dirname21, join as join41, resolve as resolve23 } from "node:path";
+init_util();
+
+// src/peers.ts
+import { existsSync as existsSync39, readFileSync as readFileSync34 } from "node:fs";
+import { createRequire as createRequire7 } from "node:module";
+import { dirname as dirname20, join as join40 } from "node:path";
+var OPTIONAL_PEERS = [
+  ["lecodes-renderer", "lecodes-renderer/headless"],
+  ["lecodes-design", "lecodes-design/server"],
+  ["lecodes-3d-editor", "lecodes-3d-editor/server"],
+  ["lecodes-assets", "lecodes-assets/cli"]
+];
+var peerVersion = (name, probe) => {
+  try {
+    const require2 = createRequire7(import.meta.url);
+    let dir = dirname20(require2.resolve(probe));
+    for (let depth = 0;depth < 16; depth++) {
+      const manifest = join40(dir, "package.json");
+      if (existsSync39(manifest)) {
+        const parsed = JSON.parse(readFileSync34(manifest, "utf8"));
+        if (parsed.name === name)
+          return parsed.version ?? "unknown";
+      }
+      const parent = dirname20(dir);
+      if (parent === dir)
+        break;
+      dir = parent;
+    }
+  } catch {}
+  return null;
+};
+
 // src/commands/types.ts
 init_api();
 init_config();
 init_manifest();
 init_types4();
 init_util();
-import { resolve as resolve21 } from "node:path";
+import { resolve as resolve22 } from "node:path";
 var label = (bundle) => `${Object.keys(bundle).length} file(s)`;
 var types4 = async (args) => {
   const dirArg = args._[0];
-  const root = dirArg ? resolve21(dirArg) : (() => {
+  const root = dirArg ? resolve22(dirArg) : (() => {
     try {
       return findProjectRoot(process.cwd());
     } catch {
@@ -226198,9 +226733,9 @@ var types4 = async (args) => {
   const same = bundleHash(onDisk) === bundleHash(bundle);
   if (checkOnly) {
     if (Object.keys(onDisk).length === 0)
-      throw new CliError(`No types in ${LECODES_DIR}/types/ — run \`lecodes types\`.`);
+      throw new CliError(`No types in ${LECODES_DIR}/types/ — run \`lecodes update\`.`);
     if (!same)
-      throw new CliError(`Types are out of date (${label(onDisk)} on disk) — run \`lecodes types\`.`);
+      throw new CliError(`Types are out of date (${label(onDisk)} on disk) — run \`lecodes update\`.`);
     success(`Types are up to date (${label(onDisk)}).`);
     return;
   }
@@ -226221,29 +226756,166 @@ var types4 = async (args) => {
     note("Reload the TypeScript server in your editor to pick them up.");
 };
 
+// src/commands/update.ts
+var findProjectDir = (start) => {
+  const home = resolve23(homedir9());
+  let dir = resolve23(start);
+  while (true) {
+    if (dir !== home && (existsSync40(join41(dir, "app.json")) || existsSync40(join41(dir, ".lecodes", "manifest.json")) || existsSync40(join41(dir, ".lecodes", "types"))))
+      return dir;
+    const parent = dirname21(dir);
+    if (parent === dir)
+      return null;
+    dir = parent;
+  }
+};
+var NPM = "https://registry.npmjs.org";
+var npmLatest = async (name) => {
+  try {
+    const res = await fetch(`${NPM}/${name}/latest`, { signal: AbortSignal.timeout(4000) });
+    if (!res.ok)
+      return null;
+    const json = await res.json();
+    return json.version ?? null;
+  } catch {
+    return null;
+  }
+};
+var semverNewer2 = (a2, b) => {
+  const pa = a2.split(/[.-]/).map(Number), pb = b.split(/[.-]/).map(Number);
+  for (let i2 = 0;i2 < 3; i2++) {
+    const d = (pa[i2] ?? 0) - (pb[i2] ?? 0);
+    if (d)
+      return d;
+  }
+  return 0;
+};
+var FROM_SOURCE = /[\\/]src[\\/]commands[\\/]/.test(import.meta.url);
+var STANDALONE = existsSync40(join41(dirname21(process.execPath), "runtime")) && existsSync40(join41(dirname21(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel"));
+var update = async (args) => {
+  const steps = [];
+  const heading = (name, what) => log(`
+${c.bold(name)}  ${c.dim(what)}`);
+  const run2 = async (name, what, fn) => {
+    heading(name, what);
+    try {
+      const r2 = await fn();
+      const [outcome, detail] = Array.isArray(r2) ? r2 : [r2, undefined];
+      steps.push({ name, outcome, detail });
+      if (outcome === "skipped" && detail)
+        note(`skipped — ${detail}`);
+    } catch (e2) {
+      const msg = e2 instanceof CliError ? e2.message : e2 instanceof Error ? e2.message : String(e2);
+      log(c.red("✗ ") + msg);
+      steps.push({ name, outcome: "failed", detail: msg });
+    }
+  };
+  const root = findProjectDir(process.cwd());
+  await run2("desktop", "LeCodes Desktop host (desktop run / render --desktop)", async () => {
+    if (process.env.LECODES_DESKTOP_EXE)
+      return ["skipped", `LECODES_DESKTOP_EXE=${process.env.LECODES_DESKTOP_EXE} (a local build; \`lecodes desktop update\` refreshes the cache anyway)`];
+    await updateDesktop();
+    return "ok";
+  });
+  await run2("matc", "Filament material compiler for local shader compiles", async () => {
+    if (process.env.LECODES_MATC)
+      return ["skipped", `LECODES_MATC=${process.env.LECODES_MATC} (a local matc)`];
+    await updateMatc();
+    return "ok";
+  });
+  await run2("shaders", "recompile the project's .mat shaders with the current matc", async () => {
+    if (!root)
+      return ["skipped", "not inside a project"];
+    await shaders({ _: ["compile"], flags: {} });
+    return "ok";
+  });
+  await run2("types", flagBool(args, "local") ? "IDE types from the SDK bundled in this CLI" : "IDE types from the server", async () => {
+    if (!root)
+      return ["skipped", "not inside a project"];
+    await types4({ _: [], flags: flagBool(args, "local") ? { local: true } : {} });
+    return "ok";
+  });
+  await run2("shells", "ios/ + android/ pins → newest SDK release + plugin tags, then re-sync", async () => {
+    if (!root)
+      return ["skipped", "not inside a project"];
+    if (flagBool(args, "no-shells"))
+      return ["skipped", "--no-shells"];
+    const present = ["ios", "android"].filter((d) => existsSync40(join41(root, d)) && readdirSync20(join41(root, d)).length > 0);
+    if (present.length === 0)
+      return ["skipped", "no ios/ or android/ shell in this project (`lecodes app init ios|android`)"];
+    await app({ _: ["update"], flags: {} });
+    return "ok";
+  });
+  await run2("cli", "lecodes-cli + its optional peers (global npm installs)", async () => {
+    if (flagBool(args, "no-cli"))
+      return ["skipped", "--no-cli"];
+    if (FROM_SOURCE)
+      return ["skipped", "running from the repo checkout — the CLI and its peers are the repo's own"];
+    const rows = [];
+    for (const [name, probe] of OPTIONAL_PEERS) {
+      const installed = peerVersion(name, probe);
+      rows.push({ name, installed, latest: installed ? await npmLatest(name) : null });
+    }
+    rows.push({ name: "lecodes-cli", installed: package_default.version, latest: await npmLatest("lecodes-cli") });
+    if (rows.every((r3) => r3.latest === null))
+      return ["skipped", "npm unreachable"];
+    const behind = rows.filter((r3) => r3.installed && r3.latest && semverNewer2(r3.latest, r3.installed) > 0);
+    for (const r3 of rows) {
+      const state = !r3.installed ? c.dim("not installed (optional — npm install -g " + r3.name + ")") : !r3.latest ? c.dim("(npm: unknown)") : behind.includes(r3) ? c.yellow("→ " + r3.latest) : c.dim("(up to date)");
+      log("  " + r3.name.padEnd(18) + " " + (r3.installed ?? "").padEnd(8) + " " + state);
+    }
+    if (behind.length === 0)
+      return "ok";
+    const specs = behind.map((r3) => r3.name + "@latest");
+    if (flagBool(args, "check"))
+      return ["updated", behind.length + " behind — run: npm install -g " + specs.join(" ")];
+    if (STANDALONE && behind.some((r3) => r3.name === "lecodes-cli")) {
+      note("this is the standalone build — the CLI updates by re-installing the release archive, not through npm; peers still go through npm");
+    }
+    const toInstall = STANDALONE ? specs.filter((s2) => !s2.startsWith("lecodes-cli@")) : specs;
+    if (toInstall.length === 0)
+      return ["skipped", "only the standalone CLI itself is behind — download the release"];
+    log("  " + c.dim("$") + " npm install -g " + toInstall.join(" "));
+    const r2 = spawnSync7("npm", ["install", "-g", ...toInstall], { stdio: "inherit", shell: true });
+    if (r2.status !== 0)
+      throw new CliError("npm install -g exited with " + (r2.status ?? "a signal"));
+    const names3 = toInstall.map((s2) => s2.replace("@latest", "")).join(", ");
+    const cliToo = toInstall.some((s2) => s2.startsWith("lecodes-cli@"));
+    return ["updated", names3 + " → latest" + (cliToo ? " (the new CLI runs from your next command)" : "")];
+  });
+  log(`
+${c.bold("Summary")}`);
+  const width = Math.max(...steps.map((s2) => s2.name.length));
+  for (const s2 of steps) {
+    const mark = s2.outcome === "failed" ? c.red("✗") : s2.outcome === "skipped" ? c.dim("–") : c.green("✓");
+    log(`  ${mark} ${s2.name.padEnd(width)}  ${s2.outcome === "failed" ? c.red(s2.detail ?? "failed") : s2.outcome === "skipped" ? c.dim(s2.detail ?? "skipped") : s2.detail ?? s2.outcome}`);
+  }
+  if (steps.some((s2) => s2.outcome === "failed"))
+    process.exitCode = 1;
+};
+
 // src/index.ts
-import { existsSync as existsSync39, readFileSync as readFileSync35, realpathSync as realpathSync2 } from "node:fs";
-import { createRequire as createRequire4 } from "node:module";
-import { delimiter as delimiter2, dirname as dirname21, join as join40 } from "node:path";
+import { existsSync as existsSync43, realpathSync as realpathSync2 } from "node:fs";
+import { delimiter as delimiter3, dirname as dirname24, join as join44 } from "node:path";
 
 // src/commands/install.ts
 init_util();
-import { execFileSync as execFileSync7 } from "node:child_process";
-import { appendFileSync as appendFileSync3, chmodSync as chmodSync2, cpSync as cpSync5, existsSync as existsSync37, mkdirSync as mkdirSync27, readFileSync as readFileSync33, realpathSync, rmSync as rmSync12, symlinkSync } from "node:fs";
-import { homedir as homedir9 } from "node:os";
-import { basename as basename18, delimiter, dirname as dirname19, join as join38, resolve as resolve22, sep as sep2 } from "node:path";
+import { execFileSync as execFileSync8 } from "node:child_process";
+import { appendFileSync as appendFileSync3, chmodSync as chmodSync2, cpSync as cpSync5, existsSync as existsSync41, mkdirSync as mkdirSync27, readFileSync as readFileSync35, realpathSync, rmSync as rmSync13, symlinkSync as symlinkSync2 } from "node:fs";
+import { homedir as homedir10 } from "node:os";
+import { basename as basename19, delimiter as delimiter2, dirname as dirname22, join as join42, resolve as resolve24, sep as sep2 } from "node:path";
 var isWin = process.platform === "win32";
-var HOME = homedir9();
+var HOME = homedir10();
 var safeRealpath = (p2) => {
   try {
     return realpathSync(p2);
   } catch {
-    return resolve22(p2);
+    return resolve24(p2);
   }
 };
 var onPath = (dir) => {
   const want = safeRealpath(dir);
-  return (process.env.PATH ?? "").split(delimiter).some((p2) => {
+  return (process.env.PATH ?? "").split(delimiter2).some((p2) => {
     if (!p2)
       return false;
     try {
@@ -226254,13 +226926,13 @@ var onPath = (dir) => {
   });
 };
 var install = async (args) => {
-  const bundle = dirname19(process.execPath);
-  const exeName3 = basename18(process.execPath);
+  const bundle = dirname22(process.execPath);
+  const exeName3 = basename19(process.execPath);
   const chiselName = isWin ? "chisel.exe" : "chisel";
-  if (!existsSync37(join38(bundle, "runtime")) || !existsSync37(join38(bundle, chiselName))) {
+  if (!existsSync41(join42(bundle, "runtime")) || !existsSync41(join42(bundle, chiselName))) {
     throw new CliError("`lecodes install` only works from the packaged release build (the archive containing lecodes + " + "chisel + runtime/). You appear to be running from source or an npm install — install globally " + "with your package manager there instead.");
   }
-  const companions = [exeName3, chiselName, "runtime", "README.txt"].filter((f3) => existsSync37(join38(bundle, f3)));
+  const companions = [exeName3, chiselName, "runtime", "README.txt"].filter((f3) => existsSync41(join42(bundle, f3)));
   if (isWin)
     return installWindows(args, bundle, companions);
   return installUnix(args, bundle, companions);
@@ -226270,9 +226942,9 @@ var copyBundle = (bundle, target, companions) => {
   if (safeRealpath(target) === safeRealpath(bundle))
     return;
   for (const f3 of companions) {
-    const dest = join38(target, f3);
-    rmSync12(dest, { recursive: true, force: true });
-    cpSync5(join38(bundle, f3), dest, { recursive: true });
+    const dest = join42(target, f3);
+    rmSync13(dest, { recursive: true, force: true });
+    cpSync5(join42(bundle, f3), dest, { recursive: true });
   }
 };
 var permError = (e2, dir, system) => {
@@ -226284,41 +226956,41 @@ var permError = (e2, dir, system) => {
 };
 var installUnix = (args, bundle, companions) => {
   const system = flagBool(args, "system");
-  const libDir = resolve22(flagStr(args, "dir") ?? (system ? "/usr/local/lib/lecodes-cli" : join38(HOME, ".local", "lib", "lecodes-cli")));
-  const binDir = resolve22(flagStr(args, "bin") ?? (system ? "/usr/local/bin" : join38(HOME, ".local", "bin")));
-  const link2 = join38(binDir, "lecodes");
+  const libDir = resolve24(flagStr(args, "dir") ?? (system ? "/usr/local/lib/lecodes-cli" : join42(HOME, ".local", "lib", "lecodes-cli")));
+  const binDir = resolve24(flagStr(args, "bin") ?? (system ? "/usr/local/bin" : join42(HOME, ".local", "bin")));
+  const link2 = join42(binDir, "lecodes");
   try {
     copyBundle(bundle, libDir, companions);
-    chmodSync2(join38(libDir, "lecodes"), 493);
-    chmodSync2(join38(libDir, "chisel"), 493);
+    chmodSync2(join42(libDir, "lecodes"), 493);
+    chmodSync2(join42(libDir, "chisel"), 493);
   } catch (e2) {
     throw permError(e2, libDir, system);
   }
   try {
     mkdirSync27(binDir, { recursive: true });
-    rmSync12(link2, { force: true });
-    symlinkSync(join38(libDir, "lecodes"), link2);
+    rmSync13(link2, { force: true });
+    symlinkSync2(join42(libDir, "lecodes"), link2);
   } catch (e2) {
     throw permError(e2, binDir, system);
   }
   success(`Installed to ${c.bold(libDir)}`);
-  log(`  ${c.dim(link2 + " → " + join38(libDir, "lecodes"))}`);
+  log(`  ${c.dim(link2 + " → " + join42(libDir, "lecodes"))}`);
   finishPathUnix(args, binDir);
 };
 var shellRc = () => {
-  const shell = basename18(process.env.SHELL ?? "");
+  const shell = basename19(process.env.SHELL ?? "");
   if (shell === "zsh")
-    return { file: join38(HOME, ".zshrc"), name: "~/.zshrc" };
+    return { file: join42(HOME, ".zshrc"), name: "~/.zshrc" };
   if (shell === "bash")
-    return { file: join38(HOME, ".bashrc"), name: "~/.bashrc" };
-  return { file: join38(HOME, ".profile"), name: "~/.profile" };
+    return { file: join42(HOME, ".bashrc"), name: "~/.bashrc" };
+  return { file: join42(HOME, ".profile"), name: "~/.profile" };
 };
 var PATH_MARKER = "# Added by `lecodes install`";
 var appendPathToShellRc = (binDir) => {
   const { file, name } = shellRc();
   const line = `export PATH="${binDir}:$PATH"`;
   try {
-    const existing = existsSync37(file) ? readFileSync33(file, "utf8") : "";
+    const existing = existsSync41(file) ? readFileSync35(file, "utf8") : "";
     if (existing.includes(line))
       return name;
     appendFileSync3(file, `${existing && !existing.endsWith(`
@@ -226356,7 +227028,7 @@ var finishPathUnix = (args, binDir) => {
   log(`  • or install system-wide (no PATH edit): ${c.bold("sudo lecodes install --system")}`);
 };
 var installWindows = (args, bundle, companions) => {
-  const target = resolve22(flagStr(args, "dir") ?? join38(process.env.LOCALAPPDATA ?? join38(HOME, "AppData", "Local"), "Programs", "lecodes-cli"));
+  const target = resolve24(flagStr(args, "dir") ?? join42(process.env.LOCALAPPDATA ?? join42(HOME, "AppData", "Local"), "Programs", "lecodes-cli"));
   try {
     copyBundle(bundle, target, companions);
   } catch (e2) {
@@ -226384,7 +227056,7 @@ var installWindows = (args, bundle, companions) => {
 var addToUserPathWindows = (dir) => {
   const script = "$d = $env:LECODES_INSTALL_DIR;" + "$p = [Environment]::GetEnvironmentVariable('Path','User'); if (-not $p) { $p = '' };" + "$parts = @($p.Split(';') | Where-Object { $_ -ne '' });" + "if ($parts -notcontains $d) { [Environment]::SetEnvironmentVariable('Path', (@($parts + $d) -join ';'), 'User') }";
   try {
-    execFileSync7("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], { stdio: "ignore", env: { ...process.env, LECODES_INSTALL_DIR: dir } });
+    execFileSync8("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], { stdio: "ignore", env: { ...process.env, LECODES_INSTALL_DIR: dir } });
     return true;
   } catch {
     return false;
@@ -226395,9 +227067,9 @@ var addToUserPathWindows = (dir) => {
 init_util();
 
 // src/projectEnv.ts
-import { existsSync as existsSync38, readFileSync as readFileSync34 } from "node:fs";
-import { homedir as homedir10 } from "node:os";
-import { dirname as dirname20, join as join39, resolve as resolve23 } from "node:path";
+import { existsSync as existsSync42, readFileSync as readFileSync36 } from "node:fs";
+import { homedir as homedir11 } from "node:os";
+import { dirname as dirname23, join as join43, resolve as resolve25 } from "node:path";
 var KEY_RE = /^(LECODES|CREATOR)_[A-Z0-9_]+$/;
 var parseDotEnv = (text) => {
   const out = {};
@@ -226432,19 +227104,19 @@ var applyDotEnv = (parsed, dir, env) => {
       continue;
     let value = raw;
     if (value.startsWith("./") || value.startsWith("../"))
-      value = resolve23(dir, value);
+      value = resolve25(dir, value);
     else if (value === "~" || value.startsWith("~/"))
-      value = join39(homedir10(), value.slice(1));
+      value = join43(homedir11(), value.slice(1));
     out[key] = value;
   }
   return out;
 };
 var findEnvRoot = (start) => {
-  let dir = resolve23(start);
+  let dir = resolve25(start);
   while (true) {
-    if (existsSync38(join39(dir, "app.json")) || existsSync38(join39(dir, ".lecodes")))
+    if (existsSync42(join43(dir, "app.json")) || existsSync42(join43(dir, ".lecodes")))
       return dir;
-    const parent = dirname20(dir);
+    const parent = dirname23(dir);
     if (parent === dir)
       return null;
     dir = parent;
@@ -226455,10 +227127,10 @@ var loadProjectEnv = (cwd = process.cwd()) => {
     const root = findEnvRoot(cwd);
     if (!root)
       return [];
-    const file = join39(root, ".env");
-    if (!existsSync38(file))
+    const file = join43(root, ".env");
+    if (!existsSync42(file))
       return [];
-    const added = applyDotEnv(parseDotEnv(readFileSync34(file, "utf8")), root, process.env);
+    const added = applyDotEnv(parseDotEnv(readFileSync36(file, "utf8")), root, process.env);
     for (const [k, v] of Object.entries(added))
       process.env[k] = v;
     return Object.keys(added);
@@ -226468,12 +227140,12 @@ var loadProjectEnv = (cwd = process.cwd()) => {
 };
 
 // src/index.ts
-var STANDALONE = (() => {
-  const dir = dirname21(process.execPath);
+var STANDALONE2 = (() => {
+  const dir = dirname24(process.execPath);
   const chisel = process.platform === "win32" ? "chisel.exe" : "chisel";
-  return existsSync39(join40(dir, "runtime")) && existsSync39(join40(dir, chisel));
+  return existsSync43(join44(dir, "runtime")) && existsSync43(join44(dir, chisel));
 })();
-var INSTALLED = STANDALONE && (() => {
+var INSTALLED = STANDALONE2 && (() => {
   const exe = process.platform === "win32" ? "lecodes.exe" : "lecodes";
   const self2 = (() => {
     try {
@@ -226482,18 +227154,18 @@ var INSTALLED = STANDALONE && (() => {
       return process.execPath;
     }
   })();
-  return (process.env.PATH ?? "").split(delimiter2).some((d) => {
+  return (process.env.PATH ?? "").split(delimiter3).some((d) => {
     if (!d)
       return false;
     try {
-      const cand = join40(d, exe);
-      return existsSync39(cand) && realpathSync2(cand) === self2;
+      const cand = join44(d, exe);
+      return existsSync43(cand) && realpathSync2(cand) === self2;
     } catch {
       return false;
     }
   });
 })();
-var INSTALL_HELP = STANDALONE && !INSTALLED ? `
+var INSTALL_HELP = STANDALONE2 && !INSTALLED ? `
   install                       Install this standalone build so 'lecodes' is on your PATH
                                   (copies the bundle to a library folder + a symlink/PATH entry).
                                   --modify-path   also add it to PATH (edits your shell rc / user PATH)
@@ -226555,6 +227227,9 @@ ${c.bold("Commands:")}
                                   --host <ip>     LAN address to advertise (default: auto-detect)
                                   --entry <path>  override the entrypoint
                                   --no-qr         don't render the QR code
+                                  --web           also open the app in the browser (Web Lite host:
+                                                    same bundle + hot reload, camera/map plugins
+                                                    have web twins; the /web/ URL is served always)
                                   --desktop       also open the app in the native desktop host
                                                     (same hot reload; window from app.json's
                                                     desktop block; closing it keeps the server)
@@ -226580,6 +227255,11 @@ ${c.bold("Commands:")}
                                   -o, --out <file>   write JSON to a file instead of stdout
                                   --png [file]       rasterize a PNG (default screenshot.png;
                                                        needs @napi-rs/canvas)
+                                  --map [file]       draw the 3D scene's annotated top-down map
+                                                       (grid + XZ footprints + named markers) as
+                                                       <file>.png + <file>.json world-space data
+                                                       (default map.png; --label-all, --max-px N;
+                                                       also a { "map": "f.png" } script step)
                                   --script <file>    drive the app through a step list (tap/type/
                                                        scroll/wait/expect/screenshot/json steps;
                                                        games: frames/drag/hold/key/keyDown/keyUp,
@@ -226643,13 +227323,22 @@ ${c.bold("Commands:")}
                                                        render --desktop
                                   (+ the render timing flags: --width/--height, --settle,
                                    --device, --safe-area, --wait-network, --logs, --entry)
-  types [dir]                   Refresh the IDE types (.lecodes/types/ + tsconfig.json) — by
-                                  default from the server, so a project scaffolded offline picks
-                                  up the SDK the platform actually runs
-                                  --local            use the SDK bundled in this CLI instead
-                                  --check            report drift only, don't write (non-zero exit)
-                                  --api <url>        server to fetch from (default: the logged-in
-                                                       one, else https://le.codes)
+  update                        Move everything a project depends on to its newest published
+                                  state, in dependency order: the desktop host ('desktop
+                                  update'), matc ('shaders update'), the project's shader
+                                  compiles, the IDE types (.lecodes/types/ + tsconfig.json,
+                                  from the server — the former 'lecodes types'), the
+                                  ios/android shell pins ('app update'), then the GLOBAL npm
+                                  installs: every installed optional peer (lecodes-renderer,
+                                  lecodes-design, lecodes-3d-editor, lecodes-assets) and this
+                                  CLI that is behind npm's latest gets 'npm install -g'.
+                                  Pinned tools are skipped, not overridden: LECODES_DESKTOP_EXE
+                                  / LECODES_MATC mean a local build. Keeps going when a step
+                                  fails; the summary says which.
+                                  --local            types from the SDK bundled in this CLI
+                                  --no-shells        leave ios/android pins alone (no re-sync)
+                                  --check            npm step: report what's behind, install nothing
+                                  --no-cli           skip the npm step (offline)
   design [serve]                LeCodes Design — a live canvas of screens for AI-driven prototyping
                                   (needs the optional 'lecodes-design' package; works inside a
                                    cloned project or standalone in any folder)
@@ -226706,6 +227395,8 @@ ${c.bold("Commands:")}
                                           --probe        headless-render the staged folder to PNG
                                                          (macOS: a brief windowed run + snapshot)
                                           --zip          also pack the result for sending
+                                          --dmg          macOS: also build a drag-to-Applications
+                                                         disk image (signed + notarized too)
                                           --sign <identity|adhoc>   macOS codesign identity
                                           --notarize <profile> / --no-notarize   macOS
                                           --zip          <out>.zip, UTF-8/forward-slash entries
@@ -226743,6 +227434,13 @@ ${c.bold("Commands:")}
                                   --port <n>         editor-server port (default 4488)
                                   --no-open          don't open the browser
                                   --no-mcp           don't register the MCP server in .mcp.json
+  thumbs [path…]                Asset thumbnails for the scene editor, WITHOUT a browser: decodes
+                                  the project's images (KTX2 too, via KTX-Software's ktx tool) into the
+                                  editor's preview cache. Incremental — the cached name carries the
+                                  asset's content hash, so unchanged files are skipped. Models,
+                                  materials and prefabs are rendered by the editor, not here
+                                  --force            redo even the up-to-date ones
+                                  --size <px>        longest edge (default 256)
   assets convert <model.fbx|.glb> [--clips a.fbx b.fbx …] [-o out.glb] [--drop-model-clips]
                                   [--fix] [--ktx2|--ktx2-hq]
                                 FBX → LeCodes-ready GLB: meters/Y-up, textures embedded, clips from
@@ -226841,35 +227539,10 @@ Config lives in ~/.lecodes/config.json (override with LECODES_API / LECODES_TOKE
 A .env next to app.json is read at startup for LECODES_* / CREATOR_* keys (the shell's own
 environment wins; ./ paths resolve against the project; the file is never pushed) — e.g.
 LECODES_DESKTOP_EXE, LECODES_MATC, LECODES_NOTARY_PROFILE, LECODES_MACOS_SIGN_ID, LECODES_TOKEN.`;
-var commands = { init: init2, login, create, clone: clone3, link, status: status3, diff: diff2, pull, push, compile: compile2, preview: previewLegacy, render, test, types: types4, design, scene, dev, app, pn, desktop, shaders, assets, lightmap, navmesh };
-if (STANDALONE)
+var commands = { init: init2, login, create, clone: clone3, link, status: status3, diff: diff2, pull, push, compile: compile2, preview: previewLegacy, render, test, design, scene, thumbs, dev, app, pn, desktop, shaders, assets, lightmap, navmesh, update };
+if (STANDALONE2)
   commands.install = install;
 var readVersion = () => package_default.version ?? "unknown";
-var OPTIONAL_PEERS = [
-  ["lecodes-renderer", "lecodes-renderer/headless"],
-  ["lecodes-design", "lecodes-design/server"],
-  ["lecodes-3d-editor", "lecodes-3d-editor/server"],
-  ["lecodes-assets", "lecodes-assets/cli"]
-];
-var peerVersion = (name, probe) => {
-  try {
-    const require2 = createRequire4(import.meta.url);
-    let dir = dirname21(require2.resolve(probe));
-    for (let depth = 0;depth < 16; depth++) {
-      const manifest = join40(dir, "package.json");
-      if (existsSync39(manifest)) {
-        const parsed = JSON.parse(readFileSync35(manifest, "utf8"));
-        if (parsed.name === name)
-          return parsed.version ?? "unknown";
-      }
-      const parent = dirname21(dir);
-      if (parent === dir)
-        break;
-      dir = parent;
-    }
-  } catch {}
-  return null;
-};
 var printVersion = () => {
   const rows = [["lecodes-cli", readVersion()]];
   for (const [name, probe] of OPTIONAL_PEERS) {