muon-ui 0.2.0 → 0.4.0

package/dist/vite.cjs

@@ -1,251 +1,30 @@
 /*!
 * name: muon-ui
-* version: 0.2.0
+* version: 0.4.0
 * description: A multi-platform GUI application framework that uses CEF as its backend
 * author: Kouji Matsui (@kekyo@mi.kekyo.net)
 * license: MIT
 * repository.url: https://github.com/kekyo/muon-ui.git
-* git.commit.hash: 6251ff88aafa8ae873657f39aed1ebba2fa329a4
+* git.commit.hash: 44d549142c8cbfa13cb29d10be2568652a68bf50
 */
-const require_build = require("./build-BxDRaTmF.cjs");
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_url = require("node:url");
+const require_vite_options = require("./vite-options-C4evRLpv.cjs");
 let node_path = require("node:path");
-let node_os = require("node:os");
-//#region src/vite-internals.ts
-var import_dist = require_build.require_dist();
-var getServerOpenValue = (server) => {
-	const open = server.config.server.open;
-	return open === true || typeof open === "string" ? open : false;
-};
-var resolveFromRoot = (root, path) => (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(root, path);
-var moduleDirectory = typeof __dirname === "string" ? __dirname : (0, node_path.dirname)((0, node_url.fileURLToPath)({}.url));
-var defaultProjectConfigFileNames = [
-	"muon.json5",
-	"muon.jsonc",
-	"muon.json"
-];
-/**
-* Resolves the muon-core runtime directory used by the Vite plugin.
-*
-* @param options Runtime path resolution inputs.
-* @returns Absolute or package-relative runtime directory path.
-*/
-var resolveMuonRuntimePath = ({ root, target, muonPath, packageDirectory = moduleDirectory }) => muonPath === void 0 ? (0, node_path.join)(packageDirectory, "runtime", target) : resolveFromRoot(root, muonPath);
-var getMuonExecutablePath = (runtimePath, platform) => (0, node_path.join)(runtimePath, platform === "win32" ? "muon-core.exe" : "muon-core");
-var getLaunchScriptFileName = (platform) => platform === "win32" ? "open-muon.cmd" : "open-muon.sh";
-var quotePosix = (value) => `'${value.replaceAll("'", "'\\''")}'`;
-var getPlatformDirectoryName = (path, platform) => platform === "win32" ? node_path.win32.dirname(path) : (0, node_path.dirname)(path);
-var getOptionalPosixValue = (value) => value === void 0 ? "''" : quotePosix(value);
-var createPosixMuonLaunchScript = ({ muonExecutablePath, projectConfigPath, overrideConfigPath }) => `#!/usr/bin/env bash
-set -euo pipefail
-MUON_EXECUTABLE=${quotePosix(muonExecutablePath)}
-MUON_EXECUTABLE_DIRECTORY=${quotePosix(getPlatformDirectoryName(muonExecutablePath, "linux"))}
-MUON_PROJECT_CONFIG=${getOptionalPosixValue(projectConfigPath)}
-MUON_OVERRIDE_CONFIG=${quotePosix(overrideConfigPath)}
-
-MUON_CONFIG_ARGS=()
-if [[ -n "$MUON_PROJECT_CONFIG" ]]; then
-  if [[ ! -f "$MUON_PROJECT_CONFIG" ]]; then
-    echo "Muon startup failed: project config does not exist: $MUON_PROJECT_CONFIG" >&2
-    exit 1
-  fi
-  MUON_CONFIG_ARGS+=("-c" "$MUON_PROJECT_CONFIG")
-fi
-
-if [[ ! -x "$MUON_EXECUTABLE" ]]; then
-  echo "Muon startup failed: executable does not exist or is not executable: $MUON_EXECUTABLE" >&2
-  exit 1
-fi
-
-if [[ ! -f "$MUON_OVERRIDE_CONFIG" ]]; then
-  echo "Muon startup failed: generated override config does not exist: $MUON_OVERRIDE_CONFIG" >&2
-  exit 1
-fi
-MUON_CONFIG_ARGS+=("-c" "$MUON_OVERRIDE_CONFIG")
-
-cd "$MUON_EXECUTABLE_DIRECTORY"
-exec "$MUON_EXECUTABLE" "\${MUON_CONFIG_ARGS[@]}"
-`;
-var escapeWindowsCmdValue = (value) => value.replaceAll("%", "%%").replaceAll("\r", "").replaceAll("\n", "");
-var getOptionalWindowsCmdValue = (value) => value === void 0 ? "" : escapeWindowsCmdValue(value);
-var createWindowsMuonLaunchScript = ({ muonExecutablePath, projectConfigPath, overrideConfigPath }) => `@echo off
-setlocal
-set "MUON_EXECUTABLE=${escapeWindowsCmdValue(muonExecutablePath)}"
-set "MUON_EXECUTABLE_DIRECTORY=${escapeWindowsCmdValue(getPlatformDirectoryName(muonExecutablePath, "win32"))}"
-set "MUON_PROJECT_CONFIG=${getOptionalWindowsCmdValue(projectConfigPath)}"
-set "MUON_OVERRIDE_CONFIG=${escapeWindowsCmdValue(overrideConfigPath)}"
-
-if not exist "%MUON_EXECUTABLE%" (
-  echo Muon startup failed: executable does not exist: %MUON_EXECUTABLE% 1>&2
-  exit /b 1
-)
-
-if not exist "%MUON_OVERRIDE_CONFIG%" (
-  echo Muon startup failed: generated override config does not exist: %MUON_OVERRIDE_CONFIG% 1>&2
-  exit /b 1
-)
-
-pushd "%MUON_EXECUTABLE_DIRECTORY%"
-if defined MUON_PROJECT_CONFIG (
-  if not exist "%MUON_PROJECT_CONFIG%" (
-    echo Muon startup failed: project config does not exist: %MUON_PROJECT_CONFIG% 1>&2
-    popd
-    exit /b 1
-  )
-  "%MUON_EXECUTABLE%" -c "%MUON_PROJECT_CONFIG%" -c "%MUON_OVERRIDE_CONFIG%"
-) else (
-  "%MUON_EXECUTABLE%" -c "%MUON_OVERRIDE_CONFIG%"
-)
-set "MUON_EXIT_CODE=%ERRORLEVEL%"
-popd
-exit /b %MUON_EXIT_CODE%
-`;
-var createMuonLaunchScript = (options) => options.platform === "win32" ? createWindowsMuonLaunchScript(options) : createPosixMuonLaunchScript(options);
-var getBaseUrl = (server) => server.resolvedUrls?.local[0] ?? server.resolvedUrls?.network[0];
-var getStartUrl = (server, openValue) => {
-	const baseUrl = getBaseUrl(server);
-	if (baseUrl === void 0) return;
-	return typeof openValue === "string" ? new URL(openValue, baseUrl).href : baseUrl;
-};
-var getWebSocketOrigin = (startUrl) => {
-	const url = new URL(startUrl);
-	if (url.protocol === "https:") url.protocol = "wss:";
-	else if (url.protocol === "http:") url.protocol = "ws:";
-	return url.origin;
-};
-var createMuonOverrideConfig = (startUrl) => {
-	const origin = new URL(startUrl).origin;
-	return {
-		browser: {
-			startPage: startUrl,
-			plugin: { allow: [`${origin}/**`] }
-		},
-		network: { allow: [`${origin}/**`, `${getWebSocketOrigin(startUrl)}/**`] }
-	};
-};
-var writeMuonOverrideConfig = (server, openValue, overrideConfigPath) => {
-	const startUrl = getStartUrl(server, openValue);
-	if (startUrl === void 0) {
-		server.config.logger.warn("Muon Vite plugin could not resolve a Vite URL.");
-		return;
-	}
-	(0, node_fs.writeFileSync)(overrideConfigPath, `${JSON.stringify(createMuonOverrideConfig(startUrl), null, 2)}\n`);
-};
-var createRuntimePaths = async (server, stagePath, platform, projectConfigPath) => {
-	const temporaryDirectory = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "muon-vite-"));
-	return {
-		temporaryDirectory,
-		launchScriptPath: (0, node_path.join)(temporaryDirectory, getLaunchScriptFileName(platform)),
-		overrideConfigPath: (0, node_path.join)(temporaryDirectory, "muon.vite.json"),
-		projectConfigPath,
-		muonExecutablePath: getMuonExecutablePath(stagePath, platform)
-	};
-};
-var fileExists = async (path) => {
-	try {
-		await (0, node_fs_promises.access)(path, node_fs.constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
-};
-var isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var getErrorMessage = (error) => error instanceof Error ? error.message : String(error);
-var resolveProjectConfigPath = async (server) => {
-	for (const fileName of defaultProjectConfigFileNames) {
-		const candidatePath = (0, node_path.join)(server.config.root, fileName);
-		if (!await fileExists(candidatePath)) continue;
-		try {
-			if (!isJsonObject((0, import_dist.parse)(await (0, node_fs_promises.readFile)(candidatePath, "utf8")))) throw new Error("muon config root must be an object");
-			return candidatePath;
-		} catch (error) {
-			server.config.logger.warn(`Muon project config will be ignored because it could not be read or parsed: ${candidatePath}: ${getErrorMessage(error)}`);
-			return;
-		}
-	}
-	server.config.logger.warn(`Muon project config was not found in ${server.config.root}; launching with generated Vite config only.`);
-};
-var writeLaunchScript = async (paths, platform) => {
-	await (0, node_fs_promises.writeFile)(paths.launchScriptPath, createMuonLaunchScript({
-		muonExecutablePath: paths.muonExecutablePath,
-		projectConfigPath: paths.projectConfigPath,
-		overrideConfigPath: paths.overrideConfigPath,
-		platform
-	}));
-	if (platform !== "win32") await (0, node_fs_promises.chmod)(paths.launchScriptPath, 448);
-};
-var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, architecture, environment }) => {
-	const openValue = getServerOpenValue(server);
-	if (openValue === false || server.httpServer === null) return;
-	const target = require_build.getDefaultMuonPrepareTarget(platform, architecture);
-	const preparedRuntime = await require_build.runMuonPrepare({
-		muonPath: resolveMuonRuntimePath({
-			root: server.config.root,
-			target,
-			muonPath: pluginOptions.muonPath
-		}),
-		cefPath: pluginOptions.cefPath === void 0 ? void 0 : resolveFromRoot(server.config.root, pluginOptions.cefPath),
-		stageDir: pluginOptions.stagePath === void 0 ? (0, node_path.resolve)(server.config.root, ".muon", target) : resolveFromRoot(server.config.root, pluginOptions.stagePath),
-		target,
-		cacheDir: environment.MUON_CACHE_DIR,
-		force: false,
-		quiet: false,
-		prepareExecutablePath: void 0,
-		environment,
-		cwd: server.config.root
-	});
-	if (preparedRuntime.stagePath === void 0) throw new Error("muon-prepare did not return a staged runtime path.");
-	const paths = await createRuntimePaths(server, preparedRuntime.stagePath, platform, await resolveProjectConfigPath(server));
-	await writeLaunchScript(paths, platform);
-	const previousBrowser = environment.BROWSER;
-	environment.BROWSER = paths.launchScriptPath;
-	let cleanupPromise = void 0;
-	const cleanup = async () => {
-		if (cleanupPromise !== void 0) return cleanupPromise;
-		cleanupPromise = (async () => {
-			if (previousBrowser === void 0) delete environment.BROWSER;
-			else environment.BROWSER = previousBrowser;
-			await (0, node_fs_promises.rm)(paths.temporaryDirectory, {
-				recursive: true,
-				force: true
-			});
-		})();
-		return cleanupPromise;
-	};
-	const originalClose = server.close.bind(server);
-	server.close = async () => {
-		try {
-			await originalClose();
-		} finally {
-			await cleanup();
-		}
-	};
-	server.httpServer.once("close", () => {
-		cleanup();
-	});
-	server.httpServer.once("listening", () => {
-		writeMuonOverrideConfig(server, openValue, paths.overrideConfigPath);
-	});
-};
-//#endregion
 //#region src/vite.ts
 /**
-* Creates a Vite plugin that launches Muon through Vite's server.open flow.
+* Creates a Vite plugin that launches Muon during Vite dev startup.
 *
-* @param options Muon runtime location used for development startup.
+* @param options Muon plugin options used for development startup and build.
 * @returns Vite plugin instance.
 */
 var muon = (options = {}) => {
 	let resolvedConfig = void 0;
-	return {
+	return require_vite_options.attachMuonVitePluginOptions({
 		name: "muon",
 		configResolved: (config) => {
 			resolvedConfig = config;
 		},
 		configureServer: async (server) => {
-			await startMuonViteBrowserBridge({
+			await require_vite_options.startMuonViteBrowserBridge({
 				server,
 				pluginOptions: options,
 				platform: process.platform,
@@ -257,9 +36,9 @@ var muon = (options = {}) => {
 			if (resolvedConfig === void 0 || resolvedConfig.command !== "build") return;
 			if (options.build === false) return;
 			const buildOptions = typeof options.build === "object" ? options.build : {};
-			await require_build.buildMuonApp(createMuonBuildOptions(resolvedConfig, buildOptions));
+			await require_vite_options.buildMuonApp(createMuonBuildOptions(resolvedConfig, buildOptions));
 		}
-	};
+	}, options);
 };
 var createMuonBuildOptions = (config, buildOptions) => {
 	const outDir = (0, node_path.isAbsolute)(config.build.outDir) ? config.build.outDir : (0, node_path.resolve)(config.root, config.build.outDir);

package/dist/vite.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite.cjs","names":[],"sources":["../src/vite-internals.ts","../src/vite.ts"],"sourcesContent":["// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon\n\nimport { constants, writeFileSync } from \"node:fs\";\nimport {\n  access,\n  chmod,\n  mkdtemp,\n  readFile,\n  rm,\n  writeFile,\n} from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, isAbsolute, join, resolve, win32 } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { parse } from \"json5\";\nimport type { ViteDevServer } from \"vite\";\n\nimport { getDefaultMuonPrepareTarget, runMuonPrepare } from \"./prepare.js\";\nimport type { MuonVitePluginOptions } from \"./vite.js\";\n\nexport interface MuonLaunchScriptOptions {\n  muonExecutablePath: string;\n  projectConfigPath: string | undefined;\n  overrideConfigPath: string;\n  platform: NodeJS.Platform;\n}\n\ninterface MuonViteSessionOptions {\n  server: ViteDevServer;\n  pluginOptions: MuonVitePluginOptions;\n  platform: NodeJS.Platform;\n  architecture: NodeJS.Architecture;\n  environment: NodeJS.ProcessEnv;\n}\n\ninterface MuonRuntimePaths {\n  temporaryDirectory: string;\n  launchScriptPath: string;\n  overrideConfigPath: string;\n  projectConfigPath: string | undefined;\n  muonExecutablePath: string;\n}\n\ninterface MuonOverrideConfig {\n  browser: {\n    startPage: string;\n    plugin: {\n      allow: string[];\n    };\n  };\n  network: {\n    allow: string[];\n  };\n}\n\n/**\n * Options for resolving a Muon runtime directory used by the Vite plugin.\n */\nexport interface MuonRuntimePathOptions {\n  /**\n   * Vite project root used to resolve explicit relative paths.\n   */\n  root: string;\n\n  /**\n   * Muon runtime target such as linux64, linuxarm, linuxarm64, windows32, or windows64.\n   */\n  target: string;\n\n  /**\n   * Explicit custom muon-core runtime path.\n   */\n  muonPath: string | undefined;\n\n  /**\n   * Directory containing the packaged Muon JavaScript files.\n   *\n   * @remarks This is injectable for tests. Production code uses the module directory.\n   */\n  packageDirectory?: string;\n}\n\nconst getServerOpenValue = (\n  server: ViteDevServer,\n): boolean | string | false => {\n  const open = server.config.server.open;\n  return open === true || typeof open === \"string\" ? open : false;\n};\n\nconst resolveFromRoot = (root: string, path: string): string =>\n  isAbsolute(path) ? path : resolve(root, path);\n\nconst moduleDirectory =\n  typeof __dirname === \"string\"\n    ? __dirname\n    : dirname(fileURLToPath(import.meta.url));\nconst defaultProjectConfigFileNames = [\"muon.json5\", \"muon.jsonc\", \"muon.json\"];\n\n/**\n * Resolves the muon-core runtime directory used by the Vite plugin.\n *\n * @param options Runtime path resolution inputs.\n * @returns Absolute or package-relative runtime directory path.\n */\nexport const resolveMuonRuntimePath = ({\n  root,\n  target,\n  muonPath,\n  packageDirectory = moduleDirectory,\n}: MuonRuntimePathOptions): string =>\n  muonPath === undefined\n    ? join(packageDirectory, \"runtime\", target)\n    : resolveFromRoot(root, muonPath);\n\nexport const getMuonExecutablePath = (\n  runtimePath: string,\n  platform: NodeJS.Platform,\n): string =>\n  join(runtimePath, platform === \"win32\" ? \"muon-core.exe\" : \"muon-core\");\n\nconst getLaunchScriptFileName = (platform: NodeJS.Platform): string =>\n  platform === \"win32\" ? \"open-muon.cmd\" : \"open-muon.sh\";\n\nconst quotePosix = (value: string): string =>\n  `'${value.replaceAll(\"'\", \"'\\\\''\")}'`;\n\nconst getPlatformDirectoryName = (\n  path: string,\n  platform: NodeJS.Platform,\n): string => (platform === \"win32\" ? win32.dirname(path) : dirname(path));\n\nconst getOptionalPosixValue = (value: string | undefined): string =>\n  value === undefined ? \"''\" : quotePosix(value);\n\nconst createPosixMuonLaunchScript = ({\n  muonExecutablePath,\n  projectConfigPath,\n  overrideConfigPath,\n}: MuonLaunchScriptOptions): string => `#!/usr/bin/env bash\nset -euo pipefail\nMUON_EXECUTABLE=${quotePosix(muonExecutablePath)}\nMUON_EXECUTABLE_DIRECTORY=${quotePosix(getPlatformDirectoryName(muonExecutablePath, \"linux\"))}\nMUON_PROJECT_CONFIG=${getOptionalPosixValue(projectConfigPath)}\nMUON_OVERRIDE_CONFIG=${quotePosix(overrideConfigPath)}\n\nMUON_CONFIG_ARGS=()\nif [[ -n \"$MUON_PROJECT_CONFIG\" ]]; then\n  if [[ ! -f \"$MUON_PROJECT_CONFIG\" ]]; then\n    echo \"Muon startup failed: project config does not exist: $MUON_PROJECT_CONFIG\" >&2\n    exit 1\n  fi\n  MUON_CONFIG_ARGS+=(\"-c\" \"$MUON_PROJECT_CONFIG\")\nfi\n\nif [[ ! -x \"$MUON_EXECUTABLE\" ]]; then\n  echo \"Muon startup failed: executable does not exist or is not executable: $MUON_EXECUTABLE\" >&2\n  exit 1\nfi\n\nif [[ ! -f \"$MUON_OVERRIDE_CONFIG\" ]]; then\n  echo \"Muon startup failed: generated override config does not exist: $MUON_OVERRIDE_CONFIG\" >&2\n  exit 1\nfi\nMUON_CONFIG_ARGS+=(\"-c\" \"$MUON_OVERRIDE_CONFIG\")\n\ncd \"$MUON_EXECUTABLE_DIRECTORY\"\nexec \"$MUON_EXECUTABLE\" \"\\${MUON_CONFIG_ARGS[@]}\"\n`;\n\nconst escapeWindowsCmdValue = (value: string): string =>\n  value.replaceAll(\"%\", \"%%\").replaceAll(\"\\r\", \"\").replaceAll(\"\\n\", \"\");\n\nconst getOptionalWindowsCmdValue = (value: string | undefined): string =>\n  value === undefined ? \"\" : escapeWindowsCmdValue(value);\n\nconst createWindowsMuonLaunchScript = ({\n  muonExecutablePath,\n  projectConfigPath,\n  overrideConfigPath,\n}: MuonLaunchScriptOptions): string => `@echo off\nsetlocal\nset \"MUON_EXECUTABLE=${escapeWindowsCmdValue(muonExecutablePath)}\"\nset \"MUON_EXECUTABLE_DIRECTORY=${escapeWindowsCmdValue(getPlatformDirectoryName(muonExecutablePath, \"win32\"))}\"\nset \"MUON_PROJECT_CONFIG=${getOptionalWindowsCmdValue(projectConfigPath)}\"\nset \"MUON_OVERRIDE_CONFIG=${escapeWindowsCmdValue(overrideConfigPath)}\"\n\nif not exist \"%MUON_EXECUTABLE%\" (\n  echo Muon startup failed: executable does not exist: %MUON_EXECUTABLE% 1>&2\n  exit /b 1\n)\n\nif not exist \"%MUON_OVERRIDE_CONFIG%\" (\n  echo Muon startup failed: generated override config does not exist: %MUON_OVERRIDE_CONFIG% 1>&2\n  exit /b 1\n)\n\npushd \"%MUON_EXECUTABLE_DIRECTORY%\"\nif defined MUON_PROJECT_CONFIG (\n  if not exist \"%MUON_PROJECT_CONFIG%\" (\n    echo Muon startup failed: project config does not exist: %MUON_PROJECT_CONFIG% 1>&2\n    popd\n    exit /b 1\n  )\n  \"%MUON_EXECUTABLE%\" -c \"%MUON_PROJECT_CONFIG%\" -c \"%MUON_OVERRIDE_CONFIG%\"\n) else (\n  \"%MUON_EXECUTABLE%\" -c \"%MUON_OVERRIDE_CONFIG%\"\n)\nset \"MUON_EXIT_CODE=%ERRORLEVEL%\"\npopd\nexit /b %MUON_EXIT_CODE%\n`;\n\nexport const createMuonLaunchScript = (\n  options: MuonLaunchScriptOptions,\n): string =>\n  options.platform === \"win32\"\n    ? createWindowsMuonLaunchScript(options)\n    : createPosixMuonLaunchScript(options);\n\nconst getBaseUrl = (server: ViteDevServer): string | undefined =>\n  server.resolvedUrls?.local[0] ?? server.resolvedUrls?.network[0];\n\nconst getStartUrl = (\n  server: ViteDevServer,\n  openValue: boolean | string,\n): string | undefined => {\n  const baseUrl = getBaseUrl(server);\n  if (baseUrl === undefined) {\n    return undefined;\n  }\n  return typeof openValue === \"string\"\n    ? new URL(openValue, baseUrl).href\n    : baseUrl;\n};\n\nconst getWebSocketOrigin = (startUrl: string): string => {\n  const url = new URL(startUrl);\n  if (url.protocol === \"https:\") {\n    url.protocol = \"wss:\";\n  } else if (url.protocol === \"http:\") {\n    url.protocol = \"ws:\";\n  }\n  return url.origin;\n};\n\nconst createMuonOverrideConfig = (startUrl: string): MuonOverrideConfig => {\n  const origin = new URL(startUrl).origin;\n  return {\n    browser: {\n      startPage: startUrl,\n      plugin: {\n        allow: [`${origin}/**`],\n      },\n    },\n    network: {\n      allow: [`${origin}/**`, `${getWebSocketOrigin(startUrl)}/**`],\n    },\n  };\n};\n\nconst writeMuonOverrideConfig = (\n  server: ViteDevServer,\n  openValue: boolean | string,\n  overrideConfigPath: string,\n): void => {\n  const startUrl = getStartUrl(server, openValue);\n  if (startUrl === undefined) {\n    server.config.logger.warn(\"Muon Vite plugin could not resolve a Vite URL.\");\n    return;\n  }\n  writeFileSync(\n    overrideConfigPath,\n    `${JSON.stringify(createMuonOverrideConfig(startUrl), null, 2)}\\n`,\n  );\n};\n\nconst createRuntimePaths = async (\n  server: ViteDevServer,\n  stagePath: string,\n  platform: NodeJS.Platform,\n  projectConfigPath: string | undefined,\n): Promise<MuonRuntimePaths> => {\n  const temporaryDirectory = await mkdtemp(join(tmpdir(), \"muon-vite-\"));\n  return {\n    temporaryDirectory,\n    launchScriptPath: join(\n      temporaryDirectory,\n      getLaunchScriptFileName(platform),\n    ),\n    overrideConfigPath: join(temporaryDirectory, \"muon.vite.json\"),\n    projectConfigPath,\n    muonExecutablePath: getMuonExecutablePath(stagePath, platform),\n  };\n};\n\nconst fileExists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst isJsonObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst getErrorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst resolveProjectConfigPath = async (\n  server: ViteDevServer,\n): Promise<string | undefined> => {\n  for (const fileName of defaultProjectConfigFileNames) {\n    const candidatePath = join(server.config.root, fileName);\n    if (!(await fileExists(candidatePath))) {\n      continue;\n    }\n\n    try {\n      const parsed = parse(await readFile(candidatePath, \"utf8\"));\n      if (!isJsonObject(parsed)) {\n        throw new Error(\"muon config root must be an object\");\n      }\n      return candidatePath;\n    } catch (error) {\n      server.config.logger.warn(\n        `Muon project config will be ignored because it could not be read or parsed: ${candidatePath}: ${getErrorMessage(error)}`,\n      );\n      return undefined;\n    }\n  }\n\n  server.config.logger.warn(\n    `Muon project config was not found in ${server.config.root}; launching with generated Vite config only.`,\n  );\n  return undefined;\n};\n\nconst writeLaunchScript = async (\n  paths: MuonRuntimePaths,\n  platform: NodeJS.Platform,\n): Promise<void> => {\n  await writeFile(\n    paths.launchScriptPath,\n    createMuonLaunchScript({\n      muonExecutablePath: paths.muonExecutablePath,\n      projectConfigPath: paths.projectConfigPath,\n      overrideConfigPath: paths.overrideConfigPath,\n      platform,\n    }),\n  );\n  if (platform !== \"win32\") {\n    await chmod(paths.launchScriptPath, 0o700);\n  }\n};\n\nexport const startMuonViteBrowserBridge = async ({\n  server,\n  pluginOptions,\n  platform,\n  architecture,\n  environment,\n}: MuonViteSessionOptions): Promise<void> => {\n  const openValue = getServerOpenValue(server);\n  if (openValue === false || server.httpServer === null) {\n    return;\n  }\n\n  const target = getDefaultMuonPrepareTarget(platform, architecture);\n  const muonPath = resolveMuonRuntimePath({\n    root: server.config.root,\n    target,\n    muonPath: pluginOptions.muonPath,\n  });\n  const cefPath =\n    pluginOptions.cefPath === undefined\n      ? undefined\n      : resolveFromRoot(server.config.root, pluginOptions.cefPath);\n  const stagePath =\n    pluginOptions.stagePath === undefined\n      ? resolve(server.config.root, \".muon\", target)\n      : resolveFromRoot(server.config.root, pluginOptions.stagePath);\n  const preparedRuntime = await runMuonPrepare({\n    muonPath,\n    cefPath,\n    stageDir: stagePath,\n    target,\n    cacheDir: environment.MUON_CACHE_DIR,\n    force: false,\n    quiet: false,\n    prepareExecutablePath: undefined,\n    environment,\n    cwd: server.config.root,\n  });\n  if (preparedRuntime.stagePath === undefined) {\n    throw new Error(\"muon-prepare did not return a staged runtime path.\");\n  }\n  const paths = await createRuntimePaths(\n    server,\n    preparedRuntime.stagePath,\n    platform,\n    await resolveProjectConfigPath(server),\n  );\n  await writeLaunchScript(paths, platform);\n  const previousBrowser = environment.BROWSER;\n  environment.BROWSER = paths.launchScriptPath;\n\n  let cleanupPromise: Promise<void> | undefined = undefined;\n  const cleanup = async (): Promise<void> => {\n    if (cleanupPromise !== undefined) {\n      return cleanupPromise;\n    }\n    cleanupPromise = (async () => {\n      if (previousBrowser === undefined) {\n        delete environment.BROWSER;\n      } else {\n        environment.BROWSER = previousBrowser;\n      }\n      await rm(paths.temporaryDirectory, { recursive: true, force: true });\n    })();\n    return cleanupPromise;\n  };\n\n  const originalClose = server.close.bind(server);\n  server.close = async (): Promise<void> => {\n    try {\n      await originalClose();\n    } finally {\n      await cleanup();\n    }\n  };\n  server.httpServer.once(\"close\", () => {\n    void cleanup();\n  });\n  server.httpServer.once(\"listening\", () => {\n    writeMuonOverrideConfig(server, openValue, paths.overrideConfigPath);\n  });\n};\n","// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon\n\nimport type { Plugin } from \"vite\";\nimport type { ResolvedConfig } from \"vite\";\nimport { isAbsolute, resolve } from \"node:path\";\n\nimport { buildMuonApp, type MuonBuildOptions } from \"./build.js\";\nimport { startMuonViteBrowserBridge } from \"./vite-internals.js\";\n\n/**\n * Options for generating Muon app distributions after Vite build.\n */\nexport interface MuonViteBuildOptions {\n  /**\n   * Target aliases or internal target names to build.\n   */\n  targets?: readonly string[];\n\n  /**\n   * Build every supported target from the installed package.\n   */\n  allTargets?: boolean;\n\n  /**\n   * File name used for the app launcher.\n   *\n   * @remarks The .exe suffix is added automatically for Windows targets.\n   */\n  appName?: string;\n\n  /**\n   * Parent directory that receives dist-linux-amd64/ style outputs.\n   */\n  outputRoot?: string;\n\n  /**\n   * Muon config path to embed.\n   */\n  configPath?: string;\n\n  /**\n   * Directory containing package runtime/ and native/ folders.\n   *\n   * @remarks This defaults to the installed muon package dist directory.\n   */\n  packageDirectory?: string;\n\n  /**\n   * Asset salt override for deterministic tests.\n   *\n   * @remarks Production builds should omit this option.\n   */\n  assetSalt?: Uint8Array;\n}\n\n/**\n * Options for the Muon Vite development plugin.\n */\nexport interface MuonVitePluginOptions {\n  /**\n   * Directory containing muon-core runtime files such as muon-core and plugins.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. When omitted,\n   * the packaged runtime at dist/runtime/<target> is used.\n   */\n  muonPath?: string;\n\n  /**\n   * Directory containing CEF files, or a CEF archive root with Release/Resources.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. When omitted,\n   * muon-prepare downloads and caches the tested CEF artifact from muonPath.\n   */\n  cefPath?: string;\n\n  /**\n   * Runtime staging directory used for development startup.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. Defaults to\n   * .muon/<target>.\n   */\n  stagePath?: string;\n\n  /**\n   * Build app distributions from Vite output.\n   *\n   * @remarks Defaults to true during Vite build. Set false to disable the build\n   * hook while keeping the development bridge enabled.\n   */\n  build?: boolean | MuonViteBuildOptions;\n}\n\n/**\n * Creates a Vite plugin that launches Muon through Vite's server.open flow.\n *\n * @param options Muon runtime location used for development startup.\n * @returns Vite plugin instance.\n */\nconst muon = (options: MuonVitePluginOptions = {}): Plugin => {\n  let resolvedConfig: ResolvedConfig | undefined = undefined;\n\n  return {\n    name: \"muon\",\n    configResolved: (config) => {\n      resolvedConfig = config;\n    },\n    configureServer: async (server) => {\n      await startMuonViteBrowserBridge({\n        server,\n        pluginOptions: options,\n        platform: process.platform,\n        architecture: process.arch,\n        environment: process.env,\n      });\n    },\n    closeBundle: async () => {\n      if (resolvedConfig === undefined || resolvedConfig.command !== \"build\") {\n        return;\n      }\n      if (options.build === false) {\n        return;\n      }\n\n      const buildOptions =\n        typeof options.build === \"object\" ? options.build : {};\n      await buildMuonApp(createMuonBuildOptions(resolvedConfig, buildOptions));\n    },\n  };\n};\n\nconst createMuonBuildOptions = (\n  config: ResolvedConfig,\n  buildOptions: MuonViteBuildOptions,\n): MuonBuildOptions => {\n  const outDir = isAbsolute(config.build.outDir)\n    ? config.build.outDir\n    : resolve(config.root, config.build.outDir);\n  const options: MuonBuildOptions = {\n    root: config.root,\n    assetSourcePath: outDir,\n    assetPrefix: \"main\",\n  };\n\n  if (buildOptions.allTargets !== undefined) {\n    options.allTargets = buildOptions.allTargets;\n  }\n  if (buildOptions.targets !== undefined) {\n    options.targets = buildOptions.targets;\n  }\n  if (buildOptions.appName !== undefined) {\n    options.appName = buildOptions.appName;\n  }\n  if (buildOptions.outputRoot !== undefined) {\n    options.outputRoot = buildOptions.outputRoot;\n  }\n  if (buildOptions.configPath !== undefined) {\n    options.configPath = buildOptions.configPath;\n  }\n  if (buildOptions.packageDirectory !== undefined) {\n    options.packageDirectory = buildOptions.packageDirectory;\n  }\n  if (buildOptions.assetSalt !== undefined) {\n    options.assetSalt = buildOptions.assetSalt;\n  }\n\n  return options;\n};\n\nexport default muon;\n"],"mappings":"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"}
+{"version":3,"file":"vite.cjs","names":[],"sources":["../src/vite.ts"],"sourcesContent":["// muon - Multi-platform GUI application framework that uses CEF as its backend\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/muon\n\nimport type { Plugin } from \"vite\";\nimport type { ResolvedConfig } from \"vite\";\nimport { isAbsolute, resolve } from \"node:path\";\n\nimport { buildMuonApp, type MuonBuildOptions } from \"./build.js\";\nimport { startMuonViteBrowserBridge } from \"./vite-internals.js\";\nimport { attachMuonVitePluginOptions } from \"./vite-options.js\";\n\n/**\n * Options for generating Muon app distributions after Vite build.\n */\nexport interface MuonViteBuildOptions {\n  /**\n   * Target aliases or internal target names to build.\n   */\n  targets?: readonly string[];\n\n  /**\n   * Build every supported target from the installed package.\n   */\n  allTargets?: boolean;\n\n  /**\n   * File name used for the app launcher.\n   *\n   * @remarks The .exe suffix is added automatically for Windows targets.\n   */\n  appName?: string;\n\n  /**\n   * Parent directory that receives dist-linux-amd64/ style outputs.\n   */\n  outputRoot?: string;\n\n  /**\n   * Muon config path to embed.\n   */\n  configPath?: string;\n\n  /**\n   * Directory containing package runtime/ and native/ folders.\n   *\n   * @remarks This defaults to the installed muon package dist directory.\n   */\n  packageDirectory?: string;\n\n  /**\n   * Asset salt override for deterministic tests.\n   *\n   * @remarks Production builds should omit this option.\n   */\n  assetSalt?: Uint8Array;\n}\n\n/**\n * Options for the Muon Vite development plugin.\n */\nexport interface MuonVitePluginOptions {\n  /**\n   * Directory containing muon-core runtime files such as muon-core and plugins.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. When omitted,\n   * the packaged runtime at dist/runtime/<target> is used.\n   */\n  muonPath?: string;\n\n  /**\n   * Directory containing CEF files, or a CEF archive root with Release/Resources.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. When omitted,\n   * muon-prepare downloads and caches the tested CEF artifact from muonPath.\n   */\n  cefPath?: string;\n\n  /**\n   * Runtime staging directory used for development startup.\n   *\n   * @remarks Relative paths are resolved from the Vite project root. Defaults to\n   * .muon/<target>.\n   */\n  stagePath?: string;\n\n  /**\n   * Launch Muon automatically during Vite dev startup.\n   *\n   * @remarks Defaults to true. This is independent from Vite's server.open\n   * browser startup option. Vite build ignores this option.\n   */\n  open?: boolean;\n\n  /**\n   * Enable the Muon debugger defaults during Vite dev startup.\n   *\n   * @remarks Defaults to true. When enabled, the generated development config\n   * enables CDP and binds DevTools to F12. Vite build ignores this option.\n   */\n  enableDebugger?: boolean;\n\n  /**\n   * Build app distributions from Vite output.\n   *\n   * @remarks Defaults to true during Vite build. Set false to disable the build\n   * hook while keeping the development bridge enabled.\n   */\n  build?: boolean | MuonViteBuildOptions;\n}\n\n/**\n * Creates a Vite plugin that launches Muon during Vite dev startup.\n *\n * @param options Muon plugin options used for development startup and build.\n * @returns Vite plugin instance.\n */\nconst muon = (options: MuonVitePluginOptions = {}): Plugin => {\n  let resolvedConfig: ResolvedConfig | undefined = undefined;\n\n  const plugin: Plugin = {\n    name: \"muon\",\n    configResolved: (config) => {\n      resolvedConfig = config;\n    },\n    configureServer: async (server) => {\n      await startMuonViteBrowserBridge({\n        server,\n        pluginOptions: options,\n        platform: process.platform,\n        architecture: process.arch,\n        environment: process.env,\n      });\n    },\n    closeBundle: async () => {\n      if (resolvedConfig === undefined || resolvedConfig.command !== \"build\") {\n        return;\n      }\n      if (options.build === false) {\n        return;\n      }\n\n      const buildOptions =\n        typeof options.build === \"object\" ? options.build : {};\n      await buildMuonApp(createMuonBuildOptions(resolvedConfig, buildOptions));\n    },\n  };\n\n  return attachMuonVitePluginOptions(plugin, options);\n};\n\nconst createMuonBuildOptions = (\n  config: ResolvedConfig,\n  buildOptions: MuonViteBuildOptions,\n): MuonBuildOptions => {\n  const outDir = isAbsolute(config.build.outDir)\n    ? config.build.outDir\n    : resolve(config.root, config.build.outDir);\n  const options: MuonBuildOptions = {\n    root: config.root,\n    assetSourcePath: outDir,\n    assetPrefix: \"main\",\n  };\n\n  if (buildOptions.allTargets !== undefined) {\n    options.allTargets = buildOptions.allTargets;\n  }\n  if (buildOptions.targets !== undefined) {\n    options.targets = buildOptions.targets;\n  }\n  if (buildOptions.appName !== undefined) {\n    options.appName = buildOptions.appName;\n  }\n  if (buildOptions.outputRoot !== undefined) {\n    options.outputRoot = buildOptions.outputRoot;\n  }\n  if (buildOptions.configPath !== undefined) {\n    options.configPath = buildOptions.configPath;\n  }\n  if (buildOptions.packageDirectory !== undefined) {\n    options.packageDirectory = buildOptions.packageDirectory;\n  }\n  if (buildOptions.assetSalt !== undefined) {\n    options.assetSalt = buildOptions.assetSalt;\n  }\n\n  return options;\n};\n\nexport default muon;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsHA,IAAM,QAAQ,UAAiC,CAAC,MAAc;CAC5D,IAAI,iBAA6C,KAAA;CA8BjD,OAAO,qBAAA,4BAA4B;EA3BjC,MAAM;EACN,iBAAiB,WAAW;GAC1B,iBAAiB;EACnB;EACA,iBAAiB,OAAO,WAAW;GACjC,MAAM,qBAAA,2BAA2B;IAC/B;IACA,eAAe;IACf,UAAU,QAAQ;IAClB,cAAc,QAAQ;IACtB,aAAa,QAAQ;GACvB,CAAC;EACH;EACA,aAAa,YAAY;GACvB,IAAI,mBAAmB,KAAA,KAAa,eAAe,YAAY,SAC7D;GAEF,IAAI,QAAQ,UAAU,OACpB;GAGF,MAAM,eACJ,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,CAAC;GACvD,MAAM,qBAAA,aAAa,uBAAuB,gBAAgB,YAAY,CAAC;EACzE;CAGiC,GAAQ,OAAO;AACpD;AAEA,IAAM,0BACJ,QACA,iBACqB;CACrB,MAAM,UAAA,GAAA,UAAA,YAAoB,OAAO,MAAM,MAAM,IACzC,OAAO,MAAM,UAAA,GAAA,UAAA,SACL,OAAO,MAAM,OAAO,MAAM,MAAM;CAC5C,MAAM,UAA4B;EAChC,MAAM,OAAO;EACb,iBAAiB;EACjB,aAAa;CACf;CAEA,IAAI,aAAa,eAAe,KAAA,GAC9B,QAAQ,aAAa,aAAa;CAEpC,IAAI,aAAa,YAAY,KAAA,GAC3B,QAAQ,UAAU,aAAa;CAEjC,IAAI,aAAa,YAAY,KAAA,GAC3B,QAAQ,UAAU,aAAa;CAEjC,IAAI,aAAa,eAAe,KAAA,GAC9B,QAAQ,aAAa,aAAa;CAEpC,IAAI,aAAa,eAAe,KAAA,GAC9B,QAAQ,aAAa,aAAa;CAEpC,IAAI,aAAa,qBAAqB,KAAA,GACpC,QAAQ,mBAAmB,aAAa;CAE1C,IAAI,aAAa,cAAc,KAAA,GAC7B,QAAQ,YAAY,aAAa;CAGnC,OAAO;AACT"}

package/dist/vite.mjs

@@ -1,11 +1,11 @@
 /*!
 * name: muon-ui
-* version: 0.2.0
+* version: 0.4.0
 * description: A multi-platform GUI application framework that uses CEF as its backend
 * author: Kouji Matsui (@kekyo@mi.kekyo.net)
 * license: MIT
 * repository.url: https://github.com/kekyo/muon-ui.git
-* git.commit.hash: 6251ff88aafa8ae873657f39aed1ebba2fa329a4
+* git.commit.hash: 44d549142c8cbfa13cb29d10be2568652a68bf50
 */
 import { basename, dirname, isAbsolute, join, relative, resolve, sep, win32 } from "node:path";
 import { constants, writeFileSync } from "node:fs";
@@ -1769,7 +1769,7 @@ var defaultConfigFileNames = [
 	"muon.jsonc",
 	"muon.json"
 ];
-var appConfigFromPath = "./assets.zip";
+var appConfigSourcePath = "./assets.zip";
 var defaultAppName = "muon-app";
 var muonLicenseFileName = "LICENSE_muon";
 var directoryMode = 493;
@@ -1833,7 +1833,7 @@ var resolveBuildTargets = (options) => {
 	return [getDefaultMuonBuildTarget()];
 };
 var resolveAssetInput = (root, assetSourcePath, assetPrefix, buildConfig) => {
-	const configuredAssetSourcePath = assetSourcePath === void 0 ? readConfigAssetFrom(buildConfig.config) : void 0;
+	const configuredAssetSourcePath = assetSourcePath === void 0 ? readConfigAssetSourcePath(buildConfig.config) : void 0;
 	return {
 		sourcePath: assetSourcePath !== void 0 ? resolve(root, assetSourcePath) : configuredAssetSourcePath !== void 0 ? resolve(buildConfig.directory, configuredAssetSourcePath) : resolve(root, "assets"),
 		prefix: normalizeZipPrefix(assetPrefix ?? "")
@@ -1864,14 +1864,14 @@ var readBuildConfig = async (root, configPath) => {
 		directory: dirname(resolvedConfigPath)
 	};
 };
-var readConfigAssetFrom = (sourceConfig) => {
+var readConfigAssetSourcePath = (sourceConfig) => {
 	const sourceAsset = sourceConfig.asset;
 	if (sourceAsset === void 0) return;
 	if (!isJsonObject$1(sourceAsset)) throw new Error("muon.json asset must be an object when present.");
-	const sourceAssetFrom = sourceAsset.from;
-	if (sourceAssetFrom === void 0) return;
-	if (typeof sourceAssetFrom !== "string") throw new Error("muon.json asset.from must be a string when present.");
-	return sourceAssetFrom;
+	const sourceAssetPath = sourceAsset.sourcePath;
+	if (sourceAssetPath === void 0) return;
+	if (typeof sourceAssetPath !== "string") throw new Error("muon.json asset.sourcePath must be a string when present.");
+	return sourceAssetPath;
 };
 var resolveConfigPath = async (root, configPath) => {
 	if (configPath !== void 0) {
@@ -2023,7 +2023,7 @@ var createEmbeddedConfig = (sourceConfig, asset) => {
 		...sourceConfig,
 		asset: {
 			...sourceAsset ?? {},
-			from: appConfigFromPath,
+			sourcePath: appConfigSourcePath,
 			signature: asset.signature,
 			salt: asset.salt
 		}
@@ -2070,11 +2070,37 @@ var isJsonObject$1 = (value) => {
 };
 var getErrorMessage$1 = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
-//#region src/vite-internals.ts
-var getServerOpenValue = (server) => {
-	const open = server.config.server.open;
-	return open === true || typeof open === "string" ? open : false;
+//#region src/gitignore.ts
+var muonGitignoreEntry = ".muon/";
+var isMissingFileError = (error) => error instanceof Error && error.code === "ENOENT";
+var hasMuonGitignoreEntry = (content) => content.split(/\r?\n/).map((line) => line.trim()).some((line) => line === muonGitignoreEntry || line === `/${muonGitignoreEntry}` || line === ".muon" || line === "/.muon");
+/**
+* Adds the Muon staging directory to a project .gitignore file.
+*
+* @param root Project root containing the .gitignore file.
+* @returns Gitignore update result.
+*/
+var ensureMuonGitignoreEntry = async (root) => {
+	const gitignorePath = join(root, ".gitignore");
+	let content = "";
+	try {
+		content = await readFile(gitignorePath, "utf8");
+	} catch (error) {
+		if (!isMissingFileError(error)) throw error;
+	}
+	if (hasMuonGitignoreEntry(content)) return {
+		gitignorePath,
+		changed: false
+	};
+	const separator = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+	await writeFile(gitignorePath, `${content}${separator}${muonGitignoreEntry}\n`);
+	return {
+		gitignorePath,
+		changed: true
+	};
 };
+//#endregion
+//#region src/vite-internals.ts
 var resolveFromRoot = (root, path) => isAbsolute(path) ? path : resolve(root, path);
 var moduleDirectory = typeof __dirname === "string" ? __dirname : dirname(fileURLToPath(import.meta.url));
 var defaultProjectConfigFileNames = [
@@ -2082,6 +2108,7 @@ var defaultProjectConfigFileNames = [
 	"muon.jsonc",
 	"muon.json"
 ];
+var muonRecycleExitCode = 88;
 /**
 * Resolves the muon-core runtime directory used by the Vite plugin.
 *
@@ -2096,6 +2123,7 @@ var getPlatformDirectoryName = (path, platform) => platform === "win32" ? win32.
 var getOptionalPosixValue = (value) => value === void 0 ? "''" : quotePosix(value);
 var createPosixMuonLaunchScript = ({ muonExecutablePath, projectConfigPath, overrideConfigPath }) => `#!/usr/bin/env bash
 set -euo pipefail
+MUON_RECYCLE_EXIT_CODE=${muonRecycleExitCode}
 MUON_EXECUTABLE=${quotePosix(muonExecutablePath)}
 MUON_EXECUTABLE_DIRECTORY=${quotePosix(getPlatformDirectoryName(muonExecutablePath, "linux"))}
 MUON_PROJECT_CONFIG=${getOptionalPosixValue(projectConfigPath)}
@@ -2122,12 +2150,21 @@ fi
 MUON_CONFIG_ARGS+=("-c" "$MUON_OVERRIDE_CONFIG")
 
 cd "$MUON_EXECUTABLE_DIRECTORY"
-exec "$MUON_EXECUTABLE" "\${MUON_CONFIG_ARGS[@]}"
+while true; do
+  set +e
+  "$MUON_EXECUTABLE" "\${MUON_CONFIG_ARGS[@]}"
+  MUON_EXIT_CODE=$?
+  set -e
+  if [[ "$MUON_EXIT_CODE" -ne "$MUON_RECYCLE_EXIT_CODE" ]]; then
+    exit "$MUON_EXIT_CODE"
+  fi
+done
 `;
 var escapeWindowsCmdValue = (value) => value.replaceAll("%", "%%").replaceAll("\r", "").replaceAll("\n", "");
 var getOptionalWindowsCmdValue = (value) => value === void 0 ? "" : escapeWindowsCmdValue(value);
 var createWindowsMuonLaunchScript = ({ muonExecutablePath, projectConfigPath, overrideConfigPath }) => `@echo off
 setlocal
+set "MUON_RECYCLE_EXIT_CODE=${muonRecycleExitCode}"
 set "MUON_EXECUTABLE=${escapeWindowsCmdValue(muonExecutablePath)}"
 set "MUON_EXECUTABLE_DIRECTORY=${escapeWindowsCmdValue(getPlatformDirectoryName(muonExecutablePath, "win32"))}"
 set "MUON_PROJECT_CONFIG=${getOptionalWindowsCmdValue(projectConfigPath)}"
@@ -2144,6 +2181,7 @@ if not exist "%MUON_OVERRIDE_CONFIG%" (
 )
 
 pushd "%MUON_EXECUTABLE_DIRECTORY%"
+:muon_recycle_loop
 if defined MUON_PROJECT_CONFIG (
   if not exist "%MUON_PROJECT_CONFIG%" (
     echo Muon startup failed: project config does not exist: %MUON_PROJECT_CONFIG% 1>&2
@@ -2155,39 +2193,41 @@ if defined MUON_PROJECT_CONFIG (
   "%MUON_EXECUTABLE%" -c "%MUON_OVERRIDE_CONFIG%"
 )
 set "MUON_EXIT_CODE=%ERRORLEVEL%"
+if "%MUON_EXIT_CODE%"=="%MUON_RECYCLE_EXIT_CODE%" goto muon_recycle_loop
 popd
 exit /b %MUON_EXIT_CODE%
 `;
 var createMuonLaunchScript = (options) => options.platform === "win32" ? createWindowsMuonLaunchScript(options) : createPosixMuonLaunchScript(options);
 var getBaseUrl = (server) => server.resolvedUrls?.local[0] ?? server.resolvedUrls?.network[0];
-var getStartUrl = (server, openValue) => {
-	const baseUrl = getBaseUrl(server);
-	if (baseUrl === void 0) return;
-	return typeof openValue === "string" ? new URL(openValue, baseUrl).href : baseUrl;
-};
 var getWebSocketOrigin = (startUrl) => {
 	const url = new URL(startUrl);
 	if (url.protocol === "https:") url.protocol = "wss:";
 	else if (url.protocol === "http:") url.protocol = "ws:";
 	return url.origin;
 };
-var createMuonOverrideConfig = (startUrl) => {
+var createMuonOverrideConfig = (startUrl, enableDebugger) => {
 	const origin = new URL(startUrl).origin;
 	return {
+		...enableDebugger ? { cdp: { enable: true } } : {},
 		browser: {
 			startPage: startUrl,
+			...enableDebugger ? { keybind: {
+				devtools: "f12",
+				recycle: "ctrl+f12"
+			} } : {},
 			plugin: { allow: [`${origin}/**`] }
 		},
 		network: { allow: [`${origin}/**`, `${getWebSocketOrigin(startUrl)}/**`] }
 	};
 };
-var writeMuonOverrideConfig = (server, openValue, overrideConfigPath) => {
-	const startUrl = getStartUrl(server, openValue);
+var writeMuonOverrideConfig = (server, overrideConfigPath, enableDebugger) => {
+	const startUrl = getBaseUrl(server);
 	if (startUrl === void 0) {
 		server.config.logger.warn("Muon Vite plugin could not resolve a Vite URL.");
-		return;
+		return false;
 	}
-	writeFileSync(overrideConfigPath, `${JSON.stringify(createMuonOverrideConfig(startUrl), null, 2)}\n`);
+	writeFileSync(overrideConfigPath, `${JSON.stringify(createMuonOverrideConfig(startUrl, enableDebugger), null, 2)}\n`);
+	return true;
 };
 var createRuntimePaths = async (server, stagePath, platform, projectConfigPath) => {
 	const temporaryDirectory = await mkdtemp(join(tmpdir(), "muon-vite-"));
@@ -2232,9 +2272,26 @@ var writeLaunchScript = async (paths, platform) => {
 	}));
 	if (platform !== "win32") await chmod(paths.launchScriptPath, 448);
 };
+var quoteWindowsCommandArgument = (value) => `"${value.replaceAll("\"", "\\\"")}"`;
+var launchMuon = (paths, platform, server) => {
+	const child = spawn(platform === "win32" ? "cmd.exe" : paths.launchScriptPath, platform === "win32" ? [
+		"/d",
+		"/s",
+		"/c",
+		quoteWindowsCommandArgument(paths.launchScriptPath)
+	] : [], {
+		detached: true,
+		stdio: "ignore",
+		windowsHide: false
+	});
+	child.once("error", (error) => {
+		server.config.logger.warn(`Muon startup failed: ${getErrorMessage(error)}`);
+	});
+	child.unref();
+};
 var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, architecture, environment }) => {
-	const openValue = getServerOpenValue(server);
-	if (openValue === false || server.httpServer === null) return;
+	await ensureMuonGitignoreEntry(server.config.root);
+	if (pluginOptions.open === false || server.httpServer === null) return;
 	const target = getDefaultMuonPrepareTarget(platform, architecture);
 	const preparedRuntime = await runMuonPrepare({
 		muonPath: resolveMuonRuntimePath({
@@ -2255,14 +2312,10 @@ var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, archi
 	if (preparedRuntime.stagePath === void 0) throw new Error("muon-prepare did not return a staged runtime path.");
 	const paths = await createRuntimePaths(server, preparedRuntime.stagePath, platform, await resolveProjectConfigPath(server));
 	await writeLaunchScript(paths, platform);
-	const previousBrowser = environment.BROWSER;
-	environment.BROWSER = paths.launchScriptPath;
 	let cleanupPromise = void 0;
 	const cleanup = async () => {
 		if (cleanupPromise !== void 0) return cleanupPromise;
 		cleanupPromise = (async () => {
-			if (previousBrowser === void 0) delete environment.BROWSER;
-			else environment.BROWSER = previousBrowser;
 			await rm(paths.temporaryDirectory, {
 				recursive: true,
 				force: true
@@ -2282,20 +2335,42 @@ var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, archi
 		cleanup();
 	});
 	server.httpServer.once("listening", () => {
-		writeMuonOverrideConfig(server, openValue, paths.overrideConfigPath);
+		if (writeMuonOverrideConfig(server, paths.overrideConfigPath, pluginOptions.enableDebugger !== false)) launchMuon(paths, platform, server);
 	});
 };
 //#endregion
+//#region src/vite-options.ts
+/**
+* Metadata symbol used to recover `muon()` plugin options from `vite.config.*`.
+*/
+var muonVitePluginOptionsSymbol = Symbol.for("muon.vite.plugin.options");
+/**
+* Attaches raw Muon Vite plugin options to a plugin instance.
+*
+* @param plugin Plugin object.
+* @param options Raw plugin options.
+* @returns Plugin object with internal Muon metadata.
+*/
+var attachMuonVitePluginOptions = (plugin, options) => {
+	Object.defineProperty(plugin, muonVitePluginOptionsSymbol, {
+		configurable: false,
+		enumerable: false,
+		value: { ...options },
+		writable: false
+	});
+	return plugin;
+};
+//#endregion
 //#region src/vite.ts
 /**
-* Creates a Vite plugin that launches Muon through Vite's server.open flow.
+* Creates a Vite plugin that launches Muon during Vite dev startup.
 *
-* @param options Muon runtime location used for development startup.
+* @param options Muon plugin options used for development startup and build.
 * @returns Vite plugin instance.
 */
 var muon = (options = {}) => {
 	let resolvedConfig = void 0;
-	return {
+	return attachMuonVitePluginOptions({
 		name: "muon",
 		configResolved: (config) => {
 			resolvedConfig = config;
@@ -2315,7 +2390,7 @@ var muon = (options = {}) => {
 			const buildOptions = typeof options.build === "object" ? options.build : {};
 			await buildMuonApp(createMuonBuildOptions(resolvedConfig, buildOptions));
 		}
-	};
+	}, options);
 };
 var createMuonBuildOptions = (config, buildOptions) => {
 	const outDir = isAbsolute(config.build.outDir) ? config.build.outDir : resolve(config.root, config.build.outDir);