@animus-ui/next-plugin 0.1.11 → 0.1.12

package/dist/turbopack-loader.mjs

@@ -1,21 +1,18 @@
-import { t as transformWithManifest } from "./loader-core-DwiidYBi.mjs";
+import { t as transformWithManifest } from "./loader-core-x6cOzF9v.mjs";
 import { createRequire } from "node:module";
-import { buildAnalyzeProjectArgs, contentHash, createV2EngineApi } from "@animus-ui/extract/pipeline";
+import { buildAnalyzeProjectArgs, contentHash, createV2EngineApi, parseFilesJson } from "@animus-ui/extract/pipeline";
 import { analysisCommitPath, analysisInputsPath, analysisStatusPath, manifestPath, readJsonEnvelope, replacementEpochPath, sessionArtifactDir } from "@animus-ui/extract/session";
 import * as nodeFs from "fs";
 import { relative } from "path";
 //#region \0rolldown/runtime.js
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
 //#endregion
 //#region src/turbopack-loader.ts
 let engine = null;
 let sentSources = null;
 let driftWarned = false;
-/** Hydration identity: `${commitPath}:${contentHash(commitRaw)}` — the
-*  commit CONTENT keys hydration; mtime/size never do (design D1). */
 let hydratedKey = null;
 let hydratedManifestJson = null;
-/** Committed per-file analyzed content hashes (from the inputs). */
 let hydratedFileHashes = null;
 const engineModuleId = "@animus-ui/extract";
 const engineApi$1 = createV2EngineApi({
@@ -38,15 +35,18 @@ const engineApi$1 = createV2EngineApi({
 		}
 	}
 });
+let engineApiImpl = engineApi$1;
+/** @internal test seam. */
+function __setTurbopackLoaderEngineApiForTests(api) {
+	engineApiImpl = api ?? engineApi$1;
+}
 let fsImpl = nodeFs;
-/** @internal test seam — pass null to restore the real fs. */
+/** @internal test seam. */
 function __setTurbopackLoaderFsForTests(fs) {
 	fsImpl = fs ?? nodeFs;
 }
-/** Epoch artifact paths SEEN on disk (per-worker) — the artifact is never
-*  deleted once written, so a positive probe is stable; negatives re-probe. */
 const epochSeenPaths = /* @__PURE__ */ new Set();
-/** @internal test seam — drop worker-local hydration state. */
+/** @internal test seam. */
 function __resetTurbopackLoaderStateForTests() {
 	hydratedKey = null;
 	hydratedManifestJson = null;
@@ -60,16 +60,10 @@ function readFileOrNull(path) {
 		return null;
 	}
 }
-const SEQLOCK_RETRIES = 5;
-/**
-* Seqlock-style artifact read: commit C0 → payloads → hash verification
-* against C0 → commit re-read; accept only if unchanged, else retry
-* (bounded) — a torn or mismatched set is never consumed (design D1).
-* Hydration replays the committed analysis inputs once per commit content.
-*/
+const ARTIFACT_READ_RETRIES = 5;
 function hydrateSession(sessionDir, sessionId) {
 	const commitPath = analysisCommitPath(sessionDir);
-	for (let attempt = 0; attempt < SEQLOCK_RETRIES; attempt++) {
+	for (let attempt = 0; attempt < ARTIFACT_READ_RETRIES; attempt++) {
 		const c0raw = readFileOrNull(commitPath);
 		if (c0raw === null) return { kind: "absent" };
 		let c0;
@@ -106,11 +100,11 @@ function hydrateSession(sessionDir, sessionId) {
 			};
 			const inputsParsed = JSON.parse(inputsRaw);
 			inputs = inputsParsed;
-			fileHashes = inputsParsed.analyzedHashes ? new Map(Object.entries(inputsParsed.analyzedHashes)) : new Map(JSON.parse(inputs.filesJson).map((entry) => [entry.path, entry.hash ?? contentHash(entry.source)]));
+			fileHashes = inputsParsed.analyzedHashes ? new Map(Object.entries(inputsParsed.analyzedHashes)) : new Map(parseFilesJson(inputs.filesJson, "animus-next-turbopack").map((entry) => [entry.path, entry.hash ?? contentHash(entry.source)]));
 		} catch {
 			return { kind: "torn" };
 		}
-		const { analyzeProject } = engineApi$1();
+		const { analyzeProject } = engineApiImpl();
 		hydratedManifestJson = analyzeProject(...buildAnalyzeProjectArgs(inputs));
 		hydratedFileHashes = fileHashes;
 		hydratedKey = key;
@@ -134,33 +128,28 @@ function readStatus(sessionDir) {
 		return null;
 	}
 }
+const hasReadableDeadline = (status) => Object.prototype.toString.call(status.deadlineAt) === "[object Number]";
 const CATCHUP_POLL_INITIAL_MS = 10;
 const CATCHUP_POLL_MAX_MS = 25;
 const CATCHUP_WAIT_MARGIN_MS = 50;
-const CATCHUP_WATCHDOG_MS = 2e3;
-/** The loader cannot read the orchestrator's configured debounce, so its
-*  own ceiling assumes the default watcher debounce. */
-const DEFAULT_DEBOUNCE_CEILING_MS = 75;
+/** Bounds the one wait carrying no deadline — a status whose `deadlineAt` is
+*  not numeric. The session-published deadline bounds every other wait.
+*  Equal to the session's status watchdog by coincidence only: never unify
+*  them, and never re-derive a deadline from the watcher debounce. */
+const CATCHUP_NO_DEADLINE_CAP_MS = 2e3;
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
-const ACTIVE_STATES = new Set([
+const ACTIVE_STATES = /* @__PURE__ */ new Set([
 	"starting",
 	"debouncing",
 	"analyzing",
 	"committing"
 ]);
-/**
-* Turbopack loader for Animus source transformation. Derives everything
-* from the incoming source, its JSON-serializable options (carrying the
-* session identity), and the session's COMMITTED disk artifacts written by
-* the out-of-band orchestrator. Async by contract — the evidence-based
-* catch-up (design D3) waits, bounded, for an imminent commit.
-*/
 function animusTurbopackLoader(source) {
-	if (typeof this.async !== "function") throw new Error("[animus-extract] the Animus Turbopack loader requires an async-capable loader runner (this.async is unavailable)");
+	if (this.async === void 0) throw new Error("[animus-extract] the Animus Turbopack loader requires an async-capable loader runner (this.async is unavailable)");
 	const callback = this.async();
-	runLoader(this, source).then((code) => callback(null, code), (err) => callback(err instanceof Error ? err : new Error(String(err))));
+	runLoader(this, source).then((code) => callback(null, code), (thrown) => callback(thrown instanceof Error ? thrown : new Error(String(thrown))));
 }
 async function runLoader(ctx, source) {
 	const opts = ctx.getOptions?.() ?? {};
@@ -171,17 +160,15 @@ async function runLoader(ctx, source) {
 	const commitPath = analysisCommitPath(sessionDir);
 	const statusPath = analysisStatusPath(sessionDir);
 	const epochPath = replacementEpochPath(sessionDir);
-	if (typeof ctx.addDependency === "function" && (epochSeenPaths.has(epochPath) || fsImpl.existsSync(epochPath))) {
+	if (ctx.addDependency !== void 0 && (epochSeenPaths.has(epochPath) || fsImpl.existsSync(epochPath))) {
 		epochSeenPaths.add(epochPath);
 		ctx.addDependency(epochPath);
 	}
 	const filename = relative(rootDir, ctx.resourcePath);
-	/** EVERY failing path registers the commit + status artifacts as
-	*  dependencies BEFORE throwing (the loader-runner sends dependency IPC
-	*  ahead of the error check upstream), so a landing commit or status
-	*  transition re-triggers the invocation — the documented
-	*  read→registration race makes this a recovery aid, never the primary
-	*  wakeup (design D3). Successful paths add NO commit/status dependency. */
+	/** Registers commit and status as dependencies before throwing: the runner
+	*  sends dependency IPC ahead of the error, so a landing commit re-fires.
+	*  Failure paths only — successful paths register neither, so this must not
+	*  be hoisted out of the failure helper. */
 	const coverageFailure = (message) => {
 		ctx.addDependency?.(commitPath);
 		ctx.addDependency?.(statusPath);
@@ -191,12 +178,12 @@ async function runLoader(ctx, source) {
 		source,
 		filename,
 		manifestJson,
-		engineApi: engineApi$1,
+		engineApi: engineApiImpl,
 		opts
 	});
 	const outcome = hydrateSession(sessionDir, sessionId);
 	if (outcome.kind === "foreign") throw coverageFailure(`ANIMUS_FOREIGN_SESSION: artifacts under ${sessionDir} belong to session ${outcome.artifactSessionId}, not ${sessionId} — refusing to transform from a foreign generation`);
-	if (outcome.kind === "torn") throw coverageFailure(`ANIMUS_ARTIFACT_READ_TORN: could not obtain a consistent committed artifact set for ${filename} after ${SEQLOCK_RETRIES} attempts`);
+	if (outcome.kind === "torn") throw coverageFailure(`ANIMUS_ARTIFACT_READ_TORN: could not obtain a consistent committed artifact set for ${filename} after ${ARTIFACT_READ_RETRIES} attempts`);
 	let sourceHash = null;
 	if (outcome.kind === "ok") {
 		const analyzedHash = outcome.hydration.fileHashes.get(filename);
@@ -214,17 +201,9 @@ async function runLoader(ctx, source) {
 		transform
 	});
 }
-/**
-* The catch-up decision table (design D3 — implemented verbatim). Waits —
-* polled, bounded — ONLY in the two evidence states: commit absent while an
-* attempt is active, or the active attempt's pending set contains this file
-* at its current hash. Everything else fails immediately with its stable
-* diagnostic. The moment a commit lands that covers the input, the seqlock
-* hydration consumes it and the transform proceeds with no diagnostic.
-*/
 async function awaitCoverage(args) {
 	const { source, sourceHash, filename, sessionId, sessionDir, coverageFailure, transform } = args;
-	const ceiling = Date.now() + DEFAULT_DEBOUNCE_CEILING_MS + CATCHUP_WATCHDOG_MS + CATCHUP_WAIT_MARGIN_MS;
+	const noDeadlineCap = Date.now() + CATCHUP_NO_DEADLINE_CAP_MS + CATCHUP_WAIT_MARGIN_MS;
 	let poll = CATCHUP_POLL_INITIAL_MS;
 	for (;;) {
 		const outcome = hydrateSession(sessionDir, sessionId);
@@ -246,11 +225,12 @@ async function awaitCoverage(args) {
 			if (!(status.pending ?? []).some(([key, hash]) => key === filename && hash === sourceHash)) throw coverageFailure(`ANIMUS_ANALYSIS_NOT_SCHEDULED: the active analysis attempt (${status.attemptId}) has not observed ${filename} at its current content`);
 		}
 		const now = Date.now();
-		if (typeof status.deadlineAt === "number" && now > status.deadlineAt) throw coverageFailure(`ANIMUS_ANALYSIS_STALLED: analysis attempt ${status.attemptId} exceeded its deadline while ${filename} waited for coverage`);
-		if (now > ceiling) throw coverageFailure(`ANIMUS_ANALYSIS_CATCHING_UP: ${filename} changed after the committed analysis; timed out waiting for the commit to advance — retrying on the next invalidation`);
+		if (hasReadableDeadline(status)) {
+			if (now > status.deadlineAt) throw coverageFailure(`ANIMUS_ANALYSIS_STALLED: analysis attempt ${status.attemptId} exceeded its deadline while ${filename} waited for coverage`);
+		} else if (now > noDeadlineCap) throw coverageFailure(`ANIMUS_ANALYSIS_CATCHING_UP: ${filename} changed after the committed analysis; timed out waiting for the commit to advance — retrying on the next invalidation`);
 		await sleep(poll);
 		poll = CATCHUP_POLL_MAX_MS;
 	}
 }
 //#endregion
-export { __resetTurbopackLoaderStateForTests, __setTurbopackLoaderFsForTests, animusTurbopackLoader as default };
+export { __resetTurbopackLoaderStateForTests, __setTurbopackLoaderEngineApiForTests, __setTurbopackLoaderFsForTests, animusTurbopackLoader as default };

package/dist/types.d.ts

@@ -2,116 +2,50 @@ import type { StaticCssConfig } from '@animus-ui/extract/pipeline';
 export interface AnimusNextOptions {
     /** Path to a module exporting a SystemInstance from `@animus-ui/system`. */
     system: string;
-    /**
-     * Exclusion patterns (substrings, or globs when `*`/`?` present). When
-     * set, REPLACES the replaceable defaults (`dist`, `.test.`, `.spec.`);
-     * `node_modules`, `.next`, and `.animus` are always excluded.
-     */
+    /** Substrings, or globs when `*`/`?` present. Replaces `dist`/`.test.`/
+     *  `.spec.`; `node_modules`, `.next` and `.animus` are always excluded. */
     exclude?: string[];
-    /**
-     * File extensions to scan for component definitions and JSX usages.
-     * Replaces the default list entirely (not additive). Include `.mdx` to
-     * extract components rendered from MDX files — `@mdx-js/mdx` must be
-     * installed as a peer for MDX files to be preprocessed; otherwise the
-     * plugin warns once at buildStart and skips them.
-     *
-     * @default ['.ts', '.tsx', '.js', '.jsx', '.mdx']
-     */
+    /** Extensions scanned for definitions and usages; replaces the default
+     *  `['.ts','.tsx','.js','.jsx','.mdx']`. `.mdx` needs `@mdx-js/mdx`. */
     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'`.
-     */
+    /** Project-root-relative path of the one file that receives the stylesheet
+     *  import; replaces the `app/layout.*` / `pages/_app.*` detection. */
     cssImportTarget?: string;
-    /** Enable verbose logging. */
     verbose?: boolean;
     /** Namespace prefix for CSS variables and class names. */
     prefix?: string;
-    /**
-     * 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.
-     */
+    /** Forced-emission declarations for usage the scanner cannot observe
+     *  (CMS-driven variants, spread-hidden props). 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`.
-     */
+    /** Browserslist query string or array. Falls back to the 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 (per `mode`, else
-     *   `NODE_ENV === 'production'`)
-     */
+    /** `true`/`false` force minification on or off; absent minifies in
+     *  production. Autoprefixing applies either way. */
     minify?: boolean;
-    /**
-     * Explicit dev/prod emission mode. Wins over the environment signal.
-     * When absent, the documented default applies: `NODE_ENV === 'production'`
-     * decides the minify default, and the compiler's dev flag decides the
-     * dev-diagnostics define.
-     */
+    /** Explicit emission mode, winning over the environment signal that
+     *  otherwise decides minification and the dev-diagnostics define. */
     mode?: 'development' | 'production';
-    /**
-     * 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'
-     */
+    /** `'v2'` is the only engine and the default. `engine: 'v1'` or
+     *  `ANIMUS_ENGINE=v1` throws — the selection is never silently upgraded. */
     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.
-     */
+    /** `'auto'` (default) generates Turbopack wiring whenever the `TURBOPACK`
+     *  environment variable is set; `'on'` always, `'off'` never. */
     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.
-     */
+    /** @deprecated Use `turbopack` — same shape, and it wins when both are
+     *  set. This alias warns once. */
     unstable_turbopack?: {
         mode?: 'off' | 'auto' | 'on';
     };
-    /**
-     * @internal Absolute path of the loader module registered in the webpack
-     * rule when it is not this package's own dist/src loader (test harnesses
-     * wrapping the real loader in a require-able shim). Feeds the needBuild
-     * loader-chain predicate; `withAnimus` never sets it.
-     */
+    /** @internal Absolute path of a loader module registered in place of this
+     *  package's own; feeds the needBuild loader-chain predicate. */
     loaderPath?: string;
-    /**
-     * 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', 'anm-global', 'anm-base', 'anm-variants', 'anm-compounds', 'anm-states', 'anm-system', 'anm-custom', 'overrides']
-     */
+    /** Full `@layer` declaration order, emitted as-is. Must contain the seven
+     *  `anm-*` layers as a subsequence; consumer layers may be interleaved. */
     layers?: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"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;;;;OAIG;IACH,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;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;;;;;;;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;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;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;+EAC2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;4EACwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;0EACsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;yEACqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;mDAC+C;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;wDACoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;yEACqE;IACrE,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;gFAC4E;IAC5E,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;qEACiE;IACjE,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;KAAE,CAAC;IAC7C;sCACkC;IAClC,kBAAkB,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD;qEACiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+EAC2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/with-animus.d.ts

@@ -1,33 +1,48 @@
 import type { AnimusNextOptions } from './types';
-type WebpackConfig = {
-    plugins?: unknown[];
+import type { TurbopackWatchOutcome } from '@animus-ui/extract/session';
+import type { NextConfig as NextOwnedConfig, TurbopackOptions } from 'next/dist/server/config-shared';
+type WebpackPluginEntry = object | false | null | undefined;
+interface WebpackLoaderUse {
+    loader: string;
+    options?: object | string;
+}
+interface WebpackRule {
+    test?: RegExp | ((path: string) => boolean);
+    exclude?: RegExp | ((path: string) => boolean);
+    enforce?: string;
+    use?: WebpackLoaderUse[];
+}
+interface WebpackConfig {
+    plugins?: WebpackPluginEntry[];
     resolve?: {
         alias?: Record<string, string>;
     };
     module?: {
-        rules?: Array<{
-            test?: RegExp | ((path: string) => boolean);
-            exclude?: RegExp | ((path: string) => boolean);
-            enforce?: string;
-            use?: Array<{
-                loader: string;
-                options?: Record<string, unknown>;
-            }>;
-        }>;
+        rules?: WebpackRule[];
     };
+}
+type DefinePluginConstructor = new (definitions: Record<string, string>) => object;
+interface NextWebpackContext {
+    dir?: string;
+    dev?: boolean;
+    webpack?: {
+        DefinePlugin?: DefinePluginConstructor;
+    };
+}
+type NextWebpackHook = (config: WebpackConfig, context: NextWebpackContext) => WebpackConfig;
+interface NextConfigBoundary {
+    webpack?: NextWebpackHook | null;
+    turbopack?: TurbopackOptions;
+}
+type CallableNextConfig = (...args: never[]) => NextOwnedConfig | Promise<NextOwnedConfig>;
+export type { NextConfigBoundary as AnimusNextConfigBoundary };
+export type NextConfigInput<Config extends NextOwnedConfig> = Config extends CallableNextConfig ? never : Config & NextConfigBoundary;
+export type WebpackNextConfig<Config extends NextOwnedConfig> = Omit<Config, 'webpack'> & {
+    webpack: NextWebpackHook;
 };
-type NextConfig = Record<string, unknown> & {
-    webpack?: (config: WebpackConfig, context: Record<string, unknown>) => WebpackConfig;
+export type TurbopackNextConfig<Config extends NextOwnedConfig> = Omit<Config, 'turbopack'> & {
+    turbopack: TurbopackOptions;
 };
-/**
- * Wrap a Next.js config to enable Animus static CSS extraction.
- *
- * ```ts
- * // next.config.ts
- * import { withAnimus } from '@animus-ui/next-plugin';
- * export default withAnimus({ system: './src/ds.ts' })({});
- * ```
- */
-export declare function withAnimus(options: AnimusNextOptions): (nextConfig: NextConfig) => NextConfig | Promise<NextConfig>;
-export {};
+export declare function withAnimus(options: AnimusNextOptions): <Config extends NextOwnedConfig>(nextConfig: NextConfigInput<Config>) => WebpackNextConfig<Config> | Promise<TurbopackNextConfig<Config>>;
+export declare function bindTurbopackWatchDeathReport(outcome: TurbopackWatchOutcome, rootDir: string): void;
 //# 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":"AA4BA,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,CAoP9D"}
+{"version":3,"file":"with-animus.d.ts","sourceRoot":"","sources":["../src/with-animus.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EACV,UAAU,IAAI,eAAe,EAC7B,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAKxC,KAAK,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;KACvB,CAAC;CACH;AAED,KAAK,uBAAuB,GAAG,KAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAChC,MAAM,CAAC;AAEZ,UAAU,kBAAkB;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,uBAAuB,CAAC;KACxC,CAAC;CACH;AAED,KAAK,eAAe,GAAG,CACrB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,kBAAkB,KACxB,aAAa,CAAC;AAEnB,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,KAAK,kBAAkB,GAAG,CACxB,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAIhD,YAAY,EAAE,kBAAkB,IAAI,wBAAwB,EAAE,CAAC;AAE/D,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,eAAe,IACxD,MAAM,SAAS,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE1E,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,eAAe,IAAI,IAAI,CAClE,MAAM,EACN,SAAS,CACV,GAAG;IACF,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,eAAe,IAAI,IAAI,CACpE,MAAM,EACN,WAAW,CACZ,GAAG;IACF,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAKF,wBAAgB,UAAU,CACxB,OAAO,EAAE,iBAAiB,GACzB,CAAC,MAAM,SAAS,eAAe,EAChC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,KAChC,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CA4LpE;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,MAAM,GACd,IAAI,CASN"}

package/package.json

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

package/dist/loader-core-D2rh--tX.cjs

@@ -1,71 +0,0 @@
-//#region src/loader-core.ts
-/**
-* Regex matching CSS import lines injected by the Rust emitter.
-* Catches both the alias form (`import '.animus/styles.css'`),
-* relative forms (`import '../.animus/styles.css'`), and the Vite
-* virtual module form (`import 'virtual:animus/styles.css'`) which
-* appears in pre-built external packages compiled with the Vite plugin.
-*/
-const CSS_IMPORT_RE = /import\s+['"](?:[^'"]*\.animus\/styles\.css|virtual:animus\/styles\.css)['"];\n?/g;
-/**
-* Default root entry file patterns. CSS is imported ONLY in the root entry
-* to prevent per-chunk duplication in Next.js builds.
-*
-* - App Router: `app/layout.tsx` (root layout wraps all routes)
-* - Pages Router: `pages/_app.tsx` (custom App wraps all pages)
-*
-* The `(src\/)?` prefix handles projects that use a `src/` directory.
-* Projects whose root entry doesn't match (nested layouts, monorepo roots)
-* set the `cssImportTarget` plugin option, which replaces this detection.
-*/
-const ROOT_ENTRY_RE = /^(src\/)?(?:app\/layout|pages\/_app)\.[tj]sx?$/;
-/** Normalize separators and strip a leading './' for path comparison. */
-function normalizePath(p) {
-	return p.replace(/\\/g, "/").replace(/^\.\//, "");
-}
-/**
-* Decide whether `filename` (project-root-relative) is the file that
-* receives the single CSS import. An explicit `cssImportTarget` replaces
-* the default filename-convention detection. Separators are normalized
-* first — Windows `relative()` yields backslashes the patterns would miss.
-*/
-function isCssImportTarget(filename, cssImportTarget) {
-	const normalized = normalizePath(filename);
-	if (cssImportTarget) return normalized === normalizePath(cssImportTarget);
-	return ROOT_ENTRY_RE.test(normalized);
-}
-/**
-* Transform one source file against a manifest: replace builder chains via
-* the engine, strip emitter-injected stylesheet imports everywhere, and
-* re-inject a single import at the root entry (after any leading
-* `'use client'` directive). On failure: throw in strict mode, otherwise
-* warn and return the source unchanged.
-*/
-function transformWithManifest(args) {
-	const { source, filename, manifestJson, engineApi, opts } = args;
-	const isRootEntry = isCssImportTarget(filename, opts.cssImportTarget);
-	try {
-		const { transformFile } = engineApi();
-		const result = transformFile(source, filename, manifestJson);
-		let code = result.hasComponents ? result.code : source;
-		code = code.replace(CSS_IMPORT_RE, "");
-		if (isRootEntry && !code.includes(".animus/styles.css")) if (code.startsWith("'use client'") || code.startsWith("\"use client\"")) {
-			const nl = code.indexOf("\n");
-			if (nl === -1) code = `${code}\nimport '.animus/styles.css';\n`;
-			else code = `${code.slice(0, nl + 1)}import '.animus/styles.css';\n${code.slice(nl + 1)}`;
-		} else code = `import '.animus/styles.css';\n${code}`;
-		return code;
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		if (opts.strict) throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
-		console.warn(`[animus-extract] Transform failed for ${filename}:`, msg);
-		return source;
-	}
-}
-//#endregion
-Object.defineProperty(exports, "transformWithManifest", {
-	enumerable: true,
-	get: function() {
-		return transformWithManifest;
-	}
-});

package/dist/loader-core-DwiidYBi.mjs

@@ -1,66 +0,0 @@
-//#region src/loader-core.ts
-/**
-* Regex matching CSS import lines injected by the Rust emitter.
-* Catches both the alias form (`import '.animus/styles.css'`),
-* relative forms (`import '../.animus/styles.css'`), and the Vite
-* virtual module form (`import 'virtual:animus/styles.css'`) which
-* appears in pre-built external packages compiled with the Vite plugin.
-*/
-const CSS_IMPORT_RE = /import\s+['"](?:[^'"]*\.animus\/styles\.css|virtual:animus\/styles\.css)['"];\n?/g;
-/**
-* Default root entry file patterns. CSS is imported ONLY in the root entry
-* to prevent per-chunk duplication in Next.js builds.
-*
-* - App Router: `app/layout.tsx` (root layout wraps all routes)
-* - Pages Router: `pages/_app.tsx` (custom App wraps all pages)
-*
-* The `(src\/)?` prefix handles projects that use a `src/` directory.
-* Projects whose root entry doesn't match (nested layouts, monorepo roots)
-* set the `cssImportTarget` plugin option, which replaces this detection.
-*/
-const ROOT_ENTRY_RE = /^(src\/)?(?:app\/layout|pages\/_app)\.[tj]sx?$/;
-/** Normalize separators and strip a leading './' for path comparison. */
-function normalizePath(p) {
-	return p.replace(/\\/g, "/").replace(/^\.\//, "");
-}
-/**
-* Decide whether `filename` (project-root-relative) is the file that
-* receives the single CSS import. An explicit `cssImportTarget` replaces
-* the default filename-convention detection. Separators are normalized
-* first — Windows `relative()` yields backslashes the patterns would miss.
-*/
-function isCssImportTarget(filename, cssImportTarget) {
-	const normalized = normalizePath(filename);
-	if (cssImportTarget) return normalized === normalizePath(cssImportTarget);
-	return ROOT_ENTRY_RE.test(normalized);
-}
-/**
-* Transform one source file against a manifest: replace builder chains via
-* the engine, strip emitter-injected stylesheet imports everywhere, and
-* re-inject a single import at the root entry (after any leading
-* `'use client'` directive). On failure: throw in strict mode, otherwise
-* warn and return the source unchanged.
-*/
-function transformWithManifest(args) {
-	const { source, filename, manifestJson, engineApi, opts } = args;
-	const isRootEntry = isCssImportTarget(filename, opts.cssImportTarget);
-	try {
-		const { transformFile } = engineApi();
-		const result = transformFile(source, filename, manifestJson);
-		let code = result.hasComponents ? result.code : source;
-		code = code.replace(CSS_IMPORT_RE, "");
-		if (isRootEntry && !code.includes(".animus/styles.css")) if (code.startsWith("'use client'") || code.startsWith("\"use client\"")) {
-			const nl = code.indexOf("\n");
-			if (nl === -1) code = `${code}\nimport '.animus/styles.css';\n`;
-			else code = `${code.slice(0, nl + 1)}import '.animus/styles.css';\n${code.slice(nl + 1)}`;
-		} else code = `import '.animus/styles.css';\n${code}`;
-		return code;
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		if (opts.strict) throw new Error(`[animus-extract] Transform failed for ${filename}: ${msg}`, { cause: e });
-		console.warn(`[animus-extract] Transform failed for ${filename}:`, msg);
-		return source;
-	}
-}
-//#endregion
-export { transformWithManifest as t };