@animus-ui/unplugin 0.1.22 → 0.1.24

package/dist/{core-CA2hGS8D.cjs → core-BqEruPuj.cjs}

@@ -20,11 +20,14 @@ function hasRequiredSystem(options) {
 function resolveHostOptions(raw, cwd = process.cwd()) {
 	const options = raw ?? {};
 	(0, _animus_ui_extract_pipeline.assertNoRetiredEngineSelection)(options.engine);
-	(0, _animus_ui_extract_pipeline.assertKnownOptionKeys)(options);
+	(0, _animus_ui_extract_pipeline.assertKnownOptionKeys)(options, ["watch"]);
 	if (!hasRequiredSystem(options)) throw new _animus_ui_extract_pipeline.AnimusConfigError("Missing required option `system` — pass `system: \"./src/ds.ts\"` to the Animus plugin.");
+	const root = options.root ? (0, node_path.resolve)(cwd, options.root) : cwd;
+	const { watch, ...core } = options;
 	return {
-		root: options.root ? (0, node_path.resolve)(cwd, options.root) : cwd,
-		options
+		root,
+		options: core,
+		watch: watch === true
 	};
 }
 function resolveHostMode(explicit, oracle) {
@@ -98,17 +101,42 @@ function transformWithEngine(code, id, ctx) {
 	const result = ctx.transformFile(code, filename, ctx.manifestJson);
 	return result.hasComponents ? result.code : null;
 }
+/** Whether esbuild's `external` option names `specifier`: exactly, as the
+*  package a subpath belongs to, or through a `*` wildcard. */
+function isEsbuildExternal(specifier, external) {
+	return (external ?? []).some((pattern) => {
+		if (!pattern.includes("*")) return specifier === pattern || specifier.startsWith(`${pattern}/`);
+		const [prefix, suffix] = pattern.split("*", 2);
+		return specifier.length >= prefix.length + suffix.length && specifier.startsWith(prefix) && specifier.endsWith(suffix);
+	});
+}
 function moduleFilePath(id) {
 	const query = id.indexOf("?");
 	return query === -1 ? id : id.slice(0, query);
 }
+/** Whether a hook context is a Rollup-family one that resolves imports. */
+function canResolve(context) {
+	return "resolve" in context;
+}
+/** Marks the esbuild resolve that `esbuild.setup` makes for itself. */
+const KIT_SOURCE_RESOLVE = "animus:kit-source-resolve";
 const PLUGIN_NAME = "animus-host";
+const ESBUILD_WATCH_HINT = "If this is an esbuild watch or serve context, pass watch: true to the Animus esbuild plugin.";
 const unpluginFactory = (rawOptions, meta) => {
-	const { root, options } = resolveHostOptions(rawOptions);
+	const { root, options, watch } = resolveHostOptions(rawOptions);
 	const state = createHostState();
 	let activeSession = null;
 	let modeOracle = null;
+	/** Whether the host is watching, where an error-level diagnostic reports
+	*  and the pipeline still publishes. Only a build fails on one. Rollup's
+	*  oracle is its watch mode; webpack's is its `mode`, so it reads
+	*  `watchMode` instead, and Vite reads its command. esbuild gives neither,
+	*  so its author says so with the `watch` option. */
+	let watching = () => modeOracle === "development";
 	let esbuildOptions = null;
+	/** The bundler's export conditions, in its order, for the system loader;
+	*  Rollup exposes none. */
+	let hostConditions = [];
 	/** Hooks can fire before buildStart (webpack's make taps run
 	*  concurrently), so joiners await this before awaiting the pipeline. */
 	let signalPipelineStarted;
@@ -116,6 +144,8 @@ const unpluginFactory = (rawOptions, meta) => {
 		signalPipelineStarted = res;
 	});
 	const effectiveMode = () => resolveHostMode(options.mode, modeOracle);
+	/** Hosts whose `resolveId` result carries `moduleSideEffects`. */
+	const rollupLike = meta.framework === "rollup" || meta.framework === "rolldown" || meta.framework === "vite";
 	const needsInlineDefine = meta.framework !== "esbuild" && meta.framework !== "webpack" && meta.framework !== "rspack";
 	const unbundledComputedImports = meta.framework === "rollup" || meta.framework === "rolldown" || meta.framework === "esbuild" || meta.framework === "vite";
 	async function startPipeline() {
@@ -124,6 +154,7 @@ const unpluginFactory = (rawOptions, meta) => {
 			await runClaimedPipeline();
 		} catch (error) {
 			releaseClaim();
+			if (meta.framework === "esbuild" && !watch && error instanceof _animus_ui_extract_pipeline.DiagnosticFailure) throw new Error(`${String(error)}\n${ESBUILD_WATCH_HINT}`, { cause: error });
 			throw error;
 		}
 	}
@@ -140,8 +171,10 @@ const unpluginFactory = (rawOptions, meta) => {
 				mode
 			}, { unbundledComputedImports });
 			activeSession = session;
+			session.development = watching();
 			session.driverLabel = "animus-unplugin";
 			session.rootDir = root;
+			session.conditions = hostConditions;
 			session.systemPropsModuleId = _animus_ui_extract_session.TURBOPACK_SYSTEM_PROPS_ID;
 			const aliasPairs = (0, _animus_ui_extract_pipeline.readTsconfigAliasPairs)(root);
 			const builtAliases = (0, _animus_ui_extract_pipeline.buildPathAliasesJson)(aliasPairs, root);
@@ -218,10 +251,21 @@ const unpluginFactory = (rawOptions, meta) => {
 			await startPipeline();
 			registerWatchTargets(this);
 		},
-		async resolveId(id) {
+		async resolveId(id, importer) {
 			const virtual = resolveAnimusId(id);
 			if (virtual !== null) return virtual;
+			if (id.startsWith(".") && importer !== void 0 && rollupLike) await joinPipeline();
+			if (id.startsWith(".") && importer !== void 0 && rollupLike && state.externalPackageDirs.some((dir) => (0, _animus_ui_extract_pipeline.isPathWithinRoot)(dir, moduleFilePath(importer)))) {
+				if (!canResolve(this)) return null;
+				const resolved = await this.resolve(id, importer, { skipSelf: true });
+				if (resolved === null || resolved.external || !(0, _animus_ui_extract_pipeline.keepsKitSourceEffects)(moduleFilePath(resolved.id), state.externalPackageDirs)) return null;
+				return {
+					id: resolved.id,
+					moduleSideEffects: true
+				};
+			}
 			if (id.startsWith(".") || id.startsWith("/") || id.startsWith("\0") || id.startsWith("animus:")) return null;
+			if (meta.framework === "esbuild") return null;
 			await joinPipeline();
 			const target = state.kitRedirects.get(id);
 			if (target === void 0) return null;
@@ -291,6 +335,10 @@ const unpluginFactory = (rawOptions, meta) => {
 				releaseClaim();
 			}
 		},
+		vite: { configResolved(config) {
+			const serving = config.command === "serve" || Boolean(config.build.watch);
+			watching = () => serving;
+		} },
 		rollup: { async buildStart() {
 			modeOracle = this.meta?.watchMode ? "development" : "production";
 			await startPipeline();
@@ -307,15 +355,81 @@ const unpluginFactory = (rawOptions, meta) => {
 		},
 		rspack(compiler) {
 			wireWebpackLike(compiler);
+			classifyRspackRedirects(compiler);
 		},
-		esbuild: { config(buildOptions) {
-			esbuildOptions = buildOptions;
-			buildOptions.define = {
-				...buildOptions.define,
-				__ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development")
-			};
-		} }
+		esbuild: {
+			/** unplugin's esbuild resolve drops `moduleSideEffects` and puts the
+			*  target in its own namespace, where no package classifies it. A
+			*  redirect resolved here stays in the `file` namespace and carries the
+			*  replaced entry's classification. */
+			setup(build) {
+				build.onResolve({ filter: /^\./ }, async (args) => {
+					if (args.pluginData === KIT_SOURCE_RESOLVE) return void 0;
+					await joinPipeline();
+					if (!state.externalPackageDirs.some((dir) => (0, _animus_ui_extract_pipeline.isPathWithinRoot)(dir, args.importer))) return;
+					const resolved = await build.resolve(args.path, {
+						importer: args.importer,
+						resolveDir: args.resolveDir,
+						kind: args.kind,
+						pluginData: KIT_SOURCE_RESOLVE
+					});
+					if (resolved.errors.length > 0 || resolved.external || !(0, _animus_ui_extract_pipeline.keepsKitSourceEffects)(resolved.path, state.externalPackageDirs)) return;
+					return {
+						path: resolved.path,
+						namespace: resolved.namespace,
+						suffix: resolved.suffix,
+						sideEffects: true
+					};
+				});
+				build.onResolve({ filter: /^[^./\0]/ }, async (args) => {
+					if (args.path.startsWith("animus:")) return void 0;
+					if (isEsbuildExternal(args.path, build.initialOptions.external)) return;
+					await joinPipeline();
+					const target = state.kitRedirects.get(args.path);
+					if (target === void 0) return void 0;
+					const sideEffects = state.kitSideEffects.get(args.path);
+					return sideEffects === void 0 ? { path: target } : {
+						path: target,
+						sideEffects
+					};
+				});
+			},
+			config(buildOptions) {
+				esbuildOptions = buildOptions;
+				hostConditions = buildOptions.conditions ?? [];
+				watching = () => watch;
+				buildOptions.define = {
+					...buildOptions.define,
+					__ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development")
+				};
+			}
+		}
 	};
+	/** Rspack's resolve data carries no rule settings, so a module rule per
+	*  classification marks each redirect target, read when it resolves. */
+	function classifyRspackRedirects(compiler) {
+		const classification = (resource) => {
+			let pure = false;
+			for (const [specifier, target] of state.kitRedirects) {
+				if (target !== resource) continue;
+				const sideEffects = state.kitSideEffects.get(specifier);
+				if (sideEffects === true) return true;
+				if (sideEffects === false) pure = true;
+			}
+			return pure ? false : void 0;
+		};
+		compiler.options.module.rules.push({
+			test: (resource) => classification(resource) === true,
+			sideEffects: true
+		}, {
+			test: (resource) => classification(resource) === false,
+			sideEffects: false
+		}, {
+			test: (resource) => (0, _animus_ui_extract_pipeline.keepsKitSourceEffects)(resource, state.externalPackageDirs),
+			issuer: (issuer) => state.externalPackageDirs.some((dir) => (0, _animus_ui_extract_pipeline.isPathWithinRoot)(dir, issuer)),
+			sideEffects: true
+		});
+	}
 	/** Webpack would classify a redirect target by its own path against the
 	*  package's `sideEffects`, so the replaced entry's classification is set
 	*  as a rule's would be. Rspack's resolve data is not known to carry
@@ -324,14 +438,17 @@ const unpluginFactory = (rawOptions, meta) => {
 		compiler.hooks.normalModuleFactory.tap(PLUGIN_NAME, (nmf) => {
 			nmf.hooks.afterResolve.tap(PLUGIN_NAME, (resolveData) => {
 				const { createData } = resolveData;
+				if (!createData?.settings || createData.resource === void 0) return;
 				const sideEffects = state.kitSideEffects.get(resolveData.request);
-				if (sideEffects === void 0 || !createData?.settings || createData.resource !== state.kitRedirects.get(resolveData.request)) return;
-				createData.settings.sideEffects = sideEffects;
+				if (sideEffects !== void 0 && createData.resource === state.kitRedirects.get(resolveData.request)) createData.settings.sideEffects = sideEffects;
+				else if ((0, _animus_ui_extract_pipeline.keepsKitSourceEffects)(moduleFilePath(createData.resource), state.externalPackageDirs)) createData.settings.sideEffects = true;
 			});
 		});
 	}
 	function wireWebpackLike(compiler) {
 		modeOracle = compiler.options.mode === "development" ? "development" : "production";
+		hostConditions = (compiler.options.resolve?.conditionNames ?? []).filter((name) => name !== "...");
+		watching = () => compiler.watchMode === true;
 		const DefinePlugin = compiler.webpack?.DefinePlugin ?? compiler.rspack?.DefinePlugin;
 		if (!DefinePlugin) throw new Error("[animus] compiler exposes no DefinePlugin — cannot supply the __ANIMUS_DEV__ dev-signal define");
 		new DefinePlugin({ __ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development") }).apply(compiler);

package/dist/{core-BefIaJxu.mjs → core-CP2SnWlP.mjs}

@@ -1,4 +1,4 @@
-import { AnimusConfigError, ENGINE_TRANSFORM_EXTENSIONS, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, isEngineTransformExtension, isPathWithinRoot, readTsconfigAliasPairs, resolveMode } from "@animus-ui/extract/pipeline";
+import { AnimusConfigError, DiagnosticFailure, ENGINE_TRANSFORM_EXTENSIONS, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, isEngineTransformExtension, isPathWithinRoot, keepsKitSourceEffects, readTsconfigAliasPairs, resolveMode } from "@animus-ui/extract/pipeline";
 import { ANIMUS_CSS_MODULE_ID, ExtractionSession, SESSION_ASSETS_DIR, TURBOPACK_SYSTEM_PROPS_ID, collectSessionAssets, engineApi, getAnalyzedHashes, getManifestJson, getSessionArtifactDir, getSharedCss, getSharedSystemProps } from "@animus-ui/extract/session";
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
@@ -20,11 +20,14 @@ function hasRequiredSystem(options) {
 function resolveHostOptions(raw, cwd = process.cwd()) {
 	const options = raw ?? {};
 	assertNoRetiredEngineSelection(options.engine);
-	assertKnownOptionKeys(options);
+	assertKnownOptionKeys(options, ["watch"]);
 	if (!hasRequiredSystem(options)) throw new AnimusConfigError("Missing required option `system` — pass `system: \"./src/ds.ts\"` to the Animus plugin.");
+	const root = options.root ? resolve(cwd, options.root) : cwd;
+	const { watch, ...core } = options;
 	return {
-		root: options.root ? resolve(cwd, options.root) : cwd,
-		options
+		root,
+		options: core,
+		watch: watch === true
 	};
 }
 function resolveHostMode(explicit, oracle) {
@@ -98,17 +101,42 @@ function transformWithEngine(code, id, ctx) {
 	const result = ctx.transformFile(code, filename, ctx.manifestJson);
 	return result.hasComponents ? result.code : null;
 }
+/** Whether esbuild's `external` option names `specifier`: exactly, as the
+*  package a subpath belongs to, or through a `*` wildcard. */
+function isEsbuildExternal(specifier, external) {
+	return (external ?? []).some((pattern) => {
+		if (!pattern.includes("*")) return specifier === pattern || specifier.startsWith(`${pattern}/`);
+		const [prefix, suffix] = pattern.split("*", 2);
+		return specifier.length >= prefix.length + suffix.length && specifier.startsWith(prefix) && specifier.endsWith(suffix);
+	});
+}
 function moduleFilePath(id) {
 	const query = id.indexOf("?");
 	return query === -1 ? id : id.slice(0, query);
 }
+/** Whether a hook context is a Rollup-family one that resolves imports. */
+function canResolve(context) {
+	return "resolve" in context;
+}
+/** Marks the esbuild resolve that `esbuild.setup` makes for itself. */
+const KIT_SOURCE_RESOLVE = "animus:kit-source-resolve";
 const PLUGIN_NAME = "animus-host";
+const ESBUILD_WATCH_HINT = "If this is an esbuild watch or serve context, pass watch: true to the Animus esbuild plugin.";
 const unpluginFactory = (rawOptions, meta) => {
-	const { root, options } = resolveHostOptions(rawOptions);
+	const { root, options, watch } = resolveHostOptions(rawOptions);
 	const state = createHostState();
 	let activeSession = null;
 	let modeOracle = null;
+	/** Whether the host is watching, where an error-level diagnostic reports
+	*  and the pipeline still publishes. Only a build fails on one. Rollup's
+	*  oracle is its watch mode; webpack's is its `mode`, so it reads
+	*  `watchMode` instead, and Vite reads its command. esbuild gives neither,
+	*  so its author says so with the `watch` option. */
+	let watching = () => modeOracle === "development";
 	let esbuildOptions = null;
+	/** The bundler's export conditions, in its order, for the system loader;
+	*  Rollup exposes none. */
+	let hostConditions = [];
 	/** Hooks can fire before buildStart (webpack's make taps run
 	*  concurrently), so joiners await this before awaiting the pipeline. */
 	let signalPipelineStarted;
@@ -116,6 +144,8 @@ const unpluginFactory = (rawOptions, meta) => {
 		signalPipelineStarted = res;
 	});
 	const effectiveMode = () => resolveHostMode(options.mode, modeOracle);
+	/** Hosts whose `resolveId` result carries `moduleSideEffects`. */
+	const rollupLike = meta.framework === "rollup" || meta.framework === "rolldown" || meta.framework === "vite";
 	const needsInlineDefine = meta.framework !== "esbuild" && meta.framework !== "webpack" && meta.framework !== "rspack";
 	const unbundledComputedImports = meta.framework === "rollup" || meta.framework === "rolldown" || meta.framework === "esbuild" || meta.framework === "vite";
 	async function startPipeline() {
@@ -124,6 +154,7 @@ const unpluginFactory = (rawOptions, meta) => {
 			await runClaimedPipeline();
 		} catch (error) {
 			releaseClaim();
+			if (meta.framework === "esbuild" && !watch && error instanceof DiagnosticFailure) throw new Error(`${String(error)}\n${ESBUILD_WATCH_HINT}`, { cause: error });
 			throw error;
 		}
 	}
@@ -140,8 +171,10 @@ const unpluginFactory = (rawOptions, meta) => {
 				mode
 			}, { unbundledComputedImports });
 			activeSession = session;
+			session.development = watching();
 			session.driverLabel = "animus-unplugin";
 			session.rootDir = root;
+			session.conditions = hostConditions;
 			session.systemPropsModuleId = TURBOPACK_SYSTEM_PROPS_ID;
 			const aliasPairs = readTsconfigAliasPairs(root);
 			const builtAliases = buildPathAliasesJson(aliasPairs, root);
@@ -218,10 +251,21 @@ const unpluginFactory = (rawOptions, meta) => {
 			await startPipeline();
 			registerWatchTargets(this);
 		},
-		async resolveId(id) {
+		async resolveId(id, importer) {
 			const virtual = resolveAnimusId(id);
 			if (virtual !== null) return virtual;
+			if (id.startsWith(".") && importer !== void 0 && rollupLike) await joinPipeline();
+			if (id.startsWith(".") && importer !== void 0 && rollupLike && state.externalPackageDirs.some((dir) => isPathWithinRoot(dir, moduleFilePath(importer)))) {
+				if (!canResolve(this)) return null;
+				const resolved = await this.resolve(id, importer, { skipSelf: true });
+				if (resolved === null || resolved.external || !keepsKitSourceEffects(moduleFilePath(resolved.id), state.externalPackageDirs)) return null;
+				return {
+					id: resolved.id,
+					moduleSideEffects: true
+				};
+			}
 			if (id.startsWith(".") || id.startsWith("/") || id.startsWith("\0") || id.startsWith("animus:")) return null;
+			if (meta.framework === "esbuild") return null;
 			await joinPipeline();
 			const target = state.kitRedirects.get(id);
 			if (target === void 0) return null;
@@ -291,6 +335,10 @@ const unpluginFactory = (rawOptions, meta) => {
 				releaseClaim();
 			}
 		},
+		vite: { configResolved(config) {
+			const serving = config.command === "serve" || Boolean(config.build.watch);
+			watching = () => serving;
+		} },
 		rollup: { async buildStart() {
 			modeOracle = this.meta?.watchMode ? "development" : "production";
 			await startPipeline();
@@ -307,15 +355,81 @@ const unpluginFactory = (rawOptions, meta) => {
 		},
 		rspack(compiler) {
 			wireWebpackLike(compiler);
+			classifyRspackRedirects(compiler);
 		},
-		esbuild: { config(buildOptions) {
-			esbuildOptions = buildOptions;
-			buildOptions.define = {
-				...buildOptions.define,
-				__ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development")
-			};
-		} }
+		esbuild: {
+			/** unplugin's esbuild resolve drops `moduleSideEffects` and puts the
+			*  target in its own namespace, where no package classifies it. A
+			*  redirect resolved here stays in the `file` namespace and carries the
+			*  replaced entry's classification. */
+			setup(build) {
+				build.onResolve({ filter: /^\./ }, async (args) => {
+					if (args.pluginData === KIT_SOURCE_RESOLVE) return void 0;
+					await joinPipeline();
+					if (!state.externalPackageDirs.some((dir) => isPathWithinRoot(dir, args.importer))) return;
+					const resolved = await build.resolve(args.path, {
+						importer: args.importer,
+						resolveDir: args.resolveDir,
+						kind: args.kind,
+						pluginData: KIT_SOURCE_RESOLVE
+					});
+					if (resolved.errors.length > 0 || resolved.external || !keepsKitSourceEffects(resolved.path, state.externalPackageDirs)) return;
+					return {
+						path: resolved.path,
+						namespace: resolved.namespace,
+						suffix: resolved.suffix,
+						sideEffects: true
+					};
+				});
+				build.onResolve({ filter: /^[^./\0]/ }, async (args) => {
+					if (args.path.startsWith("animus:")) return void 0;
+					if (isEsbuildExternal(args.path, build.initialOptions.external)) return;
+					await joinPipeline();
+					const target = state.kitRedirects.get(args.path);
+					if (target === void 0) return void 0;
+					const sideEffects = state.kitSideEffects.get(args.path);
+					return sideEffects === void 0 ? { path: target } : {
+						path: target,
+						sideEffects
+					};
+				});
+			},
+			config(buildOptions) {
+				esbuildOptions = buildOptions;
+				hostConditions = buildOptions.conditions ?? [];
+				watching = () => watch;
+				buildOptions.define = {
+					...buildOptions.define,
+					__ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development")
+				};
+			}
+		}
 	};
+	/** Rspack's resolve data carries no rule settings, so a module rule per
+	*  classification marks each redirect target, read when it resolves. */
+	function classifyRspackRedirects(compiler) {
+		const classification = (resource) => {
+			let pure = false;
+			for (const [specifier, target] of state.kitRedirects) {
+				if (target !== resource) continue;
+				const sideEffects = state.kitSideEffects.get(specifier);
+				if (sideEffects === true) return true;
+				if (sideEffects === false) pure = true;
+			}
+			return pure ? false : void 0;
+		};
+		compiler.options.module.rules.push({
+			test: (resource) => classification(resource) === true,
+			sideEffects: true
+		}, {
+			test: (resource) => classification(resource) === false,
+			sideEffects: false
+		}, {
+			test: (resource) => keepsKitSourceEffects(resource, state.externalPackageDirs),
+			issuer: (issuer) => state.externalPackageDirs.some((dir) => isPathWithinRoot(dir, issuer)),
+			sideEffects: true
+		});
+	}
 	/** Webpack would classify a redirect target by its own path against the
 	*  package's `sideEffects`, so the replaced entry's classification is set
 	*  as a rule's would be. Rspack's resolve data is not known to carry
@@ -324,14 +438,17 @@ const unpluginFactory = (rawOptions, meta) => {
 		compiler.hooks.normalModuleFactory.tap(PLUGIN_NAME, (nmf) => {
 			nmf.hooks.afterResolve.tap(PLUGIN_NAME, (resolveData) => {
 				const { createData } = resolveData;
+				if (!createData?.settings || createData.resource === void 0) return;
 				const sideEffects = state.kitSideEffects.get(resolveData.request);
-				if (sideEffects === void 0 || !createData?.settings || createData.resource !== state.kitRedirects.get(resolveData.request)) return;
-				createData.settings.sideEffects = sideEffects;
+				if (sideEffects !== void 0 && createData.resource === state.kitRedirects.get(resolveData.request)) createData.settings.sideEffects = sideEffects;
+				else if (keepsKitSourceEffects(moduleFilePath(createData.resource), state.externalPackageDirs)) createData.settings.sideEffects = true;
 			});
 		});
 	}
 	function wireWebpackLike(compiler) {
 		modeOracle = compiler.options.mode === "development" ? "development" : "production";
+		hostConditions = (compiler.options.resolve?.conditionNames ?? []).filter((name) => name !== "...");
+		watching = () => compiler.watchMode === true;
 		const DefinePlugin = compiler.webpack?.DefinePlugin ?? compiler.rspack?.DefinePlugin;
 		if (!DefinePlugin) throw new Error("[animus] compiler exposes no DefinePlugin — cannot supply the __ANIMUS_DEV__ dev-signal define");
 		new DefinePlugin({ __ANIMUS_DEV__: JSON.stringify(effectiveMode() === "development") }).apply(compiler);

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB;0DAC0D;AAC1D,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAQtD,eAAO,MAAM,cAAc,eAAe,CAAC;AAQ3C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;wCACoC;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EACT,CAAC,CACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,KACjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC,GAC9C,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,eAAe,IAAI,SAAS,CAc3C;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,qBAAqB,GAAG,iBAAiB,CAAC,GAChE,OAAO,CAMT;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IACmB,GAC9C,IAAI,CAKN;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACxB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,KACjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C,GACA,MAAM,GAAG,IAAI,CAIf;AA0DD,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,qBAAqB,GAAG,SAAS,CAuVlC,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAIV,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB;0DAC0D;AAC1D,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAQtD,eAAO,MAAM,cAAc,eAAe,CAAC;AAQ3C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;wCACoC;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EACT,CAAC,CACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,KACjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC,GAC9C,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,eAAe,IAAI,SAAS,CAc3C;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,qBAAqB,GAAG,iBAAiB,CAAC,GAChE,OAAO,CAMT;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IACmB,GAC9C,IAAI,CAKN;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACxB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,KACjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C,GACA,MAAM,GAAG,IAAI,CAIf;AAsHD,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,qBAAqB,GAAG,SAAS,CA2gBlC,CAAC"}

package/dist/esbuild.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_core = require("./core-CA2hGS8D.cjs");
+const require_core = require("./core-BqEruPuj.cjs");
 //#region src/esbuild.ts
 const animusEsbuild = (0, require("unplugin").createEsbuildPlugin)(require_core.unpluginFactory);
 //#endregion

package/dist/esbuild.d.ts

@@ -1,4 +1,4 @@
 export type { AnimusUnpluginOptions } from './options';
-export declare const animusEsbuild: (options?: import("@animus-ui/extract/pipeline").AnimusCoreOptions | undefined) => import("unplugin").EsbuildPlugin;
+export declare const animusEsbuild: (options?: import("./options").AnimusUnpluginOptions | undefined) => import("unplugin").EsbuildPlugin;
 export default animusEsbuild;
 //# sourceMappingURL=esbuild.d.ts.map

package/dist/esbuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,aAAa,qHAAuC,CAAC;eAEnD,aAAa"}
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../src/esbuild.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,aAAa,uGAAuC,CAAC;eAEnD,aAAa"}

package/dist/esbuild.mjs

@@ -1,4 +1,4 @@
-import { t as unpluginFactory } from "./core-BefIaJxu.mjs";
+import { t as unpluginFactory } from "./core-CP2SnWlP.mjs";
 import { createEsbuildPlugin } from "unplugin";
 //#region src/esbuild.ts
 const animusEsbuild = createEsbuildPlugin(unpluginFactory);

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_core = require("./core-CA2hGS8D.cjs");
+const require_core = require("./core-BqEruPuj.cjs");
 //#region src/index.ts
 const animusUnplugin = (0, require("unplugin").createUnplugin)(require_core.unpluginFactory);
 //#endregion

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { unpluginFactory } from './core';
 export type { AnimusUnpluginOptions } from './options';
 export { unpluginFactory };
-export declare const animusUnplugin: import("unplugin").UnpluginInstance<import("@animus-ui/extract/pipeline").AnimusCoreOptions | undefined, boolean>;
+export declare const animusUnplugin: import("unplugin").UnpluginInstance<import("./options").AnimusUnpluginOptions | undefined, boolean>;
 export default animusUnplugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAM,cAAc,mHAAkC,CAAC;eAE/C,cAAc"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAM,cAAc,qGAAkC,CAAC;eAE/C,cAAc"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as unpluginFactory } from "./core-BefIaJxu.mjs";
+import { t as unpluginFactory } from "./core-CP2SnWlP.mjs";
 import { createUnplugin } from "unplugin";
 //#region src/index.ts
 const animusUnplugin = createUnplugin(unpluginFactory);

package/dist/options.d.ts

@@ -1,10 +1,20 @@
 /** rollup and esbuild expose no root authority a plugin could derive, so
  *  `root` is the explicit option, defaulting to the working directory. */
 import type { AnimusCoreOptions, AnimusMode } from '@animus-ui/extract/pipeline';
-export type AnimusUnpluginOptions = AnimusCoreOptions;
+export interface AnimusUnpluginOptions extends AnimusCoreOptions {
+    /**
+     * esbuild only: set this where you call `context().watch()` or `serve()`.
+     * Every turn, the first included, then reports an error-level diagnostic
+     * and publishes. Without it, esbuild is a one-shot build, which an
+     * error-level diagnostic fails. Other hosts detect a watch themselves.
+     */
+    watch?: boolean;
+}
 export interface ResolvedHostOptions {
     root: string;
     options: AnimusCoreOptions;
+    /** The esbuild adapter's `watch` option. */
+    watch: boolean;
 }
 export declare function resolveHostOptions(raw: AnimusUnpluginOptions | undefined, cwd?: string): ResolvedHostOptions;
 export declare function resolveHostMode(explicit: AnimusMode | undefined, oracle: AnimusMode | null): AnimusMode;

package/dist/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAU1E,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACX,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAoBtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,GAAG,SAAS,EACtC,GAAG,GAAE,MAAsB,GAC1B,mBAAmB,CAYrB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,MAAM,EAAE,UAAU,GAAG,IAAI,GACxB,UAAU,CAEZ"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAU1E,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACX,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAoBD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,qBAAqB,GAAG,SAAS,EACtC,GAAG,GAAE,MAAsB,GAC1B,mBAAmB,CAarB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,MAAM,EAAE,UAAU,GAAG,IAAI,GACxB,UAAU,CAEZ"}

package/dist/rollup.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_core = require("./core-CA2hGS8D.cjs");
+const require_core = require("./core-BqEruPuj.cjs");
 //#region src/rollup.ts
 const animusRollup = (0, require("unplugin").createRollupPlugin)(require_core.unpluginFactory);
 //#endregion

package/dist/rollup.d.ts

@@ -1,4 +1,4 @@
 export type { AnimusUnpluginOptions } from './options';
-export declare const animusRollup: (options?: import("@animus-ui/extract/pipeline").AnimusCoreOptions | undefined) => import("unplugin").RollupPlugin<any>[] | import("unplugin").RollupPlugin<any>;
+export declare const animusRollup: (options?: import("./options").AnimusUnpluginOptions | undefined) => import("unplugin").RollupPlugin<any>[] | import("unplugin").RollupPlugin<any>;
 export default animusRollup;
 //# sourceMappingURL=rollup.d.ts.map

package/dist/rollup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,YAAY,kKAAsC,CAAC;eAEjD,YAAY"}
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../src/rollup.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,YAAY,oJAAsC,CAAC;eAEjD,YAAY"}

package/dist/rollup.mjs

@@ -1,4 +1,4 @@
-import { t as unpluginFactory } from "./core-BefIaJxu.mjs";
+import { t as unpluginFactory } from "./core-CP2SnWlP.mjs";
 import { createRollupPlugin } from "unplugin";
 //#region src/rollup.ts
 const animusRollup = createRollupPlugin(unpluginFactory);

package/dist/rspack.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_core = require("./core-CA2hGS8D.cjs");
+const require_core = require("./core-BqEruPuj.cjs");
 //#region src/rspack.ts
 const animusRspack = (0, require("unplugin").createRspackPlugin)(require_core.unpluginFactory);
 //#endregion

package/dist/rspack.d.ts

@@ -1,4 +1,4 @@
 export type { AnimusUnpluginOptions } from './options';
-export declare const animusRspack: (options?: import("@animus-ui/extract/pipeline").AnimusCoreOptions | undefined) => RspackPluginInstance;
+export declare const animusRspack: (options?: import("./options").AnimusUnpluginOptions | undefined) => RspackPluginInstance;
 export default animusRspack;
 //# sourceMappingURL=rspack.d.ts.map

package/dist/rspack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rspack.d.ts","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,YAAY,yGAAsC,CAAC;eAEjD,YAAY"}
+{"version":3,"file":"rspack.d.ts","sourceRoot":"","sources":["../src/rspack.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,YAAY,2FAAsC,CAAC;eAEjD,YAAY"}

package/dist/rspack.mjs

@@ -1,4 +1,4 @@
-import { t as unpluginFactory } from "./core-BefIaJxu.mjs";
+import { t as unpluginFactory } from "./core-CP2SnWlP.mjs";
 import { createRspackPlugin } from "unplugin";
 //#region src/rspack.ts
 const animusRspack = createRspackPlugin(unpluginFactory);

package/dist/webpack.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_core = require("./core-CA2hGS8D.cjs");
+const require_core = require("./core-BqEruPuj.cjs");
 //#region src/webpack.ts
 const animusWebpack = (0, require("unplugin").createWebpackPlugin)(require_core.unpluginFactory);
 //#endregion

package/dist/webpack.d.ts

@@ -1,4 +1,4 @@
 export type { AnimusUnpluginOptions } from './options';
-export declare const animusWebpack: (options?: import("@animus-ui/extract/pipeline").AnimusCoreOptions | undefined) => import("unplugin").WebpackPluginInstance;
+export declare const animusWebpack: (options?: import("./options").AnimusUnpluginOptions | undefined) => import("unplugin").WebpackPluginInstance;
 export default animusWebpack;
 //# sourceMappingURL=webpack.d.ts.map

package/dist/webpack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../src/webpack.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,aAAa,6HAAuC,CAAC;eAEnD,aAAa"}
+{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../src/webpack.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,eAAO,MAAM,aAAa,+GAAuC,CAAC;eAEnD,aAAa"}

package/dist/webpack.mjs

@@ -1,4 +1,4 @@
-import { t as unpluginFactory } from "./core-BefIaJxu.mjs";
+import { t as unpluginFactory } from "./core-CP2SnWlP.mjs";
 import { createWebpackPlugin } from "unplugin";
 //#region src/webpack.ts
 const animusWebpack = createWebpackPlugin(unpluginFactory);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/unplugin",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "Animus transform host for non-plugin bundlers — unplugin-based rollup/esbuild/rspack/webpack entry points over the one extraction session",
   "keywords": [
     "animus",
@@ -57,7 +57,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.22",
+    "@animus-ui/extract": "0.1.24",
     "unplugin": "^3.3.0"
   },
   "engines": {