@animus-ui/next-plugin 0.1.25 → 0.1.26

package/dist/index.mjs

@@ -1,9 +1,31 @@
-import { a as resolveTurbopackMode, i as resolveTurbopackLoaderPath, n as buildTurbopackConfig, o as turbopackSideEffectsLimits, r as isTurbopackDevelopment, s as resolveAnimusLoaderPath, t as ANIMUS_TURBOPACK_RULE_GLOB } from "./turbopack-config-BdfqxwT0.mjs";
-import { assembleStylesheet, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, isEngineTransformExtension, isPathWithinRoot, keepsKitSourceEffects, readTsconfigAliasPairs, resolveMode, sourceKitDependencies } from "@animus-ui/extract/pipeline";
-import { ANIMUS_CSS_MODULE_ID, ANIMUS_CSS_MODULE_ID as ANIMUS_CSS_MODULE_ID$1, ExtractionSession, TURBOPACK_SYSTEM_PROPS_ID, getAnalysisStartedPromise, getReplacementEpoch, getSharedCss, getSharedExternalDirs, getSharedExternalEntries, getSharedExternalSideEffects, replacementEpochPath, resetAnalysisStartedPromise, runSessionPipeline, sessionArtifactDir, setAnalysisStartedPromise, setSharedEngine, startTurbopackWatcher, stylesPath, systemPropsPath } from "@animus-ui/extract/session";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
+import { a as resolveTurbopackMode, i as resolveTurbopackLoaderPath, n as buildTurbopackConfig, o as turbopackSideEffectsLimits, r as isTurbopackDevelopment, s as resolveAnimusLoaderPath, t as ANIMUS_TURBOPACK_RULE_GLOB } from "./turbopack-config-3jtLDAIM.mjs";
+import { AnimusConfigError, assembleStylesheet, assertKnownOptionKeys, assertSupportedEngine, buildPathAliasesJson, builtInAssetClassification, isEngineTransformExtension, isPathWithinRoot, keepsKitSourceEffects, nextImageAssetClassification, outputExclusion, resolveMode, sourceKitDependencies, turbopackExtensionPolicy, webpackExtensionPolicy } from "@animus-ui/extract/pipeline";
+import { ANIMUS_CSS_MODULE_ID, ANIMUS_CSS_MODULE_ID as ANIMUS_CSS_MODULE_ID$1, ExtractionSession, TURBOPACK_SYSTEM_PROPS_ID, createBuildId, getAnalysisStartedPromise, getReplacementEpoch, getSharedCss, getSharedExternalDirs, getSharedExternalEntries, getSharedExternalSideEffects, replacementEpochPath, requireEngine, resetAnalysisStartedPromise, runSessionPipeline, sessionArtifactDir, setAnalysisStartedPromise, startTurbopackWatcher, stylesPath, systemPropsPath } from "@animus-ui/extract/session";
+import { existsSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync } from "fs";
+import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
+//#region src/same-directory.ts
+/** Whether two paths name one directory: by real path, which resolves a
+*  trailing slash, a symlink and the filesystem's own spelling, else by
+*  device and inode. */
+function sameDirectory(a, b) {
+	const real = (path) => {
+		try {
+			return realpathSync.native(path);
+		} catch {
+			return resolve(path);
+		}
+	};
+	if (real(a) === real(b)) return true;
+	try {
+		const left = statSync(a);
+		const right = statSync(b);
+		return left.dev === right.dev && left.ino === right.ino;
+	} catch {
+		return false;
+	}
+}
+//#endregion
 //#region src/plugin.ts
 /** The value arrives from a consumer's `next.config`, so the union above is a
 *  model of what webpack accepts, not a proof about the value in hand. */
@@ -15,6 +37,9 @@ var AnimusWebpackPlugin = class {
 	options;
 	session;
 	initialized = false;
+	/** Left its build: the next turn joins again and catches up, retried
+	*  until it succeeds, never reusing the startup it already consumed. */
+	rejoining = false;
 	aliasesExtracted = false;
 	animusLoaderPaths;
 	lastBuiltEpoch = null;
@@ -24,11 +49,10 @@ var AnimusWebpackPlugin = class {
 	watchFailure = null;
 	/** `development` is `next dev`: an error-level diagnostic reports and the
 	*  compilation keeps publishing, whatever the emission mode. */
-	constructor(options, { development = false } = {}) {
+	constructor(options, { development = false, build } = {}) {
 		this.options = options;
-		assertNoRetiredEngineSelection(options.engine);
-		setSharedEngine(options.engine ?? "v2");
-		this.session = new ExtractionSession(options);
+		assertSupportedEngine(options.engine);
+		this.session = new ExtractionSession(options, { build });
 		this.session.development = development;
 		this.session.systemPropsModuleId = TURBOPACK_SYSTEM_PROPS_ID;
 		this.animusLoaderPaths = /* @__PURE__ */ new Set([resolveAnimusLoaderPath()]);
@@ -54,10 +78,18 @@ var AnimusWebpackPlugin = class {
 		else if (isWatchIgnoreMatcher(ignored)) watchOptions.ignored = (path) => path === epochPath || Boolean(ignored(path));
 	}
 	/** Webpack's export conditions select the system's kit files as they
-	*  select the bundle's; `...`, webpack's own defaults, names none. */
+	*  select the bundle's; `...`, webpack's own defaults, names none. Its
+	*  extension order and aliases are captured alongside. */
 	extractConditions(compiler) {
-		const names = compiler.options?.resolve?.conditionNames ?? [];
+		const resolve = compiler.options?.resolve;
+		const names = resolve?.conditionNames ?? [];
 		this.session.conditions = names.filter((name) => name !== "...");
+		const resolverFactory = compiler.resolverFactory;
+		if (resolverFactory !== void 0) this.session.hostResolve = (specifier, importer) => new Promise((done) => {
+			resolverFactory.get("normal", { dependencyType: "esm" }).resolve({}, importer === void 0 ? compiler.context : dirname(importer), specifier, {}, (error, result) => done(error !== null || !result ? null : result));
+		});
+		this.session.assetClassification = builtInAssetClassification("hostOptionUnreadable", "next-webpack rules not modelled");
+		this.session.extensionPolicy = webpackExtensionPolicy("next-webpack", resolve ?? {}, compiler.webpack?.version);
 	}
 	extractAliases(compiler) {
 		if (this.aliasesExtracted) return;
@@ -81,6 +113,13 @@ var AnimusWebpackPlugin = class {
 		if (built) this.session.pathAliasesJson = built.json;
 	}
 	apply(compiler) {
+		const leave = () => {
+			this.session.close();
+			this.initialized = false;
+			this.rejoining = true;
+		};
+		compiler.hooks.shutdown?.tap(PLUGIN_NAME, leave);
+		compiler.hooks.watchClose?.tap(PLUGIN_NAME, leave);
 		if (compiler.options?.name === "edge-server") return;
 		const NormalModule = compiler.webpack?.NormalModule;
 		if (NormalModule?.getCompilationHooks === void 0) throw new Error(UNSUPPORTED_WEBPACK_MESSAGE);
@@ -103,6 +142,7 @@ var AnimusWebpackPlugin = class {
 			const registerSystemDependencies = () => {
 				for (const dep of this.session.systemDependencyPaths) if (existsSync(dep)) compilation.fileDependencies.add(dep);
 				else compilation.missingDependencies.add(dep);
+				for (const path of this.session.systemMissingPaths) compilation.missingDependencies.add(path);
 				for (const dep of this.session.assetDependencyPaths) if (existsSync(dep)) compilation.fileDependencies.add(dep);
 				else compilation.missingDependencies.add(dep);
 				for (const root of this.session.externalWatchRoots) compilation.contextDependencies.add(root);
@@ -115,7 +155,7 @@ var AnimusWebpackPlugin = class {
 				stage
 			}, () => {
 				registerSystemDependencies();
-				const css = getSharedCss();
+				const css = this.session.rootDir ? getSharedCss(this.session.key) : "";
 				if (!css || !RawSource) return;
 				const rootDir = this.session.rootDir || compiler.context;
 				const cssPath = stylesPath(sessionArtifactDir(rootDir, this.session.sessionId));
@@ -130,13 +170,18 @@ var AnimusWebpackPlugin = class {
 			this.adoptCompilerContext(_compiler);
 			this.extractAliases(_compiler);
 			this.extractConditions(_compiler);
-			const existing = getAnalysisStartedPromise();
+			if (await this.rejoin()) {
+				this.session.agreeWithSystemAuthority();
+				return;
+			}
+			const existing = getAnalysisStartedPromise(this.session.key);
 			if (existing) {
 				await existing;
+				this.session.agreeWithSystemAuthority();
 				return;
 			}
 			const promise = this.session.runFullPipeline();
-			setAnalysisStartedPromise(promise);
+			setAnalysisStartedPromise(this.session.key, promise);
 			await promise;
 		});
 		compiler.hooks.watchRun.tapPromise(PLUGIN_NAME, async (_compiler) => {
@@ -153,21 +198,38 @@ var AnimusWebpackPlugin = class {
 	}
 	/** Rejects with the analysis error; the published generation stays the
 	*  last successful one. */
+	/** Joins the build this compiler left and catches up with it: true when
+	*  the build was live, false when it starts as at first. */
+	async rejoin() {
+		if (!this.rejoining) return false;
+		this.session.reattach();
+		const live = await this.session.catchUp();
+		this.rejoining = false;
+		return live;
+	}
 	async analyzeWatchTurn(compiler) {
+		if (!this.initialized && await this.rejoin()) {
+			this.session.agreeWithSystemAuthority();
+			this.initialized = true;
+			this.lastBuiltEpoch = getReplacementEpoch(this.session.key);
+			this.epochMovedForNextCompilation = true;
+			return;
+		}
 		if (!this.initialized) {
-			let startup = getAnalysisStartedPromise();
+			let startup = getAnalysisStartedPromise(this.session.key);
 			if (!startup) {
 				startup = this.session.runFullPipeline();
-				setAnalysisStartedPromise(startup);
+				setAnalysisStartedPromise(this.session.key, startup);
 			}
 			try {
 				await startup;
 			} catch (err) {
-				if (getAnalysisStartedPromise() === startup) resetAnalysisStartedPromise();
+				if (getAnalysisStartedPromise(this.session.key) === startup) resetAnalysisStartedPromise(this.session.key);
 				throw err;
 			}
+			this.session.agreeWithSystemAuthority();
 			this.initialized = true;
-			this.lastBuiltEpoch = getReplacementEpoch();
+			this.lastBuiltEpoch = getReplacementEpoch(this.session.key);
 			this.epochMovedForNextCompilation = this.watchFailure !== null;
 			return;
 		}
@@ -175,7 +237,8 @@ var AnimusWebpackPlugin = class {
 			modifiedFiles: compiler.modifiedFiles,
 			removedFiles: compiler.removedFiles
 		});
-		const epoch = getReplacementEpoch();
+		this.session.agreeWithSystemAuthority();
+		const epoch = getReplacementEpoch(this.session.key);
 		this.epochMovedForNextCompilation = this.lastBuiltEpoch !== null && epoch !== null && epoch !== this.lastBuiltEpoch;
 		if (epoch !== null) this.lastBuiltEpoch = epoch;
 	}
@@ -188,21 +251,23 @@ var AnimusWebpackPlugin = class {
 	setRootDir(rootDir) {
 		this.session.rootDir = rootDir;
 	}
-	warnedRootDivergence = false;
+	/** Keeps Next's output directory out of discovery, whatever the user's
+	*  exclude list says. Call after `setRootDir`. */
+	excludeOutputDir(outDir) {
+		const pattern = outputExclusion(this.session.rootDir, outDir);
+		if (pattern !== null) this.session.structuralExclude = [pattern];
+	}
 	/** Adopts `compiler.context` only when no config-time root exists: every
 	*  frozen derivation came from that root, so an overwrite re-keys it.
 	*  Stub path, css alias, virtual system-props target and watch-ignore are
-	*  all frozen from it, so a disagreement is warned, never reconciled. */
+	*  all frozen from it, so a disagreement fails, never reconciled. */
 	adoptCompilerContext(compiler) {
 		const context = compiler.context;
 		if (!this.session.rootDir) {
 			this.session.rootDir = context;
 			return;
 		}
-		if (context && this.session.rootDir !== context && !this.warnedRootDivergence) {
-			this.warnedRootDivergence = true;
-			console.warn(`[animus-extract] compiler.context (${context}) differs from the configured project root (${this.session.rootDir}); keeping the configured root — run next against the app directory (or align your custom webpack context) so both agree`);
-		}
+		if (context && !sameDirectory(context, this.session.rootDir)) throw new AnimusConfigError(`[animus-extract] compiler.context (${context}) differs from the configured project root (${this.session.rootDir}). Run next against the app directory, or align your custom webpack context, so both agree.`);
 	}
 	get sessionDir() {
 		return this.session.sessionDir;
@@ -211,15 +276,20 @@ var AnimusWebpackPlugin = class {
 		return this.options;
 	}
 	getExternalPackageDirs() {
-		return this.session.externalPackageDirs.length > 0 ? this.session.externalPackageDirs : getSharedExternalDirs();
+		return this.session.externalPackageDirs.length > 0 ? this.session.externalPackageDirs : getSharedExternalDirs(this.session.key);
+	}
+	/** An import webpack resolved while bundling, with the resolve options of
+	*  the rules its importer matches (spec §2.2 A4). */
+	reportHostResolution(importer, request, resolved) {
+		this.session.reportHostResolution(importer, request, resolved);
 	}
 	getExternalSourceEntries() {
-		return this.session.externalSourceEntries.size > 0 ? this.session.externalSourceEntries : getSharedExternalEntries();
+		return this.session.externalSourceEntries.size > 0 ? this.session.externalSourceEntries : getSharedExternalEntries(this.session.key);
 	}
 	/** The classification of the entries `getExternalSourceEntries` returns,
 	*  from the same source. */
 	getExternalSourceSideEffects() {
-		return this.session.externalSourceEntries.size > 0 ? this.session.externalSourceSideEffects : getSharedExternalSideEffects();
+		return this.session.externalSourceEntries.size > 0 ? this.session.externalSourceSideEffects : getSharedExternalSideEffects(this.session.key);
 	}
 };
 //#endregion
@@ -233,6 +303,7 @@ const PHASE_PRODUCTION_BUILD = "phase-production-build";
 let warnedGitignore = false;
 let warnedUnstableTurbopack = false;
 function withAnimus(options) {
+	assertSupportedEngine(options.engine);
 	if (!options.system) throw new Error("[animus-extract] Missing required option `system`. Provide the path to your SystemInstance module: withAnimus({ system: \"./src/ds.ts\" })");
 	assertKnownOptionKeys({ ...options }, [
 		"cssImportTarget",
@@ -240,10 +311,7 @@ function withAnimus(options) {
 		"unstable_turbopack",
 		"loaderPath",
 		"phase"
-	], [{
-		key: "root",
-		reason: "this driver derives its own root — Next's `dir` under webpack, `process.cwd()` under Turbopack (Next passes no dir to a config module)"
-	}], {
+	], [], {
 		onUnknownKey: "warn",
 		warn: (message) => console.warn(`[animus-extract] ${message}`)
 	});
@@ -251,21 +319,31 @@ function withAnimus(options) {
 		warnedUnstableTurbopack = true;
 		console.warn("[animus-extract] `unstable_turbopack` is deprecated — rename it to `turbopack` (same shape)");
 	}
+	const build = createBuildId();
+	const appRoot = options.root === void 0 ? process.cwd() : resolve(options.root);
 	return (authoredConfig) => {
-		const nextConfig = withSourceKits(authoredConfig, process.cwd());
-		if (resolveTurbopackMode(options)) return turbopackConfig(nextConfig, options);
+		const nextConfig = withSourceKits(authoredConfig, appRoot);
+		if (resolveTurbopackMode(options)) {
+			warnTurbopackCwdRoot(options, appRoot);
+			return turbopackConfig(nextConfig, options, build, appRoot);
+		}
 		const existingWebpack = nextConfig.webpack;
 		return {
 			...nextConfig,
 			webpack(config, context) {
 				if (existingWebpack) config = existingWebpack(config, context);
-				const rootDir = context.dir?.length ? context.dir : process.cwd();
+				if (context.dir?.length && !sameDirectory(context.dir, appRoot)) throw new AnimusConfigError(`[animus-extract] Next builds ${context.dir}, but Animus read the app's source kits from ${appRoot}. Run next from the app directory, or pass withAnimus({ root }) naming it.`);
+				const rootDir = appRoot;
 				const { mode } = resolveMode(options.mode, () => context.dev === true ? "development" : "production");
 				const plugin = new AnimusWebpackPlugin({
 					...options,
 					mode
-				}, { development: context.dev === true });
+				}, {
+					development: context.dev === true,
+					build
+				});
 				plugin.setRootDir(rootDir);
+				if (nextConfig.distDir) plugin.excludeOutputDir(resolve(rootDir, nextConfig.distDir));
 				const sessionDir = plugin.sessionDir;
 				if (!existsSync(sessionDir)) mkdirSync(sessionDir, { recursive: true });
 				const stubCssPath = stylesPath(sessionDir);
@@ -310,6 +388,9 @@ function withAnimus(options) {
 							}
 						});
 						nmf.hooks.afterResolve.tap("AnimusVirtualResolve", (resolveData) => {
+							const issuer = resolveData.contextInfo?.issuer;
+							const resolved = resolveData.createData?.resource;
+							if (issuer && resolved !== void 0) plugin.reportHostResolution(issuer, resolveData.request, resolved);
 							const sideEffects = redirectSideEffects.get(resolveData);
 							const settings = resolveData.createData?.settings;
 							if (!settings) return;
@@ -335,9 +416,10 @@ function withAnimus(options) {
 					use: [{
 						loader: actualLoaderPath,
 						options: {
-							strict: options.strict,
 							development: context.dev === true,
-							cssImportTarget: options.cssImportTarget
+							cssImportTarget: options.cssImportTarget,
+							build,
+							root: rootDir
 						}
 					}]
 				});
@@ -358,17 +440,35 @@ function bindTurbopackWatchDeathReport(outcome, rootDir) {
 *  source, but Next's server keeps an installed package external, and so
 *  loads its runtime entry, unless the package is transpiled; transpiling
 *  also compiles its TypeScript source. */
+let warnedTurbopackCwd = false;
+/** Turbopack's loaders get no app dir either, so a cwd that is not the app
+*  cannot be detected later: warn at startup when the cwd holds no Next
+*  config and no `root` names the app. */
+function warnTurbopackCwdRoot(options, appRoot) {
+	if (options.root !== void 0 || warnedTurbopackCwd) return;
+	if ([
+		"js",
+		"mjs",
+		"cjs",
+		"ts",
+		"mts"
+	].some((ext) => existsSync(join(appRoot, `next.config.${ext}`)))) return;
+	warnedTurbopackCwd = true;
+	console.warn(`[animus-extract] the current directory (${appRoot}) holds no next.config: under Turbopack, Animus reads the app from the current directory. Run next from the app directory, or pass withAnimus({ root }) naming it.`);
+}
 function withSourceKits(nextConfig, rootDir) {
 	const declared = nextConfig.transpilePackages ?? [];
-	const kits = sourceKitDependencies(rootDir).map((kit) => kit.name).filter((name) => !declared.includes(name));
+	const kits = sourceKitDependencies(rootDir, requireEngine()).map((kit) => kit.name).filter((name) => !declared.includes(name));
 	if (kits.length === 0) return nextConfig;
 	return {
 		...nextConfig,
 		transpilePackages: [...declared, ...kits]
 	};
 }
-function turbopackConfig(nextConfig, options) {
-	const load = (phase) => loadTurbopackFragment(options, phase).then((fragment) => mergeTurbopackFragment(nextConfig, fragment));
+function turbopackConfig(nextConfig, options, build, appRoot) {
+	const resolveExtensions = nextConfig.turbopack?.resolveExtensions ?? nextConfig.experimental?.turbo?.resolveExtensions;
+	const outputExclude = nextConfig.distDir ? outputExclusion(appRoot, resolve(appRoot, nextConfig.distDir)) : null;
+	const load = (phase) => loadTurbopackFragment(options, phase, resolveExtensions, outputExclude, nextConfig.images?.disableStaticImages === true, build, appRoot).then((fragment) => mergeTurbopackFragment(nextConfig, fragment));
 	function then(onResolved, onRejected) {
 		const phase = options.phase ?? (isTurbopackDevelopment() ? PHASE_DEVELOPMENT_SERVER : PHASE_PRODUCTION_BUILD);
 		return load(phase).then(onResolved, onRejected);
@@ -377,49 +477,67 @@ function turbopackConfig(nextConfig, options) {
 	Object.defineProperty(config, "then", { enumerable: false });
 	return config;
 }
-let liveTurbopackSession = null;
-let liveTurbopackWatcher = null;
-/** The load the live session came from. Next loads the config again after
-*  Ready (validateTurboNextConfig), and a user config may await this one
-*  besides: the same phase and root share one analysis and keep the watcher.
-*  A rejected load is dropped, so a repaired source loads again. */
-let liveTurbopackLoad = null;
-function loadTurbopackFragment(options, phase) {
-	const rootDir = process.cwd();
-	const key = JSON.stringify([phase, rootDir]);
-	if (liveTurbopackLoad?.key === key) return liveTurbopackLoad.fragment;
-	const fragment = analyzeForTurbopack(options, phase, rootDir);
+/** Each wrapper's owner, by the build it created: another wrapper of the
+*  same root is another build and never shares or closes this one's. */
+const turbopackOwners = /* @__PURE__ */ new Map();
+function turbopackOwner(build) {
+	let owner = turbopackOwners.get(build);
+	if (owner === void 0) {
+		owner = {
+			session: null,
+			watcher: null,
+			load: null
+		};
+		turbopackOwners.set(build, owner);
+	}
+	return owner;
+}
+function loadTurbopackFragment(options, phase, resolveExtensions, outputExclude, disableStaticImages, build, rootDir) {
+	const key = JSON.stringify([
+		phase,
+		rootDir,
+		resolveExtensions ?? null,
+		disableStaticImages
+	]);
+	const owner = turbopackOwner(build);
+	if (owner.load?.key === key) return owner.load.fragment;
+	const fragment = analyzeForTurbopack(options, phase, rootDir, resolveExtensions, outputExclude, disableStaticImages, build);
 	const load = {
 		key,
 		fragment
 	};
-	liveTurbopackLoad = load;
+	owner.load = load;
 	fragment.catch(() => {
-		if (liveTurbopackLoad === load) liveTurbopackLoad = null;
+		if (owner.load === load) owner.load = null;
 	});
 	return fragment;
 }
-async function analyzeForTurbopack(options, phase, rootDir) {
+async function analyzeForTurbopack(options, phase, rootDir, resolveExtensions, outputExclude, disableStaticImages, build) {
 	const development = phase === PHASE_DEVELOPMENT_SERVER;
 	const { mode } = resolveMode(options.mode, () => development ? "development" : "production");
 	const session = new ExtractionSession({
 		...options,
 		mode
-	}, { unbundledComputedImports: true });
-	liveTurbopackSession?.close();
-	liveTurbopackWatcher?.close();
-	liveTurbopackWatcher = null;
-	liveTurbopackSession = session;
+	}, {
+		unbundledComputedImports: true,
+		build: `${build}-${phase}`
+	});
+	const owner = turbopackOwner(build);
+	owner.session?.close();
+	owner.watcher?.close();
+	owner.watcher = null;
+	owner.session = session;
 	session.development = development;
 	session.rootDir = rootDir;
-	const aliasPairs = readTsconfigAliasPairs(rootDir);
-	const builtAliases = buildPathAliasesJson(aliasPairs, rootDir);
-	if (builtAliases) session.pathAliasesJson = builtAliases.json;
+	if (outputExclude !== null) session.structuralExclude = [outputExclude];
+	session.extensionPolicy = turbopackExtensionPolicy(resolveExtensions);
+	session.assetClassification = nextImageAssetClassification(rootDir, disableStaticImages);
+	session.aliasesFromTsconfig = true;
 	await runSessionPipeline(session);
-	if (development && liveTurbopackSession === session) {
+	if (development && owner.session === session) {
 		const outcome = startTurbopackWatcher(session, rootDir);
 		bindTurbopackWatchDeathReport(outcome, rootDir);
-		if (outcome.kind === "started") liveTurbopackWatcher = outcome.handle;
+		if (outcome.kind === "started") owner.watcher = outcome.handle;
 	}
 	for (const line of turbopackSideEffectsLimits(rootDir, session.externalSourceEntries, session.externalSourceSideEffects)) console.warn(line);
 	return buildTurbopackConfig({

package/dist/{loader-core-CAr8opFH.cjs → loader-core-Bz52QNm3.cjs}

@@ -61,12 +61,26 @@ function extensionLineage(files, analyzedHashes) {
 	const lineage = files.map((file) => `${file}\0${analyzedHashes?.get(file) ?? ""}`).join("\0");
 	return `\nvoid "animus-lineage:${(0, _animus_ui_extract_pipeline.contentHash)(lineage)}";\n`;
 }
+let parsedManifest = null;
+/** What a manifest's transform serves, parsed once per manifest: every
+*  module of a compilation reads the same one. */
+function manifestServedFiles(manifestJson) {
+	if (parsedManifest?.json !== manifestJson) parsedManifest = {
+		json: manifestJson,
+		served: (0, _animus_ui_extract_pipeline.servedFiles)(JSON.parse(manifestJson))
+	};
+	return parsedManifest.served;
+}
 function transformWithManifest(args) {
 	const { source, filename, manifestJson, engineApi, opts } = args;
 	const isRootEntry = isCssImportTarget(filename, opts.cssImportTarget);
 	try {
 		const { transformFile } = engineApi();
 		const result = transformFile(source, filename, manifestJson);
+		const served = manifestServedFiles(manifestJson);
+		const drop = served.dropped.get(filename);
+		if (drop !== void 0) throw new Error((0, _animus_ui_extract_pipeline.droppedExtensionMessage)(drop));
+		if (!result.hasComponents && served.listed.has(filename)) throw new Error(`the analysis extracted components from ${filename}, but its transform found none`);
 		let code = result.hasComponents ? result.code : source;
 		code = code.replace(CSS_IMPORT_RE, "");
 		if (isRootEntry && !code.includes(_animus_ui_extract_session.ANIMUS_CSS_MODULE_ID)) {
@@ -79,10 +93,7 @@ function transformWithManifest(args) {
 		return code;
 	} catch (e) {
 		const msg = e instanceof Error ? e.message : String(e);
-		if (opts.strict && !opts.development) throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
-		if (opts.strict) console.error(`[animus-extract] Transform failed for ${filename}: ${msg}`);
-		else console.warn(`[animus-extract] Transform failed for ${filename}:`, msg);
-		return source;
+		throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
 	}
 }
 //#endregion

package/dist/{loader-core-pACpByOT.mjs → loader-core-DU2uZEMQ.mjs}

@@ -1,4 +1,4 @@
-import { contentHash } from "@animus-ui/extract/pipeline";
+import { contentHash, droppedExtensionMessage, servedFiles } from "@animus-ui/extract/pipeline";
 import { ANIMUS_CSS_MODULE_ID } from "@animus-ui/extract/session";
 //#region src/loader-core.ts
 /** Matches every already-emitted stylesheet import — arbitrary relative
@@ -61,12 +61,26 @@ function extensionLineage(files, analyzedHashes) {
 	const lineage = files.map((file) => `${file}\0${analyzedHashes?.get(file) ?? ""}`).join("\0");
 	return `\nvoid "animus-lineage:${contentHash(lineage)}";\n`;
 }
+let parsedManifest = null;
+/** What a manifest's transform serves, parsed once per manifest: every
+*  module of a compilation reads the same one. */
+function manifestServedFiles(manifestJson) {
+	if (parsedManifest?.json !== manifestJson) parsedManifest = {
+		json: manifestJson,
+		served: servedFiles(JSON.parse(manifestJson))
+	};
+	return parsedManifest.served;
+}
 function transformWithManifest(args) {
 	const { source, filename, manifestJson, engineApi, opts } = args;
 	const isRootEntry = isCssImportTarget(filename, opts.cssImportTarget);
 	try {
 		const { transformFile } = engineApi();
 		const result = transformFile(source, filename, manifestJson);
+		const served = manifestServedFiles(manifestJson);
+		const drop = served.dropped.get(filename);
+		if (drop !== void 0) throw new Error(droppedExtensionMessage(drop));
+		if (!result.hasComponents && served.listed.has(filename)) throw new Error(`the analysis extracted components from ${filename}, but its transform found none`);
 		let code = result.hasComponents ? result.code : source;
 		code = code.replace(CSS_IMPORT_RE, "");
 		if (isRootEntry && !code.includes(ANIMUS_CSS_MODULE_ID)) {
@@ -79,10 +93,7 @@ function transformWithManifest(args) {
 		return code;
 	} catch (e) {
 		const msg = e instanceof Error ? e.message : String(e);
-		if (opts.strict && !opts.development) throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
-		if (opts.strict) console.error(`[animus-extract] Transform failed for ${filename}: ${msg}`);
-		else console.warn(`[animus-extract] Transform failed for ${filename}:`, msg);
-		return source;
+		throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
 	}
 }
 //#endregion

package/dist/loader-core.d.ts

@@ -1,9 +1,14 @@
 export interface LoaderPolicyOptions {
-    strict?: boolean;
-    /** `next dev`: a strict transform failure reports and delivers the
-     *  source, as a non-strict one does, instead of failing the module. */
+    /** `next dev`: the Turbopack loader waits for and re-delivers the dev
+     *  watcher's generations. A transform failure fails the module in every
+     *  mode (SA1). */
     development?: boolean;
     cssImportTarget?: string;
+    /** The build the config wrapper created, which the loader reads the
+     *  analysis of. */
+    build?: string;
+    /** The root that build's plugin analyses. */
+    root?: string;
 }
 export interface LoaderContextBase<O extends LoaderPolicyOptions = LoaderPolicyOptions> {
     resourcePath: string;

package/dist/loader-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-core.d.ts","sourceRoot":"","sources":["../src/loader-core.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;2EACuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAEnD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AA0DD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7D,MAAM,CAMR;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,GAAG,CAAC;IACrB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GAAG,MAAM,CA6CT"}
+{"version":3,"file":"loader-core.d.ts","sourceRoot":"","sources":["../src/loader-core.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC;;sBAEkB;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;uBACmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAChC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB;IAEnD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AA0DD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7D,MAAM,CAMR;AAiBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,GAAG,CAAC;IACrB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GAAG,MAAM,CAiDT"}

package/dist/loader.cjs

@@ -1,4 +1,4 @@
-const require_loader_core = require("./loader-core-CAr8opFH.cjs");
+const require_loader_core = require("./loader-core-Bz52QNm3.cjs");
 let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
 let _animus_ui_extract_session = require("@animus-ui/extract/session");
 let fs = require("fs");
@@ -6,8 +6,11 @@ let path = require("path");
 //#region src/loader.ts
 const epochSeenForSessionDir = /* @__PURE__ */ new Set();
 function animusLoader(source) {
+	const opts = this.getOptions?.() ?? {};
+	if (opts.build === void 0) throw new _animus_ui_extract_pipeline.AnimusConfigError(`[animus-extract] the Animus loader for ${(0, path.relative)(this.rootContext, this.resourcePath)} names no Animus build; it runs only as withAnimus() configures it.`);
+	const key = (0, _animus_ui_extract_session.sessionKey)(opts.build, opts.root ?? this.rootContext);
 	if (this.addDependency !== void 0) {
-		const sessionDir = (0, _animus_ui_extract_session.getSessionArtifactDir)();
+		const sessionDir = (0, _animus_ui_extract_session.getSessionArtifactDir)(key);
 		if (sessionDir) {
 			const epochPath = (0, _animus_ui_extract_session.replacementEpochPath)(sessionDir);
 			if (epochSeenForSessionDir.has(sessionDir) || (0, fs.existsSync)(epochPath)) {
@@ -16,29 +19,29 @@ function animusLoader(source) {
 			}
 		}
 	}
-	let manifestJson = (0, _animus_ui_extract_session.getManifestJson)();
-	if (!manifestJson) return source;
+	let manifestJson = (0, _animus_ui_extract_session.getManifestJson)(key);
+	if (!manifestJson) throw new Error(`[animus-extract] no analysis is available to transform ${(0, path.relative)(this.rootContext, this.resourcePath)}: the project analysis failed; see the error above.`);
 	const filename = (0, path.relative)(this.rootContext, this.resourcePath);
-	const analyzedHash = (0, _animus_ui_extract_session.getAnalyzedHashes)()?.get(filename);
+	const analyzedHash = (0, _animus_ui_extract_session.getAnalyzedHashes)(key)?.get(filename);
 	if (analyzedHash !== void 0) {
 		const sourceHash = (0, _animus_ui_extract_pipeline.contentHash)(source);
 		if (sourceHash !== analyzedHash) {
-			const refreshedHash = (0, _animus_ui_extract_session.getAnalyzedHashes)()?.get(filename);
+			const refreshedHash = (0, _animus_ui_extract_session.getAnalyzedHashes)(key)?.get(filename);
 			if (refreshedHash === void 0 || sourceHash !== refreshedHash) throw new Error(`ANIMUS_ANALYSIS_CATCHING_UP: ${filename} changed after the current analysis; retrying on the next watch turn`);
-			manifestJson = (0, _animus_ui_extract_session.getManifestJson)() ?? manifestJson;
+			manifestJson = (0, _animus_ui_extract_session.getManifestJson)(key) ?? manifestJson;
 		}
 	}
 	const code = require_loader_core.transformWithManifest({
 		source,
 		filename,
 		manifestJson,
-		engineApi: _animus_ui_extract_session.engineApi,
-		opts: this.getOptions?.() ?? {}
+		engineApi: () => (0, _animus_ui_extract_session.engineApi)(key),
+		opts
 	});
 	if (!(this.mode !== "production") || this.addDependency === void 0) return code;
 	const extended = require_loader_core.extendedFiles(manifestJson, filename);
 	for (const file of extended) this.addDependency((0, path.join)(this.rootContext, file));
-	return code + require_loader_core.extensionLineage(extended, (0, _animus_ui_extract_session.getAnalyzedHashes)());
+	return code + require_loader_core.extensionLineage(extended, (0, _animus_ui_extract_session.getAnalyzedHashes)(key));
 }
 //#endregion
 module.exports = animusLoader;

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvD,KAAK,aAAa,GAAG,iBAAiB,GAAG;IACvC,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAkDR"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvD,KAAK,aAAa,GAAG,iBAAiB,GAAG;IACvC,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAuER"}