@animus-ui/next-plugin 0.1.1 → 0.1.3

package/dist/{singleton-CttvA4Rg.cjs → singleton-DH7yeWZa.cjs}

@@ -1,3 +1,4 @@
+let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
 //#region src/singleton.ts
 /**
 * Module-scope singleton for sharing analysis state between the webpack plugin and loader.
@@ -61,72 +62,46 @@ function getSharedEngine() {
 *  mirrors the untyped `require` the call sites previously used — the NAPI
 *  module's own .d.ts is the authoritative surface. */
 function requireEngine() {
-	return getSharedEngine() === "v2" ? require("@animus-ui/extract/engine-v2") : require("@animus-ui/extract");
+	return require("@animus-ui/extract");
 }
 const V2_ENGINE_KEY = "__animus_v2_engine__";
 /**
 * Engine-agnostic API over both engines (extract-v2-spine row 13). The
-* v2 leg adapts the v1 function surface onto a stateful ExtractEngine;
-* the INSTANCE lives on globalThis for the same reason the manifest
-* does — the ESM plugin and the CJS webpack loader must see one engine.
-* (The next-plugin is already process-singleton by design: manifest,
-* css, and system props share the same globalThis keys.)
+* v2 leg adapts the v1 function surface onto a stateful ExtractEngine
+* (hoisted to `createV2EngineApi` in @animus-ui/extract/pipeline — the
+* single authoritative copy shared with vite-plugin). The engine INSTANCE,
+* its analyze-time sources, and the one-shot drift flag all live on
+* globalThis for the same reason the manifest does — the ESM plugin and the
+* CJS webpack loader must see one engine (and one drift warning) across the
+* double-load. (The next-plugin is already process-singleton by design:
+* manifest, css, and system props share the same globalThis keys.)
 * loadSystemModule is exported by both bindings from one engine-neutral
 * Rust crate, so the default path no longer loads the v1 binary.
 */
 const V2_SENT_SOURCES_KEY = "__animus_v2_sent_sources__";
-let v2DriftWarned = false;
-function engineApi() {
-	if (getSharedEngine() !== "v2") return requireEngine();
-	const native = requireEngine();
-	return {
-		loadSystemModule: (...args) => native.loadSystemModule(...args),
-		analyzeProject: (filesJson, themeJson, variableMapJson, contextualVarsJson, configJson, groupRegistryJson, packageResolutionJson, devMode, emitterConfigJson, selectorAliasesJson, _selectorOrderJson, globalStyleBlocksJson, pathAliasesJson, keyframesJson) => {
-			const sent = /* @__PURE__ */ new Map();
-			for (const entry of JSON.parse(filesJson)) sent.set(entry.path, entry.source);
-			globalThis[V2_SENT_SOURCES_KEY] = sent;
-			const emitterConfig = emitterConfigJson ? JSON.parse(emitterConfigJson) : {};
-			globalThis[V2_ENGINE_KEY] = null;
-			const engine = new native.ExtractEngine({
-				runtimeImport: emitterConfig.runtime_import ?? void 0,
-				cssModuleId: emitterConfig.css_module_id ?? void 0,
-				systemPropsModuleId: emitterConfig.system_props_module_id ?? void 0,
-				themeJson,
-				variableMapJson,
-				contextualVarsJson: contextualVarsJson ?? void 0,
-				configJson,
-				groupRegistryJson,
-				selectorAliasesJson: selectorAliasesJson ?? void 0,
-				globalStyleBlocksJson: globalStyleBlocksJson ?? void 0,
-				keyframesJson: keyframesJson ?? void 0,
-				packageResolutionJson: packageResolutionJson ?? void 0,
-				pathAliasesJson: pathAliasesJson ?? void 0,
-				devMode
-			});
+const V2_DRIFT_WARNED_KEY = "__animus_v2_drift_warned__";
+const v2EngineApi = (0, _animus_ui_extract_pipeline.createV2EngineApi)({
+	label: "animus-next",
+	isV2: () => getSharedEngine() === "v2",
+	loadNativeEngine: requireEngine,
+	passThroughUnknownPaths: true,
+	store: {
+		getEngine: () => globalThis[V2_ENGINE_KEY],
+		setEngine: (engine) => {
 			globalThis[V2_ENGINE_KEY] = engine;
-			return engine.analyze(filesJson);
 		},
-		transformFile: (source, path, _manifest) => {
-			const engine = globalThis[V2_ENGINE_KEY];
-			if (!engine) throw new Error("[animus-next] v2 transform before analyze — engine instance not initialized");
-			const sentMap = globalThis[V2_SENT_SOURCES_KEY];
-			if (sentMap && !sentMap.has(path)) return {
-				code: source,
-				hasComponents: false
-			};
-			const sent = sentMap?.get(path);
-			if (sent !== void 0 && sent !== source && !v2DriftWarned) {
-				v2DriftWarned = true;
-				console.warn(`[animus-next] v2: transform-time source for ${path} differs from analyze-time source — an upstream transform may be reverted`);
-			}
-			return JSON.parse(engine.transformFile(path));
+		getSentSources: () => globalThis[V2_SENT_SOURCES_KEY] ?? null,
+		setSentSources: (sources) => {
+			globalThis[V2_SENT_SOURCES_KEY] = sources;
 		},
-		clearAnalysisCache: () => {
-			const engine = globalThis[V2_ENGINE_KEY];
-			if (engine) engine.clearCache();
-			globalThis[V2_ENGINE_KEY] = null;
+		getDriftWarned: () => Boolean(globalThis[V2_DRIFT_WARNED_KEY]),
+		setDriftWarned: (value) => {
+			globalThis[V2_DRIFT_WARNED_KEY] = value;
 		}
-	};
+	}
+});
+function engineApi() {
+	return v2EngineApi();
 }
 //#endregion
 Object.defineProperty(exports, "engineApi", {
@@ -153,12 +128,6 @@ Object.defineProperty(exports, "getSharedCss", {
 		return getSharedCss;
 	}
 });
-Object.defineProperty(exports, "getSharedEngine", {
-	enumerable: true,
-	get: function() {
-		return getSharedEngine;
-	}
-});
 Object.defineProperty(exports, "getSharedExternalDirs", {
 	enumerable: true,
 	get: function() {

package/dist/singleton.d.ts

@@ -1,10 +1,3 @@
-/**
- * Module-scope singleton for sharing analysis state between the webpack plugin and loader.
- *
- * Uses globalThis to survive the ESM/CJS module boundary: the plugin is loaded via ESM
- * (next.config.ts import) while the loader is loaded by webpack via require(). Without
- * globalThis, each module system gets its own singleton instance.
- */
 export declare function getManifestJson(): string | null;
 export declare function setManifestJson(json: string): void;
 export declare function getAnalysisPromise(): Promise<void> | null;
@@ -17,7 +10,7 @@ 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;
-export type AnimusEngine = 'v1' | 'v2';
+export type AnimusEngine = 'v2';
 /** Engine selection travels through the singleton so non-owning compiler
  *  instances and the webpack loader honor the same choice as the owner. */
 export declare function setSharedEngine(engine: AnimusEngine): void;

package/dist/singleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,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;AAID,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC;2EAC2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;uDAEuD;AAEvD,wBAAgB,aAAa,IAAI,GAAG,CAOnC;AAiBD,wBAAgB,SAAS,IAAI,GAAG,CAmG/B"}
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAkBA,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;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"}

package/dist/timing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Verbose build-timing waterfall: JS phases, analysis sub-phases, and the
+ * shared Rust phase table. `ANIMUS_TIMING_JSON=1` additionally dumps a
+ * machine-readable merged record.
+ */
+export declare function logBuildTimings(bt: Record<string, number>, rustTiming: Record<string, number> | undefined, log: (msg: string) => void, verbose: boolean): void;
+//# sourceMappingURL=timing.d.ts.map

package/dist/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC9C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAO,EAAE,OAAO,GACf,IAAI,CAkDN"}

package/dist/turbopack-config.d.ts

@@ -0,0 +1,55 @@
+import type { AnimusNextOptions } from './types';
+/**
+ * Turbopack config fragment generation (spec: next-turbopack-integration).
+ * Everything emitted here MUST be JSON-serializable — Turbopack forwards
+ * loader options across process boundaries and rejects live values.
+ */
+export type TurbopackMode = 'off' | 'auto' | 'on';
+export interface TurbopackRule {
+    loaders: Array<{
+        loader: string;
+        options: Record<string, unknown>;
+    }>;
+}
+export interface TurbopackConfigFragment {
+    rules: Record<string, TurbopackRule>;
+    resolveAlias: Record<string, string>;
+}
+/** The single glob the Animus loader registers under. `.mjs` is included
+ *  for webpack parity: an external package without `src/` is ingested via
+ *  its resolved dist entry (often `dist/index.mjs`) and must still reach
+ *  the loader — manifest lookup remains the file-level gate. */
+export declare const ANIMUS_TURBOPACK_RULE_GLOB = "*.{ts,tsx,js,jsx,mjs}";
+/** Virtual system-props id emitted into transformed sources under Turbopack
+ *  (absolute-path imports are rejected there); resolveAlias maps it to the
+ *  on-disk artifact. */
+export declare const TURBOPACK_SYSTEM_PROPS_ID = "virtual:animus/system-props";
+/**
+ * Resolve whether Turbopack wiring is active for this process. Default is
+ * `'auto'`: active exactly when the TURBOPACK environment variable is set
+ * (Next sets it for every Turbopack dev/build). The stable `turbopack`
+ * option wins over the deprecated `unstable_turbopack` alias.
+ */
+export declare function resolveTurbopackMode(options: AnimusNextOptions, env?: Record<string, string | undefined>): boolean;
+/**
+ * Build the `turbopack` config fragment: one glob-keyed loader rule
+ * (file-level allowlisting lives in the loader via manifest lookup — Next 15
+ * rules have no condition algebra) plus resolve aliases for the virtual
+ * system-props id, the emitter's stylesheet id, and each collected external
+ * package specifier redirected to its source entry.
+ */
+export declare function buildTurbopackConfig(args: {
+    rootDir: string;
+    loaderPath: string;
+    options: AnimusNextOptions;
+    externalSourceEntries: ReadonlyMap<string, string>;
+}): TurbopackConfigFragment;
+/**
+ * Locate the Turbopack loader module: built dist first, source fallback for
+ * in-repo development. CJS preferred — Turbopack's loader-runner follows
+ * the webpack loader contract (`module.exports = fn`), and the .cjs build
+ * is loadable by every runner version; ESM default-export acceptance is
+ * not guaranteed.
+ */
+export declare function resolveTurbopackLoaderPath(pluginDir: string): string;
+//# sourceMappingURL=turbopack-config.d.ts.map

package/dist/turbopack-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-config.d.ts","sourceRoot":"","sources":["../src/turbopack-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;gEAGgE;AAChE,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAElE;;wBAEwB;AACxB,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,OAAO,CAMT;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD,GAAG,uBAAuB,CA8B1B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/turbopack-loader.cjs

@@ -0,0 +1,90 @@
+const require_loader_core = require("./loader-core-CbaYNhBu.cjs");
+let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
+let fs = require("fs");
+let path = require("path");
+//#region src/turbopack-loader.ts
+let engine = null;
+let sentSources = null;
+let driftWarned = false;
+let hydratedKey = null;
+let hydratedManifestJson = null;
+let hydrateFailedWarned = false;
+const engineModuleId = "@animus-ui/extract";
+const engineApi = (0, _animus_ui_extract_pipeline.createV2EngineApi)({
+	label: "animus-next-turbopack",
+	isV2: () => true,
+	loadNativeEngine: () => require(engineModuleId),
+	passThroughUnknownPaths: true,
+	store: {
+		getEngine: () => engine,
+		setEngine: (next) => {
+			engine = next;
+		},
+		getSentSources: () => sentSources,
+		setSentSources: (sources) => {
+			sentSources = sources;
+		},
+		getDriftWarned: () => driftWarned,
+		setDriftWarned: (value) => {
+			driftWarned = value;
+		}
+	}
+});
+/**
+* Hydrate this worker's engine from the `.animus/` artifact pair — the v2
+* engine serves transforms only from analyze-retained state, so a fresh
+* worker replays the persisted analysis inputs once (and again whenever
+* either artifact changes; keyed by mtime+size of both). The persisted
+* manifest is a hard prerequisite (spec: next-turbopack-integration /
+* Stateless per-file transformation — absent or unreadable
+* `.animus/manifest.json` means passthrough, even when analysis inputs
+* exist). Returns the manifest JSON, or null (caller passes through).
+*/
+function hydrate(rootDir) {
+	const inputsPath = (0, path.join)(rootDir, ".animus", "analysis-inputs.json");
+	const manifestPath = (0, path.join)(rootDir, ".animus", "manifest.json");
+	let inputsStat;
+	let manifestStat;
+	try {
+		inputsStat = (0, fs.statSync)(inputsPath, { bigint: true });
+		manifestStat = (0, fs.statSync)(manifestPath, { bigint: true });
+	} catch {
+		return null;
+	}
+	const key = `${inputsPath}:${inputsStat.mtimeNs}:${inputsStat.size}:${manifestStat.mtimeNs}:${manifestStat.size}`;
+	if (key === hydratedKey && hydratedManifestJson !== null) return hydratedManifestJson;
+	try {
+		JSON.parse((0, fs.readFileSync)(manifestPath, "utf-8"));
+		const inputs = JSON.parse((0, fs.readFileSync)(inputsPath, "utf-8"));
+		const { analyzeProject } = engineApi();
+		hydratedManifestJson = analyzeProject(...(0, _animus_ui_extract_pipeline.buildAnalyzeProjectArgs)(inputs));
+		hydratedKey = key;
+		return hydratedManifestJson;
+	} catch (e) {
+		if (!hydrateFailedWarned) {
+			hydrateFailedWarned = true;
+			console.warn(`[animus-extract] Turbopack worker hydration failed (${String(e)}); sources pass through untransformed`);
+		}
+		return null;
+	}
+}
+/**
+* Turbopack loader for Animus source transformation. Derives everything
+* from the incoming source, its JSON-serializable options, and the
+* `.animus/` disk artifacts written by the out-of-band orchestrator.
+*/
+function animusTurbopackLoader(source) {
+	const opts = this.getOptions?.() ?? {};
+	const rootDir = opts.rootDir ?? this.rootContext;
+	const manifestJson = hydrate(rootDir);
+	if (!manifestJson) return source;
+	return require_loader_core.transformWithManifest({
+		source,
+		filename: (0, path.relative)(rootDir, this.resourcePath),
+		manifestJson,
+		engineApi,
+		opts
+	});
+}
+//#endregion
+module.exports = animusTurbopackLoader;

package/dist/turbopack-loader.d.ts

@@ -0,0 +1,16 @@
+import type { LoaderPolicyOptions } from './loader-core';
+type LoaderContext = {
+    resourcePath: string;
+    rootContext: string;
+    getOptions: () => LoaderPolicyOptions & {
+        rootDir?: string;
+    };
+};
+/**
+ * Turbopack loader for Animus source transformation. Derives everything
+ * from the incoming source, its JSON-serializable options, and the
+ * `.animus/` disk artifacts written by the out-of-band orchestrator.
+ */
+export default function animusTurbopackLoader(this: LoaderContext, source: string): string;
+export {};
+//# sourceMappingURL=turbopack-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-loader.d.ts","sourceRoot":"","sources":["../src/turbopack-loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAMzD,KAAK,aAAa,GAAG;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,mBAAmB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D,CAAC;AAgGF;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAeR"}

package/dist/turbopack-loader.mjs

@@ -0,0 +1,91 @@
+import { t as __require } from "./chunk-y_GBKt04.mjs";
+import { t as transformWithManifest } from "./loader-core-D6Tm_b8F.mjs";
+import { buildAnalyzeProjectArgs, createV2EngineApi } from "@animus-ui/extract/pipeline";
+import { readFileSync, statSync } from "fs";
+import { join, relative } from "path";
+//#region src/turbopack-loader.ts
+let engine = null;
+let sentSources = null;
+let driftWarned = false;
+let hydratedKey = null;
+let hydratedManifestJson = null;
+let hydrateFailedWarned = false;
+const engineModuleId = "@animus-ui/extract";
+const engineApi = createV2EngineApi({
+	label: "animus-next-turbopack",
+	isV2: () => true,
+	loadNativeEngine: () => __require(engineModuleId),
+	passThroughUnknownPaths: true,
+	store: {
+		getEngine: () => engine,
+		setEngine: (next) => {
+			engine = next;
+		},
+		getSentSources: () => sentSources,
+		setSentSources: (sources) => {
+			sentSources = sources;
+		},
+		getDriftWarned: () => driftWarned,
+		setDriftWarned: (value) => {
+			driftWarned = value;
+		}
+	}
+});
+/**
+* Hydrate this worker's engine from the `.animus/` artifact pair — the v2
+* engine serves transforms only from analyze-retained state, so a fresh
+* worker replays the persisted analysis inputs once (and again whenever
+* either artifact changes; keyed by mtime+size of both). The persisted
+* manifest is a hard prerequisite (spec: next-turbopack-integration /
+* Stateless per-file transformation — absent or unreadable
+* `.animus/manifest.json` means passthrough, even when analysis inputs
+* exist). Returns the manifest JSON, or null (caller passes through).
+*/
+function hydrate(rootDir) {
+	const inputsPath = join(rootDir, ".animus", "analysis-inputs.json");
+	const manifestPath = join(rootDir, ".animus", "manifest.json");
+	let inputsStat;
+	let manifestStat;
+	try {
+		inputsStat = statSync(inputsPath, { bigint: true });
+		manifestStat = statSync(manifestPath, { bigint: true });
+	} catch {
+		return null;
+	}
+	const key = `${inputsPath}:${inputsStat.mtimeNs}:${inputsStat.size}:${manifestStat.mtimeNs}:${manifestStat.size}`;
+	if (key === hydratedKey && hydratedManifestJson !== null) return hydratedManifestJson;
+	try {
+		JSON.parse(readFileSync(manifestPath, "utf-8"));
+		const inputs = JSON.parse(readFileSync(inputsPath, "utf-8"));
+		const { analyzeProject } = engineApi();
+		hydratedManifestJson = analyzeProject(...buildAnalyzeProjectArgs(inputs));
+		hydratedKey = key;
+		return hydratedManifestJson;
+	} catch (e) {
+		if (!hydrateFailedWarned) {
+			hydrateFailedWarned = true;
+			console.warn(`[animus-extract] Turbopack worker hydration failed (${String(e)}); sources pass through untransformed`);
+		}
+		return null;
+	}
+}
+/**
+* Turbopack loader for Animus source transformation. Derives everything
+* from the incoming source, its JSON-serializable options, and the
+* `.animus/` disk artifacts written by the out-of-band orchestrator.
+*/
+function animusTurbopackLoader(source) {
+	const opts = this.getOptions?.() ?? {};
+	const rootDir = opts.rootDir ?? this.rootContext;
+	const manifestJson = hydrate(rootDir);
+	if (!manifestJson) return source;
+	return transformWithManifest({
+		source,
+		filename: relative(rootDir, this.resourcePath),
+		manifestJson,
+		engineApi,
+		opts
+	});
+}
+//#endregion
+export { animusTurbopackLoader as default };

package/dist/turbopack-orchestrator.d.ts

@@ -0,0 +1,31 @@
+import { watch } from 'fs';
+import type { ExtractionSession } from './extraction-session';
+/**
+ * Out-of-band pipeline orchestration for Turbopack (spec:
+ * next-turbopack-integration). Turbopack exposes no compiler hooks, so the
+ * pipeline runs during next.config resolution and, in dev, from a
+ * filesystem watcher — the bundler only ever sees the `.animus/` disk
+ * artifacts.
+ */
+/** Run the full pipeline with the Turbopack emitter identity: hydration
+ *  artifacts persisted, and the virtual system-props id (Turbopack rejects
+ *  the webpack path's absolute-path imports). */
+export declare function runTurbopackPipeline(session: ExtractionSession): Promise<void>;
+/**
+ * Start the dev watcher: fs.watch per eligible top-level directory (plus a
+ * non-recursive watch on the root itself), debounced into
+ * existence-partitioned modified/removed sets feeding
+ * `session.handleWatchUpdate` (serialized — updates never overlap).
+ * Generated and vendored trees (`.animus`, `.next`, node_modules) are never
+ * registered with the OS — recursive registration of those trees exhausts
+ * inotify/kqueue descriptors (EMFILE/ENOSPC) on large projects.
+ * Idempotent per project root; unref'd so it never holds the process open.
+ * Asynchronous FSWatcher errors degrade to no-watch with a warning instead
+ * of crashing the dev server. Returns a close handle, or null when this
+ * root is already watched or the platform lacks recursive fs.watch (Linux
+ * before Node 20 — degrades to no-watch with a warning).
+ */
+export declare function startTurbopackWatcher(session: ExtractionSession, rootDir: string, debounceMs?: number, watchFn?: typeof watch): {
+    close(): void;
+} | null;
+//# sourceMappingURL=turbopack-orchestrator.d.ts.map

package/dist/turbopack-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-orchestrator.d.ts","sourceRoot":"","sources":["../src/turbopack-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,EAAE,MAAM,IAAI,CAAC;AAK9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AAEH;;iDAEiD;AACjD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAK,EAGf,OAAO,GAAE,OAAO,KAAa,GAC5B;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,GAAG,IAAI,CA0G1B"}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { StaticCssConfig } from '@animus-ui/extract/pipeline';
 export interface AnimusNextOptions {
     /** Path to a module exporting a SystemInstance from `@animus-ui/system`. */
     system: string;
@@ -15,26 +16,82 @@ export interface AnimusNextOptions {
     extensions?: string[];
     /** When true, extraction failures throw instead of warning. */
     strict?: boolean;
+    /**
+     * Project-root-relative path of the single file that receives the
+     * `import '.animus/styles.css'` injection (the stylesheet import is
+     * stripped from every other file to prevent per-chunk CSS duplication).
+     * Set this when your root entry doesn't match the default detection of
+     * `app/layout.*` / `pages/_app.*`, optionally under `src/` — e.g. a
+     * nested App Router root layout like `'src/app/[locale]/layout.tsx'`.
+     */
+    cssImportTarget?: string;
     /** Enable verbose logging. */
     verbose?: boolean;
     /** Namespace prefix for CSS variables and class names. */
     prefix?: string;
     /**
-     * Extraction engine selection. `'v2'` (default) is the production
-     * engine — parity-proven against v1 with 8× fewer parses and no cache
-     * machinery. `'v1'` remains selectable and functional as the escape
-     * hatch until v1 retires. Propagated to every compiler instance,
-     * including non-owning ones.
+     * Forced-emission declarations for usage the scanner cannot observe
+     * (CMS-driven variants, spread-hidden props, dynamically selected
+     * components). Declared variants/states/system-prop values and custom
+     * dynamic slots are emitted as if used; entries are labeled as forced
+     * in the extraction report. Empty/absent is a no-op.
+     */
+    staticCss?: StaticCssConfig;
+    /**
+     * Browser targets for CSS autoprefixing and syntax lowering.
+     * Accepts a browserslist query string or array of queries.
+     * Falls back to project's browserslist config, then to `defaults`.
+     */
+    targets?: string | string[];
+    /**
+     * Control CSS minification of the emitted stylesheet.
+     * - `true`: always minify (dev + prod)
+     * - `false`: never minify (autoprefixing still applies)
+     * - `undefined` (default): minify in production (`NODE_ENV === 'production'`)
+     */
+    minify?: boolean;
+    /**
+     * Extraction engine selection. `'v2'` is the only engine and the default,
+     * propagated to every compiler instance (including non-owning ones). The v1
+     * engine was retired (openspec: retire-extract-v1); configuring
+     * `engine: 'v1'` (or setting `ANIMUS_ENGINE=v1`) throws — the selection is
+     * never silently upgraded.
      *
      * @default 'v2'
      */
-    engine?: 'v1' | 'v2';
+    engine?: 'v2';
+    /**
+     * Turbopack integration mode.
+     *
+     * - `'auto'` (default): activate whenever the process runs under
+     *   Turbopack (Next sets the `TURBOPACK` environment variable for every
+     *   Turbopack dev/build). Zero-config support for Next 16 defaults and
+     *   `next dev --turbopack` on Next 15.
+     * - `'on'`: always generate Turbopack wiring.
+     * - `'off'`: webpack-only; no Turbopack keys are generated.
+     *
+     * When active, extraction runs during next.config resolution (the wrapped
+     * config resolves asynchronously — Next awaits it), a dev watcher re-runs
+     * analysis on source changes, and per-file transforms run in a stateless
+     * loader fed by `.animus/` disk artifacts.
+     */
+    turbopack?: {
+        mode?: 'auto' | 'on' | 'off';
+    };
+    /**
+     * @deprecated Use `turbopack` — same shape. Honored for one release
+     * cycle with a one-time warning; `turbopack` wins when both are set.
+     */
+    unstable_turbopack?: {
+        mode?: 'off' | 'auto' | 'on';
+    };
     /**
-     * Full `@layer` declaration order. Must include all 7 Animus layers
-     * (`global`, `base`, `variants`, `compounds`, `states`, `system`, `custom`)
-     * as a subsequence. Consumer layers may be interleaved.
+     * Full `@layer` declaration order. Must include all 7 Animus `anm-*`
+     * layers (`anm-global`, `anm-base`, `anm-variants`, `anm-compounds`,
+     * `anm-states`, `anm-system`, `anm-custom`) as a subsequence. Consumer
+     * layers may be interleaved. Names are emitted as-is.
      *
-     * @example ['reset', 'global', 'base', 'variants', 'compounds', 'states', 'system', 'custom', 'overrides']
+     * @example ['reset', 'anm-global', 'anm-base', 'anm-variants', 'anm-compounds', 'anm-states', 'anm-system', 'anm-custom', 'overrides']
      */
     layers?: string[];
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;KAAE,CAAC;IAC7C;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/with-animus.d.ts

@@ -28,6 +28,6 @@ type NextConfig = Record<string, unknown> & {
  * export default withAnimus({ system: './src/ds.ts' })({});
  * ```
  */
-export declare function withAnimus(options: AnimusNextOptions): (nextConfig: NextConfig) => NextConfig;
+export declare function withAnimus(options: AnimusNextOptions): (nextConfig: NextConfig) => NextConfig | Promise<NextConfig>;
 export {};
 //# sourceMappingURL=with-animus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"with-animus.d.ts","sourceRoot":"","sources":["../src/with-animus.ts"],"names":[],"mappings":"AAMA,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;AAIF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,iBAAiB,GACzB,CAAC,UAAU,EAAE,UAAU,KAAK,UAAU,CAgLxC"}
+{"version":3,"file":"with-animus.d.ts","sourceRoot":"","sources":["../src/with-animus.ts"],"names":[],"mappings":"AAsBA,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,CAgM9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/next-plugin",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Animus static CSS extraction for Next.js (webpack)",
   "keywords": [
     "animus",
@@ -36,15 +36,15 @@
   },
   "scripts": {
     "build": "bun run build:ts",
-    "build:ts": "tsdown && tsgo -p tsconfig.build.json",
-    "compile": "tsgo --noEmit"
+    "build:ts": "tsdown && tsc -p tsconfig.build.json",
+    "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.1"
+    "@animus-ui/extract": "0.1.3"
   },
   "peerDependencies": {
     "@mdx-js/mdx": "^3.0.0",
-    "next": ">=15 <16",
+    "next": ">=15 <17",
     "webpack": ">=5 <6"
   },
   "peerDependenciesMeta": {

package/dist/analyze-project-args.d.ts

@@ -1,33 +0,0 @@
-export type AnalyzeProjectArgs = [
-    filesJson: string,
-    scalesJson: string,
-    variableMapJson: string,
-    contextualVarsJson: string | null,
-    propConfigJson: string,
-    groupRegistryJson: string,
-    packageResolutionJson: string,
-    devMode: boolean,
-    emitterConfigJson: string | null,
-    selectorAliasesJson: string | null,
-    selectorOrderJson: null,
-    globalStyleBlocksJson: string | null,
-    pathAliasesJson: string | null,
-    keyframesJson: string | null
-];
-export interface AnalyzeProjectInputs {
-    filesJson: string;
-    scalesJson: string;
-    variableMapJson: string;
-    contextualVarsJson: string | null;
-    propConfigJson: string;
-    groupRegistryJson: string;
-    packageResolutionJson: string;
-    emitterConfigJson: string | null;
-    selectorAliasesJson: string | null;
-    globalStyleBlocksJson: string | null;
-    pathAliasesJson: string | null;
-    keyframesJson: string | null;
-}
-export declare function buildProductionAnalyzeProjectArgs(inputs: AnalyzeProjectInputs): AnalyzeProjectArgs;
-export declare function buildHmrAnalyzeProjectArgs(inputs: AnalyzeProjectInputs): AnalyzeProjectArgs;
-//# sourceMappingURL=analyze-project-args.d.ts.map

package/dist/analyze-project-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analyze-project-args.d.ts","sourceRoot":"","sources":["../src/analyze-project-args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,MAAM;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI;IACjC,cAAc,EAAE,MAAM;IACtB,iBAAiB,EAAE,MAAM;IACzB,qBAAqB,EAAE,MAAM;IAC7B,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAClC,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI;CAC7B,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAwBD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAEpB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAEpB"}