@animus-ui/cli 0.1.42 → 0.1.44

package/README.md

@@ -31,8 +31,14 @@ on unsupported platforms.
 animus build --root . --system ./src/ds.ts --strict
 animus watch --root . --system ./src/ds.ts
 animus print-config --root . --system ./src/ds.ts
+animus prop-order --root . --system ./src/ds.ts
 ```
 
+`animus prop-order` writes only `<root>/.animus/prop-order.json`. The
+[`animus/prop-order` lint rule](../extract/README.md#prop-order-lint-rule)
+reads it, and the command needs no dev server; `animus build` writes the
+same file when the config sets `propOrderFile: true`.
+
 Configuration lives in `animus.config.{json,mjs,js,ts}` (probed in that
 order; `.ts` needs Node >= 23.6 native type stripping — older runtimes get
 a guided error naming the `.mjs`/`.json` remedy). Flags override file

package/dist/build.d.ts

@@ -26,6 +26,10 @@ export declare function reportDiscoveryOutcomes(config: ResolvedCliConfig, sessi
 export interface BuildFlags {
     /** Also write the kit descriptor at the root. */
     kit?: boolean;
+    /** Write only the prop-order file the `animus/prop-order` lint rule
+     *  reads: no artifact directory is claimed or published, so a running
+     *  build's output stays as it is. */
+    propOrderOnly?: 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":"AAQA,OAAO,EAIL,iBAAiB,EAMlB,MAAM,4BAA4B,CAAC;AAcpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKlD,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,CAkC7E;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,CAsEhB;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"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,iBAAiB,EAOlB,MAAM,4BAA4B,CAAC;AAcpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKlD,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,CAkC7E;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,CAsEhB;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;IACd;;yCAEqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAgBD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,GAAE,UAAe,GACrB,OAAO,CAAC,WAAW,CAAC,CA6EtB"}

package/dist/config.d.ts

@@ -45,6 +45,10 @@ export declare function projectResolvedConfig(config: ResolvedCliConfig): {
     verbose: "trace" | boolean;
     targets: string | string[] | null;
     keepDirSelector: boolean;
+    shortClassNames: {
+        prefix: string;
+    } | null;
+    propOrderFile: boolean;
     minify: boolean | null;
     prefix: string | null;
     prefixContextualVars: boolean;

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;AA8PD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAyI5B;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,eAAe;IACf,MAAM;IACN,MAAM;IACN,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,SAAS;IACT,aAAa;IACb,oBAAoB;IACpB,YAAY;IACZ,WAAW;IACX,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;AAuQD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CA2I5B;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,eAAe;IACf,eAAe;;;IACf,aAAa;IACb,MAAM;IACN,MAAM;IACN,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,SAAS;IACT,aAAa;IACb,oBAAoB;IACpB,YAAY;IACZ,WAAW;IACX,OAAO;IACP,UAAU;EAEb"}

package/dist/index.cjs

@@ -367,14 +367,21 @@ function reportDiscoveryOutcomes(config, session) {
 *  build published. */
 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;
+	const path$3 = (0, path.join)(root, _animus_ui_extract_pipeline.KIT_DESCRIPTOR_FILE);
+	(0, fs.writeFileSync)(path$3, `${JSON.stringify((0, _animus_ui_extract_pipeline.buildKitDescriptor)(manifest), null, 2)}\n`);
+	return path$3;
 }
 async function runBuild(config, flags = {}) {
 	const { outDir } = config;
 	await runPreflight(config);
-	const release = acquireLock(outDir);
+	const release = flags.propOrderOnly ? () => {} : acquireLock(outDir);
+	const run = flags.propOrderOnly ? {
+		...config,
+		options: {
+			...config.options,
+			propOrderFile: true
+		}
+	} : config;
 	let session = null;
 	const releaseClaims = createRunClaimRelease(() => session, release);
 	const removeShutdownSignals = installShutdownSignals({ release: ({ exitCode, signal }) => {
@@ -383,12 +390,23 @@ async function runBuild(config, flags = {}) {
 		process.exit(exitCode);
 	} });
 	try {
-		session = createCliSession(config);
+		session = createCliSession(run);
 		try {
 			await session.runFullPipeline();
 		} catch (error) {
 			throw new ExtractionFailure(String(error));
 		}
+		if (flags.propOrderOnly) {
+			const path$2 = (0, _animus_ui_extract_session.propOrderPath)(config.root);
+			if (session.propOrderWrittenTo !== path$2) throw new ExtractionFailure(`Analysis wrote no prop-order file at ${path$2}`);
+			reportDiscoveryOutcomes(config, session);
+			err(`prop order → ${path$2}`);
+			return {
+				outDir: (0, path.dirname)(path$2),
+				componentCount: session.lastComponentCount ?? 0,
+				fileCount: (0, _animus_ui_extract_session.getAnalyzedHashes)(session.key)?.size ?? 0
+			};
+		}
 		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)(session.key), config.outDir);
@@ -487,6 +505,8 @@ function parseLoadedCliConfig(raw) {
 			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
 			targets: isConfigString(raw.targets) || isConfigStringArray(raw.targets) ? raw.targets : void 0,
 			keepDirSelector: isConfigBoolean(raw.keepDirSelector) ? raw.keepDirSelector : void 0,
+			shortClassNames: isConfigRecord(raw.shortClassNames) && isConfigString(raw.shortClassNames.prefix) ? { prefix: raw.shortClassNames.prefix } : void 0,
+			propOrderFile: isConfigBoolean(raw.propOrderFile) ? raw.propOrderFile : void 0,
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
@@ -584,6 +604,8 @@ async function resolveCliConfig(flags, cwd) {
 		prefixContextualVars: pick("prefixContextualVars", void 0),
 		targets: pick("targets", flags.targets),
 		keepDirSelector: pick("keepDirSelector", void 0),
+		shortClassNames: pick("shortClassNames", void 0),
+		propOrderFile: pick("propOrderFile", void 0),
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
 		layers: pick("layers", void 0),
@@ -625,6 +647,8 @@ function projectResolvedConfig(config) {
 		verbose: config.options.verbose ?? false,
 		targets: config.options.targets ?? null,
 		keepDirSelector: config.options.keepDirSelector ?? false,
+		shortClassNames: config.options.shortClassNames ?? null,
+		propOrderFile: config.options.propOrderFile ?? false,
 		minify: config.options.minify ?? null,
 		prefix: config.options.prefix ?? null,
 		prefixContextualVars: config.options.prefixContextualVars ?? false,
@@ -828,6 +852,9 @@ Usage:
   animus watch [options]      Long-lived watch: republish on change; ready,
                               per-cycle failures, and degradation on stderr
   animus print-config [opts]  Print the fully resolved configuration (JSON)
+  animus prop-order [opts]    Write only .animus/prop-order.json, which the
+                              animus/prop-order lint rule reads, without a
+                              dev server
 
 Options:
   --system <path>     SystemInstance module (required unless configured)
@@ -914,7 +941,7 @@ async function main(argv = process.argv.slice(2)) {
 		reportUsageError(`Unexpected argument '${positionals[1]}' — one command per invocation`);
 		return;
 	}
-	if (command !== "build" && command !== "watch" && command !== "print-config") {
+	if (command !== "build" && command !== "watch" && command !== "print-config" && command !== "prop-order") {
 		reportUsageError(`Unknown command '${command}'`);
 		return;
 	}
@@ -944,6 +971,11 @@ async function main(argv = process.argv.slice(2)) {
 			process.exitCode = 0;
 			return;
 		}
+		if (command === "prop-order") {
+			await runBuild(config, { propOrderOnly: true });
+			process.exitCode = 0;
+			return;
+		}
 		process.exitCode = await runWatch(config, { failOnDegraded: values["fail-on-degraded"] === true });
 	} catch (error) {
 		console.error(`[animus] ${String(readThrownMessage(error) ?? error)}`);

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAiBlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAiBlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,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;AA+D9B;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,CAmGf"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { AnimusConfigError, DIAGNOSTIC_LEVELS, KIT_DESCRIPTOR_FILE, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertSupportedEngine, buildKitDescriptor, contentHash, createExcludeMatcher, kitPublicationFailures, outputExclusion, renderFontPreloads, resolveMode, runStructuralSelfCheck, stylesheetSliceFiles } from "@animus-ui/extract/pipeline";
 import { parseArgs } from "node:util";
-import { ANIMUS_ARTIFACT_DIR, CLI_COMMIT_ARTIFACT, CLI_FONT_PRELOADS_ARTIFACT, CLI_LOCK_ARTIFACT, CLI_STYLESHEETS_ARTIFACT, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, checkLockLiveness, collectSessionAssets, decodeCommitRecord, engineApi, getAnalyzedHashes, getManifestJson, getSharedCss, getSharedFontPreloads, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, readCliLockRecord, startTurbopackWatcher, verifyCommitRecord } from "@animus-ui/extract/session";
+import { ANIMUS_ARTIFACT_DIR, CLI_COMMIT_ARTIFACT, CLI_FONT_PRELOADS_ARTIFACT, CLI_LOCK_ARTIFACT, CLI_STYLESHEETS_ARTIFACT, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, checkLockLiveness, collectSessionAssets, decodeCommitRecord, engineApi, getAnalyzedHashes, getManifestJson, getSharedCss, getSharedFontPreloads, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, propOrderPath, 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";
@@ -373,7 +373,14 @@ function writeKitDescriptor(root, key) {
 async function runBuild(config, flags = {}) {
 	const { outDir } = config;
 	await runPreflight(config);
-	const release = acquireLock(outDir);
+	const release = flags.propOrderOnly ? () => {} : acquireLock(outDir);
+	const run = flags.propOrderOnly ? {
+		...config,
+		options: {
+			...config.options,
+			propOrderFile: true
+		}
+	} : config;
 	let session = null;
 	const releaseClaims = createRunClaimRelease(() => session, release);
 	const removeShutdownSignals = installShutdownSignals({ release: ({ exitCode, signal }) => {
@@ -382,12 +389,23 @@ async function runBuild(config, flags = {}) {
 		process.exit(exitCode);
 	} });
 	try {
-		session = createCliSession(config);
+		session = createCliSession(run);
 		try {
 			await session.runFullPipeline();
 		} catch (error) {
 			throw new ExtractionFailure(String(error));
 		}
+		if (flags.propOrderOnly) {
+			const path = propOrderPath(config.root);
+			if (session.propOrderWrittenTo !== path) throw new ExtractionFailure(`Analysis wrote no prop-order file at ${path}`);
+			reportDiscoveryOutcomes(config, session);
+			err(`prop order → ${path}`);
+			return {
+				outDir: dirname(path),
+				componentCount: session.lastComponentCount ?? 0,
+				fileCount: getAnalyzedHashes(session.key)?.size ?? 0
+			};
+		}
 		const { componentCount, fileCount } = publishSharedPayloads(config, session);
 		if (flags.kit) {
 			const failures = kitPublicationFailures(config.root, engineApi(session.key), config.outDir);
@@ -486,6 +504,8 @@ function parseLoadedCliConfig(raw) {
 			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
 			targets: isConfigString(raw.targets) || isConfigStringArray(raw.targets) ? raw.targets : void 0,
 			keepDirSelector: isConfigBoolean(raw.keepDirSelector) ? raw.keepDirSelector : void 0,
+			shortClassNames: isConfigRecord(raw.shortClassNames) && isConfigString(raw.shortClassNames.prefix) ? { prefix: raw.shortClassNames.prefix } : void 0,
+			propOrderFile: isConfigBoolean(raw.propOrderFile) ? raw.propOrderFile : void 0,
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
@@ -583,6 +603,8 @@ async function resolveCliConfig(flags, cwd) {
 		prefixContextualVars: pick("prefixContextualVars", void 0),
 		targets: pick("targets", flags.targets),
 		keepDirSelector: pick("keepDirSelector", void 0),
+		shortClassNames: pick("shortClassNames", void 0),
+		propOrderFile: pick("propOrderFile", void 0),
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
 		layers: pick("layers", void 0),
@@ -624,6 +646,8 @@ function projectResolvedConfig(config) {
 		verbose: config.options.verbose ?? false,
 		targets: config.options.targets ?? null,
 		keepDirSelector: config.options.keepDirSelector ?? false,
+		shortClassNames: config.options.shortClassNames ?? null,
+		propOrderFile: config.options.propOrderFile ?? false,
 		minify: config.options.minify ?? null,
 		prefix: config.options.prefix ?? null,
 		prefixContextualVars: config.options.prefixContextualVars ?? false,
@@ -827,6 +851,9 @@ Usage:
   animus watch [options]      Long-lived watch: republish on change; ready,
                               per-cycle failures, and degradation on stderr
   animus print-config [opts]  Print the fully resolved configuration (JSON)
+  animus prop-order [opts]    Write only .animus/prop-order.json, which the
+                              animus/prop-order lint rule reads, without a
+                              dev server
 
 Options:
   --system <path>     SystemInstance module (required unless configured)
@@ -913,7 +940,7 @@ async function main(argv = process.argv.slice(2)) {
 		reportUsageError(`Unexpected argument '${positionals[1]}' — one command per invocation`);
 		return;
 	}
-	if (command !== "build" && command !== "watch" && command !== "print-config") {
+	if (command !== "build" && command !== "watch" && command !== "print-config" && command !== "prop-order") {
 		reportUsageError(`Unknown command '${command}'`);
 		return;
 	}
@@ -943,6 +970,11 @@ async function main(argv = process.argv.slice(2)) {
 			process.exitCode = 0;
 			return;
 		}
+		if (command === "prop-order") {
+			await runBuild(config, { propOrderOnly: true });
+			process.exitCode = 0;
+			return;
+		}
 		process.exitCode = await runWatch(config, { failOnDegraded: values["fail-on-degraded"] === true });
 	} catch (error) {
 		console.error(`[animus] ${String(readThrownMessage(error) ?? error)}`);

package/package.json

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