@animus-ui/next-plugin 0.1.8 → 0.1.9

package/dist/extraction-session.d.ts

@@ -64,6 +64,9 @@ export declare class ExtractionSession {
      *  ownership, design D2; duplicate specifiers resolving to one canonical
      *  root share it). Engine watch wiring and tests read this. */
     externalRootOwners: Map<string, Set<string>>;
+    /** Canonical external root → the extension set its collection walk used
+     *  (widened for dist-only roots); rewalks and classification share it. */
+    private externalRootExtensions;
     /** Canonical admitted external watch roots — the engine-side watch
      *  surface (webpack contextDependencies / Turbopack watchers). */
     externalWatchRoots: string[];
@@ -160,6 +163,14 @@ export declare class ExtractionSession {
      * joiner; the gate always clears.
      */
     handleWatchUpdate(changes: WatchChanges): Promise<void>;
+    /**
+     * Owner-side entry for a batch observed by a NON-OWNING compiler's
+     * watcher. Serializes behind any in-flight transaction, then runs the
+     * forwarded batch as its own transaction — never drops it (a forwarded
+     * batch has no other delivery; content-hash diffing makes an
+     * already-covered batch a cheap no-op).
+     */
+    ingestForwardedBatch(changes: WatchChanges): Promise<void>;
     /**
      * Incremental watch pass: geological reset when the system file changed,
      * otherwise content-hash diffing restricted to the watcher's change sets

package/dist/extraction-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-session.d.ts","sourceRoot":"","sources":["../src/extraction-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extraction-session.d.ts","sourceRoot":"","sources":["../src/extraction-session.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_session_paths = require("./session-paths-CZoi19NW.cjs");
-const require_singleton = require("./singleton-D4vhawsW.cjs");
+const require_singleton = require("./singleton-BjZyw_8b.cjs");
 require("./turbopack-loader.cjs");
 let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
 let fs = require("fs");
@@ -174,6 +174,9 @@ var ExtractionSession = class {
 	*  ownership, design D2; duplicate specifiers resolving to one canonical
 	*  root share it). Engine watch wiring and tests read this. */
 	externalRootOwners = /* @__PURE__ */ new Map();
+	/** Canonical external root → the extension set its collection walk used
+	*  (widened for dist-only roots); rewalks and classification share it. */
+	externalRootExtensions = /* @__PURE__ */ new Map();
 	/** Canonical admitted external watch roots — the engine-side watch
 	*  surface (webpack contextDependencies / Turbopack watchers). */
 	externalWatchRoots = [];
@@ -304,7 +307,34 @@ var ExtractionSession = class {
 			await inflight;
 			return;
 		}
+		if (!this.system) {
+			const owner = require_singleton.getOwningWatchSession();
+			const hasBatch = (changes.modifiedFiles?.size ?? 0) > 0 || (changes.removedFiles?.size ?? 0) > 0;
+			if (owner && owner !== this && hasBatch) await owner.ingestForwardedBatch(changes);
+			return;
+		}
+		const transaction = this.processWatchUpdate(changes);
+		require_singleton.setWatchTransaction(transaction);
+		try {
+			await transaction;
+		} finally {
+			require_singleton.setWatchTransaction(null);
+		}
+	}
+	/**
+	* Owner-side entry for a batch observed by a NON-OWNING compiler's
+	* watcher. Serializes behind any in-flight transaction, then runs the
+	* forwarded batch as its own transaction — never drops it (a forwarded
+	* batch has no other delivery; content-hash diffing makes an
+	* already-covered batch a cheap no-op).
+	*/
+	async ingestForwardedBatch(changes) {
 		if (!this.system) return;
+		for (;;) {
+			const inflight = require_singleton.getWatchTransaction();
+			if (!inflight) break;
+			await inflight;
+		}
 		const transaction = this.processWatchUpdate(changes);
 		require_singleton.setWatchTransaction(transaction);
 		try {
@@ -361,6 +391,7 @@ var ExtractionSession = class {
 			if (!priorCacheEntries.has(key)) priorCacheEntries.set(key, this.fileCache.get(key) ?? null);
 		};
 		const inventoryUpdates = [];
+		const ownerRemovals = [];
 		let removedAny = false;
 		if (changes.removedFiles) for (const removedPath of changes.removedFiles) {
 			let key;
@@ -383,8 +414,7 @@ var ExtractionSession = class {
 						hash: null,
 						abs: removedPath
 					});
-					delete this.externalFileOwners[key];
-					delete this.externalFileOwners[key + ".tsx"];
+					ownerRemovals.push(key, key + ".tsx");
 				}
 			}
 		}
@@ -468,6 +498,7 @@ var ExtractionSession = class {
 					abs: update.abs
 				});
 			}
+			for (const key of ownerRemovals) delete this.externalFileOwners[key];
 		} else if (this.statusAttemptOpen) {
 			this.debouncePending.clear();
 			this.writeAnalysisStatus("idle", []);
@@ -626,11 +657,14 @@ var ExtractionSession = class {
 		const admitted = (0, _animus_ui_extract_pipeline.excludeCollectedPackages)(collected, rejectedSpecifiers, rootDir);
 		const identity = (0, _animus_ui_extract_pipeline.createSourceIdentity)(rootDir);
 		this.externalRootOwners = /* @__PURE__ */ new Map();
+		this.externalRootExtensions = /* @__PURE__ */ new Map();
 		for (const [dir, specifiers] of Object.entries(admitted.dirOwnerSets)) {
 			const canonical = identity.registerExternalRoot(dir);
 			const owners = this.externalRootOwners.get(canonical) ?? /* @__PURE__ */ new Set();
 			for (const specifier of specifiers) owners.add(specifier);
 			this.externalRootOwners.set(canonical, owners);
+			const exts = admitted.dirExtensions[dir];
+			if (exts) this.externalRootExtensions.set(canonical, new Set(exts));
 		}
 		this.sourceIdentity = identity;
 		this.externalWatchRoots = identity.externalRoots();
@@ -673,12 +707,13 @@ var ExtractionSession = class {
 			const merge = (0, _animus_ui_extract_pipeline.mergeExternalKeyframes)((entry, root) => api.scanKeyframesExports(entry, root), this.system.keyframesJson, admitted.keyframesScanEntries.values(), this.rootDir);
 			this.system.keyframesJson = merge.keyframesJson;
 			this.externalKeyframesDiagnostics = merge.diagnostics;
-		}
+		} else this.externalKeyframesDiagnostics = [];
 		bt.packageResolve = this.elapsed(t);
 		const universe = new Set(fileEntries.map((entry) => entry.path));
 		for (const key of [...this.fileCache.keys()]) if (!universe.has(key)) this.fileCache.delete(key);
 		await this.analyzeAndEmit(fileEntries, packageMap, false, bt, pipelineStart, pending);
 		this.onExternalRootsCommitted?.(this.externalWatchRoots);
+		require_singleton.setOwningWatchSession(this);
 	}
 	/**
 	* Reset analysis state for HMR geological reset. Payload write guards go
@@ -759,7 +794,8 @@ var ExtractionSession = class {
 		for (const root of dirtyRoots) {
 			const previous = this.externalInventory.get(root) ?? /* @__PURE__ */ new Map();
 			const seen = /* @__PURE__ */ new Set();
-			const walked = (0, _animus_ui_extract_pipeline.walkPackageSources)(root, extensionsSet);
+			const walked = (0, _animus_ui_extract_pipeline.walkPackageSources)(root, this.externalRootExtensions.get(root) ?? extensionsSet);
+			if (walked.length === 0 && previous.size > 0) this.warn(`external root rewalk found no files under ${root} while its inventory holds ${previous.size} — reconciling as full deletion`);
 			for (const abs of walked) {
 				const resolved = identity.resolveSourceId(abs);
 				if (!resolved || resolved.owningRoot !== root) continue;
@@ -788,9 +824,10 @@ var ExtractionSession = class {
 	* Returns null for dropped paths.
 	*/
 	classifyWatchPath(absPath, scan) {
-		if (!scan.extensionsSet.has((0, path.extname)(absPath))) return null;
+		const ext = (0, path.extname)(absPath);
 		const rootDir = this.rootDir;
 		if ((0, _animus_ui_extract_pipeline.isPathWithinRoot)(rootDir, absPath)) {
+			if (!scan.extensionsSet.has(ext)) return null;
 			const rel = (0, path.relative)(rootDir, absPath);
 			if (scan.excludePatterns.some((pattern) => absPath.includes(pattern) || rel.includes(pattern))) return null;
 			return {
@@ -801,12 +838,14 @@ var ExtractionSession = class {
 		const resolved = this.sourceIdentity?.resolveSourceId(absPath);
 		if (!resolved) return null;
 		if (resolved.owningRoot === null) {
+			if (!scan.extensionsSet.has(ext)) return null;
 			if (scan.excludePatterns.some((pattern) => resolved.sourceKey.includes(pattern))) return null;
 			return {
 				key: resolved.sourceKey,
 				owningRoot: null
 			};
 		}
+		if (!(this.externalRootExtensions.get(resolved.owningRoot) ?? scan.extensionsSet).has(ext)) return null;
 		if ((0, _animus_ui_extract_pipeline.isExcludedPackageRelativePath)(resolved.pathInRoot)) return null;
 		return {
 			key: resolved.sourceKey,
@@ -895,6 +934,7 @@ var ExtractionSession = class {
 			strict: this.options.strict,
 			extraDiagnostics: this.externalKeyframesDiagnostics
 		});
+		(0, _animus_ui_extract_pipeline.assertNoErrorDiagnostics)(result.manifest?.diagnostics);
 		(0, _animus_ui_extract_pipeline.enforceExternalTokenContracts)({
 			diagnostics: result.manifest?.diagnostics,
 			fileOwners: this.externalFileOwners,
@@ -1001,7 +1041,11 @@ var ExtractionSession = class {
 		queueMicrotask(() => {
 			this.debounceStatusWriteScheduled = false;
 			if (this.debouncePending.size === 0) return;
-			this.writeAnalysisStatus("debouncing", [...this.debouncePending.entries()]);
+			try {
+				this.writeAnalysisStatus("debouncing", [...this.debouncePending.entries()]);
+			} catch (err) {
+				this.warn(`debounce status write failed: ${String(err)}`);
+			}
 		});
 	}
 	/** One pending microtask flushes a burst of debounce observations. */
@@ -1097,13 +1141,14 @@ var ExtractionSession = class {
 	* artifacts (below) — the webpack cold-cache validity witness.
 	*/
 	publishReplacementEpoch(epoch) {
-		if (this.lastEpochValue === null) this.lastEpochValue = this.diskEpochValue();
+		const onDisk = this.diskEpochValue();
+		if (this.lastEpochValue === null) this.lastEpochValue = onDisk;
+		if (epoch !== onDisk) this.writeSessionArtifact(require_session_paths.REPLACEMENT_EPOCH_ARTIFACT, JSON.stringify({
+			schema: 1,
+			sessionId: this.sessionId,
+			epoch
+		}));
 		if (epoch !== this.lastEpochValue) {
-			this.writeSessionArtifact(require_session_paths.REPLACEMENT_EPOCH_ARTIFACT, JSON.stringify({
-				schema: 1,
-				sessionId: this.sessionId,
-				epoch
-			}));
 			this.lastEpochValue = epoch;
 			this.reconcileSiblingEpochs(epoch);
 		}
@@ -1487,7 +1532,7 @@ var AnimusWebpackPlugin = class {
 			});
 		});
 		compiler.hooks.run.tapPromise(PLUGIN_NAME, async (_compiler) => {
-			this.session.rootDir = _compiler.context;
+			this.adoptCompilerContext(_compiler);
 			this.extractAliases(_compiler);
 			const existing = require_singleton.getAnalysisPromise();
 			if (existing) {
@@ -1499,7 +1544,7 @@ var AnimusWebpackPlugin = class {
 			await promise;
 		});
 		compiler.hooks.watchRun.tapPromise(PLUGIN_NAME, async (_compiler) => {
-			this.session.rootDir = _compiler.context;
+			this.adoptCompilerContext(_compiler);
 			this.extractAliases(_compiler);
 			if (!this.initialized) {
 				const existing = require_singleton.getAnalysisPromise();
@@ -1534,11 +1579,34 @@ var AnimusWebpackPlugin = class {
 		return this.session.sessionId;
 	}
 	/** Set the project root at CONFIG time (with-animus) — the ONE root all
-	*  session-path derivations use. The compiler hooks re-assert it from
-	*  compiler.context (identical when compiler.context === cwd). */
+	*  session-path derivations use. The compiler hooks ADOPT
+	*  compiler.context only when no root was published (bare-apply
+	*  harnesses); they never overwrite this. */
 	setRootDir(rootDir) {
 		this.session.rootDir = rootDir;
 	}
+	/** One warning per plugin instance for a context/root mismatch. */
+	warnedRootDivergence = false;
+	/** The run/watchRun taps' root handling: adopt compiler.context when no
+	*  config-time root exists; otherwise KEEP the configured root — every
+	*  frozen config-time derivation (stub path, css alias target,
+	*  virtual:animus/system-props target, watch-ignore) came from it, and a
+	*  silent overwrite re-keys sessionDir so the pipeline publishes
+	*  artifacts where none of those consumers look. A disagreement is
+	*  surfaced loudly instead (with-animus derives the root from Next's own
+	*  `dir`, which equals compiler.context in real Next runs — a mismatch
+	*  means a custom-webpack setup wired the plugin differently). */
+	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`);
+		}
+	}
 	/** This session's artifact directory, derived from the one root. */
 	get sessionDir() {
 		return this.session.sessionDir;
@@ -1860,7 +1928,7 @@ function withAnimus(options) {
 			...nextConfig,
 			webpack(config, context) {
 				if (typeof existingWebpack === "function") config = existingWebpack(config, context);
-				const rootDir = process.cwd();
+				const rootDir = typeof context.dir === "string" && context.dir.length > 0 ? context.dir : process.cwd();
 				const plugin = new AnimusWebpackPlugin(options);
 				plugin.setRootDir(rootDir);
 				const sessionDir = plugin.sessionDir;

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { S as __require, _ as replacementEpochPath, a as REPLACEMENT_EPOCH_ARTIFACT, b as stylesPath, c as SYSTEM_PROPS_ARTIFACT, f as envelopeCssArtifact, g as readJsonEnvelope, h as readCssEnvelope, i as MANIFEST_ARTIFACT, l as analysisCommitPath, n as ANALYSIS_INPUTS_ARTIFACT, o as SESSION_ASSETS_DIR, p as envelopeJsonArtifact, r as ANALYSIS_STATUS_ARTIFACT, s as STYLES_ARTIFACT, t as ANALYSIS_COMMIT_ARTIFACT, v as sessionArtifactDir, x as systemPropsPath, y as sessionsRootDir } from "./session-paths-DfYIPDcM.mjs";
-import { C as setWatchTransaction, S as setSharedSystemProps, _ as setSessionArtifactDir, b as setSharedExternalDirs, c as getSharedCss, d as getWatchTransaction, f as resetAnalysisPromise, g as setReplacementEpoch, h as setManifestJson, l as getSharedExternalDirs, m as setAnalyzedHashes, n as engineApi, o as getReplacementEpoch, p as setAnalysisPromise, r as getAnalysisPromise, t as claimProcessSessionId, u as getSharedExternalEntries, v as setSharedCss, x as setSharedExternalEntries, y as setSharedEngine } from "./singleton-372wiSRr.mjs";
-import { DEFAULT_EXTENSIONS, assembleStylesheet, assertNoRetiredEngineSelection, buildPathAliasesJson, buildSystemPropsModule, clearEngineCache, collectExternalPackageSources, contentHash, createSourceIdentity, discoverFiles, enforceExternalTokenContracts, excludeCollectedPackages, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, firstOwners, formatRustTimingWaterfall, hashReplacementPlans, isExcludedPackageRelativePath, isPathWithinRoot, loadSystemConfig, mergeExternalKeyframes, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAssetFile, resolveLightningTargets, runProjectAnalysis, serializeStaticCss, sharesVolumeRoot, snapshotFilePlans, staleDistIncludesMessage, substituteAssetPlaceholders, toWatchKeys, unresolvableIncludesMessage, walkPackageSources } from "@animus-ui/extract/pipeline";
+import { C as setSharedExternalEntries, S as setSharedExternalDirs, T as setWatchTransaction, _ as setOwningWatchSession, b as setSharedCss, d as getSharedExternalEntries, f as getWatchTransaction, g as setManifestJson, h as setAnalyzedHashes, l as getSharedCss, m as setAnalysisPromise, n as engineApi, o as getOwningWatchSession, p as resetAnalysisPromise, r as getAnalysisPromise, s as getReplacementEpoch, t as claimProcessSessionId, u as getSharedExternalDirs, v as setReplacementEpoch, w as setSharedSystemProps, x as setSharedEngine, y as setSessionArtifactDir } from "./singleton-BjSsGjsg.mjs";
+import { DEFAULT_EXTENSIONS, assembleStylesheet, assertNoErrorDiagnostics, assertNoRetiredEngineSelection, buildPathAliasesJson, buildSystemPropsModule, clearEngineCache, collectExternalPackageSources, contentHash, createSourceIdentity, discoverFiles, enforceExternalTokenContracts, excludeCollectedPackages, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, firstOwners, formatRustTimingWaterfall, hashReplacementPlans, isExcludedPackageRelativePath, isPathWithinRoot, loadSystemConfig, mergeExternalKeyframes, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAssetFile, resolveLightningTargets, runProjectAnalysis, serializeStaticCss, sharesVolumeRoot, snapshotFilePlans, staleDistIncludesMessage, substituteAssetPlaceholders, toWatchKeys, unresolvableIncludesMessage, walkPackageSources } from "@animus-ui/extract/pipeline";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, watch, writeFileSync } from "fs";
 import { basename, dirname, extname, join, relative, resolve } from "path";
 import { fileURLToPath } from "url";
@@ -172,6 +172,9 @@ var ExtractionSession = class {
 	*  ownership, design D2; duplicate specifiers resolving to one canonical
 	*  root share it). Engine watch wiring and tests read this. */
 	externalRootOwners = /* @__PURE__ */ new Map();
+	/** Canonical external root → the extension set its collection walk used
+	*  (widened for dist-only roots); rewalks and classification share it. */
+	externalRootExtensions = /* @__PURE__ */ new Map();
 	/** Canonical admitted external watch roots — the engine-side watch
 	*  surface (webpack contextDependencies / Turbopack watchers). */
 	externalWatchRoots = [];
@@ -302,7 +305,34 @@ var ExtractionSession = class {
 			await inflight;
 			return;
 		}
+		if (!this.system) {
+			const owner = getOwningWatchSession();
+			const hasBatch = (changes.modifiedFiles?.size ?? 0) > 0 || (changes.removedFiles?.size ?? 0) > 0;
+			if (owner && owner !== this && hasBatch) await owner.ingestForwardedBatch(changes);
+			return;
+		}
+		const transaction = this.processWatchUpdate(changes);
+		setWatchTransaction(transaction);
+		try {
+			await transaction;
+		} finally {
+			setWatchTransaction(null);
+		}
+	}
+	/**
+	* Owner-side entry for a batch observed by a NON-OWNING compiler's
+	* watcher. Serializes behind any in-flight transaction, then runs the
+	* forwarded batch as its own transaction — never drops it (a forwarded
+	* batch has no other delivery; content-hash diffing makes an
+	* already-covered batch a cheap no-op).
+	*/
+	async ingestForwardedBatch(changes) {
 		if (!this.system) return;
+		for (;;) {
+			const inflight = getWatchTransaction();
+			if (!inflight) break;
+			await inflight;
+		}
 		const transaction = this.processWatchUpdate(changes);
 		setWatchTransaction(transaction);
 		try {
@@ -359,6 +389,7 @@ var ExtractionSession = class {
 			if (!priorCacheEntries.has(key)) priorCacheEntries.set(key, this.fileCache.get(key) ?? null);
 		};
 		const inventoryUpdates = [];
+		const ownerRemovals = [];
 		let removedAny = false;
 		if (changes.removedFiles) for (const removedPath of changes.removedFiles) {
 			let key;
@@ -381,8 +412,7 @@ var ExtractionSession = class {
 						hash: null,
 						abs: removedPath
 					});
-					delete this.externalFileOwners[key];
-					delete this.externalFileOwners[key + ".tsx"];
+					ownerRemovals.push(key, key + ".tsx");
 				}
 			}
 		}
@@ -466,6 +496,7 @@ var ExtractionSession = class {
 					abs: update.abs
 				});
 			}
+			for (const key of ownerRemovals) delete this.externalFileOwners[key];
 		} else if (this.statusAttemptOpen) {
 			this.debouncePending.clear();
 			this.writeAnalysisStatus("idle", []);
@@ -624,11 +655,14 @@ var ExtractionSession = class {
 		const admitted = excludeCollectedPackages(collected, rejectedSpecifiers, rootDir);
 		const identity = createSourceIdentity(rootDir);
 		this.externalRootOwners = /* @__PURE__ */ new Map();
+		this.externalRootExtensions = /* @__PURE__ */ new Map();
 		for (const [dir, specifiers] of Object.entries(admitted.dirOwnerSets)) {
 			const canonical = identity.registerExternalRoot(dir);
 			const owners = this.externalRootOwners.get(canonical) ?? /* @__PURE__ */ new Set();
 			for (const specifier of specifiers) owners.add(specifier);
 			this.externalRootOwners.set(canonical, owners);
+			const exts = admitted.dirExtensions[dir];
+			if (exts) this.externalRootExtensions.set(canonical, new Set(exts));
 		}
 		this.sourceIdentity = identity;
 		this.externalWatchRoots = identity.externalRoots();
@@ -671,12 +705,13 @@ var ExtractionSession = class {
 			const merge = mergeExternalKeyframes((entry, root) => api.scanKeyframesExports(entry, root), this.system.keyframesJson, admitted.keyframesScanEntries.values(), this.rootDir);
 			this.system.keyframesJson = merge.keyframesJson;
 			this.externalKeyframesDiagnostics = merge.diagnostics;
-		}
+		} else this.externalKeyframesDiagnostics = [];
 		bt.packageResolve = this.elapsed(t);
 		const universe = new Set(fileEntries.map((entry) => entry.path));
 		for (const key of [...this.fileCache.keys()]) if (!universe.has(key)) this.fileCache.delete(key);
 		await this.analyzeAndEmit(fileEntries, packageMap, false, bt, pipelineStart, pending);
 		this.onExternalRootsCommitted?.(this.externalWatchRoots);
+		setOwningWatchSession(this);
 	}
 	/**
 	* Reset analysis state for HMR geological reset. Payload write guards go
@@ -757,7 +792,8 @@ var ExtractionSession = class {
 		for (const root of dirtyRoots) {
 			const previous = this.externalInventory.get(root) ?? /* @__PURE__ */ new Map();
 			const seen = /* @__PURE__ */ new Set();
-			const walked = walkPackageSources(root, extensionsSet);
+			const walked = walkPackageSources(root, this.externalRootExtensions.get(root) ?? extensionsSet);
+			if (walked.length === 0 && previous.size > 0) this.warn(`external root rewalk found no files under ${root} while its inventory holds ${previous.size} — reconciling as full deletion`);
 			for (const abs of walked) {
 				const resolved = identity.resolveSourceId(abs);
 				if (!resolved || resolved.owningRoot !== root) continue;
@@ -786,9 +822,10 @@ var ExtractionSession = class {
 	* Returns null for dropped paths.
 	*/
 	classifyWatchPath(absPath, scan) {
-		if (!scan.extensionsSet.has(extname(absPath))) return null;
+		const ext = extname(absPath);
 		const rootDir = this.rootDir;
 		if (isPathWithinRoot(rootDir, absPath)) {
+			if (!scan.extensionsSet.has(ext)) return null;
 			const rel = relative(rootDir, absPath);
 			if (scan.excludePatterns.some((pattern) => absPath.includes(pattern) || rel.includes(pattern))) return null;
 			return {
@@ -799,12 +836,14 @@ var ExtractionSession = class {
 		const resolved = this.sourceIdentity?.resolveSourceId(absPath);
 		if (!resolved) return null;
 		if (resolved.owningRoot === null) {
+			if (!scan.extensionsSet.has(ext)) return null;
 			if (scan.excludePatterns.some((pattern) => resolved.sourceKey.includes(pattern))) return null;
 			return {
 				key: resolved.sourceKey,
 				owningRoot: null
 			};
 		}
+		if (!(this.externalRootExtensions.get(resolved.owningRoot) ?? scan.extensionsSet).has(ext)) return null;
 		if (isExcludedPackageRelativePath(resolved.pathInRoot)) return null;
 		return {
 			key: resolved.sourceKey,
@@ -893,6 +932,7 @@ var ExtractionSession = class {
 			strict: this.options.strict,
 			extraDiagnostics: this.externalKeyframesDiagnostics
 		});
+		assertNoErrorDiagnostics(result.manifest?.diagnostics);
 		enforceExternalTokenContracts({
 			diagnostics: result.manifest?.diagnostics,
 			fileOwners: this.externalFileOwners,
@@ -999,7 +1039,11 @@ var ExtractionSession = class {
 		queueMicrotask(() => {
 			this.debounceStatusWriteScheduled = false;
 			if (this.debouncePending.size === 0) return;
-			this.writeAnalysisStatus("debouncing", [...this.debouncePending.entries()]);
+			try {
+				this.writeAnalysisStatus("debouncing", [...this.debouncePending.entries()]);
+			} catch (err) {
+				this.warn(`debounce status write failed: ${String(err)}`);
+			}
 		});
 	}
 	/** One pending microtask flushes a burst of debounce observations. */
@@ -1095,13 +1139,14 @@ var ExtractionSession = class {
 	* artifacts (below) — the webpack cold-cache validity witness.
 	*/
 	publishReplacementEpoch(epoch) {
-		if (this.lastEpochValue === null) this.lastEpochValue = this.diskEpochValue();
+		const onDisk = this.diskEpochValue();
+		if (this.lastEpochValue === null) this.lastEpochValue = onDisk;
+		if (epoch !== onDisk) this.writeSessionArtifact(REPLACEMENT_EPOCH_ARTIFACT, JSON.stringify({
+			schema: 1,
+			sessionId: this.sessionId,
+			epoch
+		}));
 		if (epoch !== this.lastEpochValue) {
-			this.writeSessionArtifact(REPLACEMENT_EPOCH_ARTIFACT, JSON.stringify({
-				schema: 1,
-				sessionId: this.sessionId,
-				epoch
-			}));
 			this.lastEpochValue = epoch;
 			this.reconcileSiblingEpochs(epoch);
 		}
@@ -1485,7 +1530,7 @@ var AnimusWebpackPlugin = class {
 			});
 		});
 		compiler.hooks.run.tapPromise(PLUGIN_NAME, async (_compiler) => {
-			this.session.rootDir = _compiler.context;
+			this.adoptCompilerContext(_compiler);
 			this.extractAliases(_compiler);
 			const existing = getAnalysisPromise();
 			if (existing) {
@@ -1497,7 +1542,7 @@ var AnimusWebpackPlugin = class {
 			await promise;
 		});
 		compiler.hooks.watchRun.tapPromise(PLUGIN_NAME, async (_compiler) => {
-			this.session.rootDir = _compiler.context;
+			this.adoptCompilerContext(_compiler);
 			this.extractAliases(_compiler);
 			if (!this.initialized) {
 				const existing = getAnalysisPromise();
@@ -1532,11 +1577,34 @@ var AnimusWebpackPlugin = class {
 		return this.session.sessionId;
 	}
 	/** Set the project root at CONFIG time (with-animus) — the ONE root all
-	*  session-path derivations use. The compiler hooks re-assert it from
-	*  compiler.context (identical when compiler.context === cwd). */
+	*  session-path derivations use. The compiler hooks ADOPT
+	*  compiler.context only when no root was published (bare-apply
+	*  harnesses); they never overwrite this. */
 	setRootDir(rootDir) {
 		this.session.rootDir = rootDir;
 	}
+	/** One warning per plugin instance for a context/root mismatch. */
+	warnedRootDivergence = false;
+	/** The run/watchRun taps' root handling: adopt compiler.context when no
+	*  config-time root exists; otherwise KEEP the configured root — every
+	*  frozen config-time derivation (stub path, css alias target,
+	*  virtual:animus/system-props target, watch-ignore) came from it, and a
+	*  silent overwrite re-keys sessionDir so the pipeline publishes
+	*  artifacts where none of those consumers look. A disagreement is
+	*  surfaced loudly instead (with-animus derives the root from Next's own
+	*  `dir`, which equals compiler.context in real Next runs — a mismatch
+	*  means a custom-webpack setup wired the plugin differently). */
+	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`);
+		}
+	}
 	/** This session's artifact directory, derived from the one root. */
 	get sessionDir() {
 		return this.session.sessionDir;
@@ -1858,7 +1926,7 @@ function withAnimus(options) {
 			...nextConfig,
 			webpack(config, context) {
 				if (typeof existingWebpack === "function") config = existingWebpack(config, context);
-				const rootDir = process.cwd();
+				const rootDir = typeof context.dir === "string" && context.dir.length > 0 ? context.dir : process.cwd();
 				const plugin = new AnimusWebpackPlugin(options);
 				plugin.setRootDir(rootDir);
 				const sessionDir = plugin.sessionDir;

package/dist/loader.cjs

@@ -1,14 +1,18 @@
 const require_session_paths = require("./session-paths-CZoi19NW.cjs");
-const require_singleton = require("./singleton-D4vhawsW.cjs");
+const require_singleton = require("./singleton-BjZyw_8b.cjs");
 const require_loader_core = require("./loader-core-C40WbC6s.cjs");
 require("./turbopack-loader.cjs");
 let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
 let fs = require("fs");
 let path = require("path");
 //#region src/loader.ts
-/** Session dirs whose epoch artifact has been SEEN on disk — the artifact
-*  is never deleted once written, so a positive existsSync is stable for
-*  the life of the process (negatives always re-probe). */
+/** Session dirs whose epoch artifact has been SEEN on disk. A sibling
+*  session's reconciliation may delete the artifact, but the owning
+*  session self-heals it on its next publish, so a positive existsSync
+*  stays a sound basis for registering the dependency: a module built
+*  during the missing window records a missing-file witness that the
+*  recreation then invalidates (over-invalidation, never under).
+*  Negatives always re-probe. */
 const epochSeenForSessionDir = /* @__PURE__ */ new Set();
 /**
 * Webpack loader for Animus source transformation.

package/dist/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOzD,KAAK,aAAa,GAAG;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,mBAAmB,CAAC;IACtC;uDACmD;IACnD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,uEAAuE;IACvE,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAmDR"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAWzD,KAAK,aAAa,GAAG;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,mBAAmB,CAAC;IACtC;uDACmD;IACnD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,uEAAuE;IACvE,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAmDR"}

package/dist/loader.mjs

@@ -1,13 +1,17 @@
 import { _ as replacementEpochPath } from "./session-paths-DfYIPDcM.mjs";
-import { a as getManifestJson, i as getAnalyzedHashes, n as engineApi, s as getSessionArtifactDir } from "./singleton-372wiSRr.mjs";
+import { a as getManifestJson, c as getSessionArtifactDir, i as getAnalyzedHashes, n as engineApi } from "./singleton-BjSsGjsg.mjs";
 import { t as transformWithManifest } from "./loader-core-D6Tm_b8F.mjs";
 import { contentHash } from "@animus-ui/extract/pipeline";
 import { existsSync } from "fs";
 import { relative } from "path";
 //#region src/loader.ts
-/** Session dirs whose epoch artifact has been SEEN on disk — the artifact
-*  is never deleted once written, so a positive existsSync is stable for
-*  the life of the process (negatives always re-probe). */
+/** Session dirs whose epoch artifact has been SEEN on disk. A sibling
+*  session's reconciliation may delete the artifact, but the owning
+*  session self-heals it on its next publish, so a positive existsSync
+*  stays a sound basis for registering the dependency: a module built
+*  during the missing window records a missing-file witness that the
+*  recreation then invalidates (over-invalidation, never under).
+*  Negatives always re-probe. */
 const epochSeenForSessionDir = /* @__PURE__ */ new Set();
 /**
 * Webpack loader for Animus source transformation.

package/dist/plugin.d.ts

@@ -138,9 +138,22 @@ export declare class AnimusWebpackPlugin {
      *  session-scoped alias/stub paths from it (design D2). */
     get sessionId(): string;
     /** Set the project root at CONFIG time (with-animus) — the ONE root all
-     *  session-path derivations use. The compiler hooks re-assert it from
-     *  compiler.context (identical when compiler.context === cwd). */
+     *  session-path derivations use. The compiler hooks ADOPT
+     *  compiler.context only when no root was published (bare-apply
+     *  harnesses); they never overwrite this. */
     setRootDir(rootDir: string): void;
+    /** One warning per plugin instance for a context/root mismatch. */
+    private warnedRootDivergence;
+    /** The run/watchRun taps' root handling: adopt compiler.context when no
+     *  config-time root exists; otherwise KEEP the configured root — every
+     *  frozen config-time derivation (stub path, css alias target,
+     *  virtual:animus/system-props target, watch-ignore) came from it, and a
+     *  silent overwrite re-keys sessionDir so the pipeline publishes
+     *  artifacts where none of those consumers look. A disagreement is
+     *  surfaced loudly instead (with-animus derives the root from Next's own
+     *  `dir`, which equals compiler.context in real Next runs — a mismatch
+     *  means a custom-webpack setup wired the plugin differently). */
+    private adoptCompilerContext;
     /** This session's artifact directory, derived from the one root. */
     get sessionDir(): string;
     /** Expose options for the loader */

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/{singleton-372wiSRr.mjs → singleton-BjSsGjsg.mjs}

@@ -67,10 +67,25 @@ const REPLACEMENT_EPOCH_KEY = "__animus_replacement_epoch__";
 const WATCH_TRANSACTION_KEY = "__animus_watch_transaction__";
 const PROCESS_SESSION_ID_KEY = "__animus_process_session_id__";
 const SESSION_ARTIFACT_DIR_KEY = "__animus_session_artifact_dir__";
+const OWNING_WATCH_SESSION_KEY = "__animus_owning_watch_session__";
 const analyzedHashesSlot = globalSlot(ANALYZED_HASHES_KEY);
 const replacementEpochSlot = globalSlot(REPLACEMENT_EPOCH_KEY);
 const watchTransactionSlot = globalSlot(WATCH_TRANSACTION_KEY);
 const sessionArtifactDirSlot = globalSlot(SESSION_ARTIFACT_DIR_KEY);
+const owningWatchSessionSlot = globalSlot(OWNING_WATCH_SESSION_KEY);
+/**
+* The session that completed the full pipeline and holds system state — the
+* only instance that can run watch analysis. Each MultiCompiler child holds
+* its own session AND its own watcher with its own modified set; a
+* non-owning session forwards its batch here instead of dropping it (a file
+* only that compiler watches would otherwise never be analyzed).
+*/
+function getOwningWatchSession() {
+	return owningWatchSessionSlot.get();
+}
+function setOwningWatchSession(session) {
+	owningWatchSessionSlot.set(session);
+}
 /**
 * Per-file analyzed content hashes of the last published analysis (relPath →
 * contentHash of the exact bytes analyzed) — the loader's witness for the
@@ -199,4 +214,4 @@ function engineApi() {
 	return v2EngineApi();
 }
 //#endregion
-export { setWatchTransaction as C, setSharedSystemProps as S, setSessionArtifactDir as _, getManifestJson as a, setSharedExternalDirs as b, getSharedCss as c, getWatchTransaction as d, resetAnalysisPromise as f, setReplacementEpoch as g, setManifestJson as h, getAnalyzedHashes as i, getSharedExternalDirs as l, setAnalyzedHashes as m, engineApi as n, getReplacementEpoch as o, setAnalysisPromise as p, getAnalysisPromise as r, getSessionArtifactDir as s, claimProcessSessionId as t, getSharedExternalEntries as u, setSharedCss as v, setSharedExternalEntries as x, setSharedEngine as y };
+export { setSharedExternalEntries as C, setSharedExternalDirs as S, setWatchTransaction as T, setOwningWatchSession as _, getManifestJson as a, setSharedCss as b, getSessionArtifactDir as c, getSharedExternalEntries as d, getWatchTransaction as f, setManifestJson as g, setAnalyzedHashes as h, getAnalyzedHashes as i, getSharedCss as l, setAnalysisPromise as m, engineApi as n, getOwningWatchSession as o, resetAnalysisPromise as p, getAnalysisPromise as r, getReplacementEpoch as s, claimProcessSessionId as t, getSharedExternalDirs as u, setReplacementEpoch as v, setSharedSystemProps as w, setSharedEngine as x, setSessionArtifactDir as y };

package/dist/{singleton-D4vhawsW.cjs → singleton-BjZyw_8b.cjs}

@@ -67,10 +67,25 @@ const REPLACEMENT_EPOCH_KEY = "__animus_replacement_epoch__";
 const WATCH_TRANSACTION_KEY = "__animus_watch_transaction__";
 const PROCESS_SESSION_ID_KEY = "__animus_process_session_id__";
 const SESSION_ARTIFACT_DIR_KEY = "__animus_session_artifact_dir__";
+const OWNING_WATCH_SESSION_KEY = "__animus_owning_watch_session__";
 const analyzedHashesSlot = globalSlot(ANALYZED_HASHES_KEY);
 const replacementEpochSlot = globalSlot(REPLACEMENT_EPOCH_KEY);
 const watchTransactionSlot = globalSlot(WATCH_TRANSACTION_KEY);
 const sessionArtifactDirSlot = globalSlot(SESSION_ARTIFACT_DIR_KEY);
+const owningWatchSessionSlot = globalSlot(OWNING_WATCH_SESSION_KEY);
+/**
+* The session that completed the full pipeline and holds system state — the
+* only instance that can run watch analysis. Each MultiCompiler child holds
+* its own session AND its own watcher with its own modified set; a
+* non-owning session forwards its batch here instead of dropping it (a file
+* only that compiler watches would otherwise never be analyzed).
+*/
+function getOwningWatchSession() {
+	return owningWatchSessionSlot.get();
+}
+function setOwningWatchSession(session) {
+	owningWatchSessionSlot.set(session);
+}
 /**
 * Per-file analyzed content hashes of the last published analysis (relPath →
 * contentHash of the exact bytes analyzed) — the loader's witness for the
@@ -229,6 +244,12 @@ Object.defineProperty(exports, "getManifestJson", {
 		return getManifestJson;
 	}
 });
+Object.defineProperty(exports, "getOwningWatchSession", {
+	enumerable: true,
+	get: function() {
+		return getOwningWatchSession;
+	}
+});
 Object.defineProperty(exports, "getReplacementEpoch", {
 	enumerable: true,
 	get: function() {
@@ -289,6 +310,12 @@ Object.defineProperty(exports, "setManifestJson", {
 		return setManifestJson;
 	}
 });
+Object.defineProperty(exports, "setOwningWatchSession", {
+	enumerable: true,
+	get: function() {
+		return setOwningWatchSession;
+	}
+});
 Object.defineProperty(exports, "setReplacementEpoch", {
 	enumerable: true,
 	get: function() {

package/dist/singleton.d.ts

@@ -10,6 +10,24 @@ export declare function getSharedExternalDirs(): string[];
 export declare function setSharedExternalDirs(dirs: string[]): void;
 export declare function getSharedExternalEntries(): Map<string, string>;
 export declare function setSharedExternalEntries(entries: Map<string, string>): void;
+/** Structural view of the owning session a forwarded watch batch targets —
+ *  kept minimal (and defined here, not imported) so the singleton never
+ *  depends on the session module it serves. */
+export interface WatchBatchTarget {
+    ingestForwardedBatch(changes: {
+        modifiedFiles?: ReadonlySet<string>;
+        removedFiles?: ReadonlySet<string>;
+    }): Promise<void>;
+}
+/**
+ * The session that completed the full pipeline and holds system state — the
+ * only instance that can run watch analysis. Each MultiCompiler child holds
+ * its own session AND its own watcher with its own modified set; a
+ * non-owning session forwards its batch here instead of dropping it (a file
+ * only that compiler watches would otherwise never be analyzed).
+ */
+export declare function getOwningWatchSession(): WatchBatchTarget | null;
+export declare function setOwningWatchSession(session: WatchBatchTarget | null): void;
 /**
  * Per-file analyzed content hashes of the last published analysis (relPath →
  * contentHash of the exact bytes analyzed) — the loader's witness for the
@@ -74,5 +92,5 @@ export declare function engineApi(): any;
  * Every globalThis key this module owns — the single authority test
  * harnesses snapshot/clear per test (never re-declare this list).
  */
-export declare const SINGLETON_GLOBAL_KEYS: readonly ["__animus_manifest_json__", "__animus_analysis_promise__", "__animus_shared_css__", "__animus_shared_system_props__", "__animus_external_pkg_dirs__", "__animus_external_source_entries__", "__animus_analyzed_hashes__", "__animus_replacement_epoch__", "__animus_watch_transaction__", "__animus_process_session_id__", "__animus_session_artifact_dir__", "__animus_engine__", "__animus_v2_engine__", "__animus_v2_sent_sources__", "__animus_v2_drift_warned__"];
+export declare const SINGLETON_GLOBAL_KEYS: readonly ["__animus_manifest_json__", "__animus_analysis_promise__", "__animus_shared_css__", "__animus_shared_system_props__", "__animus_external_pkg_dirs__", "__animus_external_source_entries__", "__animus_analyzed_hashes__", "__animus_replacement_epoch__", "__animus_watch_transaction__", "__animus_process_session_id__", "__animus_session_artifact_dir__", "__animus_owning_watch_session__", "__animus_engine__", "__animus_v2_engine__", "__animus_v2_sent_sources__", "__animus_v2_drift_warned__"];
 //# sourceMappingURL=singleton.d.ts.map

package/dist/singleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAmBA,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAIzD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAMhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1D;AAED,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM9D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAG3E;AA4BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAE3E;AAID,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC;2EAC2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;uDAEuD;AAEvD,wBAAgB,aAAa,IAAI,GAAG,CAInC;AAoDD,wBAAgB,SAAS,IAAI,GAAG,CAE/B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,kdAgBxB,CAAC"}
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAmBA,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAIzD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAMhD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAE1D;AAED,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM9D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAG3E;AA6BD;;+CAE+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,OAAO,EAAE;QAC5B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,GAAG,IAAI,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAE3E;AAID,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC;AAEhC;2EAC2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;uDAEuD;AAEvD,wBAAgB,aAAa,IAAI,GAAG,CAInC;AAoDD,wBAAgB,SAAS,IAAI,GAAG,CAE/B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qfAiBxB,CAAC"}

package/dist/with-animus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-animus.d.ts","sourceRoot":"","sources":["../src/with-animus.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD,KAAK,aAAa,GAAG;IACnB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;YAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;YAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,GAAG,CAAC,EAAE,KAAK,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAC,CAAC;SACpE,CAAC,CAAC;KACJ,CAAC;CACH,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC1C,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,aAAa,CAAC;CACpB,CAAC;AAKF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,iBAAiB,GACzB,CAAC,UAAU,EAAE,UAAU,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAgN9D"}
+{"version":3,"file":"with-animus.d.ts","sourceRoot":"","sources":["../src/with-animus.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKjD,KAAK,aAAa,GAAG;IACnB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;YAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;YAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,GAAG,CAAC,EAAE,KAAK,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAC,CAAC;SACpE,CAAC,CAAC;KACJ,CAAC;CACH,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC1C,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,aAAa,CAAC;CACpB,CAAC;AAKF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,iBAAiB,GACzB,CAAC,UAAU,EAAE,UAAU,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAwN9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/next-plugin",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Animus static CSS extraction for Next.js (webpack)",
   "keywords": [
     "animus",
@@ -40,7 +40,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.8"
+    "@animus-ui/extract": "0.1.9"
   },
   "peerDependencies": {
     "@mdx-js/mdx": "^3.0.0",