@applift/core 0.6.0 → 0.7.1

package/dist/project-4_orxby_.mjs

@@ -0,0 +1,806 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/framework.ts
+/**
+* 框架适配器：让 applift 框架无关（RN / Flutter / 原生安卓 / 原生 iOS / 原生鸿蒙）。
+* 探测规则 + 产物 pattern + 缺省构建命令；插件可用 'channel:register' 旁路注册自定义 FrameworkAdapter。
+*/
+/** 一层子目录列表（探测用，跳过隐藏目录与 node_modules/Pods） */
+function subdirs(cwd, depth) {
+	if (depth <= 0) return [];
+	const out = [];
+	let names;
+	try {
+		names = fs.readdirSync(cwd, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+	for (const name of names) {
+		if (!name.isDirectory() || name.name.startsWith(".") || name.name === "node_modules" || name.name === "Pods") continue;
+		const p = path.join(cwd, name.name);
+		out.push(p, ...subdirs(p, depth - 1));
+	}
+	return out;
+}
+/** package.json 读取（容错） */
+function readJson(filePath) {
+	try {
+		return JSON.parse(fs.readFileSync(filePath, "utf8"));
+	} catch {
+		return null;
+	}
+}
+function deps(pkg) {
+	if (!pkg) return {};
+	return {
+		...pkg.dependencies,
+		...pkg.devDependencies
+	};
+}
+/**
+* 声明式框架解析：插件注册的 adapter 是唯一来源（不再回退内置探测表）。
+* - 未注册 → null（CLI 层负责提示声明 framework 插件）
+* - 注册多个 → 报错（声明即意图，多个意图是配置错误）
+* - 注册一个 → detect 降级为校验（声明与工程不符时显式报错，而非静默跳过）
+*/
+function resolveFramework(cwd, registered) {
+	if (registered.length === 0) return null;
+	if (registered.length > 1) throw new Error(`多个 framework 插件注册：${registered.map((a) => a.id).join(", ")}——只能声明一个`);
+	const adapter = registered[0];
+	if (!adapter.detect(cwd)) throw new Error(`声明的 framework「${adapter.label}」与当前工程不匹配，请检查 plugins 声明`);
+	return adapter;
+}
+/** 按 pattern 扫描产物（支持 ** 与 * 简单通配，返回绝对路径，多产物按 mtime 新者在前） */
+function findArtifacts(cwd, patterns) {
+	const byPath = /* @__PURE__ */ new Map();
+	for (const pattern of patterns) for (const p of globWalk(path.resolve(cwd), pattern.split("/"))) {
+		if (byPath.has(p)) continue;
+		try {
+			byPath.set(p, fs.statSync(p).mtimeMs);
+		} catch {}
+	}
+	return [...byPath].sort((a, b) => b[1] - a[1]).map(([p]) => p);
+}
+/** 文本读取（容错：不存在/不可读返回 null，绝不抛；detectBundleIds 各源共用） */
+function readText$1(filePath) {
+	try {
+		return fs.readFileSync(filePath, "utf8");
+	} catch {
+		return null;
+	}
+}
+/** 从 JSON 对象按路径取非空字符串（任一层缺失/非字符串返回 undefined） */
+function pickString(obj, ...keys) {
+	let cur = obj;
+	for (const k of keys) {
+		if (cur === null || typeof cur !== "object") return void 0;
+		cur = cur[k];
+	}
+	return typeof cur === "string" && cur.trim() ? cur.trim() : void 0;
+}
+/** 原生安卓 applicationId（groovy/kts 两种赋值语法；app/ 与 android/app/ 两处布局；不中返回 undefined） */
+function gradleApplicationId(cwd) {
+	const candidates = [
+		path.join(cwd, "app", "build.gradle"),
+		path.join(cwd, "app", "build.gradle.kts"),
+		path.join(cwd, "android", "app", "build.gradle"),
+		path.join(cwd, "android", "app", "build.gradle.kts")
+	];
+	for (const file of candidates) {
+		const text = readText$1(file);
+		if (!text) continue;
+		const m = /(?:^|\s)applicationId\s*[=:]?\s*["']([^"'\s]+)["']/.exec(text);
+		if (m?.[1]) return m[1];
+	}
+}
+/** 鸿蒙 AppScope/app.json5 的 bundleName（json5 允许注释/尾逗号，正则取值而非 JSON 解析） */
+function appJson5BundleName(file) {
+	const text = readText$1(file);
+	return (text && /"bundleName"\s*:\s*"([^"]+)"/.exec(text))?.[1];
+}
+/** 两层子目录内找首个 *.xcodeproj：pbxproj 第一个非变量（含 $ 的 $(...) 与 ${...}）的 PRODUCT_BUNDLE_IDENTIFIER + 工程名（Pods 已被 subdirs 排除） */
+function findPbxproj(cwd) {
+	for (const dir of [cwd, ...subdirs(cwd, 2)]) {
+		let entries;
+		try {
+			entries = fs.readdirSync(dir, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+		const projects = entries.filter((e) => e.isDirectory() && e.name.endsWith(".xcodeproj")).map((e) => e.name).sort();
+		for (const name of projects) {
+			const pbx = readText$1(path.join(dir, name, "project.pbxproj"));
+			if (!pbx) continue;
+			for (const m of pbx.matchAll(/PRODUCT_BUNDLE_IDENTIFIER\s*=\s*([^;]+);/g)) {
+				const value = m[1].trim().replace(/^["']|["']$/g, "");
+				if (value && !value.includes("$")) return {
+					bundleId: value,
+					scheme: name.slice(0, -10)
+				};
+			}
+		}
+	}
+	return null;
+}
+/**
+* 自动推导三端应用标识（项目配置缺省时的兜底，配置可全空）：
+* android：RN app.json android.applicationId > 原生 gradle applicationId；
+* harmony：AppScope/app.json5（根或 harmony/ 下）> RN app.json harmony.bundleName；
+* ios：RN app.json ios.bundleIdentifier > 两层内 xcodeproj 的 PRODUCT_BUNDLE_IDENTIFIER（scheme=工程名）。
+* 容错：文件不存在/正则不中只置 undefined，绝不抛。
+*/
+function detectBundleIds(cwd) {
+	const appJson = readJson(path.join(cwd, "app.json"));
+	const pbx = findPbxproj(cwd);
+	const expo = appJson?.expo ?? null;
+	const expoAndroid = expo ? pickString(expo, "android", "package") : void 0;
+	const expoIos = expo ? pickString(expo, "ios", "bundleIdentifier") : void 0;
+	const expoName = expo && typeof expo.name === "string" ? expo.name : void 0;
+	return {
+		androidPkgName: expoAndroid ?? pickString(appJson, "android", "applicationId") ?? gradleApplicationId(cwd),
+		harmonyBundleName: appJson5BundleName(path.join(cwd, "AppScope", "app.json5")) ?? appJson5BundleName(path.join(cwd, "harmony", "AppScope", "app.json5")) ?? pickString(appJson, "harmony", "bundleName"),
+		iosBundleId: expoIos ?? pickString(appJson, "ios", "bundleIdentifier") ?? pbx?.bundleId,
+		iosScheme: pbx?.scheme ?? expoName
+	};
+}
+/** 极简 glob 目录游走（** 跨层，* 单段），避免引入 minimatch 依赖 */
+function globWalk(dir, segments) {
+	const [head, ...rest] = segments;
+	if (!head) return [dir];
+	if (!fs.existsSync(dir)) return [];
+	if (head === "**") {
+		const out = [];
+		const walkAll = (d) => {
+			out.push(...globWalk(d, rest));
+			for (const name of fs.readdirSync(d, { withFileTypes: true })) {
+				if (!name.isDirectory() || name.name.startsWith(".") || name.name === "node_modules") continue;
+				walkAll(path.join(d, name.name));
+			}
+		};
+		walkAll(dir);
+		return [...new Set(out)];
+	}
+	if (head.includes("*")) {
+		const re = new RegExp(`^${head.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")}$`);
+		const out = [];
+		for (const name of fs.readdirSync(dir)) if (re.test(name)) out.push(...globWalk(path.join(dir, name), rest));
+		return out;
+	}
+	return globWalk(path.join(dir, head), rest);
+}
+//#endregion
+//#region src/plugins/frameworks.ts
+/**
+* framework 插件工厂：内置七个框架适配器的声明式形态。
+*
+* applift.config.ts 的 plugins 数组声明其一（如 rnFramework({...})），
+* 经 'framework:register' 钩子注册 adapter；声明即唯一来源（见 resolveFramework）。
+* 项目特化（如自定义构建命令）通过工厂参数覆盖，不进 applift core。
+*/
+function frameworkPlugin(name, adapter) {
+	return {
+		name,
+		"framework:register"(adapters) {
+			adapters.push(adapter);
+		}
+	};
+}
+/** 生态通用 RN adapter：产物 pattern 按 RN 社区惯例；构建命令无统一标准（项目覆盖） */
+const rnAdapter = {
+	id: "rn",
+	label: "React Native",
+	detect(cwd) {
+		return "react-native" in deps(readJson(path.join(cwd, "package.json")));
+	},
+	/** Expo 项目（依赖 expo 包）：同走 RN 产物路径（prebuild 生成原生工程），label 区分展示 */
+	expoAwareLabel(cwd) {
+		return "expo" in deps(readJson(path.join(cwd, "package.json"))) ? "Expo (React Native)" : "React Native";
+	},
+	artifactPatterns(platform) {
+		if (platform === "android") return ["android/app/build/outputs/apk/release/*-release.apk"];
+		if (platform === "ios") return ["build/ios/ipa/*.ipa"];
+		return [
+			"harmony/entry/build/default/outputs/**/entry-*-signed.hap",
+			"harmony/entry/build/default/outputs/**/entry-*.app",
+			"harmony/build/outputs/**/*.app",
+			"build/outputs/**/*.app"
+		];
+	}
+};
+function rnFramework() {
+	return frameworkPlugin("framework-react-native", rnAdapter);
+}
+const flutterAdapter = {
+	id: "flutter",
+	label: "Flutter",
+	detect(cwd) {
+		if (readJson(path.join(cwd, "pubspec.yaml"))) return true;
+		try {
+			const text = fs.readFileSync(path.join(cwd, "pubspec.yaml"), "utf8");
+			return /^sdk:\s*flutter$/m.test(text) || /^name:/m.test(text);
+		} catch {
+			return false;
+		}
+	},
+	artifactPatterns(platform) {
+		if (platform === "android") return ["build/app/outputs/flutter-apk/app-release.apk"];
+		if (platform === "ios") return ["build/ios/ipa/*.ipa"];
+		return [
+			"build/**/outputs/**/*-signed.hap",
+			"harmony/entry/build/**/outputs/**/*-signed.hap",
+			"ohos/entry/build/**/outputs/**/*-signed.hap",
+			"build/**/outputs/**/*.app"
+		];
+	}
+};
+function flutterFramework() {
+	return frameworkPlugin("framework-flutter", flutterAdapter);
+}
+const nativeAndroidAdapter = {
+	id: "native-android",
+	label: "原生 Android",
+	detect(cwd) {
+		if (rnAdapter.detect(cwd)) return false;
+		return fs.existsSync(path.join(cwd, "settings.gradle")) || fs.existsSync(path.join(cwd, "settings.gradle.kts"));
+	},
+	artifactPatterns() {
+		return ["app/build/outputs/apk/release/*-release.apk"];
+	}
+};
+function nativeAndroidFramework() {
+	return frameworkPlugin("framework-native-android", nativeAndroidAdapter);
+}
+const nativeIosAdapter = {
+	id: "native-ios",
+	label: "原生 iOS",
+	detect(cwd) {
+		if (rnAdapter.detect(cwd)) return false;
+		for (const dir of [cwd, ...subdirs(cwd, 1)]) {
+			let entries;
+			try {
+				entries = fs.readdirSync(dir);
+			} catch {
+				continue;
+			}
+			if (entries.some((f) => String(f).endsWith(".xcodeproj") || String(f).endsWith(".xcworkspace"))) return true;
+		}
+		return false;
+	},
+	artifactPatterns() {
+		return ["build/**/*.ipa"];
+	}
+};
+function nativeIosFramework() {
+	return frameworkPlugin("framework-native-ios", nativeIosAdapter);
+}
+const nativeHarmonyAdapter = {
+	id: "native-harmony",
+	label: "原生鸿蒙 (ArkTS)",
+	detect(cwd) {
+		return fs.existsSync(path.join(cwd, "oh-package.json5")) || fs.existsSync(path.join(cwd, "harmony/oh-package.json5"));
+	},
+	artifactPatterns() {
+		return [
+			"entry/build/default/outputs/**/entry-*-signed.hap",
+			"entry/build/default/outputs/**/entry-*.app",
+			"harmony/entry/build/default/outputs/**/*-signed.hap",
+			"build/outputs/**/*.app",
+			"harmony/build/outputs/**/*.app",
+			"ohos/build/outputs/**/*.app"
+		];
+	}
+};
+function nativeHarmonyFramework() {
+	return frameworkPlugin("framework-native-harmony", nativeHarmonyAdapter);
+}
+const electronAdapter = {
+	id: "electron",
+	label: "Electron",
+	detect(cwd) {
+		return "electron" in deps(readJson(path.join(cwd, "package.json")));
+	},
+	artifactPatterns(platform) {
+		if (platform === "windows") return [
+			"dist/*.exe",
+			"dist/**/*.exe",
+			"out/make/*.exe"
+		];
+		if (platform === "macos") return [
+			"dist/*.dmg",
+			"dist/**/*.dmg",
+			"out/make/*.dmg"
+		];
+		if (platform === "linux") return [
+			"dist/*.AppImage",
+			"dist/**/*.AppImage",
+			"out/make/*.AppImage"
+		];
+		return [];
+	}
+};
+function electronFramework() {
+	return frameworkPlugin("framework-electron", electronAdapter);
+}
+const tauriAdapter = {
+	id: "tauri",
+	label: "Tauri",
+	detect(cwd) {
+		return "@tauri-apps/cli" in deps(readJson(path.join(cwd, "package.json"))) || fs.existsSync(path.join(cwd, "src-tauri"));
+	},
+	artifactPatterns(platform) {
+		if (platform === "windows") return ["src-tauri/target/release/bundle/nsis/*.exe", "src-tauri/target/release/bundle/msi/*.msi"];
+		if (platform === "macos") return ["src-tauri/target/release/bundle/dmg/*.dmg", "src-tauri/target/release/bundle/macos/*.app"];
+		if (platform === "linux") return ["src-tauri/target/release/bundle/deb/*.deb", "src-tauri/target/release/bundle/appimage/*.AppImage"];
+		return [];
+	}
+};
+const knownFrameworkAdapters = [
+	rnAdapter,
+	flutterAdapter,
+	electronAdapter,
+	tauriAdapter,
+	nativeAndroidAdapter,
+	nativeIosAdapter,
+	nativeHarmonyAdapter
+];
+/** 按已知框架表探测建议（仅供 init/doctor 展示，不是发布依据） */
+function suggestFramework(cwd) {
+	for (const adapter of knownFrameworkAdapters) try {
+		if (adapter.detect(cwd)) return adapter;
+	} catch {}
+	return null;
+}
+function tauriFramework() {
+	return frameworkPlugin("framework-tauri", tauriAdapter);
+}
+//#endregion
+//#region src/channels/shared/redact.ts
+/**
+* 凭据脱敏（对拍 apkgo pkg/httptrace/redact.go 权威）。
+* 判定依据是“名字”：JSON 键 / 表单字段 / query 参数 / header 名携带凭据语义即整值掩码为
+* [REDACTED <len>]（保留长度线索），空串保持空串——“签名为空”本身就是排查线索。
+* 非敏感名下的值仍递归扫内容（signed URL / 内嵌 JSON / name=value 自由文本）。
+* 故意分歧：掩码不做 percent-encode（日志可读性优先）；JSON 再序列化保持原键序（Go map 序随机）。
+* 挂接点：CLI / 错误消息层接入（core 先提供能力）。
+*/
+/** 归一化后「包含即敏感」的词（对拍 redact.go sensitiveWords） */
+const SENSITIVE_WORDS = [
+	"secret",
+	"token",
+	"password",
+	"passwd",
+	"authorization",
+	"credential",
+	"cookie",
+	"privatekey",
+	"apikey",
+	"assertion",
+	"jwt",
+	"signature"
+];
+/** 归一化后全等即敏感的名字（对拍 redact.go sensitiveNames） */
+const SENSITIVE_NAMES = {
+	sig: true,
+	sign: true,
+	pwd: true,
+	auth: true
+};
+/** 名字是否携带凭据语义（JSON 键 / 表单字段 / query 参数 / header 名通用；归一化 = 小写去非字母数字） */
+function isSensitiveName(name) {
+	const n = name.toLowerCase().replace(/[^a-z0-9]/g, "");
+	if (n in SENSITIVE_NAMES) return true;
+	if (n === "tokentype" || n.startsWith("accesscontrol")) return false;
+	if (n.endsWith("sign") && n !== "design") return true;
+	return SENSITIVE_WORDS.some((w) => n.includes(w));
+}
+/** 整值掩码：保留长度；空串保持（“签名为空”是有效诊断信息）。3 处调用点需锁步一致 */
+function mask(v) {
+	return v === "" ? "" : `[REDACTED ${v.length}]`;
+}
+/**
+* 按名字脱敏单个值：敏感名 → 整值掩码；Authorization 保留 scheme（"Bearer [REDACTED 812]"，
+* 对拍 redact.go redactHeaders）；非敏感名 → 递归 redactText 扫值内凭据。
+*/
+function redactValue(name, v) {
+	if (/^authorization$/i.test(name) && v.includes(" ")) {
+		const schemeEnd = v.indexOf(" ");
+		return `${v.slice(0, schemeEnd)} ${mask(v.slice(schemeEnd + 1))}`;
+	}
+	return isSensitiveName(name) ? mask(v) : redactText(v);
+}
+/** redactURL：剥离 userinfo + query 参数按名脱敏，路径/fragment 原样保留 */
+function redactUrlString(v) {
+	let out = v.replace(/^(https?:\/\/)[^/?#]*@/, "$1");
+	const hashIdx = out.indexOf("#");
+	const hash = hashIdx >= 0 ? out.slice(hashIdx) : "";
+	if (hashIdx >= 0) out = out.slice(0, hashIdx);
+	const qIdx = out.indexOf("?");
+	if (qIdx < 0) return out + hash;
+	const query = new URLSearchParams(out.slice(qIdx + 1));
+	const pairs = [];
+	for (const [k, val] of query) pairs.push(`${k}=${isSensitiveName(k) ? mask(val) : val}`);
+	return `${out.slice(0, qIdx)}?${pairs.join("&")}${hash}`;
+}
+/** free 文本中的 name=value / "name":"value" 凭据对（对拍 redact.go scrubRe；掩码无长度） */
+const SCRUB_RE = /([\w.-]*(?:secret|token|password|passwd|signature|credential|authorization|api_?key|assertion)[\w.-]*"?\s*[=:]\s*"?)([^"&\s,;<}]+)/gi;
+/** JSON 树递归：敏感名下字符串掩码、数字/布尔置 [REDACTED]，数组元素继承外层键名 */
+function redactTree(name, v) {
+	if (v === null || typeof v !== "object") {
+		if (typeof v === "string") return redactValue(name, v);
+		return isSensitiveName(name) ? "[REDACTED]" : v;
+	}
+	if (Array.isArray(v)) return v.map((x) => redactTree(name, x));
+	const out = {};
+	for (const [k, val] of Object.entries(v)) out[k] = redactTree(k, val);
+	return out;
+}
+/**
+* 文本脱敏（三层层叠，逐层尝试）：
+*   1) http(s) URL 带 query/userinfo → query 按名脱敏 + 剥 userinfo
+*   2) { / [ 开头且整串为合法 JSON → 递归按键名脱敏
+*   3) 其余 → name=value 正则扫（错误消息等无结构文本）
+*/
+function redactText(v) {
+	if (/^https?:\/\//i.test(v) && (v.includes("?") || /^https?:\/\/[^/?#]*@/i.test(v))) return redactUrlString(v);
+	if (v.length > 1 && (v.startsWith("{") || v.startsWith("["))) try {
+		return JSON.stringify(redactTree("", JSON.parse(v)));
+	} catch {}
+	return v.replace(SCRUB_RE, "$1[REDACTED]");
+}
+//#endregion
+//#region src/version/project.ts
+/**
+* 工程文件版本读写（可接管模式：版本事实源永远是工程文件，applift 只代读代写）。
+* 只认标准模板形态（AGP/Xcode/DevEco/pubspec/package.json/tauri.conf）；行级改写、
+* 幂等（字段定位 + 写死目标值，不依赖旧值，跑 N 次 diff 不变——qy-driver sync-app-identity 同款模式）。
+* version catalog 引用形态（libs.versions.xxx.get()）读侧识别并标注 problem，不代写。
+*/
+function readText(p) {
+	try {
+		return fs.readFileSync(p, "utf8");
+	} catch {
+		return null;
+	}
+}
+function firstExisting(...paths) {
+	return paths.find((p) => fs.existsSync(p));
+}
+function locateIosProject(dir) {
+	const find = (d) => {
+		try {
+			return fs.readdirSync(d, { withFileTypes: true }).find((e) => e.isDirectory() && e.name.endsWith(".xcodeproj") && !e.name.startsWith(".") && e.name !== "Pods.xcodeproj");
+		} catch {
+			return;
+		}
+	};
+	let xcodeproj = find(dir);
+	let base = dir;
+	if (!xcodeproj) try {
+		const subs = fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules" && e.name !== "Pods");
+		for (const s of subs) {
+			xcodeproj = find(path.join(dir, s.name));
+			if (xcodeproj) {
+				base = path.join(dir, s.name);
+				break;
+			}
+		}
+	} catch {}
+	const pbxproj = xcodeproj ? path.join(base, xcodeproj.name, "project.pbxproj") : void 0;
+	const projDir = xcodeproj?.name.replace(/\.xcodeproj$/, "");
+	const plist = projDir && fs.existsSync(path.join(base, projDir, "Info.plist")) ? path.join(base, projDir, "Info.plist") : void 0;
+	return {
+		pbxproj: pbxproj && fs.existsSync(pbxproj) ? pbxproj : void 0,
+		plist
+	};
+}
+function locateVersionFiles(cwd, framework) {
+	const loc = {};
+	const id = framework?.id ?? "";
+	const tryAll = framework === null;
+	if (tryAll || id === "rn" || id === "native-android" || id === "flutter") loc.android = firstExisting(path.join(cwd, "android", "app", "build.gradle.kts"), path.join(cwd, "android", "app", "build.gradle"), path.join(cwd, "app", "build.gradle.kts"), path.join(cwd, "app", "build.gradle"));
+	if (tryAll || id === "rn" || id === "native-ios" || id === "flutter") {
+		const sub = locateIosProject(path.join(cwd, "ios"));
+		const root = sub.pbxproj ? sub : locateIosProject(cwd);
+		loc.ios = root.pbxproj;
+		loc.plist = root.plist;
+	}
+	if (tryAll || id === "rn" || id === "native-harmony" || id === "flutter") loc.harmony = firstExisting(path.join(cwd, "harmony", "AppScope", "app.json5"), path.join(cwd, "AppScope", "app.json5"));
+	if (tryAll || id === "flutter") loc.pubspec = fs.existsSync(path.join(cwd, "pubspec.yaml")) ? path.join(cwd, "pubspec.yaml") : void 0;
+	if (tryAll || id === "rn" || id === "electron") loc.packageJson = fs.existsSync(path.join(cwd, "package.json")) ? path.join(cwd, "package.json") : void 0;
+	if (tryAll || id === "tauri") {
+		loc.tauri = firstExisting(path.join(cwd, "src-tauri", "tauri.conf.json"), path.join(cwd, "src-tauri", "tauri.conf.json5"));
+		loc.packageJson = fs.existsSync(path.join(cwd, "package.json")) ? path.join(cwd, "package.json") : void 0;
+	}
+	if (id === "rn") {
+		const appJson = readText(path.join(cwd, "app.json"));
+		if (appJson && /"expo"\s*:/.test(appJson)) loc.expoAppJson = path.join(cwd, "app.json");
+	}
+	return loc;
+}
+function readGradle(file) {
+	const text = readText(file);
+	if (!text) return {};
+	const out = {};
+	const codeM = /(versionCode(?!Suffix)\s*=?\s*)(\d+)/.exec(text);
+	const nameM = /(versionName(?!Suffix)\s*=?\s*)("[^"]*"|'[^']*'|[\w.+-]+)/.exec(text);
+	if (codeM) out.versionCode = codeM[2];
+	if (nameM) {
+		const nameVal = nameM[2].replace(/^["']|["']$/g, "");
+		if (nameVal.startsWith("libs.versions.")) out.problem = "versionName 走 version catalog 引用（libs.versions.*）：非标准形态，请把版本字段搬回 app/build.gradle(.kts) 字面量";
+		else out.versionName = nameVal;
+	}
+	if (/(versionCode|versionName)\s*=?\s*libs\.versions\./.test(text) && !out.problem) out.problem = "版本字段走 version catalog 引用（libs.versions.*）：非标准形态，请把版本字段搬回 app/build.gradle(.kts) 字面量";
+	return out;
+}
+function readPbxproj(file) {
+	const text = readText(file);
+	if (!text) return {};
+	const names = [...text.matchAll(/MARKETING_VERSION\s*=\s*([^;]+);/g)].map((m) => m[1].trim());
+	return {
+		versionName: names[0],
+		versionCode: /CURRENT_PROJECT_VERSION\s*=\s*([^;]+);/.exec(text)?.[1]?.trim(),
+		problem: new Set(names).size > 1 ? `多 target MARKETING_VERSION 不一致（${[...new Set(names)].join(" / ")}）：读第一个，bump 时将全部同步` : void 0
+	};
+}
+function readPlist(file) {
+	const text = readText(file);
+	if (!text) return {};
+	const name = /<key>CFBundleShortVersionString<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1];
+	const code = /<key>CFBundleVersion<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1];
+	if (name && !name.startsWith("$")) return {
+		versionName: name,
+		versionCode: code
+	};
+	return {};
+}
+function readAppJson5(file) {
+	const text = readText(file);
+	if (!text) return {};
+	return {
+		versionName: /"versionName"\s*:\s*"([^"]+)"/.exec(text)?.[1],
+		versionCode: /"versionCode"\s*:\s*(\d+)/.exec(text)?.[1]
+	};
+}
+function readPubspec(file) {
+	const text = readText(file);
+	if (!text) return {};
+	const m = /^version:\s*(\S+)(?:\s*#.*)?$/m.exec(text);
+	if (!m) return {};
+	const [name, code] = m[1].split("+");
+	return {
+		versionName: name,
+		versionCode: code
+	};
+}
+function readJsonVersionKey(file) {
+	const text = readText(file);
+	if (!text) return {};
+	let best;
+	for (const m of text.matchAll(/^(\s*)"version"\s*:\s*"([^"]+)"\s*,?\s*$/gm)) {
+		const indent = m[1].length;
+		if (!best || indent < best.indent) best = {
+			indent,
+			value: m[2]
+		};
+	}
+	if (best) return { versionName: best.value };
+	try {
+		const obj = JSON.parse(text);
+		if (typeof obj.version === "string") return { versionName: obj.version };
+	} catch {}
+	const flat = /"version"\s*:\s*"([^"]+)"/.exec(text)?.[1];
+	return flat ? { versionName: flat } : {};
+}
+function readExpoAppJson(file) {
+	const text = readText(file);
+	if (!text) return {};
+	return {
+		versionName: /"version"\s*:\s*"([^"]+)"/.exec(text)?.[1],
+		versionCode: /"versionCode"\s*:\s*(\d+)/.exec(text)?.[1] ?? /"buildNumber"\s*:\s*"([^"]+)"/.exec(text)?.[1]
+	};
+}
+/** 各端版本实况（按框架布局；未识别框架时尝试全部标准位置） */
+function readProjectVersions(cwd, framework) {
+	const loc = locateVersionFiles(cwd, framework);
+	const out = [];
+	if (loc.android) out.push({
+		platform: "android",
+		file: loc.android,
+		kind: "gradle",
+		...readGradle(loc.android)
+	});
+	if (loc.ios) out.push({
+		platform: "ios",
+		file: loc.ios,
+		kind: "pbxproj",
+		...readPbxproj(loc.ios)
+	});
+	else if (loc.plist) {
+		const plist = readPlist(loc.plist);
+		if (plist.versionName) out.push({
+			platform: "ios",
+			file: loc.plist,
+			kind: "pbxproj",
+			...plist,
+			problem: "未找到 pbxproj，读 Info.plist 字面量"
+		});
+	}
+	if (loc.harmony) out.push({
+		platform: "harmony",
+		file: loc.harmony,
+		kind: "app-json5",
+		...readAppJson5(loc.harmony)
+	});
+	if (loc.pubspec) out.push({
+		platform: "flutter",
+		file: loc.pubspec,
+		kind: "pubspec",
+		...readPubspec(loc.pubspec)
+	});
+	if (loc.packageJson) out.push({
+		platform: "js",
+		file: loc.packageJson,
+		kind: "package-json",
+		...readJsonVersionKey(loc.packageJson)
+	});
+	if (loc.tauri) out.push({
+		platform: "tauri",
+		file: loc.tauri,
+		kind: "tauri",
+		...readJsonVersionKey(loc.tauri)
+	});
+	if (loc.expoAppJson) out.push({
+		platform: "expo",
+		file: loc.expoAppJson,
+		kind: "expo-app-json",
+		...readExpoAppJson(loc.expoAppJson)
+	});
+	return out;
+}
+/** 指定捕获组替换为 value（其余组原样保留；约定各正则组外无字面量） */
+function replaceGroup(re, text, group, value) {
+	let count = 0;
+	return {
+		text: text.replace(re, (_m, ...groups) => {
+			count++;
+			const g = groups.slice(0, -2);
+			g[group - 1] = value;
+			return g.join("");
+		}),
+		count
+	};
+}
+function writeIfChanged(file, next) {
+	if (readText(file) === next) return false;
+	fs.writeFileSync(file, next, "utf8");
+	return true;
+}
+function writeGradle(file, w) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	if (/version(Code|Name)\s*=?\s*libs\.versions\./.test(text)) throw new Error(`${file} 的版本字段是 version catalog 引用形态：请先改造为字面量（applift 只写标准形态）`);
+	let next = text;
+	const code = replaceGroup(/(versionCode(?!Suffix)\s*=?\s*)(\d+)/g, next, 2, String(w.versionCode));
+	next = code.text;
+	const name = replaceGroup(/(versionName(?!Suffix)\s*=?\s*)("[^"]*"|'[^']*'|[\w.+-]+)/g, next, 2, `"${w.versionName}"`);
+	next = name.text;
+	if (code.count === 0 && name.count === 0) throw new Error(`${file} 未找到 versionCode/versionName 字面量`);
+	return writeIfChanged(file, next);
+}
+function writePbxproj(file, w) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	let next = text;
+	const name = replaceGroup(/(MARKETING_VERSION\s*=\s*)([^;]+)(;)/g, next, 2, w.versionName);
+	next = name.text;
+	const code = replaceGroup(/(CURRENT_PROJECT_VERSION\s*=\s*)([^;]+)(;)/g, next, 2, String(w.versionCode));
+	next = code.text;
+	if (name.count === 0 && code.count === 0) throw new Error(`${file} 未找到 MARKETING_VERSION/CURRENT_PROJECT_VERSION`);
+	return writeIfChanged(file, next);
+}
+function writeAppJson5(file, w) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	let next = text;
+	const name = replaceGroup(/("versionName"\s*:\s*")([^"]+)(")/g, next, 2, w.versionName);
+	next = name.text;
+	const code = replaceGroup(/("versionCode"\s*:\s*)(\d+)/g, next, 2, String(w.versionCode));
+	next = code.text;
+	if (name.count === 0 && code.count === 0) throw new Error(`${file} 未找到 versionName/versionCode`);
+	return writeIfChanged(file, next);
+}
+function writePubspec(file, w) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	if (!/^version:\s*\S+/m.test(text)) throw new Error(`${file} 未找到 version: 行`);
+	return writeIfChanged(file, text.replace(/^version:[^\n#]*?(\s*)(#.*)?$/m, (_m, gap, comment) => `version: ${w.versionName}+${w.versionCode}${comment ? gap ?? " " : ""}${comment ?? ""}`));
+}
+/** JSON 顶层 version 键改写（两遍：先定位最小缩进行，再只改该行——单遍回调在嵌套键
+*  先出现时会把它一并改写，篡改依赖声明）。单行 JSON 回退首个匹配。 */
+function writeJsonVersionKey(file, versionName) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	const lines = text.split("\n");
+	const re = /^(\s*)"version"\s*:\s*"([^"]+)"(\s*,?\s*)$/;
+	let target = -1;
+	let bestIndent = Number.POSITIVE_INFINITY;
+	for (let i = 0; i < lines.length; i++) {
+		const m = re.exec(lines[i]);
+		if (!m) continue;
+		const ind = m[1].length;
+		if (ind < bestIndent) {
+			bestIndent = ind;
+			target = i;
+		}
+	}
+	let next;
+	if (target >= 0) {
+		const m = re.exec(lines[target]);
+		lines[target] = `${m[1]}"version": "${versionName}"${m[3]}`;
+		next = lines.join("\n");
+	} else {
+		let topVersion;
+		try {
+			const obj = JSON.parse(text);
+			if (typeof obj.version === "string") topVersion = obj.version;
+		} catch {}
+		const esc = (topVersion ?? "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		const re1 = topVersion ? new RegExp(`"version"\\s*:\\s*"${esc}"`) : /"version"\s*:\s*"([^"]+)"/;
+		if (!re1.test(text)) throw new Error(`${file} 未找到 "version" 键`);
+		next = text.replace(re1, `"version": "${versionName}"`);
+	}
+	return writeIfChanged(file, next);
+}
+function writeExpoAppJson(file, w) {
+	const text = readText(file);
+	if (!text) throw new Error(`无法读取 ${file}`);
+	const v = replaceGroup(/("version"\s*:\s*")([^"]+)(")/g, text, 2, w.versionName);
+	if (v.count === 0) throw new Error(`${file} 未找到 expo "version" 键`);
+	let next = v.text;
+	next = replaceGroup(/("versionCode"\s*:\s*)(\d+)/g, next, 2, String(w.versionCode)).text;
+	next = replaceGroup(/("buildNumber"\s*:\s*")([^"]+)(")/g, next, 2, String(w.versionCode)).text;
+	return writeIfChanged(file, next);
+}
+/**
+* 写回各端版本（多端 versionName 同步、versionCode 各端独立）。
+* 返回实际改动的文件列表（commit 范围）。problem 端跳过并在返回中列出（不阻断其他端）。
+*/
+function writeProjectVersions(cwd, framework, writes) {
+	const loc = locateVersionFiles(cwd, framework);
+	const changed = [];
+	const skipped = [];
+	const plat = new Map(writes.map((w) => [w.platform, w]));
+	const apply = (file, fn, key) => {
+		if (!file) {
+			const w = plat.get(key);
+			if (w) skipped.push({
+				platform: w.platform,
+				reason: `未找到版本文件（${key}）`
+			});
+			return;
+		}
+		try {
+			if (fn(file)) changed.push(file);
+		} catch (e) {
+			const code = e.code;
+			if (code === "EACCES" || code === "EPERM") throw e;
+			skipped.push({
+				platform: key,
+				reason: e.message
+			});
+		}
+	};
+	if (plat.has("android")) apply(loc.android, (f) => writeGradle(f, plat.get("android")), "android");
+	if (plat.has("ios")) apply(loc.ios, (f) => writePbxproj(f, plat.get("ios")), "ios");
+	if (plat.has("harmony")) apply(loc.harmony, (f) => writeAppJson5(f, plat.get("harmony")), "harmony");
+	if (plat.has("flutter")) apply(loc.pubspec, (f) => writePubspec(f, plat.get("flutter")), "flutter");
+	if (plat.has("js")) apply(loc.packageJson, (f) => writeJsonVersionKey(f, plat.get("js").versionName), "js");
+	if (plat.has("tauri")) apply(loc.tauri, (f) => writeJsonVersionKey(f, plat.get("tauri").versionName), "tauri");
+	if (plat.has("expo")) apply(loc.expoAppJson, (f) => writeExpoAppJson(f, plat.get("expo")), "expo");
+	return {
+		changed: [...new Set(changed)],
+		skipped
+	};
+}
+//#endregion
+export { readJson as C, findArtifacts as S, subdirs as T, suggestFramework as _, electronFramework as a, deps as b, knownFrameworkAdapters as c, nativeHarmonyAdapter as d, nativeHarmonyFramework as f, rnFramework as g, rnAdapter as h, electronAdapter as i, nativeAndroidAdapter as l, nativeIosFramework as m, writeProjectVersions as n, flutterAdapter as o, nativeIosAdapter as p, redactText as r, flutterFramework as s, readProjectVersions as t, nativeAndroidFramework as u, tauriAdapter as v, resolveFramework as w, detectBundleIds as x, tauriFramework as y };