lecodes-cli 2.0.1 → 2.0.3

package/dist/index.js

@@ -52,28 +52,29 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "lecodes-cli",
-    version: "2.0.1",
+    version: "2.0.3",
     dependencies: {
       "@letary/chisel": "^0.13.0",
       jimp: "^1.6.1",
       "lecodes-sdk": "workspace:*"
     },
     devDependencies: {
-      "lecodes-design": "^0.9.0",
+      "lecodes-design": "https://storage.yandexcloud.net/le-codes/releases/packages/lecodes-design/lecodes-design-0.11.0.tgz",
       "lecodes-headless": "workspace:*",
       "qrcode-terminal": "^0.12.0",
-      "lecodes-3d-editor": "^0.7.0",
+      "lecodes-3d-editor": "https://storage.yandexcloud.net/le-codes/releases/packages/lecodes-3d-editor/lecodes-3d-editor-0.9.0.tgz",
       "lecodes-assets": "workspace:*",
       "lecodes-creator-nav": "workspace:*",
       "lecodes-gl-lite": "workspace:*",
       "lecodes-web-frame": "workspace:*",
       "lecodes-web-player": "workspace:*",
-      "lecodes-web-shared": "workspace:*"
+      "lecodes-web-shared": "workspace:*",
+      "lecodes-web-lite": "workspace:*"
     },
     peerDependencies: {
-      "lecodes-design": "^0.9.0",
-      "lecodes-headless": "^2.0.1",
-      "lecodes-3d-editor": "^0.7.0",
+      "lecodes-design": "^0.11.0",
+      "lecodes-headless": "^2.0.3",
+      "lecodes-3d-editor": "^0.9.0",
       "lecodes-assets": "^0.2.1"
     },
     bin: {
@@ -126,7 +127,7 @@ var init_package = __esm(() => {
 });
 
 // ../../sdk/src/version.ts
-var SDK_VERSION = "2.0.1", sdkMajor = (version) => {
+var SDK_VERSION = "2.0.3", sdkMajor = (version) => {
   const m = version?.match(/^(\d+)\.\d+\.\d+/);
   return m ? Number(m[1]) : null;
 }, bundleSdkVersion = (head) => head.slice(0, 2000).match(/^\/\/ sdk: (\d+\.\d+\.\d+\S*)/m)?.[1] ?? null, bundleRunsOn = (bundleVersion, hostVersion) => sdkMajor(bundleVersion) !== null && sdkMajor(bundleVersion) === sdkMajor(hostVersion);
@@ -1349,6 +1350,7 @@ var init_chisel = __esm(() => {
         "remove",
         "setContent",
         "keepAlive",
+        "url",
         "attachTo",
         "detents",
         "dismissible",
@@ -171787,10 +171789,10 @@ var applyProjectFonts = async (entries, opts) => {
   if (faces.length === 0)
     return;
   return buildFontsHeaderValue(faces, (path) => {
-    if (!opts.publicUrl || !/^https?:/i.test(opts.publicUrl))
+    if (!opts.relative && (!opts.publicUrl || !/^https?:/i.test(opts.publicUrl)))
       return null;
     const fileSrc = byPath().get(path.replace(/^\//, ""))?.fileSrc;
-    return fileSrc ? opts.publicUrl + fileSrc : null;
+    return fileSrc ? (opts.publicUrl ?? "") + fileSrc : null;
   }) || undefined;
 }, isHttp = (s) => /^https?:/i.test(s), sha12 = (b) => createHash2("sha256").update(b).digest("hex").slice(0, 12), registryHome = (registry) => registry.replace(/\/v\d+$/, ""), readRegistry = async (registry, rel) => {
   if (isHttp(registry)) {
@@ -212716,6 +212718,24 @@ var init_peers = __esm(() => {
   ];
 });
 
+// src/hosts/archives.ts
+var ARCHIVED_PEERS, BASE = "https://storage.yandexcloud.net/le-codes/releases/packages", packagesBase = () => (process.env.LECODES_PACKAGES_URL || BASE).replace(/\/$/, ""), archiveUrl = (name, version) => `${packagesBase()}/${name}/${name}-${version}.tgz`, archivedVersion = (name) => {
+  if (!ARCHIVED_PEERS.has(name))
+    return null;
+  if (name === "lecodes-headless")
+    return package_default.version;
+  const range = package_default.peerDependencies?.[name];
+  const version = range?.replace(/^[\^~>=\s]+/, "");
+  return version && /^\d+\.\d+\.\d+/.test(version) ? version : null;
+}, archiveSpec = (name) => {
+  const version = archivedVersion(name);
+  return version ? archiveUrl(name, version) : null;
+};
+var init_archives = __esm(() => {
+  init_package();
+  ARCHIVED_PEERS = new Set(["lecodes-headless", "lecodes-design", "lecodes-3d-editor"]);
+});
+
 // src/hosts/peerInstall.ts
 import { spawnSync as spawnSync6 } from "node:child_process";
 import { existsSync as existsSync23, mkdirSync as mkdirSync15, readFileSync as readFileSync19, writeFileSync as writeFileSync18 } from "node:fs";
@@ -212746,8 +212766,9 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson2 = (path2) => {
     return null;
   }
 }, peerSpec = (name) => {
-  if (name === "lecodes-headless")
-    return `lecodes-headless@${package_default.version}`;
+  const archive = archiveSpec(name);
+  if (archive)
+    return archive;
   if (name === "@napi-rs/canvas") {
     const renderer = readJson2(join24(peerDirInPrefix("lecodes-headless"), "package.json"));
     const range2 = renderer?.peerDependencies?.["@napi-rs/canvas"] ?? renderer?.optionalDependencies?.["@napi-rs/canvas"] ?? CANVAS_RANGE_FALLBACK;
@@ -212840,6 +212861,7 @@ var CANVAS_RANGE_FALLBACK = "^0.1.65", readJson2 = (path2) => {
 var init_peerInstall = __esm(() => {
   init_package();
   init_peers();
+  init_archives();
   init_cli();
 });
 
@@ -213140,7 +213162,7 @@ var DEFAULT_DIR = "design", DEFAULT_PORT = 4477, dirFlag, getContext = (dir) =>
   const mod = await loadPeer("lecodes-design", "server", { for: "lecodes design" });
   const missing = needs.filter((name) => typeof mod[name] !== "function");
   if (missing.length) {
-    throw new CliError(`This needs a newer lecodes-design — the installed one has no \`${missing[0]}\`. Run:  npm install -g lecodes-design@latest`);
+    throw new CliError(`This needs a newer lecodes-design — the installed one has no \`${missing[0]}\`. Run:  lecodes update`);
   }
   return mod;
 }, requirePlatform = (ctx, verb) => {
@@ -213256,7 +213278,7 @@ var aiFlag, cliAuthor = (ai) => ai || process.env.CLAUDECODE ? { author: "Claude
   if (!platform)
     return null;
   if (typeof designServer.mirrorThreads !== "function") {
-    note("Comment sync needs a newer lecodes-design (npm install -g lecodes-design@latest) — serving without it.");
+    note("Comment sync needs a newer lecodes-design (run: lecodes update) — serving without it.");
     return null;
   }
   let failures = 0;
@@ -213570,7 +213592,7 @@ var init_snapshot = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/lecodes-design@0.9.0+a0cdf6553a4c6042/node_modules/lecodes-design/src/core/concept.ts
+// ../../node_modules/.bun/lecodes-design@https+++storage.yandexcloud.net+le-codes+releases+packages+lecodes-design+lecodes-design-0.11.0.tgz+a0cdf6553a4c6042/node_modules/lecodes-design/src/core/concept.ts
 var SPEC_TEMPLATE = `# Concept
 
 The narrative half of this design. \`meta.json\` + the canvas hold the *visual/flow* half (screens,
@@ -213606,7 +213628,7 @@ Behaviour that isn't visible in a single screen — validation, permissions, not
 cases — and the decisions you've made and why, so they aren't re-litigated later.
 `;
 
-// ../../node_modules/.bun/lecodes-design@0.9.0+a0cdf6553a4c6042/node_modules/lecodes-design/src/templates.ts
+// ../../node_modules/.bun/lecodes-design@https+++storage.yandexcloud.net+le-codes+releases+packages+lecodes-design+lecodes-design-0.11.0.tgz+a0cdf6553a4c6042/node_modules/lecodes-design/src/templates.ts
 var SPEC_MD, META_JSON = `{
   "screens": {
     "home": { "pos": [0, 0], "desc": "Example screen — replace me", "role": "list" }
@@ -213703,9 +213725,9 @@ export default UIScreen([
     mb: spacing.lg,
   }),
 ]).style({ bgColor: colors.bg, p: spacing.md, pt: "safe-top" })
-`, CLAUDE_MD = `# LeCodes Design — screen prototyping canvas
+`, CLAUDE_MD = `# le.codes Design — screen prototyping canvas
 
-This folder is a **design canvas** for a LeCodes app: each file in \`screens/\` is one live,
+This folder is a **design canvas** for a le.codes app: each file in \`screens/\` is one live,
 executable screen shown on a spatial canvas in the browser (\`lecodes design\` runs the dev server).
 You (Claude) write the screens; the developer views them on the canvas and gives feedback.
 This is an intent-capture stage — screens run on inline mock data, before any backend exists.
@@ -213811,7 +213833,7 @@ keep in the chat.
   (entities + fields ARE the future schema — make them meaningful, not "Lorem ipsum").
 - **Reuse via shared/.** Design tokens and reusable components live in \`shared/\`. Use them in
   every screen. Promoting a repeated pattern into \`shared/\` is an explicit, deliberate step.
-- The LeCodes UI API (\`UIScreen\`, \`UIColumn\`, \`UIRow\`, \`UIBox\`, \`UIText\`, \`UIImage\`,
+- The le.codes UI API (\`UIScreen\`, \`UIColumn\`, \`UIRow\`, \`UIBox\`, \`UIText\`, \`UIImage\`,
   \`UIButton\`, \`UIInput\`, \`UISpacer\`, \`UIScrollable\`, …) is **global** — no imports needed.
   Colors must be hex strings. This folder ships a \`tsconfig.json\` + bundled SDK types
   (\`.lecodes/types/\`), so the editor resolves those globals — and \`UINode\` / \`UINodeChild\` for
@@ -214033,7 +214055,7 @@ declare function assetIcon(id: string, opts?: { color?: string }): { readonly sv
 declare function font(id: string, opts?: { weights?: number[], italic?: boolean }): string
 `, README_HINT = `# design/
 
-LeCodes Design canvas — run \`lecodes design\` here and open the printed URL.
+le.codes Design canvas — run \`lecodes design\` here and open the printed URL.
 See CLAUDE.md for the conventions (it's written for AI assistants, but it's the spec).
 `;
 var init_templates = __esm(() => {
@@ -214114,7 +214136,7 @@ var firstLine = (body, max = 64) => {
   const sync3 = flags["no-sync"] ? null : startCommentSync(ctx, designServer);
   log(`${c.bold("LeCodes Design")} — ${ctx.name}`);
   log(`Canvas:   ${c.bold(server2.url)}`);
-  log(`MCP:      ${c.bold(server2.url + "/mcp")}${renderer ? "" : c.dim("  (render_screen off — npm install -g lecodes-headless)")}`);
+  log(`MCP:      ${c.bold(server2.url + "/mcp")}${renderer ? "" : c.dim("  (render_screen off — lecodes-headless is not installed: `lecodes render` installs it)")}`);
   log(`Watching: ${ctx.dirName}/  (screens hot-reload on save; Ctrl+C to stop)`);
   if (sync3)
     log(`Comments: ${c.dim("in sync with the platform — replies and resolves go back automatically")}`);
@@ -215391,8 +215413,8 @@ var require_main = __commonJS((exports, module) => {
 // src/index.ts
 init_package();
 init_cli();
-import { existsSync as existsSync50, realpathSync as realpathSync2 } from "node:fs";
-import { delimiter as delimiter3, dirname as dirname25, join as join50 } from "node:path";
+import { existsSync as existsSync53, realpathSync as realpathSync2 } from "node:fs";
+import { delimiter as delimiter3, dirname as dirname27, join as join53 } from "node:path";
 
 // src/commands/app/index.ts
 init_manifest();
@@ -222047,8 +222069,7 @@ var desktop_default = defineCommand({
 
 // src/commands/dev.ts
 init_manifest();
-init_ignore();
-import { existsSync as existsSync34, mkdirSync as mkdirSync21, readFileSync as readFileSync26, watch, writeFileSync as writeFileSync24 } from "node:fs";
+import { existsSync as existsSync34, mkdirSync as mkdirSync21, readFileSync as readFileSync26, writeFileSync as writeFileSync24 } from "node:fs";
 import { randomBytes as randomBytes4 } from "node:crypto";
 import { networkInterfaces } from "node:os";
 import { basename as basename13, join as join35 } from "node:path";
@@ -222457,6 +222478,7 @@ var startDevServer = async (options) => {
 ` + renderPrelude({ origin: reqOrigin, base, transport, v: v2 });
   };
   const web = options.web ?? null;
+  const lite = options.lite ?? null;
   const sendBuilt = (res, dir, rel) => {
     if (rel.split("/").some((seg) => seg === ".." || seg === "" || seg === "."))
       return sendText(res, 400, "text/plain", "Bad path");
@@ -222518,6 +222540,18 @@ var startDevServer = async (options) => {
         return redirect(`${base}/web/${query()}`);
       return sendBuilt(res, web.page, rel === "/" ? "index.html" : rel.slice(1));
     }
+    if (route === "/lite" || route.startsWith("/lite/")) {
+      if (!lite)
+        return sendText(res, 404, "text/plain", "No Web Lite page with this CLI (lecodes-web-lite's dist).");
+      const rel = route.slice("/lite".length);
+      if (rel === "" || rel === "/" && !url.searchParams.has("dev")) {
+        url.searchParams.set("dev", "..");
+        res.writeHead(302, { location: `${base}/lite/?${url.searchParams.toString()}${url.hash}` });
+        res.end();
+        return;
+      }
+      return sendBuilt(res, lite, rel === "/" ? "index.html" : rel.slice(1));
+    }
     if (route === "/version") {
       return sendJson(res, 200, { v });
     }
@@ -222601,6 +222635,7 @@ var startDevServer = async (options) => {
   return {
     url: `${origin}${base}/dev.js`,
     webUrl: web ? `${origin}${base}/web/` : null,
+    liteUrl: lite ? `${origin}${base}/lite/` : null,
     base,
     port: boundPort,
     v: () => v,
@@ -222636,6 +222671,15 @@ var PAGE = {
   build: ["-c", "vite.page.config.ts"],
   sources: ["hosts/web-frame/src", "hosts/web-frame/page", "hosts/web-player/src/protocol.ts"]
 };
+var LITE = {
+  pkg: "lecodes-web-lite",
+  dist: "dist",
+  entry: "lite.js",
+  vendored: "web-lite",
+  build: [],
+  sources: ["hosts/web-lite/src", "hosts/web-lite/index.html", "renderers/web-lite/src", "renderers/web-shared/src", "hosts/web-player/src/dev.ts"]
+};
+var resolveLiteRunner = (log2 = () => {}) => resolve16(LITE, log2);
 var resolveWebRunner = (log2 = () => {}) => {
   const player = resolve16(PLAYER, log2);
   return player ? { player, page: resolve16(PAGE, log2) } : null;
@@ -222689,6 +222733,59 @@ var newest = (paths) => {
   return latest;
 };
 
+// src/dev/watchProject.ts
+init_ignore();
+init_paths();
+import { watch } from "node:fs";
+var DEBOUNCE_MS = 120;
+var SKIP_DIRS2 = new Set([".lecodes", ".git", "node_modules", "dist"]);
+var SKIP_FILES2 = new Set(["tsconfig.json", "jsconfig.json", ".gitignore", ".lecodesignore", ".DS_Store"]);
+var watchProject = (root, onChange, log2) => {
+  const ignore = loadIgnore(root);
+  const counts = (file) => {
+    if (file === null)
+      return true;
+    const parts = file.replace(/\\/g, "/").split("/");
+    if (parts.some((p2) => SKIP_DIRS2.has(p2)))
+      return false;
+    if (SKIP_FILES2.has(parts[parts.length - 1]))
+      return false;
+    try {
+      if (ignore(toKey(file), false))
+        return false;
+    } catch {
+      return false;
+    }
+    return true;
+  };
+  let timer = null;
+  let watcher = null;
+  try {
+    watcher = watch(root, { recursive: true }, (_type, file) => {
+      const name = file === null ? null : String(file);
+      log2.debug?.(`[watch] event: ${name ?? "(null)"} → ${counts(name) ? "recompile" : "skip"}`);
+      if (!counts(name))
+        return;
+      if (timer)
+        clearTimeout(timer);
+      timer = setTimeout(() => {
+        timer = null;
+        onChange();
+      }, DEBOUNCE_MS);
+    });
+  } catch {
+    log2.warn("fs.watch(recursive) unavailable on this platform — hot reload disabled (restart to pick up changes).");
+  }
+  watcher?.on("error", (e2) => log2.warn(`Watcher error — hot reload may have stopped (restart the command): ${e2.message}`));
+  return {
+    close() {
+      if (timer)
+        clearTimeout(timer);
+      watcher?.close();
+    }
+  };
+};
+
 // src/commands/dev.ts
 init_browserAuth();
 
@@ -222982,11 +223079,7 @@ var launchOnIos = (opts) => {
 // src/commands/dev.ts
 init_cli();
 init_shared();
-init_paths();
 var DEFAULT_PORT2 = 4499;
-var DEBOUNCE_MS = 120;
-var WATCH_SKIP_DIRS = new Set([".lecodes", ".git", "node_modules"]);
-var WATCH_SKIP_FILES = new Set(["tsconfig.json", "jsconfig.json", ".gitignore", ".lecodesignore", ".DS_Store"]);
 var VIRTUAL_IFACE = /wsl|docker|hyper-v|vethernet|virtualbox|vmware|tap|tun|zerotier|tailscale|loopback/i;
 var lanCandidates = () => {
   const nets = networkInterfaces();
@@ -223106,54 +223199,18 @@ var dev_default = defineCommand({
       warnErr(`Compile failed — fix it and save; devices connect once it compiles:
 ${first.error}`);
     }
-    const ignore = loadIgnore(root);
-    const shouldRecompile = (file) => {
-      if (file === null)
-        return true;
-      const parts = file.replace(/\\/g, "/").split("/");
-      if (parts.some((p2) => WATCH_SKIP_DIRS.has(p2)))
-        return false;
-      if (WATCH_SKIP_FILES.has(parts[parts.length - 1]))
-        return false;
-      try {
-        const key = toKey(file);
-        if (ignore(key, false))
-          return false;
-      } catch {
-        return false;
-      }
-      return true;
-    };
-    const debug2 = process.env.LECODES_DEV_DEBUG === "1";
-    let timer = null;
-    const onChange = (file) => {
-      if (debug2)
-        note(`[watch] event: ${file ?? "(null)"} → ${shouldRecompile(file) ? "recompile" : "skip"}`);
-      if (!shouldRecompile(file))
-        return;
-      if (timer)
-        clearTimeout(timer);
-      timer = setTimeout(async () => {
-        timer = null;
-        const result = await server2.recompile();
-        if (!result.ok) {
-          warnErr(`Compile failed (devices keep the last good version):
+    const watcher = watchProject(root, async () => {
+      const result = await server2.recompile();
+      if (!result.ok) {
+        warnErr(`Compile failed (devices keep the last good version):
 ${result.error}`);
-        } else if (result.changed) {
-          const devices = server2.clientCount();
-          note(`✓ v${result.v} → ${devices} device${devices === 1 ? "" : "s"}`);
-          for (const w of result.warnings)
-            warnErr(w);
-        }
-      }, DEBOUNCE_MS);
-    };
-    let watcher = null;
-    try {
-      watcher = watch(root, { recursive: true }, (_type, file) => onChange(file));
-    } catch {
-      warnErr("fs.watch(recursive) unavailable on this platform — hot reload disabled (restart to pick up changes).");
-    }
-    watcher?.on("error", (e2) => warnErr(`Watcher error — hot reload may have stopped (restart lecodes dev): ${e2.message}`));
+      } else if (result.changed) {
+        const devices = server2.clientCount();
+        note(`✓ v${result.v} → ${devices} device${devices === 1 ? "" : "s"}`);
+        for (const w of result.warnings)
+          warnErr(w);
+      }
+    }, { warn: warnErr, debug: process.env.LECODES_DEV_DEBUG === "1" ? note : undefined });
     log("");
     log(`${c.bold("LeCodes Dev")} — ${name}`);
     log("");
@@ -223186,14 +223243,14 @@ ${result.error}`);
         session2 = launchOnAndroid({ port, url: androidUrl, serial: flags.serial, apk: flags.apk, packageName: flags.package });
       } catch (e2) {
         server2.close();
-        watcher?.close();
+        watcher.close();
         throw e2;
       }
       note(`Android: ${session2.serial} → ${androidUrl} (adb reverse; device logs stream here as [device:log])`);
       const finish = (code) => {
         session2.stop();
         server2.close();
-        watcher?.close();
+        watcher.close();
         process.exit(code);
       };
       process.on("SIGINT", () => {
@@ -223228,14 +223285,14 @@ ${crashes.join(`
         session2 = launchOnIos({ simulatorUrl: `http://127.0.0.1:${port}${path2}`, deviceUrl, udid: flags.udid, app: flags.app, bundleId: flags.bundle });
       } catch (e2) {
         server2.close();
-        watcher?.close();
+        watcher.close();
         throw e2;
       }
       note(`iOS: ${session2.name} → ${session2.kind === "simulator" ? `http://127.0.0.1:${port}${path2}` : deviceUrl} (device logs stream here as [device:log])`);
       const finish = (code) => {
         session2.stop();
         server2.close();
-        watcher?.close();
+        watcher.close();
         process.exit(code);
       };
       process.on("SIGINT", () => {
@@ -230703,8 +230760,391 @@ var status_default = defineCommand({
 });
 
 // src/commands/test.ts
-import { existsSync as existsSync47, mkdirSync as mkdirSync31, readFileSync as readFileSync40, readdirSync as readdirSync21 } from "node:fs";
-import { dirname as dirname23, resolve as resolve28 } from "node:path";
+import { existsSync as existsSync48, mkdirSync as mkdirSync32, readFileSync as readFileSync40, readdirSync as readdirSync21 } from "node:fs";
+import { dirname as dirname24, resolve as resolve28 } from "node:path";
+init_manifest();
+
+// src/hosts/liteRunner.ts
+init_cli();
+import { spawn as spawn6 } from "node:child_process";
+import { existsSync as existsSync47, mkdirSync as mkdirSync31, writeFileSync as writeFileSync34 } from "node:fs";
+import { createServer as createServer3 } from "node:net";
+import { dirname as dirname23, join as join48 } from "node:path";
+import { createInterface as createInterface2 } from "node:readline";
+init_distRoot();
+init_peers();
+var FRAME_MS2 = 16;
+var LOG_SLACK_MS = 3000;
+var NO_NODE = "--lite needs Node on the PATH: the browser is driven from a Node process.";
+var NO_PLAYWRIGHT = "--lite runs the flows in a browser and needs Playwright: `npm install -D playwright` in the project, then `npx playwright install chromium` once.";
+var startDriver = async () => {
+  const script = join48(distRoot, "src", "hosts", "liteBrowser.mjs");
+  if (!existsSync47(script))
+    throw new CliError("--lite is not available in this build of the CLI (its browser driver ships with the npm package).");
+  const child = spawn6("node", [script], { stdio: ["pipe", "pipe", "inherit"] });
+  const waiting = new Map;
+  let onConsole = () => {};
+  let next = 1;
+  let dead = null;
+  const fail = (error) => {
+    dead = dead ?? error;
+    for (const w of waiting.values())
+      w.reject(dead);
+    waiting.clear();
+  };
+  child.on("error", () => fail(new CliError(NO_NODE)));
+  child.on("exit", () => fail(new Error("the browser's process ended")));
+  createInterface2({ input: child.stdout }).on("line", (line) => {
+    let message;
+    try {
+      message = JSON.parse(line);
+    } catch {
+      return;
+    }
+    if (message.event === "console") {
+      onConsole(message.level ?? "log", message.text ?? "");
+      return;
+    }
+    const w = message.id !== undefined ? waiting.get(message.id) : undefined;
+    if (!w)
+      return;
+    waiting.delete(message.id);
+    if (message.ok)
+      w.resolve(message.value);
+    else
+      w.reject(new Error(message.error ?? "failed"));
+  });
+  const call = (op, args = {}) => new Promise((resolve28, reject) => {
+    if (dead) {
+      reject(dead);
+      return;
+    }
+    const id = next++;
+    waiting.set(id, { resolve: resolve28, reject });
+    child.stdin.write(JSON.stringify({ id, op, args }) + `
+`);
+  });
+  const from = [
+    join48(process.cwd(), "package.json"),
+    join48(distRoot, "package.json"),
+    join48(peersDir(), "package.json"),
+    join48(distRoot, "..", "..", "engines", "gl-lite", "package.json")
+  ];
+  try {
+    await call("launch", { from });
+  } catch (e2) {
+    child.kill();
+    if (e2 instanceof CliError)
+      throw e2;
+    const message = e2 instanceof Error ? e2.message : String(e2);
+    throw new CliError(message === "NO_PLAYWRIGHT" ? NO_PLAYWRIGHT : `Chromium did not start (${message}) — run "npx playwright install chromium" once.`);
+  }
+  return {
+    open(width, height, listener) {
+      onConsole = listener;
+      return call("open", { width, height });
+    },
+    goto: (url) => call("goto", { url }),
+    waitFor: (expression, timeout) => call("waitFor", { expression, timeout }),
+    evaluate: (expression) => call("evaluate", { expression }),
+    timeout: (ms) => call("timeout", { ms }),
+    mouse: (action, x2, y2) => call("mouse", { action, x: x2, y: y2 }),
+    keyboard: (action, text2) => call("keyboard", { action, text: text2 }),
+    screenshot: (path2, clip) => call("screenshot", { path: path2, clip }),
+    async close() {
+      await call("close").catch(() => {});
+      child.kill();
+    }
+  };
+};
+var freePort = () => new Promise((resolve28, reject) => {
+  const probe = createServer3();
+  probe.once("error", reject);
+  probe.listen(0, "127.0.0.1", () => {
+    const address = probe.address();
+    const port = typeof address === "object" && address ? address.port : 0;
+    probe.close(() => resolve28(port));
+  });
+});
+var startLiteSession = async (options) => {
+  const port = await freePort();
+  const server2 = await startDevServer({
+    root: options.root,
+    manifest: options.manifest,
+    name: options.name,
+    lite: options.lite,
+    origin: `http://127.0.0.1:${port}`,
+    bind: "127.0.0.1",
+    port,
+    token: "test",
+    entryOverride: options.entry
+  });
+  const compiled = await server2.recompile();
+  if (!compiled.ok) {
+    server2.close();
+    throw new CliError(`Compile failed:
+${compiled.error}`);
+  }
+  let driver;
+  try {
+    driver = await startDriver();
+  } catch (e2) {
+    server2.close();
+    throw e2;
+  }
+  return {
+    run: (plan, runOptions) => runPlan(driver, `${server2.liteUrl}?dev=..&test`, plan, runOptions),
+    async close() {
+      await driver.close();
+      server2.close();
+    }
+  };
+};
+var parseArgs2 = (rest) => {
+  const out = [];
+  let i2 = 0;
+  while (i2 < rest.length) {
+    if (rest[i2] === " ") {
+      i2++;
+      continue;
+    }
+    if (rest[i2] === '"') {
+      let text2 = "";
+      i2++;
+      while (i2 < rest.length && rest[i2] !== '"') {
+        if (rest[i2] === "\\")
+          i2++;
+        text2 += rest[i2] ?? "";
+        i2++;
+      }
+      i2++;
+      out.push(text2);
+      continue;
+    }
+    const end = rest.indexOf(" ", i2);
+    const token = rest.slice(i2, end < 0 ? rest.length : end);
+    const n2 = Number(token);
+    out.push(Number.isFinite(n2) && token !== "" ? n2 : token);
+    i2 = end < 0 ? rest.length : end;
+  }
+  return out;
+};
+var unwire = (text2) => text2.replace(/\\(n|\\)/g, (_, c4) => c4 === "n" ? `
+` : "\\");
+var LEVEL = { log: "DEBUG", debug: "DEBUG", info: "INFO", warning: "WARN", warn: "WARN", error: "ERROR" };
+var ON_SHOW = ".lc-root > .lc:not(.lc-covered)";
+var FRAME = "new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(() => r(null))))";
+var FILL_VALUE = `(f) => f.type === "email" ? "test@example.com" : f.type === "tel" ? "5550100" : f.inputMode === "numeric" || f.inputMode === "decimal" ? "1" : f.type === "date" ? "2026-01-01" : f.type === "time" ? "12:00" : "test"`;
+var runPlan = async (driver, url, plan, options) => {
+  const output = [];
+  const seen = [];
+  const say = (line) => {
+    output.push(line);
+  };
+  await driver.open(options.width, options.height, (level, text2) => {
+    seen.push(text2);
+    say(`[${LEVEL[level] ?? "DEBUG"}] ${text2}`);
+    options.onConsole?.(level, text2);
+  });
+  const expectOf = new Map;
+  for (const step of plan.steps)
+    if (step.expectLog !== undefined)
+      for (const line of step.lines)
+        expectOf.set(line, step.expectLog);
+  const dump = () => driver.evaluate("window.lecodesTest.dump()");
+  const rectOf = (id) => driver.evaluate(`window.lecodesTest.rect(${id})`);
+  const nodeOf = async (name) => {
+    const node = findDumpTarget(parseTreeDump(await dump()), name);
+    if (!node)
+      throw new Error(`no element "${name}" on the screen`);
+    return node;
+  };
+  const pointOf = async (args, at2) => {
+    const first = args[at2];
+    if (typeof first === "number")
+      return { point: [first, Number(args[at2 + 1])], next: at2 + 2 };
+    const rect = await rectOf((await nodeOf(String(first))).id);
+    if (!rect || rect[2] === 0 || rect[3] === 0)
+      throw new Error(`"${first}" is not laid out`);
+    return { point: [rect[0] + rect[2] / 2, rect[1] + rect[3] / 2], next: at2 + 1 };
+  };
+  const frame = () => driver.evaluate(FRAME);
+  const waitFor = async (ms, line) => {
+    const expected = expectOf.get(line);
+    if (expected === undefined) {
+      await driver.timeout(ms);
+      return;
+    }
+    const until = Date.now() + ms + LOG_SLACK_MS;
+    while (Date.now() < until) {
+      if (seen.some((text2) => text2.includes(expected)))
+        return;
+      await driver.timeout(FRAME_MS2);
+    }
+  };
+  let clip = null;
+  const play = async (op, rest, line) => {
+    const args = parseArgs2(rest);
+    switch (op) {
+      case "frames":
+        await waitFor(Math.max(0, Number(args[0])) * FRAME_MS2, line);
+        return;
+      case "wait":
+        await waitFor(Math.max(0, Number(args[0])), line);
+        return;
+      case "tap": {
+        const { point } = await pointOf(args, 0);
+        await driver.mouse("move", point[0], point[1]);
+        await driver.mouse("down");
+        await driver.mouse("up");
+        await frame();
+        return;
+      }
+      case "hold": {
+        const { point, next } = await pointOf(args, 0);
+        await driver.mouse("move", point[0], point[1]);
+        await driver.mouse("down");
+        await driver.timeout(Number(args[next]) || 0);
+        await driver.mouse("up");
+        await frame();
+        return;
+      }
+      case "drag": {
+        const from = await pointOf(args, 0);
+        const to2 = await pointOf(args, from.next);
+        const ms = Number(args[to2.next]) || 300;
+        const steps = Math.max(2, Math.round(ms / FRAME_MS2));
+        await driver.mouse("move", from.point[0], from.point[1]);
+        await driver.mouse("down");
+        for (let i2 = 1;i2 <= steps; i2++) {
+          const t2 = i2 / steps;
+          await driver.mouse("move", from.point[0] + (to2.point[0] - from.point[0]) * t2, from.point[1] + (to2.point[1] - from.point[1]) * t2);
+          await driver.timeout(ms / steps);
+        }
+        await driver.mouse("up");
+        await frame();
+        return;
+      }
+      case "mouseto": {
+        const { point } = await pointOf(args, 0);
+        await driver.mouse("move", point[0], point[1]);
+        await frame();
+        return;
+      }
+      case "type":
+        await driver.keyboard("type", unwire(rest));
+        await frame();
+        return;
+      case "fill": {
+        const value = rest === "" ? undefined : unwire(rest);
+        const count = await driver.evaluate(`(() => {
+          window.__lecodesFill = [...document.querySelectorAll("${ON_SHOW} input.lc, ${ON_SHOW} textarea.lc")].filter((f) => f.value === "")
+          return window.__lecodesFill.length
+        })()`);
+        for (let i2 = 0;i2 < count; i2++) {
+          const text2 = value ?? await driver.evaluate(`(${FILL_VALUE})(window.__lecodesFill[${i2}])`);
+          await driver.evaluate(`window.__lecodesFill[${i2}].focus()`);
+          await driver.keyboard("type", text2);
+        }
+        await frame();
+        return;
+      }
+      case "scroll": {
+        const by = Number(args[0]);
+        const name = typeof args[1] === "string" ? args[1] : null;
+        const target = name === null ? `document.querySelector("${ON_SHOW} .lc-scrollable, ${ON_SHOW} .lc-vlist")` : `document.querySelector('[data-node="${(await nodeOf(name)).id}"]')`;
+        const found = await driver.evaluate(`(() => {
+          const el = ${target}
+          if (!el) return false
+          const style = getComputedStyle(el)
+          if (style.overflowX !== "hidden" && style.overflowY === "hidden") el.scrollLeft += ${by}
+          else el.scrollTop += ${by}
+          return true
+        })()`);
+        if (!found)
+          throw new Error(name === null ? "no scrollable on the screen" : `"${name}" is not there`);
+        await frame();
+        return;
+      }
+      case "key": {
+        await driver.keyboard("down", String(args[0]));
+        await driver.timeout(Number(args[1]) || 0);
+        await driver.keyboard("up", String(args[0]));
+        return;
+      }
+      case "keydown":
+        await driver.keyboard("down", String(args[0]));
+        return;
+      case "keyup":
+        await driver.keyboard("up", String(args[0]));
+        return;
+      case "wheel":
+        await driver.mouse("wheel", Number(args[0]) * 100, Number(args[1]) * 100);
+        await frame();
+        return;
+      case "dump": {
+        const file = rest.trim();
+        mkdirSync31(dirname23(file), { recursive: true });
+        writeFileSync34(file, await dump());
+        return;
+      }
+      case "clip": {
+        if (rest.trim() === "off") {
+          clip = null;
+          return;
+        }
+        if (typeof args[0] === "number") {
+          clip = { x: args[0], y: Number(args[1]), width: Number(args[2]), height: Number(args[3]) };
+          return;
+        }
+        const rect = await rectOf((await nodeOf(String(args[0]))).id);
+        if (!rect)
+          throw new Error(`"${args[0]}" is not laid out`);
+        clip = { x: rect[0], y: rect[1], width: rect[2], height: rect[3] };
+        return;
+      }
+      case "shot": {
+        const file = rest.trim();
+        mkdirSync31(dirname23(file), { recursive: true });
+        await driver.screenshot(file, clip);
+        return;
+      }
+      default:
+        throw new Error(`"${op}" is not available on Web Lite (it has no 3D scene, no gamepad)`);
+    }
+  };
+  try {
+    await driver.goto(url);
+    await driver.waitFor("window.lecodesTest && window.lecodesTest.ready === true", 20000);
+    say("[script] loaded");
+    const lines = plan.text.split(`
+`);
+    for (let i2 = 0;i2 < lines.length; i2++) {
+      const text2 = lines[i2].trim();
+      if (text2 === "" || text2.startsWith("#"))
+        continue;
+      const space = text2.indexOf(" ");
+      const op = space < 0 ? text2 : text2.slice(0, space);
+      const rest = space < 0 ? "" : text2.slice(space + 1);
+      try {
+        await play(op, rest, i2 + 1);
+        say(`[script] #${i2 + 1} done ${op}`);
+      } catch (e2) {
+        say(`[script] #${i2 + 1} error ${op}: ${e2 instanceof Error ? e2.message.split(`
+`)[0] : String(e2)}`);
+        break;
+      }
+    }
+    say("[script] end");
+  } catch (e2) {
+    say(`[ERROR] ${e2 instanceof Error ? e2.message.split(`
+`)[0] : String(e2)}`);
+  }
+  return output.join(`
+`);
+};
+
+// src/commands/test.ts
 init_manifest();
 init_cli();
 init_shared();
@@ -230782,7 +231222,7 @@ var readFlowFile = (abs, displayName) => {
     name: file.name ?? displayName,
     kind: "file",
     steps: file.steps,
-    fixtures: resolveFixtures(file.fixtures, dirname23(abs)),
+    fixtures: resolveFixtures(file.fixtures, dirname24(abs)),
     width: file.width,
     height: file.height,
     settle: file.settle,
@@ -230802,6 +231242,7 @@ var testFlags = {
   ...viewportFlags,
   ...bundleFlags,
   ...desktopRenderFlags,
+  lite: bool("run the file scenarios on Web Lite, in a browser (needs Playwright): the same steps, targets and expects; the clock is the browser's, so a step that expects a log line waits for it; design flows stay headless"),
   desktop: bool("run the file scenarios through the NATIVE host: the same steps, targets and expects as headless (expect.audio and the json output excepted); design flows stay headless. --frames / --fixed-dt as in render --desktop")
 };
 var test_default = defineCommand({
@@ -230817,6 +231258,11 @@ Design flows read tests/fixtures.json automatically (canned fetch responses) so
 });
 var runTests = async (args, flags) => {
   const sim = flags.sim;
+  const lite = flags.lite;
+  if (lite && (flags.desktop || sim))
+    throw new CliError("--lite is a host of its own — drop --desktop / --sim.");
+  if (lite && flags.flows)
+    throw new CliError("--flows needs the headless renderer (design flows read expect.screen and fill inputs) — drop --lite.");
   const desktop = flags.desktop || sim;
   if (desktop && flags.flows)
     throw new CliError(`--flows needs the headless renderer (design flows read expect.screen and fill inputs) — drop --${sim ? "sim" : "desktop"}.`);
@@ -230828,7 +231274,7 @@ var runTests = async (args, flags) => {
   }
   const desktopRenderer = desktop ? resolveDesktopRenderer(desktopRoot, flags.renderer) : undefined;
   const native = desktop ? await buildBundle(bundleOptions(flags), { localAssets: true, desktopRenderer }) : null;
-  const headless = desktop ? null : await compileHeadlessBundle({ entry: flags.entry, publicUrl: flags["public-url"], remoteAssets: flags["remote-assets"], waitNetwork: flags["wait-network"] });
+  const headless = desktop || lite ? null : await compileHeadlessBundle({ entry: flags.entry, publicUrl: flags["public-url"], remoteAssets: flags["remote-assets"], waitNetwork: flags["wait-network"] });
   const warnings = headless?.warnings ?? [];
   const useLocalAssets = headless?.useLocalAssets ?? false;
   const js = headless?.js ?? "";
@@ -230842,7 +231288,7 @@ var runTests = async (args, flags) => {
       root = process.cwd();
     }
   }
-  const renderer = desktop ? null : await requireRenderer();
+  const renderer = desktop || lite ? null : await requireRenderer();
   const nativeFrames = flags.frames || 60;
   const nativeFixedDt = flags["fixed-dt"] ?? 16;
   if (nativeFixedDt < 0 || nativeFixedDt > 1000)
@@ -230856,28 +231302,28 @@ var runTests = async (args, flags) => {
   if (args.length > 0) {
     for (const given of args) {
       const candidates = [resolve28(given), resolve28(testsDir, given), resolve28(testsDir, `${given}.flow.json`)];
-      const abs = candidates.find((p2) => existsSync47(p2));
+      const abs = candidates.find((p2) => existsSync48(p2));
       if (!abs)
         throw new CliError(`No such test: "${given}" (looked in ${testsDir}).`);
       cases.push(readFlowFile(abs, given));
     }
-  } else if (existsSync47(testsDir)) {
+  } else if (existsSync48(testsDir)) {
     for (const f5 of readdirSync21(testsDir).filter((f6) => f6.endsWith(".flow.json")).sort()) {
       cases.push(readFlowFile(resolve28(testsDir, f5), f5));
     }
   }
   const defaultPack = resolve28(testsDir, "fixtures.json");
-  const flowFixtures = flags.fixtures !== undefined ? resolveFixtures(flags.fixtures, ".") : existsSync47(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
+  const flowFixtures = flags.fixtures !== undefined ? resolveFixtures(flags.fixtures, ".") : existsSync48(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
   const flowsOnly = flags.flows;
   const wantFlows = !flags["no-flows"] && args.length === 0;
   if (flowsOnly)
     cases.length = 0;
   let skipped = [];
   let entryScreen = null;
-  if (desktop && wantFlows && existsSync47(designMetaPath)) {
-    note("Design-derived flows skipped with --desktop (they read expect.screen and fill inputs; run `lecodes test` headless for them).");
+  if ((desktop || lite) && wantFlows && existsSync48(designMetaPath)) {
+    note("Design-derived flows skipped with --desktop / --lite (they read expect.screen and fill inputs; run `lecodes test` headless for them).");
   }
-  if (!desktop && (wantFlows || flowsOnly) && existsSync47(designMetaPath)) {
+  if (!desktop && !lite && (wantFlows || flowsOnly) && existsSync48(designMetaPath)) {
     let meta;
     try {
       meta = JSON.parse(readFileSync40(designMetaPath, "utf8"));
@@ -230917,7 +231363,7 @@ var runTests = async (args, flags) => {
   const reportCase = (result) => {
     const skippedCount = result.steps.reduce((n2, s2) => n2 + (s2.skipped?.length ?? 0), 0);
     if (result.ok) {
-      out(`${c.green("✓")} ${result.name}${skippedCount > 0 ? c.dim(` (${skippedCount} semantic check${skippedCount === 1 ? "" : "s"} skipped on --desktop)`) : ""}`);
+      out(`${c.green("✓")} ${result.name}${skippedCount > 0 ? c.dim(` (${skippedCount} check${skippedCount === 1 ? "" : "s"} skipped on this host)`) : ""}`);
     } else {
       out(`${c.red("✗")} ${result.name}`);
       if (result.error)
@@ -230936,8 +231382,8 @@ var runTests = async (args, flags) => {
     const plan = translateScenario(kase.steps, { outDir: caseDir, headroomFrames: nativeFrames, sim });
     for (const st of plan.steps)
       if (st.screenshot)
-        mkdirSync31(dirname23(st.screenshot), { recursive: true });
-    mkdirSync31(caseDir, { recursive: true });
+        mkdirSync32(dirname24(st.screenshot), { recursive: true });
+    mkdirSync32(caseDir, { recursive: true });
     const finalPng = resolve28(caseDir, "final.png");
     const { output } = await runDesktopRender(native.js, native.resources, {
       renderer: desktopRenderer,
@@ -230952,7 +231398,7 @@ var runTests = async (args, flags) => {
       script: plan.text,
       fixedDtMs: nativeFixedDt
     });
-    const r2 = evaluateDesktopRun(plan, output, (path2) => existsSync47(path2) ? readFileSync40(path2, "utf8") : null);
+    const r2 = evaluateDesktopRun(plan, output, (path2) => existsSync48(path2) ? readFileSync40(path2, "utf8") : null);
     if (!r2.loaded)
       throw new CliError("This desktop host doesn't support scripted input (CREATOR_SCRIPT). Update it: lecodes desktop update (or point LECODES_DESKTOP_EXE at a newer build).");
     return {
@@ -230964,8 +231410,48 @@ var runTests = async (args, flags) => {
       artifacts: r2.ok ? [] : [finalPng]
     };
   };
+  let liteSession = null;
+  if (lite) {
+    const page = resolveLiteRunner(note);
+    if (!page)
+      throw new CliError("No Web Lite page found: this CLI has no runtime/web-lite (a monorepo checkout needs `bun run build` in hosts/web-lite).");
+    let manifest = null;
+    try {
+      manifest = readManifest(root);
+    } catch {}
+    liteSession = await startLiteSession({ root, manifest, name: manifest?.name ?? "app", lite: page, entry: flags.entry });
+  }
+  const runLiteCase = async (kase) => {
+    const caseDir = resolve28(artifactsRoot, slug(kase.name));
+    const plan = translateScenario(kase.steps, { outDir: caseDir, headroomFrames: 0 });
+    mkdirSync32(caseDir, { recursive: true });
+    const output = await liteSession.run(plan, {
+      width: flags.width || kase.width || projectViewport?.width || 390,
+      height: flags.height || kase.height || projectViewport?.height || 844,
+      onConsole
+    });
+    const r2 = evaluateDesktopRun(plan, output, (path2) => existsSync48(path2) ? readFileSync40(path2, "utf8") : null);
+    return {
+      name: kase.name,
+      kind: kase.kind,
+      ok: r2.ok,
+      steps: r2.steps.map((s2) => ({ desc: s2.desc, ok: s2.ok, error: s2.error, skipped: s2.skipped.length > 0 ? s2.skipped : undefined })),
+      error: !r2.loaded ? "the page did not load the app" : r2.ended ? undefined : "the page stopped before the script finished",
+      artifacts: []
+    };
+  };
   for (const kase of cases) {
     let result;
+    if (lite) {
+      try {
+        result = await runLiteCase(kase);
+      } catch (e2) {
+        result = { name: kase.name, kind: kase.kind, ok: false, steps: [], error: e2 instanceof Error ? e2.message : String(e2), artifacts: [] };
+      }
+      results.push(result);
+      reportCase(result);
+      continue;
+    }
     if (desktop) {
       try {
         result = await runNativeCase(kase);
@@ -231039,6 +231525,7 @@ var runTests = async (args, flags) => {
     }, null, 2) + `
 `);
   }
+  await liteSession?.close();
   clearTimeout(killer);
   process.exit(failed > 0 ? 1 : 0);
 };
@@ -231047,9 +231534,9 @@ var runTests = async (args, flags) => {
 init_peerInstall();
 import { createRequire as createRequire8 } from "node:module";
 import { execFileSync as execFileSync8 } from "node:child_process";
-import { existsSync as existsSync48, mkdtempSync as mkdtempSync6, readdirSync as readdirSync22, rmSync as rmSync13, statSync as statSync19 } from "node:fs";
+import { existsSync as existsSync49, mkdtempSync as mkdtempSync6, readdirSync as readdirSync22, rmSync as rmSync13, statSync as statSync19 } from "node:fs";
 import { tmpdir as tmpdir6 } from "node:os";
-import { extname, join as join48, relative as relative12, resolve as resolve29 } from "node:path";
+import { extname, join as join49, relative as relative12, resolve as resolve29 } from "node:path";
 init_cli();
 init_paths();
 var DEFAULT_SIZE = 256;
@@ -231061,13 +231548,13 @@ var findKtx = () => {
     process.env.LECODES_KTX,
     process.env.KTX_CLI,
     process.env.KTX_TOKTX?.replace(/toktx(\.exe)?$/i, exe),
-    process.platform === "win32" ? join48(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
-    process.platform === "win32" ? join48(process.env.ProgramFiles ?? "", "KTX-Software", "bin", exe) : null,
+    process.platform === "win32" ? join49(process.env.LOCALAPPDATA ?? "", "Programs", "KTX-Software", "bin", exe) : null,
+    process.platform === "win32" ? join49(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 (existsSync48(path2))
+    if (existsSync49(path2))
       return path2;
   }
   try {
@@ -231099,7 +231586,7 @@ var ktxToPng = (ktx, file, out) => {
     run4(["extract", "--transcode", "rgba8", "--level", "0", file, out]);
   } catch (e2) {
     run4(["extract", "--level", "0", file, out]);
-    if (!existsSync48(out))
+    if (!existsSync49(out))
       throw e2;
   }
 };
@@ -231108,7 +231595,7 @@ var collect = (dir) => {
   for (const name of readdirSync22(dir)) {
     if (name === "node_modules" || name.startsWith("."))
       continue;
-    const full = join48(dir, name);
+    const full = join49(dir, name);
     if (statSync19(full).isDirectory())
       out.push(...collect(full));
     else if (IMAGE_EXT.test(name))
@@ -231135,7 +231622,7 @@ var thumbs = async (targets, size, force) => {
   if (targets.length > 0) {
     for (const arg of targets) {
       const abs = resolve29(process.cwd(), arg);
-      if (!existsSync48(abs))
+      if (!existsSync49(abs))
         throw new CliError(`No such file or folder: ${arg}`);
       if (statSync19(abs).isDirectory())
         files.push(...collect(abs));
@@ -231157,7 +231644,7 @@ var thumbs = async (targets, size, force) => {
   const ktx = files.some((f5) => f5.toLowerCase().endsWith(".ktx2")) ? findKtx() : null;
   const sharp = sharpResizer();
   const resize = sharp ?? jimpResizer();
-  const tmp = mkdtempSync6(join48(tmpdir6(), "lecodes-thumbs-"));
+  const tmp = mkdtempSync6(join49(tmpdir6(), "lecodes-thumbs-"));
   let made = 0, fresh = 0;
   const skipped = [];
   try {
@@ -231183,7 +231670,7 @@ var thumbs = async (targets, size, force) => {
             skipped.push(`${asset} (KTX2 needs KTX-Software's \`ktx\` — set LECODES_KTX or put it on PATH)`);
             continue;
           }
-          source = join48(tmp, `${i2}.png`);
+          source = join49(tmp, `${i2}.png`);
           ktxToPng(ktx, file, source);
         }
         sceneServer.writePreviewFile(root, asset, await resize(source, size));
@@ -231203,7 +231690,7 @@ var thumbs = async (targets, size, force) => {
   if (rendered.length > 0) {
     warnErr(`Models, materials and prefabs are RENDERED, not decoded — the scene editor does those: ${rendered.join(", ")}`);
   }
-  note(`Cache: ${join48(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`);
+  note(`Cache: ${join49(root, ".lecodes", "preview")}  (re-runs skip everything unchanged)`);
 };
 
 // src/commands/update/index.ts
@@ -231211,10 +231698,11 @@ init_package();
 init_cli();
 init_peers();
 init_peerInstall();
+init_archives();
 import { spawnSync as spawnSync10 } from "node:child_process";
-import { existsSync as existsSync49, readdirSync as readdirSync23 } from "node:fs";
+import { existsSync as existsSync50, readdirSync as readdirSync23 } from "node:fs";
 import { homedir as homedir13 } from "node:os";
-import { dirname as dirname24, join as join49, resolve as resolve31 } from "node:path";
+import { dirname as dirname25, join as join50, resolve as resolve31 } from "node:path";
 
 // src/commands/update/types.ts
 init_api();
@@ -231286,9 +231774,9 @@ var findProjectDir = (start) => {
   const home = resolve31(homedir13());
   let dir = resolve31(start);
   while (true) {
-    if (dir !== home && (existsSync49(join49(dir, "app.json")) || existsSync49(join49(dir, ".lecodes", "manifest.json")) || existsSync49(join49(dir, ".lecodes", "types"))))
+    if (dir !== home && (existsSync50(join50(dir, "app.json")) || existsSync50(join50(dir, ".lecodes", "manifest.json")) || existsSync50(join50(dir, ".lecodes", "types"))))
       return dir;
-    const parent = dirname24(dir);
+    const parent = dirname25(dir);
     if (parent === dir)
       return null;
     dir = parent;
@@ -231323,7 +231811,7 @@ var semverNewer2 = (a2, b) => {
   return 0;
 };
 var FROM_SOURCE = /[\\/]src[\\/]commands[\\/]/.test(import.meta.url);
-var STANDALONE = existsSync49(join49(dirname24(process.execPath), "runtime")) && existsSync49(join49(dirname24(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel"));
+var STANDALONE = existsSync50(join50(dirname25(process.execPath), "runtime")) && existsSync50(join50(dirname25(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel"));
 var update_default = defineCommand({
   name: "update",
   summary: "Move everything the project depends on to its newest published state",
@@ -231383,7 +231871,7 @@ ${c.bold(name)}  ${c.dim(what)}`);
         return ["skipped", "not inside a project"];
       if (flags["no-shells"])
         return ["skipped", "--no-shells"];
-      const present = ["ios", "android"].filter((d) => existsSync49(join49(root, d)) && readdirSync23(join49(root, d)).length > 0);
+      const present = ["ios", "android"].filter((d) => existsSync50(join50(root, d)) && readdirSync23(join50(root, d)).length > 0);
       if (present.length === 0)
         return ["skipped", "no ios/ or android/ shell in this project (`lecodes app init ios|android`)"];
       await runSubcommand(app_default, "update");
@@ -231398,7 +231886,7 @@ ${c.bold(name)}  ${c.dim(what)}`);
       for (const [name, probe] of OPTIONAL_PEERS) {
         const where = peerSource(name, probe);
         const installed = peerVersion(name, probe);
-        const latest = !installed ? null : where === "prefix" && name === "lecodes-headless" ? package_default.version : await npmLatest(name);
+        const latest = !installed ? null : archivedVersion(name) ?? await npmLatest(name);
         rows.push({ name, installed, latest, where });
       }
       rows.push({ name: "lecodes-cli", installed: package_default.version, latest: await npmLatest("lecodes-cli"), where: "global" });
@@ -231412,7 +231900,7 @@ ${c.bold(name)}  ${c.dim(what)}`);
       if (behind.length === 0)
         return "ok";
       const prefixBehind = behind.filter((r2) => r2.where === "prefix");
-      const globalSpecs = behind.filter((r2) => r2.where !== "prefix").map((r2) => r2.name + "@latest");
+      const globalSpecs = behind.filter((r2) => r2.where !== "prefix").map((r2) => archiveSpec(r2.name) ?? r2.name + "@latest");
       if (flags.check) {
         return ["updated", behind.length + " behind — run: lecodes update" + (globalSpecs.length ? "  (global: npm install -g " + globalSpecs.join(" ") + ")" : "")];
       }
@@ -231430,7 +231918,7 @@ ${c.bold(name)}  ${c.dim(what)}`);
         const r2 = spawnSync10("npm", ["install", "-g", ...toInstall], { stdio: "inherit", shell: true });
         if (r2.status !== 0)
           throw new CliError("npm install -g exited with " + (r2.status ?? "a signal"));
-        done.push(...toInstall.map((s2) => s2.replace("@latest", "")));
+        done.push(...behind.filter((r3) => r3.where !== "prefix" && (!STANDALONE || r3.name !== "lecodes-cli")).map((r3) => r3.name));
       }
       if (done.length === 0)
         return ["skipped", "only the standalone CLI itself is behind — download the release"];
@@ -231449,11 +231937,362 @@ ${c.bold("Summary")}`);
   }
 });
 
+// src/commands/web.ts
+init_manifest();
+import { basename as basename25, relative as relative13 } from "node:path";
+init_browserAuth();
+init_cli();
+
+// src/web/build.ts
+import { createHash as createHash9 } from "node:crypto";
+import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync51, mkdirSync as mkdirSync33, readFileSync as readFileSync41, readdirSync as readdirSync24, rmSync as rmSync14, statSync as statSync20, writeFileSync as writeFileSync35 } from "node:fs";
+import { dirname as dirname26, extname as extname2, join as join51, resolve as resolve32 } from "node:path";
+init_fonts();
+init_assetIcons();
+init_projectCompile();
+init_cli();
+var escapeHtml = (text2) => text2.replace(/[&<>"]/g, (c4) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c4]);
+var normalBase = (base) => {
+  const b = (base ?? "/").trim() || "/";
+  return (b.startsWith("/") ? b : `/${b}`).replace(/\/*$/, "/");
+};
+var walk = (dir, prefix = "") => {
+  const out = [];
+  for (const name of readdirSync24(dir)) {
+    const abs = join51(dir, name);
+    const stat = statSync20(abs);
+    if (stat.isDirectory())
+      out.push(...walk(abs, `${prefix}${name}/`));
+    else
+      out.push({ path: prefix + name, bytes: stat.size });
+  }
+  return out;
+};
+var buildWeb = async (options) => {
+  const { root, manifest, name, lite } = options;
+  const out = resolve32(root, options.out);
+  if (out === resolve32(root) || resolve32(root).startsWith(out + "\\") || resolve32(root).startsWith(out + "/")) {
+    throw new CliError(`The output folder is cleaned before a build: "${options.out}" holds the project itself.`);
+  }
+  const config = readAppConfigAt(root)?.web ?? {};
+  const mode = config.urls === "path" ? "path" : "hash";
+  const base = normalBase(config.base);
+  const warnings = [];
+  const assetUrl = (path2) => "assets" + encodeURI(path2);
+  const collected = collectLocalEntries(root, manifest, "assets");
+  const entries = collected.entries.filter((e2) => {
+    const abs = e2.absPath ? resolve32(e2.absPath) : null;
+    return !(abs && (abs === out || abs.startsWith(out + "\\") || abs.startsWith(out + "/")));
+  });
+  for (const w of collected.warnings)
+    if (!/shaders compile on the server/.test(w))
+      warnings.push(w);
+  const fontsHeader = await applyProjectFonts(entries, {
+    mode: "vendor",
+    root,
+    vendorDir: root,
+    vendorPrefix: "",
+    publicUrl: "",
+    relative: true,
+    makeResourceEntry: (path2, absPath) => ({ path: path2, type: "resource", fileSrc: assetUrl(path2), absPath })
+  });
+  const iconsHeader = await applyAppAssetIcons(entries);
+  if (!options.entry) {
+    const ambiguous = ambiguousEntryWarning(entries);
+    if (ambiguous)
+      warnings.push(ambiguous);
+  }
+  const compiled = await compileProject2({
+    entries,
+    name,
+    publicUrl: "",
+    entryOverride: options.entry,
+    header: true,
+    fontsHeader,
+    iconsHeader,
+    sourcemap: options.sourcemap === true,
+    minify: options.minify,
+    onWarning: (w) => warnings.push(w)
+  });
+  const js = compiled.replace(/^\/\/ last-updated: .*$/m, "// last-updated: -");
+  const header = js.slice(0, 2000);
+  if (!/^\/\/ gl: disable/m.test(header) || /^\/\/ 2d: enable/m.test(header)) {
+    warnings.push("This project uses 3D or 2D scenes, which Web Lite does not show yet: the page runs its UI, a scene's calls fail. (`lecodes dev --web` runs the whole app on the web player.)");
+  }
+  rmSync14(out, { recursive: true, force: true });
+  mkdirSync33(out, { recursive: true });
+  cpSync6(lite, out, { recursive: true });
+  const bundle = `app.${createHash9("sha256").update(js).digest("hex").slice(0, 10)}.js`;
+  writeFileSync35(join51(out, bundle), js);
+  for (const entry of entries) {
+    if (entry.type !== "resource" || !entry.absPath || !entry.fileSrc)
+      continue;
+    if (!js.includes(entry.fileSrc))
+      continue;
+    const to2 = join51(out, "assets", ...entry.path.split("/").filter(Boolean));
+    if (existsSync51(to2)) {
+      warnings.push(`${entry.path}: a file of the page has this name in the built folder — the project's file was not copied`);
+      continue;
+    }
+    mkdirSync33(dirname26(to2), { recursive: true });
+    copyFileSync2(entry.absPath, to2);
+  }
+  const app = readAppConfigAt(root);
+  let html = readFileSync41(join51(lite, "index.html"), "utf8");
+  const head = [];
+  head.push(`<meta name="theme-color" content="${escapeHtml(config.themeColor ?? "#000000")}" />`);
+  if (app?.icon) {
+    const icon = resolve32(root, app.icon);
+    if (existsSync51(icon)) {
+      const file = `icon${extname2(icon).toLowerCase() || ".png"}`;
+      copyFileSync2(icon, join51(out, file));
+      head.push(`<link rel="icon" href="${file}" />`, `<link rel="apple-touch-icon" href="${file}" />`);
+    } else {
+      warnings.push(`app.json icon "${app.icon}" is not there — the page has no icon`);
+    }
+  }
+  if (mode === "path")
+    head.unshift(`<base href="${escapeHtml(base)}" />`);
+  const attrs = [`data-src="${bundle}"`, ...mode === "path" ? [`data-urls="path"`, `data-base="${escapeHtml(base)}"`] : []].join(" ");
+  const replace = (from, to2) => {
+    const next = html.replace(from, to2);
+    if (next === html)
+      throw new CliError(`The page of Web Lite has no ${String(from)} to fill — this CLI and its page are of different versions.`);
+    html = next;
+  };
+  replace(/<title>[^<]*<\/title>/, `<title>${escapeHtml(config.title ?? app?.name ?? name)}</title>`);
+  replace(`<div id="app"></div>`, `<div id="app" ${attrs}></div>`);
+  replace("</head>", `  ${head.join(`
+    `)}
+  </head>`);
+  if (config.lang)
+    replace(/<html lang="[^"]*">/, `<html lang="${escapeHtml(config.lang)}">`);
+  writeFileSync35(join51(out, "index.html"), html);
+  if (mode === "path")
+    writeFileSync35(join51(out, "404.html"), html);
+  return { out, bundle, files: walk(out), warnings };
+};
+
+// src/web/preview.ts
+import { createReadStream as createReadStream2, existsSync as existsSync52, statSync as statSync21 } from "node:fs";
+import { createServer as createServer4 } from "node:http";
+import { join as join52, resolve as resolve33 } from "node:path";
+var startPreview = async (dir, port) => {
+  const root = resolve33(dir);
+  const fallback = existsSync52(join52(root, "404.html")) ? join52(root, "index.html") : null;
+  const server2 = createServer4((req, res) => {
+    let path2;
+    try {
+      path2 = decodeURIComponent(new URL(req.url ?? "/", "http://localhost").pathname);
+    } catch {
+      res.writeHead(400);
+      res.end();
+      return;
+    }
+    const parts = path2.split("/").filter(Boolean);
+    if (parts.some((p2) => p2 === ".." || p2 === ".")) {
+      res.writeHead(400);
+      res.end();
+      return;
+    }
+    let file = join52(root, ...parts);
+    if (existsSync52(file) && statSync21(file).isDirectory())
+      file = join52(file, "index.html");
+    let status3 = 200;
+    if (!existsSync52(file) || !statSync21(file).isFile()) {
+      if (!fallback || /\.[a-z0-9]+$/i.test(parts[parts.length - 1] ?? "")) {
+        res.writeHead(404, { "content-type": "text/plain" });
+        res.end("Not found");
+        return;
+      }
+      file = fallback;
+    }
+    res.writeHead(status3, {
+      "content-type": contentType(file),
+      "cache-control": /[.-][0-9a-f]{8,}\.[a-z0-9]+$/i.test(file) ? "max-age=31536000, immutable" : "no-cache"
+    });
+    createReadStream2(file).pipe(res);
+  });
+  await new Promise((done, reject) => {
+    server2.once("error", reject);
+    server2.listen(port, "0.0.0.0", () => {
+      server2.removeListener("error", reject);
+      done();
+    });
+  });
+  const address = server2.address();
+  const bound = typeof address === "object" && address !== null ? address.port : port;
+  return { url: `http://localhost:${bound}/`, port: bound, close: () => server2.close() };
+};
+
+// src/commands/web.ts
+init_shared();
+var DEFAULT_PORT4 = 4488;
+var DEFAULT_OUT = "dist/web";
+var project = () => {
+  let root;
+  let manifest;
+  try {
+    root = findProjectRoot(process.cwd());
+    manifest = readManifest(root);
+  } catch {
+    root = process.cwd();
+    manifest = null;
+  }
+  return { root, manifest, name: manifest?.name ?? basename25(root) };
+};
+var litePage = () => {
+  const lite = resolveLiteRunner(note);
+  if (!lite)
+    throw new CliError("No Web Lite page found: this CLI has no runtime/web-lite (a monorepo checkout needs `bun run build` in hosts/web-lite).");
+  return lite;
+};
+var kb = (bytes) => bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+var dev = defineCommand({
+  name: "dev",
+  summary: "Open the project as a web page, reloaded on every save",
+  description: "Serves the project's bundle and assets with the page of Web Lite around them; a save recompiles and runs the app again, the page's console output and errors stream back here. The address's hash is the route the app is opened with (#/product/42 → app.launchUrl).",
+  flags: {
+    port: num("server port", { default: DEFAULT_PORT4 }),
+    entry: bundleFlags.entry,
+    "no-open": bool("don't open the browser")
+  },
+  examples: ["lecodes web dev", "lecodes web dev --port 8080 --no-open"],
+  run: async ({ flags }) => {
+    const { root, manifest, name } = project();
+    const lite = litePage();
+    const port = flags.port || DEFAULT_PORT4;
+    const lan = lanCandidates()[0]?.address;
+    const origin = `http://localhost:${port}`;
+    const server2 = await startDevServer({
+      root,
+      manifest,
+      name,
+      origin,
+      port,
+      token: loadDevToken(root),
+      entryOverride: flags.entry,
+      lite,
+      log: note
+    }).catch((e2) => {
+      const msg = e2 instanceof Error ? e2.message : String(e2);
+      throw new CliError(msg.includes("EADDRINUSE") ? `Port ${port} is already in use — pass --port <n>.` : msg);
+    });
+    note("Compiling…");
+    const first = await server2.recompile();
+    if (first.ok)
+      for (const w of first.warnings)
+        warnErr(w);
+    else
+      warnErr(`Compile failed — fix it and save; the page loads once it compiles:
+${first.error}`);
+    const watcher = watchProject(root, async () => {
+      const result = await server2.recompile();
+      if (!result.ok)
+        warnErr(`Compile failed (the page keeps the last good version):
+${result.error}`);
+      else if (result.changed) {
+        note(`✓ v${result.v}`);
+        for (const w of result.warnings)
+          warnErr(w);
+      }
+    }, { warn: warnErr, debug: process.env.LECODES_DEV_DEBUG === "1" ? note : undefined });
+    const url = server2.liteUrl;
+    log("");
+    log(`${c.bold("LeCodes Web")} — ${name}`);
+    log("");
+    log(`In the browser:  ${c.bold(url)}`);
+    if (lan)
+      note(`On this network: ${url.replace("http://localhost:", `http://${lan}:`)}`);
+    log("");
+    log(`Watching ${root} — save a file to reload. Ctrl+C to stop.`);
+    if (!flags["no-open"])
+      openBrowser(url);
+    process.on("SIGINT", () => {
+      watcher.close();
+      server2.close();
+      process.exit(0);
+    });
+  }
+});
+var build2 = defineCommand({
+  name: "build",
+  summary: "Build the project into a folder any static hosting serves",
+  description: 'Writes the page, the bundle, the page\'s own files and the assets the bundle names into one folder (dist/web). Every url in it is relative: the folder works at a domain\'s root and inside a folder of one.\n\napp.json `web` sets the page: `title`, `themeColor`, `lang`, and `urls` — "hash" (default: a route is `#/product/42`, which any hosting serves) or "path" (`/product/42` under `base`: the hosting has to answer every path with the page; a 404.html is written for the ones that do it that way).',
+  flags: {
+    out: str("the folder to write (cleaned first)", { alias: "o", value: "<dir>", default: DEFAULT_OUT }),
+    entry: bundleFlags.entry,
+    sourcemap: bool("inline the source map (errors name the app's own lines; the bundle grows by its sources)"),
+    "no-minify": bundleFlags["no-minify"]
+  },
+  examples: ["lecodes web build", "lecodes web build -o public"],
+  run: async ({ flags }) => {
+    const { root, manifest, name } = project();
+    const lite = litePage();
+    note("Building…");
+    const result = await buildWeb({
+      root,
+      manifest,
+      name,
+      lite,
+      out: flags.out,
+      entry: flags.entry,
+      sourcemap: flags.sourcemap,
+      minify: flags["no-minify"] ? false : undefined
+    });
+    for (const w of result.warnings)
+      warnErr(w);
+    const total = result.files.reduce((sum, f5) => sum + f5.bytes, 0);
+    const shown = relative13(process.cwd(), result.out) || ".";
+    log("");
+    for (const f5 of [...result.files].sort((a2, b) => b.bytes - a2.bytes).slice(0, 8))
+      log(`  ${kb(f5.bytes).padStart(10)}  ${f5.path}`);
+    if (result.files.length > 8)
+      log(c.dim(`  …and ${result.files.length - 8} more`));
+    log("");
+    log(`${c.green("✓")} ${c.bold(shown)} — ${result.files.length} files, ${kb(total)}`);
+    note(`Look at it: lecodes web preview${flags.out === DEFAULT_OUT ? "" : ` ${flags.out}`}`);
+  }
+});
+var preview = defineCommand({
+  name: "preview",
+  summary: "Serve a built folder, as a static hosting would",
+  usage: "[dir]",
+  flags: {
+    port: num("server port", { default: DEFAULT_PORT4 + 1 }),
+    "no-open": bool("don't open the browser")
+  },
+  examples: ["lecodes web preview", "lecodes web preview public --port 8080"],
+  run: async ({ args, flags }) => {
+    const dir = args[0] ?? DEFAULT_OUT;
+    const server2 = await startPreview(dir, flags.port || DEFAULT_PORT4 + 1).catch((e2) => {
+      const msg = e2 instanceof Error ? e2.message : String(e2);
+      throw new CliError(msg.includes("EADDRINUSE") ? `Port ${flags.port} is already in use — pass --port <n>.` : msg);
+    });
+    log(`${c.bold("LeCodes Web")} — ${dir}`);
+    log(`In the browser:  ${c.bold(server2.url)}`);
+    log("Ctrl+C to stop.");
+    if (!flags["no-open"])
+      openBrowser(server2.url);
+    process.on("SIGINT", () => {
+      server2.close();
+      process.exit(0);
+    });
+  }
+});
+var web_default = defineCommand({
+  name: "web",
+  summary: "The project as a web page (Web Lite): serve it with reload on save, build it for a hosting",
+  description: "Web Lite shows the app with the browser's own layout, text and scroll: what a site ships. UI apps for now — a project's 3D and 2D scenes are not shown yet.",
+  commands: [dev, build2, preview]
+});
+
 // src/commands/index.ts
 var commandGroups = (opts) => [
   { title: "Project", commands: [init_default, create_default, clone_default, link_default, status_default, diff_default, pull_default, push_default, login_default] },
   { title: "Run & test", commands: [
     dev_default,
+    web_default,
     compile_default,
     render_default,
     test_default,
@@ -231485,9 +232324,9 @@ var commandGroups = (opts) => [
 // src/index.ts
 init_peers();
 var STANDALONE2 = (() => {
-  const dir = dirname25(process.execPath);
+  const dir = dirname27(process.execPath);
   const chisel = process.platform === "win32" ? "chisel.exe" : "chisel";
-  return existsSync50(join50(dir, "runtime")) && existsSync50(join50(dir, chisel));
+  return existsSync53(join53(dir, "runtime")) && existsSync53(join53(dir, chisel));
 })();
 var INSTALLED = STANDALONE2 && (() => {
   const exe = process.platform === "win32" ? "lecodes.exe" : "lecodes";
@@ -231502,8 +232341,8 @@ var INSTALLED = STANDALONE2 && (() => {
     if (!d)
       return false;
     try {
-      const cand = join50(d, exe);
-      return existsSync50(cand) && realpathSync2(cand) === self2;
+      const cand = join53(d, exe);
+      return existsSync53(cand) && realpathSync2(cand) === self2;
     } catch {
       return false;
     }