muon-ui 0.1.0 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@ A multi-platform GUI application framework that uses CEF as its backend.
 
 ![muon](./images/muon-120.png)
 
-[![Project Status: Concept – Minimal or no implementation has been done yet, or the repository is only intended to be a limited example, demo, or proof-of-concept.](https://www.repostatus.org/badges/latest/concept.svg)](https://www.repostatus.org/#concept)
+[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---

package/dist/{build-CCuZpajl.cjs → build-xwfaxosJ.cjs}

@@ -1,11 +1,11 @@
 /*!
 * name: muon-ui
-* version: 0.1.0
+* version: 0.3.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: 35f9658786642562593735d3b589c1d7ab270ecf
+* git.commit.hash: e3c2c87d50dddb0bf6c2b4d5ebf0a37ab2d3b433
 */
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -137,8 +137,38 @@ var runMuonPrepare = async (options) => {
 	};
 };
 //#endregion
-//#region src/embed-config.ts
-var import_dist = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
+//#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 = (0, node_path.join)(root, ".gitignore");
+	let content = "";
+	try {
+		content = await (0, node_fs_promises.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 (0, node_fs_promises.writeFile)(gitignorePath, `${content}${separator}${muonGitignoreEntry}\n`);
+	return {
+		gitignorePath,
+		changed: true
+	};
+};
+//#endregion
+//#region ../node_modules/json5/dist/index.js
+var require_dist = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	(function(global, factory) {
 		typeof exports === "object" && typeof module !== "undefined" ? module.exports = factory() : typeof define === "function" && define.amd ? define(factory) : global.JSON5 = factory();
 	})(exports, (function() {
@@ -1295,7 +1325,10 @@ var import_dist = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 		};
 	}));
-})))();
+}));
+//#endregion
+//#region src/embed-config.ts
+var import_dist = require_dist();
 /**
 * Fixed byte size reserved in muon-core for an embedded muon.json payload.
 */
@@ -1790,8 +1823,9 @@ 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;
 var executableMode = 493;
 var assetSaltByteLength = 16;
@@ -1821,8 +1855,8 @@ var buildMuonApp = async (options = {}) => {
 	const targets = resolveBuildTargets(options);
 	const outputRoot = (0, node_path.resolve)(root, options.outputRoot ?? ".");
 	const appName = await resolveAppName(root, options.appName);
-	const assetInput = resolveAssetInput(root, options.assetSourcePath, options.assetPrefix);
-	const sourceConfig = await readBuildConfig(root, options.configPath);
+	const buildConfig = await readBuildConfig(root, options.configPath);
+	const assetInput = resolveAssetInput(root, options.assetSourcePath, options.assetPrefix, buildConfig);
 	const salt = Buffer.from(options.assetSalt ?? (0, node_crypto.randomBytes)(assetSaltByteLength));
 	const results = [];
 	for (const target of targets) {
@@ -1832,7 +1866,7 @@ var buildMuonApp = async (options = {}) => {
 			appName,
 			target,
 			assetInput,
-			sourceConfig,
+			sourceConfig: buildConfig.config,
 			salt
 		});
 		results.push(result);
@@ -1852,9 +1886,10 @@ var resolveBuildTargets = (options) => {
 	if (options.targets !== void 0 && options.targets.length > 0) return [...new Set(options.targets.map((target) => normalizeMuonBuildTarget(target)))];
 	return [getDefaultMuonBuildTarget()];
 };
-var resolveAssetInput = (root, assetSourcePath, assetPrefix) => {
+var resolveAssetInput = (root, assetSourcePath, assetPrefix, buildConfig) => {
+	const configuredAssetSourcePath = assetSourcePath === void 0 ? readConfigAssetSourcePath(buildConfig.config) : void 0;
 	return {
-		sourcePath: (0, node_path.resolve)(root, assetSourcePath ?? "assets"),
+		sourcePath: assetSourcePath !== void 0 ? (0, node_path.resolve)(root, assetSourcePath) : configuredAssetSourcePath !== void 0 ? (0, node_path.resolve)(buildConfig.directory, configuredAssetSourcePath) : (0, node_path.resolve)(root, "assets"),
 		prefix: normalizeZipPrefix(assetPrefix ?? "")
 	};
 };
@@ -1864,7 +1899,7 @@ var normalizeZipPrefix = (prefix) => {
 };
 var resolveAppName = async (root, appName) => {
 	if (appName !== void 0) return sanitizeAppName(appName);
-	const packageJson = await readJsonObjectFile((0, node_path.join)(root, "package.json"));
+	const packageJson = await readJsonObjectFile((0, node_path.join)(root, "package.json"), "package.json");
 	const packageName = typeof packageJson.name === "string" ? packageJson.name : defaultAppName;
 	return sanitizeAppName(packageName.startsWith("@") ? packageName.slice(packageName.indexOf("/") + 1) : packageName);
 };
@@ -1874,8 +1909,23 @@ var sanitizeAppName = (name) => {
 };
 var readBuildConfig = async (root, configPath) => {
 	const resolvedConfigPath = await resolveConfigPath(root, configPath);
-	if (resolvedConfigPath === void 0) return {};
-	return readJsonObjectFile(resolvedConfigPath);
+	if (resolvedConfigPath === void 0) return {
+		config: {},
+		directory: root
+	};
+	return {
+		config: await readJsonObjectFile(resolvedConfigPath, "Muon config file"),
+		directory: (0, node_path.dirname)(resolvedConfigPath)
+	};
+};
+var readConfigAssetSourcePath = (sourceConfig) => {
+	const sourceAsset = sourceConfig.asset;
+	if (sourceAsset === void 0) return;
+	if (!isJsonObject(sourceAsset)) throw new Error("muon.json asset must be an object when present.");
+	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) {
@@ -1888,9 +1938,20 @@ var resolveConfigPath = async (root, configPath) => {
 		if (await fileExists(candidatePath)) return candidatePath;
 	}
 };
-var readJsonObjectFile = async (filePath) => {
-	const parsed = (0, import_dist.parse)(await (0, node_fs_promises.readFile)(filePath, "utf8"));
-	if (!isJsonObject(parsed)) throw new Error(`Expected JSON object in ${filePath}`);
+var readJsonObjectFile = async (filePath, label) => {
+	let content;
+	try {
+		content = await (0, node_fs_promises.readFile)(filePath, "utf8");
+	} catch (error) {
+		throw new Error(`${label} could not be read: ${filePath}: ${getErrorMessage(error)}`);
+	}
+	let parsed;
+	try {
+		parsed = (0, import_dist.parse)(content);
+	} catch (error) {
+		throw new Error(`${label} could not be parsed: ${filePath}: ${getErrorMessage(error)}`);
+	}
+	if (!isJsonObject(parsed)) throw new Error(`${label} must contain a JSON object: ${filePath}`);
 	return parsed;
 };
 var buildMuonTarget = async (input) => {
@@ -1945,7 +2006,7 @@ var verifyTargetInputs = async (input) => {
 	await assertDirectory(input.sourceRuntimePath, `Muon runtime for ${input.target}`);
 	await assertFile(input.sourceBootstrapPath, `Muon bootstrap for ${input.target}`);
 	for (const fileName of input.descriptor.runtimeFiles) await assertFile((0, node_path.join)(input.sourceRuntimePath, fileName), `Muon runtime file ${fileName} for ${input.target}`);
-	await assertFile((0, node_path.join)(input.sourceRuntimePath, "THIRD_PARTY_NOTICES.md"), `Muon third-party notices for ${input.target}`);
+	await assertFile((0, node_path.join)(input.sourceRuntimePath, muonLicenseFileName), `Muon license file for ${input.target}`);
 };
 var getLauncherFileName = (appName, descriptor) => {
 	if (descriptor.launcherExtension.length > 0 && !appName.endsWith(descriptor.launcherExtension)) return `${appName}${descriptor.launcherExtension}`;
@@ -1953,21 +2014,33 @@ var getLauncherFileName = (appName, descriptor) => {
 };
 var copyRuntimeFiles = async (sourceRuntimePath, outputPath, descriptor) => {
 	for (const fileName of descriptor.runtimeFiles) await (0, node_fs_promises.copyFile)((0, node_path.join)(sourceRuntimePath, fileName), (0, node_path.join)(outputPath, fileName));
-	await (0, node_fs_promises.copyFile)((0, node_path.join)(sourceRuntimePath, "THIRD_PARTY_NOTICES.md"), (0, node_path.join)(outputPath, "THIRD_PARTY_NOTICES.md"));
+	await (0, node_fs_promises.copyFile)((0, node_path.join)(sourceRuntimePath, muonLicenseFileName), (0, node_path.join)(outputPath, muonLicenseFileName));
 };
 var writeAssetArchive = async (input, outputPath, salt) => {
-	await assertDirectory(input.sourcePath, "Muon asset source");
-	const entries = await collectZipEntries(input.sourcePath, input.prefix);
-	if (entries.length === 0) throw new Error(`Muon asset source has no files: ${input.sourcePath}`);
-	const archive = createZipArchive(entries);
+	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;
+	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 {
 		path: outputPath,
 		signature: (0, node_crypto.createHash)("sha1").update(archive).update(salt).digest("hex"),
 		salt: salt.toString("hex"),
-		entryCount: entries.length
+		entryCount: sourceStats.isDirectory() ? readZipEntryCount(archive, outputPath) : readZipEntryCount(archive, input.sourcePath)
 	};
 };
+var createAssetArchiveFromDirectory = async (input) => {
+	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);
+};
+var readZipEntryCount = (archive, sourcePath) => {
+	const endSignature = 101010256;
+	const lastPossibleOffset = archive.length - 22;
+	const firstPossibleOffset = Math.max(0, lastPossibleOffset - 65535);
+	for (let offset = lastPossibleOffset; offset >= firstPossibleOffset; offset -= 1) if (archive.readUInt32LE(offset) === endSignature) return archive.readUInt16LE(offset + 10);
+	throw new Error(`Muon asset ZIP could not be read: ${sourcePath}`);
+};
 var collectZipEntries = async (sourcePath, prefix) => {
 	const entries = [];
 	const walk = async (directoryPath) => {
@@ -2004,7 +2077,7 @@ var createEmbeddedConfig = (sourceConfig, asset) => {
 		...sourceConfig,
 		asset: {
 			...sourceAsset ?? {},
-			from: appConfigFromPath,
+			sourcePath: appConfigSourcePath,
 			signature: asset.signature,
 			salt: asset.salt
 		}
@@ -2024,13 +2097,20 @@ var withTemporaryConfig = async (config, callback) => {
 	}
 };
 var assertDirectory = async (path, label) => {
-	const stats = await (0, node_fs_promises.stat)(path).catch(() => void 0);
+	const stats = await statOrUndefined(path);
 	if (stats === void 0 || !stats.isDirectory()) throw new Error(`${label} directory does not exist: ${path}`);
 };
 var assertFile = async (path, label) => {
-	const stats = await (0, node_fs_promises.stat)(path).catch(() => void 0);
+	const stats = await statOrUndefined(path);
 	if (stats === void 0 || !stats.isFile()) throw new Error(`${label} file does not exist: ${path}`);
 };
+var statOrUndefined = async (path) => {
+	try {
+		return await (0, node_fs_promises.stat)(path);
+	} catch {
+		return;
+	}
+};
 var fileExists = async (path) => {
 	try {
 		await (0, node_fs_promises.access)(path, node_fs.constants.F_OK);
@@ -2042,6 +2122,7 @@ var fileExists = async (path) => {
 var isJsonObject = (value) => {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 };
+var getErrorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
 Object.defineProperty(exports, "buildMuonApp", {
 	enumerable: true,
@@ -2067,12 +2148,24 @@ Object.defineProperty(exports, "embedMuonConfigInRuntime", {
 		return embedMuonConfigInRuntime;
 	}
 });
+Object.defineProperty(exports, "ensureMuonGitignoreEntry", {
+	enumerable: true,
+	get: function() {
+		return ensureMuonGitignoreEntry;
+	}
+});
 Object.defineProperty(exports, "getDefaultMuonPrepareTarget", {
 	enumerable: true,
 	get: function() {
 		return getDefaultMuonPrepareTarget;
 	}
 });
+Object.defineProperty(exports, "require_dist", {
+	enumerable: true,
+	get: function() {
+		return require_dist;
+	}
+});
 Object.defineProperty(exports, "runMuonPrepare", {
 	enumerable: true,
 	get: function() {
@@ -2080,4 +2173,4 @@ Object.defineProperty(exports, "runMuonPrepare", {
 	}
 });
 
-//# sourceMappingURL=build-CCuZpajl.cjs.map
+//# sourceMappingURL=build-xwfaxosJ.cjs.map