@animus-ui/cli 0.1.32 → 0.1.37

package/README.md

@@ -109,7 +109,10 @@ files, and structural emptiness are fatal in every mode.
 
 `animus build` publishes to `--out-dir` (default `<root>/.animus/` —
 `.gitignore` it) at fixed paths: `styles.css`, `system-props.js`,
-`manifest.json`, and `commit.json` — written last, carrying a content hash
+`manifest.json`, `font-preloads.json` (the font faces' preloads, for
+`renderFontPreloads`; present only when a face preloads, as the faces'
+`preload` flags or the config's `fontPreloads` entries select them), and
+`commit.json` — written last, carrying a content hash
 per payload, so one read verifies set completeness and freshness. Bytes are
 deterministic and identity-free; `lock.json` is a single-writer advisory
 lock that fails loud. The full contract, including the consistency-check

package/dist/build.d.ts.map

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

@@ -52,6 +52,7 @@ export declare function projectResolvedConfig(config: ResolvedCliConfig): {
     staticCss: StaticCssConfig | null;
     runtimeImport: string | null;
     closedDynamicImports: import("@animus-ui/extract/pipeline").ClosedDynamicImport[] | null;
+    fontPreloads: import("@animus-ui/extract/pipeline").FontPreloadEntry[] | 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;AAmPD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAsI5B;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,oBAAoB;IACpB,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;AAuPD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAuI5B;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,oBAAoB;IACpB,YAAY;IACZ,OAAO;IACP,UAAU;EAEb"}

package/dist/index.cjs

@@ -62,6 +62,7 @@ const MANIFEST_FILE = _animus_ui_extract_session.MANIFEST_ARTIFACT;
 const COMMIT_FILE = _animus_ui_extract_session.CLI_COMMIT_ARTIFACT;
 const LOCK_FILE = _animus_ui_extract_session.CLI_LOCK_ARTIFACT;
 const ASSETS_DIR = _animus_ui_extract_session.SESSION_ASSETS_DIR;
+const FONT_PRELOADS_FILE = _animus_ui_extract_session.CLI_FONT_PRELOADS_ARTIFACT;
 function isFileExistsError(error) {
 	return error instanceof Object && "code" in error && error.code === "EEXIST";
 }
@@ -101,7 +102,8 @@ const STAGING_PREFIX = ".staging-";
 const NAMED_PAYLOAD_FIELDS = [
 	[STYLES_FILE, "stylesCss"],
 	[SYSTEM_PROPS_FILE, "systemPropsJs"],
-	[MANIFEST_FILE, "manifestJson"]
+	[MANIFEST_FILE, "manifestJson"],
+	[FONT_PRELOADS_FILE, "fontPreloadsJson"]
 ];
 const PUBLISHED_NAMES = [...NAMED_PAYLOAD_FIELDS.map(([name]) => name), COMMIT_FILE];
 /** Called only while the claim is held — deciding a tree is debris and
@@ -165,21 +167,21 @@ function acquireLock(outDir) {
 		startedAt
 	});
 }
-function publishedAssetNames(outDir) {
+/** Every name the current commit record publishes. */
+function publishedNames(outDir) {
 	let record;
 	try {
 		record = (0, _animus_ui_extract_session.decodeCommitRecord)((0, fs.readFileSync)((0, path.join)(outDir, COMMIT_FILE), "utf-8"));
 	} catch {
 		return /* @__PURE__ */ new Set();
 	}
-	if (record === null) return /* @__PURE__ */ new Set();
-	return new Set(Object.keys(record.payloads).filter((name) => name.startsWith(`${ASSETS_DIR}/`)).map((name) => name.slice(ASSETS_DIR.length + 1)));
+	return new Set(record === null ? [] : Object.keys(record.payloads));
 }
 /** Staged, verified, then renamed into place with the commit record LAST. A
 *  set that cannot verify throws with the previous generation untouched. */
 function publishArtifacts(outDir, payloads) {
 	(0, fs.mkdirSync)(outDir, { recursive: true });
-	const previouslyPublishedAssets = publishedAssetNames(outDir);
+	const previouslyPublished = publishedNames(outDir);
 	const staging = (0, path.join)(outDir, `${STAGING_PREFIX}${process.pid}`);
 	(0, fs.rmSync)(staging, {
 		recursive: true,
@@ -187,7 +189,11 @@ function publishArtifacts(outDir, payloads) {
 	});
 	(0, fs.mkdirSync)(staging, { recursive: true });
 	try {
-		const namedPayloads = NAMED_PAYLOAD_FIELDS.map(([name, field]) => [name, payloads[field]]);
+		const namedPayloads = [];
+		for (const [name, field] of NAMED_PAYLOAD_FIELDS) {
+			const text = payloads[field];
+			if (text !== void 0) namedPayloads.push([name, text]);
+		}
 		const record = {
 			schema: 1,
 			payloads: {}
@@ -221,11 +227,11 @@ function publishArtifacts(outDir, payloads) {
 					landed.push(`${ASSETS_DIR}/${name}`);
 				}
 			}
-			const expectedNames = new Set(assets.map((asset) => asset.name));
-			for (const name of previouslyPublishedAssets) {
-				if (expectedNames.has(name)) continue;
+			const expectedNames = /* @__PURE__ */ new Set([...namedPayloads.map(([name]) => name), ...assets.map((asset) => `${ASSETS_DIR}/${asset.name}`)]);
+			for (const name of previouslyPublished) {
+				if (expectedNames.has(name) || name === COMMIT_FILE) continue;
 				try {
-					(0, fs.unlinkSync)((0, path.join)(publishedAssetsDir, name));
+					(0, fs.unlinkSync)((0, path.join)(outDir, name));
 				} catch {}
 			}
 			(0, fs.renameSync)((0, path.join)(staging, COMMIT_FILE), (0, path.join)(outDir, COMMIT_FILE));
@@ -285,6 +291,7 @@ function publishSharedPayloads(config, session) {
 	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);
+	const fontPreloads = (0, _animus_ui_extract_session.getSharedFontPreloads)(session.key);
 	let componentCount = session.lastComponentCount ?? -1;
 	if (componentCount < 0) try {
 		const manifest = JSON.parse(manifestJson);
@@ -303,14 +310,15 @@ function publishSharedPayloads(config, session) {
 		variableMapJson: session.variableMapJson
 	});
 	if (failures.length > 0) throw new ExtractionFailure(`Structural self-check failed:\n  - ${failures.join("\n  - ")}`);
-	const assets = (0, _animus_ui_extract_session.collectSessionAssets)(session.sessionDir);
+	const payloads = {
+		stylesCss,
+		systemPropsJs,
+		manifestJson,
+		assets: (0, _animus_ui_extract_session.collectSessionAssets)(session.sessionDir)
+	};
+	if (fontPreloads.length > 0) payloads.fontPreloadsJson = JSON.stringify(fontPreloads);
 	try {
-		publishArtifacts(outDir, {
-			stylesCss,
-			systemPropsJs,
-			manifestJson,
-			assets
-		});
+		publishArtifacts(outDir, payloads);
 	} catch (error) {
 		if (error instanceof PublishInconsistencyError) throw new EnvironmentFailure(error.message);
 		throw error;
@@ -473,6 +481,7 @@ function parseLoadedCliConfig(raw) {
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
 			runtimeImport: isConfigString(raw.runtimeImport) ? raw.runtimeImport : void 0,
 			closedDynamicImports: Array.isArray(raw.closedDynamicImports) ? raw.closedDynamicImports : void 0,
+			fontPreloads: Array.isArray(raw.fontPreloads) ? raw.fontPreloads : void 0,
 			mode: raw.mode === "development" || raw.mode === "production" ? raw.mode : void 0
 		},
 		cli: { outDir: cli.outDir }
@@ -567,6 +576,7 @@ async function resolveCliConfig(flags, cwd) {
 		layers: pick("layers", void 0),
 		runtimeImport: pick("runtimeImport", void 0),
 		closedDynamicImports: pick("closedDynamicImports", void 0),
+		fontPreloads: pick("fontPreloads", void 0),
 		mode: resolvedMode.mode
 	};
 	const excludePatterns = (0, _animus_ui_extract_pipeline.createExcludeMatcher)(options.exclude).patterns;
@@ -608,6 +618,7 @@ function projectResolvedConfig(config) {
 		staticCss: config.options.staticCss ?? null,
 		runtimeImport: config.options.runtimeImport ?? null,
 		closedDynamicImports: config.options.closedDynamicImports ?? null,
+		fontPreloads: config.options.fontPreloads ?? null,
 		exclude: config.excludePatterns,
 		provenance: config.provenance
 	};
@@ -931,3 +942,9 @@ exports.EXIT_OK = EXIT_OK;
 exports.EXIT_USAGE = EXIT_USAGE;
 exports.exitCodeFor = exitCodeFor;
 exports.main = main;
+Object.defineProperty(exports, "renderFontPreloads", {
+	enumerable: true,
+	get: function() {
+		return _animus_ui_extract_pipeline.renderFontPreloads;
+	}
+});

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 /** The supported consumer surface is the `animus` binary; the programmatic
  *  exports may change without semver ceremony. */
+export { renderFontPreloads } from '@animus-ui/extract/pipeline';
+export type { FontPreload } from '@animus-ui/extract/pipeline';
 export declare const EXIT_OK = 0;
 export declare const EXIT_EXTRACTION = 1;
 export declare const EXIT_USAGE = 2;

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;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;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, 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 { AnimusConfigError, DIAGNOSTIC_LEVELS, KIT_DESCRIPTOR_FILE, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertSupportedEngine, buildKitDescriptor, contentHash, createExcludeMatcher, kitPublicationFailures, outputExclusion, renderFontPreloads, 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 { ANIMUS_ARTIFACT_DIR, CLI_COMMIT_ARTIFACT, CLI_FONT_PRELOADS_ARTIFACT, CLI_LOCK_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 { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "fs";
 import { dirname, isAbsolute, join, relative, resolve } from "path";
 import { pathToFileURL } from "url";
@@ -61,6 +61,7 @@ const MANIFEST_FILE = MANIFEST_ARTIFACT;
 const COMMIT_FILE = CLI_COMMIT_ARTIFACT;
 const LOCK_FILE = CLI_LOCK_ARTIFACT;
 const ASSETS_DIR = SESSION_ASSETS_DIR;
+const FONT_PRELOADS_FILE = CLI_FONT_PRELOADS_ARTIFACT;
 function isFileExistsError(error) {
 	return error instanceof Object && "code" in error && error.code === "EEXIST";
 }
@@ -100,7 +101,8 @@ const STAGING_PREFIX = ".staging-";
 const NAMED_PAYLOAD_FIELDS = [
 	[STYLES_FILE, "stylesCss"],
 	[SYSTEM_PROPS_FILE, "systemPropsJs"],
-	[MANIFEST_FILE, "manifestJson"]
+	[MANIFEST_FILE, "manifestJson"],
+	[FONT_PRELOADS_FILE, "fontPreloadsJson"]
 ];
 const PUBLISHED_NAMES = [...NAMED_PAYLOAD_FIELDS.map(([name]) => name), COMMIT_FILE];
 /** Called only while the claim is held — deciding a tree is debris and
@@ -164,21 +166,21 @@ function acquireLock(outDir) {
 		startedAt
 	});
 }
-function publishedAssetNames(outDir) {
+/** Every name the current commit record publishes. */
+function publishedNames(outDir) {
 	let record;
 	try {
 		record = decodeCommitRecord(readFileSync(join(outDir, COMMIT_FILE), "utf-8"));
 	} catch {
 		return /* @__PURE__ */ new Set();
 	}
-	if (record === null) return /* @__PURE__ */ new Set();
-	return new Set(Object.keys(record.payloads).filter((name) => name.startsWith(`${ASSETS_DIR}/`)).map((name) => name.slice(ASSETS_DIR.length + 1)));
+	return new Set(record === null ? [] : Object.keys(record.payloads));
 }
 /** Staged, verified, then renamed into place with the commit record LAST. A
 *  set that cannot verify throws with the previous generation untouched. */
 function publishArtifacts(outDir, payloads) {
 	mkdirSync(outDir, { recursive: true });
-	const previouslyPublishedAssets = publishedAssetNames(outDir);
+	const previouslyPublished = publishedNames(outDir);
 	const staging = join(outDir, `${STAGING_PREFIX}${process.pid}`);
 	rmSync(staging, {
 		recursive: true,
@@ -186,7 +188,11 @@ function publishArtifacts(outDir, payloads) {
 	});
 	mkdirSync(staging, { recursive: true });
 	try {
-		const namedPayloads = NAMED_PAYLOAD_FIELDS.map(([name, field]) => [name, payloads[field]]);
+		const namedPayloads = [];
+		for (const [name, field] of NAMED_PAYLOAD_FIELDS) {
+			const text = payloads[field];
+			if (text !== void 0) namedPayloads.push([name, text]);
+		}
 		const record = {
 			schema: 1,
 			payloads: {}
@@ -220,11 +226,11 @@ function publishArtifacts(outDir, payloads) {
 					landed.push(`${ASSETS_DIR}/${name}`);
 				}
 			}
-			const expectedNames = new Set(assets.map((asset) => asset.name));
-			for (const name of previouslyPublishedAssets) {
-				if (expectedNames.has(name)) continue;
+			const expectedNames = /* @__PURE__ */ new Set([...namedPayloads.map(([name]) => name), ...assets.map((asset) => `${ASSETS_DIR}/${asset.name}`)]);
+			for (const name of previouslyPublished) {
+				if (expectedNames.has(name) || name === COMMIT_FILE) continue;
 				try {
-					unlinkSync(join(publishedAssetsDir, name));
+					unlinkSync(join(outDir, name));
 				} catch {}
 			}
 			renameSync(join(staging, COMMIT_FILE), join(outDir, COMMIT_FILE));
@@ -284,6 +290,7 @@ function publishSharedPayloads(config, session) {
 	const manifestJson = getManifestJson(session.key) ?? "";
 	const stylesCss = getSharedCss(session.key);
 	const systemPropsJs = getSharedSystemProps(session.key);
+	const fontPreloads = getSharedFontPreloads(session.key);
 	let componentCount = session.lastComponentCount ?? -1;
 	if (componentCount < 0) try {
 		const manifest = JSON.parse(manifestJson);
@@ -302,14 +309,15 @@ function publishSharedPayloads(config, session) {
 		variableMapJson: session.variableMapJson
 	});
 	if (failures.length > 0) throw new ExtractionFailure(`Structural self-check failed:\n  - ${failures.join("\n  - ")}`);
-	const assets = collectSessionAssets(session.sessionDir);
+	const payloads = {
+		stylesCss,
+		systemPropsJs,
+		manifestJson,
+		assets: collectSessionAssets(session.sessionDir)
+	};
+	if (fontPreloads.length > 0) payloads.fontPreloadsJson = JSON.stringify(fontPreloads);
 	try {
-		publishArtifacts(outDir, {
-			stylesCss,
-			systemPropsJs,
-			manifestJson,
-			assets
-		});
+		publishArtifacts(outDir, payloads);
 	} catch (error) {
 		if (error instanceof PublishInconsistencyError) throw new EnvironmentFailure(error.message);
 		throw error;
@@ -472,6 +480,7 @@ function parseLoadedCliConfig(raw) {
 			layers: isConfigStringArray(raw.layers) ? raw.layers : void 0,
 			runtimeImport: isConfigString(raw.runtimeImport) ? raw.runtimeImport : void 0,
 			closedDynamicImports: Array.isArray(raw.closedDynamicImports) ? raw.closedDynamicImports : void 0,
+			fontPreloads: Array.isArray(raw.fontPreloads) ? raw.fontPreloads : void 0,
 			mode: raw.mode === "development" || raw.mode === "production" ? raw.mode : void 0
 		},
 		cli: { outDir: cli.outDir }
@@ -566,6 +575,7 @@ async function resolveCliConfig(flags, cwd) {
 		layers: pick("layers", void 0),
 		runtimeImport: pick("runtimeImport", void 0),
 		closedDynamicImports: pick("closedDynamicImports", void 0),
+		fontPreloads: pick("fontPreloads", void 0),
 		mode: resolvedMode.mode
 	};
 	const excludePatterns = createExcludeMatcher(options.exclude).patterns;
@@ -607,6 +617,7 @@ function projectResolvedConfig(config) {
 		staticCss: config.options.staticCss ?? null,
 		runtimeImport: config.options.runtimeImport ?? null,
 		closedDynamicImports: config.options.closedDynamicImports ?? null,
+		fontPreloads: config.options.fontPreloads ?? null,
 		exclude: config.excludePatterns,
 		provenance: config.provenance
 	};
@@ -923,4 +934,4 @@ async function main(argv = process.argv.slice(2)) {
 	}
 }
 //#endregion
-export { EXIT_ENVIRONMENT, EXIT_EXTRACTION, EXIT_INSTALL, EXIT_OK, EXIT_USAGE, exitCodeFor, main };
+export { EXIT_ENVIRONMENT, EXIT_EXTRACTION, EXIT_INSTALL, EXIT_OK, EXIT_USAGE, exitCodeFor, main, renderFontPreloads };

package/dist/writer.d.ts

@@ -6,10 +6,14 @@ export declare const MANIFEST_FILE = "manifest.json";
 export declare const COMMIT_FILE = "commit.json";
 export declare const LOCK_FILE = "lock.json";
 export declare const ASSETS_DIR = "assets";
+export declare const FONT_PRELOADS_FILE = "font-preloads.json";
 export interface ArtifactPayloads {
     stylesCss: string;
     systemPropsJs: string;
     manifestJson: string;
+    /** The faces' preloads, hrefs relative to styles.css, for
+     *  `renderFontPreloads`; absent when no face preloads. */
+    fontPreloadsJson?: string;
     /** Published under `assets/<name>` beside styles.css — the stylesheet's
      *  relative urls dangle without them. */
     assets?: readonly SessionAsset[];

package/dist/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,6BAA6B,CAAC;AA4B7E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI7E,eAAO,MAAM,WAAW,eAAkB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,oBAAwB,CAAC;AACvD,eAAO,MAAM,aAAa,kBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAsB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,WAAqB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB;6CACyC;IACzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC;AAYD;8DAC8D;AAC9D,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAAvC,YAAqB,QAAQ,EAAE,MAAM,EAAE,EAKtC;CACF;AAED,qBAAa,0BAA0B,CAAC,MAAM,CAAE,SAAQ,KAAK;IAEzD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJ1B,YACW,MAAM,EAAE,MAAM;IACvB,wDAAwD;IAC/C,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EASzB;CACF;AAED;yEACyE;AACzE,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAmDD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAoDtD;AAmBD;4EAC4E;AAC5E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,YAAY,CA8Ed"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAe,MAAM,6BAA6B,CAAC;AA6B7E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI7E,eAAO,MAAM,WAAW,eAAkB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,oBAAwB,CAAC;AACvD,eAAO,MAAM,aAAa,kBAAoB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAsB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,WAAqB,CAAC;AAC7C,eAAO,MAAM,kBAAkB,uBAA6B,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB;8DAC0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;6CACyC;IACzC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC;AAYD;8DAC8D;AAC9D,qBAAa,yBAA0B,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAAvC,YAAqB,QAAQ,EAAE,MAAM,EAAE,EAKtC;CACF;AAED,qBAAa,0BAA0B,CAAC,MAAM,CAAE,SAAQ,KAAK;IAEzD,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJ1B,YACW,MAAM,EAAE,MAAM;IACvB,wDAAwD;IAC/C,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EASzB;CACF;AAED;yEACyE;AACzE,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAoDD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAoDtD;AAeD;4EAC4E;AAC5E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GACzB,YAAY,CAqFd"}

package/package.json

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