@weapp-tailwindcss/env 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -62,22 +62,74 @@ function isRunningInHBuilderX(options = {}) {
 	return matchesHBuilderXPluginCwd(options.cwd ?? node_process.default.cwd());
 }
 //#endregion
+//#region src/matching.ts
+function evidence(source, key, value, file) {
+	return {
+		source,
+		key,
+		...value !== void 0 ? { value } : {},
+		...file !== void 0 ? { path: file } : {}
+	};
+}
+function collectMatches(matches, all) {
+	const result = [];
+	for (const candidate of matches) {
+		result.push(candidate);
+		if (!all) break;
+	}
+	return result;
+}
+function detectionReport(candidates) {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const candidate of candidates) {
+		const existing = grouped.get(candidate.appType);
+		if (existing) existing.evidence.push(...candidate.evidence);
+		else grouped.set(candidate.appType, {
+			...candidate,
+			evidence: [...candidate.evidence]
+		});
+	}
+	const unique = [...grouped.values()];
+	const appType = unique[0]?.appType;
+	const family = (value) => value.startsWith("uni-app") ? "uni-app" : value;
+	return {
+		appType,
+		candidates: unique,
+		conflicts: appType === void 0 ? [] : unique.filter((candidate) => family(candidate.appType) !== family(appType)).map((candidate) => candidate.appType)
+	};
+}
+//#endregion
 //#region src/platform.ts
-const MINI_PROGRAM_PLATFORMS = /* @__PURE__ */ new Set([
-	"alipay",
-	"baidu",
-	"jd",
-	"qq",
-	"swan",
-	"tt",
-	"weapp",
-	"wechat",
-	"wx"
+const MPX_TO_UNI_PLATFORM = /* @__PURE__ */ new Map([
+	["ali", "mp-alipay"],
+	["dd", "mp-dingtalk"],
+	["jd", "mp-jd"],
+	["qq", "mp-qq"],
+	["swan", "mp-baidu"],
+	["tt", "mp-toutiao"],
+	["wx", "mp-weixin"]
+]);
+const MINI_PROGRAM_PLATFORMS = new Map([
+	...[...MPX_TO_UNI_PLATFORM].filter(([alias]) => alias !== "ali" && alias !== "dd"),
+	["alipay", "mp-alipay"],
+	["baidu", "mp-baidu"],
+	["weapp", "mp-weixin"],
+	["wechat", "mp-weixin"]
+]);
+const CANONICAL_PLATFORMS = new Map([
+	...[...MPX_TO_UNI_PLATFORM.values()].map((value) => [value, value]),
+	["web", "web"],
+	["h5", "web"],
+	["app", "app"],
+	["app-plus", "app-plus"],
+	["app-android", "app-android"],
+	["app-ios", "app-ios"],
+	["app-harmony", "app-harmony"]
 ]);
 function normalizePlatform(value) {
 	return value?.trim().toLowerCase() || void 0;
 }
-function resolvePlatformInfo(value) {
+function resolvePlatformInfo(value, appType) {
 	const normalized = normalizePlatform(value);
 	const isAppAndroid = normalized === "app-android";
 	const isAppIos = normalized === "app-ios";
@@ -89,7 +141,7 @@ function resolvePlatformInfo(value) {
 		isAppAndroid,
 		isAppHarmony,
 		isAppIos,
-		isMp: normalized?.startsWith("mp-") === true || (normalized ? MINI_PROGRAM_PLATFORMS.has(normalized) : false),
+		isMp: normalized?.startsWith("mp-") === true || (normalized ? MINI_PROGRAM_PLATFORMS.has(normalized) || appType === "mpx" && MPX_TO_UNI_PLATFORM.has(normalized) : false),
 		isWeb: normalized?.startsWith("web") === true || normalized === "h5"
 	};
 }
@@ -99,11 +151,19 @@ function resolvePlatform(value) {
 function resolveTaroPlatform(value = getProcessEnv().TARO_ENV) {
 	return resolvePlatform(value);
 }
+/** 读取 Taro 环境快照；省略快照时才使用调用时的进程环境。 */
+function resolveTaroPlatformFromEnv(env = getProcessEnv()) {
+	return resolvePlatform(env.TARO_ENV);
+}
 function resolveMpxPlatformValue(env = getProcessEnv()) {
 	return env.MPX_CURRENT_TARGET_MODE ?? env.MPX_CLI_MODE;
 }
 function resolveMpxPlatform(value = resolveMpxPlatformValue()) {
-	return resolvePlatform(value);
+	return resolvePlatformInfo(value, "mpx");
+}
+/** 读取 MPX 环境快照，保留 current mode 的空字符串优先级。 */
+function resolveMpxPlatformFromEnv(env = getProcessEnv()) {
+	return resolvePlatformInfo(resolveMpxPlatformValue(env), "mpx");
 }
 function resolveUniPlatform(value = getProcessEnv().UNI_PLATFORM) {
 	return resolvePlatform(value);
@@ -121,141 +181,474 @@ function resolveUniPlatformsFromEnv(env = getProcessEnv()) {
 		uniUtsPlatform: resolvePlatform(env.UNI_UTS_PLATFORM)
 	};
 }
-const MPX_TO_UNI_PLATFORM = {
-	ali: "mp-alipay",
-	dd: "mp-dingtalk",
-	jd: "mp-jd",
-	qq: "mp-qq",
-	swan: "mp-baidu",
-	tt: "mp-toutiao",
-	wx: "mp-weixin"
-};
 function normalizeFrameworkStylePlatform(platform, appType) {
 	const normalized = platform?.trim().toLowerCase();
 	if (!normalized) return;
-	if (appType === "mpx") return MPX_TO_UNI_PLATFORM[normalized] ?? normalized;
+	if (appType === "mpx") return MPX_TO_UNI_PLATFORM.get(normalized) ?? normalized;
 	return normalized;
 }
+function resolvePlatformIdentity(platform, appType) {
+	const normalized = normalizePlatform(platform);
+	return {
+		raw: platform,
+		normalized,
+		canonical: normalized ? (appType === "mpx" ? MPX_TO_UNI_PLATFORM.get(normalized) : void 0) ?? MINI_PROGRAM_PLATFORMS.get(normalized) ?? CANONICAL_PLATFORMS.get(normalized) : void 0
+	};
+}
 //#endregion
 //#region src/detect-env.ts
-function detectAppTypeFromEnv(env = getProcessEnv(), options = {}) {
-	if (env.WEAPP_TW_TARGET === "weapp-vite" || env.WEAPP_TAILWINDCSS_TARGET === "weapp-vite") return "weapp-vite";
-	if (env.TARO_ENV) return "taro";
-	if (env.MPX_CLI_MODE || env.MPX_CURRENT_TARGET_MODE) return "mpx";
+function* matchEnvironment(env, options = {}) {
+	for (const key of ["WEAPP_TW_TARGET", "WEAPP_TAILWINDCSS_TARGET"]) {
+		const value = env[key];
+		if (value === "weapp-vite") yield {
+			appType: "weapp-vite",
+			evidence: [evidence("env", key, value)]
+		};
+	}
+	const taro = env.TARO_ENV;
+	if (taro) yield {
+		appType: "taro",
+		evidence: [evidence("env", "TARO_ENV", taro)]
+	};
+	for (const key of ["MPX_CLI_MODE", "MPX_CURRENT_TARGET_MODE"]) {
+		const value = env[key];
+		if (value) yield {
+			appType: "mpx",
+			evidence: [evidence("env", key, value)]
+		};
+	}
 	const { uniPlatform, uniUtsPlatform } = resolveUniPlatformsFromEnv(env);
-	if (uniUtsPlatform.normalized) return "uni-app-x";
-	if (uniPlatform.normalized) return "uni-app-vite";
+	if (uniUtsPlatform.normalized) yield {
+		appType: "uni-app-x",
+		evidence: [evidence("env", "UNI_UTS_PLATFORM", uniUtsPlatform.raw)]
+	};
+	if (uniPlatform.normalized) yield {
+		appType: "uni-app-vite",
+		evidence: [evidence("env", "UNI_PLATFORM", uniPlatform.raw)]
+	};
 	if (isRunningInHBuilderX({
 		cwd: options.cwd,
 		env
-	})) return options.hbuilderxVite === false ? "uni-app" : "uni-app-vite";
+	})) yield {
+		appType: options.hbuilderxVite === false ? "uni-app" : "uni-app-vite",
+		evidence: [evidence("hbuilderx", "cwd", options.cwd ?? node_process.default.cwd())]
+	};
+}
+function detectAppTypeFromEnv(env = getProcessEnv(), options = {}) {
+	return collectMatches(matchEnvironment(env, options), false)[0]?.appType;
+}
+//#endregion
+//#region src/script-command.ts
+const ASSIGNMENT_RE = /^[A-Z_]\w*=/iu;
+const COMMAND_TYPES = /* @__PURE__ */ new Map([
+	["mpx", "mpx"],
+	["mpx-cli-service", "mpx"],
+	["taro", "taro"],
+	["uni", "uni-app-vite"],
+	["weapp-vite", "weapp-vite"]
+]);
+const PNPM_VALUE_OPTIONS = /* @__PURE__ */ new Set([
+	"-C",
+	"--dir",
+	"-F",
+	"--filter",
+	"--filter-prod",
+	"--reporter"
+]);
+const PNPM_FLAGS = /* @__PURE__ */ new Set([
+	"-w",
+	"--workspace-root",
+	"-r",
+	"--recursive",
+	"-s",
+	"--silent"
+]);
+const NPX_VALUE_OPTIONS = /* @__PURE__ */ new Set([
+	"-p",
+	"--package",
+	"--cache",
+	"--userconfig"
+]);
+const NPX_FLAGS = /* @__PURE__ */ new Set([
+	"-y",
+	"--yes",
+	"--no",
+	"--no-install",
+	"-q",
+	"--quiet"
+]);
+const ENV_VALUE_OPTIONS = /* @__PURE__ */ new Set([
+	"-u",
+	"--unset",
+	"-C",
+	"--chdir"
+]);
+function readExpansionEnd(script, start, opening, closing) {
+	let depth = 1;
+	let quote;
+	for (let index = start + 2; index < script.length; index++) {
+		const character = script[index];
+		if (character === "\\" && quote !== "'") index++;
+		else if (quote) {
+			if (character === quote) quote = void 0;
+		} else if (character === "\"" || character === "'" || character === "`") quote = character;
+		else if (character === opening) depth++;
+		else if (character === closing && --depth === 0) return index;
+	}
+	return -1;
+}
+function tokenizeCommands(script) {
+	const commands = [];
+	let command = [];
+	let value = "";
+	let active = false;
+	let quoted = false;
+	let shellAssignment = false;
+	let protectedPrefix = false;
+	let quote;
+	function flushToken() {
+		if (active) {
+			command.push({
+				value,
+				quoted,
+				shellAssignment
+			});
+			value = "";
+			active = false;
+			quoted = false;
+			shellAssignment = false;
+			protectedPrefix = false;
+		}
+	}
+	function flushCommand() {
+		flushToken();
+		if (command.length) {
+			commands.push(command);
+			command = [];
+		}
+	}
+	for (let index = 0; index < script.length; index++) {
+		const character = script[index];
+		const next = script[index + 1];
+		if (character === "\\" && quote !== "'" && next && /[\s"'\\$`;&|]/u.test(next) || character === "^" && !quote && next && /[\s"^;&|]/u.test(next)) {
+			if (next !== "\n" && next !== "\r") {
+				protectedPrefix = true;
+				value += next;
+				active = true;
+			} else if (next === "\r" && script[index + 2] === "\n") index++;
+			index++;
+		} else if (character === "$" && (next === "(" || next === "{") && quote !== "'") {
+			const end = readExpansionEnd(script, index, next, next === "(" ? ")" : "}");
+			if (end === -1) return [];
+			value += script.slice(index, end + 1);
+			protectedPrefix = true;
+			active = true;
+			index = end;
+		} else if (quote) {
+			if (character === quote) quote = void 0;
+			else value += character;
+		} else if (character === "\"" || character === "'" || character === "`") {
+			quote = character;
+			quoted = true;
+			protectedPrefix = true;
+			active = true;
+			if (character === "`") value += character;
+		} else if (character === "<" && next === "<") return [];
+		else if ((character === ">" || character === "<") && next === "&" || character === "&" && next === ">") {
+			value += character + next;
+			active = true;
+			index++;
+		} else if (character === "#" && !active) while (script[index + 1] && script[index + 1] !== "\n") index++;
+		else if (character === ";" || character === "&" || character === "|" || character === "\n" || character === "\r") flushCommand();
+		else if (/\s/u.test(character)) flushToken();
+		else {
+			if (character === "=" && !protectedPrefix && ASSIGNMENT_RE.test(`${value}=`)) shellAssignment = true;
+			value += character;
+			active = true;
+		}
+	}
+	if (quote) return [];
+	flushCommand();
+	return commands;
+}
+function executableName(value, allowVersion = false) {
+	if (allowVersion && value.startsWith("@")) return value;
+	const name = node_path.default.win32.basename(node_path.default.posix.basename(value));
+	const executable = /\.(?:cmd|bat|exe)$/iu.test(name) ? name.replace(/\.(?:cmd|bat|exe)$/iu, "").toLowerCase() : name;
+	return allowVersion ? executable.replace(/@[^@]+$/u, "") : executable;
+}
+function skipAssignments(tokens, index, shellPosition = false) {
+	while (tokens[index] && (shellPosition ? tokens[index].shellAssignment : ASSIGNMENT_RE.test(tokens[index].value))) index++;
+	return index;
+}
+function skipOptions(tokens, index, flags, valueOptions) {
+	while (tokens[index]?.value.startsWith("-")) {
+		const value = tokens[index].value;
+		if (value === "--") return index + 1;
+		if (flags.has(value)) index++;
+		else if (valueOptions.has(value)) {
+			if (!tokens[index + 1]) return tokens.length;
+			index += 2;
+		} else if (value.includes("=") && valueOptions.has(value.slice(0, value.indexOf("=")))) index++;
+		else return tokens.length;
+	}
+	return index;
+}
+function collectCommands(script, detected, depth = 0) {
+	if (depth > 8) return;
+	for (const tokens of tokenizeCommands(script)) {
+		let index = skipAssignments(tokens, 0, true);
+		let allowVersion = false;
+		while (tokens[index]) {
+			const name = executableName(tokens[index].value, allowVersion);
+			const appType = COMMAND_TYPES.get(name);
+			if (appType) {
+				detected.add(appType);
+				break;
+			}
+			allowVersion = false;
+			index++;
+			if (name === "cross-env" || name === "cross-env-shell") {
+				index = skipAssignments(tokens, index);
+				const payload = tokens[index];
+				if (name === "cross-env-shell" && payload?.quoted) {
+					collectCommands(payload.value, detected, depth + 1);
+					break;
+				}
+			} else if (name === "env") {
+				index = skipOptions(tokens, index, /* @__PURE__ */ new Set(["-i", "--ignore-environment"]), ENV_VALUE_OPTIONS);
+				index = skipAssignments(tokens, index);
+			} else if (name === "pnpm") {
+				index = skipOptions(tokens, index, PNPM_FLAGS, PNPM_VALUE_OPTIONS);
+				if (tokens[index]?.value === "exec" || tokens[index]?.value === "dlx") {
+					const dlx = tokens[index].value === "dlx";
+					index++;
+					index = skipOptions(tokens, index, dlx ? NPX_FLAGS : PNPM_FLAGS, dlx ? NPX_VALUE_OPTIONS : PNPM_VALUE_OPTIONS);
+					allowVersion = dlx;
+				}
+			} else if (name === "npx") {
+				index = skipOptions(tokens, index, NPX_FLAGS, NPX_VALUE_OPTIONS);
+				allowVersion = true;
+			} else break;
+		}
+	}
+}
+/**
+* 仅识别脚本中明确的命令位置，不执行脚本或推断任意参数中的框架名称。
+*/
+function detectFrameworkCommands(script) {
+	const detected = /* @__PURE__ */ new Set();
+	collectCommands(script, detected);
+	return [...detected];
 }
 //#endregion
 //#region src/package.ts
-const MPX_SCRIPT_RE = /\bmpx(?:-cli-service)?\b/u;
-const TARO_SCRIPT_RE = /\btaro\b/u;
-const WEAPP_VITE_SCRIPT_RE = /\bweapp-vite\b/u;
-const UNI_APP_SCRIPT_RE = /\buni(?:\s|$)/u;
-const UNI_APP_VITE_SCRIPT_RE = /\buni(?:\s|$)/u;
-function resolveDependencyNames(pkg) {
-	return /* @__PURE__ */ new Set([
-		...Object.keys(pkg.dependencies ?? {}),
-		...Object.keys(pkg.devDependencies ?? {}),
-		...Object.keys(pkg.peerDependencies ?? {}),
-		...Object.keys(pkg.optionalDependencies ?? {})
-	]);
-}
-function hasDependencyPrefix(dependencyNames, prefix) {
-	return [...dependencyNames].some((name) => name.startsWith(prefix));
-}
-function hasScriptMatch(pkg, pattern) {
-	return Object.values(pkg.scripts ?? {}).some((script) => pattern.test(script));
+const FRAMEWORK_PRIORITY = [
+	"weapp-vite",
+	"mpx",
+	"taro",
+	"uni-app-x",
+	"uni-app-vite",
+	"uni-app"
+];
+const DEPENDENCY_FIELDS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+function matchesDependency(appType, name) {
+	switch (appType) {
+		case "weapp-vite": return name === "weapp-vite" || name.startsWith("@weapp-vite/");
+		case "mpx": return name.startsWith("@mpxjs/");
+		case "taro": return name.startsWith("@tarojs/");
+		case "uni-app-x": return name === "@dcloudio/uni-uts-v1" || name === "@weapp-tailwindcss/debug-uni-app-x";
+		case "uni-app-vite": return name === "@dcloudio/vite-plugin-uni";
+		case "uni-app": return name === "@dcloudio/vue-cli-plugin-uni" || name === "@dcloudio/uni-app";
+	}
+}
+function packageMatcher(pkg, file) {
+	let scripts;
+	return (appType, all) => {
+		const result = [];
+		for (const field of DEPENDENCY_FIELDS) for (const [name, version] of Object.entries(pkg[field] ?? {})) if (matchesDependency(appType, name)) {
+			result.push(evidence("dependency", `${field}.${name}`, version, file));
+			if (!all) return result;
+		}
+		if (appType === "uni-app" && Object.hasOwn(pkg, "uni-app")) {
+			result.push(evidence("package-field", "uni-app", void 0, file));
+			if (!all) return result;
+		}
+		if (appType === "uni-app-x") return result;
+		scripts ??= Object.entries(pkg.scripts ?? {}).map(([name, value]) => ({
+			name,
+			value,
+			commands: detectFrameworkCommands(value)
+		}));
+		for (const script of scripts) {
+			const commandType = appType === "uni-app" ? "uni-app-vite" : appType;
+			if (script.commands.includes(commandType)) {
+				result.push(evidence("script", `scripts.${script.name}`, script.value, file));
+				if (!all) return result;
+			}
+		}
+		return result;
+	};
+}
+function* matchPackageJson(pkg, all, file) {
+	const match = packageMatcher(pkg, file);
+	for (const appType of FRAMEWORK_PRIORITY) {
+		const evidence = match(appType, all);
+		if (evidence.length) yield {
+			appType,
+			evidence
+		};
+	}
 }
 function isWeappVitePackage(pkg) {
-	const dependencyNames = resolveDependencyNames(pkg);
-	return dependencyNames.has("weapp-vite") || hasDependencyPrefix(dependencyNames, "@weapp-vite/") || hasScriptMatch(pkg, WEAPP_VITE_SCRIPT_RE);
+	return packageMatcher(pkg)("weapp-vite", false).length > 0;
 }
 function isMpxPackage(pkg) {
-	return hasDependencyPrefix(resolveDependencyNames(pkg), "@mpxjs/") || hasScriptMatch(pkg, MPX_SCRIPT_RE);
+	return packageMatcher(pkg)("mpx", false).length > 0;
 }
 function isTaroPackage(pkg) {
-	return hasDependencyPrefix(resolveDependencyNames(pkg), "@tarojs/") || hasScriptMatch(pkg, TARO_SCRIPT_RE);
+	return packageMatcher(pkg)("taro", false).length > 0;
 }
 function isUniAppVitePackage(pkg) {
-	return resolveDependencyNames(pkg).has("@dcloudio/vite-plugin-uni") || hasScriptMatch(pkg, UNI_APP_VITE_SCRIPT_RE);
+	return packageMatcher(pkg)("uni-app-vite", false).length > 0;
 }
 function isUniAppXPackage(pkg) {
-	const dependencyNames = resolveDependencyNames(pkg);
-	return dependencyNames.has("@dcloudio/uni-uts-v1") || dependencyNames.has("@weapp-tailwindcss/debug-uni-app-x");
+	return packageMatcher(pkg)("uni-app-x", false).length > 0;
 }
 function isUniAppPackage(pkg) {
-	const dependencyNames = resolveDependencyNames(pkg);
-	return dependencyNames.has("@dcloudio/vue-cli-plugin-uni") || dependencyNames.has("@dcloudio/uni-app") || Object.hasOwn(pkg, "uni-app") || hasScriptMatch(pkg, UNI_APP_SCRIPT_RE);
+	return packageMatcher(pkg)("uni-app", false).length > 0;
 }
 function isUniAppXManifest(manifest) {
 	return Boolean(manifest && Object.hasOwn(manifest, "uni-app-x"));
 }
 function detectAppTypeFromPackageJson(pkg) {
-	if (isWeappVitePackage(pkg)) return "weapp-vite";
-	if (isMpxPackage(pkg)) return "mpx";
-	if (isTaroPackage(pkg)) return "taro";
-	if (isUniAppXPackage(pkg)) return "uni-app-x";
-	if (isUniAppVitePackage(pkg)) return "uni-app-vite";
-	if (isUniAppPackage(pkg)) return "uni-app";
+	return collectMatches(matchPackageJson(pkg, false), false)[0]?.appType;
+}
+//#endregion
+//#region src/manifest.ts
+/** 仅移除字符串外的注释，其余语法仍交给严格 JSON 解析。 */
+function parseManifestJson(source) {
+	const characters = source.split("");
+	let inString = false;
+	for (let index = 0; index < source.length; index++) {
+		const character = source[index];
+		if (inString) {
+			if (character === "\\") index++;
+			else if (character === "\"") inString = false;
+			continue;
+		}
+		if (character === "\"") {
+			inString = true;
+			continue;
+		}
+		if (character !== "/") continue;
+		if (source[index + 1] === "/") {
+			characters[index] = " ";
+			characters[++index] = " ";
+			while (index + 1 < source.length && source[index + 1] !== "\n" && source[index + 1] !== "\r") characters[++index] = " ";
+		} else if (source[index + 1] === "*") {
+			characters[index] = " ";
+			characters[++index] = " ";
+			let closed = false;
+			while (++index < source.length) {
+				if (source[index] === "*" && source[index + 1] === "/") {
+					characters[index] = " ";
+					characters[++index] = " ";
+					closed = true;
+					break;
+				}
+				if (source[index] !== "\n" && source[index] !== "\r") characters[index] = " ";
+			}
+			if (!closed) throw new SyntaxError("manifest.json 中存在未闭合的块注释");
+		}
+	}
+	return JSON.parse(characters.join(""));
 }
 //#endregion
 //#region src/project.ts
 const PACKAGE_JSON_FILE = "package.json";
 const MANIFEST_JSON_FILE = "manifest.json";
 const MPX_MARKERS = [["src", "app.mpx"], ["app.mpx"]];
-function tryReadJson(file) {
+function tryReadJson(file, parse = JSON.parse) {
 	if (!(0, node_fs.existsSync)(file)) return;
 	try {
-		return JSON.parse((0, node_fs.readFileSync)(file, "utf8"));
+		return parse((0, node_fs.readFileSync)(file, "utf8"));
 	} catch {}
 }
-function detectAppTypeFromMarkers(root) {
-	for (const segments of MPX_MARKERS) if ((0, node_fs.existsSync)(node_path.default.join(root, ...segments))) return "mpx";
+function manifestMatches(manifest, file) {
+	return isUniAppXManifest(manifest) ? [{
+		appType: "uni-app-x",
+		evidence: [evidence("manifest", "uni-app-x", void 0, file)]
+	}] : [];
 }
-function detectAppTypeFromRoot(root, searchUp = true) {
+function matchRoot(root, searchUp, all) {
 	const resolvedRoot = node_path.default.resolve(root);
-	if (!(0, node_fs.existsSync)(resolvedRoot)) return;
-	const markerDetected = detectAppTypeFromMarkers(resolvedRoot);
-	if (markerDetected) return markerDetected;
+	if (!(0, node_fs.existsSync)(resolvedRoot)) return [];
+	const markers = [];
+	for (const segments of MPX_MARKERS) {
+		const file = node_path.default.join(resolvedRoot, ...segments);
+		if ((0, node_fs.existsSync)(file)) {
+			markers.push(evidence("marker", "app.mpx", void 0, file));
+			if (!all) break;
+		}
+	}
+	if (markers.length) return [{
+		appType: "mpx",
+		evidence: markers
+	}];
 	let current = resolvedRoot;
 	while (true) {
-		if (isUniAppXManifest(tryReadJson(node_path.default.join(current, MANIFEST_JSON_FILE)))) return "uni-app-x";
-		const pkg = tryReadJson(node_path.default.join(current, PACKAGE_JSON_FILE));
+		const manifestFile = node_path.default.join(current, MANIFEST_JSON_FILE);
+		const manifest = manifestMatches(tryReadJson(manifestFile, parseManifestJson), manifestFile);
+		if (manifest.length) return manifest;
+		const packageFile = node_path.default.join(current, PACKAGE_JSON_FILE);
+		const pkg = tryReadJson(packageFile);
 		if (pkg) {
-			const detected = detectAppTypeFromPackageJson(pkg);
-			if (detected) return detected;
+			const candidates = collectMatches(matchPackageJson(pkg, all, packageFile), all);
+			if (candidates.length) return candidates;
 		}
 		if (!searchUp) break;
 		const parent = node_path.default.dirname(current);
 		if (parent === current) break;
 		current = parent;
 	}
+	return [];
 }
-function detectAppType(options = {}) {
-	if (isUniAppXManifest(options.manifest)) return "uni-app-x";
+function matchAppType(options, all) {
+	const manifest = manifestMatches(options.manifest);
+	if (manifest.length) return manifest;
 	if (options.packageJson) {
-		const detected = detectAppTypeFromPackageJson(options.packageJson);
-		if (detected) return detected;
+		const candidates = collectMatches(matchPackageJson(options.packageJson, all), all);
+		if (candidates.length) return candidates;
 	}
 	if (options.root) {
-		const detected = detectAppTypeFromRoot(options.root, options.searchUp ?? true);
-		if (detected) return detected;
+		const candidates = matchRoot(options.root, options.searchUp ?? true, all);
+		if (candidates.length) return candidates;
 	}
 	const env = options.env ?? (options.detectEnv ? getProcessEnv() : void 0);
-	if (env) return detectAppTypeFromEnv(env, {
+	if (!env) return [];
+	return collectMatches(matchEnvironment(env, {
 		cwd: options.cwd ?? options.root ?? (options.detectEnv ? node_process.default.cwd() : void 0),
 		hbuilderxVite: options.hbuilderxVite
-	});
+	}), all);
+}
+function detectAppType(options = {}) {
+	return matchAppType(options, false)[0]?.appType;
+}
+/** 解释首次命中阶段的框架候选与冲突，不扩大项目搜索范围。 */
+function detectAppTypeReport(options = {}) {
+	return detectionReport(matchAppType(options, true));
 }
 //#endregion
 exports.detectAppType = detectAppType;
 exports.detectAppTypeFromEnv = detectAppTypeFromEnv;
 exports.detectAppTypeFromPackageJson = detectAppTypeFromPackageJson;
+exports.detectAppTypeReport = detectAppTypeReport;
 exports.isMpxPackage = isMpxPackage;
 exports.isRunningInHBuilderX = isRunningInHBuilderX;
 exports.isTaroPackage = isTaroPackage;
@@ -266,8 +659,11 @@ exports.isUniAppXPackage = isUniAppXPackage;
 exports.isWeappVitePackage = isWeappVitePackage;
 exports.normalizeFrameworkStylePlatform = normalizeFrameworkStylePlatform;
 exports.resolveMpxPlatform = resolveMpxPlatform;
+exports.resolveMpxPlatformFromEnv = resolveMpxPlatformFromEnv;
 exports.resolvePlatform = resolvePlatform;
+exports.resolvePlatformIdentity = resolvePlatformIdentity;
 exports.resolveTaroPlatform = resolveTaroPlatform;
+exports.resolveTaroPlatformFromEnv = resolveTaroPlatformFromEnv;
 exports.resolveUniAppXPlatform = resolveUniAppXPlatform;
 exports.resolveUniPlatform = resolveUniPlatform;
 exports.resolveUniPlatformsFromEnv = resolveUniPlatformsFromEnv;