@animus-ui/cli 0.1.22 → 0.1.24

package/dist/build.d.ts

@@ -23,5 +23,9 @@ export interface PublishOutcome {
 export declare function publishSharedPayloads(config: ResolvedCliConfig, session: ExtractionSession): PublishOutcome;
 export declare function createRunClaimRelease(getSession: () => ExtractionSession | null, releaseLock: () => void): () => void;
 export declare function reportDiscoveryOutcomes(config: ResolvedCliConfig, session: ExtractionSession): void;
-export declare function runBuild(config: ResolvedCliConfig): Promise<BuildResult>;
+export interface BuildFlags {
+    /** Also write the kit descriptor at the root. */
+    kit?: boolean;
+}
+export declare function runBuild(config: ResolvedCliConfig, flags?: BuildFlags): Promise<BuildResult>;
 //# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,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,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,WAAW,CAAC,CAyCtB"}
+{"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"}

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import type { AnimusCoreOptions, AnimusMode, OptionProvenance, StaticCssConfig } from '@animus-ui/extract/pipeline';
+import type { AnimusCoreOptions, AnimusMode, DiagnosticLevel, OptionProvenance, StaticCssConfig } from '@animus-ui/extract/pipeline';
 export declare const CONFIG_FILENAMES: readonly ['animus.config.json', 'animus.config.mjs', 'animus.config.js', 'animus.config.ts'];
 export interface CliNamespaceOptions {
     /** Artifact output directory, relative to the root. @default '.animus' */
@@ -41,6 +41,7 @@ export declare function projectResolvedConfig(config: ResolvedCliConfig): {
     mode: AnimusMode;
     system: string;
     strict: boolean;
+    diagnostics: Readonly<Record<string, DiagnosticLevel>> | null;
     verbose: "trace" | boolean;
     targets: string | string[] | null;
     minify: boolean | null;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,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;AAmOD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAmI5B;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,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;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"}

package/dist/index.cjs

@@ -348,7 +348,15 @@ function reportDiscoveryOutcomes(config, session) {
 	const stats = session.getExcludeStats();
 	for (const pattern of config.options.exclude ?? []) if ((stats.get(pattern) ?? 0) === 0) err(`exclude pattern '${pattern}' matched nothing`);
 }
-async function runBuild(config) {
+/** 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)() ?? "");
+	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;
+}
+async function runBuild(config, flags = {}) {
 	const { outDir } = config;
 	await runPreflight(config);
 	const release = acquireLock(outDir);
@@ -367,6 +375,11 @@ async function runBuild(config) {
 			throw new ExtractionFailure(String(error));
 		}
 		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);
+			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)}`);
+		}
 		reportDiscoveryOutcomes(config, session);
 		err(`build complete: ${componentCount} components from ${fileCount} files → ${outDir}`);
 		return {
@@ -435,6 +448,11 @@ function configStaticCss(value) {
 	if (isStaticCssConfig(value)) return value;
 	throw new _animus_ui_extract_pipeline.AnimusConfigError(`Invalid value for "staticCss" — expected a static CSS declaration object, got ${JSON.stringify(value)}.`);
 }
+/** The shared validator has already rejected a non-level value. */
+function configDiagnostics(value) {
+	if (!isConfigRecord(value)) return void 0;
+	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.assertKnownOptionKeys)(raw);
@@ -448,6 +466,7 @@ function parseLoadedCliConfig(raw) {
 			exclude: isConfigStringArray(raw.exclude) ? raw.exclude : void 0,
 			extensions: isConfigStringArray(raw.extensions) ? raw.extensions : void 0,
 			strict: isConfigBoolean(raw.strict) ? raw.strict : void 0,
+			diagnostics: configDiagnostics(raw.diagnostics),
 			verbose: isConfigBoolean(raw.verbose) || raw.verbose === "trace" ? raw.verbose : void 0,
 			prefix: isConfigString(raw.prefix) ? raw.prefix : void 0,
 			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
@@ -539,6 +558,7 @@ async function resolveCliConfig(flags, cwd) {
 		exclude: excludeIsExplicit ? exclude : void 0,
 		extensions: pick("extensions", void 0),
 		strict: pick("strict", flags.strict),
+		diagnostics: pick("diagnostics", void 0),
 		verbose: pick("verbose", flags.verbose),
 		prefix: pick("prefix", void 0),
 		prefixContextualVars: pick("prefixContextualVars", void 0),
@@ -576,6 +596,7 @@ function projectResolvedConfig(config) {
 		mode: config.mode,
 		system: config.options.system,
 		strict: config.options.strict ?? false,
+		diagnostics: config.options.diagnostics ?? null,
 		verbose: config.options.verbose ?? false,
 		targets: config.options.targets ?? null,
 		minify: config.options.minify ?? null,
@@ -641,6 +662,7 @@ async function runWatch(config, flags) {
 	let startup;
 	try {
 		const created = createCliSession(config);
+		created.development = true;
 		constructed = created;
 		const claim = (0, _animus_ui_extract_session.startTurbopackWatcher)(created, root, { holdEvents: true });
 		if (claim.kind === "started") watcher = claim.handle;
@@ -790,6 +812,8 @@ Options:
   --targets <query>   Browserslist query for CSS lowering
   --strict            Fail on inputs that could not be read or resolved,
                       and on classified unsupported Animus declarations
+  --kit               build only: also write the kit descriptor, animus.json,
+                      at the root, for the kit to export as ./animus.json
   --fail-on-degraded  watch only: exit 3 instead of running with unwatched
                       roots (degradation is otherwise reported and tolerated)
   --verbose           Verbose logging (stderr): phase checkpoints,
@@ -839,6 +863,7 @@ async function main(argv = process.argv.slice(2)) {
 				strict: { type: "boolean" },
 				verbose: { type: "boolean" },
 				trace: { type: "boolean" },
+				kit: { type: "boolean" },
 				"fail-on-degraded": { type: "boolean" },
 				"print-config": { type: "boolean" },
 				help: { type: "boolean" }
@@ -885,7 +910,7 @@ async function main(argv = process.argv.slice(2)) {
 			return;
 		}
 		if (command === "build") {
-			await runBuild(config);
+			await runBuild(config, { kit: values.kit === true });
 			process.exitCode = 0;
 			return;
 		}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAiBlD,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC;qEACqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AA0D9B;sDACsD;AACtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAQD,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CA2Ff"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAiBlD,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC;qEACqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AA4D9B;sDACsD;AACtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAQD,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CA4Ff"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { AnimusConfigError, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, contentHash, createExcludeMatcher, readTsconfigAliasPairs, resolveMode, runStructuralSelfCheck } from "@animus-ui/extract/pipeline";
+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 { 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, getAnalyzedHashes, getManifestJson, getSharedCss, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, readCliLockRecord, startTurbopackWatcher, verifyCommitRecord } from "@animus-ui/extract/session";
+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";
 import { dirname, isAbsolute, join, relative, resolve } from "path";
 import { pathToFileURL } from "url";
@@ -347,7 +347,15 @@ function reportDiscoveryOutcomes(config, session) {
 	const stats = session.getExcludeStats();
 	for (const pattern of config.options.exclude ?? []) if ((stats.get(pattern) ?? 0) === 0) err(`exclude pattern '${pattern}' matched nothing`);
 }
-async function runBuild(config) {
+/** Writes the analysed kit's descriptor at the root, from the manifest the
+*  build published. */
+function writeKitDescriptor(root) {
+	const manifest = JSON.parse(getManifestJson() ?? "");
+	const path = join(root, KIT_DESCRIPTOR_FILE);
+	writeFileSync(path, `${JSON.stringify(buildKitDescriptor(manifest), null, 2)}\n`);
+	return path;
+}
+async function runBuild(config, flags = {}) {
 	const { outDir } = config;
 	await runPreflight(config);
 	const release = acquireLock(outDir);
@@ -366,6 +374,11 @@ async function runBuild(config) {
 			throw new ExtractionFailure(String(error));
 		}
 		const { componentCount, fileCount } = publishSharedPayloads(config, session);
+		if (flags.kit) {
+			const failures = kitPublicationFailures(config.root, engineApi(), 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)}`);
+		}
 		reportDiscoveryOutcomes(config, session);
 		err(`build complete: ${componentCount} components from ${fileCount} files → ${outDir}`);
 		return {
@@ -434,6 +447,11 @@ function configStaticCss(value) {
 	if (isStaticCssConfig(value)) return value;
 	throw new AnimusConfigError(`Invalid value for "staticCss" — expected a static CSS declaration object, got ${JSON.stringify(value)}.`);
 }
+/** The shared validator has already rejected a non-level value. */
+function configDiagnostics(value) {
+	if (!isConfigRecord(value)) return void 0;
+	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);
 	assertKnownOptionKeys(raw);
@@ -447,6 +465,7 @@ function parseLoadedCliConfig(raw) {
 			exclude: isConfigStringArray(raw.exclude) ? raw.exclude : void 0,
 			extensions: isConfigStringArray(raw.extensions) ? raw.extensions : void 0,
 			strict: isConfigBoolean(raw.strict) ? raw.strict : void 0,
+			diagnostics: configDiagnostics(raw.diagnostics),
 			verbose: isConfigBoolean(raw.verbose) || raw.verbose === "trace" ? raw.verbose : void 0,
 			prefix: isConfigString(raw.prefix) ? raw.prefix : void 0,
 			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
@@ -538,6 +557,7 @@ async function resolveCliConfig(flags, cwd) {
 		exclude: excludeIsExplicit ? exclude : void 0,
 		extensions: pick("extensions", void 0),
 		strict: pick("strict", flags.strict),
+		diagnostics: pick("diagnostics", void 0),
 		verbose: pick("verbose", flags.verbose),
 		prefix: pick("prefix", void 0),
 		prefixContextualVars: pick("prefixContextualVars", void 0),
@@ -575,6 +595,7 @@ function projectResolvedConfig(config) {
 		mode: config.mode,
 		system: config.options.system,
 		strict: config.options.strict ?? false,
+		diagnostics: config.options.diagnostics ?? null,
 		verbose: config.options.verbose ?? false,
 		targets: config.options.targets ?? null,
 		minify: config.options.minify ?? null,
@@ -640,6 +661,7 @@ async function runWatch(config, flags) {
 	let startup;
 	try {
 		const created = createCliSession(config);
+		created.development = true;
 		constructed = created;
 		const claim = startTurbopackWatcher(created, root, { holdEvents: true });
 		if (claim.kind === "started") watcher = claim.handle;
@@ -789,6 +811,8 @@ Options:
   --targets <query>   Browserslist query for CSS lowering
   --strict            Fail on inputs that could not be read or resolved,
                       and on classified unsupported Animus declarations
+  --kit               build only: also write the kit descriptor, animus.json,
+                      at the root, for the kit to export as ./animus.json
   --fail-on-degraded  watch only: exit 3 instead of running with unwatched
                       roots (degradation is otherwise reported and tolerated)
   --verbose           Verbose logging (stderr): phase checkpoints,
@@ -838,6 +862,7 @@ async function main(argv = process.argv.slice(2)) {
 				strict: { type: "boolean" },
 				verbose: { type: "boolean" },
 				trace: { type: "boolean" },
+				kit: { type: "boolean" },
 				"fail-on-degraded": { type: "boolean" },
 				"print-config": { type: "boolean" },
 				help: { type: "boolean" }
@@ -884,7 +909,7 @@ async function main(argv = process.argv.slice(2)) {
 			return;
 		}
 		if (command === "build") {
-			await runBuild(config);
+			await runBuild(config, { kit: values.kit === true });
 			process.exitCode = 0;
 			return;
 		}

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,CAwMjB"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/cli",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "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.22"
+    "@animus-ui/extract": "0.1.24"
   },
   "engines": {
     "node": ">=22.12.0"