weapp-tailwindcss 5.1.15 → 5.2.0

package/dist/{gulp-3m1dAiig.js → gulp-Cjcss8T_.cjs}

@@ -1,18 +1,21 @@
-const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.js");
-const require_generator = require("./generator-CEnUsjed.js");
-const require_tailwindcss = require("./tailwindcss-KBYPJ2DW.js");
-const require_wxml = require("./wxml-Ce10eREX.js");
-const require_context = require("./context-VeFq_8vW.js");
-const require_hmr_timing = require("./hmr-timing-B8p4f0ca.js");
+const require_rolldown_runtime = require("./rolldown-runtime-CVvi-lCc.cjs");
+const require_generator = require("./generator-C8D5cnbe.cjs");
+const require_options = require("./options-DlvhQwWB.cjs");
+const require_v4_generation_core = require("./v4-generation-core-D7MuR5ZF.cjs");
+const require_wxml = require("./wxml-DSMNuUaP.cjs");
+const require_hmr_timing = require("./hmr-timing-DMLfNfGG.cjs");
+const require_context = require("./context-PZXBqrAJ.cjs");
+const require_tailwindcss = require("./tailwindcss-Cs94gJgf.cjs");
+const require_style_options = require("./style-options-CEfXwZzX.cjs");
 let node_fs = require("node:fs");
-node_fs = require_rolldown_runtime.__toESM(node_fs);
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
 let node_path = require("node:path");
-node_path = require_rolldown_runtime.__toESM(node_path);
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
 let node_process = require("node:process");
-node_process = require_rolldown_runtime.__toESM(node_process);
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let node_buffer = require("node:buffer");
 let node_stream = require("node:stream");
-node_stream = require_rolldown_runtime.__toESM(node_stream);
+node_stream = require_rolldown_runtime.__toESM(node_stream, 1);
 let _weapp_tailwindcss_postcss = require("@weapp-tailwindcss/postcss");
 //#region src/bundlers/gulp/module-graph.ts
 const MODULE_EXTENSIONS = [
@@ -66,72 +69,20 @@ function createGulpModuleGraphOptions(opts) {
 }
 //#endregion
 //#region src/bundlers/gulp/runtime-snapshot.ts
-function createGulpRuntimeSnapshot(runtimeSourcesByFile, changedFiles) {
-	const runtimeAffectingChangedByType = {
-		html: /* @__PURE__ */ new Set(),
-		js: /* @__PURE__ */ new Set(),
-		css: /* @__PURE__ */ new Set(),
-		other: /* @__PURE__ */ new Set()
-	};
-	for (const file of changedFiles) {
-		const entry = runtimeSourcesByFile.get(file);
-		if (entry) runtimeAffectingChangedByType[entry.type].add(file);
-	}
-	return {
-		entries: [...runtimeSourcesByFile.entries()].map(([file, entry]) => ({
-			file,
-			output: {
-				fileName: file,
-				source: entry.source,
-				type: "asset"
-			},
-			source: entry.source,
-			type: entry.type
-		})),
-		jsEntries: /* @__PURE__ */ new Map(),
-		sourceHashByFile: /* @__PURE__ */ new Map(),
-		runtimeAffectingSignatureByFile: /* @__PURE__ */ new Map(),
-		runtimeAffectingHashByFile: /* @__PURE__ */ new Map(),
-		hasOmittedKnownFiles: false,
-		changedByType: {
-			html: /* @__PURE__ */ new Set(),
-			js: /* @__PURE__ */ new Set(),
-			css: /* @__PURE__ */ new Set(),
-			other: /* @__PURE__ */ new Set()
-		},
-		runtimeAffectingChangedByType,
-		processFiles: {
-			html: /* @__PURE__ */ new Set(),
-			js: /* @__PURE__ */ new Set(),
-			css: /* @__PURE__ */ new Set()
-		},
-		linkedImpactsByEntry: /* @__PURE__ */ new Map()
-	};
-}
-//#endregion
-//#region src/bundlers/gulp/vinyl-transform.ts
-const Transform = node_stream.default.Transform;
-function createVinylTransform(phase, handler, getTimingDetails) {
-	return new Transform({
-		objectMode: true,
-		async transform(file, _encoding, callback) {
-			const hmrTimingStartedAt = performance.now();
-			try {
-				await handler(file);
-				require_hmr_timing.emitHmrTiming("gulp", phase, performance.now() - hmrTimingStartedAt, {
-					file: file.relative || node_path.default.basename(file.path),
-					...getTimingDetails?.(file)
-				});
-				callback(null, file);
-			} catch (error) {
-				callback(error, file);
-			}
-		}
+function createGulpRuntimeSnapshot(runtimeSourcesByFile, state, computeHash, options = {}) {
+	return require_hmr_timing.buildRuntimeCompilationSnapshot([...runtimeSourcesByFile.entries()].map(([file, entry]) => ({
+		file,
+		runtimeCandidate: true,
+		source: entry.source,
+		type: entry.type
+	})), state, {
+		computeHash,
+		createRuntimeAffectingSignature: require_v4_generation_core.createRuntimeAffectingSourceSignature,
+		removedFiles: options.removedFiles
 	});
 }
 //#endregion
-//#region src/bundlers/gulp/shared/create-native-framework-plugins.ts
-const debug = require_wxml.createDebug();
+//#region src/bundlers/gulp/shared/create-native-framework-plugins/cache-state.ts
 const GULP_RUNTIME_SOURCE_CACHE_MAX = 256;
 const GULP_PROCESS_CACHE_MAX = 512;
 function toMb(bytes) {
@@ -141,13 +92,15 @@ function touchMapEntry(map, key, value) {
 	map.delete(key);
 	map.set(key, value);
 }
-function pruneGulpRuntimeSourceCaches(sourceHashByFile, sourcesByFile) {
+function pruneGulpRuntimeSourceCaches(sourcesByFile) {
+	const removedFiles = [];
 	while (sourcesByFile.size > GULP_RUNTIME_SOURCE_CACHE_MAX) {
 		const oldestKey = sourcesByFile.keys().next().value;
 		if (typeof oldestKey !== "string") break;
 		sourcesByFile.delete(oldestKey);
-		sourceHashByFile.delete(oldestKey);
+		removedFiles.push(oldestKey);
 	}
+	return removedFiles;
 }
 function rememberGulpProcessCacheKey(cacheKeys, key) {
 	cacheKeys.delete(key);
@@ -192,6 +145,227 @@ function resolveGulpMemoryDebugStats(context) {
 		tailwind: { v4: require_generator.getTailwindV4IncrementalGenerateCacheStats() }
 	};
 }
+//#endregion
+//#region src/bundlers/gulp/asset-emission-plan.ts
+function applyGulpAssetEmissionPlan(plan, options) {
+	for (const operation of plan.operations()) {
+		if (operation.kind === "delete") {
+			options.deleteAsset(operation.assetId);
+			continue;
+		}
+		options.writeAsset(operation.assetId, typeof operation.source === "string" ? node_buffer.Buffer.from(operation.source) : node_buffer.Buffer.from(operation.source));
+	}
+}
+function writeGulpFileAsset(file, source) {
+	const plan = new require_v4_generation_core.AssetEmissionPlan();
+	plan.write(file.path, source);
+	applyGulpAssetEmissionPlan(plan, {
+		deleteAsset(assetId) {
+			if (assetId === file.path) file.contents = null;
+		},
+		writeAsset(assetId, contents) {
+			if (assetId === file.path) file.contents = contents;
+		}
+	});
+}
+//#endregion
+//#region src/bundlers/gulp/vinyl-transform.ts
+const Transform = node_stream.default.Transform;
+function createVinylTransform(phase, handler, getTimingDetails) {
+	return new Transform({
+		objectMode: true,
+		async transform(file, _encoding, callback) {
+			const hmrTimingStartedAt = performance.now();
+			try {
+				await handler(file);
+				require_hmr_timing.emitHmrTiming("gulp", phase, performance.now() - hmrTimingStartedAt, {
+					file: file.relative || node_path.default.basename(file.path),
+					...getTimingDetails?.(file)
+				});
+				callback(null, file);
+			} catch (error) {
+				callback(error, file);
+			}
+		}
+	});
+}
+//#endregion
+//#region src/bundlers/gulp/shared/create-native-framework-plugins/file-transforms.ts
+function createGulpFileTransforms(context) {
+	const { cache, createRuntimeSetHash, debug, generatedCssPreflightModeByFile, getCompilationDependencyRevision, getSourceCandidateGetter, getSourceCandidateSourceGetter, getRuntimeSet, gulpProcessCacheKeys, opts, refreshGulpV4SourceCandidates, refreshRuntimeSet, refreshRuntimeSetForSource, registerAutoCssSource, rememberCompilationScope, resolveGulpStyleOutputExtension, resolveGulpTransformTimingDetails, resolveModuleGraphOptions, resolveWxmlHandlerOptions, resolveWxssFileHandlerOptions, resolveWxssUserHandlerOptions, runtimeState } = context;
+	const { templateHandler, styleHandler, jsHandler } = opts;
+	function createWxssTransform(options, stage) {
+		return createVinylTransform(`css:${stage}`, async (file) => {
+			if (!file.contents) return;
+			const rawSource = file.contents.toString();
+			const cssSourceChanged = await registerAutoCssSource(file, rawSource);
+			const shouldUseGenerator = runtimeState.tailwindRuntime.majorVersion === 4;
+			let gulpSourceCandidateGetter = getSourceCandidateGetter();
+			if (shouldUseGenerator) gulpSourceCandidateGetter = await refreshGulpV4SourceCandidates(cssSourceChanged);
+			const nextRuntimeSet = await refreshRuntimeSet({
+				forceRefresh: cssSourceChanged,
+				forceCollect: cssSourceChanged,
+				clearCache: cssSourceChanged
+			});
+			const sourceCandidateSourceGetter = getSourceCandidateSourceGetter();
+			const sourceTraceTokenSources = sourceCandidateSourceGetter ? require_v4_generation_core.createCssTokenSourceMap(sourceCandidateSourceGetter(void 0), opts) : void 0;
+			const sourceTraceSignature = require_v4_generation_core.createCssSourceTraceCacheSignature(sourceTraceTokenSources, opts);
+			const sourceCandidateSignature = gulpSourceCandidateGetter ? `gulp-source-candidates:1:${[...gulpSourceCandidateGetter(void 0)].sort().join("\n")}` : void 0;
+			const styleOutputExtension = resolveGulpStyleOutputExtension(file);
+			const cssHandlerOptions = resolveWxssFileHandlerOptions(file, rawSource, options);
+			const outputFile = (file.relative || node_path.default.basename(file.path)).replaceAll(node_path.default.sep, "/");
+			const compilationScope = {
+				id: outputFile,
+				kind: cssHandlerOptions.isMainChunk ? "global" : "component"
+			};
+			rememberCompilationScope(file.path, compilationScope.id);
+			const compilationDependencyRevision = getCompilationDependencyRevision(compilationScope.id);
+			const outputSignature = `${styleOutputExtension ? `gulp-output:1:${stage}:${styleOutputExtension}` : `gulp-output:0:${stage}`}:compiler-dependencies:${compilationDependencyRevision}`;
+			await require_hmr_timing.processCachedTask({
+				cache,
+				cacheKey: file.path,
+				hash: createRuntimeSetHash(rawSource, nextRuntimeSet, sourceTraceSignature, sourceCandidateSignature, outputSignature),
+				applyResult(source) {
+					writeGulpFileAsset(file, source);
+				},
+				onCacheHit() {
+					debug("css cache hit: %s", file.path);
+				},
+				async transform() {
+					await runtimeState.readyPromise;
+					const generated = shouldUseGenerator ? await require_v4_generation_core.generateTailwindV4Css({
+						opts,
+						runtimeState,
+						runtime: nextRuntimeSet,
+						rawSource,
+						file: file.path,
+						outputFile,
+						scope: compilationScope,
+						cssHandlerOptions,
+						cssUserHandlerOptions: resolveWxssUserHandlerOptions(options),
+						getSourceCandidatesForEntries: gulpSourceCandidateGetter,
+						styleHandler,
+						debug,
+						deferCssAdaptation: stage === "generate"
+					}) : void 0;
+					const transformedCss = generated?.css ?? (stage === "generate" ? rawSource : (await styleHandler(rawSource, cssHandlerOptions)).css);
+					if (stage === "generate") {
+						const preflightMode = generated?.metadata?.preflightMode;
+						if (preflightMode) generatedCssPreflightModeByFile.set(file.path, preflightMode);
+						else generatedCssPreflightModeByFile.delete(file.path);
+					}
+					const css = require_v4_generation_core.annotateCssSourceTrace(transformedCss, {
+						opts,
+						tokenSources: sourceTraceTokenSources
+					});
+					const generatedCss = stage === "generate" && generated ? `${require_v4_generation_core.createBundlerGeneratedCssMarker("gulp", file.path)}\n${css}` : css;
+					const outputCss = stage === "generate" ? generatedCss : (0, _weapp_tailwindcss_postcss.rewriteLocalCssImportRequestsForOutput)(generatedCss, { styleOutputExtension });
+					debug("css handle: %s", file.path);
+					return { result: outputCss };
+				}
+			});
+			rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
+			pruneGulpProcessCache(cache, gulpProcessCacheKeys);
+		}, () => resolveGulpTransformTimingDetails(`css:${stage}`));
+	}
+	const generateWxss = (options = {}) => createWxssTransform(options, "generate");
+	const transformWxss = (options = {}) => createWxssTransform(options, "transform");
+	const adaptWxss = (options = {}) => createVinylTransform("css:adapt", async (file) => {
+		if (!file.contents) return;
+		const rawSource = file.contents.toString();
+		const generatedCss = require_v4_generation_core.hasBundlerGeneratedCssMarker(rawSource);
+		const source = generatedCss ? require_v4_generation_core.stripBundlerGeneratedCssMarkers(rawSource) : rawSource;
+		const styleOutputExtension = resolveGulpStyleOutputExtension(file);
+		const cssHandlerOptions = resolveWxssFileHandlerOptions(file, source, options);
+		const handled = await styleHandler(source, cssHandlerOptions);
+		const preflightMode = generatedCssPreflightModeByFile.get(file.path);
+		writeGulpFileAsset(file, (0, _weapp_tailwindcss_postcss.rewriteLocalCssImportRequestsForOutput)(generatedCss ? require_v4_generation_core.finalizeMiniProgramGeneratorCss(handled.css, "weapp", runtimeState.tailwindRuntime.majorVersion, opts.cssPreflight, {
+			injectPreflight: preflightMode?.inject ?? cssHandlerOptions.isMainChunk,
+			preservePreflight: preflightMode?.preserve ?? cssHandlerOptions.isMainChunk,
+			styleOptions: cssHandlerOptions
+		}) : handled.css, { styleOutputExtension }));
+		debug("css adapt: %s", file.path);
+	}, () => resolveGulpTransformTimingDetails("css:adapt"));
+	const transformJs = (options = {}) => createVinylTransform("js", async (file) => {
+		if (!file.contents) return;
+		const filename = node_path.default.resolve(file.path);
+		const rawSource = file.contents.toString();
+		await refreshRuntimeSetForSource(file, rawSource, "js");
+		await runtimeState.readyPromise;
+		const moduleGraph = resolveModuleGraphOptions(options.moduleGraph);
+		const handlerOptions = {
+			...options,
+			generateMap: false,
+			filename,
+			moduleGraph,
+			babelParserOptions: {
+				...options?.babelParserOptions ?? {},
+				sourceFilename: filename
+			}
+		};
+		if (runtimeState.tailwindRuntime.majorVersion !== void 0) handlerOptions.tailwindcssMajorVersion = runtimeState.tailwindRuntime.majorVersion;
+		await require_hmr_timing.processCachedTask({
+			cache,
+			cacheKey: file.path,
+			rawSource,
+			applyResult(source) {
+				writeGulpFileAsset(file, source);
+			},
+			onCacheHit() {
+				debug("js cache hit: %s", file.path);
+			},
+			async transform() {
+				await runtimeState.readyPromise;
+				const currentSource = file.contents?.toString() ?? rawSource;
+				if (require_context.shouldSkipJsTransform(currentSource, {
+					...handlerOptions,
+					classNameSet: getRuntimeSet()
+				})) return { result: currentSource };
+				const { code } = await jsHandler(currentSource, getRuntimeSet(), handlerOptions);
+				debug("js handle: %s", file.path);
+				return { result: code };
+			}
+		});
+		rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
+		pruneGulpProcessCache(cache, gulpProcessCacheKeys);
+	}, () => resolveGulpTransformTimingDetails("js"));
+	const transformWxml = (options = {}) => createVinylTransform("html", async (file) => {
+		if (!file.contents) return;
+		const rawSource = file.contents.toString();
+		await refreshRuntimeSetForSource(file, rawSource, "html");
+		await runtimeState.readyPromise;
+		await require_hmr_timing.processCachedTask({
+			cache,
+			cacheKey: file.path,
+			rawSource,
+			applyResult(source) {
+				writeGulpFileAsset(file, source);
+			},
+			onCacheHit() {
+				debug("html cache hit: %s", file.path);
+			},
+			async transform() {
+				await runtimeState.readyPromise;
+				const code = await templateHandler(rawSource, resolveWxmlHandlerOptions(options));
+				debug("html handle: %s", file.path);
+				return { result: code };
+			}
+		});
+		rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
+		pruneGulpProcessCache(cache, gulpProcessCacheKeys);
+	}, () => resolveGulpTransformTimingDetails("html"));
+	return {
+		adaptWxss,
+		generateWxss,
+		transformWxss,
+		transformWxml,
+		transformJs
+	};
+}
+//#endregion
+//#region src/bundlers/gulp/shared/create-native-framework-plugins.ts
+const debug = require_wxml.createDebug();
+const GULP_COMPILATION_SCOPE_CACHE_MAX = 512;
 /**
 * @name weapp-tw-gulp
 * @description native framework 的插件组合实现
@@ -203,7 +377,7 @@ function createNativeGulpPlugins(options = {}) {
 		...options,
 		__internalDeferMissingCssEntriesWarning: true
 	});
-	const { templateHandler, styleHandler, jsHandler, cache } = opts;
+	const { cache } = opts;
 	const initialTailwindRuntime = opts.tailwindRuntime;
 	const refreshTailwindcssRuntime = opts.refreshTailwindcssRuntime;
 	const readyPromise = require_context.createTailwindRuntimeReadyPromise(initialTailwindRuntime);
@@ -221,12 +395,13 @@ function createNativeGulpPlugins(options = {}) {
 	let cachedGulpSourceCandidateSourceGetter;
 	let runtimeSetInitialized = false;
 	let runtimeSetDirty = false;
-	const runtimeSourceHashByFile = /* @__PURE__ */ new Map();
 	const runtimeSourcesByFile = /* @__PURE__ */ new Map();
+	const runtimeSnapshotState = require_hmr_timing.createRuntimeCompilationBuildState();
 	const generatedCssPreflightModeByFile = /* @__PURE__ */ new Map();
+	const compilationScopeBySourceFile = /* @__PURE__ */ new Map();
 	let cachedGulpSourceCandidateSignature;
 	const gulpProcessCacheKeys = /* @__PURE__ */ new Set();
-	const bundleRuntimeClassSetManager = options.__internalGulpRuntimeClassSetManager ?? require_hmr_timing.createBundleRuntimeClassSetManager();
+	const bundleRuntimeClassSetManager = options.__internalGulpRuntimeClassSetManager ?? require_hmr_timing.createRuntimeClassSetManager();
 	function invalidateGulpSourceCandidates() {
 		cachedGulpSourceCandidateSignature = void 0;
 		cachedGulpSourceCandidateGetter = void 0;
@@ -254,19 +429,18 @@ function createNativeGulpPlugins(options = {}) {
 	}
 	async function refreshRuntimeSetForSource(file, rawSource, type) {
 		const filename = node_path.default.resolve(file.path);
-		const hash = cache.computeHash(rawSource);
-		const changed = runtimeSourceHashByFile.get(filename) !== hash;
-		runtimeSourceHashByFile.delete(filename);
-		runtimeSourceHashByFile.set(filename, hash);
 		touchMapEntry(runtimeSourcesByFile, filename, {
 			source: rawSource,
 			type
 		});
-		pruneGulpRuntimeSourceCaches(runtimeSourceHashByFile, runtimeSourcesByFile);
+		require_hmr_timing.removeRuntimeCompilationBuildStateFiles(runtimeSnapshotState, pruneGulpRuntimeSourceCaches(runtimeSourcesByFile));
+		const snapshot = createGulpRuntimeSnapshot(runtimeSourcesByFile, runtimeSnapshotState, (source) => cache.computeHash(source));
+		const changed = snapshot.changedByType[type].has(filename);
+		require_hmr_timing.updateRuntimeCompilationBuildState(runtimeSnapshotState, snapshot, /* @__PURE__ */ new Map());
 		if (changed) invalidateGulpSourceCandidates();
 		if (!changed && runtimeSetInitialized) return runtimeSet;
 		if (!runtimeSetDirty) try {
-			runtimeSet = await bundleRuntimeClassSetManager.sync(runtimeState.tailwindRuntime, createGulpRuntimeSnapshot(runtimeSourcesByFile, [filename]));
+			runtimeSet = await bundleRuntimeClassSetManager.sync(runtimeState.tailwindRuntime, snapshot);
 			runtimeSetInitialized = true;
 			return runtimeSet;
 		} catch (error) {
@@ -277,7 +451,7 @@ function createNativeGulpPlugins(options = {}) {
 	}
 	async function refreshGulpV4SourceCandidates(forceRefresh = false) {
 		const root = opts.tailwindcssBasedir ?? node_process.default.cwd();
-		const sourceScan = await require_tailwindcss.resolveViteSourceScanEntries(opts, runtimeState.tailwindRuntime, { root });
+		const sourceScan = await require_options.resolveSourceScanEntries(opts, runtimeState.tailwindRuntime, { root });
 		const nextSignature = cache.computeHash(JSON.stringify({
 			root,
 			entries: sourceScan?.entries,
@@ -289,7 +463,7 @@ function createNativeGulpPlugins(options = {}) {
 			dependencies: [...sourceScan?.dependencies ?? []].sort()
 		}));
 		if (!forceRefresh && cachedGulpSourceCandidateSignature === nextSignature && cachedGulpSourceCandidateGetter) return cachedGulpSourceCandidateGetter;
-		const collector = require_hmr_timing.createSourceCandidateCollector({
+		const collector = require_v4_generation_core.createSourceCandidateCollector({
 			bareArbitraryValues: opts.arbitraryValues?.bareArbitraryValues,
 			customAttributesEntities: opts.customAttributesEntities,
 			disabledDefaultTemplateHandler: opts.disabledDefaultTemplateHandler
@@ -338,7 +512,7 @@ function createNativeGulpPlugins(options = {}) {
 		return cachedDefaultModuleGraphOptions;
 	}
 	function resolveWxssHandlerOptions(options) {
-		const styleHandlerMajorVersion = require_context.normalizeStyleHandlerMajorVersion(runtimeState.tailwindRuntime.majorVersion);
+		const styleHandlerMajorVersion = require_style_options.normalizeStyleHandlerMajorVersion(runtimeState.tailwindRuntime.majorVersion);
 		const majorVersion = styleHandlerMajorVersion ?? "unknown";
 		if (!options || Object.keys(options).length === 0) {
 			let cached = defaultStyleHandlerOptionsCache.get(majorVersion);
@@ -417,167 +591,78 @@ function createNativeGulpPlugins(options = {}) {
 			gulpProcessCacheKeys,
 			phase,
 			runtimeSet,
-			runtimeSourceHashByFile,
+			runtimeSourceHashByFile: runtimeSnapshotState.sourceHashByFile,
 			runtimeSourcesByFile
 		}) };
 	}
-	function createWxssTransform(options, stage) {
-		return createVinylTransform(`css:${stage}`, async (file) => {
-			if (!file.contents) return;
-			const rawSource = file.contents.toString();
-			const cssSourceChanged = await registerAutoCssSource(file, rawSource);
-			const shouldUseGenerator = runtimeState.tailwindRuntime.majorVersion === 4;
-			let gulpSourceCandidateGetter;
-			if (shouldUseGenerator) gulpSourceCandidateGetter = await refreshGulpV4SourceCandidates(cssSourceChanged);
-			const nextRuntimeSet = await refreshRuntimeSet({
-				forceRefresh: cssSourceChanged,
-				forceCollect: cssSourceChanged,
-				clearCache: cssSourceChanged
-			});
-			const sourceTraceTokenSources = cachedGulpSourceCandidateSourceGetter ? require_hmr_timing.createCssTokenSourceMap(cachedGulpSourceCandidateSourceGetter(void 0), opts) : void 0;
-			const sourceTraceSignature = require_hmr_timing.createCssSourceTraceCacheSignature(sourceTraceTokenSources, opts);
-			const sourceCandidateSignature = cachedGulpSourceCandidateGetter ? `gulp-source-candidates:1:${[...cachedGulpSourceCandidateGetter(void 0)].sort().join("\n")}` : void 0;
-			const styleOutputExtension = resolveGulpStyleOutputExtension(file);
-			const outputSignature = styleOutputExtension ? `gulp-output:1:${stage}:${styleOutputExtension}` : `gulp-output:0:${stage}`;
-			await require_hmr_timing.processCachedTask({
-				cache,
-				cacheKey: file.path,
-				hash: createRuntimeSetHash(rawSource, nextRuntimeSet, sourceTraceSignature, sourceCandidateSignature, outputSignature),
-				applyResult(source) {
-					file.contents = node_buffer.Buffer.from(source);
-				},
-				onCacheHit() {
-					debug("css cache hit: %s", file.path);
-				},
-				async transform() {
-					await runtimeState.readyPromise;
-					const cssHandlerOptions = resolveWxssFileHandlerOptions(file, rawSource, options);
-					const generated = shouldUseGenerator ? await require_hmr_timing.generateCssByGenerator({
-						opts,
-						runtimeState,
-						runtime: nextRuntimeSet,
-						rawSource,
-						file: file.path,
-						cssHandlerOptions,
-						cssUserHandlerOptions: resolveWxssUserHandlerOptions(options),
-						getSourceCandidatesForEntries: gulpSourceCandidateGetter,
-						styleHandler,
-						debug,
-						deferCssAdaptation: stage === "generate"
-					}) : void 0;
-					const transformedCss = generated?.css ?? (stage === "generate" ? rawSource : (await styleHandler(rawSource, cssHandlerOptions)).css);
-					if (stage === "generate") {
-						const preflightMode = generated?.metadata?.preflightMode;
-						if (preflightMode) generatedCssPreflightModeByFile.set(file.path, preflightMode);
-						else generatedCssPreflightModeByFile.delete(file.path);
-					}
-					const css = require_hmr_timing.annotateCssSourceTrace(transformedCss, {
-						opts,
-						tokenSources: sourceTraceTokenSources
-					});
-					const generatedCss = stage === "generate" && generated ? `${require_hmr_timing.createBundlerGeneratedCssMarker("gulp", file.path)}\n${css}` : css;
-					const outputCss = stage === "generate" ? generatedCss : (0, _weapp_tailwindcss_postcss.rewriteLocalCssImportRequestsForOutput)(generatedCss, { styleOutputExtension });
-					debug("css handle: %s", file.path);
-					return { result: outputCss };
-				}
-			});
-			rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
-			pruneGulpProcessCache(cache, gulpProcessCacheKeys);
-		}, () => resolveGulpTransformTimingDetails(`css:${stage}`));
+	function rememberCompilationScope(sourceFile, scopeId) {
+		touchMapEntry(compilationScopeBySourceFile, node_path.default.resolve(sourceFile), scopeId);
+		while (compilationScopeBySourceFile.size > GULP_COMPILATION_SCOPE_CACHE_MAX) {
+			const oldestSourceFile = compilationScopeBySourceFile.keys().next().value;
+			if (typeof oldestSourceFile !== "string") break;
+			compilationScopeBySourceFile.delete(oldestSourceFile);
+		}
 	}
-	const generateWxss = (options = {}) => createWxssTransform(options, "generate");
-	const transformWxss = (options = {}) => createWxssTransform(options, "transform");
-	const adaptWxss = (options = {}) => createVinylTransform("css:adapt", async (file) => {
-		if (!file.contents) return;
-		const rawSource = file.contents.toString();
-		const generatedCss = require_hmr_timing.hasBundlerGeneratedCssMarker(rawSource);
-		const source = generatedCss ? require_hmr_timing.stripBundlerGeneratedCssMarkers(rawSource) : rawSource;
-		const styleOutputExtension = resolveGulpStyleOutputExtension(file);
-		const cssHandlerOptions = resolveWxssFileHandlerOptions(file, source, options);
-		const handled = await styleHandler(source, cssHandlerOptions);
-		const preflightMode = generatedCssPreflightModeByFile.get(file.path);
-		const finalized = generatedCss ? require_hmr_timing.finalizeMiniProgramGeneratorCss(handled.css, "weapp", runtimeState.tailwindRuntime.majorVersion, opts.cssPreflight, {
-			injectPreflight: preflightMode?.inject ?? cssHandlerOptions.isMainChunk,
-			preservePreflight: preflightMode?.preserve ?? cssHandlerOptions.isMainChunk,
-			styleOptions: cssHandlerOptions
-		}) : handled.css;
-		file.contents = node_buffer.Buffer.from((0, _weapp_tailwindcss_postcss.rewriteLocalCssImportRequestsForOutput)(finalized, { styleOutputExtension }));
-		debug("css adapt: %s", file.path);
-	}, () => resolveGulpTransformTimingDetails("css:adapt"));
-	const transformJs = (options = {}) => createVinylTransform("js", async (file) => {
-		if (!file.contents) return;
-		const filename = node_path.default.resolve(file.path);
-		const rawSource = file.contents.toString();
-		await refreshRuntimeSetForSource(file, rawSource, "js");
-		await runtimeState.readyPromise;
-		const moduleGraph = resolveModuleGraphOptions(options.moduleGraph);
-		const handlerOptions = {
-			...options,
-			generateMap: false,
-			filename,
-			moduleGraph,
-			babelParserOptions: {
-				...options?.babelParserOptions ?? {},
-				sourceFilename: filename
-			}
-		};
-		if (runtimeState.tailwindRuntime.majorVersion !== void 0) handlerOptions.tailwindcssMajorVersion = runtimeState.tailwindRuntime.majorVersion;
-		await require_hmr_timing.processCachedTask({
-			cache,
-			cacheKey: file.path,
-			rawSource,
-			applyResult(source) {
-				file.contents = node_buffer.Buffer.from(source);
-			},
-			onCacheHit() {
-				debug("js cache hit: %s", file.path);
-			},
-			async transform() {
-				await runtimeState.readyPromise;
-				const currentSource = file.contents?.toString() ?? rawSource;
-				if (require_context.shouldSkipJsTransform(currentSource, {
-					...handlerOptions,
-					classNameSet: runtimeSet
-				})) return { result: currentSource };
-				const { code } = await jsHandler(currentSource, runtimeSet, handlerOptions);
-				debug("js handle: %s", file.path);
-				return { result: code };
+	/** 记录 Gulp watcher 提交的源码或生成依赖变化。 */
+	async function watchChange(id, change = { event: "update" }) {
+		require_v4_generation_core.beginCompilerShadowRun(runtimeState);
+		const file = node_path.default.resolve(id);
+		const affectedScopes = require_v4_generation_core.recordCompilationDependencyChanges(runtimeState, require_v4_generation_core.createCompilationDependencyChanges([file]));
+		invalidateGulpSourceCandidates();
+		if (change.event === "delete") {
+			const removedRuntimeSource = runtimeSourcesByFile.delete(file);
+			const removedCssSource = require_generator.removeTailwindV4CssSource(opts, file);
+			const removedScopeId = compilationScopeBySourceFile.get(file);
+			if (removedScopeId) {
+				require_v4_generation_core.invalidateCompilationScope(runtimeState, removedScopeId);
+				compilationScopeBySourceFile.delete(file);
 			}
-		});
-		rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
-		pruneGulpProcessCache(cache, gulpProcessCacheKeys);
-	}, () => resolveGulpTransformTimingDetails("js"));
-	const transformWxml = (options = {}) => createVinylTransform("html", async (file) => {
-		if (!file.contents) return;
-		const rawSource = file.contents.toString();
-		await refreshRuntimeSetForSource(file, rawSource, "html");
-		await runtimeState.readyPromise;
-		await require_hmr_timing.processCachedTask({
-			cache,
-			cacheKey: file.path,
-			rawSource,
-			applyResult(source) {
-				file.contents = node_buffer.Buffer.from(source);
-			},
-			onCacheHit() {
-				debug("html cache hit: %s", file.path);
-			},
-			async transform() {
-				await runtimeState.readyPromise;
-				const code = await templateHandler(rawSource, resolveWxmlHandlerOptions(options));
-				debug("html handle: %s", file.path);
-				return { result: code };
+			require_hmr_timing.removeRuntimeCompilationBuildStateFiles(runtimeSnapshotState, [file]);
+			generatedCssPreflightModeByFile.delete(file);
+			gulpProcessCacheKeys.delete(file);
+			cache.instance.delete(file);
+			cache.hashMap.delete(file);
+			if (removedRuntimeSource || removedCssSource) {
+				runtimeSetInitialized = false;
+				runtimeSetDirty = true;
+				await bundleRuntimeClassSetManager.reset();
 			}
-		});
-		rememberGulpProcessCacheKey(gulpProcessCacheKeys, file.path);
-		pruneGulpProcessCache(cache, gulpProcessCacheKeys);
-	}, () => resolveGulpTransformTimingDetails("html"));
+		}
+		return affectedScopes;
+	}
 	return {
-		adaptWxss,
-		generateWxss,
-		transformWxss,
-		transformWxml,
-		transformJs
+		...createGulpFileTransforms({
+			cache,
+			createRuntimeSetHash,
+			debug,
+			generatedCssPreflightModeByFile,
+			getCompilationDependencyRevision: (scopeId) => require_v4_generation_core.getCompilationScopeDependencyRevision(runtimeState, scopeId),
+			getSourceCandidateGetter: () => cachedGulpSourceCandidateGetter,
+			getSourceCandidateSourceGetter: () => cachedGulpSourceCandidateSourceGetter,
+			getRuntimeSet: () => runtimeSet,
+			gulpProcessCacheKeys,
+			opts,
+			refreshGulpV4SourceCandidates,
+			refreshRuntimeSet,
+			refreshRuntimeSetForSource,
+			registerAutoCssSource,
+			rememberCompilationScope,
+			resolveGulpStyleOutputExtension,
+			resolveGulpTransformTimingDetails,
+			resolveModuleGraphOptions,
+			resolveWxmlHandlerOptions,
+			resolveWxssFileHandlerOptions,
+			resolveWxssUserHandlerOptions,
+			runtimeState
+		}),
+		beginCompilerShadowRun: () => require_v4_generation_core.beginCompilerShadowRun(runtimeState),
+		completeCompilerShadowRun: (revision) => require_hmr_timing.finalizeCompilerShadowRun(runtimeState, { revision }),
+		async dispose() {
+			await require_v4_generation_core.disposeCompilerOwner(runtimeState);
+			await bundleRuntimeClassSetManager.reset();
+		},
+		getCompilerShadowRunSnapshot: () => require_v4_generation_core.getCompilerShadowRunSnapshot(runtimeState),
+		watchChange
 	};
 }
 //#endregion