mbler 0.2.7-rc.6 → 0.2.8-rc.1

package/dist/build.d.ts

@@ -29,12 +29,13 @@ interface MblerBuildConfig {
 }
 interface MblerConfigData {
   name: string;
+  displayName?: string;
   outdir?: MblerConfigOutdir;
   description: string;
   version: string;
   mcVersion: string | string[];
   script?: MblerConfigScript;
-  minify?: boolean;
+  minify?: 'oxc' | 'terser' | 'esbuild';
   build?: Partial<MblerBuildConfig>;
 }
 interface CliParam {
@@ -43,10 +44,6 @@ interface CliParam {
 }
 //#endregion
 //#region src/build/sapi.d.ts
-/**
- * Compare two dotted version strings ("major.minor.patch").
- * Returns negative if a < b, positive if a > b, zero if equal.
- */
 declare const Sapi: () => {
   refresh: () => Promise<void>;
   generateVersion: (module: "@minecraft/server-ui" | "@minecraft/server", mcVersion: string, isBeta: boolean, withFull: boolean) => Promise<string>;

package/dist/build.esm.mjs

@@ -1,6 +1,5 @@
 import { createRequire } from "node:module";
 import * as mcxDef from "@mbler/mcx-core";
-import minifyPlugin from "@rollup/plugin-terser";
 import { watch as watch$1 } from "chokidar";
 import * as fs$3 from "node:fs/promises";
 import fs from "node:fs/promises";
@@ -11,9 +10,10 @@ import * as readline from "readline";
 import * as fs$2 from "node:fs";
 import fs$1 from "node:fs";
 import os, { homedir, tmpdir } from "node:os";
-import crypto from "node:crypto";
 import { env } from "node:process";
 import { styleText } from "node:util";
+import { pathToFileURL } from "node:url";
+import crypto from "node:crypto";
 import { createMCXLanguagePlugin } from "@mbler/mcx-server";
 import { runTsc } from "@volar/typescript/lib/quickstart/runTsc.js";
 //#region \0rolldown/runtime.js
@@ -44,11 +44,12 @@ const cmdList = [
 ];
 const templateMblerConfig = {
 	name: "demo",
+	displayName: "",
 	description: "demo",
 	version: "0.0.0",
 	mcVersion: "1.21.100",
+	minify: "oxc",
 	script: { main: "" },
-	minify: false,
 	outdir: {
 		behavior: "",
 		resources: "",
@@ -68,19 +69,13 @@ const templateMblerConfig = {
 //#endregion
 //#region src/version.ts
 var version_default = {
-	commit: `commit 85f665dae2e6951b64fd1f021a8bb151c5776b15
+	commit: `commit fd62af9738d7c40c81852464f6b10c32921396ed
 Author: ruanhor <3915264929@qq.com>
-Date:   Sat Jun 13 22:04:15 2026 +0800
+Date:   Mon Jun 22 18:20:50 2026 +0800
 
-    refactor(cli): add declarative command framework with typed params
-    
-    - Add src/cli/command.ts with CommandDef, parseArgs, parseRawParams
-    - Refactor CLI dispatcher to use CommandDef-based dispatch
-    - Convert all 11 command handlers to declarative CommandDef format
-    - Fix parseParam to handle -flag=value correctly
-    - Add 63 new tests for CLI framework and publisher modules
+    fix: improve error message clarity in build process
 `,
-	version: "0.2.7-rc.4"
+	version: "0.2.8"
 };
 //#endregion
 //#region src/i18n/zh.ts
@@ -159,6 +154,7 @@ git https://github.com/RuanhoR/mbler/`,
 		readmeNotFound: "未找到 README 文件",
 		metadataInvalid: "元数据无效",
 		packageNameInvalid: "包名格式必须是 @scope/name",
+		nameMismatch: "mbler.config.js 与 package.json 中的 name 必须一致",
 		notLoginError: "未登录",
 		tokenMissing: "获取 token 失败",
 		unpublishReqFailed: "取消发布请求失败",
@@ -274,6 +270,7 @@ var en_default = {
 		readmeNotFound: "README file not found",
 		metadataInvalid: "Invalid metadata",
 		packageNameInvalid: "Package name must be in the format of @scope/name",
+		nameMismatch: "Package name in mbler.config.js and package.json must match",
 		notLoginError: "Not logged in",
 		tokenMissing: "Failed to get token",
 		unpublishReqFailed: "Failed to unpublish package",
@@ -579,6 +576,11 @@ const BuildConfig = {
 			items: "directory",
 			loot_tables: "directory",
 			recipes: "directory",
+			/**
+			* Skipped from the default copy flow; handled separately by the build:
+			* - bundle: true  → bundled via rollup
+			* - bundle: false → copied as-is into the output
+			*/
 			scripts: "skip",
 			spawn_rules: "directory",
 			structures: "directory",
@@ -614,6 +616,7 @@ async function ReadProjectMblerConfig(project) {
 	try {
 		const pkgRaw = await fs$3.readFile(path$1.join(project, "package.json"), "utf-8");
 		const pkg = JSON.parse(pkgRaw);
+		if (file.name && pkg.name && file.name !== pkg.name) throw new Error(`Package name mismatch: mbler.config.js ("${file.name}") != package.json ("${pkg.name}"). They must match.`);
 		if (pkg.name) config.name = pkg.name;
 		if (pkg.version) config.version = pkg.version;
 	} catch {}
@@ -621,6 +624,11 @@ async function ReadProjectMblerConfig(project) {
 	if (!config.version) config.version = "0.0.0";
 	return config;
 }
+function sleep(time) {
+	return new Promise((resolve) => {
+		setTimeout(resolve, time);
+	});
+}
 /**
 * Print a single-line message to stdout with a trailing newline.
 * Exported here so other modules (for example `build`) do not need
@@ -733,6 +741,96 @@ var BuildCacheManager = class {
 	}
 };
 //#endregion
+//#region src/build/release.ts
+function Release() {
+	const AdmZip = __require("adm-zip");
+	function createFullZip(dir) {
+		const zip = new AdmZip();
+		zip.addLocalFolder(dir);
+		return zip;
+	}
+	function createZipWithMoreFolder(dir) {
+		const zip = new AdmZip();
+		for (const folder of dir) zip.addLocalFolder(folder[0], folder[1]);
+		return zip;
+	}
+	return async function generateRelease(build) {
+		if (!build.outdirs) throw new Error("invalid Build");
+		if (env.BUILD_MODULE !== "release") return;
+		let zip;
+		if (build.module == "all") zip = createZipWithMoreFolder([[build.outdirs?.behavior, "behavior"], [build.outdirs?.resources, "resources"]]);
+		else if (build.module == "behavior") zip = createFullZip(build.outdirs?.behavior);
+		else zip = createFullZip(build.outdirs?.resources);
+		await zip.writeZipPromise(build.outdirs?.dist);
+	};
+}
+let releaseEmul = null;
+const generateRelease = (...argv) => {
+	if (!releaseEmul) releaseEmul = Release();
+	return releaseEmul(...argv);
+};
+//#endregion
+//#region src/build/postgress.ts
+var Postgress = class {
+	max;
+	constructor(max) {
+		this.max = max;
+	}
+	update(current) {
+		const percentage = Math.min(current, this.max) / this.max;
+		const barWidth = 30;
+		const filledWidth = Math.round(barWidth * percentage);
+		const emptyWidth = barWidth - filledWidth;
+		showText(`\n\u001B[1A\r[${`${styleText("green", "█".repeat(filledWidth))}${styleText("white", "█".repeat(emptyWidth))}`}] ${styleText("blue", `${Math.round(percentage * 100)}%`)} (${current}/${this.max})`, false);
+		if (current == this.max) showText("", true);
+	}
+};
+//#endregion
+//#region src/build/minify.ts
+function resolvePackage(name, baseBuildDir) {
+	const require = createRequire(path.join(baseBuildDir, "noop.js"));
+	try {
+		return require.resolve(name, { paths: [baseBuildDir] });
+	} catch {
+		throw new Error(`\`${name}\` is required for minification. Install it in your project:\n  npm i -D ${name}\n  pnpm add -D ${name}\n  yarn add -D ${name}`);
+	}
+}
+function terserPlugin(baseBuildDir) {
+	return {
+		name: "mbler:terser",
+		async generateBundle(_, bundle) {
+			const terser = await import(pathToFileURL(resolvePackage("terser", baseBuildDir)).href);
+			for (const [, chunk] of Object.entries(bundle)) {
+				if (chunk.type !== "chunk") continue;
+				const res = await terser.minify(chunk.code, {
+					format: { comments: false },
+					compress: {
+						unused: true,
+						dead_code: true,
+						if_return: true
+					}
+				});
+				if (res.code) chunk.code = res.code;
+			}
+		}
+	};
+}
+function esbuildPlugin(baseBuildDir) {
+	return {
+		name: "mbler:esbuild",
+		async generateBundle(_, bundle) {
+			const esbuild = await import(pathToFileURL(resolvePackage("esbuild", baseBuildDir)).href);
+			for (const [, chunk] of Object.entries(bundle)) {
+				if (chunk.type !== "chunk") continue;
+				chunk.code = (await esbuild.transform(chunk.code, {
+					minify: true,
+					loader: "js"
+				})).code;
+			}
+		}
+	};
+}
+//#endregion
 //#region src/uuid/index.ts
 /**
 * @description To generate uuid
@@ -756,21 +854,18 @@ const config = {
 };
 //#endregion
 //#region src/build/sapi.ts
-/**
-* Compare two dotted version strings ("major.minor.patch").
-* Returns negative if a < b, positive if a > b, zero if equal.
-*/
 const Sapi = function() {
-	async function json(path) {
-		return await (await fetch("https://registry.npmjs.com" + path)).json();
+	const MAX_RETRIES = 3;
+	async function json(path, attempt = 1) {
+		const r = await fetch("https://registry.npmjs.com" + path);
+		if (!r.ok && attempt < MAX_RETRIES) {
+			await sleep(1e3 * attempt);
+			return json(path, attempt + 1);
+		}
+		return await r.json();
 	}
 	const cacheFile = path$1.join(config.tmpdir, "_sapi_version.json");
 	let cacheData = null;
-	/**
-	* Pull every published version for a package and reduce it to a mapping
-	* from the embedded Minecraft version (e.g. "1.21.60") to the most
-	* recent formal/beta release we were able to parse.
-	*/
 	async function fetchData(pkgName) {
 		const data = await json(`/${pkgName}`);
 		const pkgVersions = Object.keys(data.versions);
@@ -787,18 +882,13 @@ const Sapi = function() {
 			if (!entry) {
 				entry = {
 					formal: "",
-					beta: "",
-					_v: -1
+					beta: ""
 				};
 				reValue[mcVersion] = entry;
 			}
 			if (isStable) {
-				if (!entry.formal || v > entry.formal) entry.formal = v;
-				entry._v = Infinity;
-			} else {
-				if (!entry.beta || v > entry.beta) entry.beta = v;
-				if (entry._v !== Infinity) entry._v = 1;
-			}
+				if (!entry.formal || compareVersion(v, entry.formal) > 0) entry.formal = v;
+			} else if (!entry.beta || compareVersion(v, entry.beta) > 0) entry.beta = v;
 		}
 		return reValue;
 	}
@@ -807,26 +897,20 @@ const Sapi = function() {
 		const uiMap = await fetchData("@minecraft/server-ui");
 		const versions = new Set([...Object.keys(serverMap), ...Object.keys(uiMap)]);
 		const arr = [];
-		for (const ver of Array.from(versions)) arr.push({
+		for (const ver of versions) arr.push({
 			version: ver,
-			server: serverMap[ver] ? {
-				formal: serverMap[ver].formal,
-				beta: serverMap[ver].beta
-			} : {
+			server: serverMap[ver] ?? {
 				formal: "",
 				beta: ""
 			},
-			"server-ui": uiMap[ver] ? {
-				formal: uiMap[ver].formal,
-				beta: uiMap[ver].beta
-			} : {
+			"server-ui": uiMap[ver] ?? {
 				formal: "",
 				beta: ""
 			}
 		});
 		arr.sort((a, b) => compareVersion(a.version, b.version));
 		cacheData = arr;
-		await fs$2.promises.mkdir(config.tmpdir, { recursive: true }).catch(() => void 0);
+		await fs$2.promises.mkdir(config.tmpdir, { recursive: true }).catch(() => {});
 		await fs$2.promises.writeFile(cacheFile, JSON.stringify(arr, null, 2), "utf-8");
 	}
 	async function generateVersion(module, mcVersion, isBeta, withFull = false) {
@@ -836,26 +920,20 @@ const Sapi = function() {
 		} catch {
 			await refresh();
 		}
-		if (!cacheData) throw new Error("unable to load sapi cache data");
+		if (!cacheData) throw new Error("unable to load SAPI version data. Check network connectivity or delete ~/.mbler/_sapi_version.json and try again.");
 		let entry = cacheData.find((e) => e.version === mcVersion);
 		if (!entry) {
-			const sorted = cacheData.slice();
 			let candidate = null;
-			for (const e of sorted) if (compareVersion(e.version, mcVersion) <= 0) candidate = e;
+			for (const e of cacheData) if (compareVersion(e.version, mcVersion) <= 0) candidate = e;
 			else break;
-			if (!candidate) candidate = sorted[0];
-			entry = candidate;
+			entry = candidate ?? cacheData[0];
 		}
+		if (!entry) throw new Error(`no SAPI version data found for Minecraft version ${mcVersion}`);
 		const entryModule = entry[module === "@minecraft/server" ? "server" : "server-ui"];
 		let result = isBeta ? entryModule.beta : entryModule.formal;
 		if (!result) result = entryModule.formal || entryModule.beta;
 		if (withFull) return result || "";
-		else {
-			const tmp = result.split("-").slice(0, 2);
-			tmp[1] = tmp[1].split(".")[0];
-			result = tmp.join("-");
-			return result || "error";
-		}
+		return evalVersion(result || "error");
 	}
 	return {
 		refresh,
@@ -877,8 +955,7 @@ var sapi_default = new Proxy({}, {
 function evalVersion(result) {
 	const tmp = result.split("-").slice(0, 2);
 	tmp[1] = tmp[1].split(".")[0];
-	result = tmp.join("-");
-	return result;
+	return tmp.join("-");
 }
 //#endregion
 //#region src/build/manifest.ts
@@ -887,7 +964,7 @@ async function generateManifest(config, type) {
 	const manifest = {
 		format_version: 2,
 		header: {
-			name: config.name,
+			name: config.displayName || config.name,
 			description: config.description,
 			uuid: fromString(hashRaw, BuildConfig.salt.header),
 			version: stringToNumberArray(config.version),
@@ -939,51 +1016,6 @@ async function generateManifest(config, type) {
 	return manifest;
 }
 //#endregion
-//#region src/build/release.ts
-function Release() {
-	const AdmZip = __require("adm-zip");
-	function createFullZip(dir) {
-		const zip = new AdmZip();
-		zip.addLocalFolder(dir);
-		return zip;
-	}
-	function createZipWithMoreFolder(dir) {
-		const zip = new AdmZip();
-		for (const folder of dir) zip.addLocalFolder(folder[0], folder[1]);
-		return zip;
-	}
-	return async function generateRelease(build) {
-		if (!build.outdirs) throw new Error("invalid Build");
-		if (env.BUILD_MODULE !== "release") return;
-		let zip;
-		if (build.module == "all") zip = createZipWithMoreFolder([[build.outdirs?.behavior, "behavior"], [build.outdirs?.resources, "resources"]]);
-		else if (build.module == "behavior") zip = createFullZip(build.outdirs?.behavior);
-		else zip = createFullZip(build.outdirs?.resources);
-		await zip.writeZipPromise(build.outdirs?.dist);
-	};
-}
-let releaseEmul = null;
-const generateRelease = (...argv) => {
-	if (!releaseEmul) releaseEmul = Release();
-	return releaseEmul(...argv);
-};
-//#endregion
-//#region src/build/postgress.ts
-var Postgress = class {
-	max;
-	constructor(max) {
-		this.max = max;
-	}
-	update(current) {
-		const percentage = Math.min(current, this.max) / this.max;
-		const barWidth = 30;
-		const filledWidth = Math.round(barWidth * percentage);
-		const emptyWidth = barWidth - filledWidth;
-		showText(`\n\u001B[1A\r[${`${styleText("green", "█".repeat(filledWidth))}${styleText("white", "█".repeat(emptyWidth))}`}] ${styleText("blue", `${Math.round(percentage * 100)}%`)} (${current}/${this.max})`, false);
-		if (current == this.max) showText("", true);
-	}
-};
-//#endregion
 //#region src/build/plugin-mcx-tsc.ts
 /**
 * 运行 MCX TypeScript 编译器
@@ -1147,18 +1179,20 @@ var Build = class {
 		const isBundle = this.currentConfig.build?.bundle !== false;
 		if (this.currentConfig.script) if (isBundle) {
 			const rBuild = await this.createRollup();
-			if (!this.rollupPlugin || !this.outdirs) throw new Error(`[build addon]: can't resolve rollup instance`);
+			if (!this.rollupPlugin || !this.outdirs) throw new Error(`[build addon]: rollup instance not available`);
 			if (!this.isWatch) progress.update(50);
 			let output = this.currentConfig.script?.main;
 			if (!output) output = "index.js";
 			if (path.extname(output) !== "js") output = output.slice(0, output.length - path.extname(output).length) + ".js";
 			if (this.buildConfig?.outputFilename) output = this.buildConfig.outputFilename;
 			const outputDir = this.buildConfig?.outputDir || "scripts";
-			await rBuild.write({
+			const writeOptions = {
 				file: join(path.join(this.outdirs.behavior, outputDir), output),
 				format: "esm",
 				sourcemap: false
-			});
+			};
+			if (this.currentConfig.minify === "oxc") writeOptions.minify = true;
+			await rBuild.write(writeOptions);
 		} else {
 			const srcScriptDir = path.join(this.srcDirs.behavior, "scripts");
 			const outputDir = this.buildConfig?.outputDir || "scripts";
@@ -1169,7 +1203,7 @@ var Build = class {
 			});
 		}
 		if (!this.isWatch) progress.update(70);
-		if (!this.outdirs || !this.module) throw new Error(`[build addon]: can't resolve outdirs`);
+		if (!this.outdirs || !this.module) throw new Error(`[build addon]: output directories not initialized`);
 		await generateRelease({
 			outdirs: this.outdirs,
 			module: this.module
@@ -1191,21 +1225,21 @@ var Build = class {
 	* (in which case nothing needs to be bundled).
 	*/
 	async createRollup() {
-		if (!this.currentConfig || !this.srcDirs || !this.outdirs) throw new Error(`[build addon]: can't first can this method`);
+		if (!this.currentConfig || !this.srcDirs || !this.outdirs) throw new Error(`[build addon]: internal error: called before initialization`);
 		if (!this.currentConfig.script) return;
 		const main = path.join(this.srcDirs.behavior, "scripts", this.currentConfig.script.main);
-		if (!await FileExist(main)) throw new Error(`[build addon]: main script ${main} is not exist: can't resolve entry`);
+		if (!await FileExist(main)) throw new Error(`[build addon]: main script not found: ${main}`);
 		const plugin = [];
 		const moduleDir = path.join(this.baseBuildDir, "node_modules");
-		if (!await FileExist(moduleDir)) throw new Error(`[build addon]: node_modules is not exist in project root: can't resolve node_modules for rollup: ${moduleDir}`);
-		if (this.currentConfig.minify) plugin.push(minifyPlugin({
-			format: { comments: false },
-			compress: { unused: true }
-		}));
+		if (!await FileExist(moduleDir)) throw new Error(`[build addon]: node_modules not found: ${moduleDir}`);
+		if (this.currentConfig.minify) {
+			if (this.currentConfig.minify === "terser") plugin.push(terserPlugin(this.baseBuildDir));
+			else if (this.currentConfig.minify === "esbuild") plugin.push(esbuildPlugin(this.baseBuildDir));
+		}
 		if (this.buildConfig?.rollupPlugins) plugin.push(...this.buildConfig.rollupPlugins);
 		if (this.currentConfig.script?.lang == "mcx") try {
 			const tsconfigPath = path.join(this.baseBuildDir, "tsconfig.json");
-			if (!await FileExist(tsconfigPath)) throw new Error(`[build addon]: ts-lang: tsconfig.json is not exist in project root: can't resolve tsconfig for rollup: ${tsconfigPath}`);
+			if (!await FileExist(tsconfigPath)) throw new Error(`[build addon]: tsconfig.json not found: ${tsconfigPath}`);
 			const pluginConfig = {
 				moduleDir,
 				tsconfigPath,
@@ -1262,12 +1296,18 @@ var Build = class {
 		return false;
 	}
 	async createRollupWatcher() {
-		if (!this.srcDirs || !this.outdirs || !this.currentConfig || !this.rollupPlugin) throw new Error(`[build addon]: can't first can this method`);
+		if (!this.srcDirs || !this.outdirs || !this.currentConfig || !this.rollupPlugin) throw new Error(`[build addon]: internal error: called before initialization`);
 		let output = this.currentConfig.script?.main;
 		if (!output) output = "index.js";
 		if (path.extname(output) !== "js") output = output.slice(0, output.length - path.extname(output).length) + ".js";
 		if (this.buildConfig?.outputFilename) output = this.buildConfig.outputFilename;
 		const outputDir = this.buildConfig?.outputDir || "scripts";
+		const outputOptions = {
+			file: join(path.join(this.outdirs.behavior, outputDir), output),
+			format: "esm",
+			sourcemap: false
+		};
+		if (this.currentConfig.minify === "oxc") outputOptions.minify = true;
 		const rollupWatcher = watch$2({
 			input: path.join(this.srcDirs.behavior, "scripts", this.currentConfig?.script?.main || ""),
 			external: [
@@ -1277,11 +1317,7 @@ var Build = class {
 			],
 			plugins: this.rollupPlugin,
 			experimental: { ...this.cacheManager?.shouldUseIncrementalBuild() ? { incrementalBuild: true } : {} },
-			output: {
-				file: join(path.join(this.outdirs.behavior, outputDir), output),
-				format: "esm",
-				sourcemap: false
-			},
+			output: outputOptions,
 			watch: {
 				clearScreen: false,
 				include: path.join(this.srcDirs.behavior, "scripts/**/*"),
@@ -1307,7 +1343,7 @@ var Build = class {
 	}
 	async onChange(filePath) {
 		const isBundle = this.currentConfig?.build?.bundle !== false;
-		if (!this.srcDirs || !this.outdirs || !this.currentConfig || isBundle && !this.rollupPlugin || !this.watchers) throw new Error(`[build addon]: can't first can this method`);
+		if (!this.srcDirs || !this.outdirs || !this.currentConfig || isBundle && !this.rollupPlugin || !this.watchers) throw new Error(`[build addon]: internal error: called before initialization`);
 		const isConfigChange = path.relative(path.join(this.baseBuildDir, BuildConfig.ConfigFile), filePath) === "";
 		const isPkgChange = path.relative(path.join(this.baseBuildDir, "package.json"), filePath) === "";
 		const isScriptsChange = !isBundle && this.isParent(path.join(this.srcDirs.behavior, "scripts"), filePath);
@@ -1355,7 +1391,7 @@ var Build = class {
 		}
 		if (isBehaviorChange || isResourcesChange) {
 			const handlerBP = async () => {
-				if (!this.srcDirs || !this.outdirs) throw new Error(`[build addon]: can't first can this method`);
+				if (!this.srcDirs || !this.outdirs) throw new Error(`[build addon]: internal error: called before initialization`);
 				const relativePath = path.relative(this.srcDirs.behavior, filePath);
 				await fs$3.cp(path.join(this.srcDirs.behavior, relativePath), path.join(this.outdirs.behavior, relativePath), {
 					recursive: true,
@@ -1363,7 +1399,7 @@ var Build = class {
 				});
 			};
 			const handlerRP = async () => {
-				if (!this.srcDirs || !this.outdirs) throw new Error(`[build addon]: can't first can this method`);
+				if (!this.srcDirs || !this.outdirs) throw new Error(`[build addon]: internal error: called before initialization`);
 				const relativePath = path.relative(this.srcDirs.resources, filePath);
 				await fs$3.cp(path.join(this.srcDirs.resources, relativePath), path.join(this.outdirs.resources, relativePath), {
 					recursive: true,
@@ -1377,7 +1413,7 @@ var Build = class {
 	}
 	async createWatcher() {
 		const isBundle = this.currentConfig?.build?.bundle !== false;
-		if (!this.srcDirs || !this.outdirs || isBundle && !this.rollupPlugin) throw new Error(`[build addon]: can't first can this method`);
+		if (!this.srcDirs || !this.outdirs || isBundle && !this.rollupPlugin) throw new Error(`[build addon]: internal error: called before initialization`);
 		const chokidar = watch$1(this.baseBuildDir, {
 			ignored: [
 				this.outdirs.behavior,
@@ -1404,13 +1440,13 @@ var Build = class {
 		};
 	}
 	async handlerManifest() {
-		if (!this.currentConfig || !this.outdirs || !this.srcDirs || !this.module) throw new Error(`[build addon]: can't first can this method`);
+		if (!this.currentConfig || !this.outdirs || !this.srcDirs || !this.module) throw new Error(`[build addon]: internal error: called before initialization`);
 		const otherManifestOption = {
 			behavior: {},
 			resources: {}
 		};
 		const handlerBP = async () => {
-			if (!this.outdirs || !this.currentConfig) throw new Error(`[build addon]: can't first can this method`);
+			if (!this.outdirs || !this.currentConfig) throw new Error(`[build addon]: internal error: called before initialization`);
 			const manifest = await generateManifest(this.currentConfig, "data");
 			await writeJSON(path.join(this.outdirs.behavior, "manifest.json"), {
 				...manifest,
@@ -1418,7 +1454,7 @@ var Build = class {
 			});
 		};
 		const handlerRP = async () => {
-			if (!this.outdirs || !this.currentConfig) throw new Error(`[build addon]: can't first can this method`);
+			if (!this.outdirs || !this.currentConfig) throw new Error(`[build addon]: internal error: called before initialization`);
 			const manifest = await generateManifest(this.currentConfig, "resources");
 			await writeJSON(path.join(this.outdirs.resources, "manifest.json"), {
 				...manifest,
@@ -1447,7 +1483,7 @@ var Build = class {
 		}
 	}
 	loadData() {
-		if (!this.currentConfig || !this.baseBuildDir) throw new Error("[build data]: can't resolve again");
+		if (!this.currentConfig || !this.baseBuildDir) throw new Error("[build data]: already initialized");
 		this.srcDirs = {
 			behavior: path.join(this.baseBuildDir, BuildConfig.behavior),
 			resources: path.join(this.baseBuildDir, BuildConfig.resources)
@@ -1464,10 +1500,10 @@ var Build = class {
 	* by inspecting the source directories.
 	*/
 	async handlerOtherAddon() {
-		if (!this.srcDirs) throw new Error("[build addon]: can't first can this method");
-		if (!await FileExist(this.srcDirs.behavior)) throw new Error("[build addon]: can't resolve behavior");
+		if (!this.srcDirs) throw new Error("[build addon]: internal error: called before initialization");
+		if (!await FileExist(this.srcDirs.behavior)) throw new Error("[build addon]: behavior source directory not found");
 		const handlerBP = async () => {
-			if (!this.srcDirs || !this.outdirs) throw new Error("[build addon]: can't first can this method");
+			if (!this.srcDirs || !this.outdirs) throw new Error("[build addon]: internal error: called before initialization");
 			for (const f of await fs$3.readdir(this.srcDirs.behavior)) {
 				const fType = await this.fileType(path.join(this.srcDirs.behavior, f));
 				const includeType = BuildConfig.includes.behavior[f] || BuildConfig.includes.public[f];
@@ -1480,7 +1516,7 @@ var Build = class {
 			}
 		};
 		const handlerRP = async () => {
-			if (!this.srcDirs || !this.outdirs) throw new Error("[build addon]: can't first can this method");
+			if (!this.srcDirs || !this.outdirs) throw new Error("[build addon]: internal error: called before initialization");
 			for (const f of await fs$3.readdir(this.srcDirs.resources)) {
 				const fType = await this.fileType(path.join(this.srcDirs.resources, f));
 				const includeType = BuildConfig.includes.resources[f] || BuildConfig.includes.public[f];