@bamboocss/vite 1.37.11 → 1.37.13

package/dist/index.cjs

@@ -94,6 +94,7 @@ const pruneStaticCss = (css, session, { prune = true } = {}) => {
 					if (!className || !prunable.has(className) || used.has(className)) return;
 					candidate.remove();
 					removedAny = true;
+					session.prunedClasses.add(className);
 				});
 			}).processSync(rule.selector);
 		} catch {
@@ -154,6 +155,56 @@ const pruneStaticCss = (css, session, { prune = true } = {}) => {
 	return root.toString();
 };
 //#endregion
+//#region src/static-session.ts
+const createStaticCompilationSession = () => {
+	const session = {
+		utilityLayer: "utilities",
+		sourcemap: false,
+		cssLoaded: false,
+		transformedFiles: /* @__PURE__ */ new Set(),
+		extractedFiles: /* @__PURE__ */ new Set(),
+		prunableClasses: /* @__PURE__ */ new Set(),
+		viewTransitionClasses: /* @__PURE__ */ new Set(),
+		usedClasses: /* @__PURE__ */ new Set(),
+		expectedEnvironments: void 0,
+		startedEnvironments: /* @__PURE__ */ new Set(),
+		prunedClasses: /* @__PURE__ */ new Set(),
+		markClassUsed(className) {
+			for (const token of className.split(" ")) {
+				if (!token) continue;
+				session.usedClasses.add(token.includes("\\") ? token : (0, _bamboocss_shared.esc)(token));
+			}
+		}
+	};
+	return session;
+};
+/**
+* Environments this run intends to build that have not been compiled yet.
+*
+* Empty means everything the run will contribute has been contributed, which is the condition
+* every whole-run judgement here waits for: pruning the stylesheet against reachability, and
+* the two guards that ask whether the compiled modules and the extraction graph agree. Each of
+* those is false about a build in progress and true only about a finished one.
+*
+* Empty is also the answer for a single-environment build, where nothing announced an
+* environment list because there is only ever one — so that path is unchanged.
+*
+* An environment a run declares and then never builds leaves this permanently non-empty, and
+* those judgements are skipped for the run. Every one of them errs towards shipping more CSS
+* or asserting less, so that is the safe direction to be wrong in.
+*/
+const remainingEnvironments = (session) => [...session.expectedEnvironments ?? []].filter((name) => !session.startedEnvironments.has(name));
+const resetStaticCompilationSession = (session) => {
+	session.cssLoaded = false;
+	session.transformedFiles.clear();
+	session.extractedFiles.clear();
+	session.prunableClasses.clear();
+	session.viewTransitionClasses.clear();
+	session.usedClasses.clear();
+	session.startedEnvironments.clear();
+	session.prunedClasses.clear();
+};
+//#endregion
 //#region src/css.ts
 /**
 * What a project imports to get the stylesheet.
@@ -262,11 +313,15 @@ const carriesGeneratedCss = (output) => output.type === "asset" && output.fileNa
 * hash is not cosmetic: it makes late graph reachability cache-safe.
 */
 const optimizeStaticCssAssets = (bundle, session, options = {}) => {
-	const { rename = true } = options;
+	const { rename = true, prune = true, sourcemap = session.sourcemap } = options;
+	/** Assets in this bundle that carry the generated stylesheet, pruned or not. */
+	let sheets = 0;
 	for (const output of Object.values(bundle)) {
 		if (!carriesGeneratedCss(output)) continue;
 		const source = typeof output.source === "string" ? output.source : Buffer.from(output.source).toString();
 		if (!source.includes("--made-with-bamboo")) continue;
+		sheets++;
+		if (!prune) continue;
 		const optimized = pruneStaticCss(source, session);
 		output.source = optimized;
 		if (optimized === source) continue;
@@ -279,8 +334,9 @@ const optimizeStaticCssAssets = (bundle, session, options = {}) => {
 		if (bundle[nextName] && bundle[nextName] !== output) throw new Error(`bamboocss: final CSS asset name collision at ${JSON.stringify(nextName)}.`);
 		const previous = output.fileName;
 		output.fileName = nextName;
-		replaceAssetReferences(bundle, previous, nextName, session.sourcemap);
+		replaceAssetReferences(bundle, previous, nextName, sourcemap);
 	}
+	return { sheets };
 };
 /**
 * Serve bamboo's stylesheet as a virtual module, in dev and in build.
@@ -356,9 +412,32 @@ const bamboocssCss = (options) => {
 	};
 	return {
 		name: "bamboocss:css",
+		/**
+		* One instance for every environment of a build, rather than one per environment.
+		*
+		* Vite re-reads the config file once per environment, so a project that lists this plugin
+		* in `vite.config.ts` — every project — got a *fresh* instance per environment, each with
+		* its own compilation session, context and ts-morph project. Nothing an environment
+		* established could then be seen by the next one, which is the premise the reachability
+		* accounting below is built on, and it also meant the whole config load and extraction
+		* happened once per environment.
+		*/
+		sharedDuringBuild: true,
 		configResolved(config) {
 			command = config.command;
 			session.sourcemap = config.build.sourcemap;
+			if (config.builder && config.environments) session.expectedEnvironments = new Set(Object.keys(config.environments));
+		},
+		/**
+		* The definitive environment list, for a run that reaches `builder.buildApp()` without
+		* configuring `builder` — the shape `vite build` itself takes, where exactly one
+		* environment is set up and pruning is therefore safe.
+		*/
+		buildApp: {
+			order: "pre",
+			async handler(builder) {
+				session.expectedEnvironments = new Set(Object.keys(builder.environments));
+			}
 		},
 		resolveId(id) {
 			const query = queryOf(id);
@@ -398,8 +477,34 @@ const bamboocssCss = (options) => {
 		generateBundle: {
 			order: "post",
 			handler(_, bundle) {
-				optimizeStaticCssAssets(bundle, session, { rename: renameCssAsset });
-				if (!servedEnvironments.has(this.environment?.name ?? "default")) return;
+				const environment = this.environment;
+				/**
+				* Every environment of this run has already had its modules compiled.
+				*
+				* Reachability is what pruning removes rules against, and it is only complete once
+				* nothing is left to contribute to it. The stylesheet is emitted and finalized by the
+				* environment that *imports* it, which in an SSR app is the client — and the client
+				* builds first, before the server environment has transformed a single module. Pruning
+				* there deletes every rule for a class only the server graph reaches, and the pages
+				* link the pruned copy: one project lost 39% of its atoms that way, presenting as
+				* rarely-used classes such as `md:{display:inline-block}` silently not applying.
+				*
+				* So the full extracted stylesheet ships instead, exactly as `renameCssAsset: false`
+				* already does. Being the last environment is not the common case — frameworks build
+				* the client first — but it is the only one where the answer is knowable, and a
+				* framework that builds its server bundle first does get pruned output.
+				*/
+				const pending = remainingEnvironments(session);
+				const { sheets } = optimizeStaticCssAssets(bundle, session, {
+					rename: renameCssAsset,
+					prune: pending.length === 0,
+					sourcemap: environment?.config?.build?.sourcemap
+				});
+				if (sheets && pending.length) _bamboocss_logger.logger.info("vite", `Reachability pruning skipped: the stylesheet is emitted by the ${JSON.stringify(environment?.name ?? "default")} environment, and ${(0, _bamboocss_shared.truncateList)(pending, {
+					unit: "environment",
+					separator: ", "
+				})} ${pending.length === 1 ? "has" : "have"} not been compiled in this run. The full extracted stylesheet ships — nothing is missing from it.`);
+				if (!servedEnvironments.has(environment?.name ?? "default")) return;
 				if (!session.transformedFiles.size) return;
 				if (!Object.values(bundle).some((output) => {
 					if (!carriesGeneratedCss(output)) return false;
@@ -2562,7 +2667,21 @@ const foldSource = (options) => {
 		const sourceFile = ownSourceFile ?? candidates[0]?.node.getSourceFile() ?? recipeDefinitions[0]?.call.getSourceFile();
 		if (!sourceFile) return;
 		const importedRecipeBindings = new Set(parserResult.importedRecipes?.keys() ?? []);
-		const identifiers = identifierIndex(sourceFile);
+		/**
+		* Every identifier in the module, grouped by the name it spells — built at most once per
+		* pass, and only when something below has a name to look up.
+		*
+		* One index answers for every binding, rather than a walk per binding. Built here rather
+		* than cached across passes: it holds nodes, and a node does not outlive its source file
+		* being replaced.
+		*
+		* Deferred because most modules in an app neither declare nor import a recipe, and the
+		* walk is not cheap — `getDescendantsOfKind` wraps every identifier in the file in a
+		* ts-morph node to answer a question those modules never ask. It was 11% of a 6,307-file
+		* build, most of it spent producing an index nothing read.
+		*/
+		let identifiers;
+		const identifiersByName = () => identifiers ??= identifierIndex(sourceFile);
 		for (const binding of new Set([...recipeConfigs.keys(), ...importedRecipeBindings])) {
 			const entry = recipeConfigs.get(binding);
 			if (entry === AMBIGUOUS) continue;
@@ -2570,7 +2689,7 @@ const foldSource = (options) => {
 			const definition = entry?.box?.getNode?.();
 			const nameNode = definition?.getSourceFile() === sourceFile ? definition?.getFirstAncestorByKind(ts_morph.SyntaxKind.VariableDeclaration)?.getNameNode() : importSpecifierFor(sourceFile, binding);
 			if (!nameNode || !ts_morph.Node.isIdentifier(nameNode)) continue;
-			const references = localReferencesTo(identifiers, binding, nameNode);
+			const references = localReferencesTo(identifiersByName(), binding, nameNode);
 			if (skipped.filter((item) => SURVIVES_TO_RUNTIME.has(item.reason) && item.end > item.start).some((item) => references.some((ref) => ref.getStart() >= item.start && ref.getStart() < item.end))) continue;
 			const survivor = references.find((ref) => !applied.some(([from, to]) => ref.getStart() >= from && ref.getStart() < to));
 			if (!survivor) continue;
@@ -2671,25 +2790,24 @@ const foldSource = (options) => {
 		}
 		if (watched.size === 0) return;
 		const declined = skipped.filter((entry) => SURVIVES_TO_RUNTIME.has(entry.reason) && entry.end > entry.start).map((entry) => [entry.start, entry.end]);
-		const reported = /* @__PURE__ */ new Set();
-		for (const identifier of sourceFile.getDescendantsOfKind(ts_morph.SyntaxKind.Identifier)) {
-			const local = identifier.getText();
-			const imported = watched.get(local);
-			if (imported === void 0 || reported.has(local)) continue;
+		const survivors = [];
+		for (const [local, imported] of watched) for (const identifier of identifiersByName().get(local) ?? []) {
 			const start = identifier.getStart();
 			if (identifier.getFirstAncestorByKind(ts_morph.SyntaxKind.ImportDeclaration)) continue;
 			if (applied.some(([from, to]) => start >= from && start < to)) continue;
 			if (declined.some(([from, to]) => start >= from && start < to)) continue;
 			if (!isValueReference(identifier)) continue;
 			if (isShadowed(identifier, local)) continue;
-			reported.add(local);
-			skipped.push({
+			survivors.push({
 				name: imported,
 				reason: "runtime-binding",
 				start,
 				end: identifier.getEnd()
 			});
+			break;
 		}
+		survivors.sort((a, b) => a.start - b.start);
+		skipped.push(...survivors);
 	}
 	if (reportSurvivors) reportRuntimeBindings();
 	if (folded.length === 0) return {
@@ -2771,35 +2889,6 @@ const createStaticStyleSetCompiler = (ctx, runtimeCss, allocateClassString = (cl
 	};
 };
 //#endregion
-//#region src/static-session.ts
-const createStaticCompilationSession = () => {
-	const session = {
-		utilityLayer: "utilities",
-		sourcemap: false,
-		cssLoaded: false,
-		transformedFiles: /* @__PURE__ */ new Set(),
-		extractedFiles: /* @__PURE__ */ new Set(),
-		prunableClasses: /* @__PURE__ */ new Set(),
-		viewTransitionClasses: /* @__PURE__ */ new Set(),
-		usedClasses: /* @__PURE__ */ new Set(),
-		markClassUsed(className) {
-			for (const token of className.split(" ")) {
-				if (!token) continue;
-				session.usedClasses.add(token.includes("\\") ? token : (0, _bamboocss_shared.esc)(token));
-			}
-		}
-	};
-	return session;
-};
-const resetStaticCompilationSession = (session) => {
-	session.cssLoaded = false;
-	session.transformedFiles.clear();
-	session.extractedFiles.clear();
-	session.prunableClasses.clear();
-	session.viewTransitionClasses.clear();
-	session.usedClasses.clear();
-};
-//#endregion
 //#region src/plugin.ts
 const DEFAULT_EXTENSIONS = /\.(?:[cm]?[jt]sx?)$/;
 const NODE_MODULES = /node_modules/;
@@ -2853,8 +2942,6 @@ const formatSkipped = (id, skipped) => {
 const bamboocss = (options = {}) => {
 	const { configPath, cwd, reportSkipped = false, reportSummary = true, maxRecipeStates, renameCssAsset = true } = options;
 	if (maxRecipeStates !== void 0 && (!Number.isSafeInteger(maxRecipeStates) || maxRecipeStates < 1)) throw new Error("bamboocss: `maxRecipeStates` must be a positive safe integer.");
-	/** Environments whose `buildStart` has run in the build currently in progress. */
-	const seenEnvironments = /* @__PURE__ */ new Set();
 	/** Totals across the build, for the summary. */
 	const totals = {
 		folded: 0,
@@ -2928,13 +3015,14 @@ const bamboocss = (options = {}) => {
 	}), {
 		name: "bamboocss:compiler",
 		enforce: "pre",
+		/** See the same declaration on the css plugin: one instance per build, not per environment. */
+		sharedDuringBuild: true,
 		configResolved(config) {
 			command = config.command;
 		},
 		async buildStart() {
 			const environment = this.environment?.name ?? "default";
-			if (seenEnvironments.has(environment)) {
-				seenEnvironments.clear();
+			if (staticSession.startedEnvironments.has(environment)) {
 				totals.folded = 0;
 				totals.files = 0;
 				totals.filesWithFolds = 0;
@@ -2943,7 +3031,7 @@ const bamboocss = (options = {}) => {
 				recipeConfigCache.clear();
 				resetStaticCompilationSession(staticSession);
 			}
-			seenEnvironments.add(environment);
+			staticSession.startedEnvironments.add(environment);
 			try {
 				await ensureContext();
 			} catch (error) {
@@ -3054,7 +3142,15 @@ const bamboocss = (options = {}) => {
 		buildEnd() {
 			const survivors = allSurvivors();
 			if (survivors.length) throw createSurvivorError(survivors);
-			if (typeof this.getModuleInfo === "function") {
+			const lost = [...staticSession.usedClasses].filter((className) => staticSession.prunedClasses.has(bare(className)));
+			if (lost.length) {
+				const environment = this.environment?.name ?? "default";
+				throw new Error(`bamboocss: ${lost.length} class(es) compiled in the ${JSON.stringify(environment)} environment were already pruned out of a stylesheet emitted by an earlier one. Elements carrying them would render unstyled.\n\n${(0, _bamboocss_shared.truncateList)(lost.map((className) => `  ${className}`), {
+					unit: "class",
+					separator: "\n"
+				})}\n\nThe stylesheet is finalized by the environment that imports it, so pruning it is only safe once every environment has been compiled. This build did not say how many there would be: it called \`builder.build(environment)\` directly. Run it through \`vite build\`, call \`builder.buildApp()\`, or set \`builder: {}\` in the Vite config so the environments are known before the first one builds. \`bamboocss({ renameCssAsset: false })\` also turns pruning off entirely.`);
+			}
+			if (typeof this.getModuleInfo === "function" && !remainingEnvironments(staticSession).length) {
 				if (!staticSession.cssLoaded) throw new Error(`bamboocss: compiled class values were produced, but ${JSON.stringify(VIRTUAL_CSS_ID)} was not imported. Add \`import ${JSON.stringify(VIRTUAL_CSS_ID)}\` once, from a JavaScript or TypeScript module in the application entry graph.\n\nIt has to be a JS import. \`@import\` from a stylesheet does not reach it: the id names a virtual module resolved by this plugin, and Vite resolves CSS \`@import\` before plugin resolution, so it fails as an unresolvable path. A project that ships one preloaded stylesheet imports this from its entry module instead, and lets Vite emit the CSS asset.`);
 				const outsideExtraction = [...staticSession.transformedFiles].filter((file) => !staticSession.extractedFiles.has(file));
 				if (outsideExtraction.length) throw new Error(`bamboocss: ${outsideExtraction.length} statically compiled module(s) are outside the CSS extraction graph:\n\n${(0, _bamboocss_shared.truncateList)(outsideExtraction.map((file) => `  ${file}`), {

package/dist/index.mjs

@@ -64,6 +64,7 @@ const pruneStaticCss = (css, session, { prune = true } = {}) => {
 					if (!className || !prunable.has(className) || used.has(className)) return;
 					candidate.remove();
 					removedAny = true;
+					session.prunedClasses.add(className);
 				});
 			}).processSync(rule.selector);
 		} catch {
@@ -124,6 +125,56 @@ const pruneStaticCss = (css, session, { prune = true } = {}) => {
 	return root.toString();
 };
 //#endregion
+//#region src/static-session.ts
+const createStaticCompilationSession = () => {
+	const session = {
+		utilityLayer: "utilities",
+		sourcemap: false,
+		cssLoaded: false,
+		transformedFiles: /* @__PURE__ */ new Set(),
+		extractedFiles: /* @__PURE__ */ new Set(),
+		prunableClasses: /* @__PURE__ */ new Set(),
+		viewTransitionClasses: /* @__PURE__ */ new Set(),
+		usedClasses: /* @__PURE__ */ new Set(),
+		expectedEnvironments: void 0,
+		startedEnvironments: /* @__PURE__ */ new Set(),
+		prunedClasses: /* @__PURE__ */ new Set(),
+		markClassUsed(className) {
+			for (const token of className.split(" ")) {
+				if (!token) continue;
+				session.usedClasses.add(token.includes("\\") ? token : esc(token));
+			}
+		}
+	};
+	return session;
+};
+/**
+* Environments this run intends to build that have not been compiled yet.
+*
+* Empty means everything the run will contribute has been contributed, which is the condition
+* every whole-run judgement here waits for: pruning the stylesheet against reachability, and
+* the two guards that ask whether the compiled modules and the extraction graph agree. Each of
+* those is false about a build in progress and true only about a finished one.
+*
+* Empty is also the answer for a single-environment build, where nothing announced an
+* environment list because there is only ever one — so that path is unchanged.
+*
+* An environment a run declares and then never builds leaves this permanently non-empty, and
+* those judgements are skipped for the run. Every one of them errs towards shipping more CSS
+* or asserting less, so that is the safe direction to be wrong in.
+*/
+const remainingEnvironments = (session) => [...session.expectedEnvironments ?? []].filter((name) => !session.startedEnvironments.has(name));
+const resetStaticCompilationSession = (session) => {
+	session.cssLoaded = false;
+	session.transformedFiles.clear();
+	session.extractedFiles.clear();
+	session.prunableClasses.clear();
+	session.viewTransitionClasses.clear();
+	session.usedClasses.clear();
+	session.startedEnvironments.clear();
+	session.prunedClasses.clear();
+};
+//#endregion
 //#region src/css.ts
 /**
 * What a project imports to get the stylesheet.
@@ -232,11 +283,15 @@ const carriesGeneratedCss = (output) => output.type === "asset" && output.fileNa
 * hash is not cosmetic: it makes late graph reachability cache-safe.
 */
 const optimizeStaticCssAssets = (bundle, session, options = {}) => {
-	const { rename = true } = options;
+	const { rename = true, prune = true, sourcemap = session.sourcemap } = options;
+	/** Assets in this bundle that carry the generated stylesheet, pruned or not. */
+	let sheets = 0;
 	for (const output of Object.values(bundle)) {
 		if (!carriesGeneratedCss(output)) continue;
 		const source = typeof output.source === "string" ? output.source : Buffer.from(output.source).toString();
 		if (!source.includes("--made-with-bamboo")) continue;
+		sheets++;
+		if (!prune) continue;
 		const optimized = pruneStaticCss(source, session);
 		output.source = optimized;
 		if (optimized === source) continue;
@@ -249,8 +304,9 @@ const optimizeStaticCssAssets = (bundle, session, options = {}) => {
 		if (bundle[nextName] && bundle[nextName] !== output) throw new Error(`bamboocss: final CSS asset name collision at ${JSON.stringify(nextName)}.`);
 		const previous = output.fileName;
 		output.fileName = nextName;
-		replaceAssetReferences(bundle, previous, nextName, session.sourcemap);
+		replaceAssetReferences(bundle, previous, nextName, sourcemap);
 	}
+	return { sheets };
 };
 /**
 * Serve bamboo's stylesheet as a virtual module, in dev and in build.
@@ -326,9 +382,32 @@ const bamboocssCss = (options) => {
 	};
 	return {
 		name: "bamboocss:css",
+		/**
+		* One instance for every environment of a build, rather than one per environment.
+		*
+		* Vite re-reads the config file once per environment, so a project that lists this plugin
+		* in `vite.config.ts` — every project — got a *fresh* instance per environment, each with
+		* its own compilation session, context and ts-morph project. Nothing an environment
+		* established could then be seen by the next one, which is the premise the reachability
+		* accounting below is built on, and it also meant the whole config load and extraction
+		* happened once per environment.
+		*/
+		sharedDuringBuild: true,
 		configResolved(config) {
 			command = config.command;
 			session.sourcemap = config.build.sourcemap;
+			if (config.builder && config.environments) session.expectedEnvironments = new Set(Object.keys(config.environments));
+		},
+		/**
+		* The definitive environment list, for a run that reaches `builder.buildApp()` without
+		* configuring `builder` — the shape `vite build` itself takes, where exactly one
+		* environment is set up and pruning is therefore safe.
+		*/
+		buildApp: {
+			order: "pre",
+			async handler(builder) {
+				session.expectedEnvironments = new Set(Object.keys(builder.environments));
+			}
 		},
 		resolveId(id) {
 			const query = queryOf(id);
@@ -368,8 +447,34 @@ const bamboocssCss = (options) => {
 		generateBundle: {
 			order: "post",
 			handler(_, bundle) {
-				optimizeStaticCssAssets(bundle, session, { rename: renameCssAsset });
-				if (!servedEnvironments.has(this.environment?.name ?? "default")) return;
+				const environment = this.environment;
+				/**
+				* Every environment of this run has already had its modules compiled.
+				*
+				* Reachability is what pruning removes rules against, and it is only complete once
+				* nothing is left to contribute to it. The stylesheet is emitted and finalized by the
+				* environment that *imports* it, which in an SSR app is the client — and the client
+				* builds first, before the server environment has transformed a single module. Pruning
+				* there deletes every rule for a class only the server graph reaches, and the pages
+				* link the pruned copy: one project lost 39% of its atoms that way, presenting as
+				* rarely-used classes such as `md:{display:inline-block}` silently not applying.
+				*
+				* So the full extracted stylesheet ships instead, exactly as `renameCssAsset: false`
+				* already does. Being the last environment is not the common case — frameworks build
+				* the client first — but it is the only one where the answer is knowable, and a
+				* framework that builds its server bundle first does get pruned output.
+				*/
+				const pending = remainingEnvironments(session);
+				const { sheets } = optimizeStaticCssAssets(bundle, session, {
+					rename: renameCssAsset,
+					prune: pending.length === 0,
+					sourcemap: environment?.config?.build?.sourcemap
+				});
+				if (sheets && pending.length) logger.info("vite", `Reachability pruning skipped: the stylesheet is emitted by the ${JSON.stringify(environment?.name ?? "default")} environment, and ${truncateList(pending, {
+					unit: "environment",
+					separator: ", "
+				})} ${pending.length === 1 ? "has" : "have"} not been compiled in this run. The full extracted stylesheet ships — nothing is missing from it.`);
+				if (!servedEnvironments.has(environment?.name ?? "default")) return;
 				if (!session.transformedFiles.size) return;
 				if (!Object.values(bundle).some((output) => {
 					if (!carriesGeneratedCss(output)) return false;
@@ -2532,7 +2637,21 @@ const foldSource = (options) => {
 		const sourceFile = ownSourceFile ?? candidates[0]?.node.getSourceFile() ?? recipeDefinitions[0]?.call.getSourceFile();
 		if (!sourceFile) return;
 		const importedRecipeBindings = new Set(parserResult.importedRecipes?.keys() ?? []);
-		const identifiers = identifierIndex(sourceFile);
+		/**
+		* Every identifier in the module, grouped by the name it spells — built at most once per
+		* pass, and only when something below has a name to look up.
+		*
+		* One index answers for every binding, rather than a walk per binding. Built here rather
+		* than cached across passes: it holds nodes, and a node does not outlive its source file
+		* being replaced.
+		*
+		* Deferred because most modules in an app neither declare nor import a recipe, and the
+		* walk is not cheap — `getDescendantsOfKind` wraps every identifier in the file in a
+		* ts-morph node to answer a question those modules never ask. It was 11% of a 6,307-file
+		* build, most of it spent producing an index nothing read.
+		*/
+		let identifiers;
+		const identifiersByName = () => identifiers ??= identifierIndex(sourceFile);
 		for (const binding of new Set([...recipeConfigs.keys(), ...importedRecipeBindings])) {
 			const entry = recipeConfigs.get(binding);
 			if (entry === AMBIGUOUS) continue;
@@ -2540,7 +2659,7 @@ const foldSource = (options) => {
 			const definition = entry?.box?.getNode?.();
 			const nameNode = definition?.getSourceFile() === sourceFile ? definition?.getFirstAncestorByKind(SyntaxKind.VariableDeclaration)?.getNameNode() : importSpecifierFor(sourceFile, binding);
 			if (!nameNode || !Node.isIdentifier(nameNode)) continue;
-			const references = localReferencesTo(identifiers, binding, nameNode);
+			const references = localReferencesTo(identifiersByName(), binding, nameNode);
 			if (skipped.filter((item) => SURVIVES_TO_RUNTIME.has(item.reason) && item.end > item.start).some((item) => references.some((ref) => ref.getStart() >= item.start && ref.getStart() < item.end))) continue;
 			const survivor = references.find((ref) => !applied.some(([from, to]) => ref.getStart() >= from && ref.getStart() < to));
 			if (!survivor) continue;
@@ -2641,25 +2760,24 @@ const foldSource = (options) => {
 		}
 		if (watched.size === 0) return;
 		const declined = skipped.filter((entry) => SURVIVES_TO_RUNTIME.has(entry.reason) && entry.end > entry.start).map((entry) => [entry.start, entry.end]);
-		const reported = /* @__PURE__ */ new Set();
-		for (const identifier of sourceFile.getDescendantsOfKind(SyntaxKind.Identifier)) {
-			const local = identifier.getText();
-			const imported = watched.get(local);
-			if (imported === void 0 || reported.has(local)) continue;
+		const survivors = [];
+		for (const [local, imported] of watched) for (const identifier of identifiersByName().get(local) ?? []) {
 			const start = identifier.getStart();
 			if (identifier.getFirstAncestorByKind(SyntaxKind.ImportDeclaration)) continue;
 			if (applied.some(([from, to]) => start >= from && start < to)) continue;
 			if (declined.some(([from, to]) => start >= from && start < to)) continue;
 			if (!isValueReference(identifier)) continue;
 			if (isShadowed(identifier, local)) continue;
-			reported.add(local);
-			skipped.push({
+			survivors.push({
 				name: imported,
 				reason: "runtime-binding",
 				start,
 				end: identifier.getEnd()
 			});
+			break;
 		}
+		survivors.sort((a, b) => a.start - b.start);
+		skipped.push(...survivors);
 	}
 	if (reportSurvivors) reportRuntimeBindings();
 	if (folded.length === 0) return {
@@ -2741,35 +2859,6 @@ const createStaticStyleSetCompiler = (ctx, runtimeCss, allocateClassString = (cl
 	};
 };
 //#endregion
-//#region src/static-session.ts
-const createStaticCompilationSession = () => {
-	const session = {
-		utilityLayer: "utilities",
-		sourcemap: false,
-		cssLoaded: false,
-		transformedFiles: /* @__PURE__ */ new Set(),
-		extractedFiles: /* @__PURE__ */ new Set(),
-		prunableClasses: /* @__PURE__ */ new Set(),
-		viewTransitionClasses: /* @__PURE__ */ new Set(),
-		usedClasses: /* @__PURE__ */ new Set(),
-		markClassUsed(className) {
-			for (const token of className.split(" ")) {
-				if (!token) continue;
-				session.usedClasses.add(token.includes("\\") ? token : esc(token));
-			}
-		}
-	};
-	return session;
-};
-const resetStaticCompilationSession = (session) => {
-	session.cssLoaded = false;
-	session.transformedFiles.clear();
-	session.extractedFiles.clear();
-	session.prunableClasses.clear();
-	session.viewTransitionClasses.clear();
-	session.usedClasses.clear();
-};
-//#endregion
 //#region src/plugin.ts
 const DEFAULT_EXTENSIONS = /\.(?:[cm]?[jt]sx?)$/;
 const NODE_MODULES = /node_modules/;
@@ -2823,8 +2912,6 @@ const formatSkipped = (id, skipped) => {
 const bamboocss = (options = {}) => {
 	const { configPath, cwd, reportSkipped = false, reportSummary = true, maxRecipeStates, renameCssAsset = true } = options;
 	if (maxRecipeStates !== void 0 && (!Number.isSafeInteger(maxRecipeStates) || maxRecipeStates < 1)) throw new Error("bamboocss: `maxRecipeStates` must be a positive safe integer.");
-	/** Environments whose `buildStart` has run in the build currently in progress. */
-	const seenEnvironments = /* @__PURE__ */ new Set();
 	/** Totals across the build, for the summary. */
 	const totals = {
 		folded: 0,
@@ -2898,13 +2985,14 @@ const bamboocss = (options = {}) => {
 	}), {
 		name: "bamboocss:compiler",
 		enforce: "pre",
+		/** See the same declaration on the css plugin: one instance per build, not per environment. */
+		sharedDuringBuild: true,
 		configResolved(config) {
 			command = config.command;
 		},
 		async buildStart() {
 			const environment = this.environment?.name ?? "default";
-			if (seenEnvironments.has(environment)) {
-				seenEnvironments.clear();
+			if (staticSession.startedEnvironments.has(environment)) {
 				totals.folded = 0;
 				totals.files = 0;
 				totals.filesWithFolds = 0;
@@ -2913,7 +3001,7 @@ const bamboocss = (options = {}) => {
 				recipeConfigCache.clear();
 				resetStaticCompilationSession(staticSession);
 			}
-			seenEnvironments.add(environment);
+			staticSession.startedEnvironments.add(environment);
 			try {
 				await ensureContext();
 			} catch (error) {
@@ -3024,7 +3112,15 @@ const bamboocss = (options = {}) => {
 		buildEnd() {
 			const survivors = allSurvivors();
 			if (survivors.length) throw createSurvivorError(survivors);
-			if (typeof this.getModuleInfo === "function") {
+			const lost = [...staticSession.usedClasses].filter((className) => staticSession.prunedClasses.has(bare(className)));
+			if (lost.length) {
+				const environment = this.environment?.name ?? "default";
+				throw new Error(`bamboocss: ${lost.length} class(es) compiled in the ${JSON.stringify(environment)} environment were already pruned out of a stylesheet emitted by an earlier one. Elements carrying them would render unstyled.\n\n${truncateList(lost.map((className) => `  ${className}`), {
+					unit: "class",
+					separator: "\n"
+				})}\n\nThe stylesheet is finalized by the environment that imports it, so pruning it is only safe once every environment has been compiled. This build did not say how many there would be: it called \`builder.build(environment)\` directly. Run it through \`vite build\`, call \`builder.buildApp()\`, or set \`builder: {}\` in the Vite config so the environments are known before the first one builds. \`bamboocss({ renameCssAsset: false })\` also turns pruning off entirely.`);
+			}
+			if (typeof this.getModuleInfo === "function" && !remainingEnvironments(staticSession).length) {
 				if (!staticSession.cssLoaded) throw new Error(`bamboocss: compiled class values were produced, but ${JSON.stringify(VIRTUAL_CSS_ID)} was not imported. Add \`import ${JSON.stringify(VIRTUAL_CSS_ID)}\` once, from a JavaScript or TypeScript module in the application entry graph.\n\nIt has to be a JS import. \`@import\` from a stylesheet does not reach it: the id names a virtual module resolved by this plugin, and Vite resolves CSS \`@import\` before plugin resolution, so it fails as an unresolvable path. A project that ships one preloaded stylesheet imports this from its entry module instead, and lets Vite emit the CSS asset.`);
 				const outsideExtraction = [...staticSession.transformedFiles].filter((file) => !staticSession.extractedFiles.has(file));
 				if (outsideExtraction.length) throw new Error(`bamboocss: ${outsideExtraction.length} statically compiled module(s) are outside the CSS extraction graph:\n\n${truncateList(outsideExtraction.map((file) => `  ${file}`), {

package/package.json

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