@animus-ui/cli 0.1.25 → 0.1.27

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,iBAAiB,EAKlB,MAAM,4BAA4B,CAAC;AAcpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAC1C,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,eAAO,MAAM,GAAG,aAAc,OAAO,EAAE,KAAG,IACL,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;qCACqC;AACrC,wBAAsB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAsC7E;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,cAAc,CA+DhB;AAqBD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,iBAAiB,GAAG,IAAI,EAC1C,WAAW,EAAE,MAAM,IAAI,GACtB,MAAM,IAAI,CAOZ;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAgBN;AAED,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAgBD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,UAAe,GACrB,OAAO,CAAC,WAAW,CAAC,CAwDtB"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,iBAAiB,EAKlB,MAAM,4BAA4B,CAAC;AAcpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIlD,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAC/C,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAC1C,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,eAAO,MAAM,GAAG,aAAc,OAAO,EAAE,KAAG,IACL,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;qCACqC;AACrC,wBAAsB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAgC7E;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,cAAc,CA+DhB;AAqBD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,iBAAiB,GAAG,IAAI,EAC1C,WAAW,EAAE,MAAM,IAAI,GACtB,MAAM,IAAI,CAOZ;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAUN;AAED,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAgBD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,UAAe,GACrB,OAAO,CAAC,WAAW,CAAC,CAwDtB"}

package/dist/config.d.ts

@@ -50,6 +50,7 @@ export declare function projectResolvedConfig(config: ResolvedCliConfig): {
     layers: string[] | null;
     extensions: string[] | null;
     staticCss: StaticCssConfig | null;
+    runtimeImport: string | null;
     exclude: readonly string[];
     provenance: Record<string, OptionProvenance>;
 };

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EAEf,gBAAgB,EAEhB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,gBAAgB,YAC3B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,CACV,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AA+OD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAoI5B;AAED;kEACkE;AAClE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB;IAE3D,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,UAAU;EAEb"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EAEf,gBAAgB,EAEhB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,gBAAgB,YAC3B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,CACV,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAgPD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAqI5B;AAED;kEACkE;AAClE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB;IAE3D,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,SAAS;IACT,aAAa;IACb,OAAO;IACP,UAAU;EAEb"}

package/dist/index.cjs

@@ -263,29 +263,27 @@ async function runPreflight(config) {
 }
 function createCliSession(config) {
 	const { root, outDir, options } = config;
-	const session = new _animus_ui_extract_session.ExtractionSession(options);
+	const session = new _animus_ui_extract_session.ExtractionSession(options, { noBundler: true });
 	const relOut = (0, path.relative)(root, outDir);
 	if (relOut === "") throw new UsageFailure(`The artifact directory is the root itself (${outDir}) — the published ${STYLES_FILE}/${SYSTEM_PROPS_FILE}/${MANIFEST_FILE} would be re-ingested as source on the next run. Pass --out-dir with a subdirectory (the default is ${_animus_ui_extract_session.ANIMUS_ARTIFACT_DIR}) or point --root at the source tree.`);
-	if (!relOut.startsWith("..") && !config.excludePatterns.some((p) => relOut.includes(p) || p === relOut)) {
-		const anchored = `${relOut.split("\\").join("/")}/**`;
-		session.structuralExclude = [anchored];
-		err(`outDir ${relOut} is inside the root — auto-excluded from discovery (pattern '${anchored}')`);
+	const outputDir = (0, _animus_ui_extract_pipeline.outputExclusion)(root, outDir);
+	if (outputDir !== null) {
+		session.structuralExclude = [outputDir];
+		err(`outDir ${relOut} is inside the root — auto-excluded from discovery (directory '${outputDir}')`);
 	}
 	session.driverLabel = "animus";
 	session.rootDir = root;
 	session.staleAssetPruning = "every-cycle";
-	const aliasPairs = (0, _animus_ui_extract_pipeline.readTsconfigAliasPairs)(root);
-	const builtAliases = (0, _animus_ui_extract_pipeline.buildPathAliasesJson)(aliasPairs, root);
-	if (builtAliases) session.pathAliasesJson = builtAliases.json;
+	session.aliasesFromTsconfig = true;
 	return session;
 }
 function publishSharedPayloads(config, session) {
 	const { root, outDir, options } = config;
-	const fileCount = (0, _animus_ui_extract_session.getAnalyzedHashes)()?.size ?? 0;
+	const fileCount = (0, _animus_ui_extract_session.getAnalyzedHashes)(session.key)?.size ?? 0;
 	if (fileCount === 0) throw new ExtractionFailure(`Discovery found zero source files under ${root} (exclusions: ${config.excludePatterns.join(", ")})`);
-	const manifestJson = (0, _animus_ui_extract_session.getManifestJson)() ?? "";
-	const stylesCss = (0, _animus_ui_extract_session.getSharedCss)();
-	const systemPropsJs = (0, _animus_ui_extract_session.getSharedSystemProps)();
+	const manifestJson = (0, _animus_ui_extract_session.getManifestJson)(session.key) ?? "";
+	const stylesCss = (0, _animus_ui_extract_session.getSharedCss)(session.key);
+	const systemPropsJs = (0, _animus_ui_extract_session.getSharedSystemProps)(session.key);
 	let componentCount = session.lastComponentCount ?? -1;
 	if (componentCount < 0) try {
 		const manifest = JSON.parse(manifestJson);
@@ -345,13 +343,11 @@ function createRunClaimRelease(getSession, releaseLock) {
 }
 function reportDiscoveryOutcomes(config, session) {
 	for (const { specifier, outcome, fileCount: files } of session.lastExternalOutcomes) err(`include '${specifier}': ${outcome}${outcome === "resolved" ? ` (${files} files)` : ""}`);
-	const stats = session.getExcludeStats();
-	for (const pattern of config.options.exclude ?? []) if ((stats.get(pattern) ?? 0) === 0) err(`exclude pattern '${pattern}' matched nothing`);
 }
 /** Writes the analysed kit's descriptor at the root, from the manifest the
 *  build published. */
-function writeKitDescriptor(root) {
-	const manifest = JSON.parse((0, _animus_ui_extract_session.getManifestJson)() ?? "");
+function writeKitDescriptor(root, key) {
+	const manifest = JSON.parse((0, _animus_ui_extract_session.getManifestJson)(key) ?? "");
 	const path$2 = (0, path.join)(root, _animus_ui_extract_pipeline.KIT_DESCRIPTOR_FILE);
 	(0, fs.writeFileSync)(path$2, `${JSON.stringify((0, _animus_ui_extract_pipeline.buildKitDescriptor)(manifest), null, 2)}\n`);
 	return path$2;
@@ -376,9 +372,9 @@ async function runBuild(config, flags = {}) {
 		}
 		const { componentCount, fileCount } = publishSharedPayloads(config, session);
 		if (flags.kit) {
-			const failures = (0, _animus_ui_extract_pipeline.kitPublicationFailures)(config.root, (0, _animus_ui_extract_session.engineApi)(), config.outDir);
+			const failures = (0, _animus_ui_extract_pipeline.kitPublicationFailures)(config.root, (0, _animus_ui_extract_session.engineApi)(session.key), config.outDir);
 			if (failures.length > 0) throw new ExtractionFailure(`the kit is not ready to publish: an installed consumer would fail on missing source, or receive this build's artifacts:\n${failures.map((line) => `  - ${line}`).join("\n")}`);
-			err(`kit descriptor → ${writeKitDescriptor(config.root)}`);
+			err(`kit descriptor → ${writeKitDescriptor(config.root, session.key)}`);
 		}
 		reportDiscoveryOutcomes(config, session);
 		err(`build complete: ${componentCount} components from ${fileCount} files → ${outDir}`);
@@ -454,7 +450,7 @@ function configDiagnostics(value) {
 	return Object.fromEntries(Object.entries(value).filter((entry) => isConfigString(entry[1]) && _animus_ui_extract_pipeline.DIAGNOSTIC_LEVELS.has(entry[1])));
 }
 function parseLoadedCliConfig(raw) {
-	(0, _animus_ui_extract_pipeline.assertNoRetiredEngineSelection)(isConfigString(raw.engine) ? raw.engine : void 0);
+	(0, _animus_ui_extract_pipeline.assertSupportedEngine)(isConfigString(raw.engine) ? raw.engine : void 0);
 	(0, _animus_ui_extract_pipeline.assertKnownOptionKeys)(raw);
 	const cliValue = raw.cli;
 	const cli = isConfigRecord(cliValue) ? cliValue : {};
@@ -474,6 +470,7 @@ function parseLoadedCliConfig(raw) {
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
+			runtimeImport: isConfigString(raw.runtimeImport) ? raw.runtimeImport : void 0,
 			mode: raw.mode === "development" || raw.mode === "production" ? raw.mode : void 0
 		},
 		cli: { outDir: cli.outDir }
@@ -566,6 +563,7 @@ async function resolveCliConfig(flags, cwd) {
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
 		layers: pick("layers", void 0),
+		runtimeImport: pick("runtimeImport", void 0),
 		mode: resolvedMode.mode
 	};
 	const excludePatterns = (0, _animus_ui_extract_pipeline.createExcludeMatcher)(options.exclude).patterns;
@@ -605,6 +603,7 @@ function projectResolvedConfig(config) {
 		layers: config.options.layers ?? null,
 		extensions: config.options.extensions ?? null,
 		staticCss: config.options.staticCss ?? null,
+		runtimeImport: config.options.runtimeImport ?? null,
 		exclude: config.excludePatterns,
 		provenance: config.provenance
 	};
@@ -643,11 +642,11 @@ function formatCyclePublishFailure(outDir, error) {
 	if (error instanceof PublishSwapIncompleteError) return `watch cycle publication failed mid-swap — ${outDir} is NOT last-good: ${String(error)}`;
 	return `watch cycle publication rejected — keeping last-good artifacts in ${outDir}: ${String(error)}`;
 }
-function currentPayloadKey() {
+function currentPayloadKey(key) {
 	return [
-		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getManifestJson)() ?? ""),
-		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getSharedCss)()),
-		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getSharedSystemProps)())
+		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getManifestJson)(key) ?? ""),
+		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getSharedCss)(key)),
+		(0, _animus_ui_extract_pipeline.contentHash)((0, _animus_ui_extract_session.getSharedSystemProps)(key))
 	].join(":");
 }
 /** Resolves with the process exit code at shutdown. Startup failures throw,
@@ -686,7 +685,7 @@ async function runWatch(config, flags) {
 	const { session, claim } = startup;
 	let lastPublication = startup.publication;
 	let publications = 1;
-	let lastPublishedKey = currentPayloadKey();
+	let lastPublishedKey = currentPayloadKey(session.key);
 	return new Promise((resolvePromise) => {
 		const keepalive = setInterval(() => {}, 2 ** 30);
 		let shuttingDown = null;
@@ -752,7 +751,7 @@ async function runWatch(config, flags) {
 				err(`watch cycle failed — keeping last-good artifacts in ${outDir}: ${String(cause)}`);
 				return;
 			}
-			const key = currentPayloadKey();
+			const key = currentPayloadKey(session.key);
 			if (key === lastPublishedKey) return;
 			let outcome;
 			try {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { AnimusConfigError, DIAGNOSTIC_LEVELS, KIT_DESCRIPTOR_FILE, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildKitDescriptor, buildPathAliasesJson, contentHash, createExcludeMatcher, kitPublicationFailures, readTsconfigAliasPairs, resolveMode, runStructuralSelfCheck } from "@animus-ui/extract/pipeline";
+import { AnimusConfigError, DIAGNOSTIC_LEVELS, KIT_DESCRIPTOR_FILE, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertSupportedEngine, buildKitDescriptor, contentHash, createExcludeMatcher, kitPublicationFailures, outputExclusion, resolveMode, runStructuralSelfCheck } from "@animus-ui/extract/pipeline";
 import { parseArgs } from "node:util";
 import { ANIMUS_ARTIFACT_DIR, CLI_COMMIT_ARTIFACT, CLI_LOCK_ARTIFACT, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, checkLockLiveness, collectSessionAssets, decodeCommitRecord, engineApi, getAnalyzedHashes, getManifestJson, getSharedCss, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, readCliLockRecord, startTurbopackWatcher, verifyCommitRecord } from "@animus-ui/extract/session";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "fs";
@@ -262,29 +262,27 @@ async function runPreflight(config) {
 }
 function createCliSession(config) {
 	const { root, outDir, options } = config;
-	const session = new ExtractionSession(options);
+	const session = new ExtractionSession(options, { noBundler: true });
 	const relOut = relative(root, outDir);
 	if (relOut === "") throw new UsageFailure(`The artifact directory is the root itself (${outDir}) — the published ${STYLES_FILE}/${SYSTEM_PROPS_FILE}/${MANIFEST_FILE} would be re-ingested as source on the next run. Pass --out-dir with a subdirectory (the default is ${ANIMUS_ARTIFACT_DIR}) or point --root at the source tree.`);
-	if (!relOut.startsWith("..") && !config.excludePatterns.some((p) => relOut.includes(p) || p === relOut)) {
-		const anchored = `${relOut.split("\\").join("/")}/**`;
-		session.structuralExclude = [anchored];
-		err(`outDir ${relOut} is inside the root — auto-excluded from discovery (pattern '${anchored}')`);
+	const outputDir = outputExclusion(root, outDir);
+	if (outputDir !== null) {
+		session.structuralExclude = [outputDir];
+		err(`outDir ${relOut} is inside the root — auto-excluded from discovery (directory '${outputDir}')`);
 	}
 	session.driverLabel = "animus";
 	session.rootDir = root;
 	session.staleAssetPruning = "every-cycle";
-	const aliasPairs = readTsconfigAliasPairs(root);
-	const builtAliases = buildPathAliasesJson(aliasPairs, root);
-	if (builtAliases) session.pathAliasesJson = builtAliases.json;
+	session.aliasesFromTsconfig = true;
 	return session;
 }
 function publishSharedPayloads(config, session) {
 	const { root, outDir, options } = config;
-	const fileCount = getAnalyzedHashes()?.size ?? 0;
+	const fileCount = getAnalyzedHashes(session.key)?.size ?? 0;
 	if (fileCount === 0) throw new ExtractionFailure(`Discovery found zero source files under ${root} (exclusions: ${config.excludePatterns.join(", ")})`);
-	const manifestJson = getManifestJson() ?? "";
-	const stylesCss = getSharedCss();
-	const systemPropsJs = getSharedSystemProps();
+	const manifestJson = getManifestJson(session.key) ?? "";
+	const stylesCss = getSharedCss(session.key);
+	const systemPropsJs = getSharedSystemProps(session.key);
 	let componentCount = session.lastComponentCount ?? -1;
 	if (componentCount < 0) try {
 		const manifest = JSON.parse(manifestJson);
@@ -344,13 +342,11 @@ function createRunClaimRelease(getSession, releaseLock) {
 }
 function reportDiscoveryOutcomes(config, session) {
 	for (const { specifier, outcome, fileCount: files } of session.lastExternalOutcomes) err(`include '${specifier}': ${outcome}${outcome === "resolved" ? ` (${files} files)` : ""}`);
-	const stats = session.getExcludeStats();
-	for (const pattern of config.options.exclude ?? []) if ((stats.get(pattern) ?? 0) === 0) err(`exclude pattern '${pattern}' matched nothing`);
 }
 /** Writes the analysed kit's descriptor at the root, from the manifest the
 *  build published. */
-function writeKitDescriptor(root) {
-	const manifest = JSON.parse(getManifestJson() ?? "");
+function writeKitDescriptor(root, key) {
+	const manifest = JSON.parse(getManifestJson(key) ?? "");
 	const path = join(root, KIT_DESCRIPTOR_FILE);
 	writeFileSync(path, `${JSON.stringify(buildKitDescriptor(manifest), null, 2)}\n`);
 	return path;
@@ -375,9 +371,9 @@ async function runBuild(config, flags = {}) {
 		}
 		const { componentCount, fileCount } = publishSharedPayloads(config, session);
 		if (flags.kit) {
-			const failures = kitPublicationFailures(config.root, engineApi(), config.outDir);
+			const failures = kitPublicationFailures(config.root, engineApi(session.key), config.outDir);
 			if (failures.length > 0) throw new ExtractionFailure(`the kit is not ready to publish: an installed consumer would fail on missing source, or receive this build's artifacts:\n${failures.map((line) => `  - ${line}`).join("\n")}`);
-			err(`kit descriptor → ${writeKitDescriptor(config.root)}`);
+			err(`kit descriptor → ${writeKitDescriptor(config.root, session.key)}`);
 		}
 		reportDiscoveryOutcomes(config, session);
 		err(`build complete: ${componentCount} components from ${fileCount} files → ${outDir}`);
@@ -453,7 +449,7 @@ function configDiagnostics(value) {
 	return Object.fromEntries(Object.entries(value).filter((entry) => isConfigString(entry[1]) && DIAGNOSTIC_LEVELS.has(entry[1])));
 }
 function parseLoadedCliConfig(raw) {
-	assertNoRetiredEngineSelection(isConfigString(raw.engine) ? raw.engine : void 0);
+	assertSupportedEngine(isConfigString(raw.engine) ? raw.engine : void 0);
 	assertKnownOptionKeys(raw);
 	const cliValue = raw.cli;
 	const cli = isConfigRecord(cliValue) ? cliValue : {};
@@ -473,6 +469,7 @@ function parseLoadedCliConfig(raw) {
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
+			runtimeImport: isConfigString(raw.runtimeImport) ? raw.runtimeImport : void 0,
 			mode: raw.mode === "development" || raw.mode === "production" ? raw.mode : void 0
 		},
 		cli: { outDir: cli.outDir }
@@ -565,6 +562,7 @@ async function resolveCliConfig(flags, cwd) {
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
 		layers: pick("layers", void 0),
+		runtimeImport: pick("runtimeImport", void 0),
 		mode: resolvedMode.mode
 	};
 	const excludePatterns = createExcludeMatcher(options.exclude).patterns;
@@ -604,6 +602,7 @@ function projectResolvedConfig(config) {
 		layers: config.options.layers ?? null,
 		extensions: config.options.extensions ?? null,
 		staticCss: config.options.staticCss ?? null,
+		runtimeImport: config.options.runtimeImport ?? null,
 		exclude: config.excludePatterns,
 		provenance: config.provenance
 	};
@@ -642,11 +641,11 @@ function formatCyclePublishFailure(outDir, error) {
 	if (error instanceof PublishSwapIncompleteError) return `watch cycle publication failed mid-swap — ${outDir} is NOT last-good: ${String(error)}`;
 	return `watch cycle publication rejected — keeping last-good artifacts in ${outDir}: ${String(error)}`;
 }
-function currentPayloadKey() {
+function currentPayloadKey(key) {
 	return [
-		contentHash(getManifestJson() ?? ""),
-		contentHash(getSharedCss()),
-		contentHash(getSharedSystemProps())
+		contentHash(getManifestJson(key) ?? ""),
+		contentHash(getSharedCss(key)),
+		contentHash(getSharedSystemProps(key))
 	].join(":");
 }
 /** Resolves with the process exit code at shutdown. Startup failures throw,
@@ -685,7 +684,7 @@ async function runWatch(config, flags) {
 	const { session, claim } = startup;
 	let lastPublication = startup.publication;
 	let publications = 1;
-	let lastPublishedKey = currentPayloadKey();
+	let lastPublishedKey = currentPayloadKey(session.key);
 	return new Promise((resolvePromise) => {
 		const keepalive = setInterval(() => {}, 2 ** 30);
 		let shuttingDown = null;
@@ -751,7 +750,7 @@ async function runWatch(config, flags) {
 				err(`watch cycle failed — keeping last-good artifacts in ${outDir}: ${String(cause)}`);
 				return;
 			}
-			const key = currentPayloadKey();
+			const key = currentPayloadKey(session.key);
 			if (key === lastPublishedKey) return;
 			let outcome;
 			try {

package/dist/watch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AASlD,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAS7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,CAAC;IAChC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,GAAG,YAAY,EAAE,CA0BjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAgBD;iFACiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CA0MjB"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAUlD,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAS7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,CAAC;IAChC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD,GAAG,YAAY,EAAE,CA0BjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAgBD;iFACiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CA0MjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/cli",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Standalone Animus extraction CLI — one-shot builds and artifact emission for any build system",
   "keywords": [
     "animus",
@@ -41,7 +41,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.25"
+    "@animus-ui/extract": "0.1.27"
   },
   "engines": {
     "node": ">=22.12.0"