@animus-ui/next-plugin 0.1.6 → 0.1.8

package/dist/loader-path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The one loader-path derivation: first existing dist candidate under the
+ * plugin dir, else the in-repo source fallback. Both loader resolvers below
+ * are thin wrappers, so rule registration and any loader-chain predicate
+ * can never drift (openspec: next-webpack-served-transform-coherence,
+ * design D1).
+ */
+export declare function resolveLoaderPath(pluginDir: string, distCandidates: string[], sourceFallback: string): string;
+/**
+ * This package's webpack loader path, shared by the rule registration
+ * (with-animus) and the needBuild loader-chain predicate (plugin). Compiled
+ * dist ships `loader.mjs` next to this module; running from source falls
+ * back to the TypeScript loader.
+ */
+export declare function resolveAnimusLoaderPath(): string;
+//# sourceMappingURL=loader-path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader-path.d.ts","sourceRoot":"","sources":["../src/loader-path.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EAAE,EACxB,cAAc,EAAE,MAAM,GACrB,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/loader.cjs

@@ -1,20 +1,56 @@
-const require_singleton = require("./singleton-DH7yeWZa.cjs");
-const require_loader_core = require("./loader-core-CbaYNhBu.cjs");
+const require_session_paths = require("./session-paths-CZoi19NW.cjs");
+const require_singleton = require("./singleton-D4vhawsW.cjs");
+const require_loader_core = require("./loader-core-C40WbC6s.cjs");
+require("./turbopack-loader.cjs");
+let _animus_ui_extract_pipeline = require("@animus-ui/extract/pipeline");
+let fs = require("fs");
 let path = require("path");
 //#region src/loader.ts
+/** Session dirs whose epoch artifact has been SEEN on disk — the artifact
+*  is never deleted once written, so a positive existsSync is stable for
+*  the life of the process (negatives always re-probe). */
+const epochSeenForSessionDir = /* @__PURE__ */ new Set();
 /**
 * Webpack loader for Animus source transformation.
 * Runs with enforce: 'pre' to see original source before Babel/SWC.
 * The manifest arrives via the process singleton (the webpack pipeline and
 * this loader share one process); the transform + CSS-import policy lives
 * in the shared loader-core.
+*
+* Coherence duties (openspec: next-webpack-served-transform-coherence):
+* every dev invocation registers the replacement-epoch artifact as a file
+* dependency (design D2 — restored persistent-cache modules snapshot it, so
+* offline epoch moves invalidate them), and an analyzed file whose current
+* source hash mismatches its analyzed hash fails with the stable diagnostic
+* `ANIMUS_ANALYSIS_CATCHING_UP` after one refreshed re-check (design D4 —
+* unconditional: a zero-entry stale manifest must never publish raw bytes).
 */
 function animusLoader(source) {
-	const manifestJson = require_singleton.getManifestJson();
+	if (this.mode !== "production" && typeof this.addDependency === "function") {
+		const sessionDir = require_singleton.getSessionArtifactDir();
+		if (sessionDir) {
+			const epochPath = require_session_paths.replacementEpochPath(sessionDir);
+			if (epochSeenForSessionDir.has(sessionDir) || (0, fs.existsSync)(epochPath)) {
+				epochSeenForSessionDir.add(sessionDir);
+				this.addDependency(epochPath);
+			}
+		}
+	}
+	let manifestJson = require_singleton.getManifestJson();
 	if (!manifestJson) return source;
+	const filename = (0, path.relative)(this.rootContext, this.resourcePath);
+	const analyzedHash = require_singleton.getAnalyzedHashes()?.get(filename);
+	if (analyzedHash !== void 0) {
+		const sourceHash = (0, _animus_ui_extract_pipeline.contentHash)(source);
+		if (sourceHash !== analyzedHash) {
+			const refreshedHash = require_singleton.getAnalyzedHashes()?.get(filename);
+			if (refreshedHash === void 0 || sourceHash !== refreshedHash) throw new Error(`ANIMUS_ANALYSIS_CATCHING_UP: ${filename} changed after the current analysis; retrying on the next watch turn`);
+			manifestJson = require_singleton.getManifestJson() ?? manifestJson;
+		}
+	}
 	return require_loader_core.transformWithManifest({
 		source,
-		filename: (0, path.relative)(this.rootContext, this.resourcePath),
+		filename,
 		manifestJson,
 		engineApi: require_singleton.engineApi,
 		opts: this.getOptions?.() ?? {}

package/dist/loader.d.ts

@@ -3,6 +3,11 @@ type LoaderContext = {
     resourcePath: string;
     rootContext: string;
     getOptions: () => LoaderPolicyOptions;
+    /** webpack file-dependency registration — optional so bare policy tests
+     *  can drive the loader without a full context. */
+    addDependency?: (file: string) => void;
+    /** webpack build mode; production invocations stay engine-verbatim. */
+    mode?: 'development' | 'production' | 'none';
 };
 /**
  * Webpack loader for Animus source transformation.
@@ -10,6 +15,14 @@ type LoaderContext = {
  * The manifest arrives via the process singleton (the webpack pipeline and
  * this loader share one process); the transform + CSS-import policy lives
  * in the shared loader-core.
+ *
+ * Coherence duties (openspec: next-webpack-served-transform-coherence):
+ * every dev invocation registers the replacement-epoch artifact as a file
+ * dependency (design D2 — restored persistent-cache modules snapshot it, so
+ * offline epoch moves invalidate them), and an analyzed file whose current
+ * source hash mismatches its analyzed hash fails with the stable diagnostic
+ * `ANIMUS_ANALYSIS_CATCHING_UP` after one refreshed re-check (design D4 —
+ * unconditional: a zero-entry stale manifest must never publish raw bytes).
  */
 export default function animusLoader(this: LoaderContext, source: string): string;
 export {};

package/dist/loader.d.ts.map

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

package/dist/loader.mjs

@@ -1,20 +1,55 @@
-import { r as getManifestJson, t as engineApi } from "./singleton-BKALu7Mk.mjs";
+import { _ as replacementEpochPath } from "./session-paths-DfYIPDcM.mjs";
+import { a as getManifestJson, i as getAnalyzedHashes, n as engineApi, s as getSessionArtifactDir } from "./singleton-372wiSRr.mjs";
 import { t as transformWithManifest } from "./loader-core-D6Tm_b8F.mjs";
+import { contentHash } from "@animus-ui/extract/pipeline";
+import { existsSync } from "fs";
 import { relative } from "path";
 //#region src/loader.ts
+/** Session dirs whose epoch artifact has been SEEN on disk — the artifact
+*  is never deleted once written, so a positive existsSync is stable for
+*  the life of the process (negatives always re-probe). */
+const epochSeenForSessionDir = /* @__PURE__ */ new Set();
 /**
 * Webpack loader for Animus source transformation.
 * Runs with enforce: 'pre' to see original source before Babel/SWC.
 * The manifest arrives via the process singleton (the webpack pipeline and
 * this loader share one process); the transform + CSS-import policy lives
 * in the shared loader-core.
+*
+* Coherence duties (openspec: next-webpack-served-transform-coherence):
+* every dev invocation registers the replacement-epoch artifact as a file
+* dependency (design D2 — restored persistent-cache modules snapshot it, so
+* offline epoch moves invalidate them), and an analyzed file whose current
+* source hash mismatches its analyzed hash fails with the stable diagnostic
+* `ANIMUS_ANALYSIS_CATCHING_UP` after one refreshed re-check (design D4 —
+* unconditional: a zero-entry stale manifest must never publish raw bytes).
 */
 function animusLoader(source) {
-	const manifestJson = getManifestJson();
+	if (this.mode !== "production" && typeof this.addDependency === "function") {
+		const sessionDir = getSessionArtifactDir();
+		if (sessionDir) {
+			const epochPath = replacementEpochPath(sessionDir);
+			if (epochSeenForSessionDir.has(sessionDir) || existsSync(epochPath)) {
+				epochSeenForSessionDir.add(sessionDir);
+				this.addDependency(epochPath);
+			}
+		}
+	}
+	let manifestJson = getManifestJson();
 	if (!manifestJson) return source;
+	const filename = relative(this.rootContext, this.resourcePath);
+	const analyzedHash = getAnalyzedHashes()?.get(filename);
+	if (analyzedHash !== void 0) {
+		const sourceHash = contentHash(source);
+		if (sourceHash !== analyzedHash) {
+			const refreshedHash = getAnalyzedHashes()?.get(filename);
+			if (refreshedHash === void 0 || sourceHash !== refreshedHash) throw new Error(`ANIMUS_ANALYSIS_CATCHING_UP: ${filename} changed after the current analysis; retrying on the next watch turn`);
+			manifestJson = getManifestJson() ?? manifestJson;
+		}
+	}
 	return transformWithManifest({
 		source,
-		filename: relative(this.rootContext, this.resourcePath),
+		filename,
 		manifestJson,
 		engineApi,
 		opts: this.getOptions?.() ?? {}

package/dist/plugin.d.ts

@@ -21,11 +21,32 @@ type Compilation = {
     missingDependencies: {
         add(path: string): void;
     };
+    /** Directory watch inputs (webpack 5 LazySet). External kit roots are
+     *  registered here every compilation so UNIMPORTED creations still
+     *  produce watch turns — webpack reports the DIRECTORY, and the
+     *  session's root-dirty rewalk reconstructs the delta (openspec:
+     *  external-source-watch-ingestion, design D3; probe E). */
+    contextDependencies: {
+        add(path: string): void;
+    };
     getAsset(name: string): {
         source: WebpackSource;
     } | undefined;
     updateAsset(name: string, newSource: WebpackSource): void;
 };
+/** The slice of a webpack Module the needBuild predicate inspects. */
+type CandidateModule = {
+    loaders?: Array<{
+        loader?: string;
+    }>;
+};
+type NeedBuildCallback = (err?: Error | null, result?: boolean) => void;
+/** NormalModule.getCompilationHooks(...) slice (webpack 5). */
+type NormalModuleCompilationHooks = {
+    needBuild?: {
+        tapAsync: (name: string, fn: (module: CandidateModule, context: unknown, callback: NeedBuildCallback) => void) => void;
+    };
+};
 type Compiler = {
     hooks: {
         run: {
@@ -37,6 +58,9 @@ type Compiler = {
         compilation: {
             tap: (name: string, fn: (compilation: Compilation) => void) => void;
         };
+        thisCompilation: {
+            tap: (name: string, fn: (compilation: unknown) => void) => void;
+        };
     };
     context: string;
     /** Present on watchRun compilers after the first compilation (webpack 5). */
@@ -47,6 +71,9 @@ type Compiler = {
         resolve?: {
             alias?: Record<string, string | string[] | false>;
         };
+        watchOptions?: {
+            ignored?: unknown;
+        };
     };
     webpack?: {
         Compilation: {
@@ -55,6 +82,11 @@ type Compiler = {
         sources: {
             RawSource: new (source: string) => WebpackSource;
         };
+        /** Obtained from the compiler instance at hook time — NEVER a top-level
+         *  webpack import (Next ships its own compiled webpack). */
+        NormalModule?: {
+            getCompilationHooks?: (compilation: unknown) => NormalModuleCompilationHooks;
+        };
     };
 };
 /**
@@ -69,7 +101,31 @@ export declare class AnimusWebpackPlugin {
     private session;
     private initialized;
     private aliasesExtracted;
+    /** Loader paths counting as "the animus loader" in a module's chain —
+     *  this package's own loader plus an optional harness override. */
+    private readonly animusLoaderPaths;
+    /** Epoch THIS compiler last proceeded with (set after every awaited
+     *  watchRun transaction — including joined ones). Null until the
+     *  initialization pipeline publishes. */
+    private lastBuiltEpoch;
+    /** Armed by watchRun when the transaction moved the epoch; captured and
+     *  disarmed by the next compilation's needBuild wiring (design D1). */
+    private epochMovedForNextCompilation;
     constructor(options: AnimusNextOptions);
+    /** True when the module's loader chain contains the animus loader — the
+     *  needBuild fan-out predicate (design D1: no historical records; covers
+     *  restored persistent-cache modules and raw passthroughs alike). */
+    private moduleUsesAnimusLoader;
+    /** Append the exact epoch artifact path to `watchOptions.ignored`,
+     *  preserving the user's shape (design D2: the artifact participates in
+     *  module snapshots via addDependency but never triggers live watch
+     *  turns — no echo compilations). Session identity is process-claimed,
+     *  so every compiler's plugin instance derives the SAME session-scoped
+     *  path here regardless of which instance ends up owning the pipeline.
+     *  Derived from the ONE root (session.rootDir, set at config time by
+     *  with-animus); compiler.context is the fallback for bare-apply
+     *  harnesses — identical when compiler.context === cwd. */
+    private appendEpochWatchIgnore;
     /** Extract path aliases from webpack's resolve.alias config. Runs once per
      *  plugin instance — the resolve config is immutable after apply. */
     private extractAliases;
@@ -78,6 +134,15 @@ export declare class AnimusWebpackPlugin {
      * Reset analysis state for HMR geological reset.
      */
     resetForHmr(): void;
+    /** Session identity (process-claimed) — with-animus derives the
+     *  session-scoped alias/stub paths from it (design D2). */
+    get sessionId(): string;
+    /** Set the project root at CONFIG time (with-animus) — the ONE root all
+     *  session-path derivations use. The compiler hooks re-assert it from
+     *  compiler.context (identical when compiler.context === cwd). */
+    setRootDir(rootDir: string): void;
+    /** This session's artifact directory, derived from the one root. */
+    get sessionDir(): string;
     /** Expose options for the loader */
     getOptions(): AnimusNextOptions;
     /** Expose external package directories for webpack loader allowlisting.

package/dist/plugin.d.ts.map

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

package/dist/session-paths-CZoi19NW.cjs

@@ -0,0 +1,229 @@
+require("./turbopack-loader.cjs");
+let path = require("path");
+//#region src/session-paths.ts
+/**
+* Session-scoped artifact names, path derivations, and the analysis-status
+* shape (openspec: next-turbopack-served-transform-coherence, design D1–D3)
+* — shared by the session writer (extraction-session), the webpack
+* plugin/loader, and the Turbopack loader.
+*
+* Deliberately free of singleton/session imports: the Turbopack loader
+* executes in isolated worker processes and its module graph must stay
+* worker-local (guardrail G1) — this module is pure path/shape vocabulary.
+*/
+/** Session-dir-relative name of the replacement-epoch disk witness
+*  (openspec: next-webpack-served-transform-coherence, design D2;
+*  session-scoped by next-turbopack-served-transform-coherence D2). */
+const REPLACEMENT_EPOCH_ARTIFACT = "replacements-epoch";
+/** Session-dir-relative name of the analysis-commit transaction artifact
+*  (design D1). */
+const ANALYSIS_COMMIT_ARTIFACT = "analysis-commit";
+/** Session-dir-relative name of the analysis-status artifact (design D3). */
+const ANALYSIS_STATUS_ARTIFACT = "analysis-status.json";
+/** Session-dir-relative name of the manifest payload artifact. */
+const MANIFEST_ARTIFACT = "manifest.json";
+/** Session-dir-relative name of the analysis-inputs payload artifact
+*  (Turbopack loader-worker hydration corpus). */
+const ANALYSIS_INPUTS_ARTIFACT = "analysis-inputs.json";
+/** Session-dir-relative name of the emitted stylesheet artifact. */
+const STYLES_ARTIFACT = "styles.css";
+/** Session-dir-relative name of the emitted system-props module. */
+const SYSTEM_PROPS_ARTIFACT = "system-props.js";
+/** Session-dir-relative directory holding copied asset() files. */
+const SESSION_ASSETS_DIR = "assets";
+/** Root of every session-scoped artifact tree for a project. */
+function sessionsRootDir(rootDir) {
+	return (0, path.join)(rootDir, ".animus", "sessions");
+}
+/** One session's artifact directory (design D2: session-scoped trees,
+*  no global pointer). */
+function sessionArtifactDir(rootDir, sessionId) {
+	return (0, path.join)(sessionsRootDir(rootDir), sessionId);
+}
+/** Absolute path of a session's replacement-epoch artifact — the single
+*  derivation shared by the session writer, the webpack plugin's
+*  watch-ignore entry, and both loaders' file dependencies. Takes the
+*  SESSION directory (not the project root) since the artifact was
+*  relocated into the session tree. */
+function replacementEpochPath(sessionDir) {
+	return (0, path.join)(sessionDir, REPLACEMENT_EPOCH_ARTIFACT);
+}
+/** Absolute path of a session's analysis-commit artifact. */
+function analysisCommitPath(sessionDir) {
+	return (0, path.join)(sessionDir, ANALYSIS_COMMIT_ARTIFACT);
+}
+/** Absolute path of a session's analysis-status artifact. */
+function analysisStatusPath(sessionDir) {
+	return (0, path.join)(sessionDir, ANALYSIS_STATUS_ARTIFACT);
+}
+/** Absolute path of a session's manifest artifact. */
+function manifestPath(sessionDir) {
+	return (0, path.join)(sessionDir, MANIFEST_ARTIFACT);
+}
+/** Absolute path of a session's analysis-inputs artifact. */
+function analysisInputsPath(sessionDir) {
+	return (0, path.join)(sessionDir, ANALYSIS_INPUTS_ARTIFACT);
+}
+/** Absolute path of a session's stylesheet artifact. */
+function stylesPath(sessionDir) {
+	return (0, path.join)(sessionDir, STYLES_ARTIFACT);
+}
+/** Absolute path of a session's system-props module artifact. */
+function systemPropsPath(sessionDir) {
+	return (0, path.join)(sessionDir, SYSTEM_PROPS_ARTIFACT);
+}
+/** Splice the session envelope into a JSON-object payload as a leading
+*  `__animusSession` field, byte-preserving the payload's own content
+*  (parse/re-stringify could reformat engine-emitted JSON). */
+function envelopeJsonArtifact(payload, envelopeJson) {
+	const trimmed = payload.trimStart();
+	if (!trimmed.startsWith("{")) return payload;
+	if (trimmed.slice(1).trimStart().startsWith("}")) return `{"__animusSession":${envelopeJson}}`;
+	return `{"__animusSession":${envelopeJson},${trimmed.slice(1)}`;
+}
+/** Trailing-comment side-band for the CSS artifact (a leading comment
+*  would displace the @layer declaration consumers pin at offset 0). */
+function envelopeCssArtifact(payload, envelopeJson) {
+	return `${payload}\n/* __animusSession ${envelopeJson} */\n`;
+}
+/** Matches the CSS artifact's envelope side-band. */
+const ENVELOPE_CSS_COMMENT_RE = /\/\* __animusSession (\{.*\}) \*\//;
+/** Envelope of a JSON artifact's bytes, or undefined when the artifact
+*  carries none. THROWS on unparseable bytes — callers decide whether a
+*  torn artifact fails closed or degrades. */
+function readJsonEnvelope(bytes) {
+	return JSON.parse(bytes).__animusSession;
+}
+/** Envelope of the CSS artifact's side-band comment, or undefined when the
+*  side-band is absent. THROWS on an unparseable envelope body. */
+function readCssEnvelope(bytes) {
+	const match = bytes.match(ENVELOPE_CSS_COMMENT_RE);
+	return match ? JSON.parse(match[1]) : void 0;
+}
+//#endregion
+Object.defineProperty(exports, "ANALYSIS_COMMIT_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return ANALYSIS_COMMIT_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "ANALYSIS_INPUTS_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return ANALYSIS_INPUTS_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "ANALYSIS_STATUS_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return ANALYSIS_STATUS_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "MANIFEST_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return MANIFEST_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "REPLACEMENT_EPOCH_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return REPLACEMENT_EPOCH_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "SESSION_ASSETS_DIR", {
+	enumerable: true,
+	get: function() {
+		return SESSION_ASSETS_DIR;
+	}
+});
+Object.defineProperty(exports, "STYLES_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return STYLES_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "SYSTEM_PROPS_ARTIFACT", {
+	enumerable: true,
+	get: function() {
+		return SYSTEM_PROPS_ARTIFACT;
+	}
+});
+Object.defineProperty(exports, "analysisCommitPath", {
+	enumerable: true,
+	get: function() {
+		return analysisCommitPath;
+	}
+});
+Object.defineProperty(exports, "analysisInputsPath", {
+	enumerable: true,
+	get: function() {
+		return analysisInputsPath;
+	}
+});
+Object.defineProperty(exports, "analysisStatusPath", {
+	enumerable: true,
+	get: function() {
+		return analysisStatusPath;
+	}
+});
+Object.defineProperty(exports, "envelopeCssArtifact", {
+	enumerable: true,
+	get: function() {
+		return envelopeCssArtifact;
+	}
+});
+Object.defineProperty(exports, "envelopeJsonArtifact", {
+	enumerable: true,
+	get: function() {
+		return envelopeJsonArtifact;
+	}
+});
+Object.defineProperty(exports, "manifestPath", {
+	enumerable: true,
+	get: function() {
+		return manifestPath;
+	}
+});
+Object.defineProperty(exports, "readCssEnvelope", {
+	enumerable: true,
+	get: function() {
+		return readCssEnvelope;
+	}
+});
+Object.defineProperty(exports, "readJsonEnvelope", {
+	enumerable: true,
+	get: function() {
+		return readJsonEnvelope;
+	}
+});
+Object.defineProperty(exports, "replacementEpochPath", {
+	enumerable: true,
+	get: function() {
+		return replacementEpochPath;
+	}
+});
+Object.defineProperty(exports, "sessionArtifactDir", {
+	enumerable: true,
+	get: function() {
+		return sessionArtifactDir;
+	}
+});
+Object.defineProperty(exports, "sessionsRootDir", {
+	enumerable: true,
+	get: function() {
+		return sessionsRootDir;
+	}
+});
+Object.defineProperty(exports, "stylesPath", {
+	enumerable: true,
+	get: function() {
+		return stylesPath;
+	}
+});
+Object.defineProperty(exports, "systemPropsPath", {
+	enumerable: true,
+	get: function() {
+		return systemPropsPath;
+	}
+});

package/dist/session-paths-DfYIPDcM.mjs

@@ -0,0 +1,107 @@
+import { createRequire } from "node:module";
+import { join } from "path";
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+//#region src/session-paths.ts
+/**
+* Session-scoped artifact names, path derivations, and the analysis-status
+* shape (openspec: next-turbopack-served-transform-coherence, design D1–D3)
+* — shared by the session writer (extraction-session), the webpack
+* plugin/loader, and the Turbopack loader.
+*
+* Deliberately free of singleton/session imports: the Turbopack loader
+* executes in isolated worker processes and its module graph must stay
+* worker-local (guardrail G1) — this module is pure path/shape vocabulary.
+*/
+/** Session-dir-relative name of the replacement-epoch disk witness
+*  (openspec: next-webpack-served-transform-coherence, design D2;
+*  session-scoped by next-turbopack-served-transform-coherence D2). */
+const REPLACEMENT_EPOCH_ARTIFACT = "replacements-epoch";
+/** Session-dir-relative name of the analysis-commit transaction artifact
+*  (design D1). */
+const ANALYSIS_COMMIT_ARTIFACT = "analysis-commit";
+/** Session-dir-relative name of the analysis-status artifact (design D3). */
+const ANALYSIS_STATUS_ARTIFACT = "analysis-status.json";
+/** Session-dir-relative name of the manifest payload artifact. */
+const MANIFEST_ARTIFACT = "manifest.json";
+/** Session-dir-relative name of the analysis-inputs payload artifact
+*  (Turbopack loader-worker hydration corpus). */
+const ANALYSIS_INPUTS_ARTIFACT = "analysis-inputs.json";
+/** Session-dir-relative name of the emitted stylesheet artifact. */
+const STYLES_ARTIFACT = "styles.css";
+/** Session-dir-relative name of the emitted system-props module. */
+const SYSTEM_PROPS_ARTIFACT = "system-props.js";
+/** Session-dir-relative directory holding copied asset() files. */
+const SESSION_ASSETS_DIR = "assets";
+/** Root of every session-scoped artifact tree for a project. */
+function sessionsRootDir(rootDir) {
+	return join(rootDir, ".animus", "sessions");
+}
+/** One session's artifact directory (design D2: session-scoped trees,
+*  no global pointer). */
+function sessionArtifactDir(rootDir, sessionId) {
+	return join(sessionsRootDir(rootDir), sessionId);
+}
+/** Absolute path of a session's replacement-epoch artifact — the single
+*  derivation shared by the session writer, the webpack plugin's
+*  watch-ignore entry, and both loaders' file dependencies. Takes the
+*  SESSION directory (not the project root) since the artifact was
+*  relocated into the session tree. */
+function replacementEpochPath(sessionDir) {
+	return join(sessionDir, REPLACEMENT_EPOCH_ARTIFACT);
+}
+/** Absolute path of a session's analysis-commit artifact. */
+function analysisCommitPath(sessionDir) {
+	return join(sessionDir, ANALYSIS_COMMIT_ARTIFACT);
+}
+/** Absolute path of a session's analysis-status artifact. */
+function analysisStatusPath(sessionDir) {
+	return join(sessionDir, ANALYSIS_STATUS_ARTIFACT);
+}
+/** Absolute path of a session's manifest artifact. */
+function manifestPath(sessionDir) {
+	return join(sessionDir, MANIFEST_ARTIFACT);
+}
+/** Absolute path of a session's analysis-inputs artifact. */
+function analysisInputsPath(sessionDir) {
+	return join(sessionDir, ANALYSIS_INPUTS_ARTIFACT);
+}
+/** Absolute path of a session's stylesheet artifact. */
+function stylesPath(sessionDir) {
+	return join(sessionDir, STYLES_ARTIFACT);
+}
+/** Absolute path of a session's system-props module artifact. */
+function systemPropsPath(sessionDir) {
+	return join(sessionDir, SYSTEM_PROPS_ARTIFACT);
+}
+/** Splice the session envelope into a JSON-object payload as a leading
+*  `__animusSession` field, byte-preserving the payload's own content
+*  (parse/re-stringify could reformat engine-emitted JSON). */
+function envelopeJsonArtifact(payload, envelopeJson) {
+	const trimmed = payload.trimStart();
+	if (!trimmed.startsWith("{")) return payload;
+	if (trimmed.slice(1).trimStart().startsWith("}")) return `{"__animusSession":${envelopeJson}}`;
+	return `{"__animusSession":${envelopeJson},${trimmed.slice(1)}`;
+}
+/** Trailing-comment side-band for the CSS artifact (a leading comment
+*  would displace the @layer declaration consumers pin at offset 0). */
+function envelopeCssArtifact(payload, envelopeJson) {
+	return `${payload}\n/* __animusSession ${envelopeJson} */\n`;
+}
+/** Matches the CSS artifact's envelope side-band. */
+const ENVELOPE_CSS_COMMENT_RE = /\/\* __animusSession (\{.*\}) \*\//;
+/** Envelope of a JSON artifact's bytes, or undefined when the artifact
+*  carries none. THROWS on unparseable bytes — callers decide whether a
+*  torn artifact fails closed or degrades. */
+function readJsonEnvelope(bytes) {
+	return JSON.parse(bytes).__animusSession;
+}
+/** Envelope of the CSS artifact's side-band comment, or undefined when the
+*  side-band is absent. THROWS on an unparseable envelope body. */
+function readCssEnvelope(bytes) {
+	const match = bytes.match(ENVELOPE_CSS_COMMENT_RE);
+	return match ? JSON.parse(match[1]) : void 0;
+}
+//#endregion
+export { __require as S, replacementEpochPath as _, REPLACEMENT_EPOCH_ARTIFACT as a, stylesPath as b, SYSTEM_PROPS_ARTIFACT as c, analysisStatusPath as d, envelopeCssArtifact as f, readJsonEnvelope as g, readCssEnvelope as h, MANIFEST_ARTIFACT as i, analysisCommitPath as l, manifestPath as m, ANALYSIS_INPUTS_ARTIFACT as n, SESSION_ASSETS_DIR as o, envelopeJsonArtifact as p, ANALYSIS_STATUS_ARTIFACT as r, STYLES_ARTIFACT as s, ANALYSIS_COMMIT_ARTIFACT as t, analysisInputsPath as u, sessionArtifactDir as v, systemPropsPath as x, sessionsRootDir as y };