elit 3.5.7 → 3.5.9

package/Cargo.lock

@@ -1211,7 +1211,7 @@ dependencies = [
 
 [[package]]
 name = "elit-desktop"
-version = "0.1.0"
+version = "3.5.9"
 dependencies = [
  "eframe",
  "http",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "elit-desktop"
-version = "3.5.7"
+version = "3.5.9"
 edition = "2021"
 build = "desktop/build.rs"
 

package/README.md

@@ -955,7 +955,7 @@ The package also exports `elit/test`, `elit/test-runtime`, and `elit/test-report
 
 Latest release notes live in [CHANGELOG.md](CHANGELOG.md).
 
-Highlights in `v3.5.7`:
+Highlights in `v3.5.9`:
 
 - Added `elit pm` for detached background process management of shell commands, file targets, and WAPK apps.
 - Added `pm.apps[]` and `pm.dataDir` in `elit.config.*` for config-first process manager workflows.

package/dist/build.d.ts

@@ -1,4 +1,4 @@
-import { B as BuildOptions, a as BuildResult } from './server-CNgDUgSZ.js';
+import { B as BuildOptions, a as BuildResult } from './server-FCdUqabc.js';
 import './http.js';
 import 'node:events';
 import './ws.js';

package/dist/cli.cjs

@@ -59622,6 +59622,9 @@ async function loadConfigFile(configPath) {
       await build2({
         entryPoints: [configPath],
         bundle: true,
+        banner: {
+          js: `import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);`
+        },
         format: "esm",
         platform: "node",
         outfile: tempFile,
@@ -76741,6 +76744,9 @@ function toDesktopBootstrapImportPath(fromPath, toPath) {
   const importPath = (0, import_node_path3.relative)((0, import_node_path3.dirname)(fromPath), toPath).replace(/\\/g, "/");
   return importPath.startsWith("./") || importPath.startsWith("../") ? importPath : `./${importPath}`;
 }
+function isNodeModulesPackagePath(path) {
+  return path.split(/[\\/]+/).some((segment) => segment.toLowerCase() === "node_modules");
+}
 function formatDesktopDisplayName(value) {
   if (!value) {
     return "Elit";
@@ -76769,12 +76775,47 @@ function resolveDesktopEntryDisplayName(entryPath, fallbackName) {
   }
   return formatDesktopDisplayName(fallbackName);
 }
+function resolveDesktopBootstrapSupportModulePath(moduleName, packageRoot = PACKAGE_ROOT) {
+  const candidates = [
+    (0, import_node_path3.resolve)(packageRoot, "src", `${moduleName}.ts`),
+    (0, import_node_path3.resolve)(packageRoot, "dist", `${moduleName}.mjs`)
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_node_fs3.existsSync)(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Desktop support module "${moduleName}" was not found in ${packageRoot}. Expected one of: ${candidates.join(", ")}`
+  );
+}
+function resolveDesktopCargoTargetBaseDir(packageRoot = PACKAGE_ROOT, cwd = process.cwd(), env = process.env, platform = process.platform) {
+  const explicitTargetDir = env.ELIT_DESKTOP_CARGO_TARGET_DIR?.trim();
+  if (explicitTargetDir) {
+    return (0, import_node_path3.resolve)(explicitTargetDir);
+  }
+  const localAppData = env.LOCALAPPDATA?.trim();
+  if (platform === "win32" && localAppData) {
+    return (0, import_node_path3.resolve)(localAppData, "elit", "target", "desktop");
+  }
+  if (isNodeModulesPackagePath(packageRoot)) {
+    return (0, import_node_path3.resolve)(cwd, ".elit", "target", "desktop");
+  }
+  return (0, import_node_path3.resolve)(packageRoot, "target", "desktop");
+}
+function resolveDesktopBinaryOverridePath(configuredPath, envName, cwd = process.cwd(), env = process.env) {
+  const explicitPath = env[envName]?.trim() || configuredPath?.trim();
+  if (!explicitPath) {
+    return void 0;
+  }
+  return (0, import_node_path3.resolve)(cwd, explicitPath);
+}
 function createDesktopBootstrapEntry(entryPath, appName) {
   const bootstrapId = (0, import_node_crypto3.randomUUID)();
   const bootstrapPath = (0, import_node_path3.join)((0, import_node_path3.dirname)(entryPath), `.elit-desktop-bootstrap-${appName}-${bootstrapId}.ts`);
   const preludePath = (0, import_node_path3.join)((0, import_node_path3.dirname)(entryPath), `.elit-desktop-prelude-${appName}-${bootstrapId}.ts`);
-  const desktopAutoRenderPath = (0, import_node_path3.resolve)(PACKAGE_ROOT, "src", "desktop-auto-render.ts");
-  const renderContextPath = (0, import_node_path3.resolve)(PACKAGE_ROOT, "src", "render-context.ts");
+  const desktopAutoRenderPath = resolveDesktopBootstrapSupportModulePath("desktop-auto-render");
+  const renderContextPath = resolveDesktopBootstrapSupportModulePath("render-context");
   const defaultTitle = `${resolveDesktopEntryDisplayName(entryPath, appName)} Desktop`;
   (0, import_node_fs3.writeFileSync)(
     preludePath,
@@ -76863,6 +76904,9 @@ function parseDesktopRunArgs(args, config) {
     mode: getDefaultDesktopMode(config),
     entry: void 0,
     exportName: config?.native?.exportName,
+    binaryPath: config?.binaryPath,
+    nativeBinaryPath: config?.nativeBinaryPath,
+    cargoTargetDir: config?.cargoTargetDir,
     runtime: config?.runtime ?? "quickjs",
     compiler: config?.compiler ?? "auto",
     release: config?.release ?? false
@@ -76928,6 +76972,9 @@ function parseDesktopBuildArgs(args, config) {
     mode: getDefaultDesktopMode(config),
     entry: void 0,
     exportName: config?.native?.exportName,
+    binaryPath: config?.binaryPath,
+    nativeBinaryPath: config?.nativeBinaryPath,
+    cargoTargetDir: config?.cargoTargetDir,
     runtime: config?.runtime ?? "quickjs",
     compiler: config?.compiler ?? "auto",
     release: config?.release ?? false,
@@ -77074,6 +77121,8 @@ function printDesktopHelp() {
     "  - TypeScript and module-style QuickJS entries are transpiled automatically.",
     "  - The tsx compiler is Node-only and keeps loading the original source tree.",
     "  - The tsx and tsup compilers require those packages to be installed.",
+    "  - Use desktop.binaryPath / desktop.nativeBinaryPath or ELIT_DESKTOP_BINARY_PATH / ELIT_DESKTOP_NATIVE_BINARY_PATH to reuse prebuilt runtimes when Cargo builds are blocked.",
+    "  - Use desktop.cargoTargetDir or ELIT_DESKTOP_CARGO_TARGET_DIR to move the desktop Cargo cache to a policy-approved location.",
     '  - desktop.mode defaults to "native" when desktop.native.entry exists, otherwise "hybrid".',
     "  - desktop.entry is used for hybrid mode. desktop.native.entry is used for native mode.",
     "  - Native mode falls back to desktop.entry when only the legacy desktop.entry is configured.",
@@ -77334,6 +77383,8 @@ async function runDesktopRuntime(options) {
   try {
     const binary = ensureDesktopBinary({
       runtime: options.runtime,
+      binaryPath: options.binaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77349,6 +77400,8 @@ async function runDesktopNativeRuntime(options) {
   const preparedPayload = await prepareDesktopNativePayload(options);
   try {
     const binary = ensureDesktopNativeBinary({
+      binaryPath: options.nativeBinaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77366,13 +77419,14 @@ async function buildDesktopBundle(options) {
     return;
   }
   const triple = options.platform ? PLATFORMS[options.platform] : void 0;
-  buildDesktopRuntime({
+  const binary = ensureDesktopBinary({
     runtime: options.runtime,
+    binaryPath: options.binaryPath,
+    cargoTargetDir: options.cargoTargetDir,
     release: options.release,
     triple,
     entryPath: options.entry
   });
-  const binary = findDesktopBinary(options.runtime, options.release, triple);
   if (!binary) {
     throw new Error("Desktop runtime binary was not found after cargo build completed.");
   }
@@ -77402,12 +77456,13 @@ async function buildDesktopBundle(options) {
 }
 async function buildDesktopNativeBundle(options) {
   const triple = options.platform ? PLATFORMS[options.platform] : void 0;
-  buildDesktopNativeRuntime({
+  const binary = ensureDesktopNativeBinary({
+    binaryPath: options.nativeBinaryPath,
+    cargoTargetDir: options.cargoTargetDir,
     release: options.release,
     triple,
     entryPath: options.entry
   });
-  const binary = findDesktopNativeBinary(options.release, triple);
   if (!binary) {
     throw new Error("Desktop native runtime binary was not found after cargo build completed.");
   }
@@ -77435,10 +77490,17 @@ async function buildDesktopNativeBundle(options) {
   }
 }
 function ensureDesktopBinary(options) {
-  let binary = findDesktopBinary(options.runtime, options.release, options.triple);
+  const overriddenBinary = resolveDesktopBinaryOverridePath(options.binaryPath, "ELIT_DESKTOP_BINARY_PATH");
+  if (overriddenBinary) {
+    if (!(0, import_node_fs3.existsSync)(overriddenBinary)) {
+      throw new Error(`Configured desktop runtime binary was not found: ${overriddenBinary}`);
+    }
+    return overriddenBinary;
+  }
+  let binary = findDesktopBinary(options.runtime, options.release, options.triple, options.cargoTargetDir);
   if (!binary || isDesktopRustBuildStale(binary)) {
     buildDesktopRuntime(options);
-    binary = findDesktopBinary(options.runtime, options.release, options.triple);
+    binary = findDesktopBinary(options.runtime, options.release, options.triple, options.cargoTargetDir);
   }
   if (!binary) {
     throw new Error("Desktop runtime binary was not found after cargo build completed.");
@@ -77446,10 +77508,17 @@ function ensureDesktopBinary(options) {
   return binary;
 }
 function ensureDesktopNativeBinary(options) {
-  let binary = findDesktopNativeBinary(options.release, options.triple);
+  const overriddenBinary = resolveDesktopBinaryOverridePath(options.binaryPath, "ELIT_DESKTOP_NATIVE_BINARY_PATH");
+  if (overriddenBinary) {
+    if (!(0, import_node_fs3.existsSync)(overriddenBinary)) {
+      throw new Error(`Configured desktop native runtime binary was not found: ${overriddenBinary}`);
+    }
+    return overriddenBinary;
+  }
+  let binary = findDesktopNativeBinary(options.release, options.triple, options.cargoTargetDir);
   if (!binary || isDesktopRustBuildStale(binary)) {
     buildDesktopNativeRuntime(options);
-    binary = findDesktopNativeBinary(options.release, options.triple);
+    binary = findDesktopNativeBinary(options.release, options.triple, options.cargoTargetDir);
   }
   if (!binary) {
     throw new Error("Desktop native runtime binary was not found after cargo build completed.");
@@ -77475,7 +77544,7 @@ function buildDesktopRuntime(options) {
   }
   const env = {
     ...process.env,
-    CARGO_TARGET_DIR: desktopCargoTargetDir(options.runtime)
+    CARGO_TARGET_DIR: desktopCargoTargetDir(options.runtime, options.cargoTargetDir)
   };
   const iconPath = resolveDesktopIcon(options.entryPath);
   if (iconPath) {
@@ -77495,6 +77564,7 @@ function buildDesktopRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("hybrid");
     process.exit(result2.status ?? 1);
   }
 }
@@ -77514,7 +77584,7 @@ function buildDesktopNativeRuntime(options) {
   }
   const env = {
     ...process.env,
-    CARGO_TARGET_DIR: desktopNativeCargoTargetDir()
+    CARGO_TARGET_DIR: desktopNativeCargoTargetDir(options.cargoTargetDir)
   };
   const iconPath = resolveDesktopIcon(options.entryPath);
   if (iconPath) {
@@ -77534,11 +77604,16 @@ function buildDesktopNativeRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("native");
     process.exit(result2.status ?? 1);
   }
 }
-function findDesktopBinary(runtime2, release, triple) {
-  const targetDir = desktopCargoTargetDir(runtime2);
+function findDesktopBinary(runtime2, release, triple, configuredTargetDir, configuredBinaryPath) {
+  const overriddenBinary = resolveDesktopBinaryOverridePath(configuredBinaryPath, "ELIT_DESKTOP_BINARY_PATH");
+  if (overriddenBinary) {
+    return (0, import_node_fs3.existsSync)(overriddenBinary) ? overriddenBinary : null;
+  }
+  const targetDir = desktopCargoTargetDir(runtime2, configuredTargetDir);
   const profile = release ? "release" : "debug";
   const binaryName = isWindowsTarget(triple) ? "elit-desktop.exe" : "elit-desktop";
   const candidates = triple ? [(0, import_node_path3.join)(targetDir, triple, profile, binaryName)] : [(0, import_node_path3.join)(targetDir, profile, binaryName)];
@@ -77549,8 +77624,12 @@ function findDesktopBinary(runtime2, release, triple) {
   }
   return null;
 }
-function findDesktopNativeBinary(release, triple) {
-  const targetDir = desktopNativeCargoTargetDir();
+function findDesktopNativeBinary(release, triple, configuredTargetDir, configuredBinaryPath) {
+  const overriddenBinary = resolveDesktopBinaryOverridePath(configuredBinaryPath, "ELIT_DESKTOP_NATIVE_BINARY_PATH");
+  if (overriddenBinary) {
+    return (0, import_node_fs3.existsSync)(overriddenBinary) ? overriddenBinary : null;
+  }
+  const targetDir = desktopNativeCargoTargetDir(configuredTargetDir);
   const profile = release ? "release" : "debug";
   const binaryName = isWindowsTarget(triple) ? "elit-desktop-native.exe" : "elit-desktop-native";
   const candidates = triple ? [(0, import_node_path3.join)(targetDir, triple, profile, binaryName)] : [(0, import_node_path3.join)(targetDir, profile, binaryName)];
@@ -77561,11 +77640,34 @@ function findDesktopNativeBinary(release, triple) {
   }
   return null;
 }
-function desktopCargoTargetDir(runtime2) {
-  return (0, import_node_path3.resolve)(PACKAGE_ROOT, "target", "desktop", runtime2);
+function desktopCargoTargetDir(runtime2, configuredTargetDir) {
+  return (0, import_node_path3.resolve)(resolveDesktopCargoTargetBaseDir(
+    PACKAGE_ROOT,
+    process.cwd(),
+    {
+      ...process.env,
+      ...configuredTargetDir ? { ELIT_DESKTOP_CARGO_TARGET_DIR: configuredTargetDir } : {}
+    }
+  ), runtime2);
+}
+function desktopNativeCargoTargetDir(configuredTargetDir) {
+  return (0, import_node_path3.resolve)(resolveDesktopCargoTargetBaseDir(
+    PACKAGE_ROOT,
+    process.cwd(),
+    {
+      ...process.env,
+      ...configuredTargetDir ? { ELIT_DESKTOP_CARGO_TARGET_DIR: configuredTargetDir } : {}
+    }
+  ), "native");
 }
-function desktopNativeCargoTargetDir() {
-  return (0, import_node_path3.resolve)(PACKAGE_ROOT, "target", "desktop", "native");
+function printDesktopCargoFailureHint(mode) {
+  if (process.platform !== "win32") {
+    return;
+  }
+  const binaryConfigLabel = mode === "native" ? "desktop.nativeBinaryPath or ELIT_DESKTOP_NATIVE_BINARY_PATH" : "desktop.binaryPath or ELIT_DESKTOP_BINARY_PATH";
+  console.error("[desktop] Cargo build failed. If Windows Application Control blocks Rust build scripts on this machine, configure a prebuilt runtime binary.");
+  console.error(`[desktop] Use ${binaryConfigLabel} to bypass Cargo for desktop runs/builds.`);
+  console.error("[desktop] Use desktop.cargoTargetDir or ELIT_DESKTOP_CARGO_TARGET_DIR if your environment only allows specific cache locations.");
 }
 function isDesktopRustBuildStale(binaryPath) {
   if (!(0, import_node_fs3.existsSync)(binaryPath)) {

package/dist/cli.mjs

@@ -59607,6 +59607,9 @@ async function loadConfigFile(configPath) {
       await build2({
         entryPoints: [configPath],
         bundle: true,
+        banner: {
+          js: `import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);`
+        },
         format: "esm",
         platform: "node",
         outfile: tempFile,
@@ -76726,6 +76729,9 @@ function toDesktopBootstrapImportPath(fromPath, toPath) {
   const importPath = relative3(dirname4(fromPath), toPath).replace(/\\/g, "/");
   return importPath.startsWith("./") || importPath.startsWith("../") ? importPath : `./${importPath}`;
 }
+function isNodeModulesPackagePath(path) {
+  return path.split(/[\\/]+/).some((segment) => segment.toLowerCase() === "node_modules");
+}
 function formatDesktopDisplayName(value) {
   if (!value) {
     return "Elit";
@@ -76754,12 +76760,47 @@ function resolveDesktopEntryDisplayName(entryPath, fallbackName) {
   }
   return formatDesktopDisplayName(fallbackName);
 }
+function resolveDesktopBootstrapSupportModulePath(moduleName, packageRoot = PACKAGE_ROOT) {
+  const candidates = [
+    resolve4(packageRoot, "src", `${moduleName}.ts`),
+    resolve4(packageRoot, "dist", `${moduleName}.mjs`)
+  ];
+  for (const candidate of candidates) {
+    if (existsSync3(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `Desktop support module "${moduleName}" was not found in ${packageRoot}. Expected one of: ${candidates.join(", ")}`
+  );
+}
+function resolveDesktopCargoTargetBaseDir(packageRoot = PACKAGE_ROOT, cwd = process.cwd(), env = process.env, platform = process.platform) {
+  const explicitTargetDir = env.ELIT_DESKTOP_CARGO_TARGET_DIR?.trim();
+  if (explicitTargetDir) {
+    return resolve4(explicitTargetDir);
+  }
+  const localAppData = env.LOCALAPPDATA?.trim();
+  if (platform === "win32" && localAppData) {
+    return resolve4(localAppData, "elit", "target", "desktop");
+  }
+  if (isNodeModulesPackagePath(packageRoot)) {
+    return resolve4(cwd, ".elit", "target", "desktop");
+  }
+  return resolve4(packageRoot, "target", "desktop");
+}
+function resolveDesktopBinaryOverridePath(configuredPath, envName, cwd = process.cwd(), env = process.env) {
+  const explicitPath = env[envName]?.trim() || configuredPath?.trim();
+  if (!explicitPath) {
+    return void 0;
+  }
+  return resolve4(cwd, explicitPath);
+}
 function createDesktopBootstrapEntry(entryPath, appName) {
   const bootstrapId = randomUUID2();
   const bootstrapPath = join3(dirname4(entryPath), `.elit-desktop-bootstrap-${appName}-${bootstrapId}.ts`);
   const preludePath = join3(dirname4(entryPath), `.elit-desktop-prelude-${appName}-${bootstrapId}.ts`);
-  const desktopAutoRenderPath = resolve4(PACKAGE_ROOT, "src", "desktop-auto-render.ts");
-  const renderContextPath = resolve4(PACKAGE_ROOT, "src", "render-context.ts");
+  const desktopAutoRenderPath = resolveDesktopBootstrapSupportModulePath("desktop-auto-render");
+  const renderContextPath = resolveDesktopBootstrapSupportModulePath("render-context");
   const defaultTitle = `${resolveDesktopEntryDisplayName(entryPath, appName)} Desktop`;
   writeFileSync4(
     preludePath,
@@ -76848,6 +76889,9 @@ function parseDesktopRunArgs(args, config) {
     mode: getDefaultDesktopMode(config),
     entry: void 0,
     exportName: config?.native?.exportName,
+    binaryPath: config?.binaryPath,
+    nativeBinaryPath: config?.nativeBinaryPath,
+    cargoTargetDir: config?.cargoTargetDir,
     runtime: config?.runtime ?? "quickjs",
     compiler: config?.compiler ?? "auto",
     release: config?.release ?? false
@@ -76913,6 +76957,9 @@ function parseDesktopBuildArgs(args, config) {
     mode: getDefaultDesktopMode(config),
     entry: void 0,
     exportName: config?.native?.exportName,
+    binaryPath: config?.binaryPath,
+    nativeBinaryPath: config?.nativeBinaryPath,
+    cargoTargetDir: config?.cargoTargetDir,
     runtime: config?.runtime ?? "quickjs",
     compiler: config?.compiler ?? "auto",
     release: config?.release ?? false,
@@ -77059,6 +77106,8 @@ function printDesktopHelp() {
     "  - TypeScript and module-style QuickJS entries are transpiled automatically.",
     "  - The tsx compiler is Node-only and keeps loading the original source tree.",
     "  - The tsx and tsup compilers require those packages to be installed.",
+    "  - Use desktop.binaryPath / desktop.nativeBinaryPath or ELIT_DESKTOP_BINARY_PATH / ELIT_DESKTOP_NATIVE_BINARY_PATH to reuse prebuilt runtimes when Cargo builds are blocked.",
+    "  - Use desktop.cargoTargetDir or ELIT_DESKTOP_CARGO_TARGET_DIR to move the desktop Cargo cache to a policy-approved location.",
     '  - desktop.mode defaults to "native" when desktop.native.entry exists, otherwise "hybrid".',
     "  - desktop.entry is used for hybrid mode. desktop.native.entry is used for native mode.",
     "  - Native mode falls back to desktop.entry when only the legacy desktop.entry is configured.",
@@ -77319,6 +77368,8 @@ async function runDesktopRuntime(options) {
   try {
     const binary = ensureDesktopBinary({
       runtime: options.runtime,
+      binaryPath: options.binaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77334,6 +77385,8 @@ async function runDesktopNativeRuntime(options) {
   const preparedPayload = await prepareDesktopNativePayload(options);
   try {
     const binary = ensureDesktopNativeBinary({
+      binaryPath: options.nativeBinaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77351,13 +77404,14 @@ async function buildDesktopBundle(options) {
     return;
   }
   const triple = options.platform ? PLATFORMS[options.platform] : void 0;
-  buildDesktopRuntime({
+  const binary = ensureDesktopBinary({
     runtime: options.runtime,
+    binaryPath: options.binaryPath,
+    cargoTargetDir: options.cargoTargetDir,
     release: options.release,
     triple,
     entryPath: options.entry
   });
-  const binary = findDesktopBinary(options.runtime, options.release, triple);
   if (!binary) {
     throw new Error("Desktop runtime binary was not found after cargo build completed.");
   }
@@ -77387,12 +77441,13 @@ async function buildDesktopBundle(options) {
 }
 async function buildDesktopNativeBundle(options) {
   const triple = options.platform ? PLATFORMS[options.platform] : void 0;
-  buildDesktopNativeRuntime({
+  const binary = ensureDesktopNativeBinary({
+    binaryPath: options.nativeBinaryPath,
+    cargoTargetDir: options.cargoTargetDir,
     release: options.release,
     triple,
     entryPath: options.entry
   });
-  const binary = findDesktopNativeBinary(options.release, triple);
   if (!binary) {
     throw new Error("Desktop native runtime binary was not found after cargo build completed.");
   }
@@ -77420,10 +77475,17 @@ async function buildDesktopNativeBundle(options) {
   }
 }
 function ensureDesktopBinary(options) {
-  let binary = findDesktopBinary(options.runtime, options.release, options.triple);
+  const overriddenBinary = resolveDesktopBinaryOverridePath(options.binaryPath, "ELIT_DESKTOP_BINARY_PATH");
+  if (overriddenBinary) {
+    if (!existsSync3(overriddenBinary)) {
+      throw new Error(`Configured desktop runtime binary was not found: ${overriddenBinary}`);
+    }
+    return overriddenBinary;
+  }
+  let binary = findDesktopBinary(options.runtime, options.release, options.triple, options.cargoTargetDir);
   if (!binary || isDesktopRustBuildStale(binary)) {
     buildDesktopRuntime(options);
-    binary = findDesktopBinary(options.runtime, options.release, options.triple);
+    binary = findDesktopBinary(options.runtime, options.release, options.triple, options.cargoTargetDir);
   }
   if (!binary) {
     throw new Error("Desktop runtime binary was not found after cargo build completed.");
@@ -77431,10 +77493,17 @@ function ensureDesktopBinary(options) {
   return binary;
 }
 function ensureDesktopNativeBinary(options) {
-  let binary = findDesktopNativeBinary(options.release, options.triple);
+  const overriddenBinary = resolveDesktopBinaryOverridePath(options.binaryPath, "ELIT_DESKTOP_NATIVE_BINARY_PATH");
+  if (overriddenBinary) {
+    if (!existsSync3(overriddenBinary)) {
+      throw new Error(`Configured desktop native runtime binary was not found: ${overriddenBinary}`);
+    }
+    return overriddenBinary;
+  }
+  let binary = findDesktopNativeBinary(options.release, options.triple, options.cargoTargetDir);
   if (!binary || isDesktopRustBuildStale(binary)) {
     buildDesktopNativeRuntime(options);
-    binary = findDesktopNativeBinary(options.release, options.triple);
+    binary = findDesktopNativeBinary(options.release, options.triple, options.cargoTargetDir);
   }
   if (!binary) {
     throw new Error("Desktop native runtime binary was not found after cargo build completed.");
@@ -77460,7 +77529,7 @@ function buildDesktopRuntime(options) {
   }
   const env = {
     ...process.env,
-    CARGO_TARGET_DIR: desktopCargoTargetDir(options.runtime)
+    CARGO_TARGET_DIR: desktopCargoTargetDir(options.runtime, options.cargoTargetDir)
   };
   const iconPath = resolveDesktopIcon(options.entryPath);
   if (iconPath) {
@@ -77480,6 +77549,7 @@ function buildDesktopRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("hybrid");
     process.exit(result2.status ?? 1);
   }
 }
@@ -77499,7 +77569,7 @@ function buildDesktopNativeRuntime(options) {
   }
   const env = {
     ...process.env,
-    CARGO_TARGET_DIR: desktopNativeCargoTargetDir()
+    CARGO_TARGET_DIR: desktopNativeCargoTargetDir(options.cargoTargetDir)
   };
   const iconPath = resolveDesktopIcon(options.entryPath);
   if (iconPath) {
@@ -77519,11 +77589,16 @@ function buildDesktopNativeRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("native");
     process.exit(result2.status ?? 1);
   }
 }
-function findDesktopBinary(runtime2, release, triple) {
-  const targetDir = desktopCargoTargetDir(runtime2);
+function findDesktopBinary(runtime2, release, triple, configuredTargetDir, configuredBinaryPath) {
+  const overriddenBinary = resolveDesktopBinaryOverridePath(configuredBinaryPath, "ELIT_DESKTOP_BINARY_PATH");
+  if (overriddenBinary) {
+    return existsSync3(overriddenBinary) ? overriddenBinary : null;
+  }
+  const targetDir = desktopCargoTargetDir(runtime2, configuredTargetDir);
   const profile = release ? "release" : "debug";
   const binaryName = isWindowsTarget(triple) ? "elit-desktop.exe" : "elit-desktop";
   const candidates = triple ? [join3(targetDir, triple, profile, binaryName)] : [join3(targetDir, profile, binaryName)];
@@ -77534,8 +77609,12 @@ function findDesktopBinary(runtime2, release, triple) {
   }
   return null;
 }
-function findDesktopNativeBinary(release, triple) {
-  const targetDir = desktopNativeCargoTargetDir();
+function findDesktopNativeBinary(release, triple, configuredTargetDir, configuredBinaryPath) {
+  const overriddenBinary = resolveDesktopBinaryOverridePath(configuredBinaryPath, "ELIT_DESKTOP_NATIVE_BINARY_PATH");
+  if (overriddenBinary) {
+    return existsSync3(overriddenBinary) ? overriddenBinary : null;
+  }
+  const targetDir = desktopNativeCargoTargetDir(configuredTargetDir);
   const profile = release ? "release" : "debug";
   const binaryName = isWindowsTarget(triple) ? "elit-desktop-native.exe" : "elit-desktop-native";
   const candidates = triple ? [join3(targetDir, triple, profile, binaryName)] : [join3(targetDir, profile, binaryName)];
@@ -77546,11 +77625,34 @@ function findDesktopNativeBinary(release, triple) {
   }
   return null;
 }
-function desktopCargoTargetDir(runtime2) {
-  return resolve4(PACKAGE_ROOT, "target", "desktop", runtime2);
+function desktopCargoTargetDir(runtime2, configuredTargetDir) {
+  return resolve4(resolveDesktopCargoTargetBaseDir(
+    PACKAGE_ROOT,
+    process.cwd(),
+    {
+      ...process.env,
+      ...configuredTargetDir ? { ELIT_DESKTOP_CARGO_TARGET_DIR: configuredTargetDir } : {}
+    }
+  ), runtime2);
+}
+function desktopNativeCargoTargetDir(configuredTargetDir) {
+  return resolve4(resolveDesktopCargoTargetBaseDir(
+    PACKAGE_ROOT,
+    process.cwd(),
+    {
+      ...process.env,
+      ...configuredTargetDir ? { ELIT_DESKTOP_CARGO_TARGET_DIR: configuredTargetDir } : {}
+    }
+  ), "native");
 }
-function desktopNativeCargoTargetDir() {
-  return resolve4(PACKAGE_ROOT, "target", "desktop", "native");
+function printDesktopCargoFailureHint(mode) {
+  if (process.platform !== "win32") {
+    return;
+  }
+  const binaryConfigLabel = mode === "native" ? "desktop.nativeBinaryPath or ELIT_DESKTOP_NATIVE_BINARY_PATH" : "desktop.binaryPath or ELIT_DESKTOP_BINARY_PATH";
+  console.error("[desktop] Cargo build failed. If Windows Application Control blocks Rust build scripts on this machine, configure a prebuilt runtime binary.");
+  console.error(`[desktop] Use ${binaryConfigLabel} to bypass Cargo for desktop runs/builds.`);
+  console.error("[desktop] Use desktop.cargoTargetDir or ELIT_DESKTOP_CARGO_TARGET_DIR if your environment only allows specific cache locations.");
 }
 function isDesktopRustBuildStale(binaryPath) {
   if (!existsSync3(binaryPath)) {

package/dist/config.cjs

@@ -945,6 +945,9 @@ async function loadConfigFile(configPath) {
       await build({
         entryPoints: [configPath],
         bundle: true,
+        banner: {
+          js: `import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);`
+        },
         format: "esm",
         platform: "node",
         outfile: tempFile,

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { D as DevServerOptions, B as BuildOptions, P as PreviewOptions, T as TestOptions } from './server-CNgDUgSZ.js';
+import { D as DevServerOptions, B as BuildOptions, P as PreviewOptions, T as TestOptions } from './server-FCdUqabc.js';
 import './http.js';
 import 'node:events';
 import './ws.js';
@@ -151,8 +151,14 @@ interface DesktopConfig {
     mode?: DesktopMode;
     /** Desktop entry file used when the CLI command omits <entry> in hybrid mode */
     entry?: string;
+    /** Optional prebuilt hybrid desktop runtime binary path, relative to the current project when not absolute */
+    binaryPath?: string;
+    /** Optional Cargo target directory override for desktop runtime builds */
+    cargoTargetDir?: string;
     /** Optional native desktop entry defaults */
     native?: DesktopNativeConfig;
+    /** Optional prebuilt native desktop runtime binary path, relative to the current project when not absolute */
+    nativeBinaryPath?: string;
     /** Native desktop runtime: quickjs, bun, node, deno */
     runtime?: 'quickjs' | 'bun' | 'node' | 'deno';
     /** Desktop entry compiler: auto, none, esbuild, tsx, tsup */

package/dist/config.js

@@ -3445,6 +3445,9 @@ error: ${text}`);
         await build({
           entryPoints: [configPath],
           bundle: true,
+          banner: {
+            js: `import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);`
+          },
           format: "esm",
           platform: "node",
           outfile: tempFile,

package/dist/config.mjs

@@ -920,6 +920,9 @@ async function loadConfigFile(configPath) {
       await build({
         entryPoints: [configPath],
         bundle: true,
+        banner: {
+          js: `import { createRequire as __createRequire } from 'module'; const require = __createRequire(import.meta.url);`
+        },
         format: "esm",
         platform: "node",
         outfile: tempFile,

package/dist/coverage.d.ts

@@ -1,4 +1,4 @@
-import { b as TestCoverageReporter } from './server-CNgDUgSZ.js';
+import { b as TestCoverageReporter } from './server-FCdUqabc.js';
 import './http.js';
 import 'node:events';
 import './ws.js';