muon-ui 0.8.0 → 0.9.0

package/dist/{vite-internals-ChWiL2TL.cjs → vite-internals-HXgH7b5M.cjs}

@@ -1,11 +1,11 @@
 /*!
 * name: muon-ui
-* version: 0.8.0
+* version: 0.9.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: 9bb6148e155dab16c4ca441073b144e21981b038
+* git.commit.hash: 3437b522a51d8772713b72722b109c5ff30fc711
 */
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -148,6 +148,20 @@ Object.fromEntries(allMuonTargets.map((target) => [targetDescriptors[target].cef
 */
 var getMuonTargetDescriptor = (target) => targetDescriptors[target];
 /**
+* Returns the runtime app identifier embedded for one target distribution.
+*
+* @param appId Base sanitized application identifier.
+* @param target Public Muon target.
+* @returns Target runtime application identifier.
+*
+* @remarks Windows targets append their public architecture name so 32-bit and
+* 64-bit packages do not share runtime state or installer identities.
+*/
+var getMuonTargetRuntimeAppId = (appId, target) => {
+	const descriptor = getMuonTargetDescriptor(target);
+	return descriptor.os === "windows" ? `${appId}.${descriptor.arch}` : appId;
+};
+/**
 * Normalizes a user supplied public Muon target.
 *
 * @param target Target value supplied by the user.
@@ -1741,6 +1755,8 @@ var encodeTaggedBytes = (tag, bytes) => Buffer.concat([
 ]);
 var isJsonObject$4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isPath = (path, first, second) => path.length === 2 && path[0] === first && path[1] === second;
+var isPluginSignaturePath = (path) => path.length === 3 && path[0] === "plugin" && path[1] === "plugins" && path[2] === "signature";
+var isPluginSaltPath = (path) => path.length === 3 && path[0] === "plugin" && path[1] === "plugins" && path[2] === "salt";
 var isHexString = (value) => value.length % 2 === 0 && /^[0-9a-fA-F]*$/.test(value);
 var decodeHexString = (value) => {
 	const bytes = Buffer.alloc(value.length / 2);
@@ -1750,6 +1766,8 @@ var decodeHexString = (value) => {
 var encodeKnownBinaryString = (path, value) => {
 	if (isPath(path, "asset", "signature")) return value.length === 40 && isHexString(value) ? decodeHexString(value) : void 0;
 	if (isPath(path, "asset", "salt")) return isHexString(value) ? decodeHexString(value) : void 0;
+	if (isPluginSignaturePath(path)) return value.length === 40 && isHexString(value) ? decodeHexString(value) : void 0;
+	if (isPluginSaltPath(path)) return isHexString(value) ? decodeHexString(value) : void 0;
 	if (isPath(path, "browser", "backgroundColor")) {
 		const hex = value.startsWith("#") ? value.slice(1) : value;
 		return hex.length === 6 && isHexString(hex) ? decodeHexString(hex) : void 0;
@@ -1797,8 +1815,8 @@ var encodeMuonConfigTlv = (config) => encodeTlvValue(config, []);
 */
 var createMuonEmbeddedConfigSlot = (payload = void 0) => {
 	if (payload !== void 0 && payload.length > muonEmbeddedConfigPayloadCapacity) throw new Error(`Encoded muon config exceeds the embedded slot capacity: ${payload.length} > ${muonEmbeddedConfigPayloadCapacity}`);
-	const slot = createEmptySlot();
-	if (payload === void 0) return slot;
+	if (payload === void 0) return createEmptySlot();
+	const slot = (0, node_crypto.randomBytes)(muonEmbeddedConfigSlotSize);
 	Buffer.from(payload).copy(slot, 0);
 	return slot;
 };
@@ -1810,9 +1828,12 @@ var createMuonEmbeddedConfigSlot = (payload = void 0) => {
 */
 var createMuonBootstrapEmbeddedConfigSlot = (payload = void 0) => {
 	if (payload !== void 0 && payload.length > muonBootstrapEmbeddedConfigPayloadCapacity) throw new Error(`Encoded muon config exceeds the embedded bootstrap slot capacity: ${payload.length} > ${muonBootstrapEmbeddedConfigPayloadCapacity}`);
-	const slot = Buffer.alloc(muonBootstrapEmbeddedConfigSlotSize, 0);
-	muonBootstrapEmbeddedConfigEmptySlotMarker.copy(slot, 0);
-	if (payload === void 0) return slot;
+	if (payload === void 0) {
+		const slot = Buffer.alloc(muonBootstrapEmbeddedConfigSlotSize, 0);
+		muonBootstrapEmbeddedConfigEmptySlotMarker.copy(slot, 0);
+		return slot;
+	}
+	const slot = (0, node_crypto.randomBytes)(muonBootstrapEmbeddedConfigSlotSize);
 	Buffer.from(payload).copy(slot, 0);
 	return slot;
 };
@@ -1886,7 +1907,7 @@ var findMuonBootstrapEmbeddedConfigSlot = (content) => {
 	if (candidate === void 0) throw new Error("Embedded muon-bootstrap config slot was not found.");
 	return candidate;
 };
-var fileExists$4 = async (path) => {
+var fileExists$5 = async (path) => {
 	try {
 		return (await (0, node_fs_promises.stat)(path)).isFile();
 	} catch {
@@ -1902,10 +1923,10 @@ var resolveMuonConfigInputPath = async (configPath) => {
 			"muon.json"
 		]) {
 			const candidate = (0, node_path.join)(directory, fileName);
-			if (await fileExists$4(candidate)) return candidate;
+			if (await fileExists$5(candidate)) return candidate;
 		}
 	}
-	if (!await fileExists$4(configPath)) throw new Error(`muon config does not exist: ${configPath}`);
+	if (!await fileExists$5(configPath)) throw new Error(`muon config does not exist: ${configPath}`);
 	return configPath;
 };
 var readMuonConfigInput = async (configPath) => {
@@ -2192,6 +2213,68 @@ var createIco = (images) => {
 	return Buffer.concat([header, ...imageData]);
 };
 //#endregion
+//#region src/app-icon.ts
+/**
+* ZIP entry used for the generated static application icon asset.
+*/
+var appIconAssetEntryName = "main/.muon/app-icon.png";
+/**
+* Runtime asset URL injected as the generated initial title bar icon.
+*/
+var appIconAssetUrl = "asset://main/.muon/app-icon.png";
+/**
+* Creates a static application icon source from API or CLI options.
+*/
+var createAppIconOptionsSource = (iconPath, directory, label = "iconPath") => {
+	if (iconPath === void 0) return;
+	if (typeof iconPath !== "string") throw new Error(`${label} must be a string when present.`);
+	if (iconPath.trim() === "") return;
+	return {
+		iconPath: iconPath.trim(),
+		directory
+	};
+};
+/**
+* Reads the top-level `iconPath` from a Muon config object.
+*/
+var readConfigAppIconSource = (config, directory, label) => {
+	const value = config.iconPath;
+	if (value === void 0) return;
+	if (typeof value !== "string") throw new Error(`${label} iconPath must be a string when present.`);
+	return createAppIconOptionsSource(value, directory);
+};
+/**
+* Reads the top-level `iconPath` from project metadata.
+*/
+var readProjectAppIconSource = (projectJson, directory) => {
+	const value = projectJson.iconPath;
+	return typeof value === "string" ? createAppIconOptionsSource(value, directory) : void 0;
+};
+/**
+* Resolves and validates the first available static application icon source.
+*/
+var resolveMuonAppIconPath = async (sources) => {
+	for (const source of sources) {
+		const iconPath = resolveResourcePath$2(source.directory, source.iconPath);
+		await assertMuonAppIconPath(iconPath);
+		return iconPath;
+	}
+};
+var assertMuonAppIconPath = async (iconPath) => {
+	if ((0, node_path.extname)(iconPath).toLowerCase() !== ".png") throw new Error(`Muon app icon must be a .png file: ${iconPath}`);
+	if (!await fileExists$4(iconPath)) throw new Error(`Muon app icon does not exist: ${iconPath}`);
+	await createNormalizedIconPngData(await (0, node_fs_promises.readFile)(iconPath), iconPath, "Muon app icon");
+};
+var resolveResourcePath$2 = (directory, value) => (0, node_path.isAbsolute)(value) ? value : (0, node_path.resolve)(directory, value);
+var fileExists$4 = async (path) => {
+	try {
+		await (0, node_fs_promises.access)(path, node_fs.constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+};
+//#endregion
 //#region src/windows-resource.ts
 var defaultConfigFileNames$1 = [
 	"muon.json5",
@@ -2211,7 +2294,7 @@ var readMuonConfigForWindowsResource = async (root, configPath) => {
 		directory: root
 	};
 	return {
-		config: await readJsonObjectFile$1(resolvedConfigPath, "Muon config file"),
+		config: await readJsonObjectFile$2(resolvedConfigPath, "Muon config file"),
 		directory: (0, node_path.dirname)(resolvedConfigPath)
 	};
 };
@@ -2236,13 +2319,22 @@ var mergeMuonWindowsResourceOptions = (primary, fallback) => {
 * Resolves Windows resource metadata from options, config files, and package metadata.
 */
 var resolveMuonWindowsResource = async (input) => {
-	const projectJson = await readProjectJson(input.root);
-	const sources = [
+	const projectJson = await readProjectJson$1(input.root);
+	const windowsSources = [
 		createOptionsSource$1(input.options, input.root, "windowsResource"),
 		readConfigWindowsResourceSource(input.muonConfig, input.muonConfigDirectory, "muon.json"),
+		readConfigWindowsResourceSource(projectJson, input.root, "project.json")
+	].filter((source) => source !== void 0);
+	const sources = [
+		...windowsSources,
 		createProjectSource(projectJson, input.root),
 		createPackageSource(input.packageJson, input.root)
 	].filter((source) => source !== void 0);
+	const appIconSources = [
+		createAppIconOptionsSource(input.appIconPath, input.root),
+		readConfigAppIconSource(input.muonConfig, input.muonConfigDirectory, "muon.json"),
+		readProjectAppIconSource(projectJson, input.root)
+	].filter((source) => source !== void 0);
 	const productName = resolveStringField$1(sources, "productName", input.defaults.productName);
 	const fileDescription = resolveStringField$1(sources, "fileDescription", input.defaults.fileDescription);
 	const companyName = resolveStringField$1(sources, "companyName", input.defaults.companyName);
@@ -2252,7 +2344,7 @@ var resolveMuonWindowsResource = async (input) => {
 	const codePage = resolveNumericField(sources, "codePage", defaultCodePage);
 	const fixedVersion = normalizeWindowsVersion(version);
 	return {
-		iconPath: await resolveIconPath$1(sources, await resolveDefaultWindowsIcon(input.packageDirectory)),
+		iconPath: await resolveWindowsIconPath(windowsSources, appIconSources, await resolveDefaultWindowsIcon(input.packageDirectory)),
 		productName,
 		fileDescription,
 		companyName,
@@ -2289,15 +2381,24 @@ var isWindowsPeExecutable = async (path) => {
 * Applies resolved resource metadata to a Windows PE executable in place.
 */
 var updateWindowsPeResources = async (input) => {
+	return await updateWindowsPeResourceFile(input, createEngraverUpdate);
+};
+/**
+* Applies only resolved icon metadata to a Windows PE executable in place.
+*/
+var updateWindowsPeIconResource = async (input) => {
+	return await updateWindowsPeResourceFile(input, createEngraverIconUpdate);
+};
+var updateWindowsPeResourceFile = async (input, createUpdate) => {
 	if (!await isWindowsPeExecutable(input.executablePath)) return false;
 	const mode = (await (0, node_fs_promises.stat)(input.executablePath)).mode & 511;
 	const tempDirectory = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "muon-windows-resource-"));
 	const updatesJsonPath = (0, node_path.join)(tempDirectory, "updates.json");
 	const outputPath = (0, node_path.join)(tempDirectory, "output.exe");
-	const iconPath = input.resource.iconPath === void 0 ? void 0 : (0, node_path.join)(tempDirectory, "icon.ico");
+	const iconPath = (0, node_path.join)(tempDirectory, "icon.ico");
 	try {
-		if (input.resource.iconPath !== void 0 && iconPath !== void 0) await createWindowsIconFromPngFile(input.resource.iconPath, iconPath);
-		await (0, node_fs_promises.writeFile)(updatesJsonPath, `${JSON.stringify(createEngraverUpdate(input.resource, iconPath), null, 2)}\n`);
+		await createWindowsIconFromPngFile(input.resource.iconPath, iconPath);
+		await (0, node_fs_promises.writeFile)(updatesJsonPath, `${JSON.stringify(createUpdate(input.resource, iconPath), null, 2)}\n`);
 		await runMuonPrepareResourceUpdate({
 			inputPath: input.executablePath,
 			updatesJsonPath,
@@ -2338,13 +2439,15 @@ var createEngraverUpdate = (resource, iconPath) => {
 			},
 			strings
 		},
-		icons: iconPath === void 0 ? [] : [{
-			id: 1,
-			language: resource.language,
-			path: iconPath
-		}]
+		icons: createEngraverIcons(resource, iconPath)
 	};
 };
+var createEngraverIconUpdate = (resource, iconPath) => ({ icons: createEngraverIcons(resource, iconPath) });
+var createEngraverIcons = (resource, iconPath) => [{
+	id: 1,
+	language: resource.language,
+	path: iconPath
+}];
 var resolveConfigPath$1 = async (root, configPath) => {
 	if (configPath !== void 0) {
 		const resolvedPath = (0, node_path.resolve)(root, configPath);
@@ -2356,12 +2459,12 @@ var resolveConfigPath$1 = async (root, configPath) => {
 		if (await fileExists$3(candidatePath)) return candidatePath;
 	}
 };
-var readProjectJson = async (root) => {
+var readProjectJson$1 = async (root) => {
 	const projectJsonPath = (0, node_path.join)(root, "project.json");
 	if (!await fileExists$3(projectJsonPath)) return {};
-	return await readJsonObjectFile$1(projectJsonPath, "project.json");
+	return await readJsonObjectFile$2(projectJsonPath, "project.json");
 };
-var readJsonObjectFile$1 = async (filePath, label) => {
+var readJsonObjectFile$2 = async (filePath, label) => {
 	const parsed = (0, import_dist.parse)(await (0, node_fs_promises.readFile)(filePath, "utf8"));
 	if (!isJsonObject$3(parsed)) throw new Error(`${label} must contain a JSON object: ${filePath}`);
 	return parsed;
@@ -2383,7 +2486,6 @@ var readConfigWindowsResourceSource = (config, directory, label) => {
 };
 var createProjectSource = (projectJson, directory) => {
 	const topLevel = {};
-	copyStringField(projectJson, "iconPath", topLevel, "iconPath");
 	copyStringField(projectJson, "productName", topLevel, "productName");
 	copyStringField(projectJson, "name", topLevel, "productName");
 	copyStringField(projectJson, "fileDescription", topLevel, "fileDescription");
@@ -2459,33 +2561,35 @@ var resolveNumericField = (sources, field, fallback) => {
 	}
 	return fallback;
 };
-var resolveIconPath$1 = async (sources, defaultIconPath) => {
-	for (const source of sources) {
+var resolveWindowsIconPath = async (windowsSources, appIconSources, defaultIconPath) => {
+	for (const source of windowsSources) {
 		const value = source.options.iconPath;
 		if (value !== void 0 && value.trim() !== "") {
 			const iconPath = resolveResourcePath$1(source.directory, value);
-			await assertIconPath$1(iconPath, true);
+			await assertIconPath$1(iconPath);
 			return iconPath;
 		}
 	}
-	if (defaultIconPath !== void 0 && await fileExists$3(defaultIconPath)) {
-		await assertIconPath$1(defaultIconPath, false);
-		return defaultIconPath;
-	}
+	const appIconPath = await resolveMuonAppIconPath(appIconSources);
+	if (appIconPath !== void 0) return appIconPath;
+	await assertIconPath$1(defaultIconPath);
+	return defaultIconPath;
 };
-var assertIconPath$1 = async (iconPath, required) => {
+var assertIconPath$1 = async (iconPath) => {
 	if ((0, node_path.extname)(iconPath).toLowerCase() !== ".png") throw new Error(`Windows resource icon must be a .png file: ${iconPath}`);
-	if (required && !await fileExists$3(iconPath)) throw new Error(`Windows resource icon does not exist: ${iconPath}`);
-	if (await fileExists$3(iconPath)) await createNormalizedMuonIconPngData(await (0, node_fs_promises.readFile)(iconPath), iconPath);
+	if (!await fileExists$3(iconPath)) throw new Error(`Windows resource icon does not exist: ${iconPath}`);
+	await createNormalizedMuonIconPngData(await (0, node_fs_promises.readFile)(iconPath), iconPath);
 };
 var resolveDefaultWindowsIcon = async (packageDirectory) => {
+	const sourceIconPath = (0, node_path.join)(moduleDirectory$3, "..", "..", "images", "muon-256.png");
 	const candidates = [
-		(0, node_path.join)((0, node_path.resolve)(packageDirectory), "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$3, "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$3, "..", "dist", "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$3, "..", "..", "images", "muon-bootstrap-256.png")
+		(0, node_path.join)((0, node_path.resolve)(packageDirectory), "native", "muon-256.png"),
+		(0, node_path.join)(moduleDirectory$3, "native", "muon-256.png"),
+		(0, node_path.join)(moduleDirectory$3, "..", "dist", "native", "muon-256.png"),
+		sourceIconPath
 	];
 	for (const candidate of candidates) if (await fileExists$3(candidate)) return candidate;
+	return sourceIconPath;
 };
 var resolveResourcePath$1 = (directory, path) => {
 	return (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(directory, path);
@@ -2544,14 +2648,20 @@ var mergeMuonLinuxDesktopOptions = (primary, fallback) => {
 * package metadata.
 */
 var resolveMuonLinuxDesktop = async (input) => {
+	const projectJson = await readProjectJson(input.root);
 	const sources = [createOptionsSource(input.options, input.root, "linuxDesktop"), readConfigLinuxDesktopSource(input.muonConfig, input.muonConfigDirectory, "muon.json")].filter((source) => source !== void 0);
+	const appIconSources = [
+		createAppIconOptionsSource(input.appIconPath, input.root),
+		readConfigAppIconSource(input.muonConfig, input.muonConfigDirectory, "muon.json"),
+		readProjectAppIconSource(projectJson, input.root)
+	].filter((source) => source !== void 0);
 	return {
 		desktopId: sanitizeDesktopId(resolveStringField(sources, "desktopId", input.defaults.desktopId)),
 		name: resolveStringField(sources, "name", input.defaults.name),
 		comment: resolveStringField(sources, "comment", input.defaults.comment),
 		categories: resolveCategories(sources, input.defaults.categories),
 		startupNotify: resolveBooleanField(sources, "startupNotify", input.defaults.startupNotify),
-		iconPath: await resolveIconPath(sources, await resolveDefaultLinuxDesktopIcon(input.packageDirectory)),
+		iconPath: await resolveLinuxIconPath(sources, appIconSources, await resolveDefaultLinuxDesktopIcon(input.packageDirectory)),
 		iconFileName: defaultIconFileName,
 		configFileName: defaultDesktopConfigFileName
 	};
@@ -2616,6 +2726,16 @@ var quoteDesktopExecArgument = (value) => {
 	}
 	return `${escaped}"`;
 };
+var readJsonObjectFile$1 = async (filePath, label) => {
+	const parsed = (0, import_dist.parse)(await (0, node_fs_promises.readFile)(filePath, "utf8"));
+	if (!isJsonObject$2(parsed)) throw new Error(`${label} must contain a JSON object: ${filePath}`);
+	return parsed;
+};
+var readProjectJson = async (root) => {
+	const projectJsonPath = (0, node_path.join)(root, "project.json");
+	if (!await fileExists$2(projectJsonPath)) return {};
+	return await readJsonObjectFile$1(projectJsonPath, "project.json");
+};
 var createOptionsSource = (options, directory, label) => {
 	if (options === void 0) return;
 	return {
@@ -2678,7 +2798,7 @@ var resolveBooleanField = (sources, field, fallback) => {
 	}
 	return fallback;
 };
-var resolveIconPath = async (sources, defaultIconPath) => {
+var resolveLinuxIconPath = async (sources, appIconSources, defaultIconPath) => {
 	for (const source of sources) {
 		const value = source.options.iconPath;
 		if (value !== void 0 && value.trim() !== "") {
@@ -2687,6 +2807,8 @@ var resolveIconPath = async (sources, defaultIconPath) => {
 			return iconPath;
 		}
 	}
+	const appIconPath = await resolveMuonAppIconPath(appIconSources);
+	if (appIconPath !== void 0) return appIconPath;
 	if (defaultIconPath !== void 0 && await fileExists$2(defaultIconPath)) {
 		await assertIconPath(defaultIconPath, false);
 		return defaultIconPath;
@@ -2700,10 +2822,10 @@ var assertIconPath = async (iconPath, required) => {
 };
 var resolveDefaultLinuxDesktopIcon = async (packageDirectory) => {
 	const candidates = [
-		(0, node_path.join)((0, node_path.resolve)(packageDirectory), "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$2, "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$2, "..", "dist", "native", "muon-bootstrap.png"),
-		(0, node_path.join)(moduleDirectory$2, "..", "..", "images", "muon-bootstrap-256.png")
+		(0, node_path.join)((0, node_path.resolve)(packageDirectory), "native", "muon-256.png"),
+		(0, node_path.join)(moduleDirectory$2, "native", "muon-256.png"),
+		(0, node_path.join)(moduleDirectory$2, "..", "dist", "native", "muon-256.png"),
+		(0, node_path.join)(moduleDirectory$2, "..", "..", "images", "muon-256.png")
 	];
 	for (const candidate of candidates) if (await fileExists$2(candidate)) return candidate;
 };
@@ -2783,14 +2905,21 @@ var buildMuonApp = async (options = {}) => {
 	const appName = resolveAppName(packageJson, options.appName);
 	const appId = resolveAppId(packageJson, options.appId);
 	const buildConfig = await readBuildConfig(root, options.configPath);
-	const assetInput = resolveAssetInput(root, options.assetSourcePath, options.assetPrefix, buildConfig);
+	const sourceConfig = applyRuntimePluginConfig(buildConfig.config, options.runtimePluginConfig ?? { mode: "simple" });
+	assertNoUserInitialTitleBarIcon(sourceConfig);
+	const resolvedBuildConfig = {
+		...buildConfig,
+		config: sourceConfig
+	};
+	const assetInput = resolveAssetInput(root, options.assetSourcePath, options.assetPrefix, resolvedBuildConfig);
 	const windowsResource = await resolveMuonWindowsResource({
 		root,
 		packageDirectory,
 		packageJson,
-		muonConfig: buildConfig.config,
+		muonConfig: sourceConfig,
 		muonConfigDirectory: buildConfig.directory,
 		options: options.windowsResource,
+		appIconPath: options.iconPath,
 		defaults: {
 			productName: appName,
 			fileDescription: appName,
@@ -2802,9 +2931,10 @@ var buildMuonApp = async (options = {}) => {
 	const linuxDesktop = await resolveMuonLinuxDesktop({
 		root,
 		packageDirectory,
-		muonConfig: buildConfig.config,
+		muonConfig: sourceConfig,
 		muonConfigDirectory: buildConfig.directory,
 		options: options.linuxDesktop,
+		appIconPath: options.iconPath,
 		defaults: {
 			desktopId: appId,
 			name: resolveLinuxDesktopDefaultName(packageJson, appName),
@@ -2824,7 +2954,7 @@ var buildMuonApp = async (options = {}) => {
 			appId,
 			target,
 			assetInput,
-			sourceConfig: buildConfig.config,
+			sourceConfig,
 			windowsResource,
 			linuxDesktop,
 			salt
@@ -2897,6 +3027,19 @@ var readBuildConfig = async (root, configPath) => {
 		directory: (0, node_path.dirname)(resolvedConfigPath)
 	};
 };
+var applyRuntimePluginConfig = (sourceConfig, runtimePluginConfig) => {
+	if (runtimePluginConfig === void 0) return sourceConfig;
+	const sourcePlugin = sourceConfig.plugin;
+	if (sourcePlugin !== void 0 && !isJsonObject$1(sourcePlugin)) throw new Error("muon.json plugin must be an object when runtime plugin config is applied.");
+	const plugin = sourcePlugin ?? {};
+	return {
+		...sourceConfig,
+		plugin: {
+			...plugin,
+			...runtimePluginConfig
+		}
+	};
+};
 var readConfigAssetSourcePath = (sourceConfig) => {
 	const sourceAsset = sourceConfig.asset;
 	if (sourceAsset === void 0) return;
@@ -2940,6 +3083,8 @@ var buildMuonTarget = async (input) => {
 	const outputPath = (0, node_path.join)(input.outputRoot, descriptor.distributionDirectoryName);
 	const launcherPath = (0, node_path.join)(outputPath, getLauncherFileName(input.appName, descriptor));
 	const assetZipPath = (0, node_path.join)(outputPath, "assets.zip");
+	const runtimeAppId = getMuonTargetRuntimeAppId(input.appId, input.target);
+	const appIconPath = descriptor.os === "windows" ? input.windowsResource.iconPath : input.linuxDesktop.iconPath;
 	await verifyTargetInputs({
 		sourceRuntimePath,
 		sourceBootstrapPath,
@@ -2958,8 +3103,11 @@ var buildMuonTarget = async (input) => {
 	await (0, node_fs_promises.chmod)((0, node_path.join)(outputPath, descriptor.runtimeExecutableName), executableMode);
 	await (0, node_fs_promises.copyFile)(sourceBootstrapPath, launcherPath);
 	await (0, node_fs_promises.chmod)(launcherPath, executableMode);
-	const asset = await writeAssetArchive(input.assetInput, assetZipPath, input.salt);
-	const embeddedConfig = createEmbeddedConfig(input.sourceConfig, asset, input.appId, input.linuxDesktop.desktopId);
+	const asset = await writeAssetArchive(input.assetInput, assetZipPath, input.salt, [{
+		name: appIconAssetEntryName,
+		data: await (0, node_fs_promises.readFile)(appIconPath)
+	}]);
+	const embeddedConfig = createEmbeddedConfig(input.sourceConfig, asset, runtimeAppId, input.linuxDesktop.desktopId, appIconAssetUrl);
 	await withTemporaryConfig(embeddedConfig, async (configPath) => {
 		await embedMuonConfigInRuntime({
 			runtimePath: outputPath,
@@ -2972,19 +3120,27 @@ var buildMuonTarget = async (input) => {
 			outputPath: void 0
 		});
 	});
-	if (descriptor.os === "windows") await updateWindowsPeResources({
-		executablePath: launcherPath,
-		resource: input.windowsResource,
-		environment: process.env,
-		cwd: input.root
-	});
-	else if (descriptor.os === "linux") await writeLinuxDesktopDistributionFiles(outputPath, input.linuxDesktop);
+	if (descriptor.os === "windows") {
+		await updateWindowsPeIconResource({
+			executablePath: (0, node_path.join)(outputPath, descriptor.runtimeExecutableName),
+			resource: input.windowsResource,
+			environment: process.env,
+			cwd: input.root
+		});
+		await updateWindowsPeResources({
+			executablePath: launcherPath,
+			resource: input.windowsResource,
+			environment: process.env,
+			cwd: input.root
+		});
+	} else if (descriptor.os === "linux") await writeLinuxDesktopDistributionFiles(outputPath, input.linuxDesktop);
 	return {
 		target: input.target,
 		distributionDirectoryName: descriptor.distributionDirectoryName,
 		outputPath,
 		launcherPath,
 		asset,
+		runtimeAppId,
 		embeddedConfig,
 		...descriptor.os === "linux" ? { linuxDesktop: input.linuxDesktop } : {}
 	};
@@ -3007,10 +3163,10 @@ var copyRuntimeFiles = async (sourceRuntimePath, outputPath, descriptor) => {
 	}
 	await (0, node_fs_promises.copyFile)((0, node_path.join)(sourceRuntimePath, muonLicenseFileName), (0, node_path.join)(outputPath, muonLicenseFileName));
 };
-var writeAssetArchive = async (input, outputPath, salt) => {
+var writeAssetArchive = async (input, outputPath, salt, extraEntries) => {
 	const sourceStats = await statOrUndefined(input.sourcePath);
 	if (sourceStats === void 0) throw new Error(`Muon asset source does not exist: ${input.sourcePath}`);
-	const archive = sourceStats.isDirectory() ? await createAssetArchiveFromDirectory(input) : sourceStats.isFile() ? await (0, node_fs_promises.readFile)(input.sourcePath) : void 0;
+	const archive = sourceStats.isDirectory() ? await createAssetArchiveFromDirectory(input, extraEntries) : sourceStats.isFile() ? await createAssetArchiveFromZipFile(input.sourcePath, extraEntries) : void 0;
 	if (archive === void 0) throw new Error(`Muon asset source is not a directory or file: ${input.sourcePath}`);
 	await (0, node_fs_promises.writeFile)(outputPath, archive);
 	return {
@@ -3020,10 +3176,30 @@ var writeAssetArchive = async (input, outputPath, salt) => {
 		entryCount: sourceStats.isDirectory() ? readZipEntryCount(archive, outputPath) : readZipEntryCount(archive, input.sourcePath)
 	};
 };
-var createAssetArchiveFromDirectory = async (input) => {
+var createAssetArchiveFromDirectory = async (input, extraEntries) => {
 	const entries = await collectZipEntries(input.sourcePath, input.prefix);
 	if (entries.length === 0) throw new Error(`Muon asset source has no files: ${input.sourcePath}`);
-	return createZipArchive(entries);
+	return createZipArchive(appendZipEntries(entries, extraEntries));
+};
+var createAssetArchiveFromZipFile = async (sourcePath, extraEntries) => {
+	const zip = new AdmZip(await (0, node_fs_promises.readFile)(sourcePath));
+	for (const entry of extraEntries) {
+		assertSafeZipEntryName(entry.name);
+		if (zip.getEntry(entry.name) !== null) throw new Error(`Muon app icon asset entry already exists: ${entry.name}`);
+		zip.addFile(entry.name, entry.data);
+	}
+	return zip.toBuffer();
+};
+var appendZipEntries = (entries, extraEntries) => {
+	const output = [...entries];
+	const names = new Set(entries.map((entry) => entry.name));
+	for (const entry of extraEntries) {
+		assertSafeZipEntryName(entry.name);
+		if (names.has(entry.name)) throw new Error(`Muon app icon asset entry already exists: ${entry.name}`);
+		names.add(entry.name);
+		output.push(entry);
+	}
+	return output;
 };
 var readZipEntryCount = (archive, sourcePath) => {
 	const endSignature = 101010256;
@@ -3061,13 +3237,20 @@ var createZipArchive = (entries) => {
 	for (const entry of entries) zip.addFile(entry.name, entry.data);
 	return zip.toBuffer();
 };
-var createEmbeddedConfig = (sourceConfig, asset, appId, desktopId) => {
+var createEmbeddedConfig = (sourceConfig, asset, appId, desktopId, initialTitleBarIcon) => {
 	const sourceAsset = sourceConfig.asset;
 	if (sourceAsset !== void 0 && !isJsonObject$1(sourceAsset)) throw new Error("muon.json asset must be an object when present.");
 	const sourceBootstrap = sourceConfig.bootstrap;
 	if (sourceBootstrap !== void 0 && !isJsonObject$1(sourceBootstrap)) throw new Error("muon.json bootstrap must be an object when present.");
+	const runtimeConfig = stripBuildOnlyAppIconConfig(stripBuildOnlyLinuxDesktopConfig(stripBuildOnlyWindowsResourceConfig(sourceConfig)));
+	const sourceBrowser = runtimeConfig.browser;
+	if (sourceBrowser !== void 0 && !isJsonObject$1(sourceBrowser)) throw new Error("muon.json browser must be an object when present.");
 	return {
-		...stripBuildOnlyLinuxDesktopConfig(stripBuildOnlyWindowsResourceConfig(sourceConfig)),
+		...runtimeConfig,
+		browser: {
+			...sourceBrowser ?? {},
+			initialTitleBarIcon
+		},
 		asset: {
 			...sourceAsset ?? {},
 			sourcePath: appConfigSourcePath,
@@ -3081,6 +3264,17 @@ var createEmbeddedConfig = (sourceConfig, asset, appId, desktopId) => {
 		}
 	};
 };
+var assertNoUserInitialTitleBarIcon = (sourceConfig) => {
+	const sourceBrowser = sourceConfig.browser;
+	if (sourceBrowser === void 0) return;
+	if (!isJsonObject$1(sourceBrowser)) throw new Error("muon.json browser must be an object when present.");
+	if (sourceBrowser.initialTitleBarIcon !== void 0) throw new Error("muon.json browser.initialTitleBarIcon is generated by muon build; use top-level iconPath instead.");
+};
+var stripBuildOnlyAppIconConfig = (sourceConfig) => {
+	const output = {};
+	for (const [key, value] of Object.entries(sourceConfig)) if (key !== "iconPath") output[key] = value;
+	return output;
+};
 var withTemporaryConfig = async (config, callback) => {
 	const tempDirectory = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "muon-build-config-"));
 	const configPath = (0, node_path.join)(tempDirectory, "muon.json");
@@ -3139,11 +3333,23 @@ var isLinuxDesktopOptions = (value) => {
 };
 var isMuonViteBuildOptions = (value) => {
 	if (!isRecord(value)) return false;
-	return (value.targets === void 0 || isStringArray(value.targets)) && (value.allTargets === void 0 || typeof value.allTargets === "boolean") && (value.appName === void 0 || typeof value.appName === "string") && (value.appId === void 0 || typeof value.appId === "string") && (value.outputRoot === void 0 || typeof value.outputRoot === "string") && (value.configPath === void 0 || typeof value.configPath === "string") && (value.windowsResource === void 0 || isWindowsResourceOptions(value.windowsResource)) && (value.linuxDesktop === void 0 || isLinuxDesktopOptions(value.linuxDesktop)) && (value.packageDirectory === void 0 || typeof value.packageDirectory === "string") && (value.assetSalt === void 0 || value.assetSalt instanceof Uint8Array);
+	return (value.targets === void 0 || isStringArray(value.targets)) && (value.allTargets === void 0 || typeof value.allTargets === "boolean") && (value.appName === void 0 || typeof value.appName === "string") && (value.appId === void 0 || typeof value.appId === "string") && (value.outputRoot === void 0 || typeof value.outputRoot === "string") && (value.configPath === void 0 || typeof value.configPath === "string") && (value.iconPath === void 0 || typeof value.iconPath === "string") && (value.windowsResource === void 0 || isWindowsResourceOptions(value.windowsResource)) && (value.linuxDesktop === void 0 || isLinuxDesktopOptions(value.linuxDesktop)) && (value.packageDirectory === void 0 || typeof value.packageDirectory === "string") && (value.assetSalt === void 0 || value.assetSalt instanceof Uint8Array);
+};
+var isMuonVitePluginAccessImportOptions = (value) => {
+	if (!isRecord(value)) return false;
+	return (value.sources === void 0 || isStringArray(value.sources)) && (value.packages === void 0 || isStringArray(value.packages)) && (value.allow === void 0 || isStringArray(value.allow));
+};
+var isMuonVitePluginAccessEntryOptions = (value) => {
+	if (!isRecord(value)) return false;
+	return typeof value.name === "string" && (value.signature === void 0 || typeof value.signature === "string") && (value.salt === void 0 || typeof value.salt === "string") && (value.allow === void 0 || isStringArray(value.allow)) && (value.imports === void 0 || Array.isArray(value.imports) && value.imports.every(isMuonVitePluginAccessImportOptions));
+};
+var isMuonVitePluginAccessOptions = (value) => {
+	if (!isRecord(value)) return false;
+	return (value.path === void 0 || typeof value.path === "string") && (value.mode === void 0 || value.mode === "simple" || value.mode === "validate") && (value.pages === void 0 || isStringArray(value.pages)) && (value.plugins === void 0 || Array.isArray(value.plugins) && value.plugins.every(isMuonVitePluginAccessEntryOptions));
 };
 var isMuonVitePluginOptions = (value) => {
 	if (!isRecord(value)) return false;
-	return (value.muonPath === void 0 || typeof value.muonPath === "string") && (value.cefPath === void 0 || typeof value.cefPath === "string") && (value.stagePath === void 0 || typeof value.stagePath === "string") && (value.open === void 0 || typeof value.open === "boolean") && (value.enableDebugger === void 0 || typeof value.enableDebugger === "boolean") && (value.build === void 0 || typeof value.build === "boolean" || isMuonViteBuildOptions(value.build));
+	return (value.muonPath === void 0 || typeof value.muonPath === "string") && (value.cefPath === void 0 || typeof value.cefPath === "string") && (value.stagePath === void 0 || typeof value.stagePath === "string") && (value.open === void 0 || typeof value.open === "boolean") && (value.enableDebugger === void 0 || typeof value.enableDebugger === "boolean") && (value.pluginAccess === void 0 || value.pluginAccess === false || isMuonVitePluginAccessOptions(value.pluginAccess)) && (value.build === void 0 || typeof value.build === "boolean" || isMuonViteBuildOptions(value.build));
 };
 /**
 * Attaches raw Muon Vite plugin options to a plugin instance.
@@ -3276,6 +3482,7 @@ var copyDefinedBuildOptions = (output, input, usesViteAssets) => {
 	if (input.appId !== void 0) output.appId = input.appId;
 	if (input.outputRoot !== void 0) output.outputRoot = input.outputRoot;
 	if (input.configPath !== void 0) output.configPath = input.configPath;
+	if (input.iconPath !== void 0) output.iconPath = input.iconPath;
 	if (input.windowsResource !== void 0) {
 		const windowsResource = mergeMuonWindowsResourceOptions(input.windowsResource, output.windowsResource);
 		if (windowsResource !== void 0) output.windowsResource = windowsResource;
@@ -3411,7 +3618,7 @@ var getWebSocketOrigin = (startUrl) => {
 	else if (url.protocol === "http:") url.protocol = "ws:";
 	return url.origin;
 };
-var createMuonOverrideConfig = (startUrl, enableDebugger) => {
+var createMuonOverrideConfig = (startUrl, enableDebugger, runtimePluginConfig) => {
 	const origin = new URL(startUrl).origin;
 	return {
 		...enableDebugger ? { cdp: { enable: true } } : {},
@@ -3420,19 +3627,22 @@ var createMuonOverrideConfig = (startUrl, enableDebugger) => {
 			...enableDebugger ? { keybind: {
 				devtools: "f12",
 				recycle: "ctrl+f12"
-			} } : {},
-			plugin: { allow: [`${origin}/**`] }
+			} } : {}
+		},
+		plugin: {
+			...runtimePluginConfig,
+			pages: [`${origin}/**`]
 		},
 		network: { allow: [`${origin}/**`, `${getWebSocketOrigin(startUrl)}/**`] }
 	};
 };
-var writeMuonOverrideConfig = (server, overrideConfigPath, enableDebugger) => {
+var writeMuonOverrideConfig = (server, overrideConfigPath, pluginOptions, getRuntimePluginConfig) => {
 	const startUrl = getBaseUrl(server);
 	if (startUrl === void 0) {
 		server.config.logger.warn("Muon Vite plugin could not resolve a Vite URL.");
 		return false;
 	}
-	(0, node_fs.writeFileSync)(overrideConfigPath, `${JSON.stringify(createMuonOverrideConfig(startUrl, enableDebugger), null, 2)}\n`);
+	(0, node_fs.writeFileSync)(overrideConfigPath, `${JSON.stringify(createMuonOverrideConfig(startUrl, pluginOptions.enableDebugger !== false, getRuntimePluginConfig()), null, 2)}\n`);
 	return true;
 };
 var createRuntimePaths = async (server, stagePath, platform, projectConfigPath) => {
@@ -3495,7 +3705,7 @@ var launchMuon = (paths, platform, server) => {
 	});
 	child.unref();
 };
-var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, architecture, environment }) => {
+var startMuonViteBrowserBridge = async ({ server, pluginOptions, getRuntimePluginConfig, platform, architecture, environment }) => {
 	await ensureMuonGitignoreEntry(server.config.root);
 	if (pluginOptions.open === false || server.httpServer === null) return;
 	const target = getDefaultMuonPrepareTarget(platform, architecture);
@@ -3541,7 +3751,7 @@ var startMuonViteBrowserBridge = async ({ server, pluginOptions, platform, archi
 		cleanup();
 	});
 	server.httpServer.once("listening", () => {
-		if (writeMuonOverrideConfig(server, paths.overrideConfigPath, pluginOptions.enableDebugger !== false)) launchMuon(paths, platform, server);
+		if (writeMuonOverrideConfig(server, paths.overrideConfigPath, pluginOptions, getRuntimePluginConfig)) launchMuon(paths, platform, server);
 	});
 };
 //#endregion
@@ -3725,6 +3935,12 @@ Object.defineProperty(exports, "startMuonViteBrowserBridge", {
 		return startMuonViteBrowserBridge;
 	}
 });
+Object.defineProperty(exports, "updateWindowsPeIconResource", {
+	enumerable: true,
+	get: function() {
+		return updateWindowsPeIconResource;
+	}
+});
 Object.defineProperty(exports, "updateWindowsPeResources", {
 	enumerable: true,
 	get: function() {
@@ -3732,4 +3948,4 @@ Object.defineProperty(exports, "updateWindowsPeResources", {
 	}
 });
 
-//# sourceMappingURL=vite-internals-ChWiL2TL.cjs.map
+//# sourceMappingURL=vite-internals-HXgH7b5M.cjs.map