weapp-tailwindcss 5.0.0-next.3 → 5.0.0-next.7

package/dist/cli.js

@@ -30,13 +30,13 @@ node_path = __toESM(node_path);
 let node_fs_promises = require("node:fs/promises");
 let _weapp_tailwindcss_logger = require("@weapp-tailwindcss/logger");
 let lru_cache = require("lru-cache");
-let _weapp_tailwindcss_shared_node = require("@weapp-tailwindcss/shared/node");
+require("@weapp-tailwindcss/shared/node");
 let _weapp_core_escape = require("@weapp-core/escape");
 require("@weapp-tailwindcss/shared");
 let debug = require("debug");
 debug = __toESM(debug);
-let node_fs = require("node:fs");
 let node_module = require("node:module");
+let node_fs = require("node:fs");
 require("@weapp-tailwindcss/postcss");
 let _babel_traverse = require("@babel/traverse");
 _babel_traverse = __toESM(_babel_traverse);
@@ -48,260 +48,36 @@ let _ast_core_escape = require("@ast-core/escape");
 let _weapp_tailwindcss_shared_extractors = require("@weapp-tailwindcss/shared/extractors");
 require("@babel/types");
 require("htmlparser2");
-let local_pkg = require("local-pkg");
-let fast_glob = require("fast-glob");
-fast_glob = __toESM(fast_glob);
-let yaml = require("yaml");
 //#region src/debug/index.ts
 const _debug = (0, debug.default)("weapp-tw");
 function createDebug(prefix) {
-	const debug$3 = ((formatter, ...args) => {
+	const debug$4 = ((formatter, ...args) => {
 		return _debug((prefix ?? "") + formatter, ...args);
 	});
-	Object.defineProperty(debug$3, "enabled", {
+	Object.defineProperty(debug$4, "enabled", {
 		enumerable: false,
 		configurable: false,
 		get() {
 			return _debug.enabled;
 		}
 	});
-	return debug$3;
+	return debug$4;
 }
+createDebug("[tailwindcss:runtime-patch] ");
+(0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
 createDebug("[tailwindcss:runtime] ");
 //#endregion
 //#region src/tailwindcss/runtime-logs.ts
 const runtimeLogDedupeHolder = globalThis;
-const runtimeLogDedupe = runtimeLogDedupeHolder.__WEAPP_TW_RUNTIME_LOG_DEDUPE__ ?? (runtimeLogDedupeHolder.__WEAPP_TW_RUNTIME_LOG_DEDUPE__ = /* @__PURE__ */ new Set());
-function createRuntimeLogKey(category, baseDir, rootPath, version) {
-	return JSON.stringify([
-		category,
-		baseDir ?? node_process.default.cwd(),
-		rootPath ?? "",
-		version ?? ""
-	]);
-}
-function markRuntimeLog(category, baseDir, rootPath, version) {
-	const key = createRuntimeLogKey(category, baseDir, rootPath, version);
-	if (runtimeLogDedupe.has(key)) return false;
-	runtimeLogDedupe.add(key);
-	return true;
-}
-function logRuntimeTailwindcssTarget(baseDir, rootPath, version) {
-	if (!markRuntimeLog("target", baseDir, rootPath, version)) return;
-	const versionText = version ? ` (v${version})` : "";
-	_weapp_tailwindcss_logger.logger.info("%s 使用 Tailwind CSS%s", "Weapp-tailwindcss", versionText);
-}
-//#endregion
-//#region src/context/workspace.ts
-function findWorkspaceRoot(startDir) {
-	if (!startDir) return;
-	let current = node_path.default.resolve(startDir);
-	while (true) {
-		if ((0, node_fs.existsSync)(node_path.default.join(current, "pnpm-workspace.yaml"))) return current;
-		const parent = node_path.default.dirname(current);
-		if (parent === current) return;
-		current = parent;
-	}
-}
-function findNearestPackageRoot(startDir) {
-	if (!startDir) return;
-	let current = node_path.default.resolve(startDir);
-	while (true) {
-		if ((0, node_fs.existsSync)(node_path.default.join(current, "package.json"))) return current;
-		const parent = node_path.default.dirname(current);
-		if (parent === current) return;
-		current = parent;
-	}
-}
-//#endregion
-//#region src/tailwindcss/targets/paths.ts
-const PATCH_INFO_FILENAME = "tailwindcss-target.json";
-const PATCH_INFO_CACHE_RELATIVE_PATH = node_path.default.join("node_modules", ".cache", "weapp-tailwindcss", PATCH_INFO_FILENAME);
-const PATCH_INFO_LEGACY_RELATIVE_PATH = node_path.default.join(".tw-patch", PATCH_INFO_FILENAME);
-function toDisplayPath(value) {
-	return node_path.default.normalize(value).replace(/\\/g, "/");
-}
-function formatRelativeToBase(targetPath, baseDir) {
-	if (!baseDir) return toDisplayPath(targetPath);
-	const relative = node_path.default.relative(baseDir, targetPath);
-	if (!relative || relative === ".") return ".";
-	if (relative.startsWith("..")) return toDisplayPath(targetPath);
-	return toDisplayPath(node_path.default.join(".", relative));
-}
-function resolveRecordLocation(baseDir) {
-	const normalizedBase = node_path.default.normalize(baseDir);
-	const packageRoot = findNearestPackageRoot(normalizedBase) ?? normalizedBase;
-	const packageJsonPath = node_path.default.join(packageRoot, "package.json");
-	const hasPackageJson = (0, node_fs.existsSync)(packageJsonPath);
-	const recordKeySource = hasPackageJson ? packageJsonPath : normalizedBase;
-	const recordKey = (0, _weapp_tailwindcss_shared_node.md5)(node_path.default.normalize(recordKeySource));
-	const recordDir = node_path.default.join(packageRoot, "node_modules", ".cache", "weapp-tailwindcss", recordKey);
-	return {
-		normalizedBase,
-		packageRoot,
-		recordDir,
-		recordKey,
-		recordPath: node_path.default.join(recordDir, PATCH_INFO_FILENAME),
-		packageJsonPath: hasPackageJson ? packageJsonPath : void 0
-	};
-}
-function getRecordFileCandidates(baseDir) {
-	const { normalizedBase, packageRoot, recordPath } = resolveRecordLocation(baseDir);
-	return [...new Set([
-		recordPath,
-		node_path.default.join(packageRoot, PATCH_INFO_CACHE_RELATIVE_PATH),
-		node_path.default.join(normalizedBase, PATCH_INFO_CACHE_RELATIVE_PATH),
-		node_path.default.join(normalizedBase, PATCH_INFO_LEGACY_RELATIVE_PATH)
-	])];
-}
-//#endregion
-//#region package.json
-var version = "5.0.0-next.3";
-//#endregion
-//#region src/constants.ts
-const WEAPP_TW_REQUIRED_NODE_VERSION_RANGE = "^20.19.0 || >=22.12.0";
-const WEAPP_TW_VERSION = version;
-//#endregion
-//#region src/tailwindcss/targets/record-io.ts
-const loggedInvalidPatchRecords = /* @__PURE__ */ new Set();
-function warnInvalidPatchTargetRecord(baseDir, recordPath, reason) {
-	const normalizedPath = node_path.default.normalize(recordPath);
-	if (loggedInvalidPatchRecords.has(normalizedPath)) return;
-	loggedInvalidPatchRecords.add(normalizedPath);
-	const fileDisplay = formatRelativeToBase(normalizedPath, baseDir);
-	const baseDisplay = formatRelativeToBase(node_path.default.normalize(baseDir), node_process.default.cwd());
-	const reasonMessage = reason ? `：${reason}` : "";
-	_weapp_tailwindcss_logger.logger.warn(`检测到损坏的 Tailwind CSS 目标记录 ${fileDisplay}${reasonMessage}。请在 ${baseDisplay} 重新执行 "weapp-tw patch --record-target" 或删除该文件后再运行。`);
-}
-function readPatchTargetRecord(baseDir) {
-	if (!baseDir) return;
-	const normalizedBase = node_path.default.normalize(baseDir);
-	for (const recordPath of getRecordFileCandidates(normalizedBase)) {
-		if (!(0, node_fs.existsSync)(recordPath)) continue;
-		try {
-			const content = (0, node_fs.readFileSync)(recordPath, "utf8");
-			const parsed = JSON.parse(content);
-			if (!parsed || typeof parsed.tailwindPackagePath !== "string") {
-				warnInvalidPatchTargetRecord(normalizedBase, recordPath, "缺少 tailwindPackagePath 字段");
-				continue;
-			}
-			return {
-				baseDir: normalizedBase,
-				path: recordPath,
-				record: parsed
-			};
-		} catch (error) {
-			warnInvalidPatchTargetRecord(normalizedBase, recordPath, error instanceof Error ? error.message : String(error));
-			continue;
-		}
-	}
-}
-async function saveCliPatchTargetRecord(baseDir, patcher, options) {
-	if (!baseDir || !patcher?.packageInfo?.rootPath) return;
-	const normalizedBase = node_path.default.normalize(baseDir);
-	const location = resolveRecordLocation(normalizedBase);
-	const recordPath = options?.recordPath ? node_path.default.normalize(options.recordPath) : location.recordPath;
-	const record = {
-		tailwindPackagePath: node_path.default.normalize(patcher.packageInfo.rootPath),
-		packageVersion: patcher.packageInfo.version,
-		recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		source: options?.source ?? "cli",
-		tailwindcssBasedir: normalizedBase,
-		cwd: options?.cwd ? node_path.default.normalize(options.cwd) : normalizedBase,
-		patchVersion: WEAPP_TW_VERSION,
-		packageJsonPath: options?.packageJsonPath ?? location.packageJsonPath,
-		recordKey: options?.recordKey ?? location.recordKey
-	};
-	try {
-		await (0, node_fs_promises.mkdir)(node_path.default.dirname(recordPath), { recursive: true });
-		await (0, node_fs_promises.writeFile)(recordPath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
-		return recordPath;
-	} catch (error) {
-		const baseDisplay = formatRelativeToBase(normalizedBase, node_process.default.cwd());
-		_weapp_tailwindcss_logger.logger.warn("自动更新 Tailwind CSS 补丁记录失败，请在 %s 运行 \"weapp-tw patch --cwd %s\"。", baseDisplay, normalizedBase);
-		_weapp_tailwindcss_logger.logger.debug("failed to persist patch target record %s: %O", recordPath, error);
-		return;
-	}
-}
-//#endregion
-//#region src/tailwindcss/targets/recorder.ts
-function findPatchTargetRecord(baseDir) {
-	const visited = /* @__PURE__ */ new Set();
-	const fallback = baseDir ?? node_process.default.cwd();
-	let current = node_path.default.resolve(fallback);
-	while (!visited.has(current)) {
-		const record = readPatchTargetRecord(current);
-		if (record) return record;
-		const parent = node_path.default.dirname(current);
-		if (parent === current) break;
-		visited.add(current);
-		current = parent;
-	}
-}
-function createPatchTargetRecorder(baseDir, patcher, options) {
-	if (!baseDir || !patcher?.packageInfo?.rootPath || options?.recordTarget === false) return;
-	const normalizedBase = node_path.default.normalize(baseDir);
-	const recorded = findPatchTargetRecord(normalizedBase);
-	const location = resolveRecordLocation(normalizedBase);
-	const expectedPath = node_path.default.normalize(patcher.packageInfo.rootPath);
-	let reason;
-	if (!recorded) reason = "missing";
-	else if (node_path.default.normalize(recorded.record.tailwindPackagePath) !== expectedPath) reason = "mismatch";
-	else if (node_path.default.normalize(recorded.path) !== node_path.default.normalize(location.recordPath) || !recorded.record.recordKey || recorded.record.recordKey !== location.recordKey) reason = "migrate";
-	else if (!recorded.record.patchVersion || recorded.record.patchVersion !== WEAPP_TW_VERSION) reason = "stale";
-	else if (options?.cwd && recorded.record.cwd && node_path.default.normalize(recorded.record.cwd) !== node_path.default.normalize(options.cwd)) reason = "metadata";
-	else if (!recorded.record.cwd && options?.cwd) reason = "metadata";
-	if (!(options?.alwaysRecord || !recorded || Boolean(reason))) return;
-	let message;
-	switch (reason) {
-		case "mismatch":
-			message = "检测到 Tailwind CSS 目标记录与当前解析结果不一致，正在自动重新 patch 并刷新缓存。";
-			break;
-		case "migrate":
-		case "stale":
-			message = "正在刷新当前子包的 Tailwind CSS 补丁记录，确保缓存隔离。";
-			break;
-		case "missing":
-			message = "未找到当前子包的 Tailwind CSS 目标记录，正在生成。";
-			break;
-		default: break;
-	}
-	const onPatched = async () => saveCliPatchTargetRecord(normalizedBase, patcher, {
-		cwd: options?.cwd ?? normalizedBase,
-		source: options?.source ?? "cli",
-		recordPath: location.recordPath,
-		recordKey: location.recordKey,
-		packageJsonPath: location.packageJsonPath
-	});
-	return {
-		recordPath: location.recordPath,
-		message,
-		reason,
-		onPatched
-	};
-}
-//#endregion
-//#region src/tailwindcss/targets.ts
-function logTailwindcssTarget(kind, patcher, baseDir) {
-	const packageInfo = patcher?.packageInfo;
-	const label = kind === "cli" ? "weapp-tw patch" : "Weapp-tailwindcss";
-	if (!packageInfo?.rootPath) {
-		_weapp_tailwindcss_logger.logger.warn("%s 未找到 Tailwind CSS 依赖，请检查在 %s 是否已安装 tailwindcss", label, baseDir ?? node_process.default.cwd());
-		return;
-	}
-	const displayPath = formatRelativeToBase(packageInfo.rootPath, baseDir);
-	const version = packageInfo.version ? ` (v${packageInfo.version})` : "";
-	if (kind === "runtime") {
-		logRuntimeTailwindcssTarget(baseDir, packageInfo.rootPath, packageInfo.version);
-		return;
-	}
-	_weapp_tailwindcss_logger.logger.info("%s 绑定 Tailwind CSS -> %s%s", label, displayPath, version);
-}
+runtimeLogDedupeHolder.__WEAPP_TW_RUNTIME_LOG_DEDUPE__ ?? (runtimeLogDedupeHolder.__WEAPP_TW_RUNTIME_LOG_DEDUPE__ = /* @__PURE__ */ new Set());
 //#endregion
 //#region src/context/compiler-context-cache.ts
 const globalCacheHolder = globalThis;
 globalCacheHolder.__WEAPP_TW_COMPILER_CONTEXT_CACHE__ ?? (globalCacheHolder.__WEAPP_TW_COMPILER_CONTEXT_CACHE__ = /* @__PURE__ */ new Map());
 //#endregion
+//#region src/constants.ts
+const WEAPP_TW_REQUIRED_NODE_VERSION_RANGE = "^20.19.0 || >=22.12.0";
+//#endregion
 //#region src/babel/index.ts
 function _interopDefaultCompat(e) {
 	return e && typeof e === "object" && "default" in e ? e.default : e;
@@ -933,6 +709,44 @@ function walkEvalExpression(path, options, updater, handler) {
 	}
 }
 //#endregion
+//#region \0@oxc-project+runtime@0.129.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.129.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.129.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.129.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
 //#region src/js/JsTokenUpdater.ts
 /**
 * Lightweight helper that batches updates to {@link MagicString}.
@@ -941,6 +755,7 @@ function walkEvalExpression(path, options, updater, handler) {
 */
 var JsTokenUpdater = class {
 	constructor({ value } = {}) {
+		_defineProperty(this, "tokens", void 0);
 		this.tokens = value ? [...value] : [];
 	}
 	addToken(token) {
@@ -974,7 +789,7 @@ var JsTokenUpdater = class {
 var IgnoredExportsTracker = class {
 	constructor(options) {
 		this.options = options;
-		this.ignoredExportNames = /* @__PURE__ */ new Map();
+		_defineProperty(this, "ignoredExportNames", /* @__PURE__ */ new Map());
 	}
 	addIgnoredExport(filename, exportName) {
 		if (!exportName) return;
@@ -1093,8 +908,16 @@ var IgnoredExportsTracker = class {
 //#region src/js/ModuleGraph.ts
 var JsModuleGraph = class {
 	constructor(entry, graphOptions) {
-		this.modules = /* @__PURE__ */ new Map();
-		this.queue = [];
+		_defineProperty(this, "modules", /* @__PURE__ */ new Map());
+		_defineProperty(this, "queue", []);
+		_defineProperty(this, "resolve", void 0);
+		_defineProperty(this, "load", void 0);
+		_defineProperty(this, "filter", void 0);
+		_defineProperty(this, "maxDepth", void 0);
+		_defineProperty(this, "baseOptions", void 0);
+		_defineProperty(this, "parserOptions", void 0);
+		_defineProperty(this, "rootFilename", void 0);
+		_defineProperty(this, "ignoredExports", void 0);
 		this.resolve = graphOptions.resolve;
 		this.load = graphOptions.load;
 		this.filter = graphOptions.filter;
@@ -1266,6 +1089,12 @@ const NEVER_MATCH_NAME = () => false;
 */
 var NodePathWalker = class {
 	constructor({ ignoreCallExpressionIdentifiers, callback } = {}) {
+		_defineProperty(this, "ignoreCallExpressionIdentifiers", void 0);
+		_defineProperty(this, "callback", void 0);
+		_defineProperty(this, "isIgnoredCallIdentifier", void 0);
+		_defineProperty(this, "hasIgnoredCallIdentifiers", void 0);
+		_defineProperty(this, "importsStore", void 0);
+		_defineProperty(this, "visitedStore", void 0);
 		this.hasIgnoredCallIdentifiers = Boolean(ignoreCallExpressionIdentifiers && ignoreCallExpressionIdentifiers.length > 0);
 		this.ignoreCallExpressionIdentifiers = ignoreCallExpressionIdentifiers ?? EMPTY_IGNORE_CALL_EXPRESSION_IDENTIFIERS;
 		this.callback = callback ?? NOOP_STRING_PATH_CALLBACK;
@@ -1673,6 +1502,13 @@ function isWhitespace(char) {
 //#region src/wxml/Tokenizer.ts
 var Tokenizer = class {
 	constructor() {
+		_defineProperty(this, "state", void 0);
+		_defineProperty(this, "buffer", void 0);
+		_defineProperty(this, "tokens", void 0);
+		_defineProperty(this, "bufferStartIndex", void 0);
+		_defineProperty(this, "expressionStartIndex", void 0);
+		_defineProperty(this, "expressionBuffer", void 0);
+		_defineProperty(this, "expressions", void 0);
 		this.reset();
 	}
 	processChar(char, index) {
@@ -1787,36 +1623,6 @@ var Tokenizer = class {
 };
 new Tokenizer();
 //#endregion
-//#region src/context/index.ts
-async function clearTailwindcssPatcherCache(patcher, options) {
-	if (!patcher) return;
-	const cacheOptions = patcher.options?.cache;
-	if (cacheOptions == null || typeof cacheOptions === "object" && cacheOptions.enabled === false) return;
-	if (typeof patcher.clearCache === "function") try {
-		await patcher.clearCache({ scope: "all" });
-	} catch (error) {
-		_weapp_tailwindcss_logger.logger.debug("failed to clear tailwindcss patcher cache via clearCache(): %O", error);
-	}
-	if (!options?.removeDirectory) return;
-	const cachePaths = /* @__PURE__ */ new Map();
-	const normalizedCacheOptions = typeof cacheOptions === "object" ? cacheOptions : void 0;
-	if (normalizedCacheOptions?.path) cachePaths.set(normalizedCacheOptions.path, false);
-	const privateCachePath = patcher?.cacheStore?.options?.path;
-	if (privateCachePath) cachePaths.set(privateCachePath, false);
-	if (options?.removeDirectory && normalizedCacheOptions?.dir) cachePaths.set(normalizedCacheOptions.dir, true);
-	if (!cachePaths.size) return;
-	for (const [cachePath, recursive] of cachePaths.entries()) try {
-		await (0, node_fs_promises.rm)(cachePath, {
-			force: true,
-			recursive
-		});
-	} catch (error) {
-		const err = error;
-		if (err?.code === "ENOENT") continue;
-		_weapp_tailwindcss_logger.logger.debug("failed to clear tailwindcss patcher cache: %s %O", cachePath, err);
-	}
-}
-//#endregion
 //#region src/cli/context.ts
 function formatOutputPath(target, baseDir) {
 	const root = baseDir ?? node_process.default.cwd();
@@ -1860,7 +1666,7 @@ const FRAMEWORK_DEPS = [
 ];
 //#endregion
 //#region src/cli/doctor.ts
-function tryReadJson$1(file) {
+function tryReadJson(file) {
 	try {
 		return JSON.parse((0, node_fs.readFileSync)(file, "utf8"));
 	} catch {
@@ -1871,11 +1677,11 @@ function findFirstExisting(cwd, files) {
 	return files.find((file) => (0, node_fs.existsSync)(node_path.default.join(cwd, file)));
 }
 function readProjectPackageJson(cwd) {
-	return tryReadJson$1(node_path.default.join(cwd, "package.json"));
+	return tryReadJson(node_path.default.join(cwd, "package.json"));
 }
 function readDependencyVersion(cwd, packageName) {
 	try {
-		return tryReadJson$1((0, node_module.createRequire)(node_path.default.join(cwd, "package.json")).resolve(`${packageName}/package.json`))?.version;
+		return tryReadJson((0, node_module.createRequire)(node_path.default.join(cwd, "package.json")).resolve(`${packageName}/package.json`))?.version;
 	} catch {
 		return;
 	}
@@ -2118,43 +1924,6 @@ function resolveCliCwd(value) {
 	return node_path.default.isAbsolute(raw) ? node_path.default.normalize(raw) : node_path.default.resolve(node_process.default.cwd(), raw);
 }
 //#endregion
-//#region src/tailwindcss/index.ts
-function getTailwindcssPackageInfo(options) {
-	return (0, local_pkg.getPackageInfoSync)("tailwindcss", options);
-}
-//#endregion
-//#region src/cli/helpers/patch-cwd.ts
-/**
-* Resolve default working directory for `weapp-tw patch`.
-* Prefer explicit env overrides to avoid cross-package INIT_CWD pollution.
-*/
-function normalizeCandidatePath(baseDir, candidate) {
-	if (!candidate) return;
-	return node_path.default.isAbsolute(candidate) ? node_path.default.normalize(candidate) : node_path.default.resolve(baseDir, candidate);
-}
-function detectTailwindWorkspace(paths) {
-	for (const candidate of paths) try {
-		if (getTailwindcssPackageInfo({ paths: [candidate] })?.rootPath) return candidate;
-	} catch {}
-}
-function resolvePatchDefaultCwd(currentCwd = node_process.default.cwd()) {
-	const baseDir = node_path.default.normalize(currentCwd);
-	const explicitCwd = normalizeCandidatePath(baseDir, node_process.default.env.WEAPP_TW_PATCH_CWD);
-	if (explicitCwd) return explicitCwd;
-	const workspaceRoot = findWorkspaceRoot(baseDir);
-	const initCwd = normalizeCandidatePath(baseDir, node_process.default.env.INIT_CWD);
-	const localPrefix = normalizeCandidatePath(baseDir, node_process.default.env.npm_config_local_prefix);
-	const candidates = [
-		baseDir,
-		workspaceRoot,
-		initCwd,
-		localPrefix
-	].filter(Boolean);
-	const detected = detectTailwindWorkspace([...new Set(candidates)]);
-	if (detected) return detected;
-	return initCwd ?? localPrefix ?? workspaceRoot ?? baseDir;
-}
-//#endregion
 //#region src/cli/helpers.ts
 async function ensureDir(dir) {
 	await (0, node_fs_promises.mkdir)(dir, { recursive: true });
@@ -2176,212 +1945,11 @@ function commandAction(handler) {
 	};
 }
 //#endregion
-//#region src/cli/mount-options/patch-status.ts
-function formatStatusFilesHint(files) {
-	if (!files?.length) return "";
-	return ` (${files.join(", ")})`;
-}
-function logPatchStatusReport(report) {
-	const applied = report.entries.filter((entry) => entry.status === "applied");
-	const pending = report.entries.filter((entry) => entry.status === "not-applied");
-	const skipped = report.entries.filter((entry) => entry.status === "skipped" || entry.status === "unsupported");
-	const packageLabel = `${report.package.name ?? "tailwindcss"}@${report.package.version ?? "unknown"}`;
-	_weapp_tailwindcss_logger.logger.info(`Patch status for ${packageLabel} (v${report.majorVersion})`);
-	if (applied.length) {
-		_weapp_tailwindcss_logger.logger.success("Applied:");
-		applied.forEach((entry) => {
-			_weapp_tailwindcss_logger.logger.success(`  - ${entry.name}${formatStatusFilesHint(entry.files)}`);
-		});
-	}
-	if (pending.length) {
-		_weapp_tailwindcss_logger.logger.warn("Needs attention:");
-		pending.forEach((entry) => {
-			const details = entry.reason ? ` - ${entry.reason}` : "";
-			_weapp_tailwindcss_logger.logger.warn(`  - ${entry.name}${formatStatusFilesHint(entry.files)}${details}`);
-		});
-	} else _weapp_tailwindcss_logger.logger.success("All applicable patches are applied.");
-	if (skipped.length) {
-		_weapp_tailwindcss_logger.logger.info("Skipped:");
-		skipped.forEach((entry) => {
-			const details = entry.reason ? ` - ${entry.reason}` : "";
-			_weapp_tailwindcss_logger.logger.info(`  - ${entry.name}${details}`);
-		});
-	}
-}
-//#endregion
-//#region src/cli/patch-options.ts
-const DEFAULT_EXTEND_LENGTH_UNITS_FEATURE = {
-	enabled: true,
-	units: ["rpx"],
-	overwrite: true
-};
-function withDefaultExtendLengthUnits(options) {
-	const normalized = options ?? {};
-	if (normalized.apply?.extendLengthUnits == null) return {
-		...normalized,
-		apply: {
-			...normalized.apply ?? {},
-			extendLengthUnits: DEFAULT_EXTEND_LENGTH_UNITS_FEATURE
-		}
-	};
-	return normalized;
-}
-function buildExtendLengthUnitsOverride(options) {
-	if (options?.apply?.extendLengthUnits == null) return { apply: {
-		...options?.apply ?? {},
-		extendLengthUnits: DEFAULT_EXTEND_LENGTH_UNITS_FEATURE
-	} };
-}
-//#endregion
-//#region src/cli/workspace/workspace-io.ts
-function tryReadJson(file) {
-	try {
-		const content = (0, node_fs.readFileSync)(file, "utf8");
-		return JSON.parse(content);
-	} catch {
-		return;
-	}
-}
-//#endregion
-//#region src/cli/workspace/workspace-globs.ts
-function parseWorkspaceGlobsFromPackageJson(workspaceRoot) {
-	const pkg = tryReadJson(node_path.default.join(workspaceRoot, "package.json"));
-	if (!pkg?.workspaces) return [];
-	if (Array.isArray(pkg.workspaces)) return pkg.workspaces.filter(Boolean);
-	if (Array.isArray(pkg.workspaces.packages)) return pkg.workspaces.packages.filter(Boolean);
-	return [];
-}
-function parseWorkspaceGlobsFromWorkspaceFile(workspaceRoot) {
-	const workspaceFile = node_path.default.join(workspaceRoot, "pnpm-workspace.yaml");
-	if (!(0, node_fs.existsSync)(workspaceFile)) return [];
-	try {
-		const parsed = (0, yaml.parse)((0, node_fs.readFileSync)(workspaceFile, "utf8"));
-		return Array.isArray(parsed?.packages) ? parsed.packages.filter(Boolean) : [];
-	} catch {
-		return [];
-	}
-}
-//#endregion
-//#region src/cli/workspace/workspace-lock.ts
-function parseImportersFromLock(workspaceRoot) {
-	const lockPath = node_path.default.join(workspaceRoot, "pnpm-lock.yaml");
-	if (!(0, node_fs.existsSync)(lockPath)) return [];
-	try {
-		const importers = (0, yaml.parse)((0, node_fs.readFileSync)(lockPath, "utf8"))?.importers;
-		if (!importers) return [];
-		return Object.keys(importers).map((key) => {
-			if (!key || key === ".") return workspaceRoot;
-			return node_path.default.join(workspaceRoot, key);
-		});
-	} catch {
-		return [];
-	}
-}
-//#endregion
-//#region src/cli/workspace/package-dirs.ts
-const BACKSLASH_RE$1 = /\\/g;
-const TRAILING_SLASH_RE = /\/+$/;
-async function resolveWorkspacePackageDirs(workspaceRoot) {
-	const dirs = /* @__PURE__ */ new Set();
-	for (const importerDir of parseImportersFromLock(workspaceRoot)) dirs.add(node_path.default.normalize(importerDir));
-	if (!dirs.size) {
-		let globs = parseWorkspaceGlobsFromWorkspaceFile(workspaceRoot);
-		if (!globs.length) globs = parseWorkspaceGlobsFromPackageJson(workspaceRoot);
-		if (globs.length > 0) {
-			const packageJsonFiles = await (0, fast_glob.default)(globs.map((pattern) => {
-				const normalized = pattern.replace(BACKSLASH_RE$1, "/").replace(TRAILING_SLASH_RE, "");
-				return normalized.endsWith("package.json") ? normalized : `${normalized}/package.json`;
-			}), {
-				cwd: workspaceRoot,
-				absolute: true,
-				onlyFiles: true,
-				unique: true,
-				ignore: ["**/node_modules/**", "**/.git/**"]
-			});
-			for (const file of packageJsonFiles) dirs.add(node_path.default.normalize(node_path.default.dirname(file)));
-		}
-	}
-	if ((0, node_fs.existsSync)(node_path.default.join(workspaceRoot, "package.json"))) dirs.add(node_path.default.normalize(workspaceRoot));
-	return [...dirs];
-}
-//#endregion
-//#region src/cli/workspace/patch-utils.ts
-function formatDisplayName(workspaceRoot, dir, name) {
-	const relative = node_path.default.relative(workspaceRoot, dir) || ".";
-	return name ? `${name} (${relative})` : relative;
-}
-function summarizeWorkspaceResults(results) {
-	const patched = results.filter((result) => result.status === "patched").length;
-	const skipped = results.filter((result) => result.status === "skipped").length;
-	const failed = results.filter((result) => result.status === "failed").length;
-	_weapp_tailwindcss_logger.logger.info("[workspace] 汇总：已补丁 %d，跳过 %d，失败 %d", patched, skipped, failed);
-}
-//#endregion
-//#region src/cli/workspace/patch-package.ts
-function createWorkspacePatcher(cwd) {
-	return new tailwindcss_patch.TailwindcssPatcher((0, tailwindcss_patch.normalizeOptions)(withDefaultExtendLengthUnits({ projectRoot: cwd })));
-}
-async function patchWorkspacePackage(workspaceRoot, dir, pkgName, options) {
-	const displayName = formatDisplayName(workspaceRoot, dir, pkgName);
-	if (!getTailwindcssPackageInfo({ paths: [dir] })?.rootPath) {
-		_weapp_tailwindcss_logger.logger.info("[workspace] 跳过 %s（tailwindcss 未安装）。", displayName);
-		return {
-			dir,
-			name: pkgName,
-			status: "skipped",
-			message: "tailwindcss 未安装，已跳过。"
-		};
-	}
-	try {
-		const patcher = createWorkspacePatcher(dir);
-		if (options.clearCache) await clearTailwindcssPatcherCache(patcher, { removeDirectory: true });
-		const recorder = createPatchTargetRecorder(dir, patcher, {
-			source: "cli",
-			cwd: dir,
-			recordTarget: options.recordTarget !== false,
-			alwaysRecord: true
-		});
-		if (recorder?.message) _weapp_tailwindcss_logger.logger.info("[workspace] %s %s", displayName, recorder.message);
-		logTailwindcssTarget("cli", patcher, dir);
-		await patcher.patch();
-		if (recorder?.onPatched) await recorder.onPatched();
-		_weapp_tailwindcss_logger.logger.success("[workspace] 已补丁 %s", displayName);
-		return {
-			dir,
-			name: pkgName,
-			status: "patched",
-			message: "已完成 patch。"
-		};
-	} catch (error) {
-		const message = `${error instanceof Error ? error.message : String(error)}，${`请在 ${dir} 运行 "weapp-tw patch --cwd ${dir}".`}`;
-		_weapp_tailwindcss_logger.logger.error("[workspace] 补丁失败 %s：%s", displayName, message);
-		return {
-			dir,
-			name: pkgName,
-			status: "failed",
-			message
-		};
-	}
-}
-//#endregion
-//#region src/cli/workspace.ts
-async function patchWorkspace(options) {
-	const cwd = options.cwd ?? node_process.default.cwd();
-	const workspaceRoot = findWorkspaceRoot(cwd) ?? cwd;
-	const packageDirs = await resolveWorkspacePackageDirs(workspaceRoot);
-	if (packageDirs.length === 0) {
-		_weapp_tailwindcss_logger.logger.warn("未在 %s 检测到 workspace 包，已跳过批量 patch。", workspaceRoot);
-		return;
-	}
-	const results = [];
-	for (const dir of packageDirs) {
-		const pkgJson = tryReadJson(node_path.default.join(dir, "package.json"));
-		results.push(await patchWorkspacePackage(workspaceRoot, dir, pkgJson?.name, options));
-	}
-	summarizeWorkspaceResults(results);
-}
-//#endregion
 //#region src/cli/mount-options.ts
+const PATCH_COMMAND_OBSOLETE_NOTICE = "提示：weapp-tailwindcss@5 已由构建运行时接管 Tailwind CSS 处理，weapp-tw patch 已无需执行；请移除 package.json 中的 postinstall 钩子。";
+function logPatchCommandObsoleteNotice() {
+	_weapp_tailwindcss_logger.logger.warn(PATCH_COMMAND_OBSOLETE_NOTICE);
+}
 function handleCliError(error) {
 	if (error instanceof Error) {
 		_weapp_tailwindcss_logger.logger.error(error.message);
@@ -2399,92 +1967,17 @@ function withCommandErrorHandling(handler) {
 		}
 	});
 }
-async function createPatcherWithDefaultExtendLengthUnits(ctx) {
-	const extendLengthUnitsOverride = buildExtendLengthUnitsOverride(await ctx.loadPatchOptions());
-	if (extendLengthUnitsOverride) return ctx.createPatcher(extendLengthUnitsOverride);
-	return ctx.createPatcher();
-}
+const forwardedCommands = [
+	"extract",
+	"tokens",
+	"init",
+	"migrate",
+	"restore",
+	"validate"
+];
 const mountOptions = {
-	commandOptions: {
-		install: {
-			name: "patch",
-			aliases: ["install"],
-			appendDefaultOptions: false,
-			optionDefs: [
-				{
-					flags: "--cwd <dir>",
-					description: "Working directory",
-					config: { default: resolvePatchDefaultCwd() }
-				},
-				{
-					flags: "--record-target",
-					description: "Write tailwindcss target metadata (node_modules/.cache/weapp-tailwindcss/tailwindcss-target.json). Pass \"--record-target false\" to skip.",
-					config: { default: true }
-				},
-				{
-					flags: "--clear-cache",
-					description: "Clear tailwindcss-patch cache before patch (opt-in)"
-				},
-				{
-					flags: "--workspace",
-					description: "Scan pnpm workspace packages and patch each Tailwind CSS dependency"
-				}
-			]
-		},
-		status: {
-			appendDefaultOptions: false,
-			optionDefs: [{
-				flags: "--cwd <dir>",
-				description: "Working directory",
-				config: { default: resolvePatchDefaultCwd() }
-			}, {
-				flags: "--json",
-				description: "Print a JSON report of patch status"
-			}]
-		}
-	},
-	commandHandlers: {
-		install: withCommandErrorHandling(async (ctx) => {
-			const shouldClearCache = toBoolean(ctx.args.clearCache, false);
-			const shouldRecordTarget = toBoolean(ctx.args.recordTarget, true);
-			if (toBoolean(ctx.args.workspace, false)) {
-				await patchWorkspace({
-					cwd: ctx.cwd,
-					clearCache: shouldClearCache,
-					recordTarget: shouldRecordTarget
-				});
-				return;
-			}
-			const patcher = await createPatcherWithDefaultExtendLengthUnits(ctx);
-			if (shouldClearCache) await clearTailwindcssPatcherCache(patcher, { removeDirectory: true });
-			const recorder = createPatchTargetRecorder(ctx.cwd, patcher, {
-				source: "cli",
-				cwd: ctx.cwd,
-				recordTarget: shouldRecordTarget,
-				alwaysRecord: true
-			});
-			if (recorder?.message) _weapp_tailwindcss_logger.logger.info(recorder.message);
-			logTailwindcssTarget("cli", patcher, ctx.cwd);
-			await patcher.patch();
-			if (recorder?.onPatched) {
-				const recordPath = await recorder.onPatched();
-				if (recordPath) _weapp_tailwindcss_logger.logger.info(`记录 weapp-tw patch 目标 -> ${formatOutputPath(recordPath, ctx.cwd)}`);
-			}
-			_weapp_tailwindcss_logger.logger.success("Tailwind CSS 运行时补丁已完成。");
-		}),
-		extract: withCommandErrorHandling(async (_ctx, next) => next()),
-		tokens: withCommandErrorHandling(async (_ctx, next) => next()),
-		init: withCommandErrorHandling(async (_ctx, next) => next()),
-		status: withCommandErrorHandling(async (ctx) => {
-			const report = await (await createPatcherWithDefaultExtendLengthUnits(ctx)).getPatchStatus();
-			if (ctx.args.json) {
-				_weapp_tailwindcss_logger.logger.log(JSON.stringify(report, null, 2));
-				return report;
-			}
-			logPatchStatusReport(report);
-			return report;
-		})
-	}
+	commands: [...forwardedCommands],
+	commandHandlers: Object.fromEntries(forwardedCommands.map((command) => [command, withCommandErrorHandling(async (_ctx, next) => next())]))
 };
 //#endregion
 //#region src/cli/vscode-entry.ts
@@ -2592,6 +2085,23 @@ const cli = (0, tailwindcss_patch.createTailwindcssPatchCli)({
 	name: "weapp-tailwindcss",
 	mountOptions
 });
+cli.command("patch", "Deprecated no-op: v5 runtime handles Tailwind CSS automatically").alias("install").option("--cwd <dir>", "Ignored working directory").option("--clear-cache", "Ignored compatibility option").option("--record-target [enabled]", "Ignored compatibility option").option("--workspace", "Ignored compatibility option").action(commandAction(async (_options) => {
+	logPatchCommandObsoleteNotice();
+	_weapp_tailwindcss_logger.logger.success("已跳过：当前版本不需要手动执行 Tailwind CSS patch。");
+}));
+cli.command("status", "Deprecated no-op: patch status is no longer required").option("--cwd <dir>", "Ignored working directory").option("--json", "Print a JSON no-op report").action(commandAction(async (options) => {
+	const payload = {
+		required: false,
+		status: "unnecessary",
+		message: PATCH_COMMAND_OBSOLETE_NOTICE
+	};
+	if (toBoolean(options.json, false)) {
+		_weapp_tailwindcss_logger.logger.log(JSON.stringify(payload, null, 2));
+		return;
+	}
+	logPatchCommandObsoleteNotice();
+	_weapp_tailwindcss_logger.logger.success("无需检查 Tailwind CSS patch 状态。");
+}));
 cli.command("vscode-entry", "Generate a VS Code helper CSS for Tailwind IntelliSense").option("--cwd <dir>", "Working directory").option("--css <file>", "Path to the CSS file that imports weapp-tailwindcss (required)").option("--output <file>", `Helper output path. Defaults to ${DEFAULT_VSCODE_ENTRY_OUTPUT}`).option("--source <pattern>", "Additional @source glob (can be repeated)").option("--force", "Overwrite the helper file when it already exists").action(commandAction(async (options) => {
 	const resolvedCwd = resolveCliCwd(options.cwd);
 	const baseDir = resolvedCwd ?? node_process.default.cwd();