@animus-ui/next-plugin 0.1.2 → 0.1.4

package/README.md

@@ -60,9 +60,9 @@ it in a server-only module and inline it as the first child of `<head>`.
 // appearance-bootstrap.ts — server-only; never import from a client component
 import { createAppearanceBootstrap } from '@animus-ui/system/bootstrap';
 
-import { tokens } from './src/ds';
+import { theme } from './src/ds';
 
-export const appearanceBootstrap = createAppearanceBootstrap(tokens);
+export const appearanceBootstrap = createAppearanceBootstrap(theme);
 ```
 
 ```tsx

package/dist/extraction-session.d.ts

@@ -31,6 +31,10 @@ export declare class ExtractionSession {
     rootDir: string | null;
     /** Serialized path aliases, harvested by the adapter from bundler config. */
     pathAliasesJson: string | null;
+    private assetCopyCache;
+    /** Physical asset files registered with the host watcher. */
+    assetDependencyPaths: Set<string>;
+    private assetDependencyKeys;
     /** When set (Turbopack orchestration), every analysis also persists
      *  `.animus/analysis-inputs.json` so isolated loader workers can hydrate.
      *  Webpack mode leaves this off — its loader shares the process. */
@@ -42,6 +46,10 @@ export declare class ExtractionSession {
     systemPropsModuleId: string | null;
     /** Absolute directory prefixes for external DS packages (loader allowlisting). */
     externalPackageDirs: string[];
+    /** Absolute package dir → owning specifier (cross-source correlation). */
+    private externalDirOwners;
+    /** rootDir-relative external file → owning specifier (correlation join). */
+    private externalFileOwners;
     /** External package specifier → absolute source entry path. */
     externalSourceEntries: Map<string, string>;
     private readonly options;
@@ -134,5 +142,34 @@ export declare class ExtractionSession {
      *  pid — Next dev evaluates the config in more than one process, and two
      *  sessions writing the same artifact must not race on one tmp path. */
     private writeAnimusFile;
+    /**
+     * asset() placeholder substitution (global-styles-system): resolve each
+     * referenced specifier through Node resolution, copy the bytes into
+     * `.animus/assets/` under a content-hashed name, and substitute a
+     * RELATIVE url. `.animus/styles.css` is processed by Next's own CSS
+     * pipeline (webpack and Turbopack alike), which applies its native asset
+     * handling — publicPath and output hashing — to relative url()
+     * references. Unsubstitutable specifiers warn and emit literally in
+     * non-strict mode, fail the build under `strict: true`.
+     */
+    private substituteAssetReferences;
+    private trackAssetDependency;
+    /**
+     * Resolve an asset specifier to an absolute file via the shared pipeline
+     * resolver (host aliases → Node resolution → package root), with one
+     * session-local last resort: an already-discovered source entry's package
+     * root (dist-less workspace kits the shared resolver cannot see).
+     */
+    private resolveAssetSpecifier;
 }
+/**
+ * Sync `.animus/assets/` to the current build's content-hashed file set:
+ * anything else in the directory is a superseded revision (the copies are
+ * content-addressed and never overwritten) or the leftover of an asset()
+ * reference that no longer exists. Failures are tolerated per entry — Next
+ * dev evaluates the config in more than one process, and a concurrent
+ * session may have removed (or be about to rewrite) the same file; every
+ * pass rewrites whatever of its own set is missing, so races self-heal.
+ */
+export declare function pruneStaleAssets(assetsDir: string, expected: ReadonlySet<string>): void;
 //# sourceMappingURL=extraction-session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"extraction-session.d.ts","sourceRoot":"","sources":["../src/extraction-session.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAOjD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAczD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC5B,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IACtC;;wEAEoE;IACpE,qBAAqB,UAAS;IAC9B;;;2EAGuE;IACvE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C,kFAAkF;IAClF,mBAAmB,EAAE,MAAM,EAAE,CAAM;IACnC,+DAA+D;IAC/D,qBAAqB,sBAA6B;IAElD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C;iFAC6E;IAC7E,OAAO,CAAC,cAAc,CAA8B;IAGpD,OAAO,CAAC,SAAS,CAAuD;IAMxE,OAAO,CAAC,oBAAoB,CAA0B;IAEtD,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,EAAE,CAAM;IAKrC,OAAO,CAAC,sBAAsB,CAAkC;IAChE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,sBAAsB,CAAuB;IAGrD,OAAO,CAAC,WAAW,CAAiC;IAEpD,YAAY,OAAO,EAAE,iBAAiB,EAKrC;IAED,IAAI,OAAO,IAAI,OAAO,CAMrB;IAED,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,OAAO;IAIf;iFAC6E;IAC7E,OAAO,CAAC,iBAAiB;IAezB;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0I5D;IAED;;;;;;;;;OASG;YACW,kBAAkB;IA2B1B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAmJrC;IAED;;OAEG;IACH,WAAW,IAAI,IAAI,CAOlB;IAED;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;;OAGG;YACW,sBAAsB;IAmBpC;;;;;;;;;;;;;;;;;OAiBG;YACW,cAAc;IAmJ5B;;;;sBAIkB;IAClB,OAAO,CAAC,gBAAgB;IAUxB;;;;4EAIwE;IACxE,OAAO,CAAC,eAAe;CASxB"}
+{"version":3,"file":"extraction-session.d.ts","sourceRoot":"","sources":["../src/extraction-session.ts"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAOjD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAczD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC5B,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,6EAA6E;IAC7E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAItC,OAAO,CAAC,cAAc,CASlB;IACJ,6DAA6D;IAC7D,oBAAoB,cAAqB;IACzC,OAAO,CAAC,mBAAmB,CAAqB;IAChD;;wEAEoE;IACpE,qBAAqB,UAAS;IAC9B;;;2EAGuE;IACvE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C,kFAAkF;IAClF,mBAAmB,EAAE,MAAM,EAAE,CAAM;IACnC,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAA8B;IACvD,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB,CAA8B;IACxD,+DAA+D;IAC/D,qBAAqB,sBAA6B;IAElD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C;iFAC6E;IAC7E,OAAO,CAAC,cAAc,CAA8B;IAGpD,OAAO,CAAC,SAAS,CAAuD;IAMxE,OAAO,CAAC,oBAAoB,CAA0B;IAEtD,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,EAAE,CAAM;IAKrC,OAAO,CAAC,sBAAsB,CAAkC;IAChE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,sBAAsB,CAAuB;IAGrD,OAAO,CAAC,WAAW,CAAiC;IAEpD,YAAY,OAAO,EAAE,iBAAiB,EAKrC;IAED,IAAI,OAAO,IAAI,OAAO,CAMrB;IAED,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,OAAO;IAIf;iFAC6E;IAC7E,OAAO,CAAC,iBAAiB;IAezB;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8J5D;IAED;;;;;;;;;OASG;YACW,kBAAkB;IA2B1B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA+KrC;IAED;;OAEG;IACH,WAAW,IAAI,IAAI,CAOlB;IAED;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAQjC;;;OAGG;YACW,sBAAsB;IAmBpC;;;;;;;;;;;;;;;;;OAiBG;YACW,cAAc;IA0K5B;;;;sBAIkB;IAClB,OAAO,CAAC,gBAAgB;IAUxB;;;;4EAIwE;IACxE,OAAO,CAAC,eAAe;IAUvB;;;;;;;;;OASG;IACH,OAAO,CAAC,yBAAyB;IA2EjC,OAAO,CAAC,oBAAoB;IAK5B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA0B9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,IAAI,CAgBN"}

package/dist/index.cjs

@@ -124,6 +124,10 @@ var ExtractionSession = class {
 	rootDir = null;
 	/** Serialized path aliases, harvested by the adapter from bundler config. */
 	pathAliasesJson = null;
+	assetCopyCache = /* @__PURE__ */ new Map();
+	/** Physical asset files registered with the host watcher. */
+	assetDependencyPaths = /* @__PURE__ */ new Set();
+	assetDependencyKeys = /* @__PURE__ */ new Set();
 	/** When set (Turbopack orchestration), every analysis also persists
 	*  `.animus/analysis-inputs.json` so isolated loader workers can hydrate.
 	*  Webpack mode leaves this off — its loader shares the process. */
@@ -135,6 +139,10 @@ var ExtractionSession = class {
 	systemPropsModuleId = null;
 	/** Absolute directory prefixes for external DS packages (loader allowlisting). */
 	externalPackageDirs = [];
+	/** Absolute package dir → owning specifier (cross-source correlation). */
+	externalDirOwners = {};
+	/** rootDir-relative external file → owning specifier (correlation join). */
+	externalFileOwners = {};
 	/** External package specifier → absolute source entry path. */
 	externalSourceEntries = /* @__PURE__ */ new Map();
 	options;
@@ -190,6 +198,7 @@ var ExtractionSession = class {
 	async handleWatchUpdate(changes) {
 		if (!this.system) return;
 		const rootDir = this.rootDir;
+		let assetChanged = false;
 		try {
 			let systemHit;
 			if (!changes.modifiedFiles && !changes.removedFiles) for (const [dep, hash] of this.systemDependencyHashes) {
@@ -211,6 +220,10 @@ var ExtractionSession = class {
 				await promise;
 				return;
 			}
+			if ([...changes.modifiedFiles ?? [], ...changes.removedFiles ?? []].some((path$3) => (0, _animus_ui_extract_pipeline.toWatchKeys)(path$3).some((key) => this.assetDependencyKeys.has(key)))) {
+				this.assetCopyCache.clear();
+				assetChanged = true;
+			}
 		} catch (err) {
 			this.warn(`HMR geological-reset check failed: ${String(err)}`);
 		}
@@ -256,7 +269,7 @@ var ExtractionSession = class {
 				});
 			}
 		}
-		if (changedPaths.length > 0 || removedAny) {
+		if (changedPaths.length > 0 || removedAny || assetChanged) {
 			const fileEntries = this.buildFileEntriesFromCache();
 			require_singleton.resetAnalysisPromise();
 			const promise = this.runIncrementalPipeline(fileEntries);
@@ -304,6 +317,9 @@ var ExtractionSession = class {
 			rootDir,
 			prefix: this.options.prefix
 		});
+		this.assetCopyCache.clear();
+		this.assetDependencyPaths.clear();
+		this.assetDependencyKeys.clear();
 		{
 			const deps = this.system.dependencies ?? [];
 			const keys = /* @__PURE__ */ new Set();
@@ -374,8 +390,20 @@ var ExtractionSession = class {
 			onUnreadable: (relPath, err) => this.warn(`skipped unreadable package file ${relPath}: ${String(err)}`)
 		});
 		for (const record of collected.outcomes) if (record.outcome === "empty") this.warn(`include '${record.specifier}' resolved but discovered no component sources`);
+		const unresolvableMessage = (0, _animus_ui_extract_pipeline.unresolvableIncludesMessage)(collected.outcomes);
+		if (unresolvableMessage !== null) {
+			if (this.options.strict) throw new Error(unresolvableMessage);
+			this.warn(unresolvableMessage);
+		}
+		const staleDistMessage = (0, _animus_ui_extract_pipeline.staleDistIncludesMessage)(collected.outcomes);
+		if (staleDistMessage !== null) {
+			if (this.options.strict) throw new Error(staleDistMessage);
+			this.warn(staleDistMessage);
+		}
 		const packageMap = collected.packageMap;
 		this.lastPackageMap = packageMap;
+		this.externalDirOwners = collected.dirOwners;
+		this.externalFileOwners = collected.fileOwners;
 		this.externalSourceEntries = collected.sourceEntries;
 		for (const entry of collected.entries) {
 			const hash = (0, _animus_ui_extract_pipeline.contentHash)(entry.source);
@@ -414,8 +442,8 @@ var ExtractionSession = class {
 	*/
 	buildFileEntriesFromCache() {
 		const entries = [];
-		for (const [path$3, { hash, source }] of this.fileCache) entries.push({
-			path: path$3,
+		for (const [path$4, { hash, source }] of this.fileCache) entries.push({
+			path: path$4,
 			source,
 			hash
 		});
@@ -461,9 +489,19 @@ var ExtractionSession = class {
 			},
 			pathAliasesJson: this.pathAliasesJson,
 			staticCssJson: this.staticCssJson,
+			externalDirs: this.externalPackageDirs.map((dir) => (0, path.relative)(this.rootDir, dir)),
 			devMode,
 			warn: (message) => this.warn(message)
 		});
+		(0, _animus_ui_extract_pipeline.enforceExternalTokenContracts)({
+			diagnostics: result.manifest?.diagnostics,
+			fileOwners: this.externalFileOwners,
+			dirOwners: this.externalDirOwners,
+			sourceThemeManifestsJson: system.sourceThemeManifestsJson,
+			strict: this.options.strict,
+			prefix: "[animus-next]",
+			warn: (message) => this.warn(message)
+		});
 		bt.jsonSerialize = result.timings.serializeMs;
 		bt.rustExtract = result.timings.extractMs;
 		bt.jsonParse = result.timings.parseMs;
@@ -472,10 +510,11 @@ var ExtractionSession = class {
 			bt.analysis = (bt.jsonSerialize ?? 0) + (bt.rustExtract ?? 0) + (bt.jsonParse ?? 0);
 			if (manifest?.report) this.log(`Extracted ${manifest.report.components_extracted ?? "?"}/${manifest.report.components_total ?? "?"} components (${bt.analysis}ms)`);
 		}
+		const globalCss = this.substituteAssetReferences(result.globalCss, devMode);
 		const { declaration, variables, body } = (0, _animus_ui_extract_pipeline.assembleStylesheet)({
 			layers: this.options.layers,
 			variableCss: system.variableCss,
-			globalCss: result.globalCss,
+			globalCss,
 			componentCss: result.componentCss,
 			split: true
 		});
@@ -551,7 +590,113 @@ var ExtractionSession = class {
 		(0, fs.writeFileSync)(tmpPath, content);
 		(0, fs.renameSync)(tmpPath, (0, path.join)(dir, name));
 	}
+	/**
+	* asset() placeholder substitution (global-styles-system): resolve each
+	* referenced specifier through Node resolution, copy the bytes into
+	* `.animus/assets/` under a content-hashed name, and substitute a
+	* RELATIVE url. `.animus/styles.css` is processed by Next's own CSS
+	* pipeline (webpack and Turbopack alike), which applies its native asset
+	* handling — publicPath and output hashing — to relative url()
+	* references. Unsubstitutable specifiers warn and emit literally in
+	* non-strict mode, fail the build under `strict: true`.
+	*/
+	substituteAssetReferences(globalCss, devMode) {
+		const specifiers = (0, _animus_ui_extract_pipeline.findAssetSpecifiers)(globalCss);
+		const assetsDir = (0, path.join)(this.rootDir, ".animus", "assets");
+		const expected = /* @__PURE__ */ new Set();
+		this.assetDependencyPaths.clear();
+		this.assetDependencyKeys.clear();
+		const urlBySpecifier = /* @__PURE__ */ new Map();
+		for (const specifier of specifiers) {
+			const cached = this.assetCopyCache.get(specifier);
+			if (cached && (0, fs.existsSync)((0, path.join)(assetsDir, cached.fileName))) try {
+				const current = (0, fs.statSync)(cached.sourcePath);
+				if (current.mtimeMs === cached.mtimeMs && current.size === cached.size) {
+					this.trackAssetDependency(cached.sourcePath);
+					expected.add(cached.fileName);
+					urlBySpecifier.set(specifier, cached.url);
+					continue;
+				}
+			} catch {}
+			const resolvedPath = this.resolveAssetSpecifier(specifier);
+			if (!resolvedPath) {
+				const message = `unresolvable asset() specifier: ${specifier}`;
+				if (this.options.strict) throw new Error(`[animus-next] ${message}`);
+				this.warn(message);
+				urlBySpecifier.set(specifier, specifier);
+				continue;
+			}
+			const bytes = (0, fs.readFileSync)(resolvedPath);
+			const sourceStat = (0, fs.statSync)(resolvedPath);
+			this.trackAssetDependency(resolvedPath);
+			const ext = (0, path.extname)(resolvedPath);
+			const fileName = `${(0, path.basename)(resolvedPath, ext)}.${(0, _animus_ui_extract_pipeline.contentHash)(bytes).slice(0, 8)}${ext}`;
+			expected.add(fileName);
+			if (!(0, fs.existsSync)(assetsDir)) (0, fs.mkdirSync)(assetsDir, { recursive: true });
+			const assetPath = (0, path.join)(assetsDir, fileName);
+			if (!(0, fs.existsSync)(assetPath)) (0, fs.writeFileSync)(assetPath, bytes);
+			const url = `./assets/${fileName}`;
+			urlBySpecifier.set(specifier, url);
+			this.assetCopyCache.set(specifier, {
+				sourcePath: resolvedPath,
+				mtimeMs: sourceStat.mtimeMs,
+				size: sourceStat.size,
+				fileName,
+				url
+			});
+		}
+		if (!devMode) pruneStaleAssets(assetsDir, expected);
+		return (0, _animus_ui_extract_pipeline.substituteAssetPlaceholders)(globalCss, urlBySpecifier);
+	}
+	trackAssetDependency(path$5) {
+		this.assetDependencyPaths.add(path$5);
+		for (const key of (0, _animus_ui_extract_pipeline.toWatchKeys)(path$5)) this.assetDependencyKeys.add(key);
+	}
+	/**
+	* Resolve an asset specifier to an absolute file via the shared pipeline
+	* resolver (host aliases → Node resolution → package root), with one
+	* session-local last resort: an already-discovered source entry's package
+	* root (dist-less workspace kits the shared resolver cannot see).
+	*/
+	resolveAssetSpecifier(specifier) {
+		const resolved = (0, _animus_ui_extract_pipeline.resolveAssetFile)(specifier, this.rootDir, this.pathAliasesJson);
+		if (resolved) return resolved;
+		const segments = specifier.split("/");
+		const packageName = specifier.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+		const subpath = specifier.slice(packageName.length + 1);
+		if (!subpath) return null;
+		const sourceEntry = this.externalSourceEntries.get(packageName) ?? [...this.externalSourceEntries].find(([declared]) => declared === packageName || declared.startsWith(`${packageName}/`))?.[1];
+		if (sourceEntry) {
+			const candidate = (0, path.join)((0, _animus_ui_extract_pipeline.findPackageRoot)(sourceEntry), subpath);
+			if ((0, fs.existsSync)(candidate)) return candidate;
+		}
+		return null;
+	}
 };
+/**
+* Sync `.animus/assets/` to the current build's content-hashed file set:
+* anything else in the directory is a superseded revision (the copies are
+* content-addressed and never overwritten) or the leftover of an asset()
+* reference that no longer exists. Failures are tolerated per entry — Next
+* dev evaluates the config in more than one process, and a concurrent
+* session may have removed (or be about to rewrite) the same file; every
+* pass rewrites whatever of its own set is missing, so races self-heal.
+*/
+function pruneStaleAssets(assetsDir, expected) {
+	if (!(0, fs.existsSync)(assetsDir)) return;
+	let entries;
+	try {
+		entries = (0, fs.readdirSync)(assetsDir);
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		if (expected.has(entry)) continue;
+		try {
+			(0, fs.unlinkSync)((0, path.join)(assetsDir, entry));
+		} catch {}
+	}
+}
 //#endregion
 //#region src/plugin.ts
 const PLUGIN_NAME = "AnimusWebpackPlugin";
@@ -600,6 +745,8 @@ var AnimusWebpackPlugin = class {
 			const registerSystemDependencies = () => {
 				for (const dep of this.session.systemDependencyPaths) if ((0, fs.existsSync)(dep)) compilation.fileDependencies.add(dep);
 				else compilation.missingDependencies.add(dep);
+				for (const dep of this.session.assetDependencyPaths) if ((0, fs.existsSync)(dep)) compilation.fileDependencies.add(dep);
+				else compilation.missingDependencies.add(dep);
 			};
 			registerSystemDependencies();
 			const stage = compiler.webpack?.Compilation.PROCESS_ASSETS_STAGE_ADDITIONAL ?? -2e3;

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { t as __require } from "./chunk-y_GBKt04.mjs";
 import { a as getSharedExternalDirs, c as setAnalysisPromise, d as setSharedEngine, f as setSharedExternalDirs, i as getSharedCss, l as setManifestJson, m as setSharedSystemProps, n as getAnalysisPromise, o as getSharedExternalEntries, p as setSharedExternalEntries, s as resetAnalysisPromise, t as engineApi, u as setSharedCss } from "./singleton-BKALu7Mk.mjs";
-import { DEFAULT_EXTENSIONS, assembleStylesheet, assertNoRetiredEngineSelection, buildPathAliasesJson, buildSystemPropsModule, clearEngineCache, collectExternalPackageSources, contentHash, discoverFiles, extractSystemFilePackages, formatRustTimingWaterfall, loadSystemConfig, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveLightningTargets, runProjectAnalysis, serializeStaticCss, toWatchKeys } from "@animus-ui/extract/pipeline";
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, watch, writeFileSync } from "fs";
-import { dirname, extname, join, relative, resolve, sep } from "path";
+import { DEFAULT_EXTENSIONS, assembleStylesheet, assertNoRetiredEngineSelection, buildPathAliasesJson, buildSystemPropsModule, clearEngineCache, collectExternalPackageSources, contentHash, discoverFiles, enforceExternalTokenContracts, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, formatRustTimingWaterfall, loadSystemConfig, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAssetFile, resolveLightningTargets, runProjectAnalysis, serializeStaticCss, staleDistIncludesMessage, substituteAssetPlaceholders, toWatchKeys, unresolvableIncludesMessage } from "@animus-ui/extract/pipeline";
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, watch, writeFileSync } from "fs";
+import { basename, dirname, extname, join, relative, resolve, sep } from "path";
 import { fileURLToPath } from "url";
 //#region src/resolve-packages.ts
 /**
@@ -124,6 +124,10 @@ var ExtractionSession = class {
 	rootDir = null;
 	/** Serialized path aliases, harvested by the adapter from bundler config. */
 	pathAliasesJson = null;
+	assetCopyCache = /* @__PURE__ */ new Map();
+	/** Physical asset files registered with the host watcher. */
+	assetDependencyPaths = /* @__PURE__ */ new Set();
+	assetDependencyKeys = /* @__PURE__ */ new Set();
 	/** When set (Turbopack orchestration), every analysis also persists
 	*  `.animus/analysis-inputs.json` so isolated loader workers can hydrate.
 	*  Webpack mode leaves this off — its loader shares the process. */
@@ -135,6 +139,10 @@ var ExtractionSession = class {
 	systemPropsModuleId = null;
 	/** Absolute directory prefixes for external DS packages (loader allowlisting). */
 	externalPackageDirs = [];
+	/** Absolute package dir → owning specifier (cross-source correlation). */
+	externalDirOwners = {};
+	/** rootDir-relative external file → owning specifier (correlation join). */
+	externalFileOwners = {};
 	/** External package specifier → absolute source entry path. */
 	externalSourceEntries = /* @__PURE__ */ new Map();
 	options;
@@ -190,6 +198,7 @@ var ExtractionSession = class {
 	async handleWatchUpdate(changes) {
 		if (!this.system) return;
 		const rootDir = this.rootDir;
+		let assetChanged = false;
 		try {
 			let systemHit;
 			if (!changes.modifiedFiles && !changes.removedFiles) for (const [dep, hash] of this.systemDependencyHashes) {
@@ -211,6 +220,10 @@ var ExtractionSession = class {
 				await promise;
 				return;
 			}
+			if ([...changes.modifiedFiles ?? [], ...changes.removedFiles ?? []].some((path) => toWatchKeys(path).some((key) => this.assetDependencyKeys.has(key)))) {
+				this.assetCopyCache.clear();
+				assetChanged = true;
+			}
 		} catch (err) {
 			this.warn(`HMR geological-reset check failed: ${String(err)}`);
 		}
@@ -256,7 +269,7 @@ var ExtractionSession = class {
 				});
 			}
 		}
-		if (changedPaths.length > 0 || removedAny) {
+		if (changedPaths.length > 0 || removedAny || assetChanged) {
 			const fileEntries = this.buildFileEntriesFromCache();
 			resetAnalysisPromise();
 			const promise = this.runIncrementalPipeline(fileEntries);
@@ -304,6 +317,9 @@ var ExtractionSession = class {
 			rootDir,
 			prefix: this.options.prefix
 		});
+		this.assetCopyCache.clear();
+		this.assetDependencyPaths.clear();
+		this.assetDependencyKeys.clear();
 		{
 			const deps = this.system.dependencies ?? [];
 			const keys = /* @__PURE__ */ new Set();
@@ -374,8 +390,20 @@ var ExtractionSession = class {
 			onUnreadable: (relPath, err) => this.warn(`skipped unreadable package file ${relPath}: ${String(err)}`)
 		});
 		for (const record of collected.outcomes) if (record.outcome === "empty") this.warn(`include '${record.specifier}' resolved but discovered no component sources`);
+		const unresolvableMessage = unresolvableIncludesMessage(collected.outcomes);
+		if (unresolvableMessage !== null) {
+			if (this.options.strict) throw new Error(unresolvableMessage);
+			this.warn(unresolvableMessage);
+		}
+		const staleDistMessage = staleDistIncludesMessage(collected.outcomes);
+		if (staleDistMessage !== null) {
+			if (this.options.strict) throw new Error(staleDistMessage);
+			this.warn(staleDistMessage);
+		}
 		const packageMap = collected.packageMap;
 		this.lastPackageMap = packageMap;
+		this.externalDirOwners = collected.dirOwners;
+		this.externalFileOwners = collected.fileOwners;
 		this.externalSourceEntries = collected.sourceEntries;
 		for (const entry of collected.entries) {
 			const hash = contentHash(entry.source);
@@ -461,9 +489,19 @@ var ExtractionSession = class {
 			},
 			pathAliasesJson: this.pathAliasesJson,
 			staticCssJson: this.staticCssJson,
+			externalDirs: this.externalPackageDirs.map((dir) => relative(this.rootDir, dir)),
 			devMode,
 			warn: (message) => this.warn(message)
 		});
+		enforceExternalTokenContracts({
+			diagnostics: result.manifest?.diagnostics,
+			fileOwners: this.externalFileOwners,
+			dirOwners: this.externalDirOwners,
+			sourceThemeManifestsJson: system.sourceThemeManifestsJson,
+			strict: this.options.strict,
+			prefix: "[animus-next]",
+			warn: (message) => this.warn(message)
+		});
 		bt.jsonSerialize = result.timings.serializeMs;
 		bt.rustExtract = result.timings.extractMs;
 		bt.jsonParse = result.timings.parseMs;
@@ -472,10 +510,11 @@ var ExtractionSession = class {
 			bt.analysis = (bt.jsonSerialize ?? 0) + (bt.rustExtract ?? 0) + (bt.jsonParse ?? 0);
 			if (manifest?.report) this.log(`Extracted ${manifest.report.components_extracted ?? "?"}/${manifest.report.components_total ?? "?"} components (${bt.analysis}ms)`);
 		}
+		const globalCss = this.substituteAssetReferences(result.globalCss, devMode);
 		const { declaration, variables, body } = assembleStylesheet({
 			layers: this.options.layers,
 			variableCss: system.variableCss,
-			globalCss: result.globalCss,
+			globalCss,
 			componentCss: result.componentCss,
 			split: true
 		});
@@ -551,7 +590,113 @@ var ExtractionSession = class {
 		writeFileSync(tmpPath, content);
 		renameSync(tmpPath, join(dir, name));
 	}
+	/**
+	* asset() placeholder substitution (global-styles-system): resolve each
+	* referenced specifier through Node resolution, copy the bytes into
+	* `.animus/assets/` under a content-hashed name, and substitute a
+	* RELATIVE url. `.animus/styles.css` is processed by Next's own CSS
+	* pipeline (webpack and Turbopack alike), which applies its native asset
+	* handling — publicPath and output hashing — to relative url()
+	* references. Unsubstitutable specifiers warn and emit literally in
+	* non-strict mode, fail the build under `strict: true`.
+	*/
+	substituteAssetReferences(globalCss, devMode) {
+		const specifiers = findAssetSpecifiers(globalCss);
+		const assetsDir = join(this.rootDir, ".animus", "assets");
+		const expected = /* @__PURE__ */ new Set();
+		this.assetDependencyPaths.clear();
+		this.assetDependencyKeys.clear();
+		const urlBySpecifier = /* @__PURE__ */ new Map();
+		for (const specifier of specifiers) {
+			const cached = this.assetCopyCache.get(specifier);
+			if (cached && existsSync(join(assetsDir, cached.fileName))) try {
+				const current = statSync(cached.sourcePath);
+				if (current.mtimeMs === cached.mtimeMs && current.size === cached.size) {
+					this.trackAssetDependency(cached.sourcePath);
+					expected.add(cached.fileName);
+					urlBySpecifier.set(specifier, cached.url);
+					continue;
+				}
+			} catch {}
+			const resolvedPath = this.resolveAssetSpecifier(specifier);
+			if (!resolvedPath) {
+				const message = `unresolvable asset() specifier: ${specifier}`;
+				if (this.options.strict) throw new Error(`[animus-next] ${message}`);
+				this.warn(message);
+				urlBySpecifier.set(specifier, specifier);
+				continue;
+			}
+			const bytes = readFileSync(resolvedPath);
+			const sourceStat = statSync(resolvedPath);
+			this.trackAssetDependency(resolvedPath);
+			const ext = extname(resolvedPath);
+			const fileName = `${basename(resolvedPath, ext)}.${contentHash(bytes).slice(0, 8)}${ext}`;
+			expected.add(fileName);
+			if (!existsSync(assetsDir)) mkdirSync(assetsDir, { recursive: true });
+			const assetPath = join(assetsDir, fileName);
+			if (!existsSync(assetPath)) writeFileSync(assetPath, bytes);
+			const url = `./assets/${fileName}`;
+			urlBySpecifier.set(specifier, url);
+			this.assetCopyCache.set(specifier, {
+				sourcePath: resolvedPath,
+				mtimeMs: sourceStat.mtimeMs,
+				size: sourceStat.size,
+				fileName,
+				url
+			});
+		}
+		if (!devMode) pruneStaleAssets(assetsDir, expected);
+		return substituteAssetPlaceholders(globalCss, urlBySpecifier);
+	}
+	trackAssetDependency(path) {
+		this.assetDependencyPaths.add(path);
+		for (const key of toWatchKeys(path)) this.assetDependencyKeys.add(key);
+	}
+	/**
+	* Resolve an asset specifier to an absolute file via the shared pipeline
+	* resolver (host aliases → Node resolution → package root), with one
+	* session-local last resort: an already-discovered source entry's package
+	* root (dist-less workspace kits the shared resolver cannot see).
+	*/
+	resolveAssetSpecifier(specifier) {
+		const resolved = resolveAssetFile(specifier, this.rootDir, this.pathAliasesJson);
+		if (resolved) return resolved;
+		const segments = specifier.split("/");
+		const packageName = specifier.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0];
+		const subpath = specifier.slice(packageName.length + 1);
+		if (!subpath) return null;
+		const sourceEntry = this.externalSourceEntries.get(packageName) ?? [...this.externalSourceEntries].find(([declared]) => declared === packageName || declared.startsWith(`${packageName}/`))?.[1];
+		if (sourceEntry) {
+			const candidate = join(findPackageRoot(sourceEntry), subpath);
+			if (existsSync(candidate)) return candidate;
+		}
+		return null;
+	}
 };
+/**
+* Sync `.animus/assets/` to the current build's content-hashed file set:
+* anything else in the directory is a superseded revision (the copies are
+* content-addressed and never overwritten) or the leftover of an asset()
+* reference that no longer exists. Failures are tolerated per entry — Next
+* dev evaluates the config in more than one process, and a concurrent
+* session may have removed (or be about to rewrite) the same file; every
+* pass rewrites whatever of its own set is missing, so races self-heal.
+*/
+function pruneStaleAssets(assetsDir, expected) {
+	if (!existsSync(assetsDir)) return;
+	let entries;
+	try {
+		entries = readdirSync(assetsDir);
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		if (expected.has(entry)) continue;
+		try {
+			unlinkSync(join(assetsDir, entry));
+		} catch {}
+	}
+}
 //#endregion
 //#region src/plugin.ts
 const PLUGIN_NAME = "AnimusWebpackPlugin";
@@ -600,6 +745,8 @@ 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 dep of this.session.assetDependencyPaths) if (existsSync(dep)) compilation.fileDependencies.add(dep);
+				else compilation.missingDependencies.add(dep);
 			};
 			registerSystemDependencies();
 			const stage = compiler.webpack?.Compilation.PROCESS_ASSETS_STAGE_ADDITIONAL ?? -2e3;

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/package.json

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