lecodes-cli 0.19.2 → 0.20.0

package/dist/index.js

@@ -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
@@ -172193,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 ?? "";
     }
@@ -214125,26 +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");
@@ -214230,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,
@@ -214872,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;
@@ -214888,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, "/")
@@ -214929,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` };
@@ -216539,7 +216541,7 @@ var require_main = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "lecodes-cli",
-  version: "0.19.2",
+  version: "0.20.0",
   dependencies: {
     "@letary/chisel": "^0.10.0",
     jimp: "^1.6.1",
@@ -216556,7 +216558,7 @@ var package_default = {
   },
   peerDependencies: {
     "lecodes-design": "^0.9.0",
-    "lecodes-renderer": "^0.19.2",
+    "lecodes-renderer": "^0.20.0",
     "lecodes-3d-editor": "^0.7.0",
     "lecodes-assets": "^0.2.1"
   },
@@ -216609,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";
 
@@ -217036,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"
 };
@@ -217072,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;
@@ -217225,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;
@@ -217249,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 ?? []];
@@ -217264,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;
@@ -217272,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();
@@ -218076,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
 //
@@ -218101,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(
@@ -218247,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();
@@ -219494,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);
@@ -219510,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)`);
     }
@@ -219676,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));
     }
@@ -219733,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";
@@ -219756,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, 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
@@ -219883,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;
@@ -219899,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 [];
   }
@@ -219924,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)]);
@@ -220045,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)
@@ -220090,7 +220168,7 @@ 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()) {
+    if (r2.absPath && existsSync17(r2.absPath) && statSync5(r2.absPath).isFile()) {
       copyFileSync(r2.absPath, join18(runDir, r2.name));
     }
   }
@@ -220182,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"] });
@@ -220240,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, symlinkSync, 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) => {
@@ -220259,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
@@ -220413,7 +220492,7 @@ ${(r2.stdout + r2.stderr).trim()}`);
     if (signing.notaryProfile)
       notarize(dmg, signing.notaryProfile, tmp, "disk image");
   }
-  success(`DMG: ${dmg} (${mb(statSync5(dmg).size)})`);
+  success(`DMG: ${dmg} (${mb(statSync6(dmg).size)})`);
 };
 var gatekeeperVerdict = (app) => {
   const r2 = spawnSync5("spctl", ["-a", "-t", "exec", "-vv", app], { encoding: "utf8" });
@@ -220514,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/`);
@@ -220567,7 +220646,7 @@ var buildMacApp = async (input) => {
       const zip = join19(out, `${appName}.zip`);
       rmSync5(zip, { force: true });
       execFileSync4("ditto", ["-c", "-k", "--keepParent", app, zip]);
-      success(`Zip: ${zip} (${mb(statSync5(zip).size)})`);
+      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.");
     }
@@ -220591,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();
@@ -220622,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.`);
@@ -220659,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 {}
   }
@@ -220675,7 +220754,7 @@ var buildDesktop = async (args) => {
   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") {
@@ -220695,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}/`);
@@ -220709,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"))
@@ -220808,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))}
@@ -221015,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)`);
     }
@@ -221049,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/`);
@@ -221387,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`");
@@ -221430,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"));
@@ -221583,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();
@@ -221606,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 });
@@ -221632,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
@@ -221655,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
@@ -221704,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
@@ -221774,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 });
@@ -221797,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")
@@ -221830,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,
@@ -221886,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();
@@ -222158,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(".");
@@ -222253,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 });
@@ -222283,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");
@@ -222300,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);
@@ -222354,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,
@@ -222367,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;
@@ -222395,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;
@@ -222428,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).");
   }
@@ -222440,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,
@@ -222448,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);
@@ -222516,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;
@@ -222550,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);
@@ -222567,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;
     }
@@ -222742,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\`.
@@ -222852,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++;
@@ -222909,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();
 
@@ -222919,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) => {
@@ -222976,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++;
     }
@@ -223091,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;
@@ -223120,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 = {};
@@ -223157,10 +223328,10 @@ var link = async (args) => {
 
 // src/commands/lightmap.ts
 init_manifest();
-import { existsSync as existsSync28, mkdirSync as mkdirSync21, mkdtempSync as mkdtempSync4, readFileSync as readFileSync25, renameSync as renameSync3, rmSync as rmSync9, statSync as statSync10, unlinkSync, writeFileSync as writeFileSync22 } from "node:fs";
+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);
@@ -223173,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";
@@ -223234,7 +223405,7 @@ var bake = async (args) => {
     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 = {
@@ -223275,8 +223446,8 @@ 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");
+  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 {
@@ -223310,8 +223481,8 @@ import ${JSON.stringify(importPath)}
     logErr(text.startsWith("error") ? c.red(`✗ ${text}`) : text.startsWith("warning") ? c.yellow(`  ${text}`) : c.dim(`  ${text}`));
   }
   if (/\[lightmap\] done/.test(output)) {
-    const bakePath = join30(outDir, "lightmap.bake");
-    if (!existsSync28(bakePath))
+    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);
@@ -223319,13 +223490,13 @@ import ${JSON.stringify(importPath)}
     const t0 = Date.now();
     let pngKb = 0, ktxKb = 0;
     const encodePage = async (page, light) => {
-      const png2 = join30(outDir, pageFile("lightmap", page, light, ".png"));
-      const ktx2 = join30(outDir, pageFile(stem, page, light));
-      if (!existsSync28(png2))
+      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 += statSync10(png2).size / 1024;
-      ktxKb += statSync10(ktx2).size / 1024;
+      pngKb += statSync11(png2).size / 1024;
+      ktxKb += statSync11(ktx2).size / 1024;
       unlinkSync(png2);
     };
     const encodes = [];
@@ -223337,14 +223508,14 @@ import ${JSON.stringify(importPath)}
     await Promise.all(encodes);
     for (let p2 = pages;p2 < 16; p2++) {
       for (const light of [false, true]) {
-        const stale = join30(outDir, pageFile(stem, p2, light));
-        if (existsSync28(stale) && statSync10(stale).size !== PLACEHOLDER_KTX2.length)
+        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 = join30(outDir, pageFile(stem, 0, true));
-      if (existsSync28(light) && statSync10(light).size !== PLACEHOLDER_KTX2.length)
+      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);
@@ -223353,19 +223524,19 @@ import ${JSON.stringify(importPath)}
       data.lightTextures = Array.from({ length: pages }, (_, p2) => pageFile(stem, p2, true));
     if (data.volume)
       data.volume.file = `${stem}.volume`;
-    writeFileSync22(join30(outDir, `${stem}.bake`), JSON.stringify(data, null, 1) + `
+    writeFileSync22(join31(outDir, `${stem}.bake`), JSON.stringify(data, null, 1) + `
 `);
     if (stem !== "lightmap")
       unlinkSync(bakePath);
-    const volumeSrc = join30(outDir, "lightmap.volume");
-    const hasVolume = cfg.volumeCell > 0 && existsSync28(volumeSrc);
+    const volumeSrc = join31(outDir, "lightmap.volume");
+    const hasVolume = cfg.volumeCell > 0 && existsSync29(volumeSrc);
     if (hasVolume && stem !== "lightmap") {
-      rmSync9(join30(outDir, `${stem}.volume`), { force: true });
-      renameSync3(volumeSrc, join30(outDir, `${stem}.volume`));
+      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, join30(outDir, f3)).replace(/\\/g, "/");
+    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;
@@ -223395,11 +223566,11 @@ var placeholderVolume = () => {
   return b;
 };
 var ensurePlaceholders = (outDir, stem) => {
-  const missing = (f3) => !existsSync28(f3) || statSync10(f3).size === 0;
-  const bake2 = join30(outDir, `${stem}.bake`);
-  const ktx2 = join30(outDir, pageFile(stem, 0, false));
-  const light = join30(outDir, pageFile(stem, 0, true));
-  const volume = join30(outDir, `${stem}.volume`);
+  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: [] }) + `
 `);
@@ -223419,9 +223590,9 @@ var lightmap = async (args) => {
 
 // src/commands/navmesh.ts
 init_manifest();
-import { existsSync as existsSync29, mkdirSync as mkdirSync22, mkdtempSync as mkdtempSync5, readdirSync as readdirSync14, readFileSync as readFileSync26, 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
@@ -223438,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: createRequire5 } = await import("module");
-      var require2 = createRequire5(import.meta.url);
+      const { createRequire: createRequire6 } = await import("module");
+      var require2 = createRequire6(import.meta.url);
     }
     var arguments_ = [];
     var thisProgram = "./this.program";
@@ -224218,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;
     }
@@ -224232,7 +224403,7 @@ var guessName = (root) => {
       if (!f3.endsWith(".scene.ts"))
         continue;
       try {
-        if (/\bnavmesh\s*:/.test(readFileSync26(join31(dir, f3), "utf8")))
+        if (/\bnavmesh\s*:/.test(readFileSync26(join32(dir, f3), "utf8")))
           return f3.slice(0, -".scene.ts".length);
       } catch {}
     }
@@ -224275,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";
@@ -224287,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";
@@ -224303,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 {
@@ -224357,8 +224528,8 @@ 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(readFileSync26(geoPath)));
   const params = {
@@ -224408,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) => {
@@ -224565,7 +224736,7 @@ var shaders = async (args) => {
 
 // src/commands/render.ts
 import { mkdirSync as mkdirSync23, readFileSync as readFileSync29, writeFileSync as writeFileSync24 } from "node:fs";
-import { dirname as dirname15, resolve as resolve17 } from "node:path";
+import { dirname as dirname16, resolve as resolve17 } from "node:path";
 
 // src/compile/headlessBundle.ts
 init_api();
@@ -224649,8 +224820,8 @@ var compileHeadlessBundle = async (args, opts = {}) => {
 // src/compile/screenEntry.ts
 init_designMeta();
 init_util();
-import { existsSync as existsSync30, readFileSync as readFileSync28, 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";
@@ -224659,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/.`));
@@ -224674,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);
@@ -225034,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);
   }
 });
@@ -225109,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,
@@ -225158,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,
@@ -225225,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) {
@@ -225285,7 +225459,7 @@ var render = async (args) => {
     for (const w of [...warnings, ...mapWarnings])
       warnErr(w);
     const pngPath = mapFlag.endsWith(".png") ? mapFlag : mapFlag + ".png";
-    mkdirSync23(dirname15(resolve17(pngPath)), { recursive: true });
+    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));
@@ -225308,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" : ""})`);
     }
@@ -225339,8 +225513,8 @@ init_api();
 init_config();
 init_manifest();
 init_util();
-import { appendFileSync as appendFileSync2, existsSync as existsSync31, readFileSync as readFileSync30, 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());
@@ -225484,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) ? readFileSync30(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 {
@@ -225497,8 +225671,8 @@ var writeEnv = (root, key) => {
 `);
   }
   touched.push(".env");
-  const ignorePath = join33(root, ".gitignore");
-  const ignore = existsSync31(ignorePath) ? readFileSync30(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(`
@@ -225597,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();
@@ -225621,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);
     }
   }
@@ -225660,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)
@@ -225684,8 +225858,8 @@ var pullPaths = async (root, manifest, project, paths, apiUrl, token) => {
 
 // src/commands/scene.ts
 init_manifest();
-import { existsSync as existsSync34, readFileSync as readFileSync32, 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();
@@ -225694,17 +225868,17 @@ init_distRoot();
 init_util();
 init_projectCompile();
 import { createHash as createHash8 } from "node:crypto";
-import { existsSync as existsSync33, mkdirSync as mkdirSync25, readFileSync as readFileSync31, 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))
+    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.");
   }
@@ -225737,8 +225911,8 @@ 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-lite"].map((platform) => ({ platform, src }));
     }
@@ -225772,9 +225946,9 @@ 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;
@@ -225799,23 +225973,23 @@ 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(readFileSync32(path2, "utf8"));
     } catch {
@@ -225836,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++;
@@ -225882,11 +226056,11 @@ var scene = async (args) => {
 };
 
 // src/commands/thumbs.ts
-import { createRequire as createRequire5 } from "node:module";
+import { createRequire as createRequire6 } from "node:module";
 import { execFileSync as execFileSync7 } from "node:child_process";
-import { existsSync as existsSync35, mkdtempSync as mkdtempSync6, readdirSync as readdirSync16, rmSync as rmSync12, statSync as statSync14 } from "node:fs";
+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 join37, relative as relative7, resolve as resolve19 } from "node:path";
+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;
@@ -225897,13 +226071,13 @@ var findKtx = () => {
     process.env.LECODES_KTX,
     process.env.KTX_CLI,
     process.env.KTX_TOKTX?.replace(/toktx(\.exe)?$/i, exe),
-    process.platform === "win32" ? join37(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
-    process.platform === "win32" ? join37(process.env.ProgramFiles ?? "", "KTX-Software", "bin", exe) : null,
+    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 (existsSync35(path2))
+    if (existsSync36(path2))
       return path2;
   }
   try {
@@ -225915,8 +226089,8 @@ var findKtx = () => {
 };
 var sharpResizer = () => {
   try {
-    const req = createRequire5(import.meta.url);
-    const sharp = createRequire5(req.resolve("lecodes-assets/cli"))("sharp");
+    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;
@@ -225935,17 +226109,17 @@ var ktxToPng = (ktx, file, out) => {
     run2(["extract", "--transcode", "rgba8", "--level", "0", file, out]);
   } catch (e2) {
     run2(["extract", "--level", "0", file, out]);
-    if (!existsSync35(out))
+    if (!existsSync36(out))
       throw e2;
   }
 };
 var collect = (dir) => {
   const out = [];
-  for (const name of readdirSync16(dir)) {
+  for (const name of readdirSync17(dir)) {
     if (name === "node_modules" || name.startsWith("."))
       continue;
-    const full = join37(dir, name);
-    if (statSync14(full).isDirectory())
+    const full = join38(dir, name);
+    if (statSync15(full).isDirectory())
       out.push(...collect(full));
     else if (IMAGE_EXT.test(name))
       out.push(full);
@@ -225967,9 +226141,9 @@ var thumbs = async (args) => {
   if (args._.length > 0) {
     for (const arg of args._) {
       const abs = resolve19(process.cwd(), arg);
-      if (!existsSync35(abs))
+      if (!existsSync36(abs))
         throw new CliError(`No such file or folder: ${arg}`);
-      if (statSync14(abs).isDirectory())
+      if (statSync15(abs).isDirectory())
         files.push(...collect(abs));
       else if (IMAGE_EXT.test(abs))
         files.push(abs);
@@ -225989,7 +226163,7 @@ var thumbs = async (args) => {
   const ktx = files.some((f3) => f3.toLowerCase().endsWith(".ktx2")) ? findKtx() : null;
   const sharp = sharpResizer();
   const resize = sharp ?? jimpResizer();
-  const tmp = mkdtempSync6(join37(tmpdir6(), "lecodes-thumbs-"));
+  const tmp = mkdtempSync6(join38(tmpdir6(), "lecodes-thumbs-"));
   let made = 0, fresh = 0;
   const skipped = [];
   try {
@@ -226015,7 +226189,7 @@ var thumbs = async (args) => {
             skipped.push(`${asset} (KTX2 needs KTX-Software's \`ktx\` — set LECODES_KTX or put it on PATH)`);
             continue;
           }
-          source = join37(tmp, `${i2}.png`);
+          source = join38(tmp, `${i2}.png`);
           ktxToPng(ktx, file, source);
         }
         sceneServer.writePreviewFile(root, asset, await resize(source, size));
@@ -226035,16 +226209,16 @@ var thumbs = async (args) => {
   if (rendered.length > 0) {
     warnErr(`Models, materials and prefabs are RENDERED, not decoded — the scene editor does those: ${rendered.join(", ")}`);
   }
-  note(`Cache: ${join37(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`);
+  note(`Cache: ${join38(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`);
 };
 
 // src/commands/assets.ts
 init_util();
 
 // src/cmgenTool.ts
-import { existsSync as existsSync36, readdirSync as readdirSync17 } from "node:fs";
+import { existsSync as existsSync37, readdirSync as readdirSync18 } from "node:fs";
 import { homedir as homedir8 } from "node:os";
-import { join as join38, resolve as resolve20 } 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 = () => {
@@ -226054,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 = () => join38(homedir8(), ".lecodes", "cmgen");
+var cacheRoot3 = () => join39(homedir8(), ".lecodes", "cmgen");
 var findCmgenIn = (dir) => {
-  for (const entry of readdirSync17(dir, { withFileTypes: true })) {
-    const p2 = join38(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()) {
@@ -226070,7 +226244,7 @@ var findCmgenIn = (dir) => {
 };
 var installedCmgenVersions = () => {
   try {
-    return readdirSync17(cacheRoot3(), { withFileTypes: true }).filter((e2) => e2.isDirectory() && e2.name.startsWith("cmgen-")).map((e2) => e2.name.slice("cmgen-".length)).filter((v) => findCmgenIn(join38(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 [];
   }
@@ -226092,19 +226266,19 @@ var downloadCmgen = async (version, versions, dest) => {
 var resolveCmgenExeCached = () => {
   const override = process.env.LECODES_CMGEN;
   if (override) {
-    if (!existsSync36(override))
+    if (!existsSync37(override))
       throw new CliError(`LECODES_CMGEN points at "${override}" which doesn't exist.`);
     return resolve20(override);
   }
   const cached = installedCmgenVersions()[0];
-  return cached ? findCmgenIn(join38(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 = join38(cacheRoot3(), `cmgen-${latest}`);
+  const dir = join39(cacheRoot3(), `cmgen-${latest}`);
   await downloadCmgen(latest, versions, dir);
   const exe = findCmgenIn(dir);
   if (!exe)
@@ -226162,8 +226336,8 @@ var status3 = async (_args) => {
 };
 
 // src/commands/test.ts
-import { existsSync as existsSync37, mkdirSync as mkdirSync26, readFileSync as readFileSync33, readdirSync as readdirSync18 } from "node:fs";
-import { dirname as dirname18, resolve as resolve21 } 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) => {
@@ -226240,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,
@@ -226289,29 +226463,29 @@ var test = async (args) => {
   if (args._.length > 0) {
     for (const given of args._) {
       const candidates = [resolve21(given), resolve21(testsDir, given), resolve21(testsDir, `${given}.flow.json`)];
-      const abs = candidates.find((p2) => existsSync37(p2));
+      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 (existsSync37(testsDir)) {
-    for (const f3 of readdirSync18(testsDir).filter((f4) => f4.endsWith(".flow.json")).sort()) {
+  } 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 = resolve21(testsDir, "fixtures.json");
-  const flowFixtures = fixturesFlag !== undefined ? resolveFixtures(fixturesFlag, ".") : existsSync37(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
+  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 && existsSync37(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) && existsSync37(designMetaPath)) {
+  if (!desktop2 && (wantFlows || flowsOnly) && existsSync38(designMetaPath)) {
     let meta;
     try {
       meta = JSON.parse(readFileSync33(designMetaPath, "utf8"));
@@ -226353,11 +226527,12 @@ var test = async (args) => {
     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 = 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,
@@ -226478,15 +226653,15 @@ var test = async (args) => {
 
 // src/commands/update.ts
 import { spawnSync as spawnSync7 } from "node:child_process";
-import { existsSync as existsSync39, readdirSync as readdirSync19 } from "node:fs";
+import { existsSync as existsSync40, readdirSync as readdirSync20 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
-import { dirname as dirname20, join as join40, resolve as resolve23 } from "node:path";
+import { dirname as dirname21, join as join41, resolve as resolve23 } from "node:path";
 init_util();
 
 // src/peers.ts
-import { existsSync as existsSync38, readFileSync as readFileSync34 } from "node:fs";
-import { createRequire as createRequire6 } from "node:module";
-import { dirname as dirname19, join as join39 } from "node:path";
+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"],
@@ -226495,16 +226670,16 @@ var OPTIONAL_PEERS = [
 ];
 var peerVersion = (name, probe) => {
   try {
-    const require2 = createRequire6(import.meta.url);
-    let dir = dirname19(require2.resolve(probe));
+    const require2 = createRequire7(import.meta.url);
+    let dir = dirname20(require2.resolve(probe));
     for (let depth = 0;depth < 16; depth++) {
-      const manifest = join39(dir, "package.json");
-      if (existsSync38(manifest)) {
+      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 = dirname19(dir);
+      const parent = dirname20(dir);
       if (parent === dir)
         break;
       dir = parent;
@@ -226586,9 +226761,9 @@ var findProjectDir = (start) => {
   const home = resolve23(homedir9());
   let dir = resolve23(start);
   while (true) {
-    if (dir !== home && (existsSync39(join40(dir, "app.json")) || existsSync39(join40(dir, ".lecodes", "manifest.json")) || existsSync39(join40(dir, ".lecodes", "types"))))
+    if (dir !== home && (existsSync40(join41(dir, "app.json")) || existsSync40(join41(dir, ".lecodes", "manifest.json")) || existsSync40(join41(dir, ".lecodes", "types"))))
       return dir;
-    const parent = dirname20(dir);
+    const parent = dirname21(dir);
     if (parent === dir)
       return null;
     dir = parent;
@@ -226616,7 +226791,7 @@ var semverNewer2 = (a2, b) => {
   return 0;
 };
 var FROM_SOURCE = /[\\/]src[\\/]commands[\\/]/.test(import.meta.url);
-var STANDALONE = existsSync39(join40(dirname20(process.execPath), "runtime")) && existsSync39(join40(dirname20(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel"));
+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(`
@@ -226665,7 +226840,7 @@ ${c.bold(name)}  ${c.dim(what)}`);
       return ["skipped", "not inside a project"];
     if (flagBool(args, "no-shells"))
       return ["skipped", "--no-shells"];
-    const present = ["ios", "android"].filter((d) => existsSync39(join40(root, d)) && readdirSync19(join40(root, d)).length > 0);
+    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: {} });
@@ -226720,15 +226895,15 @@ ${c.bold("Summary")}`);
 };
 
 // src/index.ts
-import { existsSync as existsSync42, realpathSync as realpathSync2 } from "node:fs";
-import { delimiter as delimiter2, dirname as dirname23, join as join43 } 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 execFileSync8 } from "node:child_process";
-import { appendFileSync as appendFileSync3, chmodSync as chmodSync2, cpSync as cpSync5, existsSync as existsSync40, mkdirSync as mkdirSync27, readFileSync as readFileSync35, realpathSync, rmSync as rmSync13, symlinkSync as symlinkSync2 } from "node:fs";
+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 basename18, delimiter, dirname as dirname21, join as join41, resolve as resolve24, sep as sep2 } from "node:path";
+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 = homedir10();
 var safeRealpath = (p2) => {
@@ -226740,7 +226915,7 @@ var safeRealpath = (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 {
@@ -226751,13 +226926,13 @@ var onPath = (dir) => {
   });
 };
 var install = async (args) => {
-  const bundle = dirname21(process.execPath);
-  const exeName3 = basename18(process.execPath);
+  const bundle = dirname22(process.execPath);
+  const exeName3 = basename19(process.execPath);
   const chiselName = isWin ? "chisel.exe" : "chisel";
-  if (!existsSync40(join41(bundle, "runtime")) || !existsSync40(join41(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) => existsSync40(join41(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);
@@ -226767,9 +226942,9 @@ var copyBundle = (bundle, target, companions) => {
   if (safeRealpath(target) === safeRealpath(bundle))
     return;
   for (const f3 of companions) {
-    const dest = join41(target, f3);
+    const dest = join42(target, f3);
     rmSync13(dest, { recursive: true, force: true });
-    cpSync5(join41(bundle, f3), dest, { recursive: true });
+    cpSync5(join42(bundle, f3), dest, { recursive: true });
   }
 };
 var permError = (e2, dir, system) => {
@@ -226781,41 +226956,41 @@ var permError = (e2, dir, system) => {
 };
 var installUnix = (args, bundle, companions) => {
   const system = flagBool(args, "system");
-  const libDir = resolve24(flagStr(args, "dir") ?? (system ? "/usr/local/lib/lecodes-cli" : join41(HOME, ".local", "lib", "lecodes-cli")));
-  const binDir = resolve24(flagStr(args, "bin") ?? (system ? "/usr/local/bin" : join41(HOME, ".local", "bin")));
-  const link2 = join41(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(join41(libDir, "lecodes"), 493);
-    chmodSync2(join41(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 });
     rmSync13(link2, { force: true });
-    symlinkSync2(join41(libDir, "lecodes"), link2);
+    symlinkSync2(join42(libDir, "lecodes"), link2);
   } catch (e2) {
     throw permError(e2, binDir, system);
   }
   success(`Installed to ${c.bold(libDir)}`);
-  log(`  ${c.dim(link2 + " → " + join41(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: join41(HOME, ".zshrc"), name: "~/.zshrc" };
+    return { file: join42(HOME, ".zshrc"), name: "~/.zshrc" };
   if (shell === "bash")
-    return { file: join41(HOME, ".bashrc"), name: "~/.bashrc" };
-  return { file: join41(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 = existsSync40(file) ? readFileSync35(file, "utf8") : "";
+    const existing = existsSync41(file) ? readFileSync35(file, "utf8") : "";
     if (existing.includes(line))
       return name;
     appendFileSync3(file, `${existing && !existing.endsWith(`
@@ -226853,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 = resolve24(flagStr(args, "dir") ?? join41(process.env.LOCALAPPDATA ?? join41(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) {
@@ -226892,9 +227067,9 @@ var addToUserPathWindows = (dir) => {
 init_util();
 
 // src/projectEnv.ts
-import { existsSync as existsSync41, readFileSync as readFileSync36 } from "node:fs";
+import { existsSync as existsSync42, readFileSync as readFileSync36 } from "node:fs";
 import { homedir as homedir11 } from "node:os";
-import { dirname as dirname22, join as join42, resolve as resolve25 } from "node:path";
+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 = {};
@@ -226931,7 +227106,7 @@ var applyDotEnv = (parsed, dir, env) => {
     if (value.startsWith("./") || value.startsWith("../"))
       value = resolve25(dir, value);
     else if (value === "~" || value.startsWith("~/"))
-      value = join42(homedir11(), value.slice(1));
+      value = join43(homedir11(), value.slice(1));
     out[key] = value;
   }
   return out;
@@ -226939,9 +227114,9 @@ var applyDotEnv = (parsed, dir, env) => {
 var findEnvRoot = (start) => {
   let dir = resolve25(start);
   while (true) {
-    if (existsSync41(join42(dir, "app.json")) || existsSync41(join42(dir, ".lecodes")))
+    if (existsSync42(join43(dir, "app.json")) || existsSync42(join43(dir, ".lecodes")))
       return dir;
-    const parent = dirname22(dir);
+    const parent = dirname23(dir);
     if (parent === dir)
       return null;
     dir = parent;
@@ -226952,8 +227127,8 @@ var loadProjectEnv = (cwd = process.cwd()) => {
     const root = findEnvRoot(cwd);
     if (!root)
       return [];
-    const file = join42(root, ".env");
-    if (!existsSync41(file))
+    const file = join43(root, ".env");
+    if (!existsSync42(file))
       return [];
     const added = applyDotEnv(parseDotEnv(readFileSync36(file, "utf8")), root, process.env);
     for (const [k, v] of Object.entries(added))
@@ -226966,9 +227141,9 @@ var loadProjectEnv = (cwd = process.cwd()) => {
 
 // src/index.ts
 var STANDALONE2 = (() => {
-  const dir = dirname23(process.execPath);
+  const dir = dirname24(process.execPath);
   const chisel = process.platform === "win32" ? "chisel.exe" : "chisel";
-  return existsSync42(join43(dir, "runtime")) && existsSync42(join43(dir, chisel));
+  return existsSync43(join44(dir, "runtime")) && existsSync43(join44(dir, chisel));
 })();
 var INSTALLED = STANDALONE2 && (() => {
   const exe = process.platform === "win32" ? "lecodes.exe" : "lecodes";
@@ -226979,12 +227154,12 @@ var INSTALLED = STANDALONE2 && (() => {
       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 = join43(d, exe);
-      return existsSync42(cand) && realpathSync2(cand) === self2;
+      const cand = join44(d, exe);
+      return existsSync43(cand) && realpathSync2(cand) === self2;
     } catch {
       return false;
     }
@@ -227052,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)