elit 3.5.8 → 3.6.0

package/Cargo.lock

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

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "elit-desktop"
-version = "3.5.8"
+version = "3.6.0"
 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.8`:
+Highlights in `v3.6.0`:
 
 - 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-FCdUqabc.js';
+import { B as BuildOptions, a as BuildResult } from './server-CcBFc2F5.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,
@@ -61322,14 +61325,13 @@ var sendError = (res, code, msg) => {
 var send404 = (res, msg = "Not Found") => sendError(res, 404, msg);
 var send403 = (res, msg = "Forbidden") => sendError(res, 403, msg);
 var send500 = (res, msg = "Internal Server Error") => sendError(res, 500, msg);
-async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
+async function resolveWorkspaceElitImportBasePath(rootDir, basePath, _mode) {
   const resolvedRootDir = await realpath(resolve(rootDir));
   try {
     const packageJsonBuffer = await readFile(join(resolvedRootDir, "package.json"));
     const packageJson = JSON.parse(packageJsonBuffer.toString());
     if (packageJson.name === "elit") {
-      const workspaceDir = mode === "dev" ? "src" : "dist";
-      return basePath ? `${basePath}/${workspaceDir}` : `/${workspaceDir}`;
+      return basePath ? `${basePath}/dist` : "/dist";
     }
   } catch {
   }
@@ -61337,7 +61339,7 @@ async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
 }
 var createElitImportMap = async (rootDir, basePath = "", mode = "dev") => {
   const workspaceImportBasePath = await resolveWorkspaceElitImportBasePath(rootDir, basePath, mode);
-  const fileExt = mode === "dev" ? ".ts" : ".js";
+  const fileExt = ".js";
   const elitImports = workspaceImportBasePath ? {
     "elit": `${workspaceImportBasePath}/index${fileExt}`,
     "elit/": `${workspaceImportBasePath}/`,
@@ -76741,6 +76743,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";
@@ -76783,6 +76788,27 @@ function resolveDesktopBootstrapSupportModulePath(moduleName, packageRoot = PACK
     `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`);
@@ -76877,6 +76903,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
@@ -76942,6 +76971,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,
@@ -77088,6 +77120,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.",
@@ -77348,6 +77382,8 @@ async function runDesktopRuntime(options) {
   try {
     const binary = ensureDesktopBinary({
       runtime: options.runtime,
+      binaryPath: options.binaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77363,6 +77399,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
     });
@@ -77380,13 +77418,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.");
   }
@@ -77416,12 +77455,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.");
   }
@@ -77449,10 +77489,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.");
@@ -77460,10 +77507,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.");
@@ -77489,7 +77543,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) {
@@ -77509,6 +77563,7 @@ function buildDesktopRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("hybrid");
     process.exit(result2.status ?? 1);
   }
 }
@@ -77528,7 +77583,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) {
@@ -77548,11 +77603,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)];
@@ -77563,8 +77623,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)];
@@ -77575,11 +77639,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,
@@ -61307,14 +61310,13 @@ var sendError = (res, code, msg) => {
 var send404 = (res, msg = "Not Found") => sendError(res, 404, msg);
 var send403 = (res, msg = "Forbidden") => sendError(res, 403, msg);
 var send500 = (res, msg = "Internal Server Error") => sendError(res, 500, msg);
-async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
+async function resolveWorkspaceElitImportBasePath(rootDir, basePath, _mode) {
   const resolvedRootDir = await realpath(resolve(rootDir));
   try {
     const packageJsonBuffer = await readFile(join(resolvedRootDir, "package.json"));
     const packageJson = JSON.parse(packageJsonBuffer.toString());
     if (packageJson.name === "elit") {
-      const workspaceDir = mode === "dev" ? "src" : "dist";
-      return basePath ? `${basePath}/${workspaceDir}` : `/${workspaceDir}`;
+      return basePath ? `${basePath}/dist` : "/dist";
     }
   } catch {
   }
@@ -61322,7 +61324,7 @@ async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
 }
 var createElitImportMap = async (rootDir, basePath = "", mode = "dev") => {
   const workspaceImportBasePath = await resolveWorkspaceElitImportBasePath(rootDir, basePath, mode);
-  const fileExt = mode === "dev" ? ".ts" : ".js";
+  const fileExt = ".js";
   const elitImports = workspaceImportBasePath ? {
     "elit": `${workspaceImportBasePath}/index${fileExt}`,
     "elit/": `${workspaceImportBasePath}/`,
@@ -76726,6 +76728,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";
@@ -76768,6 +76773,27 @@ function resolveDesktopBootstrapSupportModulePath(moduleName, packageRoot = PACK
     `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`);
@@ -76862,6 +76888,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
@@ -76927,6 +76956,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,
@@ -77073,6 +77105,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.",
@@ -77333,6 +77367,8 @@ async function runDesktopRuntime(options) {
   try {
     const binary = ensureDesktopBinary({
       runtime: options.runtime,
+      binaryPath: options.binaryPath,
+      cargoTargetDir: options.cargoTargetDir,
       release: options.release,
       entryPath: options.entry
     });
@@ -77348,6 +77384,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
     });
@@ -77365,13 +77403,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.");
   }
@@ -77401,12 +77440,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.");
   }
@@ -77434,10 +77474,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.");
@@ -77445,10 +77492,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.");
@@ -77474,7 +77528,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) {
@@ -77494,6 +77548,7 @@ function buildDesktopRuntime(options) {
     throw result2.error;
   }
   if (result2.status !== 0) {
+    printDesktopCargoFailureHint("hybrid");
     process.exit(result2.status ?? 1);
   }
 }
@@ -77513,7 +77568,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) {
@@ -77533,11 +77588,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)];
@@ -77548,8 +77608,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)];
@@ -77560,11 +77624,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-FCdUqabc.js';
+import { D as DevServerOptions, B as BuildOptions, P as PreviewOptions, T as TestOptions } from './server-CcBFc2F5.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-FCdUqabc.js';
+import { b as TestCoverageReporter } from './server-CcBFc2F5.js';
 import './http.js';
 import 'node:events';
 import './ws.js';

package/dist/desktop-auto-render.d.ts

@@ -1,5 +1,5 @@
 import { DesktopRenderOptions } from './render-context.js';
-import './server-FCdUqabc.js';
+import './server-CcBFc2F5.js';
 import './http.js';
 import 'node:events';
 import './ws.js';

package/dist/render-context.d.ts

@@ -1,4 +1,4 @@
-import { V as VNode } from './server-FCdUqabc.js';
+import { V as VNode } from './server-CcBFc2F5.js';
 import './http.js';
 import 'node:events';
 import './ws.js';

package/dist/{server-FCdUqabc.d.ts → server-CcBFc2F5.d.ts}

@@ -376,7 +376,7 @@ declare const json: (res: ServerResponse, data: any, status?: number) => ServerR
 declare const text: (res: ServerResponse, data: string, status?: number) => ServerResponse;
 declare const html: (res: ServerResponse, data: string, status?: number) => ServerResponse;
 declare const status: (res: ServerResponse, code: number, message?: string) => ServerResponse;
-declare function resolveWorkspaceElitImportBasePath(rootDir: string, basePath: string, mode: 'dev' | 'preview'): Promise<string | undefined>;
+declare function resolveWorkspaceElitImportBasePath(rootDir: string, basePath: string, _mode: 'dev' | 'preview'): Promise<string | undefined>;
 declare const createElitImportMap: (rootDir: string, basePath?: string, mode?: "dev" | "preview") => Promise<string>;
 /**
  * Clear import map cache (useful when packages are added/removed)

package/dist/server.cjs

@@ -56706,14 +56706,13 @@ var sendError = (res, code, msg) => {
 var send404 = (res, msg = "Not Found") => sendError(res, 404, msg);
 var send403 = (res, msg = "Forbidden") => sendError(res, 403, msg);
 var send500 = (res, msg = "Internal Server Error") => sendError(res, 500, msg);
-async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
+async function resolveWorkspaceElitImportBasePath(rootDir, basePath, _mode) {
   const resolvedRootDir = await realpath(resolve(rootDir));
   try {
     const packageJsonBuffer = await readFile(join(resolvedRootDir, "package.json"));
     const packageJson = JSON.parse(packageJsonBuffer.toString());
     if (packageJson.name === "elit") {
-      const workspaceDir = mode === "dev" ? "src" : "dist";
-      return basePath ? `${basePath}/${workspaceDir}` : `/${workspaceDir}`;
+      return basePath ? `${basePath}/dist` : "/dist";
     }
   } catch {
   }
@@ -56721,7 +56720,7 @@ async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
 }
 var createElitImportMap = async (rootDir, basePath = "", mode = "dev") => {
   const workspaceImportBasePath = await resolveWorkspaceElitImportBasePath(rootDir, basePath, mode);
-  const fileExt = mode === "dev" ? ".ts" : ".js";
+  const fileExt = ".js";
   const elitImports = workspaceImportBasePath ? {
     "elit": `${workspaceImportBasePath}/index${fileExt}`,
     "elit/": `${workspaceImportBasePath}/`,

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import './http.js';
 import './ws.js';
-export { E as ElitRequest, c as ElitResponse, H as HttpMethod, M as Middleware, S as ServerRouteContext, d as ServerRouteHandler, e as ServerRouter, f as SharedState, g as SharedStateOptions, h as StateChangeHandler, i as StateManager, j as bodyLimit, k as cacheControl, l as clearImportMapCache, m as compress, n as cors, o as createDevServer, p as createElitImportMap, q as createProxyHandler, r as errorHandler, s as html, t as json, u as logger, v as rateLimit, w as resolveWorkspaceElitImportBasePath, x as security, y as status, z as text } from './server-FCdUqabc.js';
+export { E as ElitRequest, c as ElitResponse, H as HttpMethod, M as Middleware, S as ServerRouteContext, d as ServerRouteHandler, e as ServerRouter, f as SharedState, g as SharedStateOptions, h as StateChangeHandler, i as StateManager, j as bodyLimit, k as cacheControl, l as clearImportMapCache, m as compress, n as cors, o as createDevServer, p as createElitImportMap, q as createProxyHandler, r as errorHandler, s as html, t as json, u as logger, v as rateLimit, w as resolveWorkspaceElitImportBasePath, x as security, y as status, z as text } from './server-CcBFc2F5.js';
 import 'node:events';
 import 'events';
 import 'http';

package/dist/server.js

@@ -63433,14 +63433,13 @@ tell application "System Events" to get value of property list item "CFBundleNam
   var send404 = (res, msg = "Not Found") => sendError(res, 404, msg);
   var send403 = (res, msg = "Forbidden") => sendError(res, 403, msg);
   var send500 = (res, msg = "Internal Server Error") => sendError(res, 500, msg);
-  async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
+  async function resolveWorkspaceElitImportBasePath(rootDir, basePath, _mode) {
     const resolvedRootDir = await realpath(resolve(rootDir));
     try {
       const packageJsonBuffer = await readFile(join(resolvedRootDir, "package.json"));
       const packageJson = JSON.parse(packageJsonBuffer.toString());
       if (packageJson.name === "elit") {
-        const workspaceDir = mode === "dev" ? "src" : "dist";
-        return basePath ? `${basePath}/${workspaceDir}` : `/${workspaceDir}`;
+        return basePath ? `${basePath}/dist` : "/dist";
       }
     } catch {
     }
@@ -63448,7 +63447,7 @@ tell application "System Events" to get value of property list item "CFBundleNam
   }
   var createElitImportMap = async (rootDir, basePath = "", mode = "dev") => {
     const workspaceImportBasePath = await resolveWorkspaceElitImportBasePath(rootDir, basePath, mode);
-    const fileExt = mode === "dev" ? ".ts" : ".js";
+    const fileExt = ".js";
     const elitImports = workspaceImportBasePath ? {
       "elit": `${workspaceImportBasePath}/index${fileExt}`,
       "elit/": `${workspaceImportBasePath}/`,

package/dist/server.mjs

@@ -56688,14 +56688,13 @@ var sendError = (res, code, msg) => {
 var send404 = (res, msg = "Not Found") => sendError(res, 404, msg);
 var send403 = (res, msg = "Forbidden") => sendError(res, 403, msg);
 var send500 = (res, msg = "Internal Server Error") => sendError(res, 500, msg);
-async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
+async function resolveWorkspaceElitImportBasePath(rootDir, basePath, _mode) {
   const resolvedRootDir = await realpath(resolve(rootDir));
   try {
     const packageJsonBuffer = await readFile(join(resolvedRootDir, "package.json"));
     const packageJson = JSON.parse(packageJsonBuffer.toString());
     if (packageJson.name === "elit") {
-      const workspaceDir = mode === "dev" ? "src" : "dist";
-      return basePath ? `${basePath}/${workspaceDir}` : `/${workspaceDir}`;
+      return basePath ? `${basePath}/dist` : "/dist";
     }
   } catch {
   }
@@ -56703,7 +56702,7 @@ async function resolveWorkspaceElitImportBasePath(rootDir, basePath, mode) {
 }
 var createElitImportMap = async (rootDir, basePath = "", mode = "dev") => {
   const workspaceImportBasePath = await resolveWorkspaceElitImportBasePath(rootDir, basePath, mode);
-  const fileExt = mode === "dev" ? ".ts" : ".js";
+  const fileExt = ".js";
   const elitImports = workspaceImportBasePath ? {
     "elit": `${workspaceImportBasePath}/index${fileExt}`,
     "elit/": `${workspaceImportBasePath}/`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elit",
-  "version": "3.5.8",
+  "version": "3.6.0",
   "description": "Optimized lightweight library for creating DOM elements with reactive state",
   "main": "dist/index.js",
   "module": "dist/index.mjs",