weapp-tailwindcss 5.0.12 → 5.1.0

package/dist/{precheck-30zNPRlI.js → context-BHxLe743.js}

@@ -1,20 +1,24 @@
 const require_chunk = require("./chunk-emK7D4bc.js");
-const require_v3_engine = require("./v3-engine-CQE5JJNZ.js");
-const require_defaults = require("./defaults-Boc26eel.js");
-require("./utils-Dolmt8EO.js");
-const require_tailwindcss = require("./tailwindcss-Clpkz1oR.js");
-let _weapp_tailwindcss_postcss = require("@weapp-tailwindcss/postcss");
-let lru_cache = require("lru-cache");
-let tailwindcss_patch = require("tailwindcss-patch");
+const require_v4_engine = require("./v4-engine-D4ubP7N5.js");
+const require_generator = require("./generator-9rUz4Hcb.js");
+require("./utils-BCa37Wqj.js");
+const require_defaults = require("./defaults-CVcKbXBG.js");
+const require_tailwindcss = require("./tailwindcss-DHIYcqXT.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
-let _weapp_tailwindcss_logger = require("@weapp-tailwindcss/logger");
+let _tailwindcss_mangle_engine = require("@tailwindcss-mangle/engine");
+let _weapp_tailwindcss_postcss = require("@weapp-tailwindcss/postcss");
+let lru_cache = require("lru-cache");
 let node_fs_promises = require("node:fs/promises");
+let node_module = require("node:module");
 let node_buffer = require("node:buffer");
+let _weapp_tailwindcss_logger = require("@weapp-tailwindcss/logger");
 let _weapp_tailwindcss_shared_node = require("@weapp-tailwindcss/shared/node");
 let _weapp_core_escape = require("@weapp-core/escape");
+let debug = require("debug");
+debug = require_chunk.__toESM(debug);
 let _babel_traverse = require("@babel/traverse");
 _babel_traverse = require_chunk.__toESM(_babel_traverse);
 let _babel_parser = require("@babel/parser");
@@ -69,15 +73,16 @@ function createCache(options) {
 			});
 			return cache;
 		},
+		pruneHashKeys(hashKeys) {
+			const activeHashKeys = new Set(hashKeys);
+			for (const key of hashMap.keys()) if (!activeHashKeys.has(key)) hashMap.delete(key);
+		},
 		prune(options) {
 			if (options.cacheKeys) {
 				const cacheKeys = new Set(options.cacheKeys);
 				for (const key of instance.keys()) if (!cacheKeys.has(key)) instance.delete(key);
 			}
-			if (options.hashKeys) {
-				const hashKeys = new Set(options.hashKeys);
-				for (const key of hashMap.keys()) if (!hashKeys.has(key)) hashMap.delete(key);
-			}
+			if (options.hashKeys) cache.pruneHashKeys?.(options.hashKeys);
 		},
 		has(key) {
 			return instance.has(key);
@@ -116,13 +121,28 @@ function initializeCache(cacheConfig) {
 	return cacheConfig;
 }
 //#endregion
+//#region src/debug/index.ts
+const _debug = (0, debug.default)("weapp-tw");
+function createDebug(prefix) {
+	const debug$3 = ((formatter, ...args) => {
+		return _debug((prefix ?? "") + formatter, ...args);
+	});
+	Object.defineProperty(debug$3, "enabled", {
+		enumerable: false,
+		configurable: false,
+		get() {
+			return _debug.enabled;
+		}
+	});
+	return debug$3;
+}
+//#endregion
 //#region src/tailwindcss/runtime.ts
-const debug$1 = require_v3_engine.createDebug("[tailwindcss:runtime] ");
-const refreshTailwindcssPatcherSymbol = Symbol.for("weapp-tailwindcss.refreshTailwindcssPatcher");
-function createTailwindRuntimeReadyPromise(twPatcher) {
+const debug$2 = createDebug("[tailwindcss:runtime] ");
+const refreshTailwindcssRuntimeSymbol = Symbol.for("weapp-tailwindcss.refreshTailwindcssRuntime");
+function createTailwindRuntimeReadyPromise(tailwindRuntime) {
 	return Promise.resolve().then(async () => {
-		await require_v3_engine.ensureTailwindcssRuntimePatch(twPatcher);
-		require_v3_engine.invalidateRuntimeClassSet(twPatcher);
+		require_tailwindcss.invalidateRuntimeClassSet(tailwindRuntime);
 	});
 }
 const runtimeClassSetStateCache = /* @__PURE__ */ new WeakMap();
@@ -134,21 +154,31 @@ function getRuntimeClassSetStateEntry(state) {
 	}
 	return entry;
 }
+function getTailwindRuntime(state) {
+	return state.tailwindRuntime;
+}
+function setTailwindRuntime(state, runtime) {
+	state.tailwindRuntime = runtime;
+}
+function getRefreshTailwindRuntime(state) {
+	return state.refreshTailwindcssRuntime;
+}
 async function refreshTailwindRuntimeState(state, forceOrOptions) {
 	const normalizedOptions = typeof forceOrOptions === "boolean" ? { force: forceOrOptions } : forceOrOptions;
 	const force = normalizedOptions.force;
 	const clearCache = normalizedOptions.clearCache === true;
 	if (!force) return false;
-	debug$1("refresh runtime state start, clearCache=%s major=%s", clearCache, state.twPatcher.majorVersion ?? "unknown");
+	debug$2("refresh runtime state start, clearCache=%s major=%s", clearCache, getTailwindRuntime(state).majorVersion ?? "unknown");
 	await state.readyPromise;
 	let refreshed = false;
-	if (typeof state.refreshTailwindcssPatcher === "function") {
-		const next = await state.refreshTailwindcssPatcher({ clearCache });
-		if (next !== state.twPatcher) state.twPatcher = next;
+	const refreshTailwindRuntime = getRefreshTailwindRuntime(state);
+	if (typeof refreshTailwindRuntime === "function") {
+		const next = await refreshTailwindRuntime({ clearCache });
+		if (next !== getTailwindRuntime(state)) setTailwindRuntime(state, next);
 		refreshed = true;
 	}
-	if (refreshed) state.readyPromise = createTailwindRuntimeReadyPromise(state.twPatcher);
-	debug$1("refresh runtime state end, refreshed=%s major=%s", refreshed, state.twPatcher.majorVersion ?? "unknown");
+	if (refreshed) state.readyPromise = createTailwindRuntimeReadyPromise(getTailwindRuntime(state));
+	debug$2("refresh runtime state end, refreshed=%s major=%s", refreshed, getTailwindRuntime(state).majorVersion ?? "unknown");
 	return refreshed;
 }
 async function ensureRuntimeClassSet(state, options = {}) {
@@ -162,7 +192,7 @@ async function ensureRuntimeClassSet(state, options = {}) {
 	});
 	await state.readyPromise;
 	const entry = getRuntimeClassSetStateEntry(state);
-	const signature = await require_v3_engine.getRuntimeClassSetSignatureWithSources(state.twPatcher);
+	const signature = await require_tailwindcss.getRuntimeClassSetSignatureWithSources(getTailwindRuntime(state));
 	const signatureChanged = entry.signature !== signature;
 	const shouldForceCollect = forceCollect || forceRefresh || signatureChanged;
 	if (!shouldForceCollect) {
@@ -170,7 +200,7 @@ async function ensureRuntimeClassSet(state, options = {}) {
 		if (entry.promise) return entry.promise;
 	}
 	const task = (async () => {
-		const collected = await collectRuntimeClassSet(state.twPatcher, {
+		const collected = await collectRuntimeClassSet(getTailwindRuntime(state), {
 			force: shouldForceCollect,
 			skipRefresh: true,
 			clearCache
@@ -181,7 +211,7 @@ async function ensureRuntimeClassSet(state, options = {}) {
 			clearCache: true
 		});
 		await state.readyPromise;
-		return collectRuntimeClassSet(state.twPatcher, {
+		return collectRuntimeClassSet(getTailwindRuntime(state), {
 			force: true,
 			skipRefresh: true,
 			clearCache: true
@@ -191,118 +221,90 @@ async function ensureRuntimeClassSet(state, options = {}) {
 	try {
 		const runtimeSet = await task;
 		entry.value = runtimeSet;
-		entry.signature = await require_v3_engine.getRuntimeClassSetSignatureWithSources(state.twPatcher);
+		entry.signature = await require_tailwindcss.getRuntimeClassSetSignatureWithSources(getTailwindRuntime(state));
 		return runtimeSet;
 	} finally {
 		if (entry.promise === task) entry.promise = void 0;
 	}
 }
-function shouldPreferSync(majorVersion) {
-	if (majorVersion == null) return true;
-	if (majorVersion === 3) return true;
-	if (majorVersion === 4) return true;
-	return false;
-}
-function tryGetRuntimeClassSetSync(twPatcher) {
-	if (typeof twPatcher.getClassSetSync !== "function") return;
-	if (!shouldPreferSync(twPatcher.majorVersion)) return;
+function tryGetRuntimeClassSetSync(tailwindRuntime) {
+	if (typeof tailwindRuntime.getClassSetSync !== "function") return;
 	try {
-		const set = twPatcher.getClassSetSync();
+		const set = tailwindRuntime.getClassSetSync();
 		if (set && set.size === 0) return;
 		return set;
 	} catch (error) {
-		if (twPatcher.majorVersion === 4) debug$1("getClassSetSync() unavailable for tailwindcss v4, fallback to async getClassSet(): %O", error);
-		else debug$1("getClassSetSync() failed, fallback to async getClassSet(): %O", error);
+		debug$2("getClassSetSync() unavailable for tailwindcss v4, fallback to async getClassSet(): %O", error);
 		return;
 	}
 }
-async function collectTailwindV4GeneratorClassSet(twPatcher) {
+async function collectTailwindV4GeneratorClassSet(tailwindRuntime) {
+	if (typeof tailwindRuntime.collectContentTokens !== "function") return;
 	try {
-		const generated = await require_v3_engine.createTailwindV4Engine(await require_v3_engine.resolveTailwindV4SourceFromPatcher(twPatcher)).generate({
+		const generated = await require_v4_engine.createTailwindV4Engine(await require_v4_engine.resolveTailwindV4SourceFromRuntime(tailwindRuntime)).generate({
 			scanSources: true,
-			target: "tailwind"
+			target: "web"
 		});
-		debug$1("runtime class set resolved via tailwindcss v4 generator source scan, size=%d", generated.classSet.size);
+		debug$2("runtime class set resolved via tailwindcss v4 generator source scan, size=%d", generated.classSet.size);
 		return generated.classSet;
 	} catch (error) {
-		debug$1("tailwindcss v4 generator source scan failed, continuing fallback chain: %O", error);
+		debug$2("tailwindcss v4 generator source scan failed, continuing fallback chain: %O", error);
 		return;
 	}
 }
-async function mergeTailwindV4GeneratorClassSet(twPatcher, classSet) {
-	if (twPatcher.majorVersion !== 4) return classSet;
-	const generatorClassSet = await collectTailwindV4GeneratorClassSet(twPatcher);
+async function mergeTailwindV4GeneratorClassSet(tailwindRuntime, classSet) {
+	const generatorClassSet = await collectTailwindV4GeneratorClassSet(tailwindRuntime).catch(() => void 0);
 	if (!generatorClassSet || generatorClassSet.size === 0) return classSet;
 	return new Set([...classSet, ...generatorClassSet]);
 }
-function canReturnExtractClassSetImmediately(twPatcher) {
-	return twPatcher.majorVersion !== 4;
-}
-async function collectRuntimeClassSet(twPatcher, options = {}) {
-	let activePatcher = twPatcher;
+async function collectRuntimeClassSet(tailwindRuntime, options = {}) {
+	let activeRuntime = tailwindRuntime;
 	if (options.force && !options.skipRefresh) {
-		const refresh = activePatcher[refreshTailwindcssPatcherSymbol];
+		const refresh = activeRuntime[refreshTailwindcssRuntimeSymbol];
 		if (typeof refresh === "function") try {
 			const refreshed = await refresh({ clearCache: options.clearCache === true });
-			if (refreshed) activePatcher = refreshed;
+			if (refreshed) activeRuntime = refreshed;
 		} catch (error) {
-			debug$1("refreshTailwindcssPatcher failed, continuing with existing patcher: %O", error);
+			debug$2("refreshTailwindcssRuntime failed, continuing with existing runtime: %O", error);
 		}
 	}
-	const entry = require_v3_engine.getRuntimeClassSetCacheEntry(activePatcher);
-	const signature = await require_v3_engine.getRuntimeClassSetSignatureWithSources(activePatcher);
+	const entry = require_tailwindcss.getRuntimeClassSetCacheEntry(activeRuntime);
+	const signature = await require_tailwindcss.getRuntimeClassSetSignatureWithSources(activeRuntime);
 	if (!options.force) {
 		if (entry.value && entry.signature === signature) return entry.value;
 		if (entry.promise) return entry.promise;
 	} else entry.value = void 0;
 	const task = (async () => {
-		await require_v3_engine.ensureTailwindcssRuntimePatch(activePatcher);
-		const preExtractSyncSet = options.force ? tryGetRuntimeClassSetSync(activePatcher) : void 0;
-		if (preExtractSyncSet) debug$1("runtime class set snapshot via getClassSetSync() before extract(), size=%d", preExtractSyncSet.size);
 		const preferExtract = options.force === true;
 		try {
-			const result = await activePatcher.extract({ write: false });
+			const result = await activeRuntime.extract({ write: false });
 			if (result?.classSet) {
 				if (result.classSet.size > 0) {
-					if (canReturnExtractClassSetImmediately(activePatcher)) {
-						debug$1("runtime class set resolved via extract(), size=%d", result.classSet.size);
-						return result.classSet;
-					}
-					const merged = await mergeTailwindV4GeneratorClassSet(activePatcher, result.classSet);
-					debug$1("runtime class set resolved via extract() + tailwindcss v4 source scan, extract=%d merged=%d", result.classSet.size, merged.size);
+					const merged = await mergeTailwindV4GeneratorClassSet(activeRuntime, result.classSet);
+					debug$2("runtime class set resolved via extract() + tailwindcss v4 source scan, extract=%d merged=%d", result.classSet.size, merged.size);
 					return merged;
 				}
-				if (preferExtract && activePatcher.majorVersion !== 4) {
-					debug$1("runtime class set resolved via empty extract() on force collect, size=0");
-					return result.classSet;
-				}
-				if (preferExtract) debug$1("runtime class set from extract() is empty on force collect, fallback to generator/sync/async class set");
-				else debug$1("runtime class set from extract() is empty, fallback to sync/async class set");
+				if (preferExtract) debug$2("runtime class set from extract() is empty on force collect, fallback to generator/sync/async class set");
+				else debug$2("runtime class set from extract() is empty, fallback to sync/async class set");
 			}
 		} catch (error) {
-			debug$1("extract() failed, fallback to getClassSet(): %O", error);
-		}
-		if (activePatcher.majorVersion === 4) {
-			const generatorClassSet = await collectTailwindV4GeneratorClassSet(activePatcher);
-			if (generatorClassSet && generatorClassSet.size > 0) return generatorClassSet;
+			debug$2("extract() failed, fallback to getClassSet(): %O", error);
 		}
-		if (preExtractSyncSet) {
-			debug$1("runtime class set fallback to pre-extract sync snapshot, size=%d", preExtractSyncSet.size);
-			return preExtractSyncSet;
-		}
-		const syncSet = tryGetRuntimeClassSetSync(activePatcher);
+		const generatorClassSet = await collectTailwindV4GeneratorClassSet(activeRuntime);
+		if (generatorClassSet && generatorClassSet.size > 0) return generatorClassSet;
+		const syncSet = tryGetRuntimeClassSetSync(activeRuntime);
 		if (syncSet) {
-			debug$1("runtime class set resolved via getClassSetSync(), size=%d", syncSet.size);
+			debug$2("runtime class set resolved via getClassSetSync(), size=%d", syncSet.size);
 			return syncSet;
 		}
 		try {
-			const fallbackSet = await Promise.resolve(activePatcher.getClassSet());
+			const fallbackSet = await Promise.resolve(activeRuntime.getClassSet());
 			if (fallbackSet) {
-				debug$1("runtime class set resolved via getClassSet(), size=%d", fallbackSet.size);
+				debug$2("runtime class set resolved via getClassSet(), size=%d", fallbackSet.size);
 				return fallbackSet;
 			}
 		} catch (error) {
-			debug$1("getClassSet() failed, returning empty set: %O", error);
+			debug$2("getClassSet() failed, returning empty set: %O", error);
 		}
 		return /* @__PURE__ */ new Set();
 	})();
@@ -361,8 +363,8 @@ function formatRelativeToBase(targetPath, baseDir) {
 	if (relative.startsWith("..")) return normalized.replace(/\\/g, "/");
 	return node_path.default.join(".", relative).replace(/\\/g, "/");
 }
-function logTailwindcssTarget(patcher, baseDir) {
-	const packageInfo = patcher?.packageInfo;
+function logTailwindcssTarget(tailwindRuntime, baseDir) {
+	const packageInfo = tailwindRuntime?.packageInfo;
 	const label = "Weapp-tailwindcss";
 	if (!packageInfo?.rootPath) {
 		_weapp_tailwindcss_logger.logger.warn("%s 未找到 Tailwind CSS 依赖，请检查在 %s 是否已安装 tailwindcss", label, baseDir ?? node_process.default.cwd());
@@ -376,7 +378,7 @@ function logTailwindcssTarget(patcher, baseDir) {
 //#endregion
 //#region src/unocss/index.ts
 function normalizeUnocssOptions(unocss) {
-	return require_v3_engine.resolveBooleanObjectOption(unocss, {});
+	return require_v4_engine.resolveBooleanObjectOption(unocss, {});
 }
 function resolveUnocssBareArbitraryValues(arbitraryValues, unocss) {
 	const baseArbitraryValues = arbitraryValues ?? {};
@@ -395,10 +397,28 @@ function resolveUnocssBareArbitraryValues(arbitraryValues, unocss) {
 const PAREN_CONTENT_RE = /\(([^)]+)\)/u;
 const AT_LOCATION_RE = /at\s+(\S.*)$/u;
 const TRAILING_LINE_COL_RE = /:\d+(?::\d+)?$/u;
+const DEFAULT_COMPILER_CONTEXT_CACHE_MAX = 32;
+const DEFAULT_COMPILER_CONTEXT_KEY_CACHE_MAX = DEFAULT_COMPILER_CONTEXT_CACHE_MAX * 2;
 const globalCacheHolder = globalThis;
 const compilerContextCache = globalCacheHolder.__WEAPP_TW_COMPILER_CONTEXT_CACHE__ ?? (globalCacheHolder.__WEAPP_TW_COMPILER_CONTEXT_CACHE__ = /* @__PURE__ */ new Map());
 const compilerContextKeyCacheByOptions = /* @__PURE__ */ new WeakMap();
 const compilerContextKeyCacheWithoutOptions = /* @__PURE__ */ new Map();
+function resolveCompilerContextCacheMax(defaultValue) {
+	const raw = Number.parseInt(node_process.default.env["WEAPP_TW_COMPILER_CONTEXT_CACHE_MAX"] ?? "", 10);
+	if (!Number.isFinite(raw) || raw <= 0) return defaultValue;
+	return Math.floor(raw);
+}
+function touchMapValue(map, key, value) {
+	map.delete(key);
+	map.set(key, value);
+}
+function pruneMapToMaxSize(map, maxSize) {
+	while (map.size > maxSize) {
+		const firstKey = map.keys().next().value;
+		if (firstKey === void 0) break;
+		map.delete(firstKey);
+	}
+}
 function withCircularGuard(value, stack, factory) {
 	if (stack.has(value)) throw new TypeError("Cannot serialize circular structure in compiler context options");
 	stack.add(value);
@@ -568,7 +588,8 @@ function createCompilerContextCacheKey(opts) {
 		const cached = keyStore.get(runtimeCacheScopeKey);
 		if (cached !== void 0) return cached;
 		const cacheKey = (0, _weapp_tailwindcss_shared_node.md5)(serializeNormalizedValue(normalizeOptionsValue(getRuntimeCacheScopeValue(opts))));
-		keyStore.set(runtimeCacheScopeKey, cacheKey);
+		touchMapValue(keyStore, runtimeCacheScopeKey, cacheKey);
+		pruneMapToMaxSize(keyStore, resolveCompilerContextCacheMax(DEFAULT_COMPILER_CONTEXT_KEY_CACHE_MAX));
 		return cacheKey;
 	} catch (error) {
 		_weapp_tailwindcss_logger.logger.debug("skip compiler context cache: %O", error);
@@ -579,10 +600,16 @@ function withCompilerContextCache(opts, factory) {
 	const cacheKey = createCompilerContextCacheKey(opts);
 	if (cacheKey) {
 		const cached = compilerContextCache.get(cacheKey);
-		if (cached) return cached;
+		if (cached) {
+			touchMapValue(compilerContextCache, cacheKey, cached);
+			return cached;
+		}
 	}
 	const ctx = factory();
-	if (cacheKey) compilerContextCache.set(cacheKey, ctx);
+	if (cacheKey) {
+		touchMapValue(compilerContextCache, cacheKey, ctx);
+		pruneMapToMaxSize(compilerContextCache, resolveCompilerContextCacheMax(DEFAULT_COMPILER_CONTEXT_CACHE_MAX));
+	}
 	return ctx;
 }
 //#endregion
@@ -713,7 +740,7 @@ function replaceWxml(original, options = {
 	const { keepEOL, escapeMap, ignoreHead } = options;
 	let res = original;
 	if (!keepEOL) res = res.replaceAll(NEWLINE_RE, "");
-	res = (0, _weapp_core_escape.escape)(res, require_v3_engine.omitUndefined({
+	res = (0, _weapp_core_escape.escape)(res, require_v4_engine.omitUndefined({
 		map: escapeMap,
 		ignoreHead
 	}));
@@ -934,7 +961,7 @@ function getReplacement(candidate, escapeMap, store = getReplacementCacheStore(e
 }
 //#endregion
 //#region src/js/handlers.ts
-const debug = require_v3_engine.createDebug("[js:handlers] ");
+const debug$1 = createDebug("[js:handlers] ");
 const WEAPP_TW_IGNORE_MARKER = "weapp-tw";
 const IGNORE_MARKER = "ignore";
 function hasIgnoreComment(node) {
@@ -946,6 +973,19 @@ function hasIgnoreComment(node) {
 	}
 	return false;
 }
+function isConditionTestLiteral(path) {
+	let current = path;
+	while (current?.parentPath) {
+		const parent = current.parentPath;
+		if (parent.isConditionalExpression()) return parent.node.test === current.node;
+		if (parent.isBinaryExpression() || parent.isCallExpression() || parent.isLogicalExpression() || parent.isMemberExpression() || parent.isUnaryExpression()) {
+			current = parent;
+			continue;
+		}
+		return false;
+	}
+	return false;
+}
 function extractLiteralValue(path, { unescapeUnicode }) {
 	const { node } = path;
 	let offset = 0;
@@ -1011,10 +1051,11 @@ function replaceHandleValue(path, options) {
 	const fallbackEnabled = shouldEnableArbitraryValueFallback(options);
 	if (!alwaysEscape && !fallbackEnabled && (!classNameSet || classNameSet.size === 0)) return;
 	if (hasIgnoreComment(path.node)) return;
+	if (isConditionTestLiteral(path)) return;
 	const { literal, original, offset } = extractLiteralValue(path, options);
-	const candidates = (0, tailwindcss_patch.splitCandidateTokens)(literal);
+	const candidates = (0, _tailwindcss_mangle_engine.splitCandidateTokens)(literal);
 	if (candidates.length === 0) return;
-	const debugEnabled = debug.enabled;
+	const debugEnabled = debug$1.enabled;
 	const classContext = options.wrapExpression || isClassContextLiteralPath(path);
 	let transformed = literal;
 	let mutated = false;
@@ -1050,7 +1091,7 @@ function replaceHandleValue(path, options) {
 	}
 	const node = path.node;
 	if (!mutated || typeof node.start !== "number" || typeof node.end !== "number") return;
-	if (debugEnabled) debug("runtimeSet size=%d fallbackTriggered=%s candidates=%d matched=%d escapedHits=%d skipped=%d file=%s escapedSamples=%s skippedSamples=%s", classNameSet?.size ?? 0, fallbackDecisionCount > 0, candidates.length, matchedCandidateCount, escapedDecisionCount, skippedSamples?.length ?? 0, options.filename ?? "unknown", escapedSamples?.join(",") || "-", skippedSamples?.join(",") || "-");
+	if (debugEnabled) debug$1("runtimeSet size=%d fallbackTriggered=%s candidates=%d matched=%d escapedHits=%d skipped=%d file=%s escapedSamples=%s skippedSamples=%s", classNameSet?.size ?? 0, fallbackDecisionCount > 0, candidates.length, matchedCandidateCount, escapedDecisionCount, skippedSamples?.length ?? 0, options.filename ?? "unknown", escapedSamples?.join(",") || "-", skippedSamples?.join(",") || "-");
 	const start = node.start + offset;
 	const end = node.end - offset;
 	if (start >= end || transformed === original) return;
@@ -2026,6 +2067,198 @@ function jsHandler(rawSource, options) {
 }
 defaultEvalHandler = jsHandler;
 //#endregion
+//#region src/js/literal-transform.ts
+function transformLiteralText(literal, options) {
+	const fallbackEnabled = shouldEnableArbitraryValueFallback(options);
+	if (!options.alwaysEscape && !fallbackEnabled && (!options.classNameSet || options.classNameSet.size === 0)) return;
+	const source = options.unescapeUnicode && literal.includes("\\u") ? decodeUnicode2(literal) : literal;
+	const candidates = (0, _tailwindcss_mangle_engine.splitCandidateTokens)(source);
+	if (candidates.length === 0) return;
+	const transformOptions = {
+		...options,
+		classContext: true
+	};
+	const replacementCache = getReplacementCacheStore(options.escapeMap);
+	let transformed = source;
+	let mutated = false;
+	for (const candidate of candidates) {
+		const result = resolveClassNameTransformWithResult(candidate, transformOptions);
+		if (result.decision === "skip" || !transformed.includes(candidate)) continue;
+		const replacement = result.decision === "escaped" && result.escapedValue ? result.escapedValue : getReplacement(candidate, options.escapeMap, replacementCache);
+		const replaced = transformed.replace(candidate, replacement);
+		if (replaced !== transformed) {
+			transformed = replaced;
+			mutated = true;
+		}
+	}
+	return mutated ? transformed : void 0;
+}
+//#endregion
+//#region src/js/fast-path/oxc.ts
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+let oxcParser;
+let oxcWalker;
+function isOxcParserRuntimeSupported(version = node_process.default.versions.node) {
+	const match = /^(\d+)\.(\d+)(?:\.|$)/.exec(version);
+	if (!match) return false;
+	const major = Number(match[1]);
+	const minor = Number(match[2]);
+	if (major === 20) return minor >= 19;
+	if (major === 21) return false;
+	if (major === 22) return minor >= 12;
+	return major > 22;
+}
+function loadOxcParser() {
+	if (!isOxcParserRuntimeSupported()) return;
+	if (oxcParser === false) return;
+	if (oxcParser) return oxcParser;
+	try {
+		oxcParser = require$1("oxc-parser");
+	} catch {
+		oxcParser = false;
+		return;
+	}
+	return oxcParser;
+}
+function loadOxcWalker() {
+	if (!isOxcParserRuntimeSupported()) return;
+	if (oxcWalker === false) return;
+	if (oxcWalker) return oxcWalker;
+	try {
+		oxcWalker = require$1("oxc-walker");
+	} catch {
+		oxcWalker = false;
+		return;
+	}
+	return oxcWalker;
+}
+function hasValues(values) {
+	return Array.isArray(values) && values.length > 0;
+}
+function hasUnsupportedSourceMarker(rawSource) {
+	return rawSource.includes("eval(") || rawSource.includes("weapp-tw") && rawSource.includes("ignore");
+}
+function hasSupportedClassMatchSource(options) {
+	return options.alwaysEscape === true || Boolean(options.classNameSet && options.classNameSet.size > 0);
+}
+function canUseOxcJsFastPath(options) {
+	if (options.experimentalJsFastPath !== true && options.experimentalJsFastPath !== "oxc") return false;
+	return !options.generateMap && !options.wrapExpression && !options.moduleGraph && !options.moduleSpecifierReplacements && hasSupportedClassMatchSource(options) && !shouldEnableArbitraryValueFallback(options) && !hasValues(options.ignoreCallExpressionIdentifiers) && !hasValues(options.ignoreTaggedTemplateExpressionIdentifiers);
+}
+function getParserLang(filename) {
+	if (filename?.endsWith(".ts") || filename?.endsWith(".mts") || filename?.endsWith(".cts")) return "ts";
+	if (filename?.endsWith(".tsx")) return "tsx";
+	if (filename?.endsWith(".jsx")) return "jsx";
+	return "js";
+}
+function getParserSourceType(sourceType) {
+	return sourceType === "script" || sourceType === "module" ? sourceType : "module";
+}
+function isRangeValid(start, end) {
+	return typeof start === "number" && typeof end === "number" && start < end;
+}
+function getMagicString(rawSource, context) {
+	if (!context.ms) context.ms = new magic_string.default(rawSource);
+	return context.ms;
+}
+function addStringLiteralReplacement(rawSource, node, transformOptions, context) {
+	if (typeof node.value !== "string" || typeof node.raw !== "string" || !isRangeValid(node.start, node.end)) return false;
+	const transformed = transformLiteralText(node.value, transformOptions);
+	if (!transformed) return false;
+	const start = node.start + 1;
+	const end = node.end - 1;
+	if (start >= end || transformed === rawSource.slice(start, end)) return false;
+	getMagicString(rawSource, context).update(start, end, (0, _ast_core_escape.jsStringEscape)(transformed));
+	return true;
+}
+function addTemplateElementReplacement(rawSource, node, transformOptions, context) {
+	const raw = node.value?.raw;
+	if (typeof raw !== "string" || !isRangeValid(node.start, node.end)) return false;
+	const transformed = transformLiteralText(raw, transformOptions);
+	if (!transformed || transformed === raw) return false;
+	const first = rawSource[node.start];
+	const last = rawSource[node.end - 1];
+	const start = node.start + (first === "`" || first === "}" ? 1 : 0);
+	const end = node.end - (last === "`" ? 1 : last === "{" ? 2 : 0);
+	if (start >= end) return false;
+	getMagicString(rawSource, context).update(start, end, transformed);
+	return true;
+}
+function applyReplacements(rawSource, program, walker, stringLiteralOptions, templateLiteralOptions, context) {
+	let changed = false;
+	walker.walk(program, { enter(node) {
+		if (node.type === "Literal") {
+			changed = addStringLiteralReplacement(rawSource, node, stringLiteralOptions, context) || changed;
+			return;
+		}
+		if (node.type === "TemplateElement") {
+			changed = addTemplateElementReplacement(rawSource, node, templateLiteralOptions, context) || changed;
+			this.skip();
+		}
+	} });
+	return changed;
+}
+function oxcJsHandler(rawSource, options) {
+	if (!canUseOxcJsFastPath(options)) return;
+	if (hasUnsupportedSourceMarker(rawSource)) return;
+	const parser = loadOxcParser();
+	const walker = loadOxcWalker();
+	if (!parser || !walker) return;
+	let result;
+	try {
+		result = parser.parseSync(options.filename ?? "weapp-tailwindcss.js", rawSource, {
+			sourceType: getParserSourceType(options.babelParserOptions?.sourceType),
+			lang: getParserLang(options.filename)
+		});
+	} catch {
+		return;
+	}
+	if (!result.program || Array.isArray(result.errors) && result.errors.length > 0) return;
+	const stringLiteralOptions = options.needEscaped === true ? options : {
+		...options,
+		needEscaped: true
+	};
+	const templateLiteralOptions = options.needEscaped === false ? options : {
+		...options,
+		needEscaped: false
+	};
+	const replacementContext = {};
+	if (!applyReplacements(rawSource, result.program, walker, stringLiteralOptions, templateLiteralOptions, replacementContext)) return { code: rawSource };
+	return { code: replacementContext.ms.toString() };
+}
+//#endregion
+//#region src/js/precheck.ts
+/** 用于检测源码中是否包含类名相关模式的正则表达式 */
+const FAST_JS_TRANSFORM_HINT_RE = /className\b|class\s*=|classList\.|\b(?:twMerge|clsx|classnames|cn|cva)\b|\[["'`]class["'`]\]|text-\[|bg-\[|\b(?:[whpm]|px|py|mx|my|rounded|flex|grid|gap)-/;
+/** 用于检测源码中是否包含 import/export/require 语句的正则表达式 */
+const DEPENDENCY_HINT_RE = /\bimport\s*[("'`{*]|\brequire\s*\(|\bexport\s+\*\s+from\s+["'`]|\bexport\s*\{[^}]*\}\s*from\s+["'`]/;
+/**
+* 判断源码是否可能声明跨模块依赖。
+*
+* 该检查只作为性能预筛：返回 `true` 时必须保守走 AST 模块图分析；
+* 返回 `false` 时源码中没有可被当前模块图消费的静态 import/export/require 形态。
+*/
+function hasDependencyHint(rawSource) {
+	return DEPENDENCY_HINT_RE.test(rawSource);
+}
+/**
+* 判断是否可以跳过 JS 转换。
+* 通过正则快速检测源码内容，避免不必要的 Babel AST 解析。
+*
+* @param rawSource - 原始 JS 源码字符串
+* @param options - 可选的 JS 处理器配置选项
+* @returns 如果可以跳过转换返回 `true`，否则返回 `false`
+*/
+function shouldSkipJsTransform(rawSource, options) {
+	if (node_process.default.env["WEAPP_TW_DISABLE_JS_PRECHECK"] === "1") return false;
+	if (!rawSource) return true;
+	if (options?.alwaysEscape) return false;
+	if (options?.moduleSpecifierReplacements && Object.keys(options.moduleSpecifierReplacements).length > 0) return false;
+	if (options?.wrapExpression) return false;
+	if (hasDependencyHint(rawSource)) return false;
+	return !FAST_JS_TRANSFORM_HINT_RE.test(rawSource);
+}
+//#endregion
 //#region src/js/index.ts
 /** 默认 LRU 缓存最大条目数 */
 const RESULT_CACHE_MAX = 512;
@@ -2070,6 +2303,7 @@ function getOptionsFingerprint(options) {
 		JSON.stringify(options.ignoreCallExpressionIdentifiers ?? null),
 		JSON.stringify(options.ignoreTaggedTemplateExpressionIdentifiers?.map((v) => v instanceof RegExp ? v.source : v) ?? null),
 		JSON.stringify(options.moduleSpecifierReplacements ?? null),
+		String(options.experimentalJsFastPath ?? ""),
 		JSON.stringify(options.babelParserOptions ?? null)
 	].join("|");
 	fingerprintCache.set(options, fingerprint);
@@ -2085,6 +2319,13 @@ function shouldCacheJsResult(rawSource, options) {
 	if (options.moduleGraph || options.filename) return false;
 	return true;
 }
+function resolveFastPathOptions(rawSource, options) {
+	if (!options.moduleGraph) return options;
+	if (options.moduleSpecifierReplacements && Object.keys(options.moduleSpecifierReplacements).length > 0) return options;
+	if (hasDependencyHint(rawSource)) return options;
+	const { moduleGraph: _moduleGraph, ...fastPathOptions } = options;
+	return fastPathOptions;
+}
 function createJsHandler(options) {
 	const defaults = {
 		escapeMap: options.escapeMap,
@@ -2097,6 +2338,7 @@ function createJsHandler(options) {
 		alwaysEscape: options.alwaysEscape,
 		unescapeUnicode: options.unescapeUnicode,
 		babelParserOptions: options.babelParserOptions,
+		experimentalJsFastPath: options.experimentalJsFastPath,
 		ignoreCallExpressionIdentifiers: options.ignoreCallExpressionIdentifiers,
 		ignoreTaggedTemplateExpressionIdentifiers: options.ignoreTaggedTemplateExpressionIdentifiers,
 		uniAppX: options.uniAppX,
@@ -2165,7 +2407,7 @@ function createJsHandler(options) {
 		const resolvedOptions = resolveOptions(classNameSet, options);
 		const cached = getCachedJsResult(rawSource, resolvedOptions);
 		if (cached) return cached;
-		return setCachedJsResult(rawSource, resolvedOptions, jsHandler(rawSource, resolvedOptions));
+		return setCachedJsResult(rawSource, resolvedOptions, oxcJsHandler(rawSource, resolveFastPathOptions(rawSource, resolvedOptions)) ?? jsHandler(rawSource, resolvedOptions));
 	}
 	return handler;
 }
@@ -4539,7 +4781,7 @@ const DEFAULT_RUNTIME_PACKAGE_REPLACEMENTS = {
 //#endregion
 //#region src/context/runtime-package-replacements.ts
 function resolveRuntimePackageReplacements(option) {
-	const mapping = require_v3_engine.resolveBooleanObjectOption(option, DEFAULT_RUNTIME_PACKAGE_REPLACEMENTS);
+	const mapping = require_v4_engine.resolveBooleanObjectOption(option, DEFAULT_RUNTIME_PACKAGE_REPLACEMENTS);
 	if (!mapping) return;
 	const normalized = {};
 	for (const [from, to] of Object.entries(mapping)) {
@@ -4550,38 +4792,74 @@ function resolveRuntimePackageReplacements(option) {
 }
 //#endregion
 //#region src/context/style-options.ts
-function resolveStyleOptionsFromContext(ctx) {
+function resolveStyleOptionsFromContext(ctx, tailwindcssMajorVersion) {
 	const resolvedUniAppXOptions = require_tailwindcss.resolveUniAppXOptions(ctx.uniAppX);
+	const branch = require_generator.resolveGeneratorRuntimeBranch(require_generator.normalizeWeappTailwindcssGeneratorOptions(ctx.generator, {
+		appType: ctx.appType,
+		platform: ctx.cssOptions?.platform ?? ctx.platform,
+		tailwindcssMajorVersion,
+		uniAppX: resolvedUniAppXOptions
+	}), {
+		appType: ctx.appType,
+		platform: ctx.cssOptions?.platform ?? ctx.platform,
+		tailwindcssMajorVersion,
+		uniAppX: resolvedUniAppXOptions
+	});
+	const hasCssOptions = ctx.cssOptions !== void 0;
+	const cssOptions = {
+		cssPreflight: ctx.cssOptions?.cssPreflight ?? ctx.cssPreflight,
+		cssPreflightRange: ctx.cssOptions?.cssPreflightRange ?? ctx.cssPreflightRange,
+		cssChildCombinatorReplaceValue: ctx.cssOptions?.cssChildCombinatorReplaceValue ?? ctx.cssChildCombinatorReplaceValue,
+		cssSelectorReplacement: ctx.cssOptions?.cssSelectorReplacement ?? ctx.cssSelectorReplacement,
+		rem2rpx: ctx.cssOptions?.rem2rpx ?? ctx.rem2rpx,
+		cssRemoveProperty: ctx.cssOptions?.cssRemoveProperty ?? ctx.cssRemoveProperty,
+		cssRemoveHoverPseudoClass: ctx.cssOptions?.cssRemoveHoverPseudoClass ?? ctx.cssRemoveHoverPseudoClass,
+		tailwindcssV4GradientFallback: ctx.cssOptions?.tailwindcssV4GradientFallback ?? ctx.tailwindcssV4GradientFallback,
+		cssPresetEnv: ctx.cssOptions?.cssPresetEnv ?? ctx.cssPresetEnv,
+		atRules: ctx.cssOptions?.atRules ?? ctx.atRules,
+		autoprefixer: ctx.cssOptions?.autoprefixer ?? ctx.autoprefixer,
+		cssCalc: ctx.cssOptions?.cssCalc ?? ctx.cssCalc,
+		platform: branch.platform ?? ctx.cssOptions?.platform ?? ctx.platform,
+		px2rpx: ctx.cssOptions?.px2rpx ?? ctx.px2rpx,
+		unitsToPx: ctx.cssOptions?.unitsToPx ?? ctx.unitsToPx,
+		unitConversion: ctx.cssOptions?.unitConversion ?? ctx.unitConversion,
+		injectAdditionalCssVarScope: ctx.cssOptions?.injectAdditionalCssVarScope ?? ctx.injectAdditionalCssVarScope
+	};
 	return {
-		cssPreflight: ctx.cssPreflight,
-		cssPreflightRange: ctx.cssPreflightRange,
-		cssChildCombinatorReplaceValue: ctx.cssChildCombinatorReplaceValue,
-		cssSelectorReplacement: ctx.cssSelectorReplacement,
-		rem2rpx: ctx.rem2rpx,
-		cssRemoveProperty: ctx.cssRemoveProperty,
-		cssRemoveHoverPseudoClass: ctx.cssRemoveHoverPseudoClass,
-		cssPresetEnv: ctx.cssPresetEnv,
-		autoprefixer: ctx.autoprefixer,
-		cssCalc: ctx.cssCalc,
-		uniAppX: resolvedUniAppXOptions.enabled,
-		platform: ctx.platform,
-		px2rpx: ctx.px2rpx,
-		unitsToPx: ctx.unitsToPx,
-		unitConversion: ctx.unitConversion
+		appType: ctx.appType,
+		cssPreflight: cssOptions.cssPreflight,
+		cssPreflightRange: cssOptions.cssPreflightRange,
+		cssChildCombinatorReplaceValue: cssOptions.cssChildCombinatorReplaceValue,
+		cssSelectorReplacement: cssOptions.cssSelectorReplacement,
+		rem2rpx: cssOptions.rem2rpx,
+		...hasCssOptions ? { cssOptions } : {},
+		cssRemoveProperty: cssOptions.cssRemoveProperty,
+		cssRemoveHoverPseudoClass: cssOptions.cssRemoveHoverPseudoClass,
+		tailwindcssV4GradientFallback: cssOptions.tailwindcssV4GradientFallback,
+		cssPresetEnv: cssOptions.cssPresetEnv,
+		atRules: cssOptions.atRules,
+		autoprefixer: cssOptions.autoprefixer,
+		cssCalc: cssOptions.cssCalc,
+		uniAppX: branch.isNativeApp,
+		platform: cssOptions.platform,
+		px2rpx: cssOptions.px2rpx,
+		unitsToPx: cssOptions.unitsToPx,
+		unitConversion: cssOptions.unitConversion
 	};
 }
 //#endregion
 //#region src/context/handlers.ts
 function createHandlersFromContext(ctx, customAttributesEntities, cssCalcOptions, tailwindcssMajorVersion) {
-	const { escapeMap, injectAdditionalCssVarScope, postcssOptions, uniAppX, arbitraryValues, jsPreserveClass, jsArbitraryValueFallback, babelParserOptions, ignoreCallExpressionIdentifiers, ignoreTaggedTemplateExpressionIdentifiers, inlineWxs, disabledDefaultTemplateHandler, replaceRuntimePackages } = ctx;
+	const { escapeMap, injectAdditionalCssVarScope, postcssOptions, uniAppX, arbitraryValues, jsPreserveClass, jsArbitraryValueFallback, babelParserOptions, experimentalJsFastPath, ignoreCallExpressionIdentifiers, ignoreTaggedTemplateExpressionIdentifiers, inlineWxs, disabledDefaultTemplateHandler, replaceRuntimePackages } = ctx;
 	const resolvedUniAppXOptions = require_tailwindcss.resolveUniAppXOptions(uniAppX);
-	const styleOptions = resolveStyleOptionsFromContext(ctx);
+	const styleOptions = resolveStyleOptionsFromContext(ctx, tailwindcssMajorVersion);
+	const resolvedInjectAdditionalCssVarScope = styleOptions.cssOptions?.injectAdditionalCssVarScope ?? injectAdditionalCssVarScope;
 	const uniAppXEnabled = styleOptions.uniAppX === true;
 	const moduleSpecifierReplacements = resolveRuntimePackageReplacements(replaceRuntimePackages);
 	const styleHandler = (0, _weapp_tailwindcss_postcss.createStyleHandler)({
 		...styleOptions,
 		escapeMap,
-		injectAdditionalCssVarScope,
+		injectAdditionalCssVarScope: resolvedInjectAdditionalCssVarScope,
 		postcssOptions,
 		uniAppXUnsupported: resolvedUniAppXOptions.uvueUnsupported,
 		cssCalc: cssCalcOptions,
@@ -4595,6 +4873,7 @@ function createHandlersFromContext(ctx, customAttributesEntities, cssCalcOptions
 		tailwindcssMajorVersion,
 		generateMap: true,
 		babelParserOptions,
+		experimentalJsFastPath,
 		ignoreCallExpressionIdentifiers,
 		ignoreTaggedTemplateExpressionIdentifiers,
 		uniAppX: uniAppXEnabled,
@@ -4626,30 +4905,75 @@ function applyLoggerLevel(logLevel) {
 //#endregion
 //#region src/context/index.ts
 function resolveContextCssPreflight(opts, ctx, majorVersion) {
-	const cssPreflight = require_defaults.resolveDefaultCssPreflight(opts?.cssPreflight, majorVersion);
-	if (majorVersion !== 4 || cssPreflight === false || !require_tailwindcss.resolveUniAppXOptions(ctx.uniAppX).enabled) return cssPreflight;
-	const userCssPreflight = opts?.cssPreflight && typeof opts.cssPreflight === "object" ? opts.cssPreflight : void 0;
+	const userCssPreflight = opts?.cssOptions?.cssPreflight ?? opts?.cssPreflight;
+	const cssPreflight = require_defaults.resolveDefaultCssPreflight(userCssPreflight, majorVersion);
+	if (cssPreflight === false || !require_tailwindcss.resolveUniAppXOptions(ctx.uniAppX).enabled) return cssPreflight;
+	const userCssPreflightObject = userCssPreflight && typeof userCssPreflight === "object" ? userCssPreflight : void 0;
 	return {
 		...cssPreflight,
-		"border-width": userCssPreflight && "border-width" in userCssPreflight ? cssPreflight["border-width"] ?? false : "0",
-		"border-style": userCssPreflight && "border-style" in userCssPreflight ? cssPreflight["border-style"] ?? false : false,
-		"border": userCssPreflight && "border" in userCssPreflight ? cssPreflight["border"] ?? false : false
+		"border-width": userCssPreflightObject && "border-width" in userCssPreflightObject ? cssPreflight["border-width"] ?? false : "0",
+		"border-style": userCssPreflightObject && "border-style" in userCssPreflightObject ? cssPreflight["border-style"] ?? false : false,
+		"border": userCssPreflightObject && "border" in userCssPreflightObject ? cssPreflight["border"] ?? false : false
+	};
+}
+function syncCssOptionsToLegacyFields(ctx) {
+	if (!ctx.cssOptions) return;
+	const cssOptions = ctx.cssOptions;
+	ctx.cssPreflight = cssOptions.cssPreflight ?? ctx.cssPreflight;
+	ctx.cssPreflightRange = cssOptions.cssPreflightRange ?? ctx.cssPreflightRange;
+	ctx.cssChildCombinatorReplaceValue = cssOptions.cssChildCombinatorReplaceValue ?? ctx.cssChildCombinatorReplaceValue;
+	ctx.cssSelectorReplacement = cssOptions.cssSelectorReplacement ?? ctx.cssSelectorReplacement;
+	ctx.rem2rpx = cssOptions.rem2rpx ?? ctx.rem2rpx;
+	ctx.cssRemoveProperty = cssOptions.cssRemoveProperty ?? ctx.cssRemoveProperty;
+	ctx.cssRemoveHoverPseudoClass = cssOptions.cssRemoveHoverPseudoClass ?? ctx.cssRemoveHoverPseudoClass;
+	ctx.tailwindcssV4GradientFallback = cssOptions.tailwindcssV4GradientFallback ?? ctx.tailwindcssV4GradientFallback;
+	ctx.cssPresetEnv = cssOptions.cssPresetEnv ?? ctx.cssPresetEnv;
+	ctx.atRules = cssOptions.atRules ?? ctx.atRules;
+	ctx.autoprefixer = cssOptions.autoprefixer ?? ctx.autoprefixer;
+	ctx.cssCalc = cssOptions.cssCalc ?? ctx.cssCalc;
+	ctx.platform = cssOptions.platform ?? ctx.platform;
+	ctx.px2rpx = cssOptions.px2rpx ?? ctx.px2rpx;
+	ctx.unitsToPx = cssOptions.unitsToPx ?? ctx.unitsToPx;
+	ctx.unitConversion = cssOptions.unitConversion ?? ctx.unitConversion;
+	ctx.injectAdditionalCssVarScope = cssOptions.injectAdditionalCssVarScope ?? ctx.injectAdditionalCssVarScope;
+}
+function syncLegacyFieldsToCssOptions(ctx) {
+	if (!ctx.cssOptions) return;
+	ctx.cssOptions = {
+		...ctx.cssOptions ?? {},
+		cssPreflight: ctx.cssPreflight,
+		cssPreflightRange: ctx.cssPreflightRange,
+		cssChildCombinatorReplaceValue: ctx.cssChildCombinatorReplaceValue,
+		cssSelectorReplacement: ctx.cssSelectorReplacement,
+		rem2rpx: ctx.rem2rpx,
+		cssRemoveProperty: ctx.cssRemoveProperty,
+		cssRemoveHoverPseudoClass: ctx.cssRemoveHoverPseudoClass,
+		tailwindcssV4GradientFallback: ctx.tailwindcssV4GradientFallback,
+		cssPresetEnv: ctx.cssPresetEnv,
+		atRules: ctx.atRules,
+		autoprefixer: ctx.autoprefixer,
+		cssCalc: ctx.cssCalc,
+		platform: ctx.platform,
+		px2rpx: ctx.px2rpx,
+		unitsToPx: ctx.unitsToPx,
+		unitConversion: ctx.unitConversion,
+		injectAdditionalCssVarScope: ctx.injectAdditionalCssVarScope
 	};
 }
-async function clearTailwindcssPatcherCache(patcher, options) {
-	if (!patcher) return;
-	const cacheOptions = patcher.options?.cache;
+async function clearTailwindcssRuntimeCache(tailwindRuntime, options) {
+	if (!tailwindRuntime) return;
+	const cacheOptions = tailwindRuntime.options?.cache;
 	if (cacheOptions == null || typeof cacheOptions === "object" && cacheOptions.enabled === false) return;
-	if (typeof patcher.clearCache === "function") try {
-		await patcher.clearCache({ scope: "all" });
+	if (typeof tailwindRuntime.clearCache === "function") try {
+		await tailwindRuntime.clearCache({ scope: "all" });
 	} catch (error) {
-		_weapp_tailwindcss_logger.logger.debug("failed to clear tailwindcss patcher cache via clearCache(): %O", error);
+		_weapp_tailwindcss_logger.logger.debug("failed to clear tailwindcss runtime 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;
+	const privateCachePath = tailwindRuntime?.cacheStore?.options?.path;
 	if (privateCachePath) cachePaths.set(privateCachePath, false);
 	if (options?.removeDirectory && normalizedCacheOptions?.dir) cachePaths.set(normalizedCacheOptions.dir, true);
 	if (!cachePaths.size) return;
@@ -4661,39 +4985,41 @@ async function clearTailwindcssPatcherCache(patcher, options) {
 	} 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);
+		_weapp_tailwindcss_logger.logger.debug("failed to clear tailwindcss runtime cache: %s %O", cachePath, err);
 	}
 }
 function createInternalCompilerContext(opts) {
 	const ctx = (0, _weapp_tailwindcss_shared.defuOverrideArray)(opts, require_defaults.getDefaultOptions(), {});
 	ctx.arbitraryValues = resolveUnocssBareArbitraryValues(ctx.arbitraryValues, ctx.unocss);
 	ctx.escapeMap = ctx.customReplaceDictionary;
+	syncCssOptionsToLegacyFields(ctx);
 	applyLoggerLevel(ctx.logLevel);
-	const twPatcher = require_tailwindcss.createTailwindcssPatcherFromContext(ctx);
-	logTailwindcssTarget(twPatcher, ctx.tailwindcssBasedir);
-	logRuntimeTailwindcssVersion(ctx.tailwindcssBasedir, twPatcher.packageInfo?.rootPath, twPatcher.packageInfo?.version);
-	if (opts?.__internalDeferMissingCssEntriesWarning !== true) require_tailwindcss.warnMissingCssEntries(ctx, twPatcher);
-	ctx.cssPreflight = resolveContextCssPreflight(opts, ctx, twPatcher.majorVersion);
-	const cssCalcOptions = require_tailwindcss.applyV4CssCalcDefaults(ctx.cssCalc, twPatcher);
+	const tailwindRuntime = require_tailwindcss.createTailwindcssRuntimeFromContext(ctx);
+	logTailwindcssTarget(tailwindRuntime, ctx.tailwindcssBasedir);
+	logRuntimeTailwindcssVersion(ctx.tailwindcssBasedir, tailwindRuntime.packageInfo?.rootPath, tailwindRuntime.packageInfo?.version);
+	if (opts?.__internalDeferMissingCssEntriesWarning !== true) require_tailwindcss.warnMissingCssEntries(ctx, tailwindRuntime);
+	ctx.cssPreflight = resolveContextCssPreflight(opts, ctx, tailwindRuntime.majorVersion);
+	const cssCalcOptions = require_tailwindcss.applyV4CssCalcDefaults(ctx.cssCalc, tailwindRuntime);
 	ctx.cssCalc = cssCalcOptions;
-	const { styleHandler, jsHandler, templateHandler } = createHandlersFromContext(ctx, toCustomAttributesEntities(ctx.customAttributes), cssCalcOptions, twPatcher.majorVersion);
+	syncLegacyFieldsToCssOptions(ctx);
+	const { styleHandler, jsHandler, templateHandler } = createHandlersFromContext(ctx, toCustomAttributesEntities(ctx.customAttributes), cssCalcOptions, tailwindRuntime.majorVersion);
 	ctx.styleHandler = styleHandler;
 	ctx.jsHandler = jsHandler;
 	ctx.templateHandler = templateHandler;
 	ctx.cache = initializeCache(ctx.cache);
-	ctx.twPatcher = twPatcher;
-	const refreshTailwindcssPatcher = async (options) => {
-		const previousPatcher = ctx.twPatcher;
-		if (options?.clearCache !== false) await clearTailwindcssPatcherCache(previousPatcher);
-		require_v3_engine.invalidateRuntimeClassSet(previousPatcher);
-		const nextPatcher = require_tailwindcss.createTailwindcssPatcherFromContext(ctx);
-		Object.assign(previousPatcher, nextPatcher);
-		ctx.twPatcher = previousPatcher;
-		return previousPatcher;
+	ctx.tailwindRuntime = tailwindRuntime;
+	const refreshTailwindcssRuntime = async (options) => {
+		const previousRuntime = ctx.tailwindRuntime;
+		if (options?.clearCache !== false) await clearTailwindcssRuntimeCache(previousRuntime);
+		require_tailwindcss.invalidateRuntimeClassSet(previousRuntime);
+		const nextRuntime = require_tailwindcss.createTailwindcssRuntimeFromContext(ctx);
+		Object.assign(previousRuntime, nextRuntime);
+		ctx.tailwindRuntime = previousRuntime;
+		return previousRuntime;
 	};
-	ctx.refreshTailwindcssPatcher = refreshTailwindcssPatcher;
-	Object.defineProperty(ctx.twPatcher, refreshTailwindcssPatcherSymbol, {
-		value: refreshTailwindcssPatcher,
+	ctx.refreshTailwindcssRuntime = refreshTailwindcssRuntime;
+	Object.defineProperty(ctx.tailwindRuntime, refreshTailwindcssRuntimeSymbol, {
+		value: refreshTailwindcssRuntime,
 		configurable: true
 	});
 	return ctx;
@@ -4707,29 +5033,6 @@ function getCompilerContext(opts) {
 	return withCompilerContextCache(opts, () => createInternalCompilerContext(opts));
 }
 //#endregion
-//#region src/js/precheck.ts
-/** 用于检测源码中是否包含类名相关模式的正则表达式 */
-const FAST_JS_TRANSFORM_HINT_RE = /className\b|class\s*=|classList\.|\b(?:twMerge|clsx|classnames|cn|cva)\b|\[["'`]class["'`]\]|text-\[|bg-\[|\b(?:[whpm]|px|py|mx|my|rounded|flex|grid|gap)-/;
-/** 用于检测源码中是否包含 import/export/require 语句的正则表达式 */
-const DEPENDENCY_HINT_RE = /\bimport\s*[("'`{*]|\brequire\s*\(|\bexport\s+\*\s+from\s+["'`]|\bexport\s*\{[^}]*\}\s*from\s+["'`]/;
-/**
-* 判断是否可以跳过 JS 转换。
-* 通过正则快速检测源码内容，避免不必要的 Babel AST 解析。
-*
-* @param rawSource - 原始 JS 源码字符串
-* @param options - 可选的 JS 处理器配置选项
-* @returns 如果可以跳过转换返回 `true`，否则返回 `false`
-*/
-function shouldSkipJsTransform(rawSource, options) {
-	if (node_process.default.env["WEAPP_TW_DISABLE_JS_PRECHECK"] === "1") return false;
-	if (!rawSource) return true;
-	if (options?.alwaysEscape) return false;
-	if (options?.moduleSpecifierReplacements && Object.keys(options.moduleSpecifierReplacements).length > 0) return false;
-	if (options?.wrapExpression) return false;
-	if (DEPENDENCY_HINT_RE.test(rawSource)) return false;
-	return !FAST_JS_TRANSFORM_HINT_RE.test(rawSource);
-}
-//#endregion
 Object.defineProperty(exports, "JsTokenUpdater", {
 	enumerable: true,
 	get: function() {
@@ -4772,6 +5075,12 @@ Object.defineProperty(exports, "createAttributeMatcher", {
 		return createAttributeMatcher;
 	}
 });
+Object.defineProperty(exports, "createDebug", {
+	enumerable: true,
+	get: function() {
+		return createDebug;
+	}
+});
 Object.defineProperty(exports, "createTailwindRuntimeReadyPromise", {
 	enumerable: true,
 	get: function() {