lecodes-cli 0.10.1 → 0.10.3

package/dist/index.js

@@ -47,6 +47,41 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// ../sdk/src/compile/assetName.ts
+var inRanges = (cp, ranges) => ranges.some(([from, to]) => cp >= from && cp <= to), INVISIBLE, ODD_SPACE, ILLEGAL = '/\\:*?"<>|', sanitizeAssetName = (name) => {
+  let out = "";
+  for (const ch of name.normalize("NFC")) {
+    const cp = ch.codePointAt(0);
+    if (inRanges(cp, INVISIBLE))
+      continue;
+    out += inRanges(cp, ODD_SPACE) ? " " : ILLEGAL.includes(ch) ? "_" : ch;
+  }
+  return out.replace(/ {2,}/g, " ").replace(/^ +/, "").replace(/[ .]+$/, "");
+}, isCanonicalAssetName = (name) => sanitizeAssetName(name) === name;
+var init_assetName = __esm(() => {
+  INVISIBLE = [
+    [0, 31],
+    [127, 159],
+    [173, 173],
+    [1564, 1564],
+    [6158, 6158],
+    [8203, 8207],
+    [8232, 8233],
+    [8234, 8238],
+    [8288, 8292],
+    [8294, 8303],
+    [65279, 65279]
+  ];
+  ODD_SPACE = [
+    [160, 160],
+    [5760, 5760],
+    [8192, 8202],
+    [8239, 8239],
+    [8287, 8287],
+    [12288, 12288]
+  ];
+});
+
 // ../sdk/src/compile/assetMacro.ts
 var ASSET_RE, hasAssetMacro = (src) => src.includes("asset("), desugarAssetMacros = (src, filePath) => {
   const byPath = new Map;
@@ -129,18 +164,18 @@ var init_libraryImports = __esm(() => {
 });
 
 // ../sdk/src/compile/bundler.ts
-import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync } from "node:fs";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { createRequire as createRequire2 } from "node:module";
 import { dirname as dirname4, join as join7, relative as relative2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var resolveInject = () => {
   const override = process.env.LECODES_SDK_INJECT;
-  if (override && existsSync4(override))
+  if (override && existsSync5(override))
     return override;
   const here = dirname4(fileURLToPath2(import.meta.url));
   const src = join7(here, "..", "inject.ts");
-  if (existsSync4(src))
+  if (existsSync5(src))
     return src;
   throw new Error("sdk: could not locate the inject source (LECODES_SDK_INJECT / src/inject.ts)");
 }, normalize = (path) => {
@@ -180,13 +215,13 @@ var resolveInject = () => {
 }, resolveChiselBin = () => {
   const override = process.env.LECODES_CHISEL_BIN;
   if (override) {
-    if (existsSync4(override))
+    if (existsSync5(override))
       return override;
     throw new Error(`LECODES_CHISEL_BIN points at a missing file: ${override}`);
   }
   try {
     const bin = createRequire2(import.meta.url)("@letary/chisel").binaryPath();
-    if (bin && existsSync4(bin))
+    if (bin && existsSync5(bin))
       return bin;
   } catch {}
   throw new Error("chisel binary not found. Install @letary/chisel, or set LECODES_CHISEL_BIN.");
@@ -462,11 +497,11 @@ var init_compileProject = __esm(() => {
 });
 
 // ../sdk/src/compile/sceneEditor.ts
-import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync8 } from "node:fs";
 import { join as join8 } from "node:path";
 var SCENE_HARNESS_DIR = "./.scene-editor", SCENE_ENTRY_PATH = "./.scene-entry.ts", loadSceneHarness = (fallbackDir) => {
   const override = process.env.LECODES_SCENE_HARNESS_DIR;
-  const dir = override && existsSync5(override) ? override : fallbackDir && existsSync5(fallbackDir) ? fallbackDir : null;
+  const dir = override && existsSync6(override) ? override : fallbackDir && existsSync6(fallbackDir) ? fallbackDir : null;
   if (!dir)
     throw new Error("scene-editor harness sources not found (set LECODES_SCENE_HARNESS_DIR)");
   const out = {};
@@ -1043,9 +1078,11 @@ __export(exports_compile, {
   scanModulesFallback: () => scanModulesFallback,
   scanModulesChisel: () => scanModulesChisel,
   scanFontCalls: () => scanFontCalls,
+  sanitizeAssetName: () => sanitizeAssetName,
   parseSfnt: () => parseSfnt,
   offsetSourceMap: () => offsetSourceMap,
   loadSceneHarness: () => loadSceneHarness,
+  isCanonicalAssetName: () => isCanonicalAssetName,
   inlineSourceMapComment: () => inlineSourceMapComment,
   fontRegistryBase: () => fontRegistryBase,
   faceFileName: () => faceFileName,
@@ -1066,6 +1103,7 @@ __export(exports_compile, {
 var init_compile = __esm(() => {
   init_bundler();
   init_detectEntry();
+  init_assetName();
   init_compileProject();
   init_sceneEditor();
   init_fontMacro();
@@ -2091,7 +2129,7 @@ var require_main = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "lecodes-cli",
-  version: "0.10.1",
+  version: "0.10.3",
   dependencies: {
     "@letary/chisel": "^0.6.0"
   },
@@ -2150,7 +2188,7 @@ var package_default = {
 
 // src/commands/app.ts
 import { execFileSync } from "node:child_process";
-import { cpSync, existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync10, readdirSync as readdirSync4, rmSync, statSync as statSync2, writeFileSync as writeFileSync7 } from "node:fs";
+import { cpSync, existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync10, readdirSync as readdirSync4, rmSync, statSync as statSync2, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { basename as basename4, dirname as dirname7, join as join11, resolve as resolve2 } from "node:path";
 
@@ -2159,6 +2197,7 @@ import { dirname, join } from "node:path";
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 
 // src/util.ts
+init_assetName();
 import { createHash } from "node:crypto";
 import { createInterface } from "node:readline";
 var useColor = process.stdout.isTTY && process.env.NO_COLOR === undefined;
@@ -2204,7 +2243,10 @@ var toKey = (path) => {
   const parts = path.replace(/\\/g, "/").split("/").map((p) => p.trim()).filter((p) => p && p !== ".");
   if (parts.some((p) => p === ".."))
     throw new CliError(`Unsafe path: ${path}`);
-  return "/" + parts.join("/");
+  const names = parts.map((p) => sanitizeAssetName(p));
+  if (names.some((name) => !name))
+    throw new CliError(`Wrong path: ${path}`);
+  return "/" + names.join("/");
 };
 var prompt = (question, fallback) => new Promise((resolve) => {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -2493,7 +2535,8 @@ import { readFileSync as readFileSync5 } from "node:fs";
 import { basename } from "node:path";
 
 // src/localFiles.ts
-import { readdirSync, readFileSync as readFileSync4 } from "node:fs";
+init_assetName();
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync4 } from "node:fs";
 import { join as join4, relative } from "node:path";
 var SKIP_DIRS = new Set([".lecodes", ".git", "node_modules"]);
 var SKIP_FILES = new Set(["tsconfig.json", "jsconfig.json", ".gitignore", ".lecodesignore", ".DS_Store"]);
@@ -2575,6 +2618,23 @@ var scanLocal = (root, opts = {}) => {
   walk(root, false);
   return { files, dirs, ignored };
 };
+var resolveLocalPath = (root, key) => {
+  const direct = join4(root, key.slice(1));
+  if (existsSync3(direct))
+    return direct;
+  let dir = root;
+  try {
+    for (const name of key.slice(1).split("/")) {
+      const match = readdirSync(dir).find((entry) => entry === name || sanitizeAssetName(entry) === name);
+      if (!match)
+        return null;
+      dir = join4(dir, match);
+    }
+  } catch {
+    return null;
+  }
+  return dir;
+};
 var scanProject = (root, manifest) => scanLocal(root, { ignore: loadIgnore(root), tracked: new Set(Object.keys(manifest.files)) });
 var diffLocal = (manifest, scan) => {
   const added = [];
@@ -2698,12 +2758,12 @@ var collectLocalEntries = (root, manifest, assetBase) => {
 };
 
 // src/compile/projectCompile.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname5, join as join9 } from "node:path";
 
 // src/distRoot.ts
-import { existsSync as existsSync3 } from "node:fs";
+import { existsSync as existsSync4 } from "node:fs";
 import { dirname as dirname3, join as join6 } from "node:path";
 import { fileURLToPath } from "node:url";
 var distRoot = (() => {
@@ -2712,7 +2772,7 @@ var distRoot = (() => {
     dirname3(process.execPath)
   ];
   for (const c2 of candidates)
-    if (existsSync3(join6(c2, "runtime")))
+    if (existsSync4(join6(c2, "runtime")))
       return c2;
   return candidates[0];
 })();
@@ -2720,7 +2780,7 @@ var distRoot = (() => {
 // src/compile/projectCompile.ts
 init_compile();
 var vendoredInject = join9(distRoot, "runtime", "sdk", "inject.ts");
-if (existsSync6(vendoredInject))
+if (existsSync7(vendoredInject))
   process.env.LECODES_SDK_INJECT = vendoredInject;
 var resolveChiselBin2 = () => {
   if (process.env.LECODES_CHISEL_BIN)
@@ -2731,7 +2791,7 @@ var resolveChiselBin2 = () => {
       return fromPkg;
   } catch {}
   const local = join9(dirname5(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel");
-  return existsSync6(local) ? local : null;
+  return existsSync7(local) ? local : null;
 };
 var chiselBin = resolveChiselBin2();
 if (chiselBin)
@@ -2759,7 +2819,7 @@ var compileProject2 = (opts) => compileProject({
 // src/compile/fonts.ts
 init_compile();
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname6, join as join10 } from "node:path";
 var applyProjectFonts = async (entries, opts) => {
   const registry = (opts.registry ?? fontRegistryBase()).replace(/\/+$/, "");
@@ -2781,7 +2841,7 @@ var applyProjectFonts = async (entries, opts) => {
       const rel = `assets/fonts/${face.fileName}`;
       const abs = join10(vendorDir, rel);
       const entryPath = `${opts.vendorPrefix ?? ""}/${rel}`;
-      if (!existsSync7(abs))
+      if (!existsSync8(abs))
         await downloadFace(registry, vendorDir, face, rel, abs);
       if (!byPath().has(entryPath.replace(/^\//, ""))) {
         entries.push(opts.makeResourceEntry?.(entryPath, abs) ?? { path: entryPath, type: "resource", absPath: abs });
@@ -3733,7 +3793,7 @@ var FIRST_PARTY_PLUGINS = {
   "qr-scanner": "letary/lecodes-plugins"
 };
 var readJson = (path) => {
-  if (!existsSync8(path))
+  if (!existsSync9(path))
     return null;
   try {
     return JSON.parse(readFileSync10(path, "utf8"));
@@ -3773,7 +3833,7 @@ var fetchLatestSdkVersion = async () => {
 };
 var shellSdkVersion = (iosDir) => {
   const path = join11(iosDir, "LeCodesRuntime", "Package.swift");
-  if (!existsSync8(path))
+  if (!existsSync9(path))
     return null;
   const m = /lecodes-ios-sdk\.git",\s*(?:exact|from):\s*"([^"]+)"/.exec(readFileSync10(path, "utf8"));
   return m && VERSION_RE.test(m[1]) ? m[1] : null;
@@ -3804,7 +3864,7 @@ var ensureRepo = (repo, wantTag, lock) => {
   }
   const cache = join11(homedir2(), ".lecodes", "plugins", repo.replace("/", "__"));
   const url = `https://github.com/${repo}.git`;
-  if (!existsSync8(join11(cache, ".git"))) {
+  if (!existsSync9(join11(cache, ".git"))) {
     mkdirSync5(dirname7(cache), { recursive: true });
     note(`Cloning ${url}…`);
     git(dirname7(cache), "clone", "--quiet", url, cache);
@@ -3877,7 +3937,7 @@ var appInit = async (args) => {
   }
   const root = projectRoot();
   const iosDir = join11(root, "ios");
-  if (existsSync8(iosDir)) {
+  if (existsSync9(iosDir)) {
     throw new CliError("ios/ already exists — run `lecodes app sync` to update it.");
   }
   const existing = readJson(join11(root, "app.json")) ?? {};
@@ -3905,7 +3965,7 @@ var appInit = async (args) => {
   writeJson(join11(root, "app.json"), config);
   log(`${c.green("written")}   app.json`);
   const ignorePath = join11(root, ".lecodesignore");
-  const ignore = existsSync8(ignorePath) ? readFileSync10(ignorePath, "utf8") : DEFAULT_IGNORE_FILE;
+  const ignore = existsSync9(ignorePath) ? readFileSync10(ignorePath, "utf8") : DEFAULT_IGNORE_FILE;
   if (!/^ios\/$/m.test(ignore)) {
     writeFileSync7(ignorePath, ignore.replace(/\n*$/, `
 `) + `
@@ -3982,7 +4042,7 @@ var ensureSdkResourcesBundle = async (sdkVersion) => {
   }
   const dir = join11(homedir2(), ".lecodes", "sdk-resources", sdkVersion);
   const bundle = join11(dir, "LeCodesSDKResources.bundle");
-  if (existsSync8(bundle))
+  if (existsSync9(bundle))
     return bundle;
   const url = `https://github.com/${SDK_REPO}/releases/download/${sdkVersion}/LeCodesSDKResources.bundle.zip`;
   note(`Downloading LeCodesSDKResources.bundle (SDK ${sdkVersion})…`);
@@ -3994,7 +4054,7 @@ var ensureSdkResourcesBundle = async (sdkVersion) => {
   writeFileSync7(zip, new Uint8Array(await res.arrayBuffer()));
   execFileSync("ditto", ["-x", "-k", zip, dir]);
   rmSync(zip);
-  if (!existsSync8(bundle))
+  if (!existsSync9(bundle))
     throw new CliError(`No LeCodesSDKResources.bundle inside the release asset ${url}`);
   return bundle;
 };
@@ -4021,7 +4081,7 @@ var appSync = async (_args) => {
   const root = projectRoot();
   const config = readJson(join11(root, "app.json"));
   const iosDir = join11(root, "ios");
-  if (!config?.ios || !existsSync8(iosDir)) {
+  if (!config?.ios || !existsSync9(iosDir)) {
     throw new CliError("No iOS shell here — run `lecodes app init ios` first.");
   }
   const requestedVariant = config.ios.variant ?? "auto";
@@ -4046,7 +4106,7 @@ var appSync = async (_args) => {
     if (!module || !register)
       throw new CliError(`Plugin "${id}": manifest ios.module / ios.register missing`);
     const src = join11(plugin.dir, ios.sources ?? "ios");
-    if (!existsSync8(src))
+    if (!existsSync9(src))
       throw new CliError(`Plugin "${id}": sources dir ${src} missing`);
     const dest = join11(sourcesDir, module);
     rmSync(dest, { recursive: true, force: true });
@@ -4062,7 +4122,7 @@ var appSync = async (_args) => {
     log(`${c.green("plugin")}    ${id}@${plugin.lock.version} (${plugin.lock.tag} → Sources/${module})`);
   }
   const keep = new Set(["LeCodesRuntime", ...runtimePlugins.map((p) => p.module)]);
-  for (const entry of existsSync8(sourcesDir) ? readdirSync4(sourcesDir) : []) {
+  for (const entry of existsSync9(sourcesDir) ? readdirSync4(sourcesDir) : []) {
     if (!keep.has(entry) && statSync2(join11(sourcesDir, entry)).isDirectory()) {
       rmSync(join11(sourcesDir, entry), { recursive: true });
       log(`${c.yellow("removed")}   ios/LeCodesRuntime/Sources/${entry}  (plugin uninstalled)`);
@@ -4136,7 +4196,7 @@ var appSync = async (_args) => {
   writeFileSync7(join11(iosDir, "App", "Info.plist"), infoPlistTemplate(mergedKeys, updateUrl));
   if (updateUrl)
     log(`${c.green("update")}    OTA source ${updateUrl} — checked natively at launch, new code applies next launch`);
-  if (pluginSpecs.length > 0 || existsSync8(lockPath))
+  if (pluginSpecs.length > 0 || existsSync9(lockPath))
     writeJson(lockPath, { plugins: newLock });
   const pbxPath = join11(iosDir, "App.xcodeproj", "project.pbxproj");
   const pbx = readFileSync10(pbxPath, "utf8").replace(/MARKETING_VERSION = [^;]+;/g, `MARKETING_VERSION = ${config.version ?? "1.0.0"};`).replace(/CURRENT_PROJECT_VERSION = [^;]+;/g, `CURRENT_PROJECT_VERSION = ${config.ios.buildNumber ?? 1};`);
@@ -4226,7 +4286,7 @@ var exportOptionsPlist = (method, teamId, destination) => `<?xml version="1.0" e
 var requireShell = () => {
   const root = projectRoot();
   const config = readJson(join11(root, "app.json"));
-  if (!config?.ios || !existsSync8(join11(root, "ios"))) {
+  if (!config?.ios || !existsSync9(join11(root, "ios"))) {
     throw new CliError("No iOS shell here — run `lecodes app init ios` first.");
   }
   return { root, config };
@@ -4302,7 +4362,7 @@ var appUpdate = async (args) => {
       log(`${c.green("plugin")}    ${id} ${entry?.tag ?? "—"} → ${c.bold(tag)}`);
       changed = true;
     }
-    if (!checkOnly && existsSync8(lockPath))
+    if (!checkOnly && existsSync9(lockPath))
       writeJson(lockPath, { plugins: kept });
   }
   log("");
@@ -4336,18 +4396,18 @@ var appDoctor = async (_args) => {
   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 = join11(root, "ios", "App", "Assets.xcassets", "AppIcon.appiconset");
-  const hasIcon = existsSync8(iconDir) && readdirSync4(iconDir).some((f2) => f2.endsWith(".png"));
+  const hasIcon = existsSync9(iconDir) && readdirSync4(iconDir).some((f2) => f2.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 = join11(root, "ios", "App", "Resources", "app.js");
-  check(existsSync8(bundle), "Bundled app.js", "run `lecodes app sync`");
+  check(existsSync9(bundle), "Bundled app.js", "run `lecodes app sync`");
   const requestedVariant = config.ios.variant ?? "auto";
   const validVariant = requestedVariant === "auto" || SDK_VARIANTS.includes(requestedVariant);
   check(validVariant, `ios.variant "${requestedVariant}"`, `use "auto" or one of ${SDK_VARIANTS.join(", ")}`);
-  if (existsSync8(bundle) && validVariant) {
+  if (existsSync9(bundle) && validVariant) {
     const { variant } = resolveVariant(requestedVariant, readFileSync10(bundle, "utf8"));
     const pkg = readFileSync10(join11(root, "ios", "LeCodesRuntime", "Package.swift"), "utf8");
     const needsResources = variant === "3d" || variant === "full";
-    const hasResources = existsSync8(join11(root, "ios", "App", "Resources", "LeCodesSDKResources.bundle"));
+    const hasResources = existsSync9(join11(root, "ios", "App", "Resources", "LeCodesSDKResources.bundle"));
     check(pkg.includes(`"LeCodesSDK-${variant}"`) && (!needsResources || hasResources), `SDK variant ${variant}${needsResources ? " (+ filament resources)" : ""}`, "run `lecodes app sync`");
   }
   const linked = shellSdkVersion(join11(root, "ios"));
@@ -4419,7 +4479,7 @@ var appBuild = async (args) => {
 };
 var appUpload = async (args) => {
   const { root, config } = requireShell();
-  if (!existsSync8(join11(root, ARCHIVE_PATH))) {
+  if (!existsSync9(join11(root, ARCHIVE_PATH))) {
     throw new CliError("No archive at ios/build/App.xcarchive — run `lecodes app build ios` first.");
   }
   const ascPath = join11(homedir2(), ".lecodes", "asc.json");
@@ -4431,7 +4491,7 @@ var appUpload = async (args) => {
     throw new CliError(`App Store Connect API key needed: --key-path <AuthKey.p8> --key-id <id> --issuer-id <id>
 (create one at appstoreconnect.apple.com → Users and Access → Integrations; stored in ~/.lecodes/asc.json after first use)`);
   }
-  if (!existsSync8(keyPath))
+  if (!existsSync9(keyPath))
     throw new CliError(`API key file not found: ${keyPath}`);
   if (flagStr(args, "key-path")) {
     mkdirSync5(dirname7(ascPath), { recursive: true });
@@ -4469,7 +4529,7 @@ var appOpen = async (args) => {
   const platform = args._[1] ?? "ios";
   if (platform === "ios") {
     const proj = join11(root, "ios", "App.xcodeproj");
-    if (!existsSync8(proj))
+    if (!existsSync9(proj))
       throw new CliError("No iOS shell here — run `lecodes app init ios` first.");
     if (process.platform !== "darwin")
       throw new CliError("Opening Xcode requires macOS.");
@@ -4504,12 +4564,12 @@ var app = async (args) => {
 };
 
 // src/commands/clone.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync7, readdirSync as readdirSync6 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync7, readdirSync as readdirSync6 } from "node:fs";
 import { resolve as resolve3 } from "node:path";
 
 // src/types.ts
 import { dirname as dirname8, join as join12, relative as relative3, sep } from "node:path";
-import { existsSync as existsSync9, mkdirSync as mkdirSync6, readdirSync as readdirSync5, readFileSync as readFileSync11, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync6, readdirSync as readdirSync5, readFileSync as readFileSync11, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync8 } from "node:fs";
 var TSCONFIG = {
   compilerOptions: {
     target: "ES2020",
@@ -4527,7 +4587,7 @@ var TSCONFIG = {
   exclude: ["node_modules"]
 };
 var listBundleFiles = (dir, base = dir) => {
-  if (!existsSync9(dir))
+  if (!existsSync10(dir))
     return [];
   const out = [];
   for (const name of readdirSync5(dir)) {
@@ -4540,7 +4600,7 @@ var listBundleFiles = (dir, base = dir) => {
   return out;
 };
 var pruneEmptyDirs = (dir, root) => {
-  if (!existsSync9(dir) || !statSync3(dir).isDirectory())
+  if (!existsSync10(dir) || !statSync3(dir).isDirectory())
     return;
   for (const name of readdirSync5(dir))
     pruneEmptyDirs(join12(dir, name), root);
@@ -4586,7 +4646,7 @@ var readLocalTypeBundle = () => {
     join12(distRoot, "..", "sdk", "dist", "types.json")
   ];
   for (const path of candidates) {
-    if (existsSync9(path)) {
+    if (existsSync10(path)) {
       try {
         return JSON.parse(readFileSync11(path, "utf8"));
       } catch {}
@@ -4624,7 +4684,7 @@ var clone = async (args) => {
   const project = await getProject(apiUrl, token, uuid);
   const dir = args._[1] ?? slug(project.name);
   const root = resolve3(dir);
-  if (existsSync10(root) && readdirSync6(root).length > 0) {
+  if (existsSync11(root) && readdirSync6(root).length > 0) {
     throw new CliError(`Directory "${dir}" already exists and is not empty.`);
   }
   mkdirSync7(root, { recursive: true });
@@ -4644,7 +4704,7 @@ var clone = async (args) => {
 };
 
 // src/commands/create.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync8, readdirSync as readdirSync7, writeFileSync as writeFileSync9 } from "node:fs";
+import { existsSync as existsSync12, mkdirSync as mkdirSync8, readdirSync as readdirSync7, writeFileSync as writeFileSync9 } from "node:fs";
 import { join as join13, resolve as resolve4 } from "node:path";
 
 // src/commands/projectTemplates.ts
@@ -4731,7 +4791,7 @@ var create = async (args) => {
     throw new CliError("Usage: lecodes create <name> [directory]");
   const dir = args._[1] ?? slug2(name);
   const root = resolve4(dir);
-  if (existsSync11(root) && readdirSync7(root).length > 0) {
+  if (existsSync12(root) && readdirSync7(root).length > 0) {
     throw new CliError(`Directory "${dir}" already exists and is not empty.`);
   }
   mkdirSync8(root, { recursive: true });
@@ -4750,7 +4810,7 @@ var create = async (args) => {
 };
 
 // src/commands/design.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync10, readFileSync as readFileSync14, readdirSync as readdirSync8, writeFileSync as writeFileSync11, appendFileSync } from "node:fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync10, readFileSync as readFileSync14, readdirSync as readdirSync8, writeFileSync as writeFileSync11, appendFileSync } from "node:fs";
 import { basename as basename6, join as join15 } from "node:path";
 
 // src/compile/designCompile.ts
@@ -4759,7 +4819,7 @@ import { basename as basename5 } from "node:path";
 
 // src/compile/assetIcons.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync12, mkdirSync as mkdirSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "node:fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "node:fs";
 import { dirname as dirname9, join as join14 } from "node:path";
 var DEFAULT_REGISTRY = process.env.LECODES_ICON_REGISTRY?.trim() || "https://icon-registry.jt3.ru/v1";
 var ICON_ID = /^([a-z0-9]+(?:-[a-z0-9]+)*):([a-z0-9]+(?:-[a-z0-9]+)*)$/;
@@ -5056,7 +5116,7 @@ var renderNotices2 = (lock) => {
 `);
 };
 var writeIfChanged2 = (path, text) => {
-  const current = existsSync12(path) ? safeRead(path) : null;
+  const current = existsSync13(path) ? safeRead(path) : null;
   if (current === text)
     return false;
   writeFileSync10(path, text);
@@ -5735,7 +5795,7 @@ var getContext = (args) => {
 };
 var listScreens = (designDir) => {
   const dir = join15(designDir, "screens");
-  if (!existsSync13(dir))
+  if (!existsSync14(dir))
     return [];
   return readdirSync8(dir).filter((f2) => f2.endsWith(".ts") && !f2.startsWith(".")).map((f2) => f2.slice(0, -3)).sort();
 };
@@ -5751,7 +5811,7 @@ var writeMcpConfig = (ctx, port) => {
   const path = join15(ctx.root, ".mcp.json");
   const entry = { type: "http", url: `http://localhost:${port}/mcp` };
   let config = {};
-  if (existsSync13(path)) {
+  if (existsSync14(path)) {
     try {
       config = JSON.parse(readFileSync14(path, "utf8"));
     } catch {
@@ -5785,7 +5845,7 @@ var init = async (ctx, args) => {
   let created = 0;
   for (const [rel, content] of files) {
     const abs = join15(ctx.designDir, rel);
-    if (existsSync13(abs)) {
+    if (existsSync14(abs)) {
       note(`kept      ${ctx.dirName}/${rel.replace(/\\/g, "/")}`);
       continue;
     }
@@ -5795,7 +5855,7 @@ var init = async (ctx, args) => {
   }
   const ignorePath = join15(ctx.root, ".lecodesignore");
   const ignoreLine = `${ctx.dirName}/.snapshots/`;
-  const current = existsSync13(ignorePath) ? readFileSync14(ignorePath, "utf8") : "";
+  const current = existsSync14(ignorePath) ? readFileSync14(ignorePath, "utf8") : "";
   if (!current.split(/\r?\n/).includes(ignoreLine)) {
     appendFileSync(ignorePath, (current && !current.endsWith(`
 `) ? `
@@ -5917,7 +5977,7 @@ var snapshot = async (ctx, args) => {
   }
 };
 var serve = async (ctx, args) => {
-  if (!existsSync13(ctx.designDir)) {
+  if (!existsSync14(ctx.designDir)) {
     throw new CliError(`No ${ctx.dirName}/ folder here. Run "lecodes design init" to scaffold it.`);
   }
   let designServer;
@@ -5990,7 +6050,7 @@ var serve = async (ctx, args) => {
     openBrowser(server.url);
 };
 var arrange = async (ctx, args) => {
-  if (!existsSync13(ctx.designDir)) {
+  if (!existsSync14(ctx.designDir)) {
     throw new CliError(`No ${ctx.dirName}/ folder here. Run "lecodes design init" to scaffold it.`);
   }
   let designServer;
@@ -6026,7 +6086,7 @@ var share = async (ctx, args) => {
   note("Turn it off with:  lecodes design share --off");
 };
 var check = async (ctx, args) => {
-  if (!existsSync13(ctx.designDir)) {
+  if (!existsSync14(ctx.designDir)) {
     throw new CliError(`No ${ctx.dirName}/ folder here. Run "lecodes design init" to scaffold it.`);
   }
   let designServer;
@@ -6102,12 +6162,11 @@ var design = async (args) => {
 import { existsSync as existsSync15, mkdirSync as mkdirSync11, readFileSync as readFileSync15, watch, writeFileSync as writeFileSync12 } from "node:fs";
 import { randomBytes as randomBytes2 } from "node:crypto";
 import { networkInterfaces } from "node:os";
-import { basename as basename7, join as join17 } from "node:path";
+import { basename as basename7, join as join16 } from "node:path";
 
 // src/dev/devServer.ts
 import { createServer as createServer2 } from "node:http";
-import { createReadStream, existsSync as existsSync14, statSync as statSync4 } from "node:fs";
-import { join as join16 } from "node:path";
+import { createReadStream, statSync as statSync4 } from "node:fs";
 
 // src/dev/clientTemplates.ts
 var DEV_SCREEN_TS = `const title = "LeCodes Dev"
@@ -6476,8 +6535,8 @@ var startDevServer = async (options) => {
       } catch {
         return sendText(res, 400, "text/plain", "Bad path");
       }
-      const abs = join16(root, key.slice(1));
-      if (!existsSync14(abs) || !statSync4(abs).isFile())
+      const abs = resolveLocalPath(root, key);
+      if (!abs || !statSync4(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);
@@ -6560,14 +6619,14 @@ var pickLanAddress = () => {
   return null;
 };
 var loadDevToken = (root) => {
-  const path = join17(root, LECODES_DIR, "dev.json");
+  const path = join16(root, LECODES_DIR, "dev.json");
   try {
     const token2 = JSON.parse(readFileSync15(path, "utf8")).token;
     if (token2 && /^[a-z0-9]{8,}$/.test(token2))
       return token2;
   } catch {}
   const token = randomBytes2(6).toString("hex");
-  mkdirSync11(join17(root, LECODES_DIR), { recursive: true });
+  mkdirSync11(join16(root, LECODES_DIR), { recursive: true });
   writeFileSync12(path, JSON.stringify({ token }, null, 2) + `
 `);
   return token;
@@ -6680,7 +6739,7 @@ ${result.error}`);
     await printQr(server.url);
   log(`Scan the QR with the LeCodes app, or open:  ${c.bold(server.url)}`);
   note(`Older desktop builds (no websocket bridge): ${server.url}?t=poll`);
-  if (existsSync15(join17(root, LECODES_DIR, "manifest.json")))
+  if (existsSync15(join16(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.`);
@@ -6876,7 +6935,7 @@ var statusLabel = (e) => e.status === "added" ? c.green("  added    ") : e.statu
 
 // src/commands/init.ts
 import { existsSync as existsSync16, mkdirSync as mkdirSync12, writeFileSync as writeFileSync13 } from "node:fs";
-import { basename as basename9, dirname as dirname10, join as join18, resolve as resolve5 } from "node:path";
+import { basename as basename9, dirname as dirname10, join as join17, resolve as resolve5 } from "node:path";
 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\`.
 
@@ -6978,7 +7037,7 @@ var init2 = async (args) => {
   mkdirSync12(root, { recursive: true });
   let created = 0;
   const write = (rel, content) => {
-    const abs = join18(root, rel);
+    const abs = join17(root, rel);
     if (existsSync16(abs)) {
       note(`kept      ${rel}`);
       return;
@@ -7009,7 +7068,7 @@ var init2 = async (args) => {
 
 // src/commands/link.ts
 import { existsSync as existsSync17 } from "node:fs";
-import { basename as basename11, join as join19, resolve as resolve6 } from "node:path";
+import { basename as basename11, join as join18, resolve as resolve6 } from "node:path";
 
 // src/commands/push.ts
 import { basename as basename10 } from "node:path";
@@ -7172,7 +7231,7 @@ var link = async (args) => {
   const root = dirArg ? resolve6(dirArg) : process.cwd();
   if (!existsSync17(root))
     throw new CliError(`No such directory: ${root}`);
-  if (existsSync17(join19(root, LECODES_DIR, "manifest.json")) && !flagBool(args, "force")) {
+  if (existsSync17(join18(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;
@@ -7489,7 +7548,7 @@ var render = async (args) => {
 
 // src/commands/pull.ts
 import { existsSync as existsSync18, mkdirSync as mkdirSync14, rmSync as rmSync3, writeFileSync as writeFileSync15 } from "node:fs";
-import { dirname as dirname12, join as join20 } from "node:path";
+import { dirname as dirname12, join as join19 } from "node:path";
 var pull = async (args) => {
   const root = findProjectRoot(process.cwd());
   const manifest = readManifest(root);
@@ -7509,7 +7568,7 @@ var pull = async (args) => {
   const remotePaths = new Set([...buildPaths(project.assets).entries()].filter(([id]) => project.assets.find((a) => a.id === id)?.type !== "folder").map(([, path]) => path));
   for (const path of Object.keys(manifest.files)) {
     if (!remotePaths.has(path)) {
-      const abs = join20(root, ...path.replace(/^\//, "").split("/"));
+      const abs = join19(root, ...path.replace(/^\//, "").split("/"));
       if (existsSync18(abs))
         rmSync3(abs);
     }
@@ -7548,7 +7607,7 @@ 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 = join20(root, ...key.replace(/^\//, "").split("/"));
+    const abs = join19(root, ...key.replace(/^\//, "").split("/"));
     mkdirSync14(dirname12(abs), { recursive: true });
     let sha;
     if (asset.type === "file") {
@@ -7572,19 +7631,19 @@ var pullPaths = async (root, manifest, project, paths, apiUrl, token) => {
 
 // src/commands/scene.ts
 import { existsSync as existsSync20, readFileSync as readFileSync20, readdirSync as readdirSync9, statSync as statSync5, writeFileSync as writeFileSync16 } from "node:fs";
-import { basename as basename12, dirname as dirname13, join as join22, resolve as resolve8 } from "node:path";
+import { basename as basename12, dirname as dirname13, join as join21, resolve as resolve8 } from "node:path";
 
 // src/compile/sceneCompile.ts
 import { existsSync as existsSync19, readFileSync as readFileSync19 } from "node:fs";
-import { join as join21 } from "node:path";
+import { join as join20 } from "node:path";
 var TEXT_EXT = /\.(ts|js|json|svg|txt|md)$/i;
 var rel = (key) => key.replace(/^\//, "");
 var resolveHarness = (loadSceneHarness2) => {
-  const inRepo = join21(distRoot, "..", "projects", "src", "scene-editor");
+  const inRepo = join20(distRoot, "..", "projects", "src", "scene-editor");
   try {
     return loadSceneHarness2(existsSync19(inRepo) ? inRepo : undefined);
   } catch {
-    const vendored = join21(distRoot, "runtime", "scene-harness.json");
+    const vendored = join20(distRoot, "runtime", "scene-harness.json");
     if (existsSync19(vendored))
       return JSON.parse(readFileSync19(vendored, "utf8"));
     throw new CliError("scene-editor harness sources not found — reinstall the CLI or set LECODES_SCENE_HARNESS_DIR.");
@@ -7650,7 +7709,7 @@ var getContext2 = (args) => {
   return { root, manifest, name: manifest?.name ?? basename12(root) };
 };
 var writeMcpConfig2 = (root, port) => {
-  const path = join22(root, ".mcp.json");
+  const path = join21(root, ".mcp.json");
   const entry = { type: "http", url: `http://localhost:${port}/mcp` };
   let config = {};
   if (existsSync20(path)) {
@@ -7677,7 +7736,7 @@ var countScenes = (dir) => {
   for (const name of readdirSync9(dir)) {
     if (name === "node_modules" || name.startsWith("."))
       continue;
-    const full = join22(dir, name);
+    const full = join21(dir, name);
     if (statSync5(full).isDirectory())
       n += countScenes(full);
     else if (name.endsWith(".scene.ts"))
@@ -8044,13 +8103,13 @@ var types = async (args) => {
 // src/index.ts
 import { existsSync as existsSync23, readFileSync as readFileSync23, realpathSync as realpathSync2 } from "node:fs";
 import { createRequire as createRequire4 } from "node:module";
-import { delimiter as delimiter2, dirname as dirname16, join as join24 } from "node:path";
+import { delimiter as delimiter2, dirname as dirname16, join as join23 } from "node:path";
 
 // src/commands/install.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { appendFileSync as appendFileSync2, chmodSync, cpSync as cpSync2, existsSync as existsSync22, mkdirSync as mkdirSync15, readFileSync as readFileSync22, realpathSync, rmSync as rmSync4, symlinkSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { basename as basename13, delimiter, dirname as dirname15, join as join23, resolve as resolve11, sep as sep2 } from "node:path";
+import { basename as basename13, delimiter, dirname as dirname15, join as join22, resolve as resolve11, sep as sep2 } from "node:path";
 var isWin = process.platform === "win32";
 var HOME = homedir3();
 var safeRealpath = (p) => {
@@ -8076,10 +8135,10 @@ var install = async (args) => {
   const bundle = dirname15(process.execPath);
   const exeName = basename13(process.execPath);
   const chiselName = isWin ? "chisel.exe" : "chisel";
-  if (!existsSync22(join23(bundle, "runtime")) || !existsSync22(join23(bundle, chiselName))) {
+  if (!existsSync22(join22(bundle, "runtime")) || !existsSync22(join22(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 = [exeName, chiselName, "runtime", "README.txt"].filter((f2) => existsSync22(join23(bundle, f2)));
+  const companions = [exeName, chiselName, "runtime", "README.txt"].filter((f2) => existsSync22(join22(bundle, f2)));
   if (isWin)
     return installWindows(args, bundle, companions);
   return installUnix(args, bundle, companions);
@@ -8089,9 +8148,9 @@ var copyBundle = (bundle, target, companions) => {
   if (safeRealpath(target) === safeRealpath(bundle))
     return;
   for (const f2 of companions) {
-    const dest = join23(target, f2);
+    const dest = join22(target, f2);
     rmSync4(dest, { recursive: true, force: true });
-    cpSync2(join23(bundle, f2), dest, { recursive: true });
+    cpSync2(join22(bundle, f2), dest, { recursive: true });
   }
 };
 var permError = (e, dir, system) => {
@@ -8103,34 +8162,34 @@ var permError = (e, dir, system) => {
 };
 var installUnix = (args, bundle, companions) => {
   const system = flagBool(args, "system");
-  const libDir = resolve11(flagStr(args, "dir") ?? (system ? "/usr/local/lib/lecodes-cli" : join23(HOME, ".local", "lib", "lecodes-cli")));
-  const binDir = resolve11(flagStr(args, "bin") ?? (system ? "/usr/local/bin" : join23(HOME, ".local", "bin")));
-  const link2 = join23(binDir, "lecodes");
+  const libDir = resolve11(flagStr(args, "dir") ?? (system ? "/usr/local/lib/lecodes-cli" : join22(HOME, ".local", "lib", "lecodes-cli")));
+  const binDir = resolve11(flagStr(args, "bin") ?? (system ? "/usr/local/bin" : join22(HOME, ".local", "bin")));
+  const link2 = join22(binDir, "lecodes");
   try {
     copyBundle(bundle, libDir, companions);
-    chmodSync(join23(libDir, "lecodes"), 493);
-    chmodSync(join23(libDir, "chisel"), 493);
+    chmodSync(join22(libDir, "lecodes"), 493);
+    chmodSync(join22(libDir, "chisel"), 493);
   } catch (e) {
     throw permError(e, libDir, system);
   }
   try {
     mkdirSync15(binDir, { recursive: true });
     rmSync4(link2, { force: true });
-    symlinkSync(join23(libDir, "lecodes"), link2);
+    symlinkSync(join22(libDir, "lecodes"), link2);
   } catch (e) {
     throw permError(e, binDir, system);
   }
   success(`Installed to ${c.bold(libDir)}`);
-  log(`  ${c.dim(link2 + " → " + join23(libDir, "lecodes"))}`);
+  log(`  ${c.dim(link2 + " → " + join22(libDir, "lecodes"))}`);
   finishPathUnix(args, binDir);
 };
 var shellRc = () => {
   const shell = basename13(process.env.SHELL ?? "");
   if (shell === "zsh")
-    return { file: join23(HOME, ".zshrc"), name: "~/.zshrc" };
+    return { file: join22(HOME, ".zshrc"), name: "~/.zshrc" };
   if (shell === "bash")
-    return { file: join23(HOME, ".bashrc"), name: "~/.bashrc" };
-  return { file: join23(HOME, ".profile"), name: "~/.profile" };
+    return { file: join22(HOME, ".bashrc"), name: "~/.bashrc" };
+  return { file: join22(HOME, ".profile"), name: "~/.profile" };
 };
 var PATH_MARKER = "# Added by `lecodes install`";
 var appendPathToShellRc = (binDir) => {
@@ -8175,7 +8234,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 = resolve11(flagStr(args, "dir") ?? join23(process.env.LOCALAPPDATA ?? join23(HOME, "AppData", "Local"), "Programs", "lecodes-cli"));
+  const target = resolve11(flagStr(args, "dir") ?? join22(process.env.LOCALAPPDATA ?? join22(HOME, "AppData", "Local"), "Programs", "lecodes-cli"));
   try {
     copyBundle(bundle, target, companions);
   } catch (e) {
@@ -8214,7 +8273,7 @@ var addToUserPathWindows = (dir) => {
 var STANDALONE = (() => {
   const dir = dirname16(process.execPath);
   const chisel = process.platform === "win32" ? "chisel.exe" : "chisel";
-  return existsSync23(join24(dir, "runtime")) && existsSync23(join24(dir, chisel));
+  return existsSync23(join23(dir, "runtime")) && existsSync23(join23(dir, chisel));
 })();
 var INSTALLED = STANDALONE && (() => {
   const exe = process.platform === "win32" ? "lecodes.exe" : "lecodes";
@@ -8229,7 +8288,7 @@ var INSTALLED = STANDALONE && (() => {
     if (!d)
       return false;
     try {
-      const cand = join24(d, exe);
+      const cand = join23(d, exe);
       return existsSync23(cand) && realpathSync2(cand) === self;
     } catch {
       return false;
@@ -8416,7 +8475,7 @@ var peerVersion = (name, probe) => {
     const require2 = createRequire4(import.meta.url);
     let dir = dirname16(require2.resolve(probe));
     for (let depth = 0;depth < 16; depth++) {
-      const manifest = join24(dir, "package.json");
+      const manifest = join23(dir, "package.json");
       if (existsSync23(manifest)) {
         const parsed = JSON.parse(readFileSync23(manifest, "utf8"));
         if (parsed.name === name)