weapp-tailwindcss 5.1.13 → 5.1.15

package/dist/{vite-Tpgi77vE.mjs → vite-nXZEiwG0.mjs}

@@ -1,12 +1,12 @@
 import { resolveImplicitAppTypeFromViteRoot } from "./framework.mjs";
-import { At as resolveTailwindV4CssSourceBase, E as resolveTailwindcssOptions, J as hasTailwindApplyDirective, K as stripMiniProgramCssSpecificityPlaceholders, N as normalizeEmptyTailwindCustomVariants, Nt as filterUnsupportedMiniProgramTailwindV4Candidates, Q as normalizeTailwindConfigDirectives, U as hasMiniProgramCssSpecificityPlaceholders, X as hasTailwindRootDirectives, Y as hasTailwindNonRootGenerationDirectives, Z as hasTailwindSourceDirectives, a as resolveGeneratorRuntimeBranch, b as normalizeCssEntries, c as shouldUseNativeAppCssBranch, ct as hasTailwindGeneratedCssMarkers, et as normalizeTailwindSourceForGenerator, ft as stripGeneratorPlaceholderMarkers, g as upsertTailwindV4CssSource, h as hasConfiguredTailwindV4CssRoots, i as normalizeWeappTailwindcssGeneratorOptions, j as hasUserCssLayerBlocks, l as resolveUniUtsPlatform, m as filterTailwindV4CssSourceRoots, nt as removeTailwindSourceDirectives, q as hasLocalCssImport, s as shouldUseMiniProgramCssBranch, tt as parseImportRequest, vt as getTailwindV4IncrementalGenerateCacheStats, x as findNearestPackageRoot, y as isTailwindV4CssEntry } from "./generator-BvPcmqxU.mjs";
+import { At as resolveTailwindV4CssSourceBase, E as resolveTailwindcssOptions, J as hasTailwindApplyDirective, K as stripMiniProgramCssSpecificityPlaceholders, N as normalizeEmptyTailwindCustomVariants, Nt as filterUnsupportedMiniProgramTailwindV4Candidates, Q as normalizeTailwindConfigDirectives, R as splitUserCssLayerBlocks, Tt as isFileMatchedByTailwindSourceEntries, U as hasMiniProgramCssSpecificityPlaceholders, X as hasTailwindRootDirectives, Y as hasTailwindNonRootGenerationDirectives, Z as hasTailwindSourceDirectives, a as resolveGeneratorRuntimeBranch, b as normalizeCssEntries, c as shouldUseNativeAppCssBranch, ct as hasTailwindGeneratedCssMarkers, et as normalizeTailwindSourceForGenerator, ft as stripGeneratorPlaceholderMarkers, g as upsertTailwindV4CssSource, h as hasConfiguredTailwindV4CssRoots, i as normalizeWeappTailwindcssGeneratorOptions, j as hasUserCssLayerBlocks, l as resolveUniUtsPlatform, m as filterTailwindV4CssSourceRoots, nt as removeTailwindSourceDirectives, q as hasLocalCssImport, s as shouldUseMiniProgramCssBranch, tt as parseImportRequest, vt as getTailwindV4IncrementalGenerateCacheStats, x as findNearestPackageRoot, y as isTailwindV4CssEntry } from "./generator-CEo920So.mjs";
 import { t as omitUndefined } from "./object-BJSWl-E5.mjs";
-import { _ as resolveViteTailwindV4CssDependencies, a as findTailwindConfig, f as createViteSourceScanMatcher, g as resolveTailwindV4EntriesFromCssCached, i as resolveUniAppXOptions, l as getRuntimeClassSetSignature, m as discoverTailwindV4CssEntries, p as resolveViteSourceScanEntries, r as isUniAppXEnabled } from "./tailwindcss-DZT_pWrd.mjs";
+import { _ as resolveViteTailwindV4CssDependencies, a as findTailwindConfig, f as createViteSourceScanMatcher, g as resolveTailwindV4EntriesFromCssCached, i as resolveUniAppXOptions, l as getRuntimeClassSetSignature, m as discoverTailwindV4CssEntries, p as resolveViteSourceScanEntries, r as isUniAppXEnabled } from "./tailwindcss-xs704TRw.mjs";
 import "./utils-MVwpU07P.mjs";
 import { g as replaceWxml, y as createDebug } from "./wxml-DdGdeqaH.mjs";
-import { a as vitePluginName, c as collectRuntimeClassSet, d as refreshTailwindRuntimeState, f as normalizeFrameworkStylePlatform, l as createTailwindRuntimeReadyPromise, n as normalizeStyleHandlerMajorVersion, o as shouldSkipJsTransform, s as toCustomAttributesEntities, t as getCompilerContext } from "./context-xSJE588m.mjs";
-import { A as processCachedTask, D as createCssSourceTraceCacheSignature, E as annotateCssSourceTrace, O as createCssTokenSourceMap, S as scoreTailwindV4CssSourceFileMatch, _ as normalizeMiniProgramGeneratorCssSource, a as isSourceCandidateRequest, d as validateCandidatesByGenerator, g as mergeMarkedUserLayerComponentsCss, h as extractMarkedUserLayerComponentsCss, m as runWithConcurrency, r as createSourceCandidateCollector, s as createBundleRuntimeClassSetManager, t as createHmrTimingRecorder, v as normalizeMiniProgramImportShell, y as isPureLocalCssImportWrapper } from "./hmr-timing-hRhRAjYV.mjs";
-import { A as createBundlerGeneratedCssMarker, B as resolveViteFrameworkProfile, C as createBundleModuleGraphOptions, D as normalizeOutputPathKey, E as stripRequestQuery, F as resolvePluginDisabledState, I as createBuiltinViteStyleInjectorPlugins, M as parseBundlerGeneratedCssMarkerBlocks, N as stripBundlerGeneratedCssMarkers, P as resolvePackageDir, R as viteStyleInjectorDelegates, S as applyLinkedResults, T as isSourceStyleRequest, _ as isCSSRequest, a as createCandidateSignature, b as slash, c as getSnapshotHash, d as buildBundleSnapshot, g as formatPostcssSourceMap, h as cleanUrl, i as createScopedGeneratorSourceTraceMap, j as hasBundlerGeneratedCssMarker, k as toAbsoluteOutputPath, l as hasRuntimeAffectingSourceChanges, m as updateBundleBuildState, n as createScopedGeneratorCandidateSignature, o as createJsHashSalt, p as createBundleBuildState, r as createScopedGeneratorRuntime, s as createLinkedImpactSignature, t as createSourceCandidateScanSignature, u as summarizeStringDiff, v as isHTMLRequest, w as generateTailwindV4Css, x as createRuntimeAffectingSourceSignature, y as normalizePath } from "./source-candidate-scan-signature-t4XKAQ04.mjs";
+import { a as vitePluginName, c as collectRuntimeClassSet, d as refreshTailwindRuntimeState, f as normalizeFrameworkStylePlatform, l as createTailwindRuntimeReadyPromise, n as normalizeStyleHandlerMajorVersion, o as shouldSkipJsTransform, s as toCustomAttributesEntities, t as getCompilerContext } from "./context-BgGWVAmN.mjs";
+import { C as scoreTailwindV4CssSourceFileMatch, F as annotateCssSourceTrace, I as createCssSourceTraceCacheSignature, L as createCssTokenSourceMap, M as hasBundlerGeneratedCssMarker, N as parseBundlerGeneratedCssMarkerBlocks, O as isSourceStyleRequest, P as stripBundlerGeneratedCssMarkers, _ as mergeMarkedUserLayerComponentsCss, a as isSourceCandidateRequest, b as isPureLocalCssImportWrapper, c as createBundleRuntimeClassSetManager, f as validateCandidatesByGenerator, g as extractMarkedUserLayerComponentsCss, h as runWithConcurrency, j as createBundlerGeneratedCssMarker, k as stripRequestQuery, r as createSourceCandidateCollector, s as extractCandidatesFromSource, t as createHmrTimingRecorder, v as normalizeMiniProgramGeneratorCssSource, y as normalizeMiniProgramImportShell, z as processCachedTask } from "./hmr-timing-1aS6--U7.mjs";
+import { A as createBuiltinViteStyleInjectorPlugins, C as createBundleModuleGraphOptions, D as toAbsoluteOutputPath, M as viteStyleInjectorDelegates, O as resolvePackageDir, P as resolveViteFrameworkProfile, S as applyLinkedResults, T as normalizeOutputPathKey, _ as isCSSRequest, a as createCandidateSignature, b as slash, c as getSnapshotHash, d as buildBundleSnapshot, g as formatPostcssSourceMap, h as cleanUrl, i as createScopedGeneratorSourceTraceMap, k as resolvePluginDisabledState, l as hasRuntimeAffectingSourceChanges, m as updateBundleBuildState, n as createScopedGeneratorCandidateSignature, o as createJsHashSalt, p as createBundleBuildState, r as createScopedGeneratorRuntime, s as createLinkedImpactSignature, t as createSourceCandidateScanSignature, u as summarizeStringDiff, v as isHTMLRequest, w as generateTailwindV4Css, x as createRuntimeAffectingSourceSignature, y as normalizePath } from "./source-candidate-scan-signature-Cf7259PR.mjs";
 import { t as logger$1 } from "./logger-BNzxZbZj.mjs";
 import fs, { existsSync, readFileSync, realpathSync } from "node:fs";
 import path from "node:path";
@@ -190,8 +190,28 @@ function createStyleValueFromApplySources(sources, utilityStyles) {
 	}
 	return Object.keys(result).length > 0 ? result : void 0;
 }
-function collectUniAppXHarmonyApplyStyleSourcesFromSource(source) {
-	return (source.includes("<style") ? [...source.matchAll(SFC_STYLE_BLOCK_RE$2)].map((styleBlock) => styleBlock[1] ?? "") : [source]).map((styleSource) => styleSource.trim()).filter((styleSource) => styleSource.length > 0 && styleSource.includes("@apply"));
+function resolveReferencePaths(styleSource, sourceId) {
+	if (!sourceId || !styleSource.includes("@reference")) return styleSource;
+	let root;
+	try {
+		root = postcss.parse(styleSource);
+	} catch {
+		return styleSource;
+	}
+	const cleanSourceId = sourceId.replace(/\?.*$/, "");
+	root.walkAtRules("reference", (rule) => {
+		const quote = rule.params[0];
+		if (quote !== "\"" && quote !== "'") return;
+		const closingQuoteIndex = rule.params.indexOf(quote, 1);
+		if (closingQuoteIndex <= 1) return;
+		const referencePath = rule.params.slice(1, closingQuoteIndex);
+		if (!referencePath.startsWith(".")) return;
+		rule.params = `${quote}${path.resolve(path.dirname(cleanSourceId), referencePath)}${quote}${rule.params.slice(closingQuoteIndex + 1)}`;
+	});
+	return root.toString();
+}
+function collectUniAppXHarmonyApplyStyleSourcesFromSource(source, sourceId) {
+	return (source.includes("<style") ? [...source.matchAll(SFC_STYLE_BLOCK_RE$2)].map((styleBlock) => styleBlock[1] ?? "") : [source]).map((styleSource) => resolveReferencePaths(styleSource.trim(), sourceId)).filter((styleSource) => styleSource.length > 0 && styleSource.includes("@apply"));
 }
 function collectUniAppXHarmonyApplyUtilitiesFromSources(sources) {
 	const utilities = /* @__PURE__ */ new Set();
@@ -236,7 +256,18 @@ const STYLE_DECL_RE = /const\s+(_style_\d+)\s*=\s*\{/g;
 const EXPORT_SFC_RE = /_export_sfc\(_sfc_main\s*,\s*\[/;
 const UNI_APP_X_STYLE_PLACEHOLDER_VERSION = "uni-app-x-style-placeholder-v2";
 function createUniAppXHarmonyApplyGeneratorSource(applyStyleSources, _applyUtilities) {
-	return applyStyleSources.join("\n");
+	return applyStyleSources.map((source) => {
+		let root;
+		try {
+			root = postcss.parse(source);
+		} catch {
+			return source;
+		}
+		root.walkAtRules("reference", (rule) => {
+			if (rule.params.match(/^(['"])(.+?)\1/)?.[2]?.startsWith(".")) rule.remove();
+		});
+		return root.toString();
+	}).join("\n");
 }
 function collectUniAppXHarmonyApplyUtilities(bundle) {
 	const utilities = /* @__PURE__ */ new Set();
@@ -465,6 +496,127 @@ function createUniAppXBundleAssetSourceGetter(bundle) {
 	};
 }
 //#endregion
+//#region src/bundlers/vite/generate-bundle/transform-filter.ts
+function toArray(value) {
+	return Array.isArray(value) ? value : value === void 0 ? [] : [value];
+}
+function normalizeSourceId(id) {
+	const file = cleanUrl(id);
+	return path.isAbsolute(file) ? path.resolve(file) : void 0;
+}
+function collectChunkModuleIds$2(chunk) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const id of chunk.moduleIds ?? []) {
+		const normalized = normalizeSourceId(id);
+		if (normalized) ids.add(normalized);
+	}
+	for (const id of Object.keys(chunk.modules ?? {})) {
+		const normalized = normalizeSourceId(id);
+		if (normalized) ids.add(normalized);
+	}
+	return ids;
+}
+function collectAssetSourceIds(asset, fallbackFile, rootDir) {
+	const ids = /* @__PURE__ */ new Set();
+	const sourceCandidates = [asset.originalFileName, ...asset.originalFileNames ?? []].filter((candidate) => typeof candidate === "string" && candidate.length > 0);
+	const candidates = sourceCandidates.length > 0 ? sourceCandidates : [fallbackFile];
+	for (const candidate of candidates) {
+		if (typeof candidate !== "string" || candidate.length === 0) continue;
+		const cleanCandidate = cleanUrl(candidate);
+		const resolved = path.isAbsolute(cleanCandidate) ? path.resolve(cleanCandidate) : path.resolve(rootDir, cleanCandidate);
+		ids.add(resolved);
+	}
+	return ids;
+}
+function isStringRuleMatched(rule, id, rootDir) {
+	const normalizedId = slash(id);
+	const normalizedRule = slash(rule);
+	if (path.isAbsolute(rule)) return micromatch.isMatch(normalizedId, normalizedRule);
+	const relative = slash(path.relative(rootDir, id));
+	return relative.length > 0 && !relative.startsWith("../") && !path.isAbsolute(relative) && micromatch.isMatch(relative, normalizedRule);
+}
+function isRuleMatched(rule, id, rootDir) {
+	if (typeof rule === "string") return isStringRuleMatched(rule, id, rootDir);
+	if (rule instanceof RegExp) {
+		rule.lastIndex = 0;
+		return rule.test(slash(id));
+	}
+	return rule(id) === true;
+}
+function createTransformMatcher(rules, rootDir) {
+	const normalizedRules = toArray(rules);
+	if (normalizedRules.length === 0) return;
+	return (id) => normalizedRules.some((rule) => isRuleMatched(rule, id, rootDir));
+}
+function shouldSkipSourceIds(sourceIds, filter) {
+	if (sourceIds.size === 0) return false;
+	if (filter.exclude) {
+		let excluded = true;
+		for (const id of sourceIds) if (!filter.exclude(id)) {
+			excluded = false;
+			break;
+		}
+		if (excluded) return true;
+	}
+	if (filter.include) {
+		for (const id of sourceIds) if (filter.include(id)) return false;
+		return true;
+	}
+	return false;
+}
+function createTransformFilter(options, rootDir) {
+	const include = createTransformMatcher(options?.include, rootDir);
+	const exclude = createTransformMatcher(options?.exclude, rootDir);
+	if (!include && !exclude) return;
+	return {
+		include,
+		exclude
+	};
+}
+function shouldSkipViteJsChunkTransform(chunk, filter) {
+	if (!filter) return false;
+	return shouldSkipSourceIds(collectChunkModuleIds$2(chunk), filter);
+}
+function shouldSkipViteAssetTransform(asset, file, rootDir, filter) {
+	if (!filter) return false;
+	return shouldSkipSourceIds(collectAssetSourceIds(asset, file, rootDir), filter);
+}
+function createRuleSignature(rules) {
+	return toArray(rules).map((rule) => {
+		if (typeof rule === "string") return `s:${rule}`;
+		if (rule instanceof RegExp) return `r:${rule.source}/${rule.flags}`;
+		return "f";
+	}).join("|") || "none";
+}
+function createTransformFilterSignature(options) {
+	return [`include:${createRuleSignature(options?.include)}`, `exclude:${createRuleSignature(options?.exclude)}`].join(";");
+}
+//#endregion
+//#region src/bundlers/vite/generate-bundle/bundle-markup-candidates.ts
+async function collectBundleMarkupCandidates(options) {
+	const { extractSourceCandidates, previousCandidatesByFile, preserveMissingFiles, resolveSourceCandidateFile, rootDir, snapshot, transformFilter } = options;
+	const candidatesByFile = preserveMissingFiles ? new Map([...previousCandidatesByFile ?? []].map(([file, candidates]) => [file, new Set(candidates)])) : /* @__PURE__ */ new Map();
+	await Promise.all(snapshot.entries.map(async (entry) => {
+		if (!extractSourceCandidates || entry.type !== "html" || entry.output.type !== "asset" || shouldSkipViteAssetTransform(entry.output, entry.file, rootDir, transformFilter)) return;
+		const sourceFile = resolveSourceCandidateFile(entry.file) ?? path.resolve(rootDir, entry.file);
+		candidatesByFile.set(sourceFile, await extractSourceCandidates(sourceFile, entry.source));
+	}));
+	const valuesForEntries = (entries, filterOptions = {}) => {
+		const values = /* @__PURE__ */ new Set();
+		for (const [file, candidates] of candidatesByFile) {
+			if (entries !== void 0 && !isFileMatchedByTailwindSourceEntries(file, entries)) continue;
+			if (filterOptions.excludeEntries?.length && isFileMatchedByTailwindSourceEntries(file, filterOptions.excludeEntries)) continue;
+			for (const candidate of candidates) values.add(candidate);
+		}
+		return values;
+	};
+	return {
+		candidatesByFile,
+		values: valuesForEntries(void 0),
+		valuesForEntries
+	};
+}
+//#endregion
 //#region src/bundlers/vite/generate-bundle/configured-css-sources.ts
 function collectConfiguredTailwindV4CssSources(opts) {
 	const runtimeCssSources = opts.tailwindcssRuntimeOptions?.tailwindcss?.v4?.cssSources ?? [];
@@ -548,7 +700,8 @@ function registerGeneratorDependencies$1(ctx, dependencies) {
 //#region src/bundlers/vite/generate-bundle/css-assets.ts
 function createCssAssetEmitter(context, bundle) {
 	return (fileName, source) => {
-		const existing = bundle?.[fileName];
+		const fileNameKey = normalizeOutputPathKey(fileName);
+		const existing = bundle?.[fileName] ?? Object.entries(bundle ?? {}).find(([bundleFile, output]) => output != null && typeof output === "object" && "type" in output && output.type === "asset" && normalizeOutputPathKey("fileName" in output && typeof output.fileName === "string" ? output.fileName : bundleFile) === fileNameKey)?.[1];
 		if (existing && typeof existing === "object" && "type" in existing && existing.type === "asset") {
 			existing.source = source;
 			return existing;
@@ -645,8 +798,9 @@ function resolveMiniProgramStyleOutputExtension(options = {}) {
 	return resolveStyleOutputExtensionFromFiles(options.files, options.cssMatcher, options.stem) ?? resolveStyleOutputExtensionFromFiles(options.files, options.cssMatcher) ?? resolveStyleOutputExtensionFromMatcher(options.cssMatcher, options.stem) ?? normalizeStyleOutputExtension(options.fallback) ?? FALLBACK_STYLE_OUTPUT_EXTENSION;
 }
 function resolveReplayCssOutputFile(rootDir, file) {
-	const normalizedFile = normalizeOutputPathKey(path.isAbsolute(file) ? path.relative(resolveCssOutputRealPath(rootDir), resolveCssOutputRealPath(file)) : file);
-	if (normalizedFile.length === 0 || normalizedFile === "." || normalizedFile === ".." || normalizedFile.startsWith("../")) return normalizeOutputPathKey(path.basename(file));
+	const cleanFile = file.replace(/[?#].*$/, "");
+	const normalizedFile = normalizeOutputPathKey(path.isAbsolute(cleanFile) ? path.relative(resolveCssOutputRealPath(rootDir), resolveCssOutputRealPath(cleanFile)) : cleanFile);
+	if (normalizedFile.length === 0 || normalizedFile === "." || normalizedFile === ".." || normalizedFile.startsWith("../")) return normalizeOutputPathKey(path.basename(cleanFile));
 	return normalizedFile;
 }
 function normalizeViteSourceRoot(rootDir, sourceRoot) {
@@ -662,9 +816,10 @@ function resolveReplayCssOutputFileFromSourceRoot(rootDir, file, sourceRoot) {
 	return outputFile;
 }
 function resolveViteCssOutputFile(file, opts, isWebGeneratorTarget, preserveCssExtension = false, styleOutputExtension, styleOutputFiles) {
-	if (isWebGeneratorTarget || preserveCssExtension || opts.cssMatcher(file) || !CSS_SOURCE_OUTPUT_EXT_RE.test(file) || !isCSSRequest(file)) return file;
-	const stem = file.replace(/[?#].*$/, "").replace(CSS_SOURCE_OUTPUT_EXT_RE, "");
-	return file.replace(CSS_SOURCE_OUTPUT_EXT_RE, resolveMiniProgramStyleOutputExtension({
+	const cleanFile = file.replace(/[?#].*$/, "");
+	if (isWebGeneratorTarget || preserveCssExtension || opts.cssMatcher(cleanFile) || !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) || !isCSSRequest(file)) return cleanFile;
+	const stem = cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, "");
+	return cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, resolveMiniProgramStyleOutputExtension({
 		cssMatcher: opts.cssMatcher,
 		fallback: styleOutputExtension,
 		files: styleOutputFiles,
@@ -672,20 +827,40 @@ function resolveViteCssOutputFile(file, opts, isWebGeneratorTarget, preserveCssE
 	}));
 }
 function resolveViteCssPipelineOutputFile(file, opts, rootDir, isWebGeneratorTarget = false, preserveCssExtension = false, sourceRoot, styleOutputExtension, styleOutputFiles) {
-	const normalizedFile = resolveReplayCssOutputFileFromSourceRoot(rootDir, file, sourceRoot);
-	const cleanFile = normalizedFile.replace(/[?#].*$/, "");
+	const sourceStyleRequest = isCSSRequest(file);
+	const cleanFile = resolveReplayCssOutputFileFromSourceRoot(rootDir, file, sourceRoot).replace(/[?#].*$/, "");
+	const sourceExtension = path.extname(cleanFile);
+	if (sourceStyleRequest && !isWebGeneratorTarget && !preserveCssExtension && sourceExtension.length > 0 && !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile)) {
+		const stem = cleanFile.slice(0, -sourceExtension.length);
+		return `${stem}${resolveMiniProgramStyleOutputExtension({
+			cssMatcher: opts.cssMatcher,
+			fallback: styleOutputExtension,
+			files: styleOutputFiles,
+			stem
+		})}`;
+	}
 	const stem = cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, "");
 	const matchedStyleExtension = !isWebGeneratorTarget && !preserveCssExtension ? resolveStyleOutputExtensionFromFiles(styleOutputFiles, opts.cssMatcher, stem) : void 0;
-	if (matchedStyleExtension && CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) && isCSSRequest(normalizedFile)) return normalizedFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, matchedStyleExtension);
-	if (isWebGeneratorTarget || preserveCssExtension || opts.cssMatcher(normalizedFile) || !CSS_SOURCE_OUTPUT_EXT_RE.test(normalizedFile) || !isCSSRequest(normalizedFile)) return normalizedFile;
+	if (matchedStyleExtension && CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) && sourceStyleRequest) return cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, matchedStyleExtension);
+	if (isWebGeneratorTarget || preserveCssExtension || opts.cssMatcher(cleanFile) || !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) || !sourceStyleRequest) return cleanFile;
 	const fallbackExtension = normalizeStyleOutputExtension(styleOutputExtension);
-	if (!fallbackExtension && !SOURCE_STYLE_OUTPUT_EXT_RE.test(normalizedFile)) return normalizedFile;
-	return normalizedFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, fallbackExtension ?? FALLBACK_STYLE_OUTPUT_EXTENSION);
+	if (!fallbackExtension && !SOURCE_STYLE_OUTPUT_EXT_RE.test(cleanFile)) return cleanFile;
+	return cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, fallbackExtension ?? FALLBACK_STYLE_OUTPUT_EXTENSION);
 }
 function resolveViteCssPipelineOutputFileFromSourceFile(sourceFile, opts, rootDir, isWebGeneratorTarget = false, preserveCssExtension = false, sourceRoot, styleOutputExtension, styleOutputFiles) {
-	const normalizedFile = resolveReplayCssOutputFileFromSourceRoot(rootDir, sourceFile, sourceRoot);
-	const cleanFile = normalizedFile.replace(/[?#].*$/, "");
-	if (isWebGeneratorTarget || preserveCssExtension || !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) || !isCSSRequest(normalizedFile)) return normalizedFile;
+	const sourceStyleRequest = isCSSRequest(sourceFile);
+	const cleanFile = resolveReplayCssOutputFileFromSourceRoot(rootDir, sourceFile, sourceRoot).replace(/[?#].*$/, "");
+	const sourceExtension = path.extname(cleanFile);
+	if (sourceStyleRequest && !isWebGeneratorTarget && !preserveCssExtension && sourceExtension.length > 0 && !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile)) {
+		const stem = cleanFile.slice(0, -sourceExtension.length);
+		return resolveStyleOutputFileFromFiles(styleOutputFiles, opts.cssMatcher, stem) ?? `${stem}${resolveMiniProgramStyleOutputExtension({
+			cssMatcher: opts.cssMatcher,
+			fallback: styleOutputExtension,
+			files: styleOutputFiles,
+			stem
+		})}`;
+	}
+	if (isWebGeneratorTarget || preserveCssExtension || !CSS_SOURCE_OUTPUT_EXT_RE.test(cleanFile) || !sourceStyleRequest) return cleanFile;
 	const stem = cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, "");
 	const matchedStyleFile = resolveStyleOutputFileFromFiles(styleOutputFiles, opts.cssMatcher, stem);
 	if (matchedStyleFile) return matchedStyleFile;
@@ -695,7 +870,7 @@ function resolveViteCssPipelineOutputFileFromSourceFile(sourceFile, opts, rootDi
 		files: styleOutputFiles,
 		stem
 	}) ?? normalizeStyleOutputExtension(styleOutputExtension);
-	return normalizedFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, styleExtension);
+	return cleanFile.replace(CSS_SOURCE_OUTPUT_EXT_RE, styleExtension);
 }
 function canProcessViteSourceStyleAsCss(source, file) {
 	if (SOURCE_STYLE_NON_CSS_SYNTAX_RE.test(source)) return false;
@@ -847,7 +1022,8 @@ function createCssHandlerOptionsCache(options) {
 		const appType = options.getAppType();
 		const isMainChunk = options.mainCssChunkMatcher(file, appType);
 		const outputRoot = options.getOutputRoot?.();
-		const from = path.isAbsolute(file) ? file : outputRoot ? path.resolve(outputRoot, file) : file;
+		const sourceFile = stripRequestQuery(file);
+		const from = path.isAbsolute(sourceFile) ? sourceFile : outputRoot ? path.resolve(outputRoot, sourceFile) : sourceFile;
 		const extraOptions = options.getExtraOptions?.(file) ?? {};
 		const dynamicCssOptions = options.getDynamicCssOptions?.() ?? {};
 		const cacheKey = `${majorVersion ?? "unknown"}:${appType ?? "unknown"}:${isMainChunk ? "1" : "0"}:${outputRoot ?? ""}:${file}:${JSON.stringify(extraOptions)}:${JSON.stringify(dynamicCssOptions)}`;
@@ -859,7 +1035,10 @@ function createCssHandlerOptionsCache(options) {
 			...dynamicCssOptions,
 			postcssOptions: { options: { from } },
 			majorVersion: normalizeStyleHandlerMajorVersion(majorVersion),
-			sourceOptions: { outputRoot }
+			sourceOptions: {
+				outputRoot,
+				...sourceFile === file ? {} : { requestFile: file }
+			}
 		};
 		cssHandlerOptionsCache.set(cacheKey, created);
 		return created;
@@ -899,6 +1078,21 @@ function createRelativeCssImportRequest$1(targetFile, importedFile) {
 function createCssImportShell$1(targetFile, importedFile) {
 	return `@import "${createRelativeCssImportRequest$1(targetFile, importedFile)}";\n`;
 }
+function resolveSingleCssImportOutputFile(targetFile, css) {
+	let importedFile;
+	try {
+		postcss.parse(css).walkAtRules("import", (atRule) => {
+			if (importedFile !== void 0) return;
+			const request = parseImportRequest(atRule.params);
+			if (!request || /^(?:https?:)?\/\//i.test(request) || request.startsWith("data:")) return;
+			const cleanRequest = request.replace(/[?#].*$/, "");
+			if (!/\.(?:css|wxss|acss|ttss|qss|jxss|tyss)$/i.test(cleanRequest)) return;
+			const targetDir = path.posix.dirname(normalizeOutputPathKey(targetFile));
+			importedFile = normalizeOutputPathKey(path.posix.join(targetDir === "." ? "" : targetDir, cleanRequest));
+		});
+	} catch {}
+	return importedFile;
+}
 function createRootMiniProgramOriginStyleOutputFile(file) {
 	const normalized = normalizeOutputPathKey(file.replace(/[?#].*$/, ""));
 	if (/(?:^|\/)[^/]+-origin\.[^.]+$/i.test(normalized)) return normalized;
@@ -907,6 +1101,28 @@ function createRootMiniProgramOriginStyleOutputFile(file) {
 function shouldKeepRootMiniProgramStyleAsImportShell(enabled) {
 	return enabled === true;
 }
+function shouldPreserveFrameworkRootMiniProgramImportShell(options) {
+	return !options.isWebGeneratorTarget && options.matchesCss && isRootMiniProgramStyleOutputFile$1(options.file) && isPureLocalCssImportWrapper(options.css) && shouldKeepRootMiniProgramStyleAsImportShell(options.shouldKeep());
+}
+function restoreFrameworkRootMiniProgramImportShellAssets(bundle, options) {
+	if (options.isWebGeneratorTarget || options.targetByFile.size === 0) return 0;
+	let restored = 0;
+	for (const [sourceFile, targetFile] of options.targetByFile) {
+		if (!options.matchesCss(sourceFile) || !options.matchesCss(targetFile) || !isRootMiniProgramStyleOutputFile$1(sourceFile) || !isRootMiniProgramStyleOutputFile$1(targetFile) || normalizeOutputPathKey(sourceFile) === normalizeOutputPathKey(targetFile)) continue;
+		const output = Object.entries(bundle).find(([bundleFile, candidate]) => candidate.type === "asset" && normalizeOutputPathKey(candidate.fileName || bundleFile) === normalizeOutputPathKey(sourceFile))?.[1];
+		if (output?.type !== "asset") continue;
+		const rawSource = output.source.toString();
+		if (!shouldKeepRootMiniProgramStyleAsImportShell(options.shouldKeep(sourceFile, rawSource))) continue;
+		const nextSource = createCssImportShell$1(sourceFile, targetFile);
+		if (rawSource === nextSource) continue;
+		output.source = nextSource;
+		options.recordCssAssetResult?.(sourceFile, nextSource);
+		options.onUpdate?.(sourceFile, rawSource, nextSource);
+		options.debug?.("restore framework root css import shell: %s -> %s", sourceFile, targetFile);
+		restored++;
+	}
+	return restored;
+}
 function shouldMoveRootMiniProgramStyleToImportShellOrigin(enabled) {
 	return enabled === true;
 }
@@ -925,6 +1141,7 @@ function shouldSkipRawSourceStyleAsset(outputFile, file, rawSource, assetSourceF
 	const source = rawSource.trim();
 	if (source.length === 0) return false;
 	if (canProcessViteSourceStyleAsCss(source, file)) return false;
+	if (SOURCE_STYLE_OUTPUT_EXT_RE.test(assetSourceFile.replace(/[?#].*$/, ""))) return true;
 	const isKnownStyleSource = isSourceStyleRequest(assetSourceFile) || cssMatcher?.(assetSourceFile) === true;
 	return outputFile !== file || !isKnownStyleSource;
 }
@@ -1493,6 +1710,10 @@ const SFC_STYLE_SOURCE_EXTENSIONS = [
 const SFC_STYLE_BLOCK_RE$1 = /<style\b([^>]*)>([\s\S]*?)<\/style>/gi;
 const SFC_SCOPED_STYLE_ATTR_RE = /(?:^|\s)scoped(?:\s|=|$)/i;
 const SFC_LANG_STYLE_ATTR_RE = /(?:^|\s)lang(?:=(?:"([^"]+)"|'([^']+)'|([^\s"'=<>`]+)))?/i;
+function isSfcStyleSourceFile(file) {
+	const normalizedFile = file.replace(/[?#].*$/, "");
+	return SFC_STYLE_SOURCE_EXTENSIONS.some((extension) => normalizedFile.endsWith(extension));
+}
 function extractSfcStyleBlocks(source) {
 	const styleSources = [];
 	SFC_STYLE_BLOCK_RE$1.lastIndex = 0;
@@ -1538,7 +1759,7 @@ function createSfcStyleRequest(sourceFile, styleBlock) {
 	if (lang) params.set("lang", lang);
 	return `${sourceFile}?${params.toString()}`;
 }
-function resolveSfcStyleRequestFromKnownSource(sourceFile, sfcSource, styleSource) {
+function resolveSfcStyleRequestFromKnownSource(sourceFile, sfcSource, styleSource, currentRequest) {
 	if (!sfcSource) return sourceFile;
 	const styleBlocks = extractSfcStyleBlocks(sfcSource);
 	if (styleBlocks.length === 0) return sourceFile;
@@ -1547,7 +1768,8 @@ function resolveSfcStyleRequestFromKnownSource(sourceFile, sfcSource, styleSourc
 		const normalizedBlockSource = normalizeSfcStyleSourceForCompare(styleBlock.source);
 		return normalizedBlockSource === normalizedStyleSource || normalizedBlockSource.includes(normalizedStyleSource) || normalizedStyleSource.includes(normalizedBlockSource);
 	});
-	const styleBlock = matchedBlocks.length === 1 ? matchedBlocks[0] : styleBlocks.length === 1 ? styleBlocks[0] : void 0;
+	const requestIndex = currentRequest ? Number.parseInt(new URLSearchParams(currentRequest.split("?", 2)[1] ?? "").get("index") ?? "", 10) : NaN;
+	const styleBlock = (Number.isInteger(requestIndex) ? styleBlocks.find((styleBlock) => styleBlock.index === requestIndex) : void 0) ?? (matchedBlocks.length === 1 ? matchedBlocks[0] : styleBlocks.length === 1 ? styleBlocks[0] : void 0);
 	return styleBlock ? createSfcStyleRequest(sourceFile, styleBlock) : sourceFile;
 }
 function hasTailwindGenerationSource(source, options = {}) {
@@ -1585,7 +1807,7 @@ async function resolveSfcStyleSourceFromOutputFile(outputFile, snapshot, outputR
 function normalizeSfcSourceFileForCompare(file) {
 	return normalizeOutputPathKey(file.replace(/[?#].*$/, ""));
 }
-function collectChunkModuleIds$2(output) {
+function collectChunkModuleIds$1(output) {
 	const moduleIds = Array.isArray(output.moduleIds) ? output.moduleIds : [];
 	return [
 		output.facadeModuleId,
@@ -1609,7 +1831,7 @@ function resolveSiblingJsChunkFile(outputFile, cssMatcher) {
 }
 function normalizeSfcModuleId(id) {
 	const file = id.replace(/[?#].*$/, "");
-	if (!SFC_STYLE_SOURCE_EXTENSIONS.some((extension) => file.endsWith(extension))) return;
+	if (!isSfcStyleSourceFile(file)) return;
 	if (!path.isAbsolute(file)) return;
 	return path.resolve(file);
 }
@@ -1625,7 +1847,7 @@ function resolveSfcStyleFileFromSiblingChunk(outputFile, snapshot, outputRoot, s
 		debug("sfc style sibling chunk skipped: missing chunk for %s -> %s", outputFile, siblingJsFile);
 		return;
 	}
-	const sourceFiles = collectChunkModuleIds$2(siblingChunk.output).map(normalizeSfcModuleId).filter((file, index, files) => Boolean(file) && files.indexOf(file) === index);
+	const sourceFiles = collectChunkModuleIds$1(siblingChunk.output).map(normalizeSfcModuleId).filter((file, index, files) => Boolean(file) && files.indexOf(file) === index);
 	if (sourceFiles.length === 0) {
 		debug("sfc style sibling chunk skipped: no sfc modules for %s -> %s", outputFile, siblingJsFile);
 		return;
@@ -1656,7 +1878,7 @@ function resolveSourceStyleFileFromSiblingChunk(outputFile, snapshot, outputRoot
 		debug("source style sibling chunk skipped: missing chunk for %s -> %s", outputFile, siblingJsFile);
 		return;
 	}
-	const sourceFiles = collectChunkModuleIds$2(siblingChunk.output).map(normalizeSourceStyleModuleId).filter((file, index, files) => Boolean(file) && files.indexOf(file) === index);
+	const sourceFiles = collectChunkModuleIds$1(siblingChunk.output).map(normalizeSourceStyleModuleId).filter((file, index, files) => Boolean(file) && files.indexOf(file) === index);
 	if (sourceFiles.length === 0) {
 		debug("source style sibling chunk skipped: no source style modules for %s -> %s", outputFile, siblingJsFile);
 		return;
@@ -1775,7 +1997,7 @@ function collectMiniProgramSubpackageSourceEntries(snapshot, subpackageRoots, so
 		if (entry.output.type !== "chunk" || !isSubpackageOutputFile(entry.file, subpackageRoots)) continue;
 		const matchedSubpackageRoot = [...subpackageRoots].find((root) => isSubpackageOutputFile(entry.file, /* @__PURE__ */ new Set([root])));
 		if (!matchedSubpackageRoot) continue;
-		for (const moduleId of collectChunkModuleIds$2(entry.output)) {
+		for (const moduleId of collectChunkModuleIds$1(entry.output)) {
 			if (!path.isAbsolute(moduleId.replace(/[?#].*$/, ""))) continue;
 			const sourceRoot = resolveSubpackageSourceRootFromModuleId(moduleId, matchedSubpackageRoot);
 			if (sourceRoot) sourceRoots.add(sourceRoot);
@@ -2257,11 +2479,17 @@ function isMiniProgramStyleOutputFile(file) {
 }
 function shouldPreserveMiniProgramImportShell(options, bundle, file, css) {
 	const context = createCssAssetPipelineContext(options, file, bundle);
-	return context !== void 0 && options.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
-		...context,
+	return context !== void 0 && shouldPreserveFrameworkRootMiniProgramImportShell({
 		css,
-		file
-	}) === true && isMiniProgramStyleOutputFile(file) && options.opts.cssMatcher(file) && isPureLocalCssImportWrapper(css);
+		file,
+		isWebGeneratorTarget: context.currentGeneratorBranch?.isWeb === true,
+		matchesCss: options.opts.cssMatcher(file),
+		shouldKeep: () => options.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+			...context,
+			css,
+			file
+		})
+	});
 }
 function resolvePreservedImportShellInjectionTarget(options, bundle, file, css) {
 	const context = createCssAssetPipelineContext(options, file, bundle);
@@ -3031,21 +3259,6 @@ function resolveRootMiniProgramOriginStyleFile(file) {
 	if (/(?:^|\/)[^/]+-origin\.[^.]+$/i.test(normalized)) return;
 	return normalized.replace(/(\.[^.]+)$/, "-origin$1");
 }
-function resolveSingleCssImportOutputFile(targetFile, css) {
-	let importedFile;
-	try {
-		postcss.parse(css).walkAtRules("import", (atRule) => {
-			if (importedFile !== void 0) return;
-			const request = parseImportRequest(atRule.params);
-			if (!request || /^(?:https?:)?\/\//i.test(request) || request.startsWith("data:")) return;
-			const cleanRequest = request.replace(/[?#].*$/, "");
-			if (!/\.(?:css|wxss|acss|ttss|qss|jxss|tyss)$/i.test(cleanRequest)) return;
-			const targetDir = path.posix.dirname(normalizeOutputPathKey(targetFile));
-			importedFile = normalizeOutputPathKey(path.posix.join(targetDir === "." ? "" : targetDir, cleanRequest));
-		});
-	} catch {}
-	return importedFile;
-}
 function normalizeRootMiniProgramImportShellAssets(bundle, options) {
 	if (!options.enabled) return 0;
 	let updated = 0;
@@ -3315,11 +3528,12 @@ function collectUnescapedDynamicCandidates(source, allowedCandidates) {
 //#region src/bundlers/vite/generate-bundle/html-processing.ts
 function processHtmlBundleEntry(options) {
 	const { cache, context, debug, dynamicRetryCandidates, file, metrics, onUpdate, originalEntrySource, originalSource, rememberProcessCacheKey, resolveCurrentSourceCandidateSource, tasks, templateHandler, timeTask, transformRuntime, transformRuntimeSignature } = options;
-	const rawSource = resolveCurrentSourceCandidateSource(file) ?? originalEntrySource;
-	const currentRawDynamicCandidates = collectUnescapedDynamicCandidates(rawSource);
-	const templateRuntime = currentRawDynamicCandidates.length > 0 ? /* @__PURE__ */ new Set([...transformRuntime, ...currentRawDynamicCandidates]) : transformRuntime;
+	const currentBundleSource = originalEntrySource;
+	const candidateSource = resolveCurrentSourceCandidateSource(file) ?? currentBundleSource;
+	const currentRawDynamicCandidates = /* @__PURE__ */ new Set([...collectUnescapedDynamicCandidates(candidateSource), ...collectUnescapedDynamicCandidates(currentBundleSource)]);
+	const templateRuntime = currentRawDynamicCandidates.size > 0 ? /* @__PURE__ */ new Set([...transformRuntime, ...currentRawDynamicCandidates]) : transformRuntime;
 	const templateRuntimeSignature = templateRuntime === transformRuntime ? transformRuntimeSignature : createCandidateSignature(templateRuntime);
-	const htmlProcessHash = `${cache.computeHash(rawSource)}:${cache.computeHash(createRuntimeAffectingSourceSignature(rawSource, "html"))}:${templateRuntimeSignature}`;
+	const htmlProcessHash = `${cache.computeHash(currentBundleSource)}:${cache.computeHash(createRuntimeAffectingSourceSignature(currentBundleSource, "html"))}:${templateRuntimeSignature}`;
 	const cacheKey = `${file}:html:${htmlProcessHash}`;
 	const hashKey = cacheKey;
 	rememberProcessCacheKey(cacheKey, hashKey);
@@ -3337,7 +3551,7 @@ function processHtmlBundleEntry(options) {
 		},
 		async transform() {
 			const start = performance.now();
-			let transformed = await templateHandler(rawSource, { runtimeSet: templateRuntime });
+			let transformed = await templateHandler(currentBundleSource, { runtimeSet: templateRuntime });
 			let unresolvedDynamicCandidates = collectUnescapedDynamicCandidates(transformed);
 			let retryRuntimeSet;
 			if (unresolvedDynamicCandidates.length > 0) {
@@ -3348,13 +3562,13 @@ function processHtmlBundleEntry(options) {
 			}
 			if (retryRuntimeSet && unresolvedDynamicCandidates.length > 0) {
 				logger.warn("检测到已提取 WXML 动态类名未完成转译，已回退到完整 runtimeSet 重试: %s -> %O", file, unresolvedDynamicCandidates);
-				transformed = await templateHandler(rawSource, { runtimeSet: retryRuntimeSet });
+				transformed = await templateHandler(currentBundleSource, { runtimeSet: retryRuntimeSet });
 				unresolvedDynamicCandidates = collectUnescapedDynamicCandidates(transformed, retryRuntimeSet);
 				if (unresolvedDynamicCandidates.length > 0) logger.warn("已提取 WXML 动态类名在完整 runtimeSet 重试后仍未完成转译: %s -> %O", file, unresolvedDynamicCandidates);
 			}
 			metrics.html.elapsed += measureElapsed(start);
 			metrics.html.transformed++;
-			onUpdate(file, rawSource, transformed);
+			onUpdate(file, currentBundleSource, transformed);
 			debug("html handle: %s", file);
 			return { result: transformed };
 		}
@@ -3460,7 +3674,7 @@ function resolveUniAppXStyleIsolationEnabled(root) {
 //#region src/uni-app-x/vite.ts
 let transformUVuePromise;
 function loadTransformUVue() {
-	transformUVuePromise ?? (transformUVuePromise = import("./transform-D5JUgMpE.mjs").then((mod) => mod.transformUVue));
+	transformUVuePromise ?? (transformUVuePromise = import("./transform-B_KM9sLX.mjs").then((mod) => mod.transformUVue));
 	return transformUVuePromise;
 }
 const preprocessorLangs = /* @__PURE__ */ new Set([
@@ -3501,8 +3715,8 @@ function createUniAppXPlugins(options) {
 	let componentLocalStyleEnabled;
 	const harmonyApplyStyleSources = /* @__PURE__ */ new Set();
 	const harmonyApplyUtilities = /* @__PURE__ */ new Set();
-	function rememberHarmonyApplySource(code) {
-		const styleSources = collectUniAppXHarmonyApplyStyleSourcesFromSource(code);
+	function rememberHarmonyApplySource(code, id) {
+		const styleSources = collectUniAppXHarmonyApplyStyleSourcesFromSource(code, id);
 		if (styleSources.length === 0) return;
 		for (const styleSource of styleSources) {
 			harmonyApplyStyleSources.add(styleSource);
@@ -3535,7 +3749,7 @@ function createUniAppXPlugins(options) {
 		if (isCSSRequest(id) || parsed.vue && parsed.type === "style") {
 			if (isCssModuleExport(code)) return;
 			const shouldGenerateCss = hasTailwindSourceDirectives(code, { importFallback: true }) || hasTailwindApplyDirective(code);
-			rememberHarmonyApplySource(code);
+			rememberHarmonyApplySource(code, id);
 			const generatedCss = shouldGenerateCss ? await generateCss?.(id, code, hookContext) : void 0;
 			const styleCode = typeof generatedCss === "string" && generatedCss.trim().length > 0 ? generatedCss : code;
 			const cacheKey = `${mainCssChunkMatcher(id, appType) ? "1" : "0"}:${id}`;
@@ -3595,7 +3809,7 @@ function createUniAppXPlugins(options) {
 		async transform(code, id) {
 			if (!isEnabled()) return;
 			if (!UVUE_NVUE_QUERY_RE.test(id)) return;
-			rememberHarmonyApplySource(code);
+			rememberHarmonyApplySource(code, id);
 			const resolvedConfig = getResolvedConfig();
 			const isServeCommand = resolvedConfig?.command === "serve";
 			const isWatchBuild = resolvedConfig?.command === "build" && !!resolvedConfig.build?.watch;
@@ -3604,13 +3818,19 @@ function createUniAppXPlugins(options) {
 			const transformUVue = await loadTransformUVue();
 			const enableComponentLocalStyle = shouldEnableComponentLocalStyle();
 			const enablePageLocalStyle = shouldEnableHarmonyPageLocalStyle();
-			if (customAttributesEntities.length > 0 || disabledDefaultTemplateHandler || enableComponentLocalStyle || enablePageLocalStyle) return transformUVue(code, id, jsHandler, currentRuntimeSet, omitUndefined({
-				...customAttributesEntities.length > 0 ? { customAttributesEntities } : {},
-				...disabledDefaultTemplateHandler ? { disabledDefaultTemplateHandler } : {},
-				...enableComponentLocalStyle ? { enableComponentLocalStyle } : {},
-				...enablePageLocalStyle ? { enablePageLocalStyle } : {}
-			}));
-			return transformUVue(code, id, jsHandler, currentRuntimeSet);
+			if (customAttributesEntities.length > 0 || disabledDefaultTemplateHandler || enableComponentLocalStyle || enablePageLocalStyle) {
+				const result = transformUVue(code, id, jsHandler, currentRuntimeSet, omitUndefined({
+					...customAttributesEntities.length > 0 ? { customAttributesEntities } : {},
+					...disabledDefaultTemplateHandler ? { disabledDefaultTemplateHandler } : {},
+					...enableComponentLocalStyle ? { enableComponentLocalStyle } : {},
+					...enablePageLocalStyle ? { enablePageLocalStyle } : {}
+				}));
+				if (result?.code) rememberHarmonyApplySource(result.code, id);
+				return result;
+			}
+			const result = transformUVue(code, id, jsHandler, currentRuntimeSet);
+			if (result?.code) rememberHarmonyApplySource(result.code, id);
+			return result;
 		},
 		async handleHotUpdate(ctx) {
 			if (!isEnabled()) return;
@@ -3640,7 +3860,7 @@ function createUniAppXPlugins(options) {
 				const getAssetSource = createUniAppXBundleAssetSourceGetter(bundle);
 				if (isHarmonyTarget) {
 					const cssSources = [];
-					const applyStyleSources = [...harmonyApplyStyleSources, ...collectUniAppXHarmonyApplyStyleSources(bundle)];
+					const applyStyleSources = harmonyApplyStyleSources.size > 0 ? [...harmonyApplyStyleSources] : collectUniAppXHarmonyApplyStyleSources(bundle);
 					const applyUtilities = /* @__PURE__ */ new Set([...harmonyApplyUtilities, ...collectUniAppXHarmonyApplyUtilities(bundle)]);
 					if (applyStyleSources.length > 0 && applyUtilities.size > 0) {
 						const harmonyApplyCssFile = path.resolve(getResolvedConfig()?.root ?? process$1.cwd(), "uni-app-x-harmony-apply.css");
@@ -3918,17 +4138,25 @@ function collectRememberedCssReplayGroups(sources, opts, rootDir, isWebGenerator
 }
 //#endregion
 //#region src/bundlers/vite/generate-bundle/remembered-css-replay.ts
+function shouldSkipRawRememberedCssSource(rawSource, sourceFile) {
+	const cleanSourceFile = sourceFile.replace(/[?#].*$/, "");
+	return SOURCE_STYLE_OUTPUT_EXT_RE.test(cleanSourceFile) && !canProcessViteSourceStyleAsCss(rawSource, sourceFile);
+}
 async function processRememberedCssReplay(options) {
-	const { addWatchFile, activeViteCssCacheFiles, bundleFiles, cache, changedCssFiles = /* @__PURE__ */ new Set(), createScopedGeneratorRuntime, createScopedSourceCandidateGetter, createScopedSourceCandidateSourceGetter, cssTaskFactories, debug, defaultStyleOutputExtension, emitOrReplayCssAsset, generatorRuntime, generatorPlatform, getCssHandlerOptions, getCssUserHandlerOptions, getRememberedCssSignature, getRememberedCssSources, isNativeAppStyleTarget, isWebGeneratorTarget, lastCssRawSourceHashByFile = /* @__PURE__ */ new Map(), lastCssResultByFile, lastCssSourceHashByFile, markCssAssetProcessed, metrics, normalizeViteCssCacheKey, onUpdate, opts, recordCssAssetResult, recordViteProcessedCssAssetResult, refreshRememberedCssSource, rootDir, runtimeState, setRememberedCssSignature, shouldInjectCssIntoMainFromOutput, shouldPreserveAppCssExtension, sourceRoot, styleHandler, timeTask, useIncrementalMode } = options;
+	const { addWatchFile, activeViteCssCacheFiles, bundleFiles, cache, changedCssFiles = /* @__PURE__ */ new Set(), createScopedGeneratorRuntime, createScopedSourceCandidateGetter, createScopedSourceCandidateSourceGetter, cssTaskFactories, cssPipelineContext, cssPipelineStrategy, debug, defaultStyleOutputExtension, emitOrReplayCssAsset, generatorRuntime, generatorPlatform, getCssHandlerOptions, getCssUserHandlerOptions, getRememberedCssSignature, getRememberedCssSources, isNativeAppStyleTarget, isWebGeneratorTarget, lastCssRawSourceHashByFile = /* @__PURE__ */ new Map(), lastCssResultByFile, lastCssSourceHashByFile, markCssAssetProcessed, metrics, normalizeViteCssCacheKey, onUpdate, opts, recordCssAssetResult, recordViteProcessedCssAssetResult, refreshRememberedCssSource, rootDir, runtimeState, setRememberedCssSignature, shouldInjectCssIntoMainFromOutput, shouldPreserveAppCssExtension, sourceRoot, styleHandler, timeTask, useIncrementalMode } = options;
 	const rememberedReplayGroups = collectRememberedCssReplayGroups(getRememberedCssSources?.(), opts, rootDir, isWebGeneratorTarget, shouldPreserveAppCssExtension, sourceRoot, defaultStyleOutputExtension, bundleFiles);
 	for (const [outputFile, rememberedGroup] of rememberedReplayGroups) {
 		if (isHTMLRequest(outputFile) || options.opts.htmlMatcher(outputFile)) continue;
-		const refreshedRememberedGroup = await Promise.all(rememberedGroup.map(async (item) => ({
+		const replayableRememberedGroup = (await Promise.all(rememberedGroup.map(async (item) => ({
 			key: item.key,
 			remembered: await refreshRememberedCssSource?.(item.remembered) ?? item.remembered
-		})));
-		const rememberedKeys = refreshedRememberedGroup.map((item) => item.key);
-		const rememberedCssSource = mergeRememberedCssSources(refreshedRememberedGroup.map((item) => item.remembered), outputFile);
+		})))).filter(({ remembered }) => {
+			const shouldSkip = shouldSkipRawRememberedCssSource(remembered.rawSource, remembered.sourceFile);
+			if (shouldSkip) debug("css replay skip raw source style: %s -> %s", remembered.sourceFile, outputFile);
+			return !shouldSkip;
+		});
+		const rememberedKeys = replayableRememberedGroup.map((item) => item.key);
+		const rememberedCssSource = mergeRememberedCssSources(replayableRememberedGroup.map((item) => item.remembered), outputFile);
 		if (!rememberedCssSource) continue;
 		const { rawSource, sourceFile } = rememberedCssSource;
 		const generatorRawSource = isWebGeneratorTarget ? rawSource : normalizeMiniProgramGeneratorCssSource(rawSource, outputFile);
@@ -3963,7 +4191,17 @@ async function processRememberedCssReplay(options) {
 		const shouldRecordRememberedReplayCss = useIncrementalMode || isNativeAppStyleTarget;
 		const shouldEmitRememberedReplayCssAsset = shouldRecordRememberedReplayCss;
 		if (!shouldRecordRememberedReplayCss) continue;
-		if (!isWebGeneratorTarget && isPureLocalCssImportWrapper(rawSource)) {
+		if (shouldPreserveFrameworkRootMiniProgramImportShell({
+			css: rawSource,
+			file: outputFile,
+			isWebGeneratorTarget,
+			matchesCss: opts.cssMatcher(outputFile),
+			shouldKeep: () => cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+				...cssPipelineContext,
+				css: rawSource,
+				file: outputFile
+			})
+		}) || !isRootMiniProgramStyleOutputFile$1(outputFile) && !isWebGeneratorTarget && isPureLocalCssImportWrapper(rawSource)) {
 			cssTaskFactories.push(() => timeTask("css.replay", async () => {
 				const start = performance.now();
 				const css = annotateCss(normalizeMiniProgramImportShell(rawSource));
@@ -4223,13 +4461,12 @@ function createSubpackageSourceCandidateScope(options) {
 function normalizeSourceCandidatePathKey(file) {
 	return normalizeOutputPathKey(path.resolve(file));
 }
-function resolveCurrentSourceCandidateSource(options) {
-	const { file, getSourceCandidateSource, getSourceCandidateSources, outDir, rootDir, sourceRoot } = options;
+function createSourceCandidateFiles(options) {
+	const { file, outDir, rootDir, sourceRoot } = options;
 	const cleanedFile = file.replace(/[?#].*$/, "");
-	const normalizedFile = normalizeOutputPathKey(cleanedFile);
 	const absoluteFile = path.isAbsolute(cleanedFile) ? cleanedFile : path.resolve(rootDir, cleanedFile);
 	const relativeFromOutDir = normalizeOutputPathKey(path.relative(outDir, absoluteFile));
-	const sourceCandidates = [
+	return [
 		sourceRoot ? path.resolve(sourceRoot, file) : void 0,
 		path.resolve(rootDir, file),
 		path.resolve(path.dirname(outDir), file),
@@ -4238,6 +4475,33 @@ function resolveCurrentSourceCandidateSource(options) {
 		!path.isAbsolute(relativeFromOutDir) && !relativeFromOutDir.startsWith("../") ? path.resolve(path.dirname(outDir), relativeFromOutDir) : void 0,
 		file
 	];
+}
+function resolveCurrentSourceCandidateFile(options) {
+	const sourceCandidates = createSourceCandidateFiles(options);
+	for (const candidate of sourceCandidates) if (candidate && options.getSourceCandidateSource?.(candidate) !== void 0) return candidate;
+	const normalizedFile = normalizeOutputPathKey(options.file.replace(/[?#].*$/, ""));
+	let bestMatch;
+	const normalizedSourceCandidates = sourceCandidates.filter((candidate) => Boolean(candidate)).map((candidate) => ({
+		absolute: path.isAbsolute(candidate),
+		key: normalizeSourceCandidatePathKey(candidate)
+	}));
+	for (const [sourceFile] of options.getSourceCandidateSources?.() ?? []) {
+		const normalizedSourceFile = normalizeSourceCandidatePathKey(sourceFile);
+		let score = normalizedSourceCandidates.reduce((current, candidate) => {
+			return normalizedSourceFile === candidate.key ? Math.max(current, candidate.absolute ? 100 : 80) : current;
+		}, 0);
+		if (normalizedSourceFile.endsWith(`/${normalizedFile}`)) score = Math.max(score, 20);
+		if (score > (bestMatch?.score ?? 0)) bestMatch = {
+			file: sourceFile,
+			score
+		};
+	}
+	return bestMatch?.file;
+}
+function resolveCurrentSourceCandidateSource(options) {
+	const { file, getSourceCandidateSource, getSourceCandidateSources } = options;
+	const normalizedFile = normalizeOutputPathKey(file.replace(/[?#].*$/, ""));
+	const sourceCandidates = createSourceCandidateFiles(options);
 	const explicitSource = sourceCandidates.reduce((source, candidate) => {
 		if (source || !candidate) return source;
 		return getSourceCandidateSource?.(candidate);
@@ -4496,102 +4760,6 @@ function createBundleTaskTimer(recordTimingDetail) {
 	};
 }
 //#endregion
-//#region src/bundlers/vite/generate-bundle/transform-filter.ts
-function toArray(value) {
-	return Array.isArray(value) ? value : value === void 0 ? [] : [value];
-}
-function normalizeSourceId(id) {
-	const file = cleanUrl(id);
-	return path.isAbsolute(file) ? path.resolve(file) : void 0;
-}
-function collectChunkModuleIds$1(chunk) {
-	const ids = /* @__PURE__ */ new Set();
-	for (const id of chunk.moduleIds ?? []) {
-		const normalized = normalizeSourceId(id);
-		if (normalized) ids.add(normalized);
-	}
-	for (const id of Object.keys(chunk.modules ?? {})) {
-		const normalized = normalizeSourceId(id);
-		if (normalized) ids.add(normalized);
-	}
-	return ids;
-}
-function collectAssetSourceIds(asset, fallbackFile, rootDir) {
-	const ids = /* @__PURE__ */ new Set();
-	const sourceCandidates = [asset.originalFileName, ...asset.originalFileNames ?? []].filter((candidate) => typeof candidate === "string" && candidate.length > 0);
-	const candidates = sourceCandidates.length > 0 ? sourceCandidates : [fallbackFile];
-	for (const candidate of candidates) {
-		if (typeof candidate !== "string" || candidate.length === 0) continue;
-		const cleanCandidate = cleanUrl(candidate);
-		const resolved = path.isAbsolute(cleanCandidate) ? path.resolve(cleanCandidate) : path.resolve(rootDir, cleanCandidate);
-		ids.add(resolved);
-	}
-	return ids;
-}
-function isStringRuleMatched(rule, id, rootDir) {
-	const normalizedId = slash(id);
-	const normalizedRule = slash(rule);
-	if (path.isAbsolute(rule)) return micromatch.isMatch(normalizedId, normalizedRule);
-	const relative = slash(path.relative(rootDir, id));
-	return relative.length > 0 && !relative.startsWith("../") && !path.isAbsolute(relative) && micromatch.isMatch(relative, normalizedRule);
-}
-function isRuleMatched(rule, id, rootDir) {
-	if (typeof rule === "string") return isStringRuleMatched(rule, id, rootDir);
-	if (rule instanceof RegExp) {
-		rule.lastIndex = 0;
-		return rule.test(slash(id));
-	}
-	return rule(id) === true;
-}
-function createTransformMatcher(rules, rootDir) {
-	const normalizedRules = toArray(rules);
-	if (normalizedRules.length === 0) return;
-	return (id) => normalizedRules.some((rule) => isRuleMatched(rule, id, rootDir));
-}
-function shouldSkipSourceIds(sourceIds, filter) {
-	if (sourceIds.size === 0) return false;
-	if (filter.exclude) {
-		let excluded = true;
-		for (const id of sourceIds) if (!filter.exclude(id)) {
-			excluded = false;
-			break;
-		}
-		if (excluded) return true;
-	}
-	if (filter.include) {
-		for (const id of sourceIds) if (filter.include(id)) return false;
-		return true;
-	}
-	return false;
-}
-function createTransformFilter(options, rootDir) {
-	const include = createTransformMatcher(options?.include, rootDir);
-	const exclude = createTransformMatcher(options?.exclude, rootDir);
-	if (!include && !exclude) return;
-	return {
-		include,
-		exclude
-	};
-}
-function shouldSkipViteJsChunkTransform(chunk, filter) {
-	if (!filter) return false;
-	return shouldSkipSourceIds(collectChunkModuleIds$1(chunk), filter);
-}
-function shouldSkipViteAssetTransform(asset, file, rootDir, filter) {
-	if (!filter) return false;
-	return shouldSkipSourceIds(collectAssetSourceIds(asset, file, rootDir), filter);
-}
-function createRuleSignature(rules) {
-	return toArray(rules).map((rule) => {
-		if (typeof rule === "string") return `s:${rule}`;
-		if (rule instanceof RegExp) return `r:${rule.source}/${rule.flags}`;
-		return "f";
-	}).join("|") || "none";
-}
-function createTransformFilterSignature(options) {
-	return [`include:${createRuleSignature(options?.include)}`, `exclude:${createRuleSignature(options?.exclude)}`].join(";");
-}
-//#endregion
 //#region src/bundlers/vite/weapp-vite-config.ts
 function resolveSourceRootCandidate(root, value) {
 	if (typeof value !== "string" || value.trim().length === 0) return;
@@ -4674,6 +4842,7 @@ function createGenerateBundleHook(context) {
 	const lastCssResultByFile = /* @__PURE__ */ new Map();
 	const lastCssSourceHashByFile = /* @__PURE__ */ new Map();
 	const lastCssRawSourceHashByFile = /* @__PURE__ */ new Map();
+	const frameworkRootImportShellTargetByFile = context.frameworkRootImportShellTargetByFile ?? /* @__PURE__ */ new Map();
 	let currentOutDir;
 	let currentSubpackageRoots;
 	const createInitialCssPipelineContext = (file) => {
@@ -4711,8 +4880,11 @@ function createGenerateBundleHook(context) {
 		})
 	});
 	return async function generateBundle(_opt, bundle) {
+		if (context.shouldProcessBundle?.() === false) return;
+		const processMarkupAndScripts = context.processMarkupAndScripts !== false;
+		const processStyles = context.shouldProcessStyles?.() ?? context.processStyles !== false;
 		const addWatchFile = (id) => this.addWatchFile?.(id);
-		const { opts, runtimeState, ensureBundleRuntimeClassSet, debug, getResolvedConfig, markCssAssetProcessed, isCssAssetProcessed, isViteProcessedCssAsset, recordCssAssetResult, recordViteProcessedCssAssetResult, getViteProcessedCssAssetResults, getViteProcessedCssAssetResult, getSourceCandidates, getSourceCandidateSource, getSourceCandidateSources, getSourceCandidatesForEntries, getSourceCandidateSourcesForEntries, waitForSourceCandidateSyncs, rememberCssSource, refreshRememberedCssSource, getRememberedCssSources, getRememberedCssSignature, setRememberedCssSignature, getKnownCssSource, getKnownSfcSource, recordGeneratorCandidates, pruneViteCssCaches, getViteCssCacheStats, hmrTimingRecorder } = context;
+		const { opts, runtimeState, ensureBundleRuntimeClassSet, debug, getResolvedConfig, markCssAssetProcessed, isCssAssetProcessed, isViteProcessedCssAsset, recordCssAssetResult, recordViteProcessedCssAssetResult, getViteProcessedCssAssetResults, getViteProcessedCssAssetResult, getSourceCandidates, getSourceCandidateSource, getSourceCandidateSources, extractSourceCandidates, getSourceCandidatesForEntries, getSourceCandidateSourcesForEntries, waitForSourceCandidateSyncs, rememberCssSource, refreshRememberedCssSource, getRememberedCssSources, getRememberedCssSignature, setRememberedCssSignature, getKnownCssSource, getKnownSfcSource, getOriginalCssLayerSource, recordGeneratorCandidates, pruneViteCssCaches, getViteCssCacheStats, hmrTimingRecorder } = context;
 		const getBundlerSfcSource = (sourceFile) => {
 			const code = this.getModuleInfo?.(sourceFile)?.code;
 			return typeof code === "string" && hasSfcStyleSources(code) ? code : void 0;
@@ -4797,16 +4969,38 @@ function createGenerateBundleHook(context) {
 		const envFlags = resolveGenerateBundleEnvFlags();
 		const bundleFiles = Object.keys(bundle);
 		const activeViteCssCacheFiles = new Set(bundleFiles.map(normalizeViteCssCacheKey));
-		const getConfiguredTailwindV4CssSourceEntries = () => collectConfiguredTailwindV4CssSourceEntries({
-			...opts,
-			tailwindcssRuntimeOptions: {
-				...opts.tailwindcssRuntimeOptions ?? {},
-				tailwindcss: {
-					...resolveTailwindcssOptions(opts.tailwindcssRuntimeOptions) ?? {},
-					...resolveTailwindcssOptions(runtimeState.tailwindRuntime.options) ?? {}
+		const normalizeSystemAliasPathKey = (file) => file.startsWith("/private/var/") ? file.slice(8) : file;
+		const normalizeConfiguredCssSourceCacheKey = (file) => normalizeSystemAliasPathKey(normalizeOutputPathKey(path.resolve(file.replace(/[?#].*$/, ""))));
+		const runtimeTailwindcssOptions = resolveTailwindcssOptions(opts.tailwindcssRuntimeOptions);
+		const tailwindRuntimeOptions = resolveTailwindcssOptions(runtimeState.tailwindRuntime.options);
+		const configuredTailwindV4ExplicitCssEntryFiles = [...new Set([
+			...Array.isArray(opts.cssEntries) ? opts.cssEntries : [],
+			...Array.isArray(opts.tailwindcss?.v4?.cssEntries) ? opts.tailwindcss.v4.cssEntries : [],
+			...Array.isArray(runtimeTailwindcssOptions?.v4?.cssEntries) ? runtimeTailwindcssOptions.v4.cssEntries : [],
+			...Array.isArray(tailwindRuntimeOptions?.v4?.cssEntries) ? tailwindRuntimeOptions.v4.cssEntries : []
+		].filter((file) => typeof file === "string" && file.length > 0))];
+		const getConfiguredTailwindV4CssSourceEntries = () => {
+			const collectedEntries = collectConfiguredTailwindV4CssSourceEntries({
+				...opts,
+				tailwindcssRuntimeOptions: {
+					...opts.tailwindcssRuntimeOptions ?? {},
+					tailwindcss: {
+						...resolveTailwindcssOptions(opts.tailwindcssRuntimeOptions) ?? {},
+						...resolveTailwindcssOptions(runtimeState.tailwindRuntime.options) ?? {}
+					}
 				}
-			}
-		}, opts.tailwindcssBasedir ?? rootDir);
+			}, opts.tailwindcssBasedir ?? rootDir);
+			const cachedEntries = configuredTailwindV4ExplicitCssEntryFiles.flatMap((file) => {
+				const resolvedFile = path.isAbsolute(file) ? path.resolve(file) : path.resolve(opts.tailwindcssBasedir ?? rootDir, file);
+				const source = getCssSource(resolvedFile);
+				return typeof source === "string" && source.length > 0 ? [{
+					file: resolvedFile,
+					source
+				}] : [];
+			});
+			const cachedFileKeys = new Set(cachedEntries.map((entry) => normalizeConfiguredCssSourceCacheKey(entry.file)));
+			return [...cachedEntries, ...collectedEntries.filter((entry) => !cachedFileKeys.has(normalizeConfiguredCssSourceCacheKey(entry.file)))];
+		};
 		const normalizeGeneratorUserRawSource = (source, sourceFile, fallbackFile) => normalizeRelativeCssConfigDirectives(source, sourceFile || fallbackFile, outDir, opts);
 		const resolveMatchedCssSourceOutputFile = (sourceFile) => resolveOutputFileFromMatchedCssSource({
 			bundleFiles,
@@ -4827,20 +5021,12 @@ function createGenerateBundleHook(context) {
 		const snapshotStart = performance.now();
 		const snapshot = buildBundleSnapshot(bundle, opts, outDir, state, envFlags.disableDirtyOptimization || !useIncrementalMode, { hasOmittedKnownFiles });
 		const configuredTailwindV4CssSourceEntriesForScope = getConfiguredTailwindV4CssSourceEntries();
-		const normalizeSystemAliasPathKey = (file) => file.startsWith("/private/var/") ? file.slice(8) : file;
 		const normalizeConfiguredTailwindV4CssEntryFileKey = (file) => {
 			const cleanFile = file.replace(/[?#].*$/, "");
 			return normalizeSystemAliasPathKey(normalizeOutputPathKey(path.isAbsolute(cleanFile) ? path.resolve(cleanFile) : path.resolve(opts.tailwindcssBasedir ?? rootDir, cleanFile)));
 		};
-		const runtimeTailwindcssOptions = resolveTailwindcssOptions(opts.tailwindcssRuntimeOptions);
-		const tailwindRuntimeOptions = resolveTailwindcssOptions(runtimeState.tailwindRuntime.options);
 		const configuredTailwindV4CssSourceFileKeysForScope = new Set(configuredTailwindV4CssSourceEntriesForScope.map((entry) => normalizeConfiguredTailwindV4CssEntryFileKey(entry.file)));
-		const configuredTailwindV4ExplicitCssEntryFileKeysForScope = new Set([
-			...Array.isArray(opts.cssEntries) ? opts.cssEntries : [],
-			...Array.isArray(opts.tailwindcss?.v4?.cssEntries) ? opts.tailwindcss.v4.cssEntries : [],
-			...Array.isArray(runtimeTailwindcssOptions?.v4?.cssEntries) ? runtimeTailwindcssOptions.v4.cssEntries : [],
-			...Array.isArray(tailwindRuntimeOptions?.v4?.cssEntries) ? tailwindRuntimeOptions.v4.cssEntries : []
-		].filter((file) => typeof file === "string" && file.length > 0).map(normalizeConfiguredTailwindV4CssEntryFileKey));
+		const configuredTailwindV4ExplicitCssEntryFileKeysForScope = new Set(configuredTailwindV4ExplicitCssEntryFiles.map(normalizeConfiguredTailwindV4CssEntryFileKey));
 		const isRootStyleOutputFile = (file) => {
 			const normalized = normalizeOutputPathKey(file.replace(/[?#].*$/, ""));
 			return normalized.endsWith(".css") && !normalized.includes("/");
@@ -4870,9 +5056,11 @@ function createGenerateBundleHook(context) {
 		const selectConfiguredRootCssSourceEntry = (outputFile, entries, originalFileNames) => {
 			const matchedOriginalEntry = entries.find((entry) => originalFileNames?.some((originalFile) => normalizeConfiguredTailwindV4CssEntryFileKey(originalFile) === normalizeConfiguredTailwindV4CssEntryFileKey(entry.file)) === true);
 			if (matchedOriginalEntry && outputFile.replace(/[?#].*$/, "").endsWith(".css")) return matchedOriginalEntry;
-			if (!shouldSelectConfiguredRootCssOutput(outputFile)) return;
 			const shouldRequireExplicitConfiguredEntry = !cssPipelineContext.currentGeneratorBranch.isWeb && opts.cssMatcher(outputFile) && isRootStyleOutputFile(outputFile);
 			const generationEntries = entries.filter((entry) => hasTailwindGenerationSource(entry.source) && (!shouldRequireExplicitConfiguredEntry || configuredTailwindV4ExplicitCssEntryFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(entry.file))));
+			const matchedOutputEntries = generationEntries.filter((entry) => normalizeOutputPathKey(resolveConfiguredTailwindV4CssEntryOutputFile(entry.file).replace(/[?#].*$/, "")) === normalizeOutputPathKey(outputFile.replace(/[?#].*$/, "")));
+			if (matchedOutputEntries.length === 1) return matchedOutputEntries[0];
+			if (!shouldSelectConfiguredRootCssOutput(outputFile)) return;
 			if (generationEntries.length <= 1) return generationEntries[0];
 			const rootOutputEntries = generationEntries.filter((entry) => {
 				return !normalizeOutputPathKey(resolveConfiguredTailwindV4CssEntryOutputFile(entry.file).replace(/[?#].*$/, "")).includes("/");
@@ -4914,18 +5102,6 @@ function createGenerateBundleHook(context) {
 				return !normalizeOutputPathKey(entryOutputFile.replace(/[?#].*$/, "")).includes("/") || currentSubpackageRoots != null && !isSubpackageOutputFile(entryOutputFile, currentSubpackageRoots);
 			});
 		};
-		const { createScopedSourceCandidateGetter, createScopedSourceCandidateSourceGetter, shouldExcludeSubpackageSourceCandidates, shouldInjectCssIntoMainFromOutput } = createSubpackageSourceCandidateScope({
-			cssSourceFiles: configuredTailwindV4CssSourceEntriesForScope.map((entry) => entry.file),
-			getSourceCandidateSourcesForEntries,
-			getSourceCandidatesForEntries,
-			projectRoot: opts.tailwindcssRuntimeOptions?.projectRoot,
-			rootDir,
-			snapshot,
-			sourceRoot,
-			subpackageRoots: currentSubpackageRoots,
-			tailwindcssBasedir: opts.tailwindcssBasedir,
-			useIncrementalMode
-		});
 		recordTimingDetail("snapshot", snapshotStart);
 		const useBundleRuntimeClassSet = !isWebGeneratorTarget;
 		const forceRuntimeRefreshBySource = useIncrementalMode && hasRuntimeAffectingSourceChanges(snapshot.runtimeAffectingChangedByType);
@@ -4939,11 +5115,41 @@ function createGenerateBundleHook(context) {
 		const sourceCandidateWaitStart = performance.now();
 		await waitForSourceCandidateSyncs?.();
 		recordTimingDetail("sourceCandidates.wait", sourceCandidateWaitStart);
-		const sourceCandidates = getSourceCandidates?.() ?? /* @__PURE__ */ new Set();
+		const transformFilter = createTransformFilter(opts.transform, rootDir);
+		const bundleMarkupCandidates = await collectBundleMarkupCandidates({
+			extractSourceCandidates: processMarkupAndScripts && !isWebGeneratorTarget ? extractSourceCandidates : void 0,
+			previousCandidatesByFile: useIncrementalMode ? state.bundleMarkupCandidatesByFile : void 0,
+			preserveMissingFiles: useIncrementalMode && snapshot.hasOmittedKnownFiles,
+			resolveSourceCandidateFile: (file) => resolveCurrentSourceCandidateFile({
+				file,
+				getSourceCandidateSource,
+				getSourceCandidateSources,
+				outDir,
+				rootDir,
+				sourceRoot
+			}),
+			rootDir,
+			snapshot,
+			transformFilter
+		});
+		const getCombinedSourceCandidatesForEntries = getSourceCandidatesForEntries || bundleMarkupCandidates.values.size > 0 ? (entries, options) => /* @__PURE__ */ new Set([...getSourceCandidatesForEntries?.(entries, options) ?? [], ...bundleMarkupCandidates.valuesForEntries(entries, options)]) : void 0;
+		const sourceCandidates = /* @__PURE__ */ new Set([...getSourceCandidates?.() ?? [], ...bundleMarkupCandidates.values]);
+		const { createScopedSourceCandidateGetter, createScopedSourceCandidateSourceGetter, shouldExcludeSubpackageSourceCandidates, shouldInjectCssIntoMainFromOutput } = createSubpackageSourceCandidateScope({
+			cssSourceFiles: configuredTailwindV4CssSourceEntriesForScope.map((entry) => entry.file),
+			getSourceCandidateSourcesForEntries,
+			getSourceCandidatesForEntries: getCombinedSourceCandidatesForEntries,
+			projectRoot: opts.tailwindcssRuntimeOptions?.projectRoot,
+			rootDir,
+			snapshot,
+			sourceRoot,
+			subpackageRoots: currentSubpackageRoots,
+			tailwindcssBasedir: opts.tailwindcssBasedir,
+			useIncrementalMode
+		});
 		const createScopedGeneratorRuntime$1 = (outputFile, cssHandlerOptions, runtime, rawSource, sourceFile) => createScopedGeneratorRuntime({
 			cssHandlerOptions,
 			fallbackRuntime: runtime,
-			getSourceCandidatesForEntries,
+			getSourceCandidatesForEntries: getCombinedSourceCandidatesForEntries,
 			majorVersion: runtimeState.tailwindRuntime.majorVersion,
 			outputFile,
 			rawSource,
@@ -4953,7 +5159,6 @@ function createGenerateBundleHook(context) {
 		});
 		const jsEntries = snapshot.jsEntries;
 		const getJsEntry = createJsEntryResolver(jsEntries);
-		const transformFilter = createTransformFilter(opts.transform, rootDir);
 		const transformFilterSignature = createTransformFilterSignature(opts.transform);
 		const moduleGraphOptions = createBundleModuleGraphOptions(outDir, jsEntries);
 		const hasRuntimeAffectingChanges = hasRuntimeAffectingSourceChanges(snapshot.runtimeAffectingChangedByType);
@@ -5103,7 +5308,7 @@ function createGenerateBundleHook(context) {
 		const jsTaskFactories = [];
 		for (const entry of snapshot.entries) {
 			const { file, output: originalSource, source: originalEntrySource, type } = entry;
-			if (type === "html" && originalSource.type === "asset") {
+			if (processMarkupAndScripts && type === "html" && originalSource.type === "asset") {
 				metrics.html.total++;
 				if (isWebGeneratorTarget) {
 					debug("html skip web target: %s", file);
@@ -5142,14 +5347,59 @@ function createGenerateBundleHook(context) {
 				});
 				continue;
 			}
-			if (type === "css" && originalSource.type === "asset") {
+			if (processStyles && type === "css" && originalSource.type === "asset") {
 				metrics.css.total++;
 				const assetSourceFile = resolveAssetSourceFile(originalSource, file);
 				const rawSource = normalizeRelativeCssConfigDirectives(originalEntrySource, assetSourceFile, outDir, opts);
+				const currentRawSourceHasExplicitScanContext = rawSource.includes("@source") || rawSource.includes("@config");
 				const cssPipelineContext = {
 					...createInitialCssPipelineContext(file),
 					bundle
 				};
+				const rootImportShellOutputFile = resolveReplayCssOutputFile(outDir, originalSource.fileName || file);
+				let rememberedFrameworkRootImportTarget = frameworkRootImportShellTargetByFile.get(rootImportShellOutputFile);
+				const isCurrentFrameworkRootImportShell = shouldPreserveFrameworkRootMiniProgramImportShell({
+					css: rawSource,
+					file: rootImportShellOutputFile,
+					isWebGeneratorTarget,
+					matchesCss: opts.cssMatcher(rootImportShellOutputFile) || opts.cssMatcher(file),
+					shouldKeep: () => context.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+						...cssPipelineContext,
+						css: rawSource,
+						file: rootImportShellOutputFile
+					})
+				});
+				if (isCurrentFrameworkRootImportShell) {
+					const importedFile = resolveSingleCssImportOutputFile(rootImportShellOutputFile, rawSource);
+					if (importedFile && isRootMiniProgramStyleOutputFile$1(importedFile)) frameworkRootImportShellTargetByFile.set(rootImportShellOutputFile, importedFile);
+				}
+				if (!rememberedFrameworkRootImportTarget && !isCurrentFrameworkRootImportShell && !isWebGeneratorTarget && isRootMiniProgramStyleOutputFile$1(rootImportShellOutputFile) && normalizeOutputPathKey(assetSourceFile) === normalizeOutputPathKey(file) && opts.mainCssChunkMatcher(rootImportShellOutputFile, opts.appType) && shouldKeepRootMiniProgramStyleAsImportShell(context.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+					...cssPipelineContext,
+					css: rawSource,
+					file: rootImportShellOutputFile
+				})) && !shouldMoveRootMiniProgramStyleToImportShellOrigin(context.cssPipelineStrategy?.shouldMoveRootMiniProgramStyleToImportShellOrigin?.({
+					...cssPipelineContext,
+					file: rootImportShellOutputFile
+				}))) {
+					const rootGeneratedTargets = /* @__PURE__ */ new Set();
+					for (const entry of getConfiguredTailwindV4CssSourceEntries()) {
+						const targetFile = resolveMatchedCssSourceOutputFile(entry.file);
+						if (targetFile && isRootMiniProgramStyleOutputFile$1(targetFile) && normalizeOutputPathKey(targetFile) !== normalizeOutputPathKey(rootImportShellOutputFile)) rootGeneratedTargets.add(targetFile);
+					}
+					for (const [, record] of getViteProcessedCssAssetResults?.() ?? []) {
+						if (typeof record === "string" || record.injectIntoMain !== true || !record.outputFile) continue;
+						const targetFile = resolveViteCssPipelineOutputFile(record.outputFile, opts, rootDir, isWebGeneratorTarget, shouldPreserveAppCssExtension, sourceRoot, defaultStyleOutputExtension, bundleFiles);
+						if (isRootMiniProgramStyleOutputFile$1(targetFile) && normalizeOutputPathKey(targetFile) !== normalizeOutputPathKey(rootImportShellOutputFile)) rootGeneratedTargets.add(targetFile);
+					}
+					if (rootGeneratedTargets.size === 1) {
+						const [targetFile] = rootGeneratedTargets;
+						if (targetFile) {
+							rememberedFrameworkRootImportTarget = targetFile;
+							frameworkRootImportShellTargetByFile.set(rootImportShellOutputFile, targetFile);
+							debug("css remember framework root generated target: %s -> %s", rootImportShellOutputFile, targetFile);
+						}
+					}
+				}
 				let outputFile = resolveCssBundleOutputFile({
 					bundleFiles,
 					cssPipelineStrategy: context.cssPipelineStrategy,
@@ -5160,6 +5410,14 @@ function createGenerateBundleHook(context) {
 					pipelineContext: cssPipelineContext,
 					shouldPreserveAppCssExtension
 				});
+				if (rememberedFrameworkRootImportTarget && !isWebGeneratorTarget && (opts.cssMatcher(rootImportShellOutputFile) || opts.cssMatcher(file)) && shouldKeepRootMiniProgramStyleAsImportShell(context.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+					...cssPipelineContext,
+					css: rawSource,
+					file: rootImportShellOutputFile
+				}))) {
+					outputFile = rememberedFrameworkRootImportTarget;
+					debug("css reuse framework root import shell target: %s -> %s", rootImportShellOutputFile, outputFile);
+				}
 				const resolveMatchedOutputFileForCurrentAsset = createMatchedCssSourceOutputResolver({
 					assetSourceFile,
 					file,
@@ -5218,6 +5476,7 @@ function createGenerateBundleHook(context) {
 					return await refreshRememberedCssSource?.(remembered) ?? remembered;
 				}));
 				rememberedCssSources = rememberedCssSources.filter((remembered) => {
+					if (currentRawSourceHasExplicitScanContext && !remembered.rawSource.includes("@source") && !remembered.rawSource.includes("@config")) return false;
 					if (hasExplicitConfiguredRootCssEntryForOutput(outputFile) && !configuredTailwindV4ExplicitCssEntryFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(remembered.sourceFile))) return false;
 					if (!configuredTailwindV4CssSourceFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(remembered.sourceFile))) return true;
 					const matchedOutputFile = resolveMatchedOutputFileForCurrentAsset(remembered.sourceFile);
@@ -5237,7 +5496,7 @@ function createGenerateBundleHook(context) {
 				let outputCssHandlerOptions = getCssHandlerOptions(outputFile);
 				const configuredRootSourceStyle = resolveConfiguredRootCssSourceStyle(outputFile, getConfiguredTailwindV4CssSourceEntries(), originalSource.originalFileNames);
 				const hasExplicitRememberedRootSource = rememberedCssSources.some((remembered) => configuredTailwindV4ExplicitCssEntryFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(remembered.sourceFile)));
-				if (configuredRootSourceStyle && (!hasUsableRememberedTailwindSource || !hasExplicitRememberedRootSource)) {
+				if (configuredRootSourceStyle != null && (!currentRawSourceHasExplicitScanContext || hasTailwindGenerationSource(configuredRootSourceStyle.rawSource)) && (!hasUsableRememberedTailwindSource || !hasExplicitRememberedRootSource)) {
 					rememberedCssSources = [configuredRootSourceStyle];
 					hasUsableRememberedTailwindSource = true;
 					debug("source style source inferred from configured root tailwind v4 css source: %s -> %s", outputFile, configuredRootSourceStyle.sourceFile);
@@ -5352,6 +5611,12 @@ function createGenerateBundleHook(context) {
 						}
 					}
 				}
+				if (currentRawSourceHasExplicitScanContext) rememberedCssSources = rememberedCssSources.filter((remembered) => remembered.rawSource.includes("@source") || remembered.rawSource.includes("@config"));
+				rememberedCssSources = rememberedCssSources.filter((remembered) => {
+					const shouldSkip = shouldSkipRawRememberedCssSource(remembered.rawSource, remembered.sourceFile);
+					if (shouldSkip) debug("css skip raw remembered source style: %s -> %s", remembered.sourceFile, outputFile);
+					return !shouldSkip;
+				});
 				let rememberedCssSource = mergeRememberedCssSources(rememberedCssSources, outputFile);
 				if (rememberedCssSource && viteProcessedCssAsset && outputCssHandlerOptions.isMainChunk !== true && configuredTailwindV4CssSourceFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(rememberedCssSource.sourceFile))) {
 					const matchedOutputFile = resolveMatchedOutputFileForCurrentAsset(rememberedCssSource.sourceFile);
@@ -5365,6 +5630,17 @@ function createGenerateBundleHook(context) {
 						};
 					}
 				}
+				if (!isWebGeneratorTarget && isRootMiniProgramStyleOutputFile$1(rootImportShellOutputFile) && isRootMiniProgramStyleOutputFile$1(outputFile) && normalizeOutputPathKey(rootImportShellOutputFile) !== normalizeOutputPathKey(outputFile) && shouldKeepRootMiniProgramStyleAsImportShell(context.cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+					...cssPipelineContext,
+					css: rawSource,
+					file: rootImportShellOutputFile
+				})) && !shouldMoveRootMiniProgramStyleToImportShellOrigin(context.cssPipelineStrategy?.shouldMoveRootMiniProgramStyleToImportShellOrigin?.({
+					...cssPipelineContext,
+					file: rootImportShellOutputFile
+				}))) {
+					frameworkRootImportShellTargetByFile.set(rootImportShellOutputFile, outputFile);
+					debug("css remember framework root import shell target: %s -> %s", rootImportShellOutputFile, outputFile);
+				}
 				const shouldKeepImportedCssShell = isCssImportOnlyBundleAsset(bundle, file, rawSource);
 				const useRememberedCssSource = !shouldKeepImportedCssShell && rememberedCssSource != null && (normalizeOutputPathKey(rememberedCssSource.sourceFile) !== normalizeOutputPathKey(file) || !hasTailwindGenerationSource(rawSource) && hasTailwindGenerationSource(rememberedCssSource.rawSource));
 				const vitePipelineCssAsset = viteProcessedCssAsset || useRememberedCssSource;
@@ -5385,6 +5661,8 @@ function createGenerateBundleHook(context) {
 				const hasSameOutputRememberedTailwindGenerationSource = hasRememberedTailwindGenerationSource && rememberedCssSource != null && normalizeOutputPathKey(rememberedCssSource.outputFile) === normalizeOutputPathKey(outputFile);
 				const hasStaleViteProcessedCssSource = vitePipelineCssAsset && hasDifferentRememberedCssSource && (hasCurrentTailwindGenerationDirective || hasRememberedApplyDirective || hasRememberedTailwindGenerationSource);
 				const generatorSourceFile = vitePipelineCssAsset ? rememberedCssSource?.sourceFile ?? assetSourceFile : assetSourceFile;
+				const originalGeneratorLayerSource = vitePipelineCssAsset ? getOriginalCssLayerSource?.(generatorSourceFile) : void 0;
+				const generatorUserLayerRawSource = originalGeneratorLayerSource && normalizeCssSourceForCompare(originalGeneratorLayerSource) !== normalizeCssSourceForCompare(generatorRawSource) && hasUserCssLayerBlocks(originalGeneratorLayerSource) ? normalizeMiniProgramGeneratorRawSource(normalizeGeneratorUserRawSource(originalGeneratorLayerSource, generatorSourceFile, assetSourceFile), outputFile) : void 0;
 				const webviewRootCssInjectionTarget = vitePipelineCssAsset ? resolveConfiguredCssEntryRootInjectionTarget(generatorSourceFile, outputFile) : void 0;
 				const usesConfiguredTailwindV4FallbackSource = rememberedCssSource != null && normalizeOutputPathKey(rememberedCssSource.outputFile) === normalizeOutputPathKey(outputFile) && normalizeOutputPathKey(rememberedCssSource.sourceFile.replace(/[?#].*$/, "")) !== normalizeOutputPathKey(file);
 				if (vitePipelineCssAsset && outputCssHandlerOptions.isMainChunk !== true && configuredTailwindV4CssSourceFileKeysForScope.has(normalizeConfiguredTailwindV4CssEntryFileKey(generatorSourceFile))) {
@@ -5515,7 +5793,10 @@ function createGenerateBundleHook(context) {
 							const previousCss = !vitePipelineCssAsset && useIncrementalMode && !generatorCandidatesChanged && !hasRuntimeAffectingChanges && !snapshot.changedByType.css.has(file) ? getLastCssResult(lastCssResultByFile, outputFile, file) : void 0;
 							const generatorTransformRawSource = generatorRawSource;
 							const previousGeneratorCss = previousCss && !isWebGeneratorTarget ? normalizeMiniProgramGeneratorRawSource(previousCss, outputFile) : previousCss;
-							const generated = hasTailwindGenerationSource(generatorTransformRawSource) || hasBundlerGeneratedCssMarker(rawSource) ? await generateTailwindV4Css({
+							const shouldGenerateCssWithCore = hasTailwindGenerationSource(generatorTransformRawSource) || hasBundlerGeneratedCssMarker(rawSource);
+							const bundleUserRawSource = vitePipelineCssAsset && !hasBundlerGeneratedCssMarker(rawSource) && normalizeCssSourceForCompare(rawSource) !== normalizeCssSourceForCompare(generatorRawSource) ? normalizeMiniProgramGeneratorRawSource(normalizeGeneratorUserRawSource(rawSource, generatorSourceFile, assetSourceFile), outputFile) : void 0;
+							const generatorUserRawSource = [generatorUserLayerRawSource, bundleUserRawSource].filter((source) => typeof source === "string" && source.trim().length > 0).join("\n");
+							const generated = shouldGenerateCssWithCore ? await generateTailwindV4Css({
 								opts,
 								runtimeState,
 								runtime: scopedGeneratorRuntime,
@@ -5530,7 +5811,7 @@ function createGenerateBundleHook(context) {
 								styleHandler,
 								debug,
 								previousCss: previousGeneratorCss,
-								...vitePipelineCssAsset && !hasBundlerGeneratedCssMarker(rawSource) && normalizeCssSourceForCompare(rawSource) !== normalizeCssSourceForCompare(generatorRawSource) ? { userRawSource: normalizeMiniProgramGeneratorRawSource(normalizeGeneratorUserRawSource(rawSource, generatorSourceFile, assetSourceFile), outputFile) } : {},
+								...generatorUserRawSource ? { userRawSource: generatorUserRawSource } : {},
 								...usesConfiguredTailwindV4FallbackSource ? { restoreLocalCssImports: false } : {}
 							}) : void 0;
 							if (generated) {
@@ -5587,6 +5868,7 @@ function createGenerateBundleHook(context) {
 				continue;
 			}
 			if (type !== "js") continue;
+			if (!processMarkupAndScripts) continue;
 			if (!shouldTransformJsBundle) {
 				debug("js skip web target: %s", file);
 				continue;
@@ -5620,7 +5902,7 @@ function createGenerateBundleHook(context) {
 				useIncrementalMode
 			});
 		}
-		if (shouldProcessTailwindGeneration || useIncrementalMode || isNativeAppStyleTarget) await processRememberedCssReplay({
+		if (processStyles && (shouldProcessTailwindGeneration || useIncrementalMode || isNativeAppStyleTarget)) await processRememberedCssReplay({
 			addWatchFile,
 			activeViteCssCacheFiles,
 			bundle,
@@ -5628,6 +5910,8 @@ function createGenerateBundleHook(context) {
 			cache,
 			changedCssFiles: snapshot.changedByType.css,
 			cssTaskFactories,
+			cssPipelineContext,
+			cssPipelineStrategy: context.cssPipelineStrategy,
 			createScopedGeneratorRuntime: createScopedGeneratorRuntime$1,
 			createScopedSourceCandidateGetter,
 			createScopedSourceCandidateSourceGetter,
@@ -5680,7 +5964,7 @@ function createGenerateBundleHook(context) {
 			generatorRuntime,
 			getCssHandlerOptions,
 			getSourceCandidateSourcesForEntries,
-			getSourceCandidatesForEntries,
+			getSourceCandidatesForEntries: getCombinedSourceCandidatesForEntries,
 			getViteCssCacheStats,
 			getViteProcessedCssAssetResults,
 			hmrTimingRecorder,
@@ -5720,6 +6004,7 @@ function createGenerateBundleHook(context) {
 			transformWebTargetCss,
 			useIncrementalMode
 		});
+		state.bundleMarkupCandidatesByFile = bundleMarkupCandidates.candidatesByFile;
 	};
 }
 //#endregion
@@ -5792,7 +6077,7 @@ function createViteCssFinalizerOutputPlugin(context) {
 		generateBundle: {
 			order: "post",
 			async handler(_options, bundle) {
-				const { opts, runtimeState, ensureRuntimeClassSet, cssPipelineStrategy, isCssAssetProcessed, markCssAssetProcessed, debug, getResolvedConfig, recordCssAssetResult, recordViteProcessedCssAssetResult, getViteProcessedCssAssetResults, getRecordedGeneratorCandidates, getSourceCandidates, getSourceCandidatesForEntries, getSourceCandidateSourcesForEntries, waitForSourceCandidateSyncs, rememberMainCssSource, getRememberedMainCssSource, isViteProcessedCssAsset } = context;
+				const { opts, runtimeState, ensureRuntimeClassSet, cssPipelineStrategy, isCssAssetProcessed, markCssAssetProcessed, debug, getResolvedConfig, recordCssAssetResult, recordViteProcessedCssAssetResult, getViteProcessedCssAssetResults, getRecordedGeneratorCandidates, getSourceCandidates, getSourceCandidatesForEntries, getSourceCandidateSourcesForEntries, waitForSourceCandidateSyncs, rememberMainCssSource, getRememberedMainCssSource, isViteProcessedCssAsset, frameworkRootImportShellTargetByFile } = context;
 				const resolvedConfig = getResolvedConfig();
 				const uniUtsPlatform = resolveUniUtsPlatform();
 				const generatorPlatform = opts.cssOptions?.platform ?? opts.platform ?? inferPlatformFromViteOutDir(resolvedConfig?.build?.outDir);
@@ -5825,6 +6110,19 @@ function createViteCssFinalizerOutputPlugin(context) {
 				const rootDir = resolvedConfig?.root ? path.resolve(resolvedConfig.root) : process$1.cwd();
 				const outDir = resolvedConfig?.build?.outDir ? path.resolve(rootDir, resolvedConfig.build.outDir) : rootDir;
 				const sourceRoot = resolveWeappViteSourceRoot(resolvedConfig, opts.appType) ?? resolveSourceRootFromBundleGraph(resolvedConfig, bundle);
+				restoreFrameworkRootMiniProgramImportShellAssets(bundle, {
+					debug,
+					isWebGeneratorTarget,
+					matchesCss: opts.cssMatcher,
+					onUpdate: opts.onUpdate,
+					recordCssAssetResult,
+					shouldKeep: (file, css) => cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+						...createCssPipelineContext(file),
+						css,
+						file
+					}),
+					targetByFile: frameworkRootImportShellTargetByFile ?? /* @__PURE__ */ new Map()
+				});
 				const sourceTraceTokenSources = getSourceCandidateSourcesForEntries ? createCssTokenSourceMap(getSourceCandidateSourcesForEntries(void 0), opts) : void 0;
 				const annotateCss = (css) => annotateCssSourceTrace(css, {
 					opts,
@@ -5926,10 +6224,15 @@ function createViteCssFinalizerOutputPlugin(context) {
 					const file = output.fileName || bundleFile;
 					const rawSource = output.source.toString();
 					if (isViteProcessedCssAsset?.(output, file)) {
-						const nextCss = annotateCss(finalizeWebCss(stripBundlerGeneratedCssMarkers(rawSource), {
+						const cleanRawSource = stripBundlerGeneratedCssMarkers(rawSource);
+						const cssHandlerOptions = createCssHandlerOptions(opts, runtimeState.tailwindRuntime.majorVersion, file, outDir, cssPipelineStrategy?.getCssHandlerExtraOptions?.({
+							...createCssPipelineContext(file),
+							file
+						}) ?? {});
+						const nextCss = annotateCss(generatorBranch.isWeb ? finalizeWebCss(cleanRawSource, {
 							...createCssPipelineContext(file),
 							file
-						}, cssPipelineStrategy));
+						}, cssPipelineStrategy) : (await opts.styleHandler(cleanRawSource, cssHandlerOptions)).css);
 						output.source = nextCss;
 						markCssAssetProcessed(output, file);
 						recordCssAssetResult?.(file, nextCss);
@@ -6745,52 +7048,74 @@ function isViteServeStyleRequest(id, command) {
 function isViteServeCssRootRequest(id, command) {
 	return command === "serve" && isSourceStyleRequest(id) && !SPECIAL_QUERY_RE$1.test(id) && !COMMON_JS_PROXY_RE.test(id);
 }
+function isViteBuildStyleRequest(id, command) {
+	return command === "build" && isSourceStyleRequest(id) && !SPECIAL_QUERY_RE$1.test(id) && !COMMON_JS_PROXY_RE.test(id);
+}
 function isViteCssHmrModule(code, id, command) {
 	return isViteServeStyleRequest(id, command) && VITE_CSS_HMR_MODULE_RE.test(code) && (/[?&](?:direct|vue)(?:&|$)/.test(id) || DEFERRED_CSS_HMR_QUERY_RE.test(id));
 }
-function hasViteServeCssGenerationDirective(code) {
+function hasViteCssGenerationDirective(code) {
 	return hasTailwindRootDirectives(code) || hasTailwindSourceDirectives(code, { importFallback: true }) || hasTailwindApplyDirective(code);
 }
 function hasViteServeCssRootDirective(code) {
 	return hasTailwindRootDirectives(code);
 }
-function createViteServeCssGenerationPlugins(options) {
-	return [{
-		name: `${vitePluginName}:generate:serve`,
-		apply: "serve",
-		enforce: "pre",
-		async transform(code, id) {
-			if (!options.shouldGenerate() || !isViteServeCssRootRequest(id, options.getCommand())) return;
-			if (!hasTailwindRootDirectives(code)) return;
-			if (DEFERRED_CSS_HMR_QUERY_RE.test(id)) return;
-			await options.onTailwindRootCss?.(id, code);
-			const generatedCss = await options.generateCss(id, code, this);
-			if (generatedCss === void 0 || generatedCss === code) return;
-			return {
-				code: generatedCss,
-				map: null
-			};
-		}
-	}, {
-		name: `${vitePluginName}:generate:serve-hmr`,
-		apply: "serve",
-		enforce: "post",
-		async transform(code, id) {
-			if (!options.shouldGenerate() || !isViteCssHmrModule(code, id, options.getCommand())) return;
-			const extracted = extractViteCssHmrModuleCss(code);
-			if (!extracted) return;
-			if (!hasViteServeCssGenerationDirective(extracted.css)) return;
-			if (hasViteServeCssRootDirective(extracted.css)) await options.onTailwindRootCss?.(id, extracted.css);
-			const generatedCss = await options.generateCss(id, extracted.css, this);
-			if (generatedCss === void 0 || generatedCss === extracted.css) return;
-			const nextCode = replaceViteCssHmrModuleCss(code, generatedCss);
-			if (nextCode === void 0 || nextCode === code) return;
-			return {
-				code: nextCode,
-				map: null
-			};
+function createViteCssGenerationPlugins(options) {
+	return [
+		{
+			name: `${vitePluginName}:generate:serve`,
+			apply: "serve",
+			enforce: "pre",
+			async transform(code, id) {
+				if (!options.shouldGenerate() || !isViteServeCssRootRequest(id, options.getCommand())) return;
+				if (!hasTailwindRootDirectives(code)) return;
+				if (DEFERRED_CSS_HMR_QUERY_RE.test(id)) return;
+				await options.onTailwindRootCss?.(id, code);
+				const generatedCss = await options.generateCss(id, code, this);
+				if (generatedCss === void 0 || generatedCss === code) return;
+				return {
+					code: generatedCss,
+					map: null
+				};
+			}
+		},
+		{
+			name: `${vitePluginName}:generate:build`,
+			apply: "build",
+			enforce: "pre",
+			async transform(code, id) {
+				if (!options.shouldGenerate() || options.shouldGenerateBuild?.() === false || !isViteBuildStyleRequest(id, options.getCommand())) return;
+				if (!hasViteCssGenerationDirective(code)) return;
+				if (hasViteServeCssRootDirective(code)) await options.onTailwindRootCss?.(id, code);
+				const generatedCss = await options.generateCss(id, code, this);
+				if (generatedCss === void 0 || generatedCss === code) return;
+				return {
+					code: generatedCss,
+					map: null
+				};
+			}
+		},
+		{
+			name: `${vitePluginName}:generate:serve-hmr`,
+			apply: "serve",
+			enforce: "post",
+			async transform(code, id) {
+				if (!options.shouldGenerate() || !isViteCssHmrModule(code, id, options.getCommand())) return;
+				const extracted = extractViteCssHmrModuleCss(code);
+				if (!extracted) return;
+				if (!hasViteCssGenerationDirective(extracted.css)) return;
+				if (hasViteServeCssRootDirective(extracted.css)) await options.onTailwindRootCss?.(id, extracted.css);
+				const generatedCss = await options.generateCss(id, extracted.css, this);
+				if (generatedCss === void 0 || generatedCss === extracted.css) return;
+				const nextCode = replaceViteCssHmrModuleCss(code, generatedCss);
+				if (nextCode === void 0 || nextCode === code) return;
+				return {
+					code: nextCode,
+					map: null
+				};
+			}
 		}
-	}];
+	];
 }
 //#endregion
 //#region src/bundlers/vite/serve-js-transform.ts
@@ -6819,6 +7144,22 @@ function createViteServeJsTransformPlugin(options) {
 	};
 }
 //#endregion
+//#region src/bundlers/vite/serve-root-import-shell.ts
+function resolveViteServeRootMiniProgramImportShell(options) {
+	const { css, cssPipelineContext, cssPipelineStrategy, isWebGeneratorTarget, outputFile } = options;
+	return shouldPreserveFrameworkRootMiniProgramImportShell({
+		css,
+		file: outputFile,
+		isWebGeneratorTarget,
+		matchesCss: cssPipelineContext.opts?.cssMatcher?.(outputFile) ?? true,
+		shouldKeep: () => cssPipelineStrategy?.shouldKeepRootMiniProgramStyleAsImportShell?.({
+			...cssPipelineContext,
+			css,
+			file: outputFile
+		})
+	}) ? normalizeMiniProgramImportShell(css) : void 0;
+}
+//#endregion
 //#region src/bundlers/vite/tailwind-basedir.ts
 const PACKAGE_JSON_FILE = "package.json";
 function resolveImplicitTailwindcssBasedirFromViteRoot(root) {
@@ -6839,6 +7180,40 @@ function resolveImplicitTailwindcssBasedirFromViteRoot(root) {
 	return resolvedRoot;
 }
 //#endregion
+//#region src/bundlers/vite/watch-css-post.ts
+const wrappedCssPostPlugins = /* @__PURE__ */ new WeakSet();
+function isWebOrNativeAppPlatform$1(platform) {
+	return platform === "h5" || platform === "web" || platform?.startsWith("web-") === true || platform === "app" || platform === "app-plus" || platform?.startsWith("app-") === true;
+}
+function shouldAdaptFrameworkWatchCssBeforeCache(options) {
+	return options.enabled && options.ownsTailwindGeneration && options.isWatchBuild && (options.platform ? !isWebOrNativeAppPlatform$1(options.platform) : !options.isWebGeneratorBranch);
+}
+function resolveTransformHandler(plugin) {
+	const hook = plugin.transform;
+	if (typeof hook === "function") return hook;
+	if (hook && typeof hook === "object" && typeof hook.handler === "function") return hook.handler;
+}
+/**
+* 在框架的 CSS post hook 持久化样式前完成转换，保证 watch 重放缓存时不会重新输出原始 CSS。
+*/
+function wrapViteCssPostTransform(config, transformCss) {
+	const plugin = config.plugins?.find((candidate) => candidate.name === "vite:css-post");
+	if (!plugin || wrappedCssPostPlugins.has(plugin)) return false;
+	const originalHandler = resolveTransformHandler(plugin);
+	if (!originalHandler) return false;
+	const wrappedHandler = async function(code, id, ...args) {
+		const transformedCss = await transformCss(code, id);
+		return originalHandler.call(this, transformedCss, id, ...args);
+	};
+	const originalHook = plugin.transform;
+	plugin.transform = originalHook && typeof originalHook === "object" ? {
+		...originalHook,
+		handler: wrappedHandler
+	} : wrappedHandler;
+	wrappedCssPostPlugins.add(plugin);
+	return true;
+}
+//#endregion
 //#region src/bundlers/vite/shared/create-framework-plugins.ts
 const debug = createDebug();
 const weappTailwindcssPackageDir = resolvePackageDir("weapp-tailwindcss");
@@ -6971,6 +7346,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		cssEntries: opts.cssEntries ?? rawOptions.cssEntries
 	});
 	const autoCssSourceContent = /* @__PURE__ */ new Map();
+	const frameworkRootImportShellTargetByFile = /* @__PURE__ */ new Map();
 	const transientAutoCssSources = /* @__PURE__ */ new Map();
 	let refreshRuntimeStateForAutoCssSources;
 	let autoCssSourcesRefresh;
@@ -7047,7 +7423,21 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 	};
 	const customAttributesEntities = toCustomAttributesEntities(customAttributes);
 	let recordedGeneratorCandidates;
-	const sourceCandidateCollector = createSourceCandidateCollector({ bareArbitraryValues: opts.arbitraryValues?.bareArbitraryValues });
+	const sourceCandidateCollector = createSourceCandidateCollector({
+		bareArbitraryValues: opts.arbitraryValues?.bareArbitraryValues,
+		customAttributesEntities,
+		disabledDefaultTemplateHandler
+	});
+	const originalCssLayerSourceByFile = new LRUCache({ max: 128 });
+	const rememberOriginalCssLayerSource = (id, code) => {
+		const file = cleanUrl(id);
+		if (!isCSSRequest(file)) return;
+		if (!hasUserCssLayerBlocks(code)) {
+			originalCssLayerSourceByFile.delete(file);
+			return;
+		}
+		originalCssLayerSourceByFile.set(file, splitUserCssLayerBlocks(code).layer);
+	};
 	const sourceCandidateScanCache = new LRUCache({ max: SOURCE_CANDIDATE_SCAN_CACHE_MAX });
 	let sourceScanEntries;
 	let sourceScanMatcher;
@@ -7433,12 +7823,23 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		getMajorVersion: () => runtimeState.tailwindRuntime.majorVersion,
 		moduleGraph: void 0
 	});
+	const shouldAdaptFrameworkWatchCss = () => {
+		const platform = resolveViteStylePlatform();
+		return shouldAdaptFrameworkWatchCssBeforeCache({
+			enabled: frameworkBranch.adaptWatchCssBeforeFrameworkCache === true,
+			ownsTailwindGeneration: shouldOwnTailwindGeneration,
+			isWatchBuild: isWatchBuild(),
+			isWebGeneratorBranch: resolveCurrentGeneratorBranch().isWeb,
+			platform
+		});
+	};
 	const generateTailwindCssForVitePipeline = async (id, code, hookContext) => {
 		if (!shouldOwnTailwindGeneration) return;
 		await runtimeState.readyPromise;
 		await waitForSourceCandidateSyncs();
 		const file = cleanUrl(id);
-		const requestFile = isCSSRequest(id) ? id === file ? resolveSfcStyleRequestFromKnownSource(file, cssMemory.getKnownSfcSource(file), code) : id : file;
+		const inferredSfcStyleRequest = isSfcStyleSourceFile(file) ? resolveSfcStyleRequestFromKnownSource(file, cssMemory.getKnownSfcSource(file), code) : file;
+		const requestFile = isCSSRequest(id) ? inferredSfcStyleRequest === file ? id : inferredSfcStyleRequest : inferredSfcStyleRequest;
 		if (!isCSSRequest(requestFile) || opts.htmlMatcher(file) || isHTMLRequest(file)) return;
 		const generatorCode = normalizeEmptyTailwindCustomVariants(code);
 		const rootDir = resolvedConfig?.root ? path.resolve(resolvedConfig.root) : process$1.cwd();
@@ -7457,6 +7858,34 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		const pendingHmrChange = resolvePendingHmrCandidateChange(generatorCode, file);
 		const forceFullHmrCssRegeneration = pendingFullHmrCssRegeneration || resolvedConfig?.command === "serve" && pendingHmrCandidateChange !== void 0 && pendingHmrChange === void 0;
 		const runtime = fullRuntime;
+		const importShellCss = resolveViteServeRootMiniProgramImportShell({
+			css: generatorTransformCode,
+			cssPipelineContext,
+			cssPipelineStrategy: frameworkCssPipelineStrategy,
+			isWebGeneratorTarget: currentGeneratorBranch.isWeb,
+			outputFile
+		});
+		if (importShellCss !== void 0) {
+			cleanGeneratedCssByFile.set(fileKey, importShellCss);
+			tracedGeneratedCssByFile.set(fileKey, importShellCss);
+			generatedClassSetByFile.set(fileKey, /* @__PURE__ */ new Set());
+			recordViteProcessedCssAssetResult(file, importShellCss, {
+				injectIntoMain: false,
+				outputFile
+			});
+			markViteProcessedCssSource(file);
+			rememberTailwindRootCssModule(id);
+			recordGeneratorCandidates(fullRuntime);
+			if (pendingHmrChange) finishPendingHmrCssTargetFile(file);
+			else if (!pendingHmrCandidateChange) clearPendingHmrCandidateChange();
+			cssMemory.rememberCssSource({
+				outputFile,
+				rawSource: code,
+				sourceFile: requestFile
+			});
+			debug("css preserved root mini-program import shell for vite postcss pipeline: %s bytes=%d", requestFile, importShellCss.length);
+			return importShellCss;
+		}
 		if (pendingHmrChange && currentGeneratorOptions.target === "weapp" && filterUnsupportedMiniProgramTailwindV4Candidates(pendingHmrChange.addedCandidates).size === 0) {
 			const previousTracedCss = tracedGeneratedCssByFile.get(fileKey);
 			if (previousTracedCss !== void 0) {
@@ -7480,7 +7909,9 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 			cssHandlerOptions,
 			generatorCode: generatorTransformCode
 		}) ?? true);
-		const generated = await hmrTimingRecorder.measure("generateCss.serve", () => generateTailwindV4Css({
+		const previousCss = pendingHmrChange && !forceFullHmrCssRegeneration ? cleanGeneratedCssByFile.get(fileKey) : void 0;
+		const previousGeneratorCss = previousCss && !currentGeneratorBranch.isWeb ? normalizeMiniProgramGeneratorCssSource(previousCss, outputFile) : previousCss;
+		const generated = await hmrTimingRecorder.measure(`generateCss.${resolvedConfig?.command ?? "unknown"}`, () => generateTailwindV4Css({
 			opts,
 			runtimeState,
 			runtime,
@@ -7494,7 +7925,10 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 			generatorPlatform: resolveGeneratorPlatform(),
 			styleHandler,
 			debug,
+			previousCss: previousGeneratorCss,
+			previousClassSet: pendingHmrChange && !forceFullHmrCssRegeneration ? generatedClassSetByFile.get(fileKey) : void 0,
 			deferEmptyScopedCssSource: shouldDeferEmptyScopedCssSource,
+			deferCssAdaptation: !currentGeneratorBranch.isWeb && !shouldAdaptFrameworkWatchCss(),
 			disableSourceScan: false,
 			restoreLocalCssImports: !currentGeneratorBranch.isWeb
 		}), {
@@ -7570,7 +8004,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		weappTailwindcssDirPosix
 	});
 	if (disabledOptions.plugin) return rewritePlugins.length ? rewritePlugins : void 0;
-	const generateBundleHook = createGenerateBundleHook({
+	const generateBundleContext = {
 		opts,
 		runtimeState,
 		ensureRuntimeClassSet,
@@ -7587,6 +8021,11 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		getSourceCandidates,
 		getSourceCandidateSource: (file) => sourceCandidateCollector.source(file),
 		getSourceCandidateSources: () => sourceCandidateCollector.sources(),
+		extractSourceCandidates: (file, source) => extractCandidatesFromSource(source, path.extname(cleanUrl(file)).slice(1) || "html", {
+			bareArbitraryValues: opts.arbitraryValues?.bareArbitraryValues,
+			customAttributesEntities,
+			disabledDefaultTemplateHandler
+		}),
 		getSourceCandidatesForEntries,
 		getSourceCandidateSourcesForEntries,
 		waitForSourceCandidateSyncs,
@@ -7597,11 +8036,23 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		setRememberedCssSignature: cssMemory.setRememberedCssSignature,
 		getKnownCssSource: cssMemory.getKnownCssSource,
 		getKnownSfcSource: cssMemory.getKnownSfcSource,
+		getOriginalCssLayerSource: (file) => originalCssLayerSourceByFile.get(cleanUrl(file)),
 		recordGeneratorCandidates,
 		pruneViteCssCaches,
 		getViteCssCacheStats,
 		hmrTimingRecorder,
-		cssPipelineStrategy: frameworkCssPipelineStrategy
+		cssPipelineStrategy: frameworkCssPipelineStrategy,
+		frameworkRootImportShellTargetByFile
+	};
+	const shouldSplitGenerateBundlePhases = () => opts.appType === "weapp-vite" && getResolvedConfig()?.mode !== "production";
+	const preGenerateBundleHook = createGenerateBundleHook({
+		...generateBundleContext,
+		processMarkupAndScripts: false,
+		shouldProcessBundle: shouldSplitGenerateBundlePhases
+	});
+	const generateBundleHook = createGenerateBundleHook({
+		...generateBundleContext,
+		shouldProcessStyles: () => !shouldSplitGenerateBundlePhases()
 	});
 	const cssFinalizerOutputPlugin = createViteCssFinalizerOutputPlugin({
 		opts,
@@ -7621,6 +8072,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		getSourceCandidatesForEntries,
 		getSourceCandidateSourcesForEntries,
 		waitForSourceCandidateSyncs,
+		frameworkRootImportShellTargetByFile,
 		rememberMainCssSource: (file, rawSource) => cssMemory.rememberCssSource({
 			outputFile: file,
 			rawSource,
@@ -7647,6 +8099,21 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 		styleHandler,
 		uniAppX
 	}) ?? [];
+	const installFrameworkWatchCssCacheAdapter = async (config) => {
+		if (!shouldAdaptFrameworkWatchCss()) return;
+		if (wrapViteCssPostTransform(config, async (css, id) => {
+			if (!isCSSRequest(id)) return css;
+			if (hasBundlerGeneratedCssMarker(css)) {
+				debug("preserve adapted generated css before uni-app watch cache: %s", id);
+				return css;
+			}
+			const file = cleanUrl(id);
+			const styleRequest = isSfcStyleSourceFile(file) ? resolveSfcStyleRequestFromKnownSource(file, cssMemory.getKnownSfcSource(file), css, id) : id;
+			const transformedCss = (await styleHandler(css, transformCssHandlerOptions.getCssHandlerOptions(styleRequest))).css;
+			debug("adapt css before uni-app watch cache: %s inputRaw=%s outputRaw=%s", id, css.includes("\\[") || css.includes("\\:"), transformedCss.includes("\\[") || transformedCss.includes("\\:"));
+			return transformedCss;
+		})) debug("adapt uni-app watch css before vite:css-post cache");
+	};
 	const plugins = [
 		...rewritePlugins,
 		{
@@ -7656,6 +8123,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 				if (!shouldOwnTailwindGeneration || isWebOrNativeAppPlatform(resolveViteStylePlatform()) || !isCSSRequest(id) || !shouldCollectTransformedSourceCandidates(id)) return;
 				const rawCode = await readFile(cleanUrl(id), "utf8").catch(() => void 0);
 				if (typeof rawCode !== "string") return;
+				rememberOriginalCssLayerSource(id, rawCode);
 				const transformedCode = transformEarlyMiniProgramCss(rawCode);
 				if (transformedCode === rawCode) return;
 				cssMemory.rememberKnownSfcSource(id, transformedCode);
@@ -7664,6 +8132,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 			transform: {
 				order: "pre",
 				async handler(code, id) {
+					if (hasUserCssLayerBlocks(code)) rememberOriginalCssLayerSource(id, code);
 					let transformedCode = code;
 					if (shouldOwnTailwindGeneration && !resolveCurrentGeneratorBranch().isWeb && isCSSRequest(id)) transformedCode = transformEarlyMiniProgramCss(code);
 					const shouldReturnTransformedCode = transformedCode !== code;
@@ -7719,6 +8188,7 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 					}
 					const canReadHotSource = typeof ctx.read === "function";
 					const hotSource = isSourceCandidateHotUpdate && canReadHotSource ? await ctx.read().catch(() => void 0) : void 0;
+					if (typeof hotSource === "string" && isCSSRequest(ctx.file)) rememberOriginalCssLayerSource(ctx.file, hotSource);
 					const sourceCandidateChange = await syncChangedSourceCandidateFile(ctx.file, hotSource);
 					const isWebLikeHotUpdate = isCurrentWebLikeStylePlatform();
 					let canUseHmrCandidateAppend = false;
@@ -7762,13 +8232,15 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 				await hmrTimingRecorder.measure("sourceCandidates.buildStart", async () => {
 					await prepareTailwindGeneration();
 				}, { emit: false });
-			}
+			},
+			generateBundle: preGenerateBundleHook
 		},
-		...createViteServeCssGenerationPlugins({
+		...createViteCssGenerationPlugins({
 			generateCss: generateTailwindCssForVitePipeline,
 			getCommand: () => resolvedConfig?.command,
 			onTailwindRootCss: registerTailwindRootCss,
-			shouldGenerate: () => shouldOwnTailwindGeneration
+			shouldGenerate: () => shouldOwnTailwindGeneration,
+			shouldGenerateBuild: () => resolveCurrentGeneratorBranch().isWeb
 		}),
 		createViteServeJsTransformPlugin({
 			createHandlerOptions: (file) => serveJsHandlerOptions(file, frameworkCssPipelineStrategy?.getServeJsHandlerOptions?.({
@@ -7780,6 +8252,13 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 			shouldTransform: () => shouldOwnTailwindGeneration && (frameworkCssPipelineStrategy?.shouldTransformServeJs?.(createCssPipelineContext()) ?? !resolveCurrentGeneratorBranch().isWeb),
 			transformRuntime: ensureRuntimeClassSet
 		}),
+		{
+			name: `${vitePluginName}:watch-css-cache`,
+			configResolved: {
+				order: "post",
+				handler: installFrameworkWatchCssCacheAdapter
+			}
+		},
 		{
 			name: `${vitePluginName}:post`,
 			enforce: "post",
@@ -7787,7 +8266,10 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 				if (!shouldOwnTailwindGeneration) return;
 				if (Array.isArray(config.plugins)) {
 					const removed = disableAndRemoveTailwindVitePlugins(config.plugins);
-					if (removed > 0) debug("disable official tailwind vite plugins in generator mode: %d", removed);
+					if (removed > 0) {
+						logger.warn("检测到 @tailwindcss/vite，生成模式下已移除该插件以避免 Tailwind CSS 重复生成。");
+						debug("disable official tailwind vite plugins in generator mode: %d", removed);
+					}
 				}
 				const root = config.root ? path.resolve(config.root) : process$1.cwd();
 				const baseConfig = { resolve: { alias: [{
@@ -7841,7 +8323,10 @@ function createViteFrameworkPlugins(options = {}, frameworkBranch) {
 						const postcssPlugins = config.css.postcss.plugins;
 						if (shouldOwnTailwindGeneration) {
 							const removed = removeTailwindPostcssPlugins(postcssPlugins);
-							if (removed > 0) debug("remove official tailwind postcss plugins in generator mode: %d", removed);
+							if (removed > 0) {
+								logger.warn("检测到 @tailwindcss/postcss，生成模式下已移除该插件以避免 Tailwind CSS 重复生成。");
+								debug("remove official tailwind postcss plugins in generator mode: %d", removed);
+							}
 						}
 					}
 				}, { emit: false });
@@ -7966,6 +8451,7 @@ const uniAppCssPipelineStrategy = {
 function createUniAppVitePlugins(options = {}) {
 	return createViteFrameworkPlugins(options, {
 		frameworkName: "uni-app",
+		adaptWatchCssBeforeFrameworkCache: true,
 		cssPipelineStrategy: uniAppCssPipelineStrategy,
 		styleInjectorDelegate: viteStyleInjectorDelegates.uniApp
 	});
@@ -8091,6 +8577,7 @@ const uniAppXCssPipelineStrategy = {
 function createUniAppXVitePlugins(options = {}) {
 	return createViteFrameworkPlugins(options, {
 		frameworkName: "uni-app-x",
+		adaptWatchCssBeforeFrameworkCache: true,
 		cssPipelineStrategy: uniAppXCssPipelineStrategy,
 		getExtraPluginPlatform: () => ({ isIosPlatform: resolveUniUtsPlatform().isAppIos }),
 		styleInjectorDelegate: viteStyleInjectorDelegates.uniApp,