@bamboocss/vite 1.48.2 → 1.48.4

package/dist/index.cjs

@@ -200,6 +200,8 @@ const createCompilationHost = (options = {}) => {
 };
 //#endregion
 //#region src/static-session.ts
+/** Store one semantic class token in the selector spelling used by reachability sets. */
+const selectorClassName = (token) => token.includes("\\") ? token : (0, _bamboocss_shared.esc)(token);
 const createStaticCompilationSession = () => {
 	const session = {
 		utilityLayer: "utilities",
@@ -227,7 +229,7 @@ const createStaticCompilationSession = () => {
 		markClassUsed(className) {
 			for (const token of className.split(" ")) {
 				if (!token) continue;
-				session.usedClasses.add(token.includes("\\") ? token : (0, _bamboocss_shared.esc)(token));
+				session.usedClasses.add(selectorClassName(token));
 			}
 		}
 	};
@@ -875,10 +877,20 @@ const bamboocss = (options = {}) => {
 		] : null
 	]);
 	const transformArtifactIntegrity = (environment, artifact) => (0, node_crypto.createHmac)("sha256", transformArtifactIntegrityKey).update(serializeTransformArtifact(environment, artifact)).digest("base64url");
-	const sealTransformArtifact = (environment, artifact) => ({
-		...artifact,
-		integrity: transformArtifactIntegrity(environment, artifact)
-	});
+	const sealTransformArtifact = (environment, artifact) => {
+		const detached = {
+			...artifact,
+			skipped: artifact.skipped.map(([reason, count]) => [reason, count]),
+			survivors: artifact.survivors.map((survivor) => ({ ...survivor })),
+			classNames: [...artifact.classNames],
+			dependencies: [...artifact.dependencies],
+			...artifact.signature ? { signature: { ...artifact.signature } } : {}
+		};
+		return {
+			...detached,
+			integrity: transformArtifactIntegrity(environment, detached)
+		};
+	};
 	const skipReasons = new Set([
 		"dynamic",
 		"raw-call",
@@ -922,6 +934,11 @@ const bamboocss = (options = {}) => {
 		return /* @__PURE__ */ new Error(`bamboocss: cached transform metadata for ${JSON.stringify(id)} in the ${JSON.stringify(environment)} environment ${problem}.\n\nBamboo cannot safely rebuild from this entry because cached JavaScript may still name CSS classes whose rules would be dropped. Restart Vite to invalidate its in-memory transform cache. If this persists, clear Vite's cache directory and rebuild.`);
 	};
 	const transformStateByEnvironment = /* @__PURE__ */ new Map();
+	/** States currently materialized in the shared CSS session's reachability projection. */
+	const projectedTransformStates = /* @__PURE__ */ new Set();
+	const projectedUsedClassCounts = /* @__PURE__ */ new Map();
+	const projectedTransformedFileCounts = /* @__PURE__ */ new Map();
+	let projectedCssLoadedCount = 0;
 	/**
 	* One fold per file content per change event, shared across environments and hooks.
 	*
@@ -987,6 +1004,8 @@ const bamboocss = (options = {}) => {
 	const environmentName = (context) => environmentOf(context)?.name ?? "default";
 	const newEnvironmentState = () => ({
 		transformArtifactsByModule: /* @__PURE__ */ new Map(),
+		usedClassCounts: /* @__PURE__ */ new Map(),
+		transformedFileCounts: /* @__PURE__ */ new Map(),
 		dependentsByDependency: /* @__PURE__ */ new Map(),
 		dependenciesByModule: /* @__PURE__ */ new Map(),
 		filesByModule: /* @__PURE__ */ new Map(),
@@ -1001,6 +1020,8 @@ const bamboocss = (options = {}) => {
 	});
 	const cloneEnvironmentState = (state) => ({
 		transformArtifactsByModule: new Map(state.transformArtifactsByModule),
+		usedClassCounts: new Map(state.usedClassCounts),
+		transformedFileCounts: new Map(state.transformedFileCounts),
 		dependentsByDependency: new Map([...state.dependentsByDependency].map(([dependency, dependents]) => [dependency, new Set(dependents)])),
 		dependenciesByModule: new Map([...state.dependenciesByModule].map(([moduleId, dependencies]) => [moduleId, new Set(dependencies)])),
 		filesByModule: new Map(state.filesByModule),
@@ -1127,10 +1148,43 @@ const bamboocss = (options = {}) => {
 		if (!assets.length) return void 0;
 		return digest(JSON.stringify(assets.sort()));
 	};
-	/** Add one detached transform contribution to the global reachability projection. */
-	const applyStaticTransformContribution = (artifact) => {
-		if (artifact.transformedFile) staticSession.transformedFiles.add((0, node_path.resolve)(artifact.file));
-		for (const className of artifact.classNames) staticSession.markClassUsed(className);
+	const adjustContributionCount = (counts, value, delta) => {
+		const next = (counts.get(value) ?? 0) + delta;
+		if (next < 0) throw new Error(`bamboocss: internal contribution count underflow for ${JSON.stringify(value)}`);
+		if (next > 0) counts.set(value, next);
+		else counts.delete(value);
+		return next;
+	};
+	/** Update the projection index for one module contribution without scanning its siblings. */
+	const adjustTransformContribution = (state, artifact, delta) => {
+		if (artifact.transformedFile) adjustContributionCount(state.transformedFileCounts, (0, node_path.resolve)(artifact.file), delta);
+		for (const classNames of artifact.classNames) for (const token of classNames.split(" ")) if (token) adjustContributionCount(state.usedClassCounts, selectorClassName(token), delta);
+	};
+	const replaceTransformArtifact = (state, artifact) => {
+		const previous = state.transformArtifactsByModule.get(artifact.moduleId);
+		if (previous) adjustTransformContribution(state, previous, -1);
+		state.transformArtifactsByModule.set(artifact.moduleId, artifact);
+		adjustTransformContribution(state, artifact, 1);
+	};
+	const deleteTransformArtifact = (state, moduleId) => {
+		const previous = state.transformArtifactsByModule.get(moduleId);
+		if (!previous) return false;
+		adjustTransformContribution(state, previous, -1);
+		return state.transformArtifactsByModule.delete(moduleId);
+	};
+	const adjustProjectedTransformState = (state, delta) => {
+		for (const className of state.usedClassCounts.keys()) {
+			const next = adjustContributionCount(projectedUsedClassCounts, className, delta);
+			if (next === 1 && delta === 1) staticSession.usedClasses.add(className);
+			else if (next === 0) staticSession.usedClasses.delete(className);
+		}
+		for (const file of state.transformedFileCounts.keys()) {
+			const next = adjustContributionCount(projectedTransformedFileCounts, file, delta);
+			if (next === 1 && delta === 1) staticSession.transformedFiles.add(file);
+			else if (next === 0) staticSession.transformedFiles.delete(file);
+		}
+		if (state.cssLoaded) projectedCssLoadedCount += delta;
+		if (projectedCssLoadedCount < 0) throw new Error("bamboocss: internal stylesheet contribution count underflow");
 	};
 	/**
 	* Re-derive the two global sets CSS pruning consumes from environment-owned artifacts.
@@ -1157,13 +1211,12 @@ const bamboocss = (options = {}) => {
 		return states;
 	};
 	const rebuildStaticTransformContributions = (candidateEnvironment, candidateState) => {
-		staticSession.transformedFiles.clear();
-		staticSession.usedClasses.clear();
-		staticSession.cssLoaded = false;
-		for (const state of contributionStates(candidateEnvironment, candidateState)) {
-			if (state.cssLoaded) staticSession.cssLoaded = true;
-			for (const artifact of state.transformArtifactsByModule.values()) applyStaticTransformContribution(artifact);
-		}
+		const nextStates = new Set(contributionStates(candidateEnvironment, candidateState));
+		for (const state of projectedTransformStates) if (!nextStates.has(state)) adjustProjectedTransformState(state, -1);
+		for (const state of nextStates) if (!projectedTransformStates.has(state)) adjustProjectedTransformState(state, 1);
+		projectedTransformStates.clear();
+		for (const state of nextStates) projectedTransformStates.add(state);
+		staticSession.cssLoaded = projectedCssLoadedCount > 0;
 	};
 	/**
 	* Snapshot which reported classes Bamboo actually extracted for this JavaScript generation.
@@ -1175,9 +1228,8 @@ const bamboocss = (options = {}) => {
 	const ownedClassesForState = (state) => {
 		const extracted = new Map([...staticSession.prunableClasses].map((className) => [require_class_name.bare(className), className]));
 		const owned = /* @__PURE__ */ new Set();
-		for (const artifact of state.transformArtifactsByModule.values()) for (const reported of artifact.classNames) for (const token of reported.split(" ")) {
-			if (!token) continue;
-			const extractedClass = extracted.get(require_class_name.bare(token));
+		for (const className of state.usedClassCounts.keys()) {
+			const extractedClass = extracted.get(require_class_name.bare(className));
 			if (extractedClass !== void 0) owned.add(extractedClass);
 		}
 		return owned;
@@ -1408,18 +1460,10 @@ const bamboocss = (options = {}) => {
 		const reasons = Array.from(skipped.entries()).sort((a, b) => b[1] - a[1]).map(([reason, count]) => `${reason}=${count}`).join(" ");
 		_bamboocss_logger.logger.info("vite:transform", `Compiled ${folded}/${total} (${share}%) across ${filesWithFolds}/${perFile.size} files` + (reasons ? ` — declined: ${reasons}` : ""));
 	};
-	/** Restore every per-build fact established by one successful transform. */
-	const applyTransformArtifact = (state, value, expectedModuleId, environment) => {
-		let snapshot;
-		try {
-			snapshot = structuredClone(value);
-		} catch {
-			throw cachedArtifactError(expectedModuleId, environment, void 0, `could not be snapshotted as serializable schema version ${TRANSFORM_ARTIFACT_VERSION} data`);
-		}
-		if (!isTransformArtifact(snapshot) || snapshot.moduleId !== expectedModuleId || snapshot.file !== expectedModuleId.split("?")[0] || !hasValidTransformArtifactIntegrity(environment, snapshot)) throw cachedArtifactError(expectedModuleId, environment, snapshot);
-		const artifact = snapshot;
+	/** Apply every per-build fact established by one trusted or validated transform artifact. */
+	const commitTransformArtifact = (state, artifact) => {
 		const { file, moduleId } = artifact;
-		state.transformArtifactsByModule.set(moduleId, artifact);
+		replaceTransformArtifact(state, artifact);
 		recordFoldDependencies(state, moduleId, file, artifact.dependencies);
 		if (artifact.signature) state.foldSignatures.set(moduleId, artifact.signature);
 		else {
@@ -1427,6 +1471,17 @@ const bamboocss = (options = {}) => {
 			state.foldInputsByModule.delete(moduleId);
 		}
 	};
+	/** Snapshot and authenticate transform metadata owned by Rollup's external cache. */
+	const applyCachedTransformArtifact = (state, value, expectedModuleId, environment) => {
+		let snapshot;
+		try {
+			snapshot = structuredClone(value);
+		} catch {
+			throw cachedArtifactError(expectedModuleId, environment, void 0, `could not be snapshotted as serializable schema version ${TRANSFORM_ARTIFACT_VERSION} data`);
+		}
+		if (!isTransformArtifact(snapshot) || snapshot.moduleId !== expectedModuleId || snapshot.file !== expectedModuleId.split("?")[0] || !hasValidTransformArtifactIntegrity(environment, snapshot)) throw cachedArtifactError(expectedModuleId, environment, snapshot);
+		commitTransformArtifact(state, snapshot);
+	};
 	/**
 	* Replay transform metadata for modules Rollup reused from its cache.
 	*
@@ -1449,7 +1504,7 @@ const bamboocss = (options = {}) => {
 			const meta = pluginContext.getModuleInfo(id)?.meta;
 			if (!meta || !Object.prototype.hasOwnProperty.call(meta, TRANSFORM_META_KEY)) continue;
 			const artifact = meta[TRANSFORM_META_KEY];
-			applyTransformArtifact(state, artifact, id, environmentName(pluginContext));
+			applyCachedTransformArtifact(state, artifact, id, environmentName(pluginContext));
 		}
 	};
 	/**
@@ -2006,7 +2061,7 @@ const bamboocss = (options = {}) => {
 					recordFoldDependencies(state, moduleId, moduleFile, []);
 					state.foldSignatures.delete(moduleId);
 					state.foldInputsByModule.delete(moduleId);
-					state.transformArtifactsByModule.delete(moduleId);
+					deleteTransformArtifact(state, moduleId);
 					state.filesByModule.delete(moduleId);
 				}
 				return;
@@ -2233,7 +2288,7 @@ const bamboocss = (options = {}) => {
 			});
 			if (!compiled) return null;
 			if ("unparsed" in compiled) {
-				state.transformArtifactsByModule.delete(id);
+				deleteTransformArtifact(state, id);
 				recordFoldDependencies(state, id, filePath, []);
 				state.foldSignatures.delete(id);
 				state.foldInputsByModule.delete(id);
@@ -2246,8 +2301,7 @@ const bamboocss = (options = {}) => {
 			})), ...result.exportReads]);
 		} catch (error) {
 			_bamboocss_logger.logger.caughtError("vite:transform", `Failed to compile ${filePath}`, error);
-			const previousDependencies = [...state.dependenciesByModule.get(id) ?? []];
-			applyTransformArtifact(state, sealTransformArtifact(environmentName(this), {
+			commitTransformArtifact(state, {
 				version: TRANSFORM_ARTIFACT_VERSION,
 				moduleId: id,
 				file: filePath,
@@ -2260,8 +2314,8 @@ const bamboocss = (options = {}) => {
 				}],
 				transformedFile: false,
 				classNames: [],
-				dependencies: previousDependencies
-			}), id, environmentName(this));
+				dependencies: [...state.dependenciesByModule.get(id) ?? []]
+			});
 			state.foldSignatures.delete(id);
 			state.foldInputsByModule.delete(id);
 			if (command === "serve") throw asError(error, `failed to compile ${filePath}`);
@@ -2279,7 +2333,7 @@ const bamboocss = (options = {}) => {
 				reason: entry.reason
 			});
 		}
-		const artifact = sealTransformArtifact(environmentName(this), {
+		const artifact = {
 			version: TRANSFORM_ARTIFACT_VERSION,
 			moduleId: id,
 			file: filePath,
@@ -2294,8 +2348,8 @@ const bamboocss = (options = {}) => {
 				output: digest(result.code),
 				path: filePath
 			} } : {}
-		});
-		applyTransformArtifact(state, artifact, id, environmentName(this));
+		};
+		commitTransformArtifact(state, artifact);
 		if (artifact.signature && (command === "serve" || requestedParsePath !== filePath)) state.foldInputsByModule.set(id, {
 			code,
 			input: artifact.signature.input,
@@ -2312,7 +2366,7 @@ const bamboocss = (options = {}) => {
 				...survivor
 			})));
 		}
-		const meta = { [TRANSFORM_META_KEY]: artifact };
+		const meta = { [TRANSFORM_META_KEY]: sealTransformArtifact(environmentName(this), artifact) };
 		if (!result.folded.length) return typeof this.getModuleInfo === "function" ? {
 			code,
 			map: null,

package/dist/index.mjs

@@ -195,6 +195,8 @@ const createCompilationHost = (options = {}) => {
 };
 //#endregion
 //#region src/static-session.ts
+/** Store one semantic class token in the selector spelling used by reachability sets. */
+const selectorClassName = (token) => token.includes("\\") ? token : esc(token);
 const createStaticCompilationSession = () => {
 	const session = {
 		utilityLayer: "utilities",
@@ -222,7 +224,7 @@ const createStaticCompilationSession = () => {
 		markClassUsed(className) {
 			for (const token of className.split(" ")) {
 				if (!token) continue;
-				session.usedClasses.add(token.includes("\\") ? token : esc(token));
+				session.usedClasses.add(selectorClassName(token));
 			}
 		}
 	};
@@ -870,10 +872,20 @@ const bamboocss = (options = {}) => {
 		] : null
 	]);
 	const transformArtifactIntegrity = (environment, artifact) => createHmac("sha256", transformArtifactIntegrityKey).update(serializeTransformArtifact(environment, artifact)).digest("base64url");
-	const sealTransformArtifact = (environment, artifact) => ({
-		...artifact,
-		integrity: transformArtifactIntegrity(environment, artifact)
-	});
+	const sealTransformArtifact = (environment, artifact) => {
+		const detached = {
+			...artifact,
+			skipped: artifact.skipped.map(([reason, count]) => [reason, count]),
+			survivors: artifact.survivors.map((survivor) => ({ ...survivor })),
+			classNames: [...artifact.classNames],
+			dependencies: [...artifact.dependencies],
+			...artifact.signature ? { signature: { ...artifact.signature } } : {}
+		};
+		return {
+			...detached,
+			integrity: transformArtifactIntegrity(environment, detached)
+		};
+	};
 	const skipReasons = new Set([
 		"dynamic",
 		"raw-call",
@@ -917,6 +929,11 @@ const bamboocss = (options = {}) => {
 		return /* @__PURE__ */ new Error(`bamboocss: cached transform metadata for ${JSON.stringify(id)} in the ${JSON.stringify(environment)} environment ${problem}.\n\nBamboo cannot safely rebuild from this entry because cached JavaScript may still name CSS classes whose rules would be dropped. Restart Vite to invalidate its in-memory transform cache. If this persists, clear Vite's cache directory and rebuild.`);
 	};
 	const transformStateByEnvironment = /* @__PURE__ */ new Map();
+	/** States currently materialized in the shared CSS session's reachability projection. */
+	const projectedTransformStates = /* @__PURE__ */ new Set();
+	const projectedUsedClassCounts = /* @__PURE__ */ new Map();
+	const projectedTransformedFileCounts = /* @__PURE__ */ new Map();
+	let projectedCssLoadedCount = 0;
 	/**
 	* One fold per file content per change event, shared across environments and hooks.
 	*
@@ -982,6 +999,8 @@ const bamboocss = (options = {}) => {
 	const environmentName = (context) => environmentOf(context)?.name ?? "default";
 	const newEnvironmentState = () => ({
 		transformArtifactsByModule: /* @__PURE__ */ new Map(),
+		usedClassCounts: /* @__PURE__ */ new Map(),
+		transformedFileCounts: /* @__PURE__ */ new Map(),
 		dependentsByDependency: /* @__PURE__ */ new Map(),
 		dependenciesByModule: /* @__PURE__ */ new Map(),
 		filesByModule: /* @__PURE__ */ new Map(),
@@ -996,6 +1015,8 @@ const bamboocss = (options = {}) => {
 	});
 	const cloneEnvironmentState = (state) => ({
 		transformArtifactsByModule: new Map(state.transformArtifactsByModule),
+		usedClassCounts: new Map(state.usedClassCounts),
+		transformedFileCounts: new Map(state.transformedFileCounts),
 		dependentsByDependency: new Map([...state.dependentsByDependency].map(([dependency, dependents]) => [dependency, new Set(dependents)])),
 		dependenciesByModule: new Map([...state.dependenciesByModule].map(([moduleId, dependencies]) => [moduleId, new Set(dependencies)])),
 		filesByModule: new Map(state.filesByModule),
@@ -1122,10 +1143,43 @@ const bamboocss = (options = {}) => {
 		if (!assets.length) return void 0;
 		return digest(JSON.stringify(assets.sort()));
 	};
-	/** Add one detached transform contribution to the global reachability projection. */
-	const applyStaticTransformContribution = (artifact) => {
-		if (artifact.transformedFile) staticSession.transformedFiles.add(resolve(artifact.file));
-		for (const className of artifact.classNames) staticSession.markClassUsed(className);
+	const adjustContributionCount = (counts, value, delta) => {
+		const next = (counts.get(value) ?? 0) + delta;
+		if (next < 0) throw new Error(`bamboocss: internal contribution count underflow for ${JSON.stringify(value)}`);
+		if (next > 0) counts.set(value, next);
+		else counts.delete(value);
+		return next;
+	};
+	/** Update the projection index for one module contribution without scanning its siblings. */
+	const adjustTransformContribution = (state, artifact, delta) => {
+		if (artifact.transformedFile) adjustContributionCount(state.transformedFileCounts, resolve(artifact.file), delta);
+		for (const classNames of artifact.classNames) for (const token of classNames.split(" ")) if (token) adjustContributionCount(state.usedClassCounts, selectorClassName(token), delta);
+	};
+	const replaceTransformArtifact = (state, artifact) => {
+		const previous = state.transformArtifactsByModule.get(artifact.moduleId);
+		if (previous) adjustTransformContribution(state, previous, -1);
+		state.transformArtifactsByModule.set(artifact.moduleId, artifact);
+		adjustTransformContribution(state, artifact, 1);
+	};
+	const deleteTransformArtifact = (state, moduleId) => {
+		const previous = state.transformArtifactsByModule.get(moduleId);
+		if (!previous) return false;
+		adjustTransformContribution(state, previous, -1);
+		return state.transformArtifactsByModule.delete(moduleId);
+	};
+	const adjustProjectedTransformState = (state, delta) => {
+		for (const className of state.usedClassCounts.keys()) {
+			const next = adjustContributionCount(projectedUsedClassCounts, className, delta);
+			if (next === 1 && delta === 1) staticSession.usedClasses.add(className);
+			else if (next === 0) staticSession.usedClasses.delete(className);
+		}
+		for (const file of state.transformedFileCounts.keys()) {
+			const next = adjustContributionCount(projectedTransformedFileCounts, file, delta);
+			if (next === 1 && delta === 1) staticSession.transformedFiles.add(file);
+			else if (next === 0) staticSession.transformedFiles.delete(file);
+		}
+		if (state.cssLoaded) projectedCssLoadedCount += delta;
+		if (projectedCssLoadedCount < 0) throw new Error("bamboocss: internal stylesheet contribution count underflow");
 	};
 	/**
 	* Re-derive the two global sets CSS pruning consumes from environment-owned artifacts.
@@ -1152,13 +1206,12 @@ const bamboocss = (options = {}) => {
 		return states;
 	};
 	const rebuildStaticTransformContributions = (candidateEnvironment, candidateState) => {
-		staticSession.transformedFiles.clear();
-		staticSession.usedClasses.clear();
-		staticSession.cssLoaded = false;
-		for (const state of contributionStates(candidateEnvironment, candidateState)) {
-			if (state.cssLoaded) staticSession.cssLoaded = true;
-			for (const artifact of state.transformArtifactsByModule.values()) applyStaticTransformContribution(artifact);
-		}
+		const nextStates = new Set(contributionStates(candidateEnvironment, candidateState));
+		for (const state of projectedTransformStates) if (!nextStates.has(state)) adjustProjectedTransformState(state, -1);
+		for (const state of nextStates) if (!projectedTransformStates.has(state)) adjustProjectedTransformState(state, 1);
+		projectedTransformStates.clear();
+		for (const state of nextStates) projectedTransformStates.add(state);
+		staticSession.cssLoaded = projectedCssLoadedCount > 0;
 	};
 	/**
 	* Snapshot which reported classes Bamboo actually extracted for this JavaScript generation.
@@ -1170,9 +1223,8 @@ const bamboocss = (options = {}) => {
 	const ownedClassesForState = (state) => {
 		const extracted = new Map([...staticSession.prunableClasses].map((className) => [bare(className), className]));
 		const owned = /* @__PURE__ */ new Set();
-		for (const artifact of state.transformArtifactsByModule.values()) for (const reported of artifact.classNames) for (const token of reported.split(" ")) {
-			if (!token) continue;
-			const extractedClass = extracted.get(bare(token));
+		for (const className of state.usedClassCounts.keys()) {
+			const extractedClass = extracted.get(bare(className));
 			if (extractedClass !== void 0) owned.add(extractedClass);
 		}
 		return owned;
@@ -1403,18 +1455,10 @@ const bamboocss = (options = {}) => {
 		const reasons = Array.from(skipped.entries()).sort((a, b) => b[1] - a[1]).map(([reason, count]) => `${reason}=${count}`).join(" ");
 		logger.info("vite:transform", `Compiled ${folded}/${total} (${share}%) across ${filesWithFolds}/${perFile.size} files` + (reasons ? ` — declined: ${reasons}` : ""));
 	};
-	/** Restore every per-build fact established by one successful transform. */
-	const applyTransformArtifact = (state, value, expectedModuleId, environment) => {
-		let snapshot;
-		try {
-			snapshot = structuredClone(value);
-		} catch {
-			throw cachedArtifactError(expectedModuleId, environment, void 0, `could not be snapshotted as serializable schema version ${TRANSFORM_ARTIFACT_VERSION} data`);
-		}
-		if (!isTransformArtifact(snapshot) || snapshot.moduleId !== expectedModuleId || snapshot.file !== expectedModuleId.split("?")[0] || !hasValidTransformArtifactIntegrity(environment, snapshot)) throw cachedArtifactError(expectedModuleId, environment, snapshot);
-		const artifact = snapshot;
+	/** Apply every per-build fact established by one trusted or validated transform artifact. */
+	const commitTransformArtifact = (state, artifact) => {
 		const { file, moduleId } = artifact;
-		state.transformArtifactsByModule.set(moduleId, artifact);
+		replaceTransformArtifact(state, artifact);
 		recordFoldDependencies(state, moduleId, file, artifact.dependencies);
 		if (artifact.signature) state.foldSignatures.set(moduleId, artifact.signature);
 		else {
@@ -1422,6 +1466,17 @@ const bamboocss = (options = {}) => {
 			state.foldInputsByModule.delete(moduleId);
 		}
 	};
+	/** Snapshot and authenticate transform metadata owned by Rollup's external cache. */
+	const applyCachedTransformArtifact = (state, value, expectedModuleId, environment) => {
+		let snapshot;
+		try {
+			snapshot = structuredClone(value);
+		} catch {
+			throw cachedArtifactError(expectedModuleId, environment, void 0, `could not be snapshotted as serializable schema version ${TRANSFORM_ARTIFACT_VERSION} data`);
+		}
+		if (!isTransformArtifact(snapshot) || snapshot.moduleId !== expectedModuleId || snapshot.file !== expectedModuleId.split("?")[0] || !hasValidTransformArtifactIntegrity(environment, snapshot)) throw cachedArtifactError(expectedModuleId, environment, snapshot);
+		commitTransformArtifact(state, snapshot);
+	};
 	/**
 	* Replay transform metadata for modules Rollup reused from its cache.
 	*
@@ -1444,7 +1499,7 @@ const bamboocss = (options = {}) => {
 			const meta = pluginContext.getModuleInfo(id)?.meta;
 			if (!meta || !Object.prototype.hasOwnProperty.call(meta, TRANSFORM_META_KEY)) continue;
 			const artifact = meta[TRANSFORM_META_KEY];
-			applyTransformArtifact(state, artifact, id, environmentName(pluginContext));
+			applyCachedTransformArtifact(state, artifact, id, environmentName(pluginContext));
 		}
 	};
 	/**
@@ -2001,7 +2056,7 @@ const bamboocss = (options = {}) => {
 					recordFoldDependencies(state, moduleId, moduleFile, []);
 					state.foldSignatures.delete(moduleId);
 					state.foldInputsByModule.delete(moduleId);
-					state.transformArtifactsByModule.delete(moduleId);
+					deleteTransformArtifact(state, moduleId);
 					state.filesByModule.delete(moduleId);
 				}
 				return;
@@ -2228,7 +2283,7 @@ const bamboocss = (options = {}) => {
 			});
 			if (!compiled) return null;
 			if ("unparsed" in compiled) {
-				state.transformArtifactsByModule.delete(id);
+				deleteTransformArtifact(state, id);
 				recordFoldDependencies(state, id, filePath, []);
 				state.foldSignatures.delete(id);
 				state.foldInputsByModule.delete(id);
@@ -2241,8 +2296,7 @@ const bamboocss = (options = {}) => {
 			})), ...result.exportReads]);
 		} catch (error) {
 			logger.caughtError("vite:transform", `Failed to compile ${filePath}`, error);
-			const previousDependencies = [...state.dependenciesByModule.get(id) ?? []];
-			applyTransformArtifact(state, sealTransformArtifact(environmentName(this), {
+			commitTransformArtifact(state, {
 				version: TRANSFORM_ARTIFACT_VERSION,
 				moduleId: id,
 				file: filePath,
@@ -2255,8 +2309,8 @@ const bamboocss = (options = {}) => {
 				}],
 				transformedFile: false,
 				classNames: [],
-				dependencies: previousDependencies
-			}), id, environmentName(this));
+				dependencies: [...state.dependenciesByModule.get(id) ?? []]
+			});
 			state.foldSignatures.delete(id);
 			state.foldInputsByModule.delete(id);
 			if (command === "serve") throw asError(error, `failed to compile ${filePath}`);
@@ -2274,7 +2328,7 @@ const bamboocss = (options = {}) => {
 				reason: entry.reason
 			});
 		}
-		const artifact = sealTransformArtifact(environmentName(this), {
+		const artifact = {
 			version: TRANSFORM_ARTIFACT_VERSION,
 			moduleId: id,
 			file: filePath,
@@ -2289,8 +2343,8 @@ const bamboocss = (options = {}) => {
 				output: digest(result.code),
 				path: filePath
 			} } : {}
-		});
-		applyTransformArtifact(state, artifact, id, environmentName(this));
+		};
+		commitTransformArtifact(state, artifact);
 		if (artifact.signature && (command === "serve" || requestedParsePath !== filePath)) state.foldInputsByModule.set(id, {
 			code,
 			input: artifact.signature.input,
@@ -2307,7 +2361,7 @@ const bamboocss = (options = {}) => {
 				...survivor
 			})));
 		}
-		const meta = { [TRANSFORM_META_KEY]: artifact };
+		const meta = { [TRANSFORM_META_KEY]: sealTransformArtifact(environmentName(this), artifact) };
 		if (!result.folded.length) return typeof this.getModuleInfo === "function" ? {
 			code,
 			map: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/vite",
-  "version": "1.48.2",
+  "version": "1.48.4",
   "description": "Vite integration for Bamboo CSS",
   "homepage": "https://bamboocss.com",
   "license": "MIT",
@@ -42,18 +42,18 @@
     "postcss": "8.5.26",
     "postcss-selector-parser": "7.1.5",
     "ts-morph": "28.0.0",
-    "@bamboocss/config": "1.48.2",
-    "@bamboocss/core": "1.48.2",
-    "@bamboocss/logger": "1.48.2",
-    "@bamboocss/extractor": "1.48.2",
-    "@bamboocss/node": "1.48.2",
-    "@bamboocss/types": "1.48.2",
-    "@bamboocss/shared": "1.48.2"
+    "@bamboocss/config": "1.48.4",
+    "@bamboocss/core": "1.48.4",
+    "@bamboocss/node": "1.48.4",
+    "@bamboocss/extractor": "1.48.4",
+    "@bamboocss/logger": "1.48.4",
+    "@bamboocss/types": "1.48.4",
+    "@bamboocss/shared": "1.48.4"
   },
   "devDependencies": {
     "@jridgewell/trace-mapping": "^0.3.31",
     "vite": "7.2.6",
-    "@bamboocss/fixture": "1.48.2"
+    "@bamboocss/fixture": "1.48.4"
   },
   "peerDependencies": {
     "vite": ">=5"