lecodes-cli 2.2.11 → 2.2.14

package/dist/index.js

@@ -64,9 +64,9 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "lecodes-cli",
-    version: "2.2.11",
+    version: "2.2.14",
     dependencies: {
-      "@letary/chisel": "^0.14.0",
+      "@letary/chisel": "^0.15.0",
       jimp: "^1.6.1",
       "lecodes-sdk": "workspace:*"
     },
@@ -88,7 +88,7 @@ var init_package = __esm(() => {
     },
     peerDependencies: {
       "lecodes-design": "^0.11.0",
-      "lecodes-headless": "^2.2.11",
+      "lecodes-headless": "^2.2.14",
       "lecodes-3d-editor": "^0.9.0",
       "lecodes-assets": "^0.2.1",
       "heic-decode": "^2.1.0",
@@ -158,10 +158,10 @@ var init_package = __esm(() => {
 });
 
 // ../../sdk/src/version.ts
-var SDK_VERSION = "2.2.11";
+var SDK_VERSION = "2.2.14";
 
 // src/cli/args.ts
-var isNegativeNumber = (s) => /^-(\d|\.\d)/.test(s), isValue = (s) => !s.startsWith("-") || isNegativeNumber(s), parseArgv = (argv) => {
+var isNegativeNumber = (s) => /^-(\d|\.\d)/.test(s), isValue = (s) => !s.startsWith("-") || isNegativeNumber(s), parseArgv = (argv, booleans = new Set) => {
   const out = { positional: [], flags: {} };
   for (let i = 0;i < argv.length; i++) {
     const arg = argv[i];
@@ -183,7 +183,13 @@ var isNegativeNumber = (s) => /^-(\d|\.\d)/.test(s), isValue = (s) => !s.startsW
     }
     const key = arg.slice(long ? 2 : 1);
     const next = argv[i + 1];
-    if (next !== undefined && isValue(next)) {
+    if (booleans.has(key)) {
+      if (next === "true" || next === "false") {
+        out.flags[key] = next;
+        i++;
+      } else
+        out.flags[key] = true;
+    } else if (next !== undefined && isValue(next)) {
       out.flags[key] = next;
       i++;
     } else
@@ -243,6 +249,15 @@ var str = (help, opts) => ({ type: "string", help, ...opts }), num = (help, opts
       out[name] = present;
   }
   return out;
+}, booleanFlagNames = (spec) => {
+  const names = new Set;
+  for (const [name, s] of Object.entries(spec))
+    if (s.type === "boolean") {
+      names.add(name);
+      if (s.alias)
+        names.add(s.alias);
+    }
+  return names;
 }, unknownFlags = (spec, raw) => {
   const known = new Set;
   for (const [name, s] of Object.entries(spec)) {
@@ -498,8 +513,8 @@ var all = (groups) => groups.flatMap((g) => g.commands), closest = (name, cmds)
       process.exitCode = 1;
     return;
   }
-  const parsed = parseArgv(rest);
   const spec = node.flags ?? {};
+  const parsed = parseArgv(rest, booleanFlagNames(spec));
   if (!node.passthrough) {
     const unknown = unknownFlags(spec, parsed.flags);
     if (unknown.length)
@@ -525,6 +540,7 @@ var all = (groups) => groups.flatMap((g) => g.commands), closest = (name, cmds)
   process.exitCode = 1;
 };
 var init_run = __esm(() => {
+  init_command();
   init_args();
   init_command();
   init_errors();
@@ -590,7 +606,7 @@ var errorMessage = (body, status) => {
       return b.message;
   }
   return `Request failed with status ${status}`;
-}, apiRequest = async (apiUrl, path, opts = {}) => {
+}, ApiError, apiRequest = async (apiUrl, path, opts = {}) => {
   const headers = {};
   const isForm = opts.body instanceof FormData;
   if (opts.token)
@@ -610,13 +626,64 @@ var errorMessage = (body, status) => {
   const contentType = resp.headers.get("content-type") ?? "";
   const parsed = contentType.startsWith("application/json") ? await resp.json() : contentType.startsWith("text/") ? await resp.text() : null;
   if (resp.status >= 400)
-    throw new CliError(errorMessage(parsed, resp.status), resp.status);
+    throw new ApiError(errorMessage(parsed, resp.status), resp.status, parsed);
   return parsed;
 }, getAccount = (apiUrl, token) => apiRequest(apiUrl, "/account", { token }), getProject = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}`, { token }), createProject = (apiUrl, token, name, teamUuid) => apiRequest(apiUrl, "/projects", { token, body: { name, teamUuid } }), getCommits = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/commits`, { token }), getTypes = (apiUrl) => apiRequest(apiUrl, "/types"), uploadBlob = (apiUrl, token, uuid, name, bytes) => {
   const form = new FormData;
   form.append("file", new Blob([bytes]), name);
   return apiRequest(apiUrl, `/projects/${uuid}/blobs`, { token, body: form });
-}, sync = (apiUrl, token, uuid, payload) => apiRequest(apiUrl, `/projects/${uuid}/sync`, { token, body: payload }), publishProject = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/publish`, { token, body: {} }), enableDesignShare = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/share`, { token, body: {} }), disableDesignShare = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/share`, { token, method: "DELETE" }), setDesignCommentsOpen = (apiUrl, token, uuid, open) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/open`, { token, body: { open } }), listDesignComments = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/comments`, { token }), createDesignComment = (apiUrl, token, uuid, input) => apiRequest(apiUrl, `/projects/${uuid}/design/comments`, { token, body: input }), replyDesignComment = (apiUrl, token, uuid, threadId, body, origin) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/${threadId}/messages`, { token, body: { body, origin } }), resolveDesignComment = (apiUrl, token, uuid, threadId, resolved) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/${threadId}`, { token, method: "PATCH", body: { resolved } }), sendPush = (apiUrl, token, uuid, payload) => apiRequest(apiUrl, `/projects/${uuid}/push/send`, { token, body: payload }), listPushDevices = (apiUrl, token, uuid, user) => apiRequest(apiUrl, `/projects/${uuid}/push/registrations${user ? `?user=${encodeURIComponent(user)}` : ""}`, { token }), forgetPushDevice = (apiUrl, token, uuid, address) => apiRequest(apiUrl, `/projects/${uuid}/push/registrations/${encodeURIComponent(address)}`, { token, method: "DELETE" }), listPushKeys = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/push/keys`, { token }), createPushKey = (apiUrl, token, uuid, name) => apiRequest(apiUrl, `/projects/${uuid}/push/keys`, { token, body: { name } }), revokePushKey = (apiUrl, token, uuid, id) => apiRequest(apiUrl, `/projects/${uuid}/push/keys/${id}`, { token, method: "DELETE" }), downloadBlob = async (apiUrl, src) => {
+}, sync = (apiUrl, token, uuid, payload) => apiRequest(apiUrl, `/projects/${uuid}/sync`, { token, body: payload }), SchemaChangeError, opText = (op) => {
+  if (typeof op === "string")
+    return op;
+  if (op && typeof op === "object" && typeof op.text === "string")
+    return op.text;
+  return JSON.stringify(op);
+}, schemaChangeOf = (e) => {
+  if (!(e instanceof ApiError) || e.status !== 409 || !e.body || typeof e.body !== "object")
+    return e;
+  const body = e.body;
+  const destructive = Array.isArray(body.destructive) ? body.destructive.map(opText) : null;
+  const incompatible = typeof body.incompatible === "string" ? body.incompatible : body.incompatible === true ? "" : null;
+  if (!destructive && incompatible === null)
+    return e;
+  return new SchemaChangeError(typeof body.error === "string" ? body.error : "The schema change needs a confirmation", destructive ?? [], incompatible);
+}, releaseFailure = (e, opts) => {
+  const schema = schemaChangeOf(e);
+  if (schema !== e || !(e instanceof ApiError))
+    return schema;
+  if (opts.build && e.status === 400)
+    return new CliError(`Build failed:
+${e.message}`, 400);
+  if (e.status === 502 || e.status === 503) {
+    const detail = e.message.trimStart().startsWith("<") ? "" : `: ${e.message.trim()}`;
+    const service = opts.build ? "The platform's build service is unavailable" : "The platform could not reach the app backend";
+    return new CliError(`${service} (${e.status})${detail}. Nothing changed — try again in a minute.`, e.status);
+  }
+  return e;
+}, publishProject = async (apiUrl, token, uuid, opts = {}) => {
+  try {
+    const body = { ...opts.allowDestructive ? { allowDestructive: true } : {}, ...opts.force ? { force: true } : {} };
+    return await apiRequest(apiUrl, `/projects/${uuid}/publish`, { token, body });
+  } catch (e) {
+    throw releaseFailure(e, { build: true });
+  }
+}, listReleases = async (apiUrl, token, uuid) => (await apiRequest(apiUrl, `/projects/${uuid}/publish`, { token })).releases, useRelease = async (apiUrl, token, uuid, version, opts = {}) => {
+  try {
+    return await apiRequest(apiUrl, `/projects/${uuid}/releases/${encodeURIComponent(version)}/use`, { token, body: opts.allowDestructive ? { allowDestructive: true } : {} });
+  } catch (e) {
+    throw releaseFailure(e, { build: false });
+  }
+}, uploadReleaseBundle = async (apiUrl, token, uuid, bundle) => {
+  const form = new FormData;
+  form.append("app", new Blob([bundle.code], { type: "text/javascript" }), "app.js");
+  if (bundle.map !== null)
+    form.append("map", new Blob([bundle.map], { type: "application/json" }), "app.js.map");
+  try {
+    return await apiRequest(apiUrl, `/projects/${uuid}/releases/upload`, { token, body: form });
+  } catch (e) {
+    throw releaseFailure(e, { build: false });
+  }
+}, enableDesignShare = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/share`, { token, body: {} }), disableDesignShare = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/share`, { token, method: "DELETE" }), setDesignCommentsOpen = (apiUrl, token, uuid, open) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/open`, { token, body: { open } }), listDesignComments = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/design/comments`, { token }), createDesignComment = (apiUrl, token, uuid, input) => apiRequest(apiUrl, `/projects/${uuid}/design/comments`, { token, body: input }), replyDesignComment = (apiUrl, token, uuid, threadId, body, origin) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/${threadId}/messages`, { token, body: { body, origin } }), resolveDesignComment = (apiUrl, token, uuid, threadId, resolved) => apiRequest(apiUrl, `/projects/${uuid}/design/comments/${threadId}`, { token, method: "PATCH", body: { resolved } }), sendPush = (apiUrl, token, uuid, payload) => apiRequest(apiUrl, `/projects/${uuid}/push/send`, { token, body: payload }), listPushDevices = (apiUrl, token, uuid, user) => apiRequest(apiUrl, `/projects/${uuid}/push/registrations${user ? `?user=${encodeURIComponent(user)}` : ""}`, { token }), forgetPushDevice = (apiUrl, token, uuid, address) => apiRequest(apiUrl, `/projects/${uuid}/push/registrations/${encodeURIComponent(address)}`, { token, method: "DELETE" }), listPushKeys = (apiUrl, token, uuid) => apiRequest(apiUrl, `/projects/${uuid}/push/keys`, { token }), createPushKey = (apiUrl, token, uuid, name) => apiRequest(apiUrl, `/projects/${uuid}/push/keys`, { token, body: { name } }), revokePushKey = (apiUrl, token, uuid, id) => apiRequest(apiUrl, `/projects/${uuid}/push/keys/${id}`, { token, method: "DELETE" }), downloadBlob = async (apiUrl, src) => {
   const resp = await fetch(`${apiUrl}${src}`);
   if (!resp.ok)
     throw new CliError(`Failed to download ${src} (status ${resp.status})`);
@@ -624,6 +691,22 @@ var errorMessage = (body, status) => {
 };
 var init_api = __esm(() => {
   init_cli();
+  ApiError = class ApiError extends CliError {
+    body;
+    constructor(message, status, body) {
+      super(message, status);
+      this.body = body;
+    }
+  };
+  SchemaChangeError = class SchemaChangeError extends CliError {
+    destructive;
+    incompatible;
+    constructor(message, destructive, incompatible) {
+      super(message, 409);
+      this.destructive = destructive;
+      this.incompatible = incompatible;
+    }
+  };
 });
 
 // ../../sdk/src/compile/assetName.ts
@@ -170224,7 +170307,7 @@ var normalizePath2 = (path) => {
       continue;
     const exported = new Map(checker.getExportsOfModule(modSym).map((s) => [s.name, s]));
     for (const ex of exports) {
-      if (ex.kind === "other")
+      if (ex.kind === "other" || ex.kind === "push")
         continue;
       const id = `${serverModuleId(path)}#${ex.name}`;
       let sym = exported.get(ex.name);
@@ -170545,6 +170628,8 @@ var SERVER_FILE, isServerPath = (path) => SERVER_FILE.test(path), serverModuleId
   const s = init.trimStart();
   if (/^channel\s*[<(]/.test(s))
     return "channel";
+  if (/^pushChannel\s*[<(]/.test(s))
+    return "push";
   if (/^async\s+function\b/.test(s))
     return "fn";
   if (/^async\b/.test(s))
@@ -170588,7 +170673,7 @@ var SERVER_FILE, isServerPath = (path) => SERVER_FILE.test(path), serverModuleId
     }
   }
   return found.sort((a, b) => a.at - b.at).map(({ name, kind }) => ({ name, kind }));
-}, serverStubSource = (path, exports, serverUrl) => {
+}, serverStubSource = (path, exports, serverUrl, push = exports.some((e) => e.kind === "push")) => {
   const mod = serverModuleId(path);
   const url = JSON.stringify(serverUrl);
   const lines = exports.map(({ name, kind }) => {
@@ -170597,8 +170682,12 @@ var SERVER_FILE, isServerPath = (path) => SERVER_FILE.test(path), serverModuleId
       return `export const ${name} = __rpc(${url}, ${id})`;
     if (kind === "channel")
       return `export const ${name} = __channel(${url}, ${id})`;
+    if (kind === "push")
+      return `export const ${name} = __pushChannel(${url}, ${id})`;
     return `export const ${name} = __serverOnly(${id})`;
   });
+  if (push)
+    lines.unshift("__pushEnable()");
   return `// client stub of ${mod} — generated by the lecodes compiler
 ${lines.join(`
 `)}
@@ -170606,9 +170695,9 @@ ${lines.join(`
 }, ClientPublishError, clientPublishes = (entries) => {
   const channels = new Map;
   for (const [path, exports] of Object.entries(scanServerModules(entries))) {
-    const names = exports.filter((e) => e.kind === "channel").map((e) => e.name);
-    if (names.length)
-      channels.set(path.replace(/\.[tj]s$/, ""), new Set(names));
+    const names = new Map(exports.filter((e) => e.kind === "channel" || e.kind === "push").map((e) => [e.name, e.kind === "push" ? "send" : "publish"]));
+    if (names.size)
+      channels.set(path.replace(/\.[tj]s$/, ""), names);
   }
   if (channels.size === 0)
     return [];
@@ -170627,17 +170716,18 @@ ${lines.join(`
         continue;
       for (const part of m[1].split(",")) {
         const [imported, local] = part.split(/\s+as\s+/).map((s) => s.trim());
-        if (imported && names.has(imported))
-          locals.push(local ?? imported);
+        const verb = imported ? names.get(imported) : undefined;
+        if (verb)
+          locals.push([local ?? imported, verb]);
       }
     }
     if (!locals.length)
       continue;
     const code = blankCommentsAndStrings(src);
-    for (const local of locals) {
-      for (const m of code.matchAll(new RegExp(`(?<![\\w$.])${local.replace(/\$/g, "\\$")}\\s*\\.\\s*publish\\s*\\(`, "g"))) {
+    for (const [local, verb] of locals) {
+      for (const m of code.matchAll(new RegExp(`(?<![\\w$.])${local.replace(/\$/g, "\\$")}\\s*\\.\\s*${verb}\\s*\\(`, "g"))) {
         out.push(`${serverModuleId(e.path)}:${code.slice(0, m.index).split(`
-`).length}: ${local}.publish(…)`);
+`).length}: ${local}.${verb}(…)`);
       }
     }
   }
@@ -170677,7 +170767,11 @@ ${lines.join(`
     out[normalizePath3(e.path)] = scanServerExports(e.text ?? "", serverModuleId(e.path));
   }
   return out;
-}, stubServerEntries = (entries, serverUrl) => entries.map((e) => e.type === "text" && isServerPath(e.path) ? { ...e, text: serverStubSource(e.path, scanServerExports(e.text ?? "", serverModuleId(e.path)), serverUrl) } : e), compileServerBundle = async (opts) => {
+}, stubServerEntries = (entries, serverUrl) => {
+  const modules = scanServerModules(entries);
+  const push = Object.values(modules).some((exports) => exports.some((e) => e.kind === "push"));
+  return entries.map((e) => e.type === "text" && isServerPath(e.path) ? { ...e, text: serverStubSource(e.path, modules[normalizePath3(e.path)] ?? [], serverUrl, push) } : e);
+}, compileServerBundle = async (opts) => {
   const modules = scanServerModules(opts.entries);
   if (Object.keys(modules).length === 0)
     return null;
@@ -170714,7 +170808,7 @@ var init_serverSplit = __esm(() => {
   ClientPublishError = class ClientPublishError extends Error {
     problems;
     constructor(problems) {
-      super(`a channel goes from the server to the app — the app subscribes; to send, call a server function that publishes:
+      super(`a channel goes from the server to the app — the app listens; to send, call a server function that publishes (a push channel: that sends):
   ${problems.join(`
   `)}`);
       this.name = "ClientPublishError";
@@ -171163,7 +171257,7 @@ var init_shaderSchema = __esm(() => {
 });
 
 // ../../sdk/src/compile/header.ts
-var buildHeader = (name, code, opts = {}) => {
+var ENGINE_SIGNALS, buildHeader = (name, code, opts = {}) => {
   let header = `// sdk: ${SDK_VERSION}
 `;
   header += `// name: ${name.slice(0, 20)}
@@ -171181,6 +171275,10 @@ var buildHeader = (name, code, opts = {}) => {
 `;
   if (code.includes("_creator2d.createScene"))
     header += `// 2d: enable
+`;
+  for (const [name, re] of ENGINE_SIGNALS)
+    if (re.test(code))
+      header += `// ${name}: enable
 `;
   if (usesAR(code, opts.plugins))
     header += `// ar: enable
@@ -171214,7 +171312,14 @@ var buildHeader = (name, code, opts = {}) => {
 `;
   return header;
 }, usesAR = (code, plugins) => !!plugins?.includes("ar") && code.includes("_creator.createScene");
-var init_header = () => {};
+var init_header = __esm(() => {
+  ENGINE_SIGNALS = [
+    ["physics", /_creator\.(?:physicsCreateBody|physicsConfigure|physicsRaycast|characterCreate|vehicleCreate|ragdollCreate)\(/],
+    ["net", /\b_creatorNet\b/],
+    ["nav", /_creatorNav\.\w+\(/],
+    ["audio", /_creatorAudio\.(?:loadClip|play)\(/]
+  ];
+});
 
 // ../../sdk/src/compile/sourcemap.ts
 var offsetSourceMap = (mapJson, lines) => {
@@ -171228,295 +171333,8 @@ var offsetSourceMap = (mapJson, lines) => {
   return `//# lecodesMap=data:application/json;charset=utf-8;base64,${b64}`;
 };
 
-// ../../sdk/src/compile/compileProject.ts
-var localAssetBase = (path) => path.split(/[\\/]/).pop() ?? path, localAssetNames = (entries) => {
-  const seen = new Map;
-  for (const e of entries)
-    if (e.type === "resource") {
-      const b = localAssetBase(e.path);
-      seen.set(b, (seen.get(b) ?? 0) + 1);
-    }
-  const names = new Map;
-  for (const e of entries)
-    if (e.type === "resource") {
-      const b = localAssetBase(e.path);
-      names.set(e.path, (seen.get(b) ?? 0) > 1 ? e.path.replace(/^[./]+/, "").replace(/[\\/]/g, "__") : b);
-    }
-  return names;
-}, entriesToFiles = (entries, opts) => {
-  const files = {};
-  const localNames = localAssetNames(entries);
-  const localAssetId = (nameExpr) => `_creatorFetch.local(${nameExpr})`;
-  for (const e of entries) {
-    if (e.type === "resource") {
-      if (opts.localAssets && !e.remote) {
-        const name = localNames.get(e.path) ?? localAssetBase(e.path);
-        files[e.path] = `export default ("id:" + ${localAssetId(JSON.stringify(name))})`;
-      } else {
-        files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`;
-      }
-    } else if (e.type === "shader") {
-      const shaders = e.shaders ?? [];
-      if (e.shadersLocal && shaders.length > 0) {
-        const name = shaders[0].src.split(/[\/]/).pop() ?? "";
-        const [prefix, suffix = ".filamat"] = name.split("_opengl");
-        files[e.path] = `export default ("id:" + ${localAssetId(`${JSON.stringify(prefix + "_")} + _creator.backend + ${JSON.stringify(suffix)}`)})`;
-      } else if (shaders.length > 0) {
-        files[e.path] = `export default \`${opts.publicUrl}${shaders[0].src.replace("_opengl", "_${_creator.backend}")}\``;
-      } else {
-        files[e.path] = `export default ""`;
-      }
-    } 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 ?? "";
-    }
-  }
-  return files;
-}, pluginsOfAppJson = (entries) => {
-  const app = entries.find((e) => e.path.replace(/^[./\\]+/, "") === "app.json");
-  if (!app?.text)
-    return [];
-  try {
-    const plugins = JSON.parse(app.text).plugins;
-    return plugins && typeof plugins === "object" && !Array.isArray(plugins) ? Object.keys(plugins) : [];
-  } catch {
-    return [];
-  }
-}, pluginsOfBundle = (mapJson) => {
-  const ids = new Set;
-  try {
-    for (const source of JSON.parse(mapJson).sources ?? []) {
-      const m = /\/plugins\/gen\/([^/]+)\/sdk\//.exec(source);
-      if (m)
-        ids.add(m[1]);
-    }
-  } catch {}
-  return [...ids].sort();
-}, compileProjectWithMap = async (opts) => {
-  const published = clientPublishes(opts.entries);
-  if (published.length)
-    throw new ClientPublishError(published);
-  const entries = stubServerEntries(opts.entries, opts.serverUrl ?? "");
-  const entry = opts.entryOverride ?? detectEntry(entries, scanModulesChisel).entry;
-  if (!entry) {
-    throw new Error("Couldn't find an entrypoint (no .ts/.js project file — name yours main.ts). Pass entryOverride.");
-  }
-  const files = entriesToFiles(entries, opts);
-  const { code, map } = await bundleProjectWithMap(entry, files, opts.format ?? "esm", opts.minify, opts.editor, opts.libraries, opts.sourcemap ?? true);
-  const plugins = opts.plugins ?? pluginsOfAppJson(entries);
-  if (map && opts.onWarning) {
-    const missing = pluginsOfBundle(map).filter((id) => !plugins.includes(id));
-    if (missing.length) {
-      opts.onWarning(`The app uses ${missing.map((id) => `"${id}"`).join(", ")} and app.json does not list ${missing.length === 1 ? "it" : "them"}: a plugin that is not listed is not there — in a shell built from this project and in the browser alike. Add to app.json: "plugins": { ${missing.map((id) => `"${id}": "*"`).join(", ")} }`);
-    }
-  }
-  if (opts.header === false)
-    return { code, map, entry };
-  const header = buildHeader(opts.name, code, { icon: opts.icon, fonts: opts.fontsHeader, icons: opts.iconsHeader, plugins });
-  const headerLines = (header.match(/\n/g) ?? []).length;
-  return { code: header + code, map: map ? offsetSourceMap(map, headerLines) : null, entry };
-}, compileProject = async (opts) => {
-  const { code, map } = await compileProjectWithMap(opts);
-  return map ? `${code}
-${inlineSourceMapComment(map)}` : code;
-};
-var init_compileProject = __esm(() => {
-  init_bundler();
-  init_detectEntry();
-  init_header();
-  init_serverSplit();
-});
-
-// ../../sdk/src/compile/sceneEditor.ts
-var SCENE_HARNESS_DIR = "./.scene-editor", SCENE_ENTRY_PATH = "./.scene-entry.ts", resolveRelative = (fromPath, spec) => {
-  const segs = (p) => p.split("/").filter((s) => s !== "" && s !== ".");
-  const out = segs(fromPath).slice(0, -1);
-  for (const seg of segs(spec)) {
-    if (seg === "..")
-      out.pop();
-    else
-      out.push(seg);
-  }
-  return "./" + out.join("/");
-}, sceneImportsOf = (sceneText, scenePath, projectPaths) => {
-  const known = new Set(projectPaths);
-  const out = [];
-  const re = /^\s*import\s+[A-Za-z_$][\w$]*\s+from\s+["']([^"']+\.scene(?:\.ts)?)["']/gm;
-  for (const m of sceneText.matchAll(re)) {
-    const spec = m[1];
-    if (!spec.startsWith("."))
-      continue;
-    let p = resolveRelative(scenePath, spec);
-    if (!p.endsWith(".ts"))
-      p += ".ts";
-    if (known.has(p) && !out.includes(p))
-      out.push(p);
-  }
-  return out;
-}, sceneEditorEntries = (scenePath, harness, projectPaths = [], sceneImports = []) => {
-  const entries = Object.entries(harness).map(([name, text]) => ({
-    path: `${SCENE_HARNESS_DIR}/${name}`,
-    type: "text",
-    text
-  }));
-  entries.push({
-    path: `${SCENE_HARNESS_DIR}/.edit-mode.ts`,
-    type: "text",
-    text: `;(globalThis as any).__lecodesSceneEdit = true
-export {}
-`
-  });
-  const editorImports = projectPaths.filter((p) => p.endsWith(".editor.ts")).map((p) => `import "${p}"
-`).join("");
-  const materialPaths = projectPaths.filter((p) => p.endsWith(".material.ts"));
-  const materialImports = materialPaths.map((p, i) => `import __mat${i} from "${p}"
-`).join("");
-  const materialRegister = materialPaths.length === 0 ? "" : `;(globalThis as any).__lecodesMaterials = { ${materialPaths.map((p, i) => `${JSON.stringify(p)}: __mat${i}`).join(", ")} }
-`;
-  const sceneImportLines = sceneImports.map((p, i) => `import __scn${i} from "${p}"
-`).join("");
-  const sceneRegister = sceneImports.length === 0 ? "" : `;(globalThis as any).__lecodesSceneFiles = { ${sceneImports.map((p, i) => `${JSON.stringify(p)}: __scn${i}`).join(", ")} }
-`;
-  entries.push({
-    path: SCENE_ENTRY_PATH,
-    type: "text",
-    text: `import "${SCENE_HARNESS_DIR}/.edit-mode.ts"
-` + materialImports + sceneImportLines + `import "${scenePath}"
-` + editorImports + `import "${SCENE_HARNESS_DIR}/main.ts"
-` + materialRegister + sceneRegister
-  });
-  return entries;
-};
-
-// ../../sdk/src/compile/fontRegistry.ts
-var DEFAULT_FONT_REGISTRY_BASE = "https://cdn.le.codes/fonts/v1", fontRegistryBase = () => typeof process !== "undefined" && process.env?.LECODES_FONT_REGISTRY?.trim() || DEFAULT_FONT_REGISTRY_BASE, faceFileName = (id, weight, italic, ext) => `${id}-${weight}${italic ? "-italic" : ""}.${ext}`, LATIN, CYR, OFL = "OFL-1.1", f = (family, category, scripts, weights, italics, defaultWeights) => ({ family, category, scripts, weights, italics, defaultWeights, license: OFL }), FONT_REGISTRY;
-var init_fontRegistry = __esm(() => {
-  LATIN = ["latin"];
-  CYR = ["latin", "cyrillic"];
-  FONT_REGISTRY = {
-    inter: f("Inter", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
-    manrope: f("Manrope", "sans-serif", CYR, [200, 300, 400, 500, 600, 700, 800], [], [400, 500, 700]),
-    "golos-text": f("Golos Text", "sans-serif", CYR, [400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
-    onest: f("Onest", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
-    rubik: f("Rubik", "sans-serif", CYR, [300, 400, 500, 600, 700, 800, 900], [300, 400, 500, 600, 700, 800, 900], [400, 500, 700]),
-    nunito: f("Nunito", "sans-serif", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 600, 700]),
-    montserrat: f("Montserrat", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
-    "ibm-plex-sans": f("IBM Plex Sans", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700], [400, 700], [400, 500, 700]),
-    "pt-sans": f("PT Sans", "sans-serif", CYR, [400, 700], [400, 700], [400, 700]),
-    jost: f("Jost", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
-    "exo-2": f("Exo 2", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
-    unbounded: f("Unbounded", "display", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [], [400, 700]),
-    "russo-one": f("Russo One", "display", CYR, [400], [], [400]),
-    oswald: f("Oswald", "display", CYR, [200, 300, 400, 500, 600, 700], [], [400, 700]),
-    comfortaa: f("Comfortaa", "display", CYR, [300, 400, 500, 600, 700], [], [400, 700]),
-    "space-grotesk": f("Space Grotesk", "display", LATIN, [300, 400, 500, 600, 700], [], [400, 700]),
-    "playfair-display": f("Playfair Display", "serif", CYR, [400, 500, 600, 700, 800, 900], [400, 700], [400, 700]),
-    lora: f("Lora", "serif", CYR, [400, 500, 600, 700], [400, 700], [400, 700]),
-    "pt-serif": f("PT Serif", "serif", CYR, [400, 700], [400, 700], [400, 700]),
-    cormorant: f("Cormorant", "serif", CYR, [300, 400, 500, 600, 700], [400, 700], [400, 700]),
-    literata: f("Literata", "serif", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 700]),
-    "jetbrains-mono": f("JetBrains Mono", "monospace", CYR, [100, 200, 300, 400, 500, 600, 700, 800], [400, 700], [400, 700]),
-    "fira-code": f("Fira Code", "monospace", CYR, [300, 400, 500, 600, 700], [], [400, 700]),
-    "ibm-plex-mono": f("IBM Plex Mono", "monospace", CYR, [100, 200, 300, 400, 500, 600, 700], [400, 700], [400, 700]),
-    caveat: f("Caveat", "handwriting", CYR, [400, 500, 600, 700], [], [400, 700]),
-    pacifico: f("Pacifico", "handwriting", CYR, [400], [], [400])
-  };
-});
-
-// ../../sdk/src/compile/sfnt.ts
-var TAG_TTF = 65536, TAG_OTTO = 1330926671, TAG_TTCF = 1953784678, TAG_WOFF = 2001684038, TAG_WOF2 = 2001684018, parseSfnt = (bytes) => {
-  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  if (bytes.byteLength < 12)
-    throw new Error("not a font file (truncated)");
-  const version = dv.getUint32(0);
-  if (version === TAG_TTCF)
-    throw new Error("font collections (.ttc) aren't supported — export a single face");
-  if (version === TAG_WOFF || version === TAG_WOF2)
-    throw new Error("WOFF/WOFF2 project fonts aren't supported — use the .ttf/.otf");
-  if (version !== TAG_TTF && version !== TAG_OTTO)
-    throw new Error("not a TTF/OTF font file");
-  const numTables = dv.getUint16(4);
-  const tables = new Map;
-  for (let i = 0;i < numTables; i++) {
-    const rec = 12 + i * 16;
-    if (rec + 16 > bytes.byteLength)
-      throw new Error("not a font file (truncated table directory)");
-    const tag = String.fromCharCode(bytes[rec], bytes[rec + 1], bytes[rec + 2], bytes[rec + 3]);
-    tables.set(tag, { offset: dv.getUint32(rec + 8), length: dv.getUint32(rec + 12) });
-  }
-  const family = readFamily(dv, bytes, tables.get("name"));
-  if (!family)
-    throw new Error("no family name in the font's `name` table");
-  let weight = 400;
-  let italic = false;
-  const os2 = tables.get("OS/2");
-  if (os2 && os2.offset + 64 <= bytes.byteLength) {
-    weight = dv.getUint16(os2.offset + 4);
-    italic = (dv.getUint16(os2.offset + 62) & 1) === 1;
-  } else {
-    const head = tables.get("head");
-    if (head && head.offset + 46 <= bytes.byteLength) {
-      const macStyle = dv.getUint16(head.offset + 44);
-      if (macStyle & 1)
-        weight = 700;
-      italic = (macStyle & 2) === 2;
-    }
-  }
-  if (weight < 1 || weight > 1000)
-    weight = 400;
-  return { family, weight, italic };
-}, readFamily = (dv, bytes, name) => {
-  if (!name || name.offset + 6 > bytes.byteLength)
-    return "";
-  const base = name.offset;
-  const count = dv.getUint16(base + 2);
-  const stringOffset = base + dv.getUint16(base + 4);
-  let best = "";
-  let bestScore = -1;
-  for (let i = 0;i < count; i++) {
-    const rec = base + 6 + i * 12;
-    if (rec + 12 > bytes.byteLength)
-      break;
-    const platformID = dv.getUint16(rec);
-    const languageID = dv.getUint16(rec + 4);
-    const nameID = dv.getUint16(rec + 6);
-    const length = dv.getUint16(rec + 8);
-    const offset = stringOffset + dv.getUint16(rec + 10);
-    if (nameID !== 16 && nameID !== 1)
-      continue;
-    if (offset + length > bytes.byteLength)
-      continue;
-    let score = nameID === 16 ? 100 : 0;
-    if (platformID === 3)
-      score += languageID === 1033 ? 30 : 20;
-    else if (platformID === 0)
-      score += 10;
-    if (score <= bestScore)
-      continue;
-    const text = platformID === 1 ? decodeLatin1(bytes, offset, length) : decodeUtf16be(bytes, offset, length);
-    if (!text.trim())
-      continue;
-    best = text.trim();
-    bestScore = score;
-  }
-  return best;
-}, decodeUtf16be = (bytes, offset, length) => {
-  let out = "";
-  for (let i = 0;i + 1 < length; i += 2)
-    out += String.fromCharCode(bytes[offset + i] << 8 | bytes[offset + i + 1]);
-  return out;
-}, decodeLatin1 = (bytes, offset, length) => {
-  let out = "";
-  for (let i = 0;i < length; i++)
-    out += String.fromCharCode(bytes[offset + i]);
-  return out;
-};
-
-// ../../sdk/src/compile/fontMacro.ts
-var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z" || c >= "a" && c <= "z" || c === "_" || c === "$", isIdentPart = (c) => isIdentStart(c) || c >= "0" && c <= "9", skipString2 = (src, start) => {
+// ../../sdk/src/compile/assetIconMacro.ts
+var ICON_ID, isIdentStart = (c) => c >= "A" && c <= "Z" || c >= "a" && c <= "z" || c === "_" || c === "$", isIdentPart = (c) => isIdentStart(c) || c >= "0" && c <= "9", skipString2 = (src, start) => {
   const quote = src[start];
   const n = src.length;
   let i = start + 1;
@@ -171626,12 +171444,7 @@ var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z
   if (inner.includes(q) && !inner.includes("\\" + q))
     return null;
   return inner.replace(/\\(.)/g, "$1");
-}, prevNonSpace = (src, i) => {
-  let k = i - 1;
-  while (k >= 0 && /\s/.test(src[k]))
-    k--;
-  return k >= 0 ? src[k] : "";
-}, scanFontCalls = (source) => {
+}, scanAssetIconCalls = (source) => {
   const calls = [];
   const n = source.length;
   let i = 0;
@@ -171659,7 +171472,7 @@ var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z
       let j = i + 1;
       while (j < n && isIdentPart(source[j]))
         j++;
-      if (source.slice(i, j) === "font" && prevNonSpace(source, i) !== ".") {
+      if (source.slice(i, j) === "assetIcon" && prevNonSpace(source, i) !== ".") {
         const call = parseCall(source, i, j);
         if (call) {
           calls.push(call);
@@ -171673,6 +171486,11 @@ var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z
     i++;
   }
   return calls;
+}, prevNonSpace = (src, i) => {
+  let k = i - 1;
+  while (k >= 0 && /\s/.test(src[k]))
+    k--;
+  return k >= 0 ? src[k] : "";
 }, parseCall = (src, start, identEnd) => {
   const n = src.length;
   let i = identEnd;
@@ -171683,9 +171501,621 @@ var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z
   const close = matchParen(src, i);
   if (close === -1)
     return null;
-  const call = { start, end: close + 1, arg: "", kind: "registry" };
+  const call = { start, end: close + 1, id: "", pack: "", name: "" };
   const args = splitTopLevel(src.slice(i + 1, close), ",");
-  const arg = stringLiteralValue(args[0] ?? "");
+  const id = stringLiteralValue(args[0] ?? "");
+  if (id === null) {
+    call.error = `assetIcon(...) needs a string-literal id like "lucide:bell" (got \`${(args[0] ?? "").trim() || "()"}\`).`;
+    return call;
+  }
+  const m = ICON_ID.exec(id);
+  if (!m) {
+    call.error = `assetIcon("${id}"): id must be "pack:name", lowercase [a-z0-9-] (e.g. "lucide:bell").`;
+    return call;
+  }
+  call.id = id;
+  call.pack = m[1];
+  call.name = m[2];
+  const optsText = args[1]?.trim();
+  if (optsText) {
+    const color = extractColor(optsText);
+    if (color.error) {
+      call.error = color.error;
+      return call;
+    }
+    if (color.bake !== undefined)
+      call.bake = color.bake;
+    else if (color.tint !== undefined)
+      call.tint = color.tint;
+  }
+  return call;
+}, extractColor = (optsText) => {
+  if (!optsText.startsWith("{") || !optsText.endsWith("}")) {
+    return { error: `assetIcon(id, opts): opts must be an object literal like { color: "#5b8cff" }.` };
+  }
+  for (const prop of splitTopLevel(optsText.slice(1, -1), ",")) {
+    const kv = splitTopLevel(prop, ":");
+    if (kv.length < 2)
+      continue;
+    const key = kv[0].trim().replace(/^["'`]|["'`]$/g, "");
+    if (key !== "color")
+      continue;
+    const raw = kv.slice(1).join(":").trim();
+    if (!raw)
+      continue;
+    const literal = stringLiteralValue(raw);
+    return literal !== null ? { bake: literal } : { tint: raw };
+  }
+  return {};
+}, rewriteAssetIcons = (source, calls, svgById) => {
+  let out = source;
+  for (const call of [...calls].sort((a, b) => b.start - a.start)) {
+    const svg = svgById.get(call.id);
+    if (svg === undefined)
+      continue;
+    out = out.slice(0, call.start) + iconExpr(svg, call) + out.slice(call.end);
+  }
+  return out;
+}, iconExpr = (svg, call) => {
+  const body = call.bake ? svg.split("currentColor").join(call.bake) : svg;
+  const src = `SvgSource(\`${escapeTemplate(body)}\`)`;
+  return call.tint ? `Object.assign(${src}, { tintColor: (${call.tint}) })` : src;
+}, escapeTemplate = (s) => s.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${"), applyAssetIconMacro = async (entries, resolveSvgs) => {
+  const scanned = entries.filter((e) => e.type === "text" && typeof e.text === "string" && e.text.includes("assetIcon")).map((e) => ({ entry: e, calls: scanAssetIconCalls(e.text) })).filter((s) => s.calls.length > 0);
+  if (scanned.length === 0)
+    return [];
+  const errors = scanned.flatMap((s) => s.calls.filter((c) => c.error).map((c) => c.error));
+  if (errors.length)
+    throw new Error([...new Set(errors)].join(`
+`));
+  const ids = [...new Set(scanned.flatMap((s) => s.calls.map((c) => c.id)))];
+  const svgById = await resolveSvgs(ids);
+  const missing = ids.filter((id) => !svgById.has(id));
+  if (missing.length)
+    throw new Error(`assetIcon: could not resolve icon(s): ${missing.join(", ")}.`);
+  for (const { entry, calls } of scanned)
+    entry.text = rewriteAssetIcons(entry.text, calls, svgById);
+  return ids;
+}, buildIconsHeaderValue = (ids) => [...new Set(ids.map((id) => id.split(":")[0]))].sort().join(";"), editDistance = (a, b, cap) => {
+  if (Math.abs(a.length - b.length) > cap)
+    return cap + 1;
+  let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1;i <= a.length; i++) {
+    const cur = [i];
+    let rowMin = i;
+    for (let j = 1;j <= b.length; j++) {
+      cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+      if (cur[j] < rowMin)
+        rowMin = cur[j];
+    }
+    if (rowMin > cap)
+      return cap + 1;
+    prev = cur;
+  }
+  return prev[b.length];
+}, suggestIconNames = (want, icons) => {
+  const wantParts = new Set(want.split("-").filter(Boolean));
+  const scored = [];
+  for (const [name, info] of Object.entries(icons)) {
+    const lenDiff = Math.abs(name.length - want.length) / 100;
+    let rank;
+    if (name.includes(want) || want.includes(name))
+      rank = lenDiff;
+    else {
+      const d = editDistance(want, name, 2);
+      if (d <= 2)
+        rank = 1 + d;
+      else if (info.kw?.some((k) => wantParts.has(k)))
+        rank = 4 + lenDiff;
+      else
+        continue;
+    }
+    scored.push({ name, rank });
+  }
+  return scored.sort((a, b) => a.rank - b.rank || (a.name < b.name ? -1 : 1)).slice(0, 5).map((s) => s.name);
+}, iconNotFoundError = async (pack, name, read, registry) => {
+  const metaRaw = await read(`${pack}/meta.json`);
+  if (metaRaw !== null) {
+    let icons = {};
+    try {
+      icons = JSON.parse(metaRaw).icons ?? {};
+    } catch {}
+    const similar = suggestIconNames(name, icons);
+    const hint = similar.length ? ` Did you mean ${similar.map((s) => `"${pack}:${s}"`).join(", ")}?` : ` No similar name in the "${pack}" pack either.`;
+    return new Error(`assetIcon: icon "${pack}:${name}" not found.${hint}`);
+  }
+  const licRaw = await read("licenses.json");
+  if (licRaw !== null) {
+    try {
+      const packs = Object.keys(JSON.parse(licRaw)).sort();
+      return new Error(`assetIcon: unknown icon pack "${pack}" (in "${pack}:${name}"). Available packs: ${packs.join(", ")}.`);
+    } catch {}
+  }
+  return Object.assign(new Error(`assetIcon: can't reach the icon registry${registry ? ` (${registry})` : ""} to resolve "${pack}:${name}". ` + `Check your connection, or set LECODES_ICON_REGISTRY.`), { transient: true });
+}, VENDORED_ICON_PATH, collectVendoredIcons = (entries) => {
+  const map = new Map;
+  for (const e of entries) {
+    if (e.type !== "text" || typeof e.text !== "string")
+      continue;
+    const m = VENDORED_ICON_PATH.exec(e.path);
+    if (m)
+      map.set(`${m[1]}:${m[2]}`, e.text);
+  }
+  return map;
+};
+var init_assetIconMacro = __esm(() => {
+  ICON_ID = /^([a-z0-9]+(?:-[a-z0-9]+)*):([a-z0-9]+(?:-[a-z0-9]+)*)$/;
+  VENDORED_ICON_PATH = /(?:^|\/)assets\/icons\/([a-z0-9]+(?:-[a-z0-9]+)*)\/([a-z0-9]+(?:-[a-z0-9]+)*)\.svg$/;
+});
+
+// ../../sdk/src/compile/compileProject.ts
+var localAssetBase = (path) => path.split(/[\\/]/).pop() ?? path, localAssetNames = (entries) => {
+  const seen = new Map;
+  for (const e of entries)
+    if (e.type === "resource") {
+      const b = localAssetBase(e.path);
+      seen.set(b, (seen.get(b) ?? 0) + 1);
+    }
+  const names = new Map;
+  for (const e of entries)
+    if (e.type === "resource") {
+      const b = localAssetBase(e.path);
+      names.set(e.path, (seen.get(b) ?? 0) > 1 ? e.path.replace(/^[./]+/, "").replace(/[\\/]/g, "__") : b);
+    }
+  return names;
+}, entriesToFiles = (entries, opts) => {
+  const files = {};
+  const localNames = localAssetNames(entries);
+  const localAssetId = (nameExpr) => `_creatorFetch.local(${nameExpr})`;
+  for (const e of entries) {
+    if (e.type === "resource") {
+      if (opts.localAssets && !e.remote) {
+        const name = localNames.get(e.path) ?? localAssetBase(e.path);
+        files[e.path] = `export default ("id:" + ${localAssetId(JSON.stringify(name))})`;
+      } else {
+        files[e.path] = `export default "${opts.publicUrl}${e.fileSrc ?? ""}"`;
+      }
+    } else if (e.type === "shader") {
+      const shaders = e.shaders ?? [];
+      if (e.shadersLocal && shaders.length > 0) {
+        const name = shaders[0].src.split(/[\/]/).pop() ?? "";
+        const [prefix, suffix = ".filamat"] = name.split("_opengl");
+        files[e.path] = `export default ("id:" + ${localAssetId(`${JSON.stringify(prefix + "_")} + _creator.backend + ${JSON.stringify(suffix)}`)})`;
+      } else if (shaders.length > 0) {
+        files[e.path] = `export default \`${opts.publicUrl}${shaders[0].src.replace("_opengl", "_${_creator.backend}")}\``;
+      } else {
+        files[e.path] = `export default ""`;
+      }
+    } else if (e.path.toLowerCase().endsWith(".svg")) {
+      files[e.path] = `export default SvgSource(\`${escapeTemplate(e.text ?? "")}\`)`;
+    } else if (e.path.toLowerCase().endsWith(".json")) {
+      files[e.path] = `export default ${e.text?.trim() || "null"}`;
+    } else if (!CODE_EXT.test(e.path)) {
+      files[e.path] = `export default ${JSON.stringify(e.text ?? "")}`;
+    } else {
+      files[e.path] = e.text ?? "";
+    }
+  }
+  return files;
+}, pluginSpecsOf = (plugins) => {
+  if (Array.isArray(plugins))
+    return Object.fromEntries(plugins.filter((p) => typeof p === "string").map((id) => [id, "*"]));
+  if (plugins && typeof plugins === "object") {
+    return Object.fromEntries(Object.entries(plugins).map(([id, v]) => [id, typeof v === "string" ? v : "*"]));
+  }
+  return {};
+}, pluginIdsOf = (plugins) => Object.keys(pluginSpecsOf(plugins)), pluginsOfAppJson = (entries) => {
+  const app = entries.find((e) => e.path.replace(/^[./\\]+/, "") === "app.json");
+  if (!app?.text)
+    return [];
+  try {
+    return pluginIdsOf(JSON.parse(app.text).plugins);
+  } catch {
+    return [];
+  }
+}, pluginsOfBundle = (mapJson) => {
+  const ids = new Set;
+  try {
+    for (const source of JSON.parse(mapJson).sources ?? []) {
+      const m = /\/plugins\/gen\/([^/]+)\/sdk\//.exec(source);
+      if (m)
+        ids.add(m[1]);
+    }
+  } catch {}
+  return [...ids].sort();
+}, compileProjectWithMap = async (opts) => {
+  const published = clientPublishes(opts.entries);
+  if (published.length)
+    throw new ClientPublishError(published);
+  const entries = stubServerEntries(opts.entries, opts.serverUrl ?? "");
+  const entry = opts.entryOverride ?? detectEntry(entries, scanModulesChisel).entry;
+  if (!entry) {
+    throw new Error("Couldn't find an entrypoint (no .ts/.js project file — name yours main.ts). Pass entryOverride.");
+  }
+  const files = entriesToFiles(entries, opts);
+  const { code, map } = await bundleProjectWithMap(entry, files, opts.format ?? "esm", opts.minify, opts.editor, opts.libraries, opts.sourcemap ?? true);
+  const plugins = opts.plugins ?? pluginsOfAppJson(entries);
+  if (map && opts.onWarning) {
+    const missing = pluginsOfBundle(map).filter((id) => !plugins.includes(id));
+    if (missing.length) {
+      opts.onWarning(`The app uses ${missing.map((id) => `"${id}"`).join(", ")} and app.json does not list ${missing.length === 1 ? "it" : "them"}: a plugin that is not listed is not there — in a shell built from this project and in the browser alike. Add to app.json: "plugins": { ${missing.map((id) => `"${id}": "*"`).join(", ")} }`);
+    }
+  }
+  if (opts.header === false)
+    return { code, map, entry };
+  const header = buildHeader(opts.name, code, { icon: opts.icon, fonts: opts.fontsHeader, icons: opts.iconsHeader, plugins });
+  const headerLines = (header.match(/\n/g) ?? []).length;
+  return { code: header + code, map: map ? offsetSourceMap(map, headerLines) : null, entry };
+}, compileProject = async (opts) => {
+  const { code, map } = await compileProjectWithMap(opts);
+  return map ? `${code}
+${inlineSourceMapComment(map)}` : code;
+};
+var init_compileProject = __esm(() => {
+  init_bundler();
+  init_detectEntry();
+  init_header();
+  init_serverSplit();
+  init_assetMacro();
+  init_assetIconMacro();
+});
+
+// ../../sdk/src/compile/sceneEditor.ts
+var SCENE_HARNESS_DIR = "./.scene-editor", SCENE_ENTRY_PATH = "./.scene-entry.ts", resolveRelative = (fromPath, spec) => {
+  const segs = (p) => p.split("/").filter((s) => s !== "" && s !== ".");
+  const out = segs(fromPath).slice(0, -1);
+  for (const seg of segs(spec)) {
+    if (seg === "..")
+      out.pop();
+    else
+      out.push(seg);
+  }
+  return "./" + out.join("/");
+}, sceneImportsOf = (sceneText, scenePath, projectPaths) => {
+  const known = new Set(projectPaths);
+  const out = [];
+  const re = /^\s*import\s+[A-Za-z_$][\w$]*\s+from\s+["']([^"']+\.scene(?:\.ts)?)["']/gm;
+  for (const m of sceneText.matchAll(re)) {
+    const spec = m[1];
+    if (!spec.startsWith("."))
+      continue;
+    let p = resolveRelative(scenePath, spec);
+    if (!p.endsWith(".ts"))
+      p += ".ts";
+    if (known.has(p) && !out.includes(p))
+      out.push(p);
+  }
+  return out;
+}, sceneEditorEntries = (scenePath, harness, projectPaths = [], sceneImports = []) => {
+  const entries = Object.entries(harness).map(([name, text]) => ({
+    path: `${SCENE_HARNESS_DIR}/${name}`,
+    type: "text",
+    text
+  }));
+  entries.push({
+    path: `${SCENE_HARNESS_DIR}/.edit-mode.ts`,
+    type: "text",
+    text: `;(globalThis as any).__lecodesSceneEdit = true
+export {}
+`
+  });
+  const editorImports = projectPaths.filter((p) => p.endsWith(".editor.ts")).map((p) => `import "${p}"
+`).join("");
+  const materialPaths = projectPaths.filter((p) => p.endsWith(".material.ts"));
+  const materialImports = materialPaths.map((p, i) => `import __mat${i} from "${p}"
+`).join("");
+  const materialRegister = materialPaths.length === 0 ? "" : `;(globalThis as any).__lecodesMaterials = { ${materialPaths.map((p, i) => `${JSON.stringify(p)}: __mat${i}`).join(", ")} }
+`;
+  const sceneImportLines = sceneImports.map((p, i) => `import __scn${i} from "${p}"
+`).join("");
+  const sceneRegister = sceneImports.length === 0 ? "" : `;(globalThis as any).__lecodesSceneFiles = { ${sceneImports.map((p, i) => `${JSON.stringify(p)}: __scn${i}`).join(", ")} }
+`;
+  entries.push({
+    path: SCENE_ENTRY_PATH,
+    type: "text",
+    text: `import "${SCENE_HARNESS_DIR}/.edit-mode.ts"
+` + materialImports + sceneImportLines + `import "${scenePath}"
+` + editorImports + `import "${SCENE_HARNESS_DIR}/main.ts"
+` + materialRegister + sceneRegister
+  });
+  return entries;
+};
+
+// ../../sdk/src/compile/fontRegistry.ts
+var DEFAULT_FONT_REGISTRY_BASE = "https://cdn.le.codes/fonts/v1", fontRegistryBase = () => typeof process !== "undefined" && process.env?.LECODES_FONT_REGISTRY?.trim() || DEFAULT_FONT_REGISTRY_BASE, faceFileName = (id, weight, italic, ext) => `${id}-${weight}${italic ? "-italic" : ""}.${ext}`, LATIN, CYR, OFL = "OFL-1.1", f = (family, category, scripts, weights, italics, defaultWeights) => ({ family, category, scripts, weights, italics, defaultWeights, license: OFL }), FONT_REGISTRY;
+var init_fontRegistry = __esm(() => {
+  LATIN = ["latin"];
+  CYR = ["latin", "cyrillic"];
+  FONT_REGISTRY = {
+    inter: f("Inter", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
+    manrope: f("Manrope", "sans-serif", CYR, [200, 300, 400, 500, 600, 700, 800], [], [400, 500, 700]),
+    "golos-text": f("Golos Text", "sans-serif", CYR, [400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
+    onest: f("Onest", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [], [400, 500, 700]),
+    rubik: f("Rubik", "sans-serif", CYR, [300, 400, 500, 600, 700, 800, 900], [300, 400, 500, 600, 700, 800, 900], [400, 500, 700]),
+    nunito: f("Nunito", "sans-serif", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 600, 700]),
+    montserrat: f("Montserrat", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
+    "ibm-plex-sans": f("IBM Plex Sans", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700], [400, 700], [400, 500, 700]),
+    "pt-sans": f("PT Sans", "sans-serif", CYR, [400, 700], [400, 700], [400, 700]),
+    jost: f("Jost", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
+    "exo-2": f("Exo 2", "sans-serif", CYR, [100, 200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 500, 700]),
+    unbounded: f("Unbounded", "display", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [], [400, 700]),
+    "russo-one": f("Russo One", "display", CYR, [400], [], [400]),
+    oswald: f("Oswald", "display", CYR, [200, 300, 400, 500, 600, 700], [], [400, 700]),
+    comfortaa: f("Comfortaa", "display", CYR, [300, 400, 500, 600, 700], [], [400, 700]),
+    "space-grotesk": f("Space Grotesk", "display", LATIN, [300, 400, 500, 600, 700], [], [400, 700]),
+    "playfair-display": f("Playfair Display", "serif", CYR, [400, 500, 600, 700, 800, 900], [400, 700], [400, 700]),
+    lora: f("Lora", "serif", CYR, [400, 500, 600, 700], [400, 700], [400, 700]),
+    "pt-serif": f("PT Serif", "serif", CYR, [400, 700], [400, 700], [400, 700]),
+    cormorant: f("Cormorant", "serif", CYR, [300, 400, 500, 600, 700], [400, 700], [400, 700]),
+    literata: f("Literata", "serif", CYR, [200, 300, 400, 500, 600, 700, 800, 900], [400, 700], [400, 700]),
+    "jetbrains-mono": f("JetBrains Mono", "monospace", CYR, [100, 200, 300, 400, 500, 600, 700, 800], [400, 700], [400, 700]),
+    "fira-code": f("Fira Code", "monospace", CYR, [300, 400, 500, 600, 700], [], [400, 700]),
+    "ibm-plex-mono": f("IBM Plex Mono", "monospace", CYR, [100, 200, 300, 400, 500, 600, 700], [400, 700], [400, 700]),
+    caveat: f("Caveat", "handwriting", CYR, [400, 500, 600, 700], [], [400, 700]),
+    pacifico: f("Pacifico", "handwriting", CYR, [400], [], [400])
+  };
+});
+
+// ../../sdk/src/compile/sfnt.ts
+var TAG_TTF = 65536, TAG_OTTO = 1330926671, TAG_TTCF = 1953784678, TAG_WOFF = 2001684038, TAG_WOF2 = 2001684018, parseSfnt = (bytes) => {
+  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  if (bytes.byteLength < 12)
+    throw new Error("not a font file (truncated)");
+  const version = dv.getUint32(0);
+  if (version === TAG_TTCF)
+    throw new Error("font collections (.ttc) aren't supported — export a single face");
+  if (version === TAG_WOFF || version === TAG_WOF2)
+    throw new Error("WOFF/WOFF2 project fonts aren't supported — use the .ttf/.otf");
+  if (version !== TAG_TTF && version !== TAG_OTTO)
+    throw new Error("not a TTF/OTF font file");
+  const numTables = dv.getUint16(4);
+  const tables = new Map;
+  for (let i = 0;i < numTables; i++) {
+    const rec = 12 + i * 16;
+    if (rec + 16 > bytes.byteLength)
+      throw new Error("not a font file (truncated table directory)");
+    const tag = String.fromCharCode(bytes[rec], bytes[rec + 1], bytes[rec + 2], bytes[rec + 3]);
+    tables.set(tag, { offset: dv.getUint32(rec + 8), length: dv.getUint32(rec + 12) });
+  }
+  const family = readFamily(dv, bytes, tables.get("name"));
+  if (!family)
+    throw new Error("no family name in the font's `name` table");
+  let weight = 400;
+  let italic = false;
+  const os2 = tables.get("OS/2");
+  if (os2 && os2.offset + 64 <= bytes.byteLength) {
+    weight = dv.getUint16(os2.offset + 4);
+    italic = (dv.getUint16(os2.offset + 62) & 1) === 1;
+  } else {
+    const head = tables.get("head");
+    if (head && head.offset + 46 <= bytes.byteLength) {
+      const macStyle = dv.getUint16(head.offset + 44);
+      if (macStyle & 1)
+        weight = 700;
+      italic = (macStyle & 2) === 2;
+    }
+  }
+  if (weight < 1 || weight > 1000)
+    weight = 400;
+  return { family, weight, italic };
+}, readFamily = (dv, bytes, name) => {
+  if (!name || name.offset + 6 > bytes.byteLength)
+    return "";
+  const base = name.offset;
+  const count = dv.getUint16(base + 2);
+  const stringOffset = base + dv.getUint16(base + 4);
+  let best = "";
+  let bestScore = -1;
+  for (let i = 0;i < count; i++) {
+    const rec = base + 6 + i * 12;
+    if (rec + 12 > bytes.byteLength)
+      break;
+    const platformID = dv.getUint16(rec);
+    const languageID = dv.getUint16(rec + 4);
+    const nameID = dv.getUint16(rec + 6);
+    const length = dv.getUint16(rec + 8);
+    const offset = stringOffset + dv.getUint16(rec + 10);
+    if (nameID !== 16 && nameID !== 1)
+      continue;
+    if (offset + length > bytes.byteLength)
+      continue;
+    let score = nameID === 16 ? 100 : 0;
+    if (platformID === 3)
+      score += languageID === 1033 ? 30 : 20;
+    else if (platformID === 0)
+      score += 10;
+    if (score <= bestScore)
+      continue;
+    const text = platformID === 1 ? decodeLatin1(bytes, offset, length) : decodeUtf16be(bytes, offset, length);
+    if (!text.trim())
+      continue;
+    best = text.trim();
+    bestScore = score;
+  }
+  return best;
+}, decodeUtf16be = (bytes, offset, length) => {
+  let out = "";
+  for (let i = 0;i + 1 < length; i += 2)
+    out += String.fromCharCode(bytes[offset + i] << 8 | bytes[offset + i + 1]);
+  return out;
+}, decodeLatin1 = (bytes, offset, length) => {
+  let out = "";
+  for (let i = 0;i < length; i++)
+    out += String.fromCharCode(bytes[offset + i]);
+  return out;
+};
+
+// ../../sdk/src/compile/fontMacro.ts
+var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart2 = (c) => c >= "A" && c <= "Z" || c >= "a" && c <= "z" || c === "_" || c === "$", isIdentPart2 = (c) => isIdentStart2(c) || c >= "0" && c <= "9", skipString3 = (src, start) => {
+  const quote = src[start];
+  const n = src.length;
+  let i = start + 1;
+  while (i < n) {
+    const c = src[i];
+    if (c === "\\") {
+      i += 2;
+      continue;
+    }
+    if (quote === "`" && c === "$" && src[i + 1] === "{") {
+      i = skipBraces2(src, i + 1);
+      continue;
+    }
+    if (c === quote)
+      return i + 1;
+    i++;
+  }
+  return n;
+}, skipBraces2 = (src, open) => {
+  const n = src.length;
+  let depth = 0;
+  let i = open;
+  while (i < n) {
+    const c = src[i];
+    if (c === '"' || c === "'" || c === "`") {
+      i = skipString3(src, i);
+      continue;
+    }
+    if (c === "{")
+      depth++;
+    else if (c === "}") {
+      depth--;
+      if (depth === 0)
+        return i + 1;
+    }
+    i++;
+  }
+  return n;
+}, matchParen2 = (src, open) => {
+  const n = src.length;
+  let depth = 0;
+  let i = open;
+  while (i < n) {
+    const c = src[i];
+    if (c === '"' || c === "'" || c === "`") {
+      i = skipString3(src, i);
+      continue;
+    }
+    if (c === "/" && src[i + 1] === "/") {
+      i += 2;
+      while (i < n && src[i] !== `
+`)
+        i++;
+      continue;
+    }
+    if (c === "/" && src[i + 1] === "*") {
+      i += 2;
+      while (i < n && !(src[i] === "*" && src[i + 1] === "/"))
+        i++;
+      i += 2;
+      continue;
+    }
+    if (c === "(")
+      depth++;
+    else if (c === ")") {
+      depth--;
+      if (depth === 0)
+        return i;
+    }
+    i++;
+  }
+  return -1;
+}, splitTopLevel2 = (text, delim) => {
+  const parts = [];
+  const n = text.length;
+  let depth = 0;
+  let last = 0;
+  let i = 0;
+  while (i < n) {
+    const c = text[i];
+    if (c === '"' || c === "'" || c === "`") {
+      i = skipString3(text, i);
+      continue;
+    }
+    if (c === "(" || c === "[" || c === "{")
+      depth++;
+    else if (c === ")" || c === "]" || c === "}")
+      depth = Math.max(0, depth - 1);
+    else if (depth === 0 && c === delim) {
+      parts.push(text.slice(last, i));
+      last = i + 1;
+    }
+    i++;
+  }
+  parts.push(text.slice(last));
+  return parts;
+}, stringLiteralValue2 = (text) => {
+  const t = text.trim();
+  if (t.length < 2)
+    return null;
+  const q = t[0];
+  if (q !== '"' && q !== "'" && q !== "`" || t[t.length - 1] !== q)
+    return null;
+  const inner = t.slice(1, -1);
+  if (q === "`" && inner.includes("${"))
+    return null;
+  if (inner.includes(q) && !inner.includes("\\" + q))
+    return null;
+  return inner.replace(/\\(.)/g, "$1");
+}, prevNonSpace2 = (src, i) => {
+  let k = i - 1;
+  while (k >= 0 && /\s/.test(src[k]))
+    k--;
+  return k >= 0 ? src[k] : "";
+}, scanFontCalls = (source) => {
+  const calls = [];
+  const n = source.length;
+  let i = 0;
+  while (i < n) {
+    const c = source[i];
+    if (c === '"' || c === "'" || c === "`") {
+      i = skipString3(source, i);
+      continue;
+    }
+    if (c === "/" && source[i + 1] === "/") {
+      i += 2;
+      while (i < n && source[i] !== `
+`)
+        i++;
+      continue;
+    }
+    if (c === "/" && source[i + 1] === "*") {
+      i += 2;
+      while (i < n && !(source[i] === "*" && source[i + 1] === "/"))
+        i++;
+      i += 2;
+      continue;
+    }
+    if (isIdentStart2(c)) {
+      let j = i + 1;
+      while (j < n && isIdentPart2(source[j]))
+        j++;
+      if (source.slice(i, j) === "font" && prevNonSpace2(source, i) !== ".") {
+        const call = parseCall2(source, i, j);
+        if (call) {
+          calls.push(call);
+          i = call.end;
+          continue;
+        }
+      }
+      i = j;
+      continue;
+    }
+    i++;
+  }
+  return calls;
+}, parseCall2 = (src, start, identEnd) => {
+  const n = src.length;
+  let i = identEnd;
+  while (i < n && /\s/.test(src[i]))
+    i++;
+  if (src[i] !== "(")
+    return null;
+  const close = matchParen2(src, i);
+  if (close === -1)
+    return null;
+  const call = { start, end: close + 1, arg: "", kind: "registry" };
+  const args = splitTopLevel2(src.slice(i + 1, close), ",");
+  const arg = stringLiteralValue2(args[0] ?? "");
   if (arg === null) {
     call.error = `font(...) needs a string-literal argument — a registry id ("manrope") or a project path ("./fonts/Brand.ttf"). Got \`${(args[0] ?? "").trim() || "()"}\`.`;
     return call;
@@ -171726,10 +172156,10 @@ var FONT_ID, CODE_FILE, DECLARES_FONT, isIdentStart = (c) => c >= "A" && c <= "Z
   if (!optsText.startsWith("{") || !optsText.endsWith("}")) {
     return `font("${call.arg}", opts): opts must be an object literal like { weights: [400, 700] }.`;
   }
-  for (const prop of splitTopLevel(optsText.slice(1, -1), ",")) {
+  for (const prop of splitTopLevel2(optsText.slice(1, -1), ",")) {
     if (!prop.trim())
       continue;
-    const kv = splitTopLevel(prop, ":");
+    const kv = splitTopLevel2(prop, ":");
     if (kv.length < 2)
       return `font("${call.arg}"): couldn't parse option \`${prop.trim()}\`.`;
     const key = kv[0].trim().replace(/^["'`]|["'`]$/g, "");
@@ -171924,321 +172354,6 @@ var init_fontMacro = __esm(() => {
   DECLARES_FONT = /\b(?:function|const|let|var|class)\s+font\b|\bimport\s+(?:\{[^}]*\bfont\b[^}]*\}|font)\s+from\b/;
 });
 
-// ../../sdk/src/compile/assetIconMacro.ts
-var ICON_ID, isIdentStart2 = (c) => c >= "A" && c <= "Z" || c >= "a" && c <= "z" || c === "_" || c === "$", isIdentPart2 = (c) => isIdentStart2(c) || c >= "0" && c <= "9", skipString3 = (src, start) => {
-  const quote = src[start];
-  const n = src.length;
-  let i = start + 1;
-  while (i < n) {
-    const c = src[i];
-    if (c === "\\") {
-      i += 2;
-      continue;
-    }
-    if (quote === "`" && c === "$" && src[i + 1] === "{") {
-      i = skipBraces2(src, i + 1);
-      continue;
-    }
-    if (c === quote)
-      return i + 1;
-    i++;
-  }
-  return n;
-}, skipBraces2 = (src, open) => {
-  const n = src.length;
-  let depth = 0;
-  let i = open;
-  while (i < n) {
-    const c = src[i];
-    if (c === '"' || c === "'" || c === "`") {
-      i = skipString3(src, i);
-      continue;
-    }
-    if (c === "{")
-      depth++;
-    else if (c === "}") {
-      depth--;
-      if (depth === 0)
-        return i + 1;
-    }
-    i++;
-  }
-  return n;
-}, matchParen2 = (src, open) => {
-  const n = src.length;
-  let depth = 0;
-  let i = open;
-  while (i < n) {
-    const c = src[i];
-    if (c === '"' || c === "'" || c === "`") {
-      i = skipString3(src, i);
-      continue;
-    }
-    if (c === "/" && src[i + 1] === "/") {
-      i += 2;
-      while (i < n && src[i] !== `
-`)
-        i++;
-      continue;
-    }
-    if (c === "/" && src[i + 1] === "*") {
-      i += 2;
-      while (i < n && !(src[i] === "*" && src[i + 1] === "/"))
-        i++;
-      i += 2;
-      continue;
-    }
-    if (c === "(")
-      depth++;
-    else if (c === ")") {
-      depth--;
-      if (depth === 0)
-        return i;
-    }
-    i++;
-  }
-  return -1;
-}, splitTopLevel2 = (text, delim) => {
-  const parts = [];
-  const n = text.length;
-  let depth = 0;
-  let last = 0;
-  let i = 0;
-  while (i < n) {
-    const c = text[i];
-    if (c === '"' || c === "'" || c === "`") {
-      i = skipString3(text, i);
-      continue;
-    }
-    if (c === "(" || c === "[" || c === "{")
-      depth++;
-    else if (c === ")" || c === "]" || c === "}")
-      depth = Math.max(0, depth - 1);
-    else if (depth === 0 && c === delim) {
-      parts.push(text.slice(last, i));
-      last = i + 1;
-    }
-    i++;
-  }
-  parts.push(text.slice(last));
-  return parts;
-}, stringLiteralValue2 = (text) => {
-  const t = text.trim();
-  if (t.length < 2)
-    return null;
-  const q = t[0];
-  if (q !== '"' && q !== "'" && q !== "`" || t[t.length - 1] !== q)
-    return null;
-  const inner = t.slice(1, -1);
-  if (q === "`" && inner.includes("${"))
-    return null;
-  if (inner.includes(q) && !inner.includes("\\" + q))
-    return null;
-  return inner.replace(/\\(.)/g, "$1");
-}, scanAssetIconCalls = (source) => {
-  const calls = [];
-  const n = source.length;
-  let i = 0;
-  while (i < n) {
-    const c = source[i];
-    if (c === '"' || c === "'" || c === "`") {
-      i = skipString3(source, i);
-      continue;
-    }
-    if (c === "/" && source[i + 1] === "/") {
-      i += 2;
-      while (i < n && source[i] !== `
-`)
-        i++;
-      continue;
-    }
-    if (c === "/" && source[i + 1] === "*") {
-      i += 2;
-      while (i < n && !(source[i] === "*" && source[i + 1] === "/"))
-        i++;
-      i += 2;
-      continue;
-    }
-    if (isIdentStart2(c)) {
-      let j = i + 1;
-      while (j < n && isIdentPart2(source[j]))
-        j++;
-      if (source.slice(i, j) === "assetIcon" && prevNonSpace2(source, i) !== ".") {
-        const call = parseCall2(source, i, j);
-        if (call) {
-          calls.push(call);
-          i = call.end;
-          continue;
-        }
-      }
-      i = j;
-      continue;
-    }
-    i++;
-  }
-  return calls;
-}, prevNonSpace2 = (src, i) => {
-  let k = i - 1;
-  while (k >= 0 && /\s/.test(src[k]))
-    k--;
-  return k >= 0 ? src[k] : "";
-}, parseCall2 = (src, start, identEnd) => {
-  const n = src.length;
-  let i = identEnd;
-  while (i < n && /\s/.test(src[i]))
-    i++;
-  if (src[i] !== "(")
-    return null;
-  const close = matchParen2(src, i);
-  if (close === -1)
-    return null;
-  const call = { start, end: close + 1, id: "", pack: "", name: "" };
-  const args = splitTopLevel2(src.slice(i + 1, close), ",");
-  const id = stringLiteralValue2(args[0] ?? "");
-  if (id === null) {
-    call.error = `assetIcon(...) needs a string-literal id like "lucide:bell" (got \`${(args[0] ?? "").trim() || "()"}\`).`;
-    return call;
-  }
-  const m = ICON_ID.exec(id);
-  if (!m) {
-    call.error = `assetIcon("${id}"): id must be "pack:name", lowercase [a-z0-9-] (e.g. "lucide:bell").`;
-    return call;
-  }
-  call.id = id;
-  call.pack = m[1];
-  call.name = m[2];
-  const optsText = args[1]?.trim();
-  if (optsText) {
-    const color = extractColor(optsText);
-    if (color.error) {
-      call.error = color.error;
-      return call;
-    }
-    if (color.bake !== undefined)
-      call.bake = color.bake;
-    else if (color.tint !== undefined)
-      call.tint = color.tint;
-  }
-  return call;
-}, extractColor = (optsText) => {
-  if (!optsText.startsWith("{") || !optsText.endsWith("}")) {
-    return { error: `assetIcon(id, opts): opts must be an object literal like { color: "#5b8cff" }.` };
-  }
-  for (const prop of splitTopLevel2(optsText.slice(1, -1), ",")) {
-    const kv = splitTopLevel2(prop, ":");
-    if (kv.length < 2)
-      continue;
-    const key = kv[0].trim().replace(/^["'`]|["'`]$/g, "");
-    if (key !== "color")
-      continue;
-    const raw = kv.slice(1).join(":").trim();
-    if (!raw)
-      continue;
-    const literal = stringLiteralValue2(raw);
-    return literal !== null ? { bake: literal } : { tint: raw };
-  }
-  return {};
-}, rewriteAssetIcons = (source, calls, svgById) => {
-  let out = source;
-  for (const call of [...calls].sort((a, b) => b.start - a.start)) {
-    const svg = svgById.get(call.id);
-    if (svg === undefined)
-      continue;
-    out = out.slice(0, call.start) + iconExpr(svg, call) + out.slice(call.end);
-  }
-  return out;
-}, iconExpr = (svg, call) => {
-  const body = call.bake ? svg.split("currentColor").join(call.bake) : svg;
-  const src = `SvgSource(\`${escapeTemplate(body)}\`)`;
-  return call.tint ? `Object.assign(${src}, { tintColor: (${call.tint}) })` : src;
-}, escapeTemplate = (s) => s.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${"), applyAssetIconMacro = async (entries, resolveSvgs) => {
-  const scanned = entries.filter((e) => e.type === "text" && typeof e.text === "string" && e.text.includes("assetIcon")).map((e) => ({ entry: e, calls: scanAssetIconCalls(e.text) })).filter((s) => s.calls.length > 0);
-  if (scanned.length === 0)
-    return [];
-  const errors = scanned.flatMap((s) => s.calls.filter((c) => c.error).map((c) => c.error));
-  if (errors.length)
-    throw new Error([...new Set(errors)].join(`
-`));
-  const ids = [...new Set(scanned.flatMap((s) => s.calls.map((c) => c.id)))];
-  const svgById = await resolveSvgs(ids);
-  const missing = ids.filter((id) => !svgById.has(id));
-  if (missing.length)
-    throw new Error(`assetIcon: could not resolve icon(s): ${missing.join(", ")}.`);
-  for (const { entry, calls } of scanned)
-    entry.text = rewriteAssetIcons(entry.text, calls, svgById);
-  return ids;
-}, buildIconsHeaderValue = (ids) => [...new Set(ids.map((id) => id.split(":")[0]))].sort().join(";"), editDistance = (a, b, cap) => {
-  if (Math.abs(a.length - b.length) > cap)
-    return cap + 1;
-  let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
-  for (let i = 1;i <= a.length; i++) {
-    const cur = [i];
-    let rowMin = i;
-    for (let j = 1;j <= b.length; j++) {
-      cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
-      if (cur[j] < rowMin)
-        rowMin = cur[j];
-    }
-    if (rowMin > cap)
-      return cap + 1;
-    prev = cur;
-  }
-  return prev[b.length];
-}, suggestIconNames = (want, icons) => {
-  const wantParts = new Set(want.split("-").filter(Boolean));
-  const scored = [];
-  for (const [name, info] of Object.entries(icons)) {
-    const lenDiff = Math.abs(name.length - want.length) / 100;
-    let rank;
-    if (name.includes(want) || want.includes(name))
-      rank = lenDiff;
-    else {
-      const d = editDistance(want, name, 2);
-      if (d <= 2)
-        rank = 1 + d;
-      else if (info.kw?.some((k) => wantParts.has(k)))
-        rank = 4 + lenDiff;
-      else
-        continue;
-    }
-    scored.push({ name, rank });
-  }
-  return scored.sort((a, b) => a.rank - b.rank || (a.name < b.name ? -1 : 1)).slice(0, 5).map((s) => s.name);
-}, iconNotFoundError = async (pack, name, read, registry) => {
-  const metaRaw = await read(`${pack}/meta.json`);
-  if (metaRaw !== null) {
-    let icons = {};
-    try {
-      icons = JSON.parse(metaRaw).icons ?? {};
-    } catch {}
-    const similar = suggestIconNames(name, icons);
-    const hint = similar.length ? ` Did you mean ${similar.map((s) => `"${pack}:${s}"`).join(", ")}?` : ` No similar name in the "${pack}" pack either.`;
-    return new Error(`assetIcon: icon "${pack}:${name}" not found.${hint}`);
-  }
-  const licRaw = await read("licenses.json");
-  if (licRaw !== null) {
-    try {
-      const packs = Object.keys(JSON.parse(licRaw)).sort();
-      return new Error(`assetIcon: unknown icon pack "${pack}" (in "${pack}:${name}"). Available packs: ${packs.join(", ")}.`);
-    } catch {}
-  }
-  return Object.assign(new Error(`assetIcon: can't reach the icon registry${registry ? ` (${registry})` : ""} to resolve "${pack}:${name}". ` + `Check your connection, or set LECODES_ICON_REGISTRY.`), { transient: true });
-}, VENDORED_ICON_PATH, collectVendoredIcons = (entries) => {
-  const map = new Map;
-  for (const e of entries) {
-    if (e.type !== "text" || typeof e.text !== "string")
-      continue;
-    const m = VENDORED_ICON_PATH.exec(e.path);
-    if (m)
-      map.set(`${m[1]}:${m[2]}`, e.text);
-  }
-  return map;
-};
-var init_assetIconMacro = __esm(() => {
-  ICON_ID = /^([a-z0-9]+(?:-[a-z0-9]+)*):([a-z0-9]+(?:-[a-z0-9]+)*)$/;
-  VENDORED_ICON_PATH = /(?:^|\/)assets\/icons\/([a-z0-9]+(?:-[a-z0-9]+)*)\/([a-z0-9]+(?:-[a-z0-9]+)*)\.svg$/;
-});
-
 // ../../sdk/src/compile/index.ts
 var init_compile = __esm(() => {
   init_bundler();
@@ -207593,15 +207708,26 @@ var init_channel = __esm(() => {
   seam = globalThis;
 });
 
+// ../../sdk/src/server/pushChannel.ts
+var seam2, setPushSender = (sender) => {
+  if (sender)
+    seam2.__lecodesPushSend = sender;
+  else
+    delete seam2.__lecodesPushSend;
+}, isPushChannel = (v) => typeof v === "object" && v !== null && v.__pushChannel === true;
+var init_pushChannel = __esm(() => {
+  seam2 = globalThis;
+});
+
 // ../../sdk/src/server/context.ts
-var seam2, setRequestProvider = (provider) => {
+var seam3, setRequestProvider = (provider) => {
   if (provider)
-    seam2.__lecodesRequest = provider;
+    seam3.__lecodesRequest = provider;
   else
-    delete seam2.__lecodesRequest;
-}, currentRequest = () => seam2.__lecodesRequest?.();
+    delete seam3.__lecodesRequest;
+}, currentRequest = () => seam3.__lecodesRequest?.();
 var init_context2 = __esm(() => {
-  seam2 = globalThis;
+  seam3 = globalThis;
 });
 
 // ../../sdk/src/server/db/fields.ts
@@ -207654,9 +207780,9 @@ var init_fields = __esm(() => {
 });
 
 // ../../sdk/src/server/errors.ts
-var ApiError;
+var ApiError2;
 var init_errors3 = __esm(() => {
-  ApiError = class ApiError extends Error {
+  ApiError2 = class ApiError2 extends Error {
     status;
     constructor(status, message = "") {
       super(message);
@@ -207689,30 +207815,30 @@ var FILE_MODEL = "File", filePublicFields = () => ({
   width: t.int().optional(),
   height: t.int().optional(),
   createdAt: t.date().default("now")
-}), seam3, setFilesSeam = (value) => {
+}), seam4, setFilesSeam = (value) => {
   if (value)
-    seam3.__lecodesFiles = value;
+    seam4.__lecodesFiles = value;
   else
-    delete seam3.__lecodesFiles;
+    delete seam4.__lecodesFiles;
 };
 var init_models2 = __esm(() => {
   init_fields();
-  seam3 = globalThis;
+  seam4 = globalThis;
 });
 
 // ../../sdk/src/server/db/defineDb.ts
-var seam4, setDbTransport = (transport) => {
+var seam5, setDbTransport = (transport) => {
   if (transport)
-    seam4.__lecodesDbTransport = transport;
+    seam5.__lecodesDbTransport = transport;
   else
-    delete seam4.__lecodesDbTransport;
+    delete seam5.__lecodesDbTransport;
 }, takeRegisteredDbs = () => {
-  const dbs = seam4.__lecodesDbs ?? [];
-  seam4.__lecodesDbs = [];
+  const dbs = seam5.__lecodesDbs ?? [];
+  seam5.__lecodesDbs = [];
   return dbs;
 };
 var init_defineDb = __esm(() => {
-  seam4 = globalThis;
+  seam5 = globalThis;
 });
 
 // ../../sdk/src/server/validate.ts
@@ -207827,7 +207953,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "string", loadServerModules = (reg = globalThis.__lecodesServer) => {
   if (!reg)
     throw new Error("loadServerModules: no server bundle registered (globalThis.__lecodesServer)");
-  const out = { endpoints: new Map, channels: new Map, dbs: [], manifest: reg.manifest };
+  const out = { endpoints: new Map, channels: new Map, pushChannels: new Map, dbs: [], manifest: reg.manifest };
   for (const [mod, exports] of Object.entries(reg.modules)) {
     const kinds = new Map((reg.manifest?.modules?.[mod] ?? []).map((e) => [e.name, e.kind]));
     for (const [name, value] of Object.entries(exports)) {
@@ -207838,6 +207964,9 @@ var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "s
       } else if (isChannel(value)) {
         value.__id = id;
         out.channels.set(id, value);
+      } else if (isPushChannel(value)) {
+        value.__id = id;
+        out.pushChannels.set(id, value);
       } else if (isDb(value))
         out.dbs.push(value);
     }
@@ -207857,9 +207986,10 @@ var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "s
   if (name !== "MarciEmbeddedError" && name !== "MarciHttpError" || typeof kind !== "string")
     return null;
   return DB_ERROR_STATUS[kind] ?? null;
-}, als, installProvider = () => setRequestProvider(() => als.getStore()), withSession = (r, rc) => {
-  const issued = rc.auth?.issuedToken;
-  return issued ? { ...r, session: issued } : r;
+}, als, installProvider = () => setRequestProvider(() => als.getStore()), envelope = (server2) => (r, rc) => {
+  const s = rc.auth;
+  const out = s?.issuedToken ? { ...r, session: s.issuedToken } : r;
+  return s && s.userId !== null && !s.pushAddress && server2.pushChannels.size ? { ...out, push: true } : out;
 }, createInvoker = (server2, opts = {}) => {
   installProvider();
   const validate = opts.validate ?? true;
@@ -207867,6 +207997,7 @@ var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "s
   const params = server2.manifest.params;
   const auth = opts.auth ?? null;
   const files = opts.files ?? null;
+  const withSession = envelope(server2);
   return async (id, args, ctx = { headers: {} }) => {
     const fn = server2.endpoints.get(id);
     if (!fn)
@@ -207933,6 +208064,7 @@ var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "s
   const onError = opts.onError ?? ((id, e) => console.error(`[server] ${id}:`, e));
   const params = server2.manifest.params;
   const auth = opts.auth ?? null;
+  const withSession = envelope(server2);
   return async (channelId, args = [], ctx = { headers: {} }) => {
     const ch = server2.channels.get(channelId);
     if (!ch)
@@ -207965,6 +208097,7 @@ var isDb = (v) => typeof v === "object" && v !== null && typeof v.$schema === "s
 };
 var init_runtime = __esm(() => {
   init_channel();
+  init_pushChannel();
   init_context2();
   init_defineDb();
   init_validate();
@@ -208111,23 +208244,28 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
   return actual.length === expected.length && timingSafeEqual(actual, expected);
 }, checkPassword = (password) => {
   if (typeof password !== "string" || password.length < PASSWORD_MIN)
-    throw new ApiError(400, `Password must be at least ${PASSWORD_MIN} characters`);
+    throw new ApiError2(400, `Password must be at least ${PASSWORD_MIN} characters`);
   if (password.length > PASSWORD_MAX)
-    throw new ApiError(400, `Password must be at most ${PASSWORD_MAX} characters`);
+    throw new ApiError2(400, `Password must be at most ${PASSWORD_MAX} characters`);
   return password;
 }, EMAIL_RE, normalizeEmail = (email) => {
   const e = typeof email === "string" ? email.trim().toLowerCase() : "";
   if (!e || e.length > 254 || !EMAIL_RE.test(e))
-    throw new ApiError(400, "Invalid email");
+    throw new ApiError2(400, "Invalid email");
   return e;
 }, LOGIN_RE, parseLogin = (login) => {
   const l = typeof login === "string" ? login.trim() : "";
   if (l.includes("@"))
     return { provider: "email", subject: normalizeEmail(l) };
   if (!LOGIN_RE.test(l))
-    throw new ApiError(400, "Login must be 3–32 letters, digits, dots, dashes or underscores");
+    throw new ApiError2(400, "Login must be 3–32 letters, digits, dots, dashes or underscores");
   return { provider: "login", subject: l.toLowerCase() };
-}, identityKey = (provider, subject) => `${provider}:${subject}`, window2 = (map, key, now, span) => {
+}, identityKey = (provider, subject) => `${provider}:${subject}`, PUSH_ADDRESS_HEADER = "x-lecodes-push", PUSH_ADDRESS_RE, pushAddressOf = (ctx) => {
+  const headers = ctx.headers ?? {};
+  const raw = headers[PUSH_ADDRESS_HEADER] ?? Object.entries(headers).find(([k]) => k.toLowerCase() === PUSH_ADDRESS_HEADER)?.[1];
+  const value = typeof raw === "string" ? raw.trim() : "";
+  return PUSH_ADDRESS_RE.test(value) ? value : null;
+}, window2 = (map, key, now, span) => {
   const list = (map.get(key) ?? []).filter((x) => now - x < span);
   map.set(key, list);
   return list;
@@ -208153,14 +208291,15 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
   const requireSignedIn = (ctx) => {
     const id = stateOf(ctx).userId;
     if (id === null)
-      throw new ApiError(401, "Sign in required");
+      throw new ApiError2(401, "Sign in required");
     return id;
   };
   const mint = async (ctx) => {
     const token = randomToken();
-    const { id } = await sessions.insert({ tokenHash: await sha2562(token) });
-    const state = { sessionId: id, userId: null, issuedToken: token };
-    sessionCache.set(token, { sessionId: id, userId: null, at: now() });
+    const pushAddress = pushAddressOf(ctx);
+    const { id } = await sessions.insert({ tokenHash: await sha2562(token), ...pushAddress ? { pushAddress } : {} });
+    const state = { sessionId: id, userId: null, pushAddress, issuedToken: token };
+    sessionCache.set(token, { sessionId: id, userId: null, pushAddress, at: now() });
     ctx.auth = state;
     ctx.sessionToken = token;
     return state;
@@ -208181,6 +208320,15 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     if (opts.rotate)
       await rotate(ctx);
   };
+  const followPushAddress = async (token, sessionId, held, told) => {
+    if (!told || told === held)
+      return held;
+    await sessions.update(sessionId, { pushAddress: told });
+    const c = sessionCache.get(token);
+    if (c)
+      c.pushAddress = told;
+    return told;
+  };
   const resolve = async (ctx) => {
     if (!tables)
       return;
@@ -208188,16 +208336,18 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     if (token) {
       const c = sessionCache.get(token);
       if (c && now() - c.at < CACHE_TTL_MS) {
-        ctx.auth = { sessionId: c.sessionId, userId: c.userId };
+        const pushAddress = await followPushAddress(token, c.sessionId, c.pushAddress, pushAddressOf(ctx));
+        ctx.auth = { sessionId: c.sessionId, userId: c.userId, pushAddress };
         return;
       }
-      const row = await sessions.where({ tokenHash: await sha2562(token) }).select({ id: true, revoked: true, lastSeenAt: true, user: { id: true } }).first();
+      const row = await sessions.where({ tokenHash: await sha2562(token) }).select({ id: true, revoked: true, lastSeenAt: true, pushAddress: true, user: { id: true } }).first();
       if (row && !row.revoked) {
         const userId = row.user ? row.user.id : null;
         if (now() - (row.lastSeenAt ?? 0) > SEEN_UPDATE_MS)
           sessions.update(row.id, { lastSeenAt: now() }).then(undefined, () => {});
-        sessionCache.set(token, { sessionId: row.id, userId, at: now() });
-        ctx.auth = { sessionId: row.id, userId };
+        sessionCache.set(token, { sessionId: row.id, userId, pushAddress: row.pushAddress ?? null, at: now() });
+        const pushAddress = await followPushAddress(token, row.id, row.pushAddress ?? null, pushAddressOf(ctx));
+        ctx.auth = { sessionId: row.id, userId, pushAddress };
         return;
       }
     }
@@ -208210,7 +208360,7 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     const ident = await findIdentity("email", email);
     if (ident) {
       if (ident.user.id !== userId)
-        throw new ApiError(409, "This email belongs to another account");
+        throw new ApiError2(409, "This email belongs to another account");
       if (!ident.verifiedAt)
         await identities.update(ident.id, { verifiedAt: now(), hash: null });
     } else if (create) {
@@ -208223,7 +208373,7 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     const { provider, subject } = parseLogin(rawLogin);
     const password = checkPassword(rawPassword);
     if (await findIdentity(provider, subject))
-      throw new ApiError(409, provider === "email" ? "An account with this email already exists" : "This login is taken");
+      throw new ApiError2(409, provider === "email" ? "An account with this email already exists" : "This login is taken");
     const userId = await createUser(data);
     await createIdentity(userId, provider, subject, { hash: await hashPassword(password) });
     await bind(ctx, userId, { rotate: true });
@@ -208238,13 +208388,13 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     const byLogin = window2(passwordFails, `l:${who ? identityKey(who.provider, who.subject) : ""}`, t, 10 * 60000);
     const byIp = ctx.ip ? window2(passwordFails, `ip:${ctx.ip}`, t, 10 * 60000) : [];
     if (byLogin.length >= PASSWORD_FAILS_PER_LOGIN || byIp.length >= PASSWORD_FAILS_PER_IP)
-      throw new ApiError(429, "Too many attempts — try again later");
+      throw new ApiError2(429, "Too many attempts — try again later");
     const ident = who ? await findIdentity(who.provider, who.subject) : null;
     const ok = !!ident?.hash && typeof rawPassword === "string" && await verifyPassword(rawPassword, ident.hash);
     if (!ok) {
       byLogin.push(t);
       byIp.push(t);
-      throw new ApiError(401, "Invalid login or password");
+      throw new ApiError2(401, "Invalid login or password");
     }
     await bind(ctx, ident.user.id, { rotate: true });
   };
@@ -208255,7 +208405,7 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     const mine = await identities.where({ user: { id: userId } }).select({ id: true, provider: true });
     const typed = mine.filter((i) => i.provider === "email" || i.provider === "login");
     if (!typed.length)
-      throw new ApiError(400, "Your account has no email or login to sign in with a password — sign in with a code first");
+      throw new ApiError2(400, "Your account has no email or login to sign in with a password — sign in with a code first");
     const hash = await hashPassword(password);
     for (const i of typed)
       await identities.update(i.id, { hash });
@@ -208272,9 +208422,9 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     const t = now();
     const recent = window2(sends, email, t, 10 * 60000);
     if (recent.length && t - recent[recent.length - 1] < SEND_MIN_GAP_MS)
-      throw new ApiError(429, `Try again in ${Math.ceil((SEND_MIN_GAP_MS - (t - recent[recent.length - 1])) / 1000)} s`);
+      throw new ApiError2(429, `Try again in ${Math.ceil((SEND_MIN_GAP_MS - (t - recent[recent.length - 1])) / 1000)} s`);
     if (recent.length >= SEND_MAX_PER_10MIN)
-      throw new ApiError(429, "Too many codes requested — try again later");
+      throw new ApiError2(429, "Too many codes requested — try again later");
     const code = randomCode();
     await sessions.update(s.sessionId, { pendingEmail: email, codeHash: await codeHash(s.sessionId, code), codeExpires: t + CODE_TTL_MS, codeAttempts: 0 });
     recent.push(t);
@@ -208303,12 +208453,12 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     if (!isDevCode) {
       const row = await sessions.where({ id: s.sessionId }).select({ pendingEmail: true, codeHash: true, codeExpires: true, codeAttempts: true }).first();
       if (!row?.codeHash || row.pendingEmail !== email || !row.codeExpires || row.codeExpires < now())
-        throw new ApiError(400, "Code expired — request a new one");
+        throw new ApiError2(400, "Code expired — request a new one");
       if (row.codeAttempts >= CODE_MAX_ATTEMPTS)
-        throw new ApiError(429, "Too many attempts — request a new code");
+        throw new ApiError2(429, "Too many attempts — request a new code");
       if (typeof code !== "string" || await codeHash(s.sessionId, code.trim()) !== row.codeHash) {
         await sessions.update(s.sessionId, { codeAttempts: { $increment: 1 } });
-        throw new ApiError(400, "Invalid code");
+        throw new ApiError2(400, "Invalid code");
       }
     }
     const userId = await userOfProvenEmail(email);
@@ -208343,7 +208493,7 @@ var CODE_TTL_MS, CODE_MAX_ATTEMPTS = 5, SEND_MIN_GAP_MS = 30000, SEND_MAX_PER_10
     signIn: async (ctx, userId) => {
       requireAuth();
       if (!await users.where({ id: userId }).select({ id: true }).first())
-        throw new ApiError(404, "No such user");
+        throw new ApiError2(404, "No such user");
       await bind(ctx, userId, { rotate: true });
     },
     signOut: async (ctx) => {
@@ -208389,6 +208539,92 @@ var init_host = __esm(() => {
   enc = new TextEncoder;
   EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
   LOGIN_RE = /^[\p{L}\p{N}_.-]{3,32}$/u;
+  PUSH_ADDRESS_RE = /^[A-Za-z0-9_-]{1,128}$/;
+});
+
+// ../../sdk/src/server/push/host.ts
+var PUSH_BATCH = 500, chunks = (list, size) => {
+  const out = [];
+  for (let i = 0;i < list.length; i += size)
+    out.push(list.slice(i, i + size));
+  return out;
+}, createPushHost = (cfg) => {
+  const sessions = cfg.db?.$auth?.session ?? null;
+  const relay = cfg.relay ?? null;
+  const log = cfg.log ?? ((level, text) => level === "warn" ? console.warn(text) : console.info(text));
+  const warned = new Set;
+  const devices = async (userIds) => {
+    const rows = await sessions.where({ user: { id: { $in: userIds } }, revoked: false }).select({ id: true, pushAddress: true });
+    const byAddress = new Map;
+    for (const row of rows) {
+      if (!row.pushAddress)
+        continue;
+      const list = byAddress.get(row.pushAddress) ?? [];
+      list.push(row.id);
+      byAddress.set(row.pushAddress, list);
+    }
+    return byAddress;
+  };
+  const forget = async (byAddress, addresses) => {
+    const ids = addresses.flatMap((a) => byAddress.get(a) ?? []);
+    if (!ids.length)
+      return;
+    await sessions.where({ id: { $in: ids } }).updateMany({ pushAddress: null });
+  };
+  const send = async (channelId, userIds, message) => {
+    if (!sessions) {
+      throw new Error("pushChannel.send: the project's database has no sign-in — a user's devices are the sessions of defineDb({...}).withAuth({ model }), without it there is no one to send to");
+    }
+    if (!relay) {
+      if (!warned.has(channelId)) {
+        warned.add(channelId);
+        log("warn", `${channelId}: notifications are not sent from this backend (no road to the platform's sender) — a deployed backend sends them`);
+      }
+      return { sent: 0 };
+    }
+    const byAddress = await devices(userIds);
+    if (byAddress.size === 0)
+      return { sent: 0 };
+    const wire = {
+      channel: channelId,
+      title: message.title,
+      ...message.body !== undefined ? { body: message.body } : {},
+      ...message.url !== undefined ? { url: message.url } : {},
+      ...message.data !== undefined ? { data: message.data } : {},
+      ...message.badge !== undefined ? { badge: message.badge } : {}
+    };
+    let sent = 0;
+    for (let batch of chunks([...byAddress.keys()], PUSH_BATCH)) {
+      let result = await relay(batch, wire);
+      if (result.unknown?.length) {
+        const unknown = new Set(result.unknown);
+        await forget(byAddress, [...unknown]);
+        batch = batch.filter((a) => !unknown.has(a));
+        if (!batch.length)
+          continue;
+        result = await relay(batch, wire);
+        if (result.unknown?.length)
+          await forget(byAddress, result.unknown);
+      }
+      sent += result.sent;
+      const dead = result.failed.filter((f) => f.reason === "disabled").map((f) => f.address);
+      if (dead.length)
+        await forget(byAddress, dead);
+    }
+    return { sent };
+  };
+  return {
+    get enabled() {
+      return relay !== null;
+    },
+    install() {
+      setPushSender(send);
+    },
+    send
+  };
+};
+var init_host2 = __esm(() => {
+  init_pushChannel();
 });
 
 // ../../sdk/src/server/files/host.ts
@@ -208787,7 +209023,7 @@ var UploadError, UUID, JOURNAL = "lecodes-files", MB, TMP_MAX_AGE_MS, MAX_IMAGE_
     }
   };
 };
-var init_host2 = __esm(() => {
+var init_host3 = __esm(() => {
   init_context2();
   init_models2();
   UploadError = class UploadError extends Error {
@@ -208860,15 +209096,17 @@ var describeField = (f) => {
     models,
     endpoints: [...server2.endpoints.keys()].map((id) => ({ id, params: params[id] ?? null })),
     channels: [...server2.channels.keys()],
+    pushChannels: [...server2.pushChannels.keys()],
     auth: { model: db?.$auth?.model ?? null },
     appName: server2.manifest.app?.name
   };
 };
-var init_host3 = __esm(() => {
+var init_host4 = __esm(() => {
   init_runtime();
   init_defineDb();
   init_host();
   init_host2();
+  init_host3();
   init_models2();
   init_models();
 });
@@ -209891,7 +210129,7 @@ var require_main = __commonJS(function(exports, module) {
 });
 
 // src/dev/backendWorker.ts
-import { existsSync as existsSync54, mkdirSync as mkdirSync35, mkdtempSync as mkdtempSync8, renameSync as renameSync3, rmSync as rmSync18 } from "node:fs";
+import { existsSync as existsSync55, mkdirSync as mkdirSync35, mkdtempSync as mkdtempSync8, renameSync as renameSync3, rmSync as rmSync18 } from "node:fs";
 import { readFile as readFile3 } from "node:fs/promises";
 import { tmpdir as tmpdir8 } from "node:os";
 import { join as join58 } from "node:path";
@@ -209935,13 +210173,23 @@ var post = (m) => {
     rmSync18(aside, { recursive: true, force: true });
     renameSync3(dir, aside);
     rmSync18(`${filesDir}-old`, { recursive: true, force: true });
-    if (existsSync54(filesDir))
+    if (existsSync55(filesDir))
       renameSync3(filesDir, `${filesDir}-old`);
     mkdirSync35(dir, { recursive: true });
     db = openDatabase(dir);
     await db.$sync(schema);
     return [`database started over — the schema change couldn't be migrated (${reason}); the previous data is in ${aside}`];
   }
+}, pushRelay = (sender) => async (to, message) => {
+  try {
+    return await sendPush(sender.apiUrl, sender.token, sender.uuid, { to, ...message });
+  } catch (e) {
+    const body = e instanceof ApiError ? e.body : null;
+    if (body?.code === "unknown_addresses" && Array.isArray(body.addresses)) {
+      return { sent: 0, failed: [], unknown: body.addresses.filter((a) => typeof a === "string") };
+    }
+    throw new Error(`push: the platform refused the send: ${e.message}`);
+  }
 }, load = async (m) => {
   const noDb = () => {
     throw new Error("db: the database is not open yet — query it inside an endpoint, not while the module loads");
@@ -209960,6 +210208,11 @@ var post = (m) => {
     log: (level, text) => post({ t: "log", level, text })
   });
   authHost.install();
+  createPushHost({
+    db: server2.dbs.find((d) => d.$auth) ?? null,
+    relay: m.push ? pushRelay(m.push) : null,
+    log: (level, text) => post({ t: "log", level, text })
+  }).install();
   const auth = authHost.enabled ? authHost : null;
   const onError = (id, e) => post({ t: "log", level: "error", text: `${id}: ${e?.stack ?? e}` });
   const files = createFilesHost({
@@ -209982,8 +210235,9 @@ var post = (m) => {
   post({ t: "loaded", describe, notes });
 };
 var init_backendWorker = __esm(() => {
-  init_host3();
+  init_host4();
   init_peerInstall();
+  init_api();
   console.log = hook("log");
   console.info = hook("info");
   console.warn = hook("warn");
@@ -210028,7 +210282,7 @@ var init_backendWorker = __esm(() => {
 // src/index.ts
 init_package();
 init_cli();
-import { existsSync as existsSync55, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync56, realpathSync as realpathSync2 } from "node:fs";
 import { delimiter as delimiter3, dirname as dirname28, join as join59 } from "node:path";
 
 // src/commands/app/index.ts
@@ -210635,6 +210889,9 @@ var readManifest2 = (dir, id) => {
 };
 var readManifestIfAny = (dir, id) => existsSync14(join17(dir, MANIFEST_FILE)) ? readManifest2(dir, id) : null;
 
+// src/commands/app/shared.ts
+init_compile();
+
 // src/plugin/emitPackage.ts
 class PackageError extends Error {
 }
@@ -210731,7 +210988,12 @@ var urlSchemeOf = (config) => {
     throw new CliError(`app.json "urlScheme" is the app's OWN scheme ("myshop" → myshop://…), not ${scheme}.`);
   return scheme;
 };
-var readAppConfigAt = (root) => readJson2(join18(root, "app.json"));
+var readAppConfigAt = (root) => {
+  const config = readJson2(join18(root, "app.json"));
+  if (config && "plugins" in config)
+    config.plugins = pluginSpecsOf(config.plugins);
+  return config;
+};
 var DESKTOP_DEFAULT_WINDOW = { width: 1280, height: 720 };
 var resolveDesktopRenderer = (root, renderer) => {
   const raw = renderer ?? process.env.LECODES_DESKTOP_RENDERER ?? readAppConfigAt(root)?.desktop?.renderer;
@@ -210851,25 +211113,33 @@ var detectEngines = (bundleJs) => {
   }
   const header = lines.join(`
 `);
-  return { gl: !/^\/\/ gl: disable$/m.test(header), g2: /^\/\/ 2d: enable$/m.test(header) };
+  const on = (name) => new RegExp(`^// ${name}: enable$`, "m").test(header);
+  return { gl: !/^\/\/ gl: disable$/m.test(header), g2: on("2d"), physics: on("physics"), net: on("net"), nav: on("nav"), audio: on("audio") };
+};
+var VARIANT_LACKS = {
+  full: [],
+  "3d": ["g2", "physics", "net", "nav", "audio"],
+  "2d": ["gl", "physics", "net", "nav"],
+  core: ["gl", "g2", "physics", "net", "nav"]
 };
+var ENGINE_WORDS = { gl: "3D", g2: "2D", physics: "physics", net: "multiplayer", nav: "navigation", audio: "game audio" };
+var lacks = (variant, uses) => VARIANT_LACKS[variant].filter((e) => uses[e]).map((e) => ENGINE_WORDS[e]);
 var resolveVariant = (requested, bundleJs, configKey = "ios.variant") => {
   const uses = detectEngines(bundleJs);
-  const detected = uses.gl && uses.g2 ? "full" : uses.gl ? "3d" : uses.g2 ? "2d" : "core";
+  const detected = SDK_VARIANTS.find((v) => lacks(v, uses).length === 0) ?? "full";
+  const inUse = Object.keys(ENGINE_WORDS).filter((e) => uses[e]).map((e) => ENGINE_WORDS[e]);
+  const why = inUse.length > 0 ? `uses ${inUse.join(" + ")}` : "UI only, no engine use detected";
   if (requested === "auto")
-    return { variant: detected, detected };
+    return { variant: detected, detected, why };
   const variant = requested;
-  const missing = [
-    uses.gl && variant !== "3d" && variant !== "full" ? "3D" : null,
-    uses.g2 && variant !== "2d" && variant !== "full" ? "2D" : null
-  ].filter(Boolean);
+  const missing = lacks(variant, uses);
   if (missing.length > 0) {
-    warn(`project uses the ${missing.join(" + ")} engine but ${configKey} forces "${variant}" — those scenes won't run on device; remove ${configKey} to auto-select "${detected}".`);
+    warn(`project uses ${missing.join(" + ")} but ${configKey} forces "${variant}", which has no such engine — that part won't run on device; remove ${configKey} to auto-select "${detected}".`);
   }
-  return { variant, detected };
+  return { variant, detected, why };
 };
 var ANDROID_SDK_VARIANTS = [...SDK_VARIANTS, "vulkan"];
-var ANDROID_SDK_VULKAN_MIN = "2.1.0";
+var ANDROID_SDK_VULKAN_MIN = "2.2.11";
 var androidSdkArtifact = (variant, sdkVersion) => {
   if (variant === "vulkan" && sdkVersion && cmpVersion(sdkVersion, ANDROID_SDK_VULKAN_MIN) < 0) {
     throw new CliError(`android.variant "vulkan" needs lecodes-android-sdk >= ${ANDROID_SDK_VULKAN_MIN} (pinned: ${sdkVersion}) — run \`lecodes app update\` or set android.sdk.`);
@@ -212992,7 +213262,7 @@ engines the bundle uses and cannot see those, so a project using \`Physics\`,
 
 \`android.variant: "vulkan"\` links \`lecodes-sdk-vulkan\`: the full engine set with Filament on
 Vulkan (OpenGL ES where the device has no Vulkan 1.1), \`arm64-v8a\` only — for 3D games. Never
-auto-selected; needs lecodes-android-sdk >= 2.1.0.
+auto-selected; needs lecodes-android-sdk >= 2.2.11.
 
 ## App-local native code
 
@@ -213757,7 +214027,7 @@ var initAndroid = async (opts) => {
   if (existsSync19(androidDir)) {
     throw new CliError("android/ already exists — run `lecodes app sync` to update it.");
   }
-  const existing = readJson2(join21(root, "app.json")) ?? {};
+  const existing = readAppConfigAt(root) ?? {};
   const variant = opts.variant ?? existing.android?.variant ?? "auto";
   if (variant !== "auto" && !ANDROID_SDK_VARIANTS.includes(variant)) {
     throw new CliError(`--variant must be auto, ${ANDROID_SDK_VARIANTS.join(", ")} (got "${variant}")`);
@@ -213868,20 +214138,14 @@ var syncAndroid = async (root, config, prior) => {
   if (requestedVariant !== "auto" && !ANDROID_SDK_VARIANTS.includes(requestedVariant)) {
     throw new CliError(`app.json android.variant must be "auto" or one of ${ANDROID_SDK_VARIANTS.join(", ")} (got "${requestedVariant}").`);
   }
-  const { variant: covered, detected } = resolveVariant(requestedVariant === "auto" ? "auto" : androidVariantEngines(requestedVariant), bundleJs, "android.variant");
+  const { variant: covered, why } = resolveVariant(requestedVariant === "auto" ? "auto" : androidVariantEngines(requestedVariant), bundleJs, "android.variant");
   const variant = requestedVariant === "vulkan" ? "vulkan" : covered;
   let sdkArtifact = androidSdkArtifact(variant, sdkVersion);
   if (sdkArtifact !== "lecodes-sdk" && cmpVersion(sdkVersion, ANDROID_SDK_VARIANTS_MIN) < 0) {
     warn(`lecodes-android-sdk ${sdkVersion} predates the variant matrix (${ANDROID_SDK_VARIANTS_MIN}) — linking the full lecodes-sdk AAR; run \`lecodes app update\` to pick up variant builds.`);
     sdkArtifact = "lecodes-sdk";
   }
-  const WHY = {
-    full: "3D + 2D engines in use",
-    "3d": "3D in use, no 2D",
-    "2d": "2D in use, no 3D",
-    core: "no 3D/2D engine use detected"
-  };
-  log(`${c.green("variant")}   ${variant} → ${sdkArtifact}${requestedVariant === "auto" ? c.dim(`  (auto: ${WHY[detected]})`) : c.dim("  (forced by android.variant)")}`);
+  log(`${c.green("variant")}   ${variant} → ${sdkArtifact}${requestedVariant === "auto" ? c.dim(`  (auto: ${why})`) : c.dim("  (forced by android.variant)")}`);
   const lockPath = join21(root, "plugins.lock.json");
   const oldLock = readJson2(lockPath)?.plugins ?? {};
   const pluginSpecs = Object.entries(config.plugins ?? {});
@@ -214114,7 +214378,7 @@ var androidBuildFlags = {
 };
 var buildAndroid = async (flags) => {
   const root = projectRoot();
-  const config = readJson2(join21(root, "app.json"));
+  const config = readAppConfigAt(root);
   const androidDir = join21(root, "android");
   if (!config?.android || !existsSync19(androidDir)) {
     throw new CliError("No Android shell here — run `lecodes app init android` first.");
@@ -214318,7 +214582,7 @@ var writeSigningConfig = (root, config, storeFile, alias, storePassword, keyPass
     }
   }
   const configPath = join21(root, "app.json");
-  const fresh = readJson2(configPath) ?? config;
+  const fresh = readAppConfigAt(root) ?? config;
   fresh.android = { ...fresh.android ?? {}, signing: { storeFile: envPath, keyAlias: alias } };
   writeJson(configPath, fresh);
   log(`${c.green("written")}   app.json  (android.signing — metadata only, no passwords)`);
@@ -214334,7 +214598,7 @@ var printCertificate = (storeFile, alias, storePassword) => {
 var PLAY_APP_SIGNING_NOTE = "With Play App Signing (default for new Play apps) this is the UPLOAD key — Google keeps the app signing key, and a lost upload key can be reset through Play support. Without it, losing this file means the app can never be updated. Back it up either way.";
 var keystoreProject = () => {
   const root = projectRoot();
-  return { root, config: readJson2(join21(root, "app.json")) ?? {} };
+  return { root, config: readAppConfigAt(root) ?? {} };
 };
 var passwordFlag = { password: str("keystore password (else asked on the terminal)", { value: "<pw>" }) };
 var keystoreCreateFlags = {
@@ -215465,7 +215729,7 @@ var dirSize2 = (dir) => readdirSync8(dir, { withFileTypes: true }).reduce((sum,
 }, 0);
 var initDesktop = async (opts) => {
   const root = projectRoot();
-  const existing = readJson2(join24(root, "app.json")) ?? {};
+  const existing = readAppConfigAt(root) ?? {};
   const name = opts.name ?? existing.name ?? basename8(root);
   const window2 = {
     width: 1280,
@@ -215499,7 +215763,7 @@ var desktopBuildFlags = {
 };
 var buildDesktop = async (flags) => {
   const root = projectRoot();
-  const config = readJson2(join24(root, "app.json")) ?? {};
+  const config = readAppConfigAt(root) ?? {};
   const name = (config.name ?? basename8(root)).trim() || "app";
   const slug = flags.slug ?? cleanFileName(name);
   const out = resolve11(root, flags.out ?? join24(root, "dist", slug));
@@ -215776,7 +216040,7 @@ var initIos = async (opts) => {
   if (existsSync23(iosDir)) {
     throw new CliError("ios/ already exists — run `lecodes app sync` to update it.");
   }
-  const existing = readJson2(join25(root, "app.json")) ?? {};
+  const existing = readAppConfigAt(root) ?? {};
   const variant = opts.variant ?? existing.ios?.variant ?? "auto";
   if (variant !== "auto" && !SDK_VARIANTS.includes(variant)) {
     throw new CliError(`--variant must be auto, ${SDK_VARIANTS.join(", ")} (got "${variant}")`);
@@ -215865,7 +216129,7 @@ var init = defineCommand({
 });
 var runSync = async (platformArg) => {
   const root = projectRoot();
-  const config = readJson2(join25(root, "app.json"));
+  const config = readAppConfigAt(root);
   const platform = mobilePlatform(platformArg);
   const { hasIos, hasAndroid } = shellsOf(root, config);
   if (platform === "ios" && !hasIos)
@@ -215946,14 +216210,8 @@ var syncIos = async (root, config) => {
   mkdirSync15(resourcesDir, { recursive: true });
   const resources = await compileShell(join25(resourcesDir, "app.js"), { remotePatterns });
   const bundleJs = readFileSync20(join25(resourcesDir, "app.js"), "utf8");
-  const { variant, detected } = resolveVariant(requestedVariant, bundleJs);
-  const WHY = {
-    core: "UI only",
-    "2d": "uses the 2D engine",
-    "3d": "uses the 3D engine",
-    full: "uses the 3D + 2D engines"
-  };
-  log(`${c.green("variant")}   ${variant}${requestedVariant === "auto" ? ` (auto: ${WHY[detected]})` : " (forced by ios.variant)"}`);
+  const { variant, why } = resolveVariant(requestedVariant, bundleJs);
+  log(`${c.green("variant")}   ${variant}${requestedVariant === "auto" ? ` (auto: ${why})` : " (forced by ios.variant)"}`);
   const sdkWhy = sdkPin === "latest" ? "latest" : config.ios.sdk ? "pinned by ios.sdk" : "from the shell — set ios.sdk or run `lecodes app update`";
   log(`${c.green("sdk")}       lecodes-ios-sdk ${sdkVersion}${c.dim(`  (${sdkWhy})`)}`);
   const preload = /^\/\/ preload: (.*)$/m.exec(bundleJs)?.[1].split(";").map((s) => s.trim()).filter(Boolean) ?? [];
@@ -216076,7 +216334,7 @@ Native OTA JS updates at launch (both shells; the current launch runs the newest
 var pluginConfig = () => {
   const root = projectRoot();
   const configPath = join25(root, "app.json");
-  const config = readJson2(configPath);
+  const config = readAppConfigAt(root);
   if (!config)
     throw new CliError("No app.json here — run `lecodes app init <ios|android>` first.");
   config.plugins ??= {};
@@ -216181,7 +216439,7 @@ var updateSdkPin = async (root, config, wanted, checkOnly, platform) => {
 };
 var runAppUpdate = async (opts = {}) => {
   const root = projectRoot();
-  const config = readJson2(join25(root, "app.json"));
+  const config = readAppConfigAt(root);
   const platform = mobilePlatform(opts.platform);
   const { hasIos, hasAndroid } = shellsOf(root, config);
   if (platform === "ios" && !hasIos)
@@ -216339,7 +216597,7 @@ var doctor = defineCommand({
   examples: ["lecodes app doctor"],
   run: async () => {
     const root = projectRoot();
-    const config = readJson2(join25(root, "app.json"));
+    const config = readAppConfigAt(root);
     const { hasIos, hasAndroid } = shellsOf(root, config);
     if (!hasIos && !hasAndroid)
       throw new CliError(NO_IOS_SHELL);
@@ -216386,7 +216644,7 @@ var exportOptionsPlist = (method, teamId, destination) => `<?xml version="1.0" e
 `;
 var requireShell = () => {
   const root = projectRoot();
-  const config = readJson2(join25(root, "app.json"));
+  const config = readAppConfigAt(root);
   if (!config?.ios || !existsSync23(join25(root, "ios")))
     throw new CliError(NO_IOS_SHELL);
   return { root, config };
@@ -216499,7 +216757,7 @@ var iosUpload = defineCommand({
       "-allowProvisioningUpdates"
     ]);
     const configPath = join25(root, "app.json");
-    const fresh = readJson2(configPath);
+    const fresh = readAppConfigAt(root);
     fresh.ios.buildNumber = (fresh.ios.buildNumber ?? 1) + 1;
     writeJson(configPath, fresh);
     success(`Uploaded build ${(fresh.ios.buildNumber ?? 2) - 1} — check App Store Connect / TestFlight once processing finishes.`);
@@ -216745,7 +217003,7 @@ lecodes render --desktop --view iso --png iso.png   # 3D: inspection camera fitt
                                   # { "view": "iso", "screenshot": "iso.png" } then { "view": "off" }
 lecodes render --desktop --script <file>  # the same scenario on the NATIVE host (real GPU, the
                                   # real hit-test): the same steps, targets and expects as
-                                  # headless (only expect.audio / the json output are headless-only)
+                                  # headless (only expect.audio / expect.toast / the json output are headless-only)
 lecodes render --sim --script <file>      # the WINDOWLESS native host (lecodes-server): the real
                                   # engines, no GPU, no pixels, no UI hit-test — expect.log /
                                   # expect.paint only; runs on CI and beside an open desktop window
@@ -216791,11 +217049,12 @@ Three hosts run the same file, at a fixed 16 ms clock on all of them:
 |---|---|---|---|---|
 | headless | (none) | Bun: the runtime + UI renderer + a recording 3D core (no GPU) | names or \`{ x, y }\` | all |
 | sim | \`--sim\` | the windowless native server: real engines, no pixels, no UI | \`{ x, y }\`, straight to the scene | \`log\`, \`paint\` |
-| desktop | \`--desktop\` | the hidden desktop window: pixels, GL materials, the real hit-test | names or \`{ x, y }\` | all but \`audio\` |
+| desktop | \`--desktop\` | the hidden desktop window: pixels, GL materials, the real hit-test | names or \`{ x, y }\` | all but \`audio\` / \`toast\` |
 
 One flow file, the same verdict on headless and desktop: names resolve the same way (\`name\` →
 exact text → substring → placeholder), every step runs (\`hover\`, \`type\`, \`fill\`, \`scroll\`,
-\`clip\` included) and the semantic expects read the same tree. Only \`expect.audio\` and the
+\`clip\` included) and the semantic expects read the same tree. Only \`expect.audio\`,
+\`expect.toast\` (the last \`toast()\` message — a toast is not in the tree) and the
 \`json\` output are the headless renderer's. On the desktop \`type\` taps the input and types into
 it (appends); the sim has no UI, so it takes coordinates and \`expect.log\` / \`expect.paint\` only.
 
@@ -216948,10 +217207,11 @@ init_cli();
 import { basename as basename14 } from "node:path";
 
 // src/dev/projectBackend.ts
-init_host3();
+init_host4();
 init_projectCompile();
 init_peerInstall();
 init_manifest();
+init_shared();
 import { rmSync as rmSync9 } from "node:fs";
 import { join as join35, relative as relative5 } from "node:path";
 
@@ -217044,7 +217304,7 @@ var startLocalBackend = (options) => {
           log(`[server:error] the server process exited (${status ?? "killed"}) — it starts again with the next call`);
       }
     });
-    child.send({ t: "load", code: bundle, dbDir, filesDir, root: options.root });
+    child.send({ t: "load", code: bundle, dbDir, filesDir, root: options.root, push: options.push ?? null });
   });
   const stop = async (l) => {
     if (live === l)
@@ -217405,7 +217665,15 @@ var createProjectBackend = (options) => {
     subscribe: (_scope, ch, args, ctx) => backend ? backend.subscribe(ch, args, ctx) : Promise.resolve({ ok: false, status: 404, message: "The project has no server files" })
   });
   const sockets = new Set;
-  const start = () => startLocalBackend({ root, dbDir, log, onPublish: (ch, group, data) => hub.publish("", ch, group, data) });
+  const push = (() => {
+    try {
+      const { apiUrl, token } = session();
+      return { apiUrl, token, uuid: readManifest(root).uuid };
+    } catch {
+      return null;
+    }
+  })();
+  const start = () => startLocalBackend({ root, dbDir, log, push, onPublish: (ch, group, data) => hub.publish("", ch, group, data) });
   const envelope = (body) => new Response(JSON.stringify(body), { status: 200, headers: { "content-type": "application/json", "cache-control": "no-store", ...CORS } });
   return {
     compile: async (entries) => {
@@ -219979,8 +220247,8 @@ var lightmap_default = defineCommand({
 // src/commands/link.ts
 init_cli();
 init_api();
-import { existsSync as existsSync39 } from "node:fs";
-import { basename as basename21, join as join44, resolve as resolve21 } from "node:path";
+import { existsSync as existsSync40 } from "node:fs";
+import { basename as basename21, join as join44, resolve as resolve22 } from "node:path";
 init_ignore();
 init_localFiles();
 init_manifest();
@@ -219990,14 +220258,148 @@ init_types4();
 // src/commands/push.ts
 init_cli();
 init_api();
-import { readFileSync as readFileSync31 } from "node:fs";
+import { readFileSync as readFileSync32 } from "node:fs";
 import { basename as basename20 } from "node:path";
 init_localFiles();
 init_manifest();
+
+// src/commands/releases.ts
+init_cli();
+init_api();
+init_localFiles();
+import { existsSync as existsSync39, readFileSync as readFileSync31 } from "node:fs";
+import { resolve as resolve21 } from "node:path";
+init_shared();
+var compareVersions = (a, b) => {
+  const pa = a.split("."), pb = b.split(".");
+  for (let i = 0;i < Math.max(pa.length, pb.length); i++) {
+    const d = (parseInt(pa[i] ?? "0", 10) || 0) - (parseInt(pb[i] ?? "0", 10) || 0);
+    if (d)
+      return d;
+  }
+  return 0;
+};
+var formatSize = (bytes) => bytes < 1024 ? `${bytes} B` : bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+var qrUrl = (apiUrl, uuid) => `${apiUrl}/qr/${uuid}`;
+var reportRelease = (release, qr, verb = "Published") => {
+  const parts = [release.unchanged ? `Nothing changed — ${release.version} is current` : `${verb} ${release.version}`, release.url.replace(/\/+$/, "")];
+  if (!release.unchanged) {
+    if (typeof release.size === "number")
+      parts.push(formatSize(release.size));
+    if (release.sdk)
+      parts.push(`SDK ${release.sdk}`);
+  }
+  success(parts.join(" · "));
+  info(`  ${c.dim("QR")} ${qr}`);
+};
+var withSchemaConfirm = async (call, opts) => {
+  try {
+    return await call(false);
+  } catch (e) {
+    if (!(e instanceof SchemaChangeError))
+      throw e;
+    if (e.incompatible !== null) {
+      throw new CliError(`The production database cannot migrate to this schema in place${e.incompatible ? `: ${e.incompatible}` : ""}. Nothing changed.`, 409);
+    }
+    warn("The schema change deletes data in the production database:");
+    for (const op of e.destructive)
+      log(c.red(`    ${op}`));
+    if (!opts.allowDestructive) {
+      if (!process.stdin.isTTY)
+        throw new CliError(`Nothing changed. Run \`${opts.retry} --allow-destructive\` to apply it.`, 409);
+      if (!await confirm("Delete that data and go on?", false)) {
+        info(c.dim("Cancelled — nothing changed."));
+        return null;
+      }
+    }
+    return await call(true);
+  }
+};
+var allowDestructiveFlag = { "allow-destructive": bool("apply a schema change that deletes production data without asking") };
+var use = defineCommand({
+  name: "use",
+  usage: "<version>",
+  summary: "Make a release current again — a rollback, no compile",
+  description: "The release's bundle becomes what the project's address, the viewers and the store run, and its server is deployed to production again (the database migrates to that release's schema: a change that deletes data is shown and asked about, like a publish).",
+  flags: allowDestructiveFlag,
+  examples: ["lecodes releases use 1.2.3"],
+  run: async ({ args, flags }) => {
+    const version = args[0]?.replace(/^v/, "");
+    if (!version)
+      throw new UsageError("Which release? `lecodes releases` lists them.");
+    const { apiUrl, token, manifest } = linkedProject();
+    const releases = await listReleases(apiUrl, token, manifest.uuid);
+    const target = releases.find((r) => r.version === version);
+    if (!target)
+      throw new CliError(`${manifest.name} has no release ${version} — \`lecodes releases\` lists them.`);
+    const previous = releases.find((r) => r.current);
+    const res = await withSchemaConfirm((allowDestructive) => useRelease(apiUrl, token, manifest.uuid, version, { allowDestructive }), { allowDestructive: flags["allow-destructive"], retry: `lecodes releases use ${version}` });
+    if (!res)
+      return;
+    const back = previous !== undefined && compareVersions(res.version, previous.version) < 0;
+    reportRelease({ ...target, ...res }, qrUrl(apiUrl, manifest.uuid), back ? "Rolled back to" : "Published");
+  }
+});
+var upload2 = defineCommand({
+  name: "upload",
+  usage: "<app.js>",
+  summary: "Make a bundle compiled here the current release — no build on the platform",
+  description: "For a bundle the platform's build service cannot make any more: compiled with an older SDK's CLI (`compile --remote-assets`, so it names the project's uploaded resources), it becomes the current release with its own `// sdk:` — what the viewers of that SDK line run. Local changes are pushed first as the release's checkpoint. A project with server code cannot take one (its server is built with the client).",
+  flags: { message: str('checkpoint message when there are local changes (default "Release")', { alias: "m", value: "<text>" }) },
+  examples: ["lecodes releases upload app.js", 'lecodes releases upload build/app.js -m "Kungur for the 2.1 app"'],
+  run: async ({ args, flags }) => {
+    const file = args[0];
+    if (!file)
+      throw new UsageError("Which bundle? `lecodes releases upload <app.js>`.");
+    const path = resolve21(file);
+    if (!existsSync39(path))
+      throw new CliError(`No such file: ${file}`);
+    const code = readFileSync31(path, "utf8");
+    const sdk = /^\/\/ sdk: (\S+)/m.exec(code)?.[1];
+    if (!sdk)
+      throw new CliError(`${file} is not a LeCodes bundle: no \`// sdk:\` header line. \`lecodes compile --remote-assets -o app.js\` writes one.`);
+    const map = existsSync39(`${path}.map`) ? readFileSync31(`${path}.map`, "utf8") : null;
+    const { root, manifest, apiUrl, token } = linkedProject();
+    if (hasChanges(diffLocal(manifest, scanProject(root, manifest))))
+      await runPush({ message: flags.message || "Release" });
+    const release = await uploadReleaseBundle(apiUrl, token, manifest.uuid, { code, map });
+    reportRelease(release, qrUrl(apiUrl, manifest.uuid), "Uploaded");
+  }
+});
+var releases_default = defineCommand({
+  name: "releases",
+  summary: "List the project's releases (● = the current one); `releases use <version>` rolls back, `releases upload <app.js>` releases a bundle compiled here",
+  description: "Every `lecodes publish` (or the editor's Publish button) makes a release: an immutable build with its own version. The current one is what https://<handle>.le.codes, the viewers and the store run.",
+  commands: [use, upload2],
+  examples: ["lecodes releases", "lecodes releases use 1.2.3", "lecodes releases upload app.js"],
+  run: async () => {
+    const { apiUrl, token, manifest } = linkedProject();
+    const releases = await listReleases(apiUrl, token, manifest.uuid);
+    if (releases.length === 0) {
+      info(`${manifest.name} has no releases yet — \`lecodes publish\` makes the first.`);
+      return;
+    }
+    table([
+      ["", c.dim("VERSION"), c.dim("DATE"), c.dim("SIZE"), c.dim("SDK")],
+      ...releases.map((r) => [
+        r.current ? c.green("●") : "",
+        r.current ? c.bold(r.version) : r.version,
+        relativeTime(r.createdAt),
+        formatSize(r.size),
+        r.sdk
+      ])
+    ]);
+    if (!releases.some((r) => r.current))
+      info(c.dim("  Unpublished: no release is current."));
+  }
+});
+
+// src/commands/push.ts
 init_shared();
 var pushFlags = {
   message: str("checkpoint message (asked for when omitted)", { alias: "m", value: "<text>" }),
-  publish: bool("also deploy the project live (compile) with the push"),
+  publish: bool("also release the project with the push (= `lecodes publish`)"),
+  "force-publish": bool("--publish, and release even when nothing changed — a new SDK on the build service (= `lecodes publish --force`)"),
   force: bool("push even if the server moved on (shows + confirms which server files get overwritten)"),
   yes: bool("skip the --force overwrite confirmation", { alias: "y" })
 };
@@ -220005,18 +220407,21 @@ var push_default = defineCommand({
   name: "push",
   summary: "Push local changes as one new checkpoint",
   flags: pushFlags,
-  examples: ['lecodes push -m "Tweak the menu"', "lecodes push --publish"],
+  examples: ['lecodes push -m "Tweak the menu"', "lecodes push --publish", "lecodes push --force-publish"],
   run: ({ flags }) => runPush(flags)
 });
 var runPush = async (opts) => {
   const { root, manifest, apiUrl, token } = linkedProject();
-  const publish = !!opts.publish;
+  const forcePublish = !!opts["force-publish"];
+  const publish = !!opts.publish || forcePublish;
   const scan = scanProject(root, manifest);
   const diff = diffLocal(manifest, scan);
   if (!hasChanges(diff)) {
     if (publish) {
-      await publishProject(apiUrl, token, manifest.uuid);
-      success("No file changes — published the current project state.");
+      info(c.dim("Working tree clean — publishing the project as it is."));
+      const release = await withSchemaConfirm((allowDestructive) => publishProject(apiUrl, token, manifest.uuid, { allowDestructive, force: forcePublish }), { allowDestructive: false, retry: "lecodes publish" });
+      if (release)
+        reportRelease(release, qrUrl(apiUrl, manifest.uuid));
     } else
       info(c.dim("Working tree clean — nothing to push."));
     await flushComments();
@@ -220058,9 +220463,9 @@ var runPush = async (opts) => {
     if (source)
       entry.assetId = source.id;
     if (isTextKind(kind))
-      entry.text = readFileSync31(file.absPath, "utf8");
+      entry.text = readFileSync32(file.absPath, "utf8");
     else if (!source || source.sha !== file.sha) {
-      const blob = await uploadBlob(apiUrl, token, manifest.uuid, basename20(file.path), readFileSync31(file.absPath));
+      const blob = await uploadBlob(apiUrl, token, manifest.uuid, basename20(file.path), readFileSync32(file.absPath));
       entry.blobFileId = blob.id;
       uploaded++;
     }
@@ -220069,11 +220474,11 @@ var runPush = async (opts) => {
   const folders = scan.dirs.map((path) => ({ path }));
   if (uploaded > 0)
     info(c.dim(`Uploaded ${uploaded} binary file${uploaded === 1 ? "" : "s"}.`));
-  const res = await sync(apiUrl, token, manifest.uuid, { message, files, folders, publish });
+  const res = await sync(apiUrl, token, manifest.uuid, { message, files, folders, publish, ...forcePublish ? { force: true } : {} });
   if (!res.created) {
     info(c.dim("Server reported no changes."));
     if (publish)
-      reportPublish(res);
+      reportPublish(res, qrUrl(apiUrl, manifest.uuid));
     return;
   }
   const shaByPath = new Map(scan.files.map((f) => [f.path, f.sha]));
@@ -220089,7 +220494,7 @@ var runPush = async (opts) => {
   ].filter(Boolean).join(", ");
   success(`Pushed checkpoint${res.seq ? ` #${res.seq}` : ""}${counts ? ` (${counts})` : ""}: ${message}`);
   if (publish)
-    reportPublish(res);
+    reportPublish(res, qrUrl(apiUrl, manifest.uuid));
   await flushComments();
 };
 var flushComments = async () => {
@@ -220112,11 +220517,11 @@ var serverPathDrift = (project, manifest) => {
   const parts = [added.length ? describe("added", added) : "", removed.length ? describe("removed", removed) : ""].filter(Boolean);
   return parts.length ? parts.join("; ") : null;
 };
-var reportPublish = (res) => {
-  if (res.published)
-    success("Published — the project is now live.");
+var reportPublish = (res, qr) => {
+  if (res.published && res.release)
+    reportRelease(res.release, qr);
   else
-    warn(`Push landed, but publish failed: ${res.publishError ?? "unknown error"}`);
+    warn(`Push landed, but publish failed: ${res.publishError ?? "unknown error"} — \`lecodes publish\` tries again.`);
 };
 
 // src/commands/link.ts
@@ -220171,10 +220576,10 @@ var link_default = defineCommand({
   run: async ({ args, flags }) => {
     const { apiUrl, token } = session();
     const dirArg = args[0];
-    const root = dirArg ? resolve21(dirArg) : process.cwd();
-    if (!existsSync39(root))
+    const root = dirArg ? resolve22(dirArg) : process.cwd();
+    if (!existsSync40(root))
       throw new CliError(`No such directory: ${root}`);
-    if (existsSync39(join44(root, LECODES_DIR, "manifest.json")) && !flags.force) {
+    if (existsSync40(join44(root, LECODES_DIR, "manifest.json")) && !flags.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;
@@ -220260,9 +220665,9 @@ var login_default = defineCommand({
 });
 
 // src/commands/navmesh.ts
-import { existsSync as existsSync40, mkdirSync as mkdirSync25, mkdtempSync as mkdtempSync5, readdirSync as readdirSync17, readFileSync as readFileSync32, rmSync as rmSync12, statSync as statSync15, unlinkSync as unlinkSync2, writeFileSync as writeFileSync27 } from "node:fs";
+import { existsSync as existsSync41, mkdirSync as mkdirSync25, mkdtempSync as mkdtempSync5, readdirSync as readdirSync17, readFileSync as readFileSync33, rmSync as rmSync12, statSync as statSync15, unlinkSync as unlinkSync2, writeFileSync as writeFileSync27 } from "node:fs";
 import { tmpdir as tmpdir5 } from "node:os";
-import { basename as basename22, join as join45, relative as relative7, resolve as resolve22 } from "node:path";
+import { basename as basename22, join as join45, relative as relative7, resolve as resolve23 } from "node:path";
 init_cli();
 init_shared();
 
@@ -221059,7 +221464,7 @@ var range2 = (name, value, fallback, min, max) => {
 var guessName = (root) => {
   const dirs = [join45(root, "src"), root];
   for (const dir of dirs) {
-    if (!existsSync40(dir))
+    if (!existsSync41(dir))
       continue;
     let entries;
     try {
@@ -221071,7 +221476,7 @@ var guessName = (root) => {
       if (!f.endsWith(".scene.ts"))
         continue;
       try {
-        if (/\bnavmesh\s*:/.test(readFileSync32(join45(dir, f), "utf8")))
+        if (/\bnavmesh\s*:/.test(readFileSync33(join45(dir, f), "utf8")))
           return f.slice(0, -".scene.ts".length);
       } catch {}
     }
@@ -221137,9 +221542,9 @@ var bake2 = defineCommand({
   examples: ["lecodes navmesh bake", "lecodes navmesh bake --name yard --cell 0.2 --obj --logs"],
   run: async ({ flags }) => {
     const { root } = localProject();
-    const outDir = resolve22(root, flags.out);
+    const outDir = resolve23(root, flags.out);
     const entryFile = flags.entry;
-    if (!existsSync40(resolve22(root, entryFile))) {
+    if (!existsSync41(resolve23(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 = flags.name ?? guessName(root) ?? "scene";
@@ -221150,7 +221555,7 @@ var bake2 = defineCommand({
     const logs = flags.logs;
     mkdirSync25(outDir, { recursive: true });
     const navmeshPath = join45(outDir, `${name}.navmesh`);
-    if (!existsSync40(navmeshPath))
+    if (!existsSync41(navmeshPath))
       writeFileSync27(navmeshPath, placeholderLnav());
     const importPath = "./" + entryFile.replace(/\\/g, "/").replace(/\.tsx?$/, "");
     const entryPath = "/.navmesh-entry.ts";
@@ -221219,9 +221624,9 @@ import ${JSON.stringify(importPath)}
     if (!config)
       throw new CliError("The host reported a dump but no `[navmesh] config` line — SDK/host mismatch?");
     const geoPath = join45(outDir, `${name}.navgeo`);
-    if (!existsSync40(geoPath))
+    if (!existsSync41(geoPath))
       throw new CliError(`The host reported a dump but ${geoPath} is missing.`);
-    const geo = readNgeo(new Uint8Array(readFileSync32(geoPath)));
+    const geo = readNgeo(new Uint8Array(readFileSync33(geoPath)));
     const params = {
       agentRadius: range2("radius", flags.radius, config.agent.radius, 0.05, 10),
       agentHeight: range2("height", flags.height, config.agent.height, 0.1, 20),
@@ -221295,25 +221700,44 @@ init_cli();
 
 // src/plugin/generate.ts
 init_cli();
-import { existsSync as existsSync41, mkdirSync as mkdirSync26, readFileSync as readFileSync33, readdirSync as readdirSync18, statSync as statSync16, writeFileSync as writeFileSync28 } from "node:fs";
+import { existsSync as existsSync42, mkdirSync as mkdirSync26, readFileSync as readFileSync34, readdirSync as readdirSync18, statSync as statSync16, writeFileSync as writeFileSync28 } from "node:fs";
 import { createRequire as createRequire7 } from "node:module";
-import { basename as basename23, join as join46, relative as relative8, resolve as resolve23, sep as sep3 } from "node:path";
+import { basename as basename23, join as join46, relative as relative8, resolve as resolve24, sep as sep3 } from "node:path";
 
 // src/plugin/permissions.ts
 var PERMISSION_KINDS = ["camera", "microphone", "location", "speech"];
 var isPermissionKind = (s) => PERMISSION_KINDS.includes(s);
 var PERMISSION_NEEDS = {
-  camera: { infoPlist: ["NSCameraUsageDescription"], android: [["android.permission.CAMERA"]] },
-  microphone: { infoPlist: ["NSMicrophoneUsageDescription"], android: [["android.permission.RECORD_AUDIO"]] },
+  camera: { infoPlist: ["NSCameraUsageDescription"], android: [["android.permission.CAMERA"]], androidFeatures: ["android.hardware.camera"] },
+  microphone: {
+    infoPlist: ["NSMicrophoneUsageDescription"],
+    android: [["android.permission.RECORD_AUDIO"]],
+    androidFeatures: ["android.hardware.microphone"]
+  },
   location: {
     infoPlist: ["NSLocationWhenInUseUsageDescription"],
-    android: [["android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION"]]
+    android: [["android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION"]],
+    androidFeatures: ["android.hardware.location"]
   },
-  speech: { infoPlist: ["NSSpeechRecognitionUsageDescription"], android: [["android.permission.RECORD_AUDIO"]] }
+  speech: {
+    infoPlist: ["NSSpeechRecognitionUsageDescription"],
+    android: [["android.permission.RECORD_AUDIO"]],
+    androidFeatures: ["android.hardware.microphone"]
+  }
 };
 var usesPermissions = (xml) => [...xml.matchAll(/<uses-permission(?:-sdk-23)?\b[^>]*\bandroid:name\s*=\s*"([^"]+)"/g)].map((m) => m[1]);
-var missingDeclarations = (kinds, infoPlist, androidNames) => {
-  const out = { infoPlist: [], android: [] };
+var usesFeatures = (xml) => {
+  const out = [];
+  for (const m of xml.replace(/<!--[\s\S]*?-->/g, "").matchAll(/<uses-feature\b[^>]*>/g)) {
+    const attr = (re) => re.exec(m[0])?.[2];
+    const name = attr(/\bandroid:name\s*=\s*(["'])(.*?)\1/);
+    if (name)
+      out.push({ name, required: attr(/\bandroid:required\s*=\s*(["'])(.*?)\1/)?.trim() !== "false" });
+  }
+  return out;
+};
+var missingDeclarations = (kinds, infoPlist, androidNames, androidFeatures) => {
+  const out = { infoPlist: [], android: [], androidFeatures: [] };
   for (const kind of kinds) {
     const needs = PERMISSION_NEEDS[kind];
     if (infoPlist)
@@ -221326,8 +221750,14 @@ var missingDeclarations = (kinds, infoPlist, androidNames) => {
         if (!group.some((name) => androidNames.includes(name)))
           out.android.push(`${group.join(" or ")} (${kind})`);
       }
+    if (androidFeatures)
+      for (const feature of needs.androidFeatures) {
+        const declared = androidFeatures.filter((f) => f.name === feature);
+        if (declared.length === 0 || declared.some((f) => f.required))
+          out.androidFeatures.push(`${feature} (${kind})`);
+      }
   }
-  return { infoPlist: [...new Set(out.infoPlist)], android: [...new Set(out.android)] };
+  return { infoPlist: [...new Set(out.infoPlist)], android: [...new Set(out.android)], androidFeatures: [...new Set(out.androidFeatures)] };
 };
 
 // src/plugin/contract.ts
@@ -224135,13 +224565,13 @@ const wire = {
 var shown = (from, to) => relative8(from, to).split(sep3).join("/");
 var CONTRACT_FILE = "contract.d.ts";
 var findPlugins = (path) => {
-  const root = resolve23(path);
-  if (existsSync41(join46(root, CONTRACT_FILE)))
+  const root = resolve24(path);
+  if (existsSync42(join46(root, CONTRACT_FILE)))
     return [{ id: basename23(root), dir: root }];
   const holder = join46(root, "plugins");
-  if (!existsSync41(holder))
+  if (!existsSync42(holder))
     return [];
-  return readdirSync18(holder).sort().map((id) => ({ id, dir: join46(holder, id) })).filter((p) => statSync16(p.dir).isDirectory() && existsSync41(join46(p.dir, CONTRACT_FILE)));
+  return readdirSync18(holder).sort().map((id) => ({ id, dir: join46(holder, id) })).filter((p) => statSync16(p.dir).isDirectory() && existsSync42(join46(p.dir, CONTRACT_FILE)));
 };
 var loadTypescript = (dir) => {
   for (const from of [join46(dir, "package.json"), import.meta.url]) {
@@ -224156,25 +224586,25 @@ var loadTypescript = (dir) => {
 };
 var generatePlugin = (ts, plugin) => {
   const file = join46(plugin.dir, CONTRACT_FILE);
-  const contract = readContract(ts, file, readFileSync33(file, "utf8"));
+  const contract = readContract(ts, file, readFileSync34(file, "utf8"));
   const manifest = readManifestIfAny(plugin.dir, plugin.id);
   checkPermissions(plugin, contract, manifest);
-  const handWritten = existsSync41(join46(plugin.dir, "sdk", `${plugin.id}.ts`));
+  const handWritten = existsSync42(join46(plugin.dir, "sdk", `${plugin.id}.ts`));
   const single = contract.channels.length === 1;
   const files = contract.channels.map((channel) => ({
     file: join46(plugin.dir, "sdk", single ? `${plugin.id}.gen.ts` : `${plugin.id}.${channel.iface}.gen.ts`),
     text: emitSdk(contract, channel, { id: plugin.id, handWritten })
   }));
-  if (existsSync41(join46(plugin.dir, "ios"))) {
+  if (existsSync42(join46(plugin.dir, "ios"))) {
     const name = single ? contract.channels[0].iface : contract.channels[0].iface + "Plugin";
     files.push({ file: join46(plugin.dir, "ios", `${name}.gen.swift`), text: emitSwift(lower3(contract), { id: plugin.id }) });
   }
-  if (existsSync41(join46(plugin.dir, "android"))) {
+  if (existsSync42(join46(plugin.dir, "android"))) {
     const name = single ? contract.channels[0].iface : contract.channels[0].iface + "Plugin";
     const pkg = kotlinPackage(join46(plugin.dir, "android"));
     files.push({ file: join46(pkg.dir, `${name}.gen.kt`), text: emitKotlin(lower3(contract), { id: plugin.id, package: pkg.name }) });
   }
-  if (existsSync41(join46(plugin.dir, "web"))) {
+  if (existsSync42(join46(plugin.dir, "web"))) {
     files.push({ file: join46(plugin.dir, "web", `${plugin.id}.gen.ts`), text: emitWeb(lower3(contract), { id: plugin.id }) });
     const foreign = hostImports(join46(plugin.dir, "web"));
     if (foreign.length)
@@ -224196,13 +224626,15 @@ var checkPermissions = (plugin, contract, manifest) => {
   if (kinds.length === 0)
     return;
   const androidManifest = join46(plugin.dir, "android", "src", "main", "AndroidManifest.xml");
-  const androidNames = manifest.android ? existsSync41(androidManifest) ? usesPermissions(readFileSync33(androidManifest, "utf8")) : [] : null;
-  const missing = missingDeclarations(kinds, manifest.ios ? manifest.ios.infoPlist ?? {} : null, androidNames);
+  const androidXml = manifest.android ? existsSync42(androidManifest) ? readFileSync34(androidManifest, "utf8") : "" : null;
+  const missing = missingDeclarations(kinds, manifest.ios ? manifest.ios.infoPlist ?? {} : null, androidXml === null ? null : usesPermissions(androidXml), androidXml === null ? null : usesFeatures(androidXml));
   const problems = [];
   if (missing.infoPlist.length)
     problems.push(`ios.infoPlist: the contract's @permission needs ${missing.infoPlist.join(", ")} — the usage string the dialog shows`);
   if (missing.android.length)
     problems.push(`android/src/main/AndroidManifest.xml: the contract's @permission needs <uses-permission android:name="…"/> for ${missing.android.join(", ")}`);
+  if (missing.androidFeatures.length)
+    problems.push(`android/src/main/AndroidManifest.xml: the contract's @permission implies <uses-feature android:name="…" android:required="false"/> for ${missing.androidFeatures.join(", ")} — without it Play requires the hardware`);
   if (problems.length)
     throw new ManifestError(join46(plugin.dir, MANIFEST_FILE), problems);
 };
@@ -224218,7 +224650,7 @@ var hostImports = (web) => {
       }
       if (!/\.(ts|tsx|js|mjs)$/.test(entry))
         continue;
-      readFileSync33(path, "utf8").split(`
+      readFileSync34(path, "utf8").split(`
 `).forEach((line, i) => {
         const m = /(?:from\s+|import\s*\(\s*|import\s+)["'](lecodes-[^"']*)["']/.exec(line);
         if (m && !/^\s*\/\//.test(line))
@@ -224232,7 +224664,7 @@ var hostImports = (web) => {
 var kotlinPackage = (android) => {
   const root = join46(android, "src", "main", "java");
   let dir = root;
-  while (existsSync41(dir)) {
+  while (existsSync42(dir)) {
     const entries = readdirSync18(dir).filter((e) => !e.startsWith("."));
     const dirs = entries.filter((e) => statSync16(join46(dir, e)).isDirectory());
     if (dirs.length !== 1 || entries.length !== 1)
@@ -224246,10 +224678,10 @@ var kotlinPackage = (android) => {
 };
 var repoSdkPath = (root) => {
   const file = join46(root, "package.json");
-  if (!existsSync41(file))
+  if (!existsSync42(file))
     return DEFAULT_SDK_PATH;
   try {
-    const pkg = JSON.parse(readFileSync33(file, "utf8"));
+    const pkg = JSON.parse(readFileSync34(file, "utf8"));
     const path = pkg.lecodes?.iosSdkPath;
     if (path !== undefined && typeof path !== "string")
       throw new PackageError(`package.json lecodes.iosSdkPath: a path, as a string`);
@@ -224263,13 +224695,13 @@ var repoSdkPath = (root) => {
 var generate = (path, opts = {}) => {
   const plugins = findPlugins(path);
   if (plugins.length === 0)
-    throw new CliError(`No plugin under ${resolve23(path)}: a plugin is a directory with a ${CONTRACT_FILE} (one, or plugins/<id>/ of a repo).`);
+    throw new CliError(`No plugin under ${resolve24(path)}: a plugin is a directory with a ${CONTRACT_FILE} (one, or plugins/<id>/ of a repo).`);
   const ts = loadTypescript(plugins[0].dir);
-  const root = resolve23(path);
+  const root = resolve24(path);
   const report = { plugins: [], repo: { written: [], stale: [], fresh: [] }, failures: [] };
   const place = (f, entry) => {
     const name = shown(root, f.file) || basename23(f.file);
-    const current = existsSync41(f.file) ? readFileSync33(f.file, "utf8") : null;
+    const current = existsSync42(f.file) ? readFileSync34(f.file, "utf8") : null;
     if (current === f.text) {
       entry.fresh.push(name);
       return;
@@ -224306,7 +224738,7 @@ ${e.problems.map((p) => `  ${p}`).join(`
         throw e;
     }
   }
-  const isRepo = !existsSync41(join46(root, CONTRACT_FILE));
+  const isRepo = !existsSync42(join46(root, CONTRACT_FILE));
   if (isRepo && report.failures.length === 0 && manifests.some((m) => m.manifest.ios)) {
     try {
       place({ file: join46(root, PACKAGE_FILE), text: emitPackageSwift(manifests, repoSdkPath(root)) }, report.repo);
@@ -224582,12 +225014,37 @@ var pn_default = defineCommand({
   commands: [send, devices, keys]
 });
 
+// src/commands/publish.ts
+init_cli();
+init_api();
+init_localFiles();
+init_shared();
+var publish_default = defineCommand({
+  name: "publish",
+  summary: "Release the project: push local changes, build, make it the live version",
+  description: 'The editor\'s Publish button. Local changes are pushed first as a checkpoint ("Release", or -m). The platform builds the project, deploys its server to production and makes the build the current release at https://<handle>.le.codes — what the viewers and the store run. A project that builds to what is live already makes no release: "Nothing changed — <version> is current" (--force releases it all the same). A schema change that deletes production data is shown and asked about; without a terminal it needs --allow-destructive. `lecodes releases` lists the releases, `lecodes releases use <version>` rolls back.',
+  flags: {
+    message: str('checkpoint message when there are local changes (default "Release")', { alias: "m", value: "<text>" }),
+    force: bool("rebuild even when nothing changed — a new SDK on the build service"),
+    "allow-destructive": bool("apply a schema change that deletes production data without asking")
+  },
+  examples: ["lecodes publish", 'lecodes publish -m "Checkout v2"', "lecodes publish --force", "lecodes publish --allow-destructive"],
+  run: async ({ flags }) => {
+    const { root, manifest, apiUrl, token } = linkedProject();
+    if (hasChanges(diffLocal(manifest, scanProject(root, manifest))))
+      await runPush({ message: flags.message || "Release" });
+    const release = await withSchemaConfirm((allowDestructive) => publishProject(apiUrl, token, manifest.uuid, { allowDestructive, force: flags.force }), { allowDestructive: flags["allow-destructive"], retry: flags.force ? "lecodes publish --force" : "lecodes publish" });
+    if (release)
+      reportRelease(release, qrUrl(apiUrl, manifest.uuid));
+  }
+});
+
 // src/commands/pull.ts
 init_cli();
 init_api();
 init_localFiles();
 init_manifest();
-import { existsSync as existsSync42, mkdirSync as mkdirSync27, rmSync as rmSync13, writeFileSync as writeFileSync29 } from "node:fs";
+import { existsSync as existsSync43, mkdirSync as mkdirSync27, rmSync as rmSync13, writeFileSync as writeFileSync29 } from "node:fs";
 import { dirname as dirname21, join as join47 } from "node:path";
 init_paths();
 init_types4();
@@ -224618,7 +225075,7 @@ var pull_default = defineCommand({
       if (remotePaths.has(path))
         continue;
       const abs = join47(root, ...path.replace(/^\//, "").split("/"));
-      if (existsSync42(abs))
+      if (existsSync43(abs))
         rmSync13(abs);
     }
     const files = await materializeAssets(root, project, apiUrl, token, progress);
@@ -224679,8 +225136,8 @@ var pullPaths = async (root, manifest, project, paths, apiUrl, token) => {
 };
 
 // src/commands/render.ts
-import { mkdirSync as mkdirSync29, readFileSync as readFileSync35, writeFileSync as writeFileSync31 } from "node:fs";
-import { dirname as dirname22, resolve as resolve27 } from "node:path";
+import { mkdirSync as mkdirSync29, readFileSync as readFileSync36, writeFileSync as writeFileSync31 } from "node:fs";
+import { dirname as dirname22, resolve as resolve28 } from "node:path";
 
 // src/compile/headlessBundle.ts
 init_api();
@@ -224767,22 +225224,22 @@ var compileHeadlessBundle = async (opts = {}) => {
 init_designMeta();
 init_cli();
 init_paths();
-import { existsSync as existsSync43, readFileSync as readFileSync34, statSync as statSync17 } from "node:fs";
-import { isAbsolute, join as join48, relative as relative9, resolve as resolve24 } from "node:path";
+import { existsSync as existsSync44, readFileSync as readFileSync35, statSync as statSync17 } from "node:fs";
+import { isAbsolute, join as join48, relative as relative9, resolve as resolve25 } from "node:path";
 var SCREEN_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs"];
 var SCREEN_ENTRY_PATH = "/.screen-entry.ts";
 var DEFAULT_DESIGN_DIR = "design";
 var hasSeparator = (file) => file.includes("/") || file.includes("\\");
 var findScreenFile = (root, file, dirFlag) => {
-  const candidates = [resolve24(process.cwd(), file)];
+  const candidates = [resolve25(process.cwd(), file)];
   if (!hasSeparator(file)) {
     candidates.push(join48(root, (dirFlag ?? DEFAULT_DESIGN_DIR).replace(/[/\\]+$/, ""), "screens", file));
   }
   for (const base of candidates) {
-    if (existsSync43(base) && statSync17(base).isFile())
+    if (existsSync44(base) && statSync17(base).isFile())
       return base;
     for (const ext of SCREEN_EXTS)
-      if (existsSync43(base + ext))
+      if (existsSync44(base + ext))
         return base + ext;
   }
   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/.`));
@@ -224792,7 +225249,7 @@ var designDirOf = (root, key) => {
   if (!m)
     return null;
   const dir = join48(root, m[1]);
-  return existsSync43(join48(dir, "meta.json")) ? { dir, id: m[2] } : null;
+  return existsSync44(join48(dir, "meta.json")) ? { dir, id: m[2] } : null;
 };
 var resolveScreenTarget = (root, file, opts = {}) => {
   const abs = findScreenFile(root, file, opts.dir);
@@ -224801,7 +225258,7 @@ var resolveScreenTarget = (root, file, opts = {}) => {
     throw new CliError(`"${file}" is outside the project (${root}) — a screen renders as part of its project, so its ` + `imports and asset() files resolve from the same tree.`);
   }
   const key = toKey(rel);
-  if (!/^\s*export\s+default\b/m.test(readFileSync34(abs, "utf8"))) {
+  if (!/^\s*export\s+default\b/m.test(readFileSync35(abs, "utf8"))) {
     throw new CliError(`${key.slice(1)} has no default export. A screen file ends with ` + `\`export default UIScreen([...])\` — or \`export default (state) => UIScreen([...])\` for screen states.`);
   }
   const invoke = opts.state !== undefined ? `screen(${JSON.stringify(opts.state)})` : "screen()";
@@ -224837,9 +225294,9 @@ init_manifest();
 
 // src/hosts/flowPick.ts
 init_cli();
-import { existsSync as existsSync44, mkdirSync as mkdirSync28, mkdtempSync as mkdtempSync6, rmSync as rmSync14, writeFileSync as writeFileSync30 } from "node:fs";
+import { existsSync as existsSync45, mkdirSync as mkdirSync28, mkdtempSync as mkdtempSync6, rmSync as rmSync14, writeFileSync as writeFileSync30 } from "node:fs";
 import { tmpdir as tmpdir6 } from "node:os";
-import { join as join49, resolve as resolve25 } from "node:path";
+import { join as join49, resolve as resolve26 } from "node:path";
 import { deflateSync as deflateSync2 } from "node:zlib";
 var MAX_SIDE = 4096;
 var crcTable = (() => {
@@ -224908,8 +225365,8 @@ var write = (name, bytes) => {
 };
 var fileOf = (at, value, baseDir) => {
   if (typeof value === "string") {
-    const path = resolve25(baseDir, value);
-    if (!existsSync44(path))
+    const path = resolve26(baseDir, value);
+    if (!existsSync45(path))
       throw new CliError(`${at}: "pick": no file "${value}" (looked for ${path}).`);
     return path;
   }
@@ -224949,7 +225406,7 @@ var resolvePicks = (steps, baseDir) => {
 
 // src/hosts/desktopScript.ts
 init_cli();
-import { resolve as resolve26 } from "node:path";
+import { resolve as resolve27 } from "node:path";
 
 // ../../runtime/headless/src/headless/paintDump.ts
 var FLAG_INTERACTIVE = 1;
@@ -225132,7 +225589,7 @@ var FRAME_MS = 16;
 var SETTLE_FRAMES = 640;
 var ACTIONS = ["tap", "type", "fill", "scroll", "wait", "frames", "drag", "hold", "hover", "key", "keyDown", "keyUp", "look", "mouseTo", "wheel", "stick", "gamepad", "camera", "view"];
 var SEMANTIC_EXPECT = ["text", "notText", "node", "notNode", "screen", "value"];
-var UNSUPPORTED_EXPECT = ["audio"];
+var UNSUPPORTED_EXPECT = ["audio", "toast"];
 var VIEW_NAMES = ["iso", "top", "front", "side", "back"];
 var isVec3 = (v) => Array.isArray(v) && v.length === 3 && v.every((n) => typeof n === "number");
 var pt = (p) => typeof p === "string" ? p : `(${p.x},${p.y})`;
@@ -225394,7 +225851,7 @@ var translateScenario = (rawSteps, opts) => {
         }
       }
       if (needDump) {
-        plan.paintDump = resolve26(opts.outDir, `.dump-${i}.json`);
+        plan.paintDump = resolve27(opts.outDir, `.dump-${i}.json`);
         plan.lines.push(emit(`frames 1`));
         plan.lines.push(emit(`dump ${plan.paintDump}`));
         budgetMs += 2 * FRAME_MS;
@@ -225409,7 +225866,7 @@ var translateScenario = (rawSteps, opts) => {
         throw new CliError(`${at}: "screenshot" must be a path.`);
       if (opts.sim)
         throw new CliError(`${at}: "screenshot" isn't available with --sim (the windowless host paints nothing) — judge the run by expect.log, or run it with --desktop for pixels.`);
-      plan.screenshot = resolve26(opts.outDir, s.screenshot);
+      plan.screenshot = resolve27(opts.outDir, s.screenshot);
       const clip = s.clip;
       if (clip !== undefined) {
         if (typeof clip === "string") {
@@ -225435,7 +225892,7 @@ var translateScenario = (rawSteps, opts) => {
     if (s.dump !== undefined) {
       if (typeof s.dump !== "string")
         throw new CliError(`${at}: "dump" must be a path.`);
-      plan.dump = resolve26(opts.outDir, s.dump);
+      plan.dump = resolve27(opts.outDir, s.dump);
       plan.lines.push(emit(`frames 1`));
       plan.lines.push(emit(`dump ${plan.dump}`));
       budgetMs += 2 * FRAME_MS;
@@ -225480,7 +225937,7 @@ var evaluateDesktopRun = (plan, output, readFile = () => null) => {
   let ok = true;
   for (const st of plan.steps) {
     const skipped = [
-      ...st.skippedExpect.map((k) => `expect.${k} (the headless audio recorder's — not on a native host)`),
+      ...st.skippedExpect.map((k) => `expect.${k} (the headless renderer's record — not on a native host)`),
       ...st.skippedOutputs.map((k) => `${k} output (the headless renderer's shape — use "dump" on a native host)`)
     ];
     let error;
@@ -225586,7 +226043,7 @@ var parseNativeViews = (raw) => {
 var requireRenderer = async () => loadPeer("lecodes-headless", "headless", { for: "lecodes render" });
 var fileScenarioIO = (dir) => ({
   write: (relPath, data) => {
-    const abs = resolve27(dir, relPath);
+    const abs = resolve28(dir, relPath);
     mkdirSync29(dirname22(abs), { recursive: true });
     writeFileSync31(abs, data);
   }
@@ -225596,9 +226053,9 @@ var resolveFixtures = (value, baseDir) => {
     return;
   let map = value;
   if (typeof value === "string") {
-    const abs = resolve27(baseDir, value);
+    const abs = resolve28(baseDir, value);
     try {
-      map = JSON.parse(readFileSync35(abs, "utf8"));
+      map = JSON.parse(readFileSync36(abs, "utf8"));
     } catch (e) {
       throw new CliError(`Can't read fixtures "${value}": ${e instanceof Error ? e.message : String(e)}`);
     }
@@ -225611,18 +226068,18 @@ var resolveFixtures = (value, baseDir) => {
 var readScenarioFile = (path) => {
   let raw;
   try {
-    raw = JSON.parse(readFileSync35(resolve27(path), "utf8"));
+    raw = JSON.parse(readFileSync36(resolve28(path), "utf8"));
   } catch (e) {
     throw new CliError(`Can't read scenario "${path}": ${e instanceof Error ? e.message : String(e)}`);
   }
   if (Array.isArray(raw))
-    return { steps: resolvePicks(raw, dirname22(resolve27(path))) };
+    return { steps: resolvePicks(raw, dirname22(resolve28(path))) };
   if (typeof raw !== "object" || raw === null)
     throw new CliError(`Scenario "${path}" must be a JSON object with "steps" (or a bare step array).`);
   const file = raw;
   if (file.steps === undefined)
     throw new CliError(`Scenario "${path}" has no "steps".`);
-  return { ...file, steps: resolvePicks(file.steps, dirname22(resolve27(path))) };
+  return { ...file, steps: resolvePicks(file.steps, dirname22(resolve28(path))) };
 };
 var parseClip = (raw) => {
   if (raw === undefined)
@@ -225747,7 +226204,7 @@ var renderDesktop = async (flags, file) => {
     entryOverride: screen?.entryPath
   });
   if (!sim)
-    mkdirSync29(dirname22(resolve27(pngFlag)), { recursive: true });
+    mkdirSync29(dirname22(resolve28(pngFlag)), { recursive: true });
   if (scenario) {
     const outDir = flags["out-dir"];
     const plan = translateScenario(scenario.steps, { outDir, headroomFrames: frames, sim });
@@ -225843,7 +226300,7 @@ var renderHeadless = async (flags, file) => {
   const width = flags.width || scenario?.width || screen?.frame?.[0] || projectViewport?.width || 390;
   const height = flags.height || scenario?.height || screen?.frame?.[1] || projectViewport?.height || 844;
   const onConsole = flags.logs ? (level, text) => logErr(`${c.dim(`[${level}]`)} ${text}`) : undefined;
-  const envelopeFixtures = resolveFixtures(scenario?.fixtures, flags.script !== undefined ? dirname22(resolve27(flags.script)) : ".");
+  const envelopeFixtures = resolveFixtures(scenario?.fixtures, flags.script !== undefined ? dirname22(resolve28(flags.script)) : ".");
   const flagFixtures = resolveFixtures(flags.fixtures, ".");
   const fixtures = envelopeFixtures || flagFixtures ? { ...envelopeFixtures, ...flagFixtures } : undefined;
   if (fixtures) {
@@ -225884,7 +226341,7 @@ var renderHeadless = async (flags, file) => {
   ${c.red(st.error ?? "failed")}`);
       }
       if (!result.ok && result.failureArtifacts.length > 0) {
-        logErr(c.dim(`  failing frame: ${result.failureArtifacts.map((p) => resolve27(outDir, p)).join(", ")}`));
+        logErr(c.dim(`  failing frame: ${result.failureArtifacts.map((p) => resolve28(outDir, p)).join(", ")}`));
       }
       logErr(result.ok ? c.green(`✓ ${result.steps.length}/${steps.length} steps passed`) : c.red(`✗ failed at step ${result.steps.length} of ${steps.length}`));
       return done((cb) => cb(), result.ok ? 0 : 1);
@@ -225905,10 +226362,10 @@ var renderHeadless = async (flags, file) => {
     for (const w of [...warnings, ...mapWarnings])
       warnErr(w);
     const pngPath = mapFlag.endsWith(".png") ? mapFlag : mapFlag + ".png";
-    mkdirSync29(dirname22(resolve27(pngPath)), { recursive: true });
-    writeFileSync31(resolve27(pngPath), png);
+    mkdirSync29(dirname22(resolve28(pngPath)), { recursive: true });
+    writeFileSync31(resolve28(pngPath), png);
     const jsonPath = pngPath.slice(0, -4) + ".json";
-    writeFileSync31(resolve27(jsonPath), JSON.stringify(data, null, 2));
+    writeFileSync31(resolve28(jsonPath), JSON.stringify(data, null, 2));
     note(`Wrote ${pngPath} + ${jsonPath}`);
     return done((cb) => cb());
   }
@@ -225928,8 +226385,8 @@ var renderHeadless = async (flags, file) => {
     if (isNullSink(pngFlag)) {
       note(`Discarded PNG (${pngFlag})`);
     } else {
-      mkdirSync29(dirname22(resolve27(pngFlag)), { recursive: true });
-      writeFileSync31(resolve27(pngFlag), png);
+      mkdirSync29(dirname22(resolve28(pngFlag)), { recursive: true });
+      writeFileSync31(resolve28(pngFlag), png);
       note(`Wrote ${pngFlag} (${png.length} bytes, ${outW}x${outH}${clip !== undefined ? ", clipped" : ""})`);
     }
     return done((cb) => cb());
@@ -225944,7 +226401,7 @@ var renderHeadless = async (flags, file) => {
     return done((cb) => cb());
   }
   if (out) {
-    writeFileSync31(resolve27(out), result.text);
+    writeFileSync31(resolve28(out), result.text);
     note(`Wrote ${out} (${result.text.length} bytes)`);
     return done((cb) => cb());
   }
@@ -225956,8 +226413,8 @@ var renderHeadless = async (flags, file) => {
 
 // src/commands/scene.ts
 init_cli();
-import { existsSync as existsSync46, readFileSync as readFileSync37, readdirSync as readdirSync19, statSync as statSync18, writeFileSync as writeFileSync33 } from "node:fs";
-import { basename as basename24, dirname as dirname23, join as join51, relative as relative10, resolve as resolve28 } from "node:path";
+import { existsSync as existsSync47, readFileSync as readFileSync38, readdirSync as readdirSync19, statSync as statSync18, writeFileSync as writeFileSync33 } from "node:fs";
+import { basename as basename24, dirname as dirname23, join as join51, relative as relative10, resolve as resolve29 } from "node:path";
 
 // src/compile/sceneCompile.ts
 init_localFiles();
@@ -225965,7 +226422,7 @@ init_ignore();
 init_cli();
 init_projectCompile();
 import { createHash as createHash8 } from "node:crypto";
-import { existsSync as existsSync45, mkdirSync as mkdirSync30, readFileSync as readFileSync36, writeFileSync as writeFileSync32 } from "node:fs";
+import { existsSync as existsSync46, mkdirSync as mkdirSync30, readFileSync as readFileSync37, writeFileSync as writeFileSync32 } from "node:fs";
 import { join as join50 } from "node:path";
 var TEXT_EXT = /\.(ts|js|json|svg|txt|md)$/i;
 var rel = (key) => key.replace(/^\//, "");
@@ -225977,9 +226434,9 @@ var compileSceneEditor = async (opts) => {
   for (const file of scan.files) {
     const path = "./" + rel(file.path);
     if (TEXT_EXT.test(path)) {
-      entries.push({ path, type: "text", text: readFileSync36(file.absPath, "utf8") });
+      entries.push({ path, type: "text", text: readFileSync37(file.absPath, "utf8") });
     } else if (/\.mat$/i.test(path)) {
-      entries.push({ path, type: "shader", text: readFileSync36(file.absPath, "utf8"), absPath: file.absPath });
+      entries.push({ path, type: "shader", text: readFileSync37(file.absPath, "utf8"), absPath: file.absPath });
     } else {
       entries.push({ path, type: "resource", fileSrc: "/project/" + rel(file.path) });
     }
@@ -225997,7 +226454,7 @@ var compileSceneEditor = async (opts) => {
       const dir = shadersCacheDir(root);
       mkdirSync30(dir, { recursive: true });
       const liteName = `${hash}_webgl-lite.filamat`;
-      if (!existsSync45(join50(dir, liteName)))
+      if (!existsSync46(join50(dir, liteName)))
         writeFileSync32(join50(dir, liteName), JSON.stringify(buildLiteMaterialArtifact(e.text ?? "")));
       const src = `/project/.lecodes/shaders/${hash}_opengl.filamat`;
       e.shaders = ["opengl", "webgl-lite"].map((platform) => ({ platform, src }));
@@ -226035,7 +226492,7 @@ var DEFAULT_PORT3 = 4488;
 var findAppRoot = (start) => {
   let dir = start;
   while (true) {
-    if (existsSync46(join51(dir, "app.json")))
+    if (existsSync47(join51(dir, "app.json")))
       return dir;
     const parent = dirname23(dir);
     if (parent === dir)
@@ -226060,10 +226517,10 @@ var getContext2 = (pathArg) => {
     root = process.cwd();
     manifest = null;
     if (pathArg) {
-      const abs = resolve28(process.cwd(), pathArg);
-      if (existsSync46(abs) && statSync18(abs).isDirectory())
+      const abs = resolve29(process.cwd(), pathArg);
+      if (existsSync47(abs) && statSync18(abs).isDirectory())
         root = abs;
-      else if (abs.endsWith(".scene.ts") && existsSync46(abs))
+      else if (abs.endsWith(".scene.ts") && existsSync47(abs))
         root = findAppRoot(dirname23(abs)) ?? dirname23(abs);
       else
         throw new CliError(`No such folder or .scene.ts: ${pathArg}`);
@@ -226073,9 +226530,9 @@ var getContext2 = (pathArg) => {
   }
   let scene = null;
   if (pathArg?.endsWith(".scene.ts")) {
-    const abs = resolve28(process.cwd(), pathArg);
+    const abs = resolve29(process.cwd(), pathArg);
     const rel = relative10(root, abs).replace(/\\/g, "/");
-    if (existsSync46(abs) && !rel.startsWith(".."))
+    if (existsSync47(abs) && !rel.startsWith(".."))
       scene = "./" + rel;
   }
   return { root, manifest, name: manifest?.name ?? basename24(root), scene };
@@ -226084,9 +226541,9 @@ var writeMcpConfig2 = (root, port) => {
   const path = join51(root, ".mcp.json");
   const entry = { type: "http", url: `http://localhost:${port}/mcp` };
   let config = {};
-  if (existsSync46(path)) {
+  if (existsSync47(path)) {
     try {
-      config = JSON.parse(readFileSync37(path, "utf8"));
+      config = JSON.parse(readFileSync38(path, "utf8"));
     } catch {
       warnErr(".mcp.json exists but isn't valid JSON — left it untouched. Add the lecodes-scene server by hand.");
       return;
@@ -226201,7 +226658,7 @@ var serve_default = defineCommand({
 });
 
 // src/commands/shaders/index.ts
-import { readFileSync as readFileSync39 } from "node:fs";
+import { readFileSync as readFileSync40 } from "node:fs";
 import { relative as relative12 } from "node:path";
 init_cli();
 init_shared();
@@ -226210,15 +226667,15 @@ init_shared();
 init_compile();
 init_distRoot();
 init_cli();
-import { existsSync as existsSync47, mkdirSync as mkdirSync31, readdirSync as readdirSync20, readFileSync as readFileSync38, writeFileSync as writeFileSync34 } from "node:fs";
-import { basename as basename26, join as join52, relative as relative11, resolve as resolve29 } from "node:path";
+import { existsSync as existsSync48, mkdirSync as mkdirSync31, readdirSync as readdirSync20, readFileSync as readFileSync39, writeFileSync as writeFileSync34 } from "node:fs";
+import { basename as basename26, join as join52, relative as relative11, resolve as resolve30 } from "node:path";
 var engineMaterialsDir = () => {
   const candidates = [
     join52(distRoot, "runtime", "materials"),
     join52(distRoot, "..", "..", "engines", "gl", "materials", "src")
   ];
   for (const c of candidates)
-    if (existsSync47(join52(c, "unlit.mat")))
+    if (existsSync48(join52(c, "unlit.mat")))
       return c;
   return null;
 };
@@ -226300,11 +226757,11 @@ var writeNewShader = (o) => {
   const name = o.name.endsWith(".mat") ? o.name.slice(0, -4) : o.name;
   if (!NAME_RE.test(name))
     throw new CliError(`"${o.name}" is not a shader name — letters, digits, - and _ (starting with a letter), e.g. hologram or rim-light`);
-  const dir = resolve29(o.cwd ?? process.cwd(), o.dir ?? ".");
+  const dir = resolve30(o.cwd ?? process.cwd(), o.dir ?? ".");
   const matPath = join52(dir, `${name}.mat`), assetPath = join52(dir, `${name}.material.ts`);
   if (!o.force) {
     for (const p of [matPath, assetPath])
-      if (existsSync47(p))
+      if (existsSync48(p))
         throw new CliError(`${relative11(o.cwd ?? process.cwd(), p) || basename26(p)} exists — pick another name or pass --force to overwrite`);
   }
   let mat;
@@ -226317,7 +226774,7 @@ var writeNewShader = (o) => {
     const known = engineMaterialNames();
     if (!known.includes(ref))
       throw new CliError(`no engine material "${ref}". Known: ${known.join(", ")}`);
-    mat = refMat(name, ref, readFileSync38(join52(srcDir, `${ref}.mat`), "utf8"));
+    mat = refMat(name, ref, readFileSync39(join52(srcDir, `${ref}.mat`), "utf8"));
   } else
     mat = starterMat(name);
   mkdirSync31(dir, { recursive: true });
@@ -226349,7 +226806,7 @@ var status2 = async () => {
       if (matcId === null)
         state = c.dim("unknown (matc not downloaded)");
       else {
-        const text = readFileSync39(shader.absPath, "utf8");
+        const text = readFileSync40(shader.absPath, "utf8");
         if (shaderIsCompiled(root, text, matcId))
           state = "compiled";
         else {
@@ -226358,7 +226815,7 @@ var status2 = async () => {
         }
       }
       log(`  ${shader.path.padEnd(width)}  ${state}`);
-      const schema = parseShaderSchema(readFileSync39(shader.absPath, "utf8"));
+      const schema = parseShaderSchema(readFileSync40(shader.absPath, "utf8"));
       for (const p of schema.params) {
         const range = p.min !== undefined ? ` [${p.min}..${p.max}]` : "";
         const def = p.default !== null && p.default !== undefined ? ` = ${JSON.stringify(p.default)}` : "";
@@ -226399,7 +226856,7 @@ var compileShaders = async (platforms) => {
   }
   const matcExe = await resolveMatcExe();
   const matcId = matcIdentity(matcExe);
-  const wasCompiled = new Map(shaders.map((s) => [s.path, shaderIsCompiled(root, readFileSync39(s.absPath, "utf8"), matcId)]));
+  const wasCompiled = new Map(shaders.map((s) => [s.path, shaderIsCompiled(root, readFileSync40(s.absPath, "utf8"), matcId)]));
   const errors = [];
   for (const shader of shaders) {
     try {
@@ -226501,14 +226958,14 @@ var status_default = defineCommand({
 });
 
 // src/commands/test.ts
-import { existsSync as existsSync49, mkdirSync as mkdirSync33, readFileSync as readFileSync40, readdirSync as readdirSync21 } from "node:fs";
-import { dirname as dirname25, resolve as resolve30 } from "node:path";
+import { existsSync as existsSync50, mkdirSync as mkdirSync33, readFileSync as readFileSync41, readdirSync as readdirSync21 } from "node:fs";
+import { dirname as dirname25, resolve as resolve31 } from "node:path";
 init_manifest();
 
 // src/hosts/liteRunner.ts
 init_cli();
 import { spawn as spawn7 } from "node:child_process";
-import { existsSync as existsSync48, mkdirSync as mkdirSync32, rmSync as rmSync15, writeFileSync as writeFileSync35 } from "node:fs";
+import { existsSync as existsSync49, mkdirSync as mkdirSync32, rmSync as rmSync15, writeFileSync as writeFileSync35 } from "node:fs";
 import { createServer as createServer3 } from "node:net";
 import { dirname as dirname24, join as join53 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
@@ -226521,7 +226978,7 @@ var NO_NODE = "--lite needs Node on the PATH: the browser is driven from a Node
 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 = join53(distRoot, "src", "hosts", "liteBrowser.mjs");
-  if (!existsSync48(script))
+  if (!existsSync49(script))
     throw new CliError("--lite is not available in this build of the CLI (its browser driver ships with the npm package).");
   const child = spawn7("node", [script], { stdio: ["pipe", "pipe", "inherit"] });
   const waiting = new Map;
@@ -227018,7 +227475,7 @@ var slug = (s) => s.replace(/[^a-zA-Z0-9-_]+/g, "-").replace(/^-+|-+$/g, "").sli
 var readFlowFile = (abs, displayName) => {
   let raw;
   try {
-    raw = JSON.parse(readFileSync40(abs, "utf8"));
+    raw = JSON.parse(readFileSync41(abs, "utf8"));
   } catch (e) {
     throw new CliError(`Can't read "${displayName}": ${e instanceof Error ? e.message : String(e)}`);
   }
@@ -227112,39 +227569,39 @@ var runTests = async (args, flags) => {
   if (nativeFixedDt < 0 || nativeFixedDt > 1000)
     throw new CliError(`--fixed-dt wants a number of ms (0 = wall clock, max 1000), got "${nativeFixedDt}".`);
   const projectViewport = desktopDefaultViewport(root);
-  const testsDir = resolve30(root, flags.dir);
-  const designMetaPath = resolve30(root, flags["design-dir"], "meta.json");
+  const testsDir = resolve31(root, flags.dir);
+  const designMetaPath = resolve31(root, flags["design-dir"], "meta.json");
   const asJson = flags.json;
   const out = asJson ? logErr : log;
   const cases = [];
   if (args.length > 0) {
     for (const given of args) {
-      const candidates = [resolve30(given), resolve30(testsDir, given), resolve30(testsDir, `${given}.flow.json`)];
-      const abs = candidates.find((p) => existsSync49(p));
+      const candidates = [resolve31(given), resolve31(testsDir, given), resolve31(testsDir, `${given}.flow.json`)];
+      const abs = candidates.find((p) => existsSync50(p));
       if (!abs)
         throw new CliError(`No such test: "${given}" (looked in ${testsDir}).`);
       cases.push(readFlowFile(abs, given));
     }
-  } else if (existsSync49(testsDir)) {
+  } else if (existsSync50(testsDir)) {
     for (const f of readdirSync21(testsDir).filter((f) => f.endsWith(".flow.json")).sort()) {
-      cases.push(readFlowFile(resolve30(testsDir, f), f));
+      cases.push(readFlowFile(resolve31(testsDir, f), f));
     }
   }
-  const defaultPack = resolve30(testsDir, "fixtures.json");
-  const flowFixtures = flags.fixtures !== undefined ? resolveFixtures(flags.fixtures, ".") : existsSync49(defaultPack) ? resolveFixtures("fixtures.json", testsDir) : undefined;
+  const defaultPack = resolve31(testsDir, "fixtures.json");
+  const flowFixtures = flags.fixtures !== undefined ? resolveFixtures(flags.fixtures, ".") : existsSync50(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 || lite) && wantFlows && existsSync49(designMetaPath)) {
+  if ((desktop || lite) && wantFlows && existsSync50(designMetaPath)) {
     note("Design-derived flows skipped with --desktop / --lite (they read expect.screen and fill inputs; run `lecodes test` headless for them).");
   }
-  if (!desktop && !lite && (wantFlows || flowsOnly) && existsSync49(designMetaPath)) {
+  if (!desktop && !lite && (wantFlows || flowsOnly) && existsSync50(designMetaPath)) {
     let meta;
     try {
-      meta = JSON.parse(readFileSync40(designMetaPath, "utf8"));
+      meta = JSON.parse(readFileSync41(designMetaPath, "utf8"));
     } catch (e) {
       throw new CliError(`Can't read ${designMetaPath}: ${e instanceof Error ? e.message : String(e)}`);
     }
@@ -227177,7 +227634,7 @@ var runTests = async (args, flags) => {
   }, timeoutMs);
   killer.unref?.();
   const onConsole = flags.logs ? (level, text) => logErr(`${c.dim(`[${level}]`)} ${text}`) : undefined;
-  const artifactsRoot = resolve30(root, flags.artifacts ?? resolve30(testsDir, ".artifacts"));
+  const artifactsRoot = resolve31(root, flags.artifacts ?? resolve31(testsDir, ".artifacts"));
   const results = [];
   const reportCase = (result) => {
     const skippedCount = result.steps.reduce((n, s) => n + (s.skipped?.length ?? 0), 0);
@@ -227197,13 +227654,13 @@ var runTests = async (args, flags) => {
     }
   };
   const runNativeCase = async (kase) => {
-    const caseDir = resolve30(artifactsRoot, slug(kase.name));
+    const caseDir = resolve31(artifactsRoot, slug(kase.name));
     const plan = translateScenario(kase.steps, { outDir: caseDir, headroomFrames: nativeFrames, sim });
     for (const st of plan.steps)
       if (st.screenshot)
         mkdirSync33(dirname25(st.screenshot), { recursive: true });
     mkdirSync33(caseDir, { recursive: true });
-    const finalPng = resolve30(caseDir, "final.png");
+    const finalPng = resolve31(caseDir, "final.png");
     const { output } = await runDesktopRender(native.js, native.resources, {
       renderer: desktopRenderer,
       host: sim ? "server" : "desktop",
@@ -227217,7 +227674,7 @@ var runTests = async (args, flags) => {
       script: plan.text,
       fixedDtMs: nativeFixedDt
     });
-    const r = evaluateDesktopRun(plan, output, (path) => existsSync49(path) ? readFileSync40(path, "utf8") : null);
+    const r = evaluateDesktopRun(plan, output, (path) => existsSync50(path) ? readFileSync41(path, "utf8") : null);
     if (!r.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 {
@@ -227248,7 +227705,7 @@ var runTests = async (args, flags) => {
     }
   }
   const runLiteCase = async (kase) => {
-    const caseDir = resolve30(artifactsRoot, slug(kase.name));
+    const caseDir = resolve31(artifactsRoot, slug(kase.name));
     const plan = translateScenario(kase.steps, { outDir: caseDir, headroomFrames: 0 });
     mkdirSync33(caseDir, { recursive: true });
     const output = await liteSession.run(plan, {
@@ -227256,7 +227713,7 @@ var runTests = async (args, flags) => {
       height: flags.height || kase.height || projectViewport?.height || 844,
       onConsole
     });
-    const r = evaluateDesktopRun(plan, output, (path) => existsSync49(path) ? readFileSync40(path, "utf8") : null);
+    const r = evaluateDesktopRun(plan, output, (path) => existsSync50(path) ? readFileSync41(path, "utf8") : null);
     return {
       name: kase.name,
       kind: kase.kind,
@@ -227307,14 +227764,14 @@ var runTests = async (args, flags) => {
         onConsole
       });
       try {
-        const io = fileScenarioIO(resolve30(artifactsRoot, slug(kase.name)));
+        const io = fileScenarioIO(resolve31(artifactsRoot, slug(kase.name)));
         const outcome = await renderer.runScenario(session, steps, io);
         result = {
           name: kase.name,
           kind: kase.kind,
           ok: outcome.ok,
           steps: outcome.steps.map((s) => ({ desc: s.desc, ok: s.ok, error: s.error })),
-          artifacts: outcome.failureArtifacts.map((p) => resolve30(artifactsRoot, slug(kase.name), p))
+          artifacts: outcome.failureArtifacts.map((p) => resolve31(artifactsRoot, slug(kase.name), p))
         };
       } finally {
         session.dispose();
@@ -227365,9 +227822,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 existsSync50, mkdtempSync as mkdtempSync7, readdirSync as readdirSync22, rmSync as rmSync16, statSync as statSync19 } from "node:fs";
+import { existsSync as existsSync51, mkdtempSync as mkdtempSync7, readdirSync as readdirSync22, rmSync as rmSync16, statSync as statSync19 } from "node:fs";
 import { tmpdir as tmpdir7 } from "node:os";
-import { extname, join as join54, relative as relative13, resolve as resolve31 } from "node:path";
+import { extname, join as join54, relative as relative13, resolve as resolve32 } from "node:path";
 init_cli();
 init_paths();
 var DEFAULT_SIZE = 256;
@@ -227385,7 +227842,7 @@ var findKtx = () => {
     "/opt/homebrew/bin/ktx"
   ].filter((p) => !!p);
   for (const path of candidates) {
-    if (existsSync50(path))
+    if (existsSync51(path))
       return path;
   }
   try {
@@ -227417,7 +227874,7 @@ var ktxToPng = (ktx, file, out) => {
     run(["extract", "--transcode", "rgba8", "--level", "0", file, out]);
   } catch (e) {
     run(["extract", "--level", "0", file, out]);
-    if (!existsSync50(out))
+    if (!existsSync51(out))
       throw e;
   }
 };
@@ -227452,8 +227909,8 @@ var thumbs = async (targets, size, force) => {
   const rendered = [];
   if (targets.length > 0) {
     for (const arg of targets) {
-      const abs = resolve31(process.cwd(), arg);
-      if (!existsSync50(abs))
+      const abs = resolve32(process.cwd(), arg);
+      if (!existsSync51(abs))
         throw new CliError(`No such file or folder: ${arg}`);
       if (statSync19(abs).isDirectory())
         files.push(...collect(abs));
@@ -227532,9 +227989,9 @@ init_peerInstall();
 init_archives();
 init_packageManager();
 import { spawnSync as spawnSync11 } from "node:child_process";
-import { existsSync as existsSync51, readdirSync as readdirSync23 } from "node:fs";
+import { existsSync as existsSync52, readdirSync as readdirSync23 } from "node:fs";
 import { homedir as homedir14 } from "node:os";
-import { dirname as dirname26, join as join55, resolve as resolve33 } from "node:path";
+import { dirname as dirname26, join as join55, resolve as resolve34 } from "node:path";
 
 // src/commands/update/types.ts
 init_api();
@@ -227542,10 +227999,10 @@ init_config();
 init_manifest();
 init_types4();
 init_cli();
-import { resolve as resolve32 } from "node:path";
+import { resolve as resolve33 } from "node:path";
 var label = (bundle) => `${Object.keys(bundle).length} file(s)`;
 var refreshTypes = async (opts) => {
-  const root = opts.dir ? resolve32(opts.dir) : (() => {
+  const root = opts.dir ? resolve33(opts.dir) : (() => {
     try {
       return findProjectRoot(process.cwd());
     } catch {
@@ -227603,10 +228060,10 @@ var refreshTypes = async (opts) => {
 
 // src/commands/update/index.ts
 var findProjectDir = (start) => {
-  const home = resolve33(homedir14());
-  let dir = resolve33(start);
+  const home = resolve34(homedir14());
+  let dir = resolve34(start);
   while (true) {
-    if (dir !== home && (existsSync51(join55(dir, "app.json")) || existsSync51(join55(dir, ".lecodes", "manifest.json")) || existsSync51(join55(dir, ".lecodes", "types"))))
+    if (dir !== home && (existsSync52(join55(dir, "app.json")) || existsSync52(join55(dir, ".lecodes", "manifest.json")) || existsSync52(join55(dir, ".lecodes", "types"))))
       return dir;
     const parent = dirname26(dir);
     if (parent === dir)
@@ -227643,7 +228100,7 @@ var semverNewer2 = (a, b) => {
   return 0;
 };
 var FROM_SOURCE = /[\\/]src[\\/]commands[\\/]/.test(import.meta.url);
-var STANDALONE = existsSync51(join55(dirname26(process.execPath), "runtime")) && existsSync51(join55(dirname26(process.execPath), process.platform === "win32" ? "chisel.exe" : "chisel"));
+var STANDALONE = existsSync52(join55(dirname26(process.execPath), "runtime")) && existsSync52(join55(dirname26(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",
@@ -227703,7 +228160,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) => existsSync51(join55(root, d)) && readdirSync23(join55(root, d)).length > 0);
+      const present = ["ios", "android"].filter((d) => existsSync52(join55(root, d)) && readdirSync23(join55(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");
@@ -227781,8 +228238,8 @@ init_cli();
 
 // src/web/build.ts
 import { createHash as createHash9 } from "node:crypto";
-import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync52, mkdirSync as mkdirSync34, readFileSync as readFileSync41, readdirSync as readdirSync24, rmSync as rmSync17, statSync as statSync20, writeFileSync as writeFileSync36 } from "node:fs";
-import { dirname as dirname27, extname as extname2, join as join56, resolve as resolve34 } from "node:path";
+import { copyFileSync as copyFileSync2, cpSync as cpSync6, existsSync as existsSync53, mkdirSync as mkdirSync34, readFileSync as readFileSync42, readdirSync as readdirSync24, rmSync as rmSync17, statSync as statSync20, writeFileSync as writeFileSync36 } from "node:fs";
+import { dirname as dirname27, extname as extname2, join as join56, resolve as resolve35 } from "node:path";
 init_fonts();
 init_assetIcons();
 init_projectCompile();
@@ -227806,8 +228263,8 @@ var walk = (dir, prefix = "") => {
 };
 var buildWeb = async (options) => {
   const { root, manifest, name, lite } = options;
-  const out = resolve34(root, options.out);
-  if (out === resolve34(root) || resolve34(root).startsWith(out + "\\") || resolve34(root).startsWith(out + "/")) {
+  const out = resolve35(root, options.out);
+  if (out === resolve35(root) || resolve35(root).startsWith(out + "\\") || resolve35(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 ?? {};
@@ -227817,7 +228274,7 @@ var buildWeb = async (options) => {
   const assetUrl = (path) => "assets" + encodeURI(path);
   const collected = collectLocalEntries(root, manifest, "assets");
   const entries = collected.entries.filter((e) => {
-    const abs = e.absPath ? resolve34(e.absPath) : null;
+    const abs = e.absPath ? resolve35(e.absPath) : null;
     return !(abs && (abs === out || abs.startsWith(out + "\\") || abs.startsWith(out + "/")));
   });
   for (const w of collected.warnings)
@@ -227859,8 +228316,8 @@ var buildWeb = async (options) => {
   mkdirSync34(out, { recursive: true });
   cpSync6(lite, out, { recursive: true });
   const table = join56(out, "features.json");
-  if (existsSync52(table)) {
-    const { features, fonts } = JSON.parse(readFileSync41(table, "utf8"));
+  if (existsSync53(table)) {
+    const { features, fonts } = JSON.parse(readFileSync42(table, "utf8"));
     if (config.font === "system")
       for (const file of fonts ?? [])
         rmSync17(join56(out, file), { force: true });
@@ -227873,9 +228330,9 @@ var buildWeb = async (options) => {
     rmSync17(table);
   }
   const pluginsTable = join56(out, "plugins.json");
-  if (existsSync52(pluginsTable)) {
+  if (existsSync53(pluginsTable)) {
     const listed = new Set((/^\/\/ plugins: (.+)$/m.exec(header)?.[1] ?? "").split(";").map((id) => id.trim()).filter(Boolean));
-    const { plugins } = JSON.parse(readFileSync41(pluginsTable, "utf8"));
+    const { plugins } = JSON.parse(readFileSync42(pluginsTable, "utf8"));
     const kept = {};
     for (const id of Object.keys(plugins)) {
       if (listed.has(id))
@@ -227901,7 +228358,7 @@ var buildWeb = async (options) => {
     if (!js.includes(entry.fileSrc))
       continue;
     const to = join56(out, "assets", ...entry.path.split("/").filter(Boolean));
-    if (existsSync52(to)) {
+    if (existsSync53(to)) {
       warnings.push(`${entry.path}: a file of the page has this name in the built folder — the project's file was not copied`);
       continue;
     }
@@ -227909,12 +228366,12 @@ var buildWeb = async (options) => {
     copyFileSync2(entry.absPath, to);
   }
   const app = readAppConfigAt(root);
-  let html = readFileSync41(join56(lite, "index.html"), "utf8");
+  let html = readFileSync42(join56(lite, "index.html"), "utf8");
   const head = [];
   head.push(`<meta name="theme-color" content="${escapeHtml(config.themeColor ?? "#000000")}" />`);
   if (app?.icon) {
-    const icon = resolve34(root, app.icon);
-    if (existsSync52(icon)) {
+    const icon = resolve35(root, app.icon);
+    if (existsSync53(icon)) {
       const file = `icon${extname2(icon).toLowerCase() || ".png"}`;
       copyFileSync2(icon, join56(out, file));
       head.push(`<link rel="icon" href="${file}" />`, `<link rel="apple-touch-icon" href="${file}" />`);
@@ -227949,12 +228406,12 @@ var buildWeb = async (options) => {
 };
 
 // src/web/preview.ts
-import { createReadStream as createReadStream3, existsSync as existsSync53, statSync as statSync21 } from "node:fs";
+import { createReadStream as createReadStream3, existsSync as existsSync54, statSync as statSync21 } from "node:fs";
 import { createServer as createServer4 } from "node:http";
-import { join as join57, resolve as resolve35 } from "node:path";
+import { join as join57, resolve as resolve36 } from "node:path";
 var startPreview = async (dir, port) => {
-  const root = resolve35(dir);
-  const fallback = existsSync53(join57(root, "404.html")) ? join57(root, "index.html") : null;
+  const root = resolve36(dir);
+  const fallback = existsSync54(join57(root, "404.html")) ? join57(root, "index.html") : null;
   const server2 = createServer4((req, res) => {
     let path;
     try {
@@ -227971,10 +228428,10 @@ var startPreview = async (dir, port) => {
       return;
     }
     let file = join57(root, ...parts);
-    if (existsSync53(file) && statSync21(file).isDirectory())
+    if (existsSync54(file) && statSync21(file).isDirectory())
       file = join57(file, "index.html");
     let status = 200;
-    if (!existsSync53(file) || !statSync21(file).isFile()) {
+    if (!existsSync54(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");
@@ -228164,7 +228621,7 @@ var web_default = defineCommand({
 
 // 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: "Project", commands: [init_default, create_default, clone_default, link_default, status_default, diff_default, pull_default, push_default, publish_default, releases_default, login_default] },
   { title: "Run & test", commands: [
     dev_default,
     web_default,
@@ -228201,7 +228658,7 @@ init_peers();
 var STANDALONE2 = (() => {
   const dir = dirname28(process.execPath);
   const chisel = process.platform === "win32" ? "chisel.exe" : "chisel";
-  return existsSync55(join59(dir, "runtime")) && existsSync55(join59(dir, chisel));
+  return existsSync56(join59(dir, "runtime")) && existsSync56(join59(dir, chisel));
 })();
 var INSTALLED = STANDALONE2 && (() => {
   const exe = process.platform === "win32" ? "lecodes.exe" : "lecodes";
@@ -228217,7 +228674,7 @@ var INSTALLED = STANDALONE2 && (() => {
       return false;
     try {
       const cand = join59(d, exe);
-      return existsSync55(cand) && realpathSync2(cand) === self2;
+      return existsSync56(cand) && realpathSync2(cand) === self2;
     } catch {
       return false;
     }