@animus-ui/extract 0.1.5 → 0.1.7

package/crates/extract-v2/index.d.ts

@@ -58,7 +58,7 @@ export interface EngineOptions {
   /** Selector aliases JSON (v1 `selector_aliases_json`). */
   selectorAliasesJson?: string
   /**
-   * Condition aliases JSON (inc 03 — `conditionAliases` manifest field):
+   * Condition aliases JSON (the `conditionAliases` manifest field):
    * `{ "_motionReduce": { "value": "@media …", "order": 500, "kind":
    * "media" } }`. Absent = no registrations.
    */
@@ -98,10 +98,10 @@ export interface EngineOptions {
 export declare function engineVersion(): string
 
 /**
- * Full per-file fact extraction (increment 11): chains + eagerly evaluated
+ * Full per-file fact extraction: chains + eagerly evaluated
  * stages + statics + raw usage facts + compose families — one parse per
  * file. The store (and every AST) is dropped when this call returns; the
- * D4-relevant invariant is that no program() read happens after
+ * invariant is that no program() read happens after
  * cross-file facts resolve.
  */
 export declare function extractFacts(fileEntriesJson: string): string
@@ -118,8 +118,8 @@ export interface NapiSystemConfig {
   selectorAliases?: string
   selectorOrder?: string
   /**
-   * Condition alias map JSON (inc 03 — `conditionAliases`): alias →
-   * `{ value, order, kind }`. Absent when the system registers none.
+   * Condition alias map JSON (the `conditionAliases` manifest field):
+   * alias → `{ value, order, kind }`. Absent when the system registers none.
    */
   conditionAliases?: string
   globalStyleBlocks?: string
@@ -138,3 +138,14 @@ export interface NapiSystemConfig {
    */
   sourceThemeManifests?: string
 }
+
+/**
+ * Scan one module entry for named `Keyframes` collection exports — the
+ * keyframes-only carve-out for external package entries. The
+ * entry evaluates through the same loader pipeline as a system module, but
+ * nothing except `__brand === 'Keyframes'` exports is read from it; the
+ * consumer's configured system remains the singular config authority.
+ * Returns the `{ exportName: { keyName: { name, frames } } }` JSON, or None
+ * when the entry exports no collections.
+ */
+export declare function scanKeyframesExports(entryPath: string, rootDir: string): string | null

package/dist/engine-adapter.d.ts

@@ -40,6 +40,8 @@ export interface TransformFileResult {
  */
 export interface EngineApi {
     loadSystemModule: (...args: unknown[]) => any;
+    /** Keyframes-only scan of an external package entry. */
+    scanKeyframesExports: (entryPath: string, rootDir: string) => string | null;
     analyzeProject: (filesJson: string, scalesJson: string, variableMapJson: string, contextualVarsJson: string | null, propConfigJson: string, groupRegistryJson: string, packageResolutionJson: string, devMode: boolean, emitterConfigJson: string | null, selectorAliasesJson: string | null, selectorOrderJson: string | null, globalStyleBlocksJson: string | null, pathAliasesJson: string | null, keyframesJson: string | null, staticCssJson: string | null, conditionAliasesJson: string | null, externalDirsJson: string | null) => string;
     transformFile: (source: string, path: string, manifest: string) => TransformFileResult;
     clearAnalysisCache: () => void;

package/dist/engine-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-adapter.d.ts","sourceRoot":"","sources":["../pipeline/engine-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IAIxB,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC;IAC9C,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,KAC5B,MAAM,CAAC;IACZ,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,KACb,mBAAmB,CAAC;IACzB,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,IAAI,eAAe,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAChD,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1D,cAAc,IAAI,OAAO,CAAC;IAC1B,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,4EAA4E;AAE5E,KAAK,kBAAkB,GAAG,GAAG,CAAC;AA2B9B,MAAM,WAAW,mBAAmB;IAClC;kDAC8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd;;2DAEuD;IACvD,IAAI,IAAI,OAAO,CAAC;IAChB;qDACiD;IACjD,gBAAgB,IAAI,kBAAkB,CAAC;IACvC,qEAAqE;IACrE,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;;gBAIY;IACZ,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;+CAG2C;IAC3C,kBAAkB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,SAAS,CAkH5E"}
+{"version":3,"file":"engine-adapter.d.ts","sourceRoot":"","sources":["../pipeline/engine-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IAIxB,gBAAgB,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC;IAC9C,wDAAwD;IACxD,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5E,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,KAC5B,MAAM,CAAC;IACZ,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,KACb,mBAAmB,CAAC;IACzB,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,IAAI,eAAe,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;IAChD,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1D,cAAc,IAAI,OAAO,CAAC;IAC1B,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,4EAA4E;AAE5E,KAAK,kBAAkB,GAAG,GAAG,CAAC;AA2B9B,MAAM,WAAW,mBAAmB;IAClC;kDAC8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd;;2DAEuD;IACvD,IAAI,IAAI,OAAO,CAAC;IAChB;qDACiD;IACjD,gBAAgB,IAAI,kBAAkB,CAAC;IACvC,qEAAqE;IACrE,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;;gBAIY;IACZ,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;+CAG2C;IAC3C,kBAAkB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,SAAS,CAsH5E"}

package/dist/external-keyframes.d.ts

@@ -0,0 +1,23 @@
+import type { ManifestDiagnostic } from './manifest-diagnostics';
+/** Stable codes for external keyframes discovery. */
+export declare const KEYFRAMES_EXTERNAL_ENTRY_FAILED = "animus.keyframes.external-entry-failed";
+export declare const KEYFRAMES_EXPORT_COLLISION = "animus.keyframes.export-collision";
+export interface ExternalKeyframesMerge {
+    /** Consumer collections merged with every discovered external collection
+     *  (consumer wins on name collisions); `null` when nothing exists. */
+    keyframesJson: string | null;
+    /** Warn-severity diagnostics for failed entries and name collisions —
+     *  surfaced through the shared manifest-diagnostics policy point. */
+    diagnostics: ManifestDiagnostic[];
+}
+/**
+ * Merge `Keyframes` collections discovered from external package entries into
+ * the consumer system's collections. Keyframes are the sole carve-out from
+ * the consumer-config singular-authority rule: nothing but branded
+ * collections is read from an entry, an entry that fails to evaluate
+ * degrades to a coded diagnostic naming it, and a collection whose export
+ * name collides keeps the earlier (consumer-first) collection with a coded
+ * diagnostic instead of silently reordering names.
+ */
+export declare function mergeExternalKeyframes(scan: (entryPath: string, rootDir: string) => string | null, consumerKeyframesJson: string | null | undefined, externalEntries: Iterable<string>, rootDir: string): ExternalKeyframesMerge;
+//# sourceMappingURL=external-keyframes.d.ts.map

package/dist/external-keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-keyframes.d.ts","sourceRoot":"","sources":["../pipeline/external-keyframes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,qDAAqD;AACrD,eAAO,MAAM,+BAA+B,2CACF,CAAC;AAC3C,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC;0EACsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;yEACqE;IACrE,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,EAC3D,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChD,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,sBAAsB,CAoExB"}

package/dist/index.cjs

@@ -141,6 +141,7 @@ function createV2EngineApi(deps) {
 		const native = loadNativeEngine();
 		return {
 			loadSystemModule: (...args) => native.loadSystemModule(...args),
+			scanKeyframesExports: (entryPath, rootDir) => native.scanKeyframesExports(entryPath, rootDir) ?? null,
 			analyzeProject: (filesJsonRaw, scalesJson, variableMapJson, contextualVarsJson, propConfigJson, groupRegistryJson, packageResolutionJson, devMode, emitterConfigJson, selectorAliasesJson, _selectorOrderJson, globalStyleBlocksJson, pathAliasesJson, keyframesJson, staticCssJson, conditionAliasesJson, externalDirsJson) => {
 				const filesJson = deps.rehydrateFilesJson ? deps.rehydrateFilesJson(filesJsonRaw) : filesJsonRaw;
 				const sent = /* @__PURE__ */ new Map();
@@ -232,6 +233,77 @@ function contentHash(source) {
 	return (0, crypto.createHash)("md5").update(source).digest("hex");
 }
 //#endregion
+//#region pipeline/external-keyframes.ts
+/** Stable codes for external keyframes discovery. */
+const KEYFRAMES_EXTERNAL_ENTRY_FAILED = "animus.keyframes.external-entry-failed";
+const KEYFRAMES_EXPORT_COLLISION = "animus.keyframes.export-collision";
+/**
+* Merge `Keyframes` collections discovered from external package entries into
+* the consumer system's collections. Keyframes are the sole carve-out from
+* the consumer-config singular-authority rule: nothing but branded
+* collections is read from an entry, an entry that fails to evaluate
+* degrades to a coded diagnostic naming it, and a collection whose export
+* name collides keeps the earlier (consumer-first) collection with a coded
+* diagnostic instead of silently reordering names.
+*/
+function mergeExternalKeyframes(scan, consumerKeyframesJson, externalEntries, rootDir) {
+	const merged = {};
+	if (consumerKeyframesJson) try {
+		Object.assign(merged, JSON.parse(consumerKeyframesJson));
+	} catch {
+		return {
+			keyframesJson: consumerKeyframesJson,
+			diagnostics: []
+		};
+	}
+	const diagnostics = [];
+	const seenEntries = /* @__PURE__ */ new Set();
+	for (const entryPath of externalEntries) {
+		if (seenEntries.has(entryPath)) continue;
+		seenEntries.add(entryPath);
+		let scanned;
+		try {
+			scanned = scan(entryPath, rootDir);
+		} catch (error) {
+			diagnostics.push({
+				file: entryPath,
+				component: "keyframes",
+				kind: "warn",
+				message: `external package entry failed the keyframes scan — its collections are invisible to extraction: ${String(error)}. Keyframe collections must be reachable from the package's definition entry without evaluating framework re-exports: export them (directly or as a named re-export) from the definition entry, and avoid \`export *\` of framework packages there (${KEYFRAMES_EXTERNAL_ENTRY_FAILED})`,
+				code: KEYFRAMES_EXTERNAL_ENTRY_FAILED,
+				severity: "warn"
+			});
+			continue;
+		}
+		if (!scanned) continue;
+		let collections;
+		try {
+			collections = JSON.parse(scanned);
+		} catch {
+			continue;
+		}
+		for (const [exportName, collection] of Object.entries(collections)) {
+			const existing = merged[exportName];
+			if (existing !== void 0) {
+				if (JSON.stringify(existing) !== JSON.stringify(collection)) diagnostics.push({
+					file: entryPath,
+					component: exportName,
+					kind: "warn",
+					message: `keyframes collection export '${exportName}' collides with an earlier collection of the same name — the earlier one wins (${KEYFRAMES_EXPORT_COLLISION})`,
+					code: KEYFRAMES_EXPORT_COLLISION,
+					severity: "warn"
+				});
+				continue;
+			}
+			merged[exportName] = collection;
+		}
+	}
+	return {
+		keyframesJson: Object.keys(merged).length > 0 ? JSON.stringify(merged) : null,
+		diagnostics
+	};
+}
+//#endregion
 //#region pipeline/discover-files.ts
 /**
 * Recursively discover source files under `dir`, skipping any path that
@@ -1007,17 +1079,78 @@ function postProcessCss(css, opts) {
 }
 //#endregion
 //#region pipeline/manifest-diagnostics.ts
+/** Stable code for selector forms with no substitutable subject.
+*  Mirrors the Rust constant in `extract-v2/src/eval.rs`. */
+const SELECTOR_UNSUPPORTED_SUBJECT = "animus.selector.unsupported-subject";
+/** True when the selector string carries at least one substitutable `&`
+*  subject outside quoted text (mirrors the Rust `selector_subject` walk —
+*  ancestor, leading, and repeated subjects all count; a `&` inside a
+*  quoted attribute value does not). */
+function hasSelectorSubject(value) {
+	let quote = null;
+	for (const c of value) if (quote !== null) {
+		if (c === quote) quote = null;
+	} else if (c === "\"" || c === "'") quote = c;
+	else if (c === "&") return true;
+	return false;
+}
+/**
+* Synthesize coded diagnostics for registered selector-alias values that
+* look selector-shaped (`&` present) but carry no substitutable subject —
+* every `&` sits inside quoted text, so there is nothing to anchor the
+* class to. Ancestor-prefixed and repeated subjects are supported and pass
+* validation. The system-config boundary is where these must fail loud
+* (alias values never reach the evaluator's key guard).
+*/
+function collectSelectorAliasDiagnostics(selectorAliasesJson) {
+	if (!selectorAliasesJson) return [];
+	let aliases;
+	try {
+		aliases = JSON.parse(selectorAliasesJson);
+	} catch {
+		return [];
+	}
+	const diagnostics = [];
+	for (const [name, value] of Object.entries(aliases)) {
+		if (typeof value !== "string") continue;
+		if (value.includes("&") && !hasSelectorSubject(value)) diagnostics.push({
+			file: "system",
+			component: name,
+			kind: "warn",
+			message: `selector alias '${name}' value '${value}' has no substitutable '&' subject outside quoted text (${SELECTOR_UNSUPPORTED_SUBJECT})`,
+			code: SELECTOR_UNSUPPORTED_SUBJECT,
+			severity: "error"
+		});
+	}
+	return diagnostics;
+}
 /**
 * Surface extraction-manifest diagnostics through a plugin's warn channel.
 *
-* Single authoritative copy for both extraction plugins. Surfaces `bail`
-* (component not extracted), `skip` (component skipped), and `warn` kinds;
-* unknown kinds stay silent.
+* Single authoritative copy for both extraction plugins — and the single
+* strict-escalation policy point: error-severity diagnostics throw one
+* Error naming every offender when `policy.strict`, and print as warnings
+* otherwise. Surfaces `bail` (component not extracted), `skip` (component
+* skipped), and `warn` kinds; unknown kinds stay silent. Printed lines
+* include the diagnostic code when the message doesn't already carry it.
 */
-function surfaceManifestDiagnostics(manifest, warn) {
-	for (const diagnostic of manifest.diagnostics ?? []) if (diagnostic.kind === "bail") warn(`⚠ ${diagnostic.component} not extracted: ${diagnostic.message}`);
-	else if (diagnostic.kind === "skip") warn(`⚠ ${diagnostic.component}: skipped ${diagnostic.message}`);
-	else if (diagnostic.kind === "warn") warn(`⚠ ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`);
+function surfaceManifestDiagnostics(manifest, warn, policy = {}) {
+	const errors = [];
+	const diagnostics = policy.prepend?.length ? [...policy.prepend, ...manifest.diagnostics ?? []] : manifest.diagnostics ?? [];
+	for (const diagnostic of diagnostics) {
+		let line = null;
+		if (diagnostic.kind === "bail") line = `⚠ ${diagnostic.component} not extracted: ${diagnostic.message}`;
+		else if (diagnostic.kind === "skip") line = `⚠ ${diagnostic.component}: skipped ${diagnostic.message}`;
+		else if (diagnostic.kind === "warn") line = `⚠ ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`;
+		if (line === null) continue;
+		if (diagnostic.code && !diagnostic.message.includes(diagnostic.code)) line += ` [${diagnostic.code}]`;
+		if (policy.strict && diagnostic.severity === "error") {
+			errors.push(`${diagnostic.code ?? "error"} — ${diagnostic.component}: ${diagnostic.message}`);
+			continue;
+		}
+		warn(line);
+	}
+	if (errors.length > 0) throw new Error(`[animus] strict: ${errors.length} error diagnostic(s):\n${errors.join("\n")}`);
 }
 //#endregion
 //#region pipeline/unit-fallback.ts
@@ -1113,7 +1246,10 @@ function runProjectAnalysis(engineApi, opts) {
 	const extractMs = Math.round(performance.now() - t);
 	t = performance.now();
 	const manifest = JSON.parse(manifestJson);
-	surfaceManifestDiagnostics(manifest, opts.warn);
+	surfaceManifestDiagnostics(manifest, opts.warn, {
+		strict: opts.strict,
+		prepend: [...collectSelectorAliasDiagnostics(opts.system.selectorAliasesJson), ...opts.extraDiagnostics ?? []]
+	});
 	const parseMs = Math.round(performance.now() - t);
 	return {
 		manifest,
@@ -1581,6 +1717,8 @@ function realpathThroughNearestExistingAncestor(path) {
 //#endregion
 exports.ANIMUS_LAYERS = ANIMUS_LAYERS;
 exports.DEFAULT_EXTENSIONS = DEFAULT_EXTENSIONS;
+exports.KEYFRAMES_EXPORT_COLLISION = KEYFRAMES_EXPORT_COLLISION;
+exports.KEYFRAMES_EXTERNAL_ENTRY_FAILED = KEYFRAMES_EXTERNAL_ENTRY_FAILED;
 exports.RETIRED_ENGINE_MESSAGE = RETIRED_ENGINE_MESSAGE;
 exports.applyPrefix = applyPrefix;
 exports.applyUnitFallback = applyUnitFallback;
@@ -1603,6 +1741,7 @@ exports.findAssetSpecifiers = findAssetSpecifiers;
 exports.findPackageRoot = findPackageRoot;
 exports.formatRustTimingWaterfall = formatRustTimingWaterfall;
 exports.loadSystemConfig = loadSystemConfig;
+exports.mergeExternalKeyframes = mergeExternalKeyframes;
 exports.postProcessCss = postProcessCss;
 exports.preprocessMdx = preprocessMdx;
 exports.readTsconfigAliasPairs = readTsconfigAliasPairs;

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export type { EngineApi, TransformFileResult, V2EngineAdapterDeps, V2EngineState
 export { createV2EngineApi } from './engine-adapter';
 export { assertNoRetiredEngineSelection, RETIRED_ENGINE_MESSAGE, } from './engine-retirement';
 export { contentHash } from './content-hash';
+export { KEYFRAMES_EXPORT_COLLISION, KEYFRAMES_EXTERNAL_ENTRY_FAILED, mergeExternalKeyframes, } from './external-keyframes';
+export type { ExternalKeyframesMerge } from './external-keyframes';
 export { discoverFiles } from './discover-files';
 export type { CollectedExternalPackages, ExternalPackageOutcome, } from './discover-packages';
 export { collectExternalPackageSources, extractSystemFilePackages, findPackageRoot, staleDistIncludesMessage, unresolvableIncludesMessage, } from './discover-packages';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../pipeline/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,eAAe,EACf,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EACV,eAAe,EACf,aAAa,EACb,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,sBAAsB,EACtB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../pipeline/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -121,6 +121,7 @@ function createV2EngineApi(deps) {
 		const native = loadNativeEngine();
 		return {
 			loadSystemModule: (...args) => native.loadSystemModule(...args),
+			scanKeyframesExports: (entryPath, rootDir) => native.scanKeyframesExports(entryPath, rootDir) ?? null,
 			analyzeProject: (filesJsonRaw, scalesJson, variableMapJson, contextualVarsJson, propConfigJson, groupRegistryJson, packageResolutionJson, devMode, emitterConfigJson, selectorAliasesJson, _selectorOrderJson, globalStyleBlocksJson, pathAliasesJson, keyframesJson, staticCssJson, conditionAliasesJson, externalDirsJson) => {
 				const filesJson = deps.rehydrateFilesJson ? deps.rehydrateFilesJson(filesJsonRaw) : filesJsonRaw;
 				const sent = /* @__PURE__ */ new Map();
@@ -212,6 +213,77 @@ function contentHash(source) {
 	return createHash("md5").update(source).digest("hex");
 }
 //#endregion
+//#region pipeline/external-keyframes.ts
+/** Stable codes for external keyframes discovery. */
+const KEYFRAMES_EXTERNAL_ENTRY_FAILED = "animus.keyframes.external-entry-failed";
+const KEYFRAMES_EXPORT_COLLISION = "animus.keyframes.export-collision";
+/**
+* Merge `Keyframes` collections discovered from external package entries into
+* the consumer system's collections. Keyframes are the sole carve-out from
+* the consumer-config singular-authority rule: nothing but branded
+* collections is read from an entry, an entry that fails to evaluate
+* degrades to a coded diagnostic naming it, and a collection whose export
+* name collides keeps the earlier (consumer-first) collection with a coded
+* diagnostic instead of silently reordering names.
+*/
+function mergeExternalKeyframes(scan, consumerKeyframesJson, externalEntries, rootDir) {
+	const merged = {};
+	if (consumerKeyframesJson) try {
+		Object.assign(merged, JSON.parse(consumerKeyframesJson));
+	} catch {
+		return {
+			keyframesJson: consumerKeyframesJson,
+			diagnostics: []
+		};
+	}
+	const diagnostics = [];
+	const seenEntries = /* @__PURE__ */ new Set();
+	for (const entryPath of externalEntries) {
+		if (seenEntries.has(entryPath)) continue;
+		seenEntries.add(entryPath);
+		let scanned;
+		try {
+			scanned = scan(entryPath, rootDir);
+		} catch (error) {
+			diagnostics.push({
+				file: entryPath,
+				component: "keyframes",
+				kind: "warn",
+				message: `external package entry failed the keyframes scan — its collections are invisible to extraction: ${String(error)}. Keyframe collections must be reachable from the package's definition entry without evaluating framework re-exports: export them (directly or as a named re-export) from the definition entry, and avoid \`export *\` of framework packages there (${KEYFRAMES_EXTERNAL_ENTRY_FAILED})`,
+				code: KEYFRAMES_EXTERNAL_ENTRY_FAILED,
+				severity: "warn"
+			});
+			continue;
+		}
+		if (!scanned) continue;
+		let collections;
+		try {
+			collections = JSON.parse(scanned);
+		} catch {
+			continue;
+		}
+		for (const [exportName, collection] of Object.entries(collections)) {
+			const existing = merged[exportName];
+			if (existing !== void 0) {
+				if (JSON.stringify(existing) !== JSON.stringify(collection)) diagnostics.push({
+					file: entryPath,
+					component: exportName,
+					kind: "warn",
+					message: `keyframes collection export '${exportName}' collides with an earlier collection of the same name — the earlier one wins (${KEYFRAMES_EXPORT_COLLISION})`,
+					code: KEYFRAMES_EXPORT_COLLISION,
+					severity: "warn"
+				});
+				continue;
+			}
+			merged[exportName] = collection;
+		}
+	}
+	return {
+		keyframesJson: Object.keys(merged).length > 0 ? JSON.stringify(merged) : null,
+		diagnostics
+	};
+}
+//#endregion
 //#region pipeline/discover-files.ts
 /**
 * Recursively discover source files under `dir`, skipping any path that
@@ -987,17 +1059,78 @@ function postProcessCss(css, opts) {
 }
 //#endregion
 //#region pipeline/manifest-diagnostics.ts
+/** Stable code for selector forms with no substitutable subject.
+*  Mirrors the Rust constant in `extract-v2/src/eval.rs`. */
+const SELECTOR_UNSUPPORTED_SUBJECT = "animus.selector.unsupported-subject";
+/** True when the selector string carries at least one substitutable `&`
+*  subject outside quoted text (mirrors the Rust `selector_subject` walk —
+*  ancestor, leading, and repeated subjects all count; a `&` inside a
+*  quoted attribute value does not). */
+function hasSelectorSubject(value) {
+	let quote = null;
+	for (const c of value) if (quote !== null) {
+		if (c === quote) quote = null;
+	} else if (c === "\"" || c === "'") quote = c;
+	else if (c === "&") return true;
+	return false;
+}
+/**
+* Synthesize coded diagnostics for registered selector-alias values that
+* look selector-shaped (`&` present) but carry no substitutable subject —
+* every `&` sits inside quoted text, so there is nothing to anchor the
+* class to. Ancestor-prefixed and repeated subjects are supported and pass
+* validation. The system-config boundary is where these must fail loud
+* (alias values never reach the evaluator's key guard).
+*/
+function collectSelectorAliasDiagnostics(selectorAliasesJson) {
+	if (!selectorAliasesJson) return [];
+	let aliases;
+	try {
+		aliases = JSON.parse(selectorAliasesJson);
+	} catch {
+		return [];
+	}
+	const diagnostics = [];
+	for (const [name, value] of Object.entries(aliases)) {
+		if (typeof value !== "string") continue;
+		if (value.includes("&") && !hasSelectorSubject(value)) diagnostics.push({
+			file: "system",
+			component: name,
+			kind: "warn",
+			message: `selector alias '${name}' value '${value}' has no substitutable '&' subject outside quoted text (${SELECTOR_UNSUPPORTED_SUBJECT})`,
+			code: SELECTOR_UNSUPPORTED_SUBJECT,
+			severity: "error"
+		});
+	}
+	return diagnostics;
+}
 /**
 * Surface extraction-manifest diagnostics through a plugin's warn channel.
 *
-* Single authoritative copy for both extraction plugins. Surfaces `bail`
-* (component not extracted), `skip` (component skipped), and `warn` kinds;
-* unknown kinds stay silent.
+* Single authoritative copy for both extraction plugins — and the single
+* strict-escalation policy point: error-severity diagnostics throw one
+* Error naming every offender when `policy.strict`, and print as warnings
+* otherwise. Surfaces `bail` (component not extracted), `skip` (component
+* skipped), and `warn` kinds; unknown kinds stay silent. Printed lines
+* include the diagnostic code when the message doesn't already carry it.
 */
-function surfaceManifestDiagnostics(manifest, warn) {
-	for (const diagnostic of manifest.diagnostics ?? []) if (diagnostic.kind === "bail") warn(`⚠ ${diagnostic.component} not extracted: ${diagnostic.message}`);
-	else if (diagnostic.kind === "skip") warn(`⚠ ${diagnostic.component}: skipped ${diagnostic.message}`);
-	else if (diagnostic.kind === "warn") warn(`⚠ ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`);
+function surfaceManifestDiagnostics(manifest, warn, policy = {}) {
+	const errors = [];
+	const diagnostics = policy.prepend?.length ? [...policy.prepend, ...manifest.diagnostics ?? []] : manifest.diagnostics ?? [];
+	for (const diagnostic of diagnostics) {
+		let line = null;
+		if (diagnostic.kind === "bail") line = `⚠ ${diagnostic.component} not extracted: ${diagnostic.message}`;
+		else if (diagnostic.kind === "skip") line = `⚠ ${diagnostic.component}: skipped ${diagnostic.message}`;
+		else if (diagnostic.kind === "warn") line = `⚠ ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`;
+		if (line === null) continue;
+		if (diagnostic.code && !diagnostic.message.includes(diagnostic.code)) line += ` [${diagnostic.code}]`;
+		if (policy.strict && diagnostic.severity === "error") {
+			errors.push(`${diagnostic.code ?? "error"} — ${diagnostic.component}: ${diagnostic.message}`);
+			continue;
+		}
+		warn(line);
+	}
+	if (errors.length > 0) throw new Error(`[animus] strict: ${errors.length} error diagnostic(s):\n${errors.join("\n")}`);
 }
 //#endregion
 //#region pipeline/unit-fallback.ts
@@ -1093,7 +1226,10 @@ function runProjectAnalysis(engineApi, opts) {
 	const extractMs = Math.round(performance.now() - t);
 	t = performance.now();
 	const manifest = JSON.parse(manifestJson);
-	surfaceManifestDiagnostics(manifest, opts.warn);
+	surfaceManifestDiagnostics(manifest, opts.warn, {
+		strict: opts.strict,
+		prepend: [...collectSelectorAliasDiagnostics(opts.system.selectorAliasesJson), ...opts.extraDiagnostics ?? []]
+	});
 	const parseMs = Math.round(performance.now() - t);
 	return {
 		manifest,
@@ -1559,4 +1695,4 @@ function realpathThroughNearestExistingAncestor(path) {
 	}
 }
 //#endregion
-export { ANIMUS_LAYERS, DEFAULT_EXTENSIONS, RETIRED_ENGINE_MESSAGE, applyPrefix, applyUnitFallback, assembleStylesheet, assertNoRetiredEngineSelection, buildAnalysisInputs, buildAnalyzeProjectArgs, buildDynamicPropConfig, buildPathAliasesJson, buildSystemPropsModule, camelToKebab, clearEngineCache, collectExternalPackageSources, contentHash, createV2EngineApi, discoverFiles, enforceExternalTokenContracts, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, formatRustTimingWaterfall, loadSystemConfig, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAssetFile, resolveLightningTargets, resolveThroughPathAliases, runProjectAnalysis, serializeStaticCss, staleDistIncludesMessage, stripLeadingLayerDeclaration, substituteAssetPlaceholders, surfaceManifestDiagnostics, toWatchKeys, unresolvableIncludesMessage, validateLayerOrder };
+export { ANIMUS_LAYERS, DEFAULT_EXTENSIONS, KEYFRAMES_EXPORT_COLLISION, KEYFRAMES_EXTERNAL_ENTRY_FAILED, RETIRED_ENGINE_MESSAGE, applyPrefix, applyUnitFallback, assembleStylesheet, assertNoRetiredEngineSelection, buildAnalysisInputs, buildAnalyzeProjectArgs, buildDynamicPropConfig, buildPathAliasesJson, buildSystemPropsModule, camelToKebab, clearEngineCache, collectExternalPackageSources, contentHash, createV2EngineApi, discoverFiles, enforceExternalTokenContracts, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, formatRustTimingWaterfall, loadSystemConfig, mergeExternalKeyframes, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAssetFile, resolveLightningTargets, resolveThroughPathAliases, runProjectAnalysis, serializeStaticCss, staleDistIncludesMessage, stripLeadingLayerDeclaration, substituteAssetPlaceholders, surfaceManifestDiagnostics, toWatchKeys, unresolvableIncludesMessage, validateLayerOrder };

package/dist/manifest-diagnostics.d.ts

@@ -6,15 +6,47 @@ export type ManifestDiagnostic = {
     /** Structured token path (`scale.key`) — present only on
      *  `external-token-candidate` diagnostics (cross-source correlation). */
     token?: string;
+    /** Stable diagnostic code (`animus.<namespace>.<slug>`). */
+    code?: string;
+    /** `"error"` fails strict builds at this policy point; `"warn"`/absent
+     *  never does. */
+    severity?: string;
 };
+/** Stable code for selector forms with no substitutable subject.
+ *  Mirrors the Rust constant in `extract-v2/src/eval.rs`. */
+export declare const SELECTOR_UNSUPPORTED_SUBJECT = "animus.selector.unsupported-subject";
+export interface DiagnosticPolicy {
+    /** When true, error-severity diagnostics throw instead of warning. */
+    strict?: boolean;
+    /** System-level diagnostics (e.g. selector-alias validation) surfaced
+     *  ahead of the manifest's own, through the same policy. */
+    prepend?: ManifestDiagnostic[];
+}
+/** True when the selector string carries at least one substitutable `&`
+ *  subject outside quoted text (mirrors the Rust `selector_subject` walk —
+ *  ancestor, leading, and repeated subjects all count; a `&` inside a
+ *  quoted attribute value does not). */
+export declare function hasSelectorSubject(value: string): boolean;
+/**
+ * Synthesize coded diagnostics for registered selector-alias values that
+ * look selector-shaped (`&` present) but carry no substitutable subject —
+ * every `&` sits inside quoted text, so there is nothing to anchor the
+ * class to. Ancestor-prefixed and repeated subjects are supported and pass
+ * validation. The system-config boundary is where these must fail loud
+ * (alias values never reach the evaluator's key guard).
+ */
+export declare function collectSelectorAliasDiagnostics(selectorAliasesJson: string | null | undefined): ManifestDiagnostic[];
 /**
  * Surface extraction-manifest diagnostics through a plugin's warn channel.
  *
- * Single authoritative copy for both extraction plugins. Surfaces `bail`
- * (component not extracted), `skip` (component skipped), and `warn` kinds;
- * unknown kinds stay silent.
+ * Single authoritative copy for both extraction plugins — and the single
+ * strict-escalation policy point: error-severity diagnostics throw one
+ * Error naming every offender when `policy.strict`, and print as warnings
+ * otherwise. Surfaces `bail` (component not extracted), `skip` (component
+ * skipped), and `warn` kinds; unknown kinds stay silent. Printed lines
+ * include the diagnostic code when the message doesn't already carry it.
  */
 export declare function surfaceManifestDiagnostics(manifest: {
     diagnostics?: ManifestDiagnostic[];
-}, warn: (message: string) => void): void;
+}, warn: (message: string) => void, policy?: DiagnosticPolicy): void;
 //# sourceMappingURL=manifest-diagnostics.d.ts.map

package/dist/manifest-diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-diagnostics.d.ts","sourceRoot":"","sources":["../pipeline/manifest-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;6EACyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE;IAAE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAE,EAChD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,IAAI,CAYN"}
+{"version":3,"file":"manifest-diagnostics.d.ts","sourceRoot":"","sources":["../pipeline/manifest-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;6EACyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;sBACkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;6DAC6D;AAC7D,eAAO,MAAM,4BAA4B,wCACF,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;gEAC4D;IAC5D,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;;wCAGwC;AACxC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYzD;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7C,kBAAkB,EAAE,CAuBtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE;IAAE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAE,EAChD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,MAAM,GAAE,gBAAqB,GAC5B,IAAI,CA+BN"}

package/dist/run-analysis.d.ts

@@ -42,6 +42,10 @@ export interface AnalysisOptions {
     /** rootDir-relative external package dirs (external-token candidates). */
     externalDirs?: string[];
     devMode: boolean;
+    /** System-level diagnostics gathered outside analysis (e.g. external
+     *  keyframes discovery) — surfaced through the single shared policy
+     *  point alongside the manifest's own. */
+    extraDiagnostics?: import('./manifest-diagnostics').ManifestDiagnostic[];
 }
 /**
  * Build the named `analyzeProject` input set from analysis options. Also
@@ -59,6 +63,7 @@ export declare function buildAnalysisInputs(opts: AnalysisOptions): AnalyzeProje
  */
 export declare function runProjectAnalysis(engineApi: () => any, opts: AnalysisOptions & {
     warn: (message: string) => void;
+    strict?: boolean;
 }): ProjectAnalysisResult;
 /**
  * Clear the engine's per-file analysis cache so stale results from a prior

package/dist/run-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-analysis.d.ts","sourceRoot":"","sources":["../pipeline/run-analysis.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,EAAE,GAAG,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB;6EACyE;IACzE,MAAM,EAAE,oBAAoB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,GACpB,oBAAoB,CAiCtB;AAQD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAEhC,SAAS,EAAE,MAAM,GAAG,EACpB,IAAI,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC1D,qBAAqB,CA0BvB;AAED;;;;GAIG;AAEH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,IAAI,CAQ3D"}
+{"version":3,"file":"run-analysis.d.ts","sourceRoot":"","sources":["../pipeline/run-analysis.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,EAAE,GAAG,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB;6EACyE;IACzE,MAAM,EAAE,oBAAoB,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB;;8CAE0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,wBAAwB,EAAE,kBAAkB,EAAE,CAAC;CAC1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,eAAe,GACpB,oBAAoB,CAiCtB;AAQD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAEhC,SAAS,EAAE,MAAM,GAAG,EACpB,IAAI,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5E,qBAAqB,CAgCvB;AAED;;;;GAIG;AAEH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,IAAI,CAQ3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/extract",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Animus static CSS extraction pipeline (Rust/NAPI)",
   "keywords": [
     "animus",
@@ -51,12 +51,12 @@
     "build:v2:debug": "cd crates/extract-v2 && bunx napi build --platform"
   },
   "dependencies": {
-    "@animus-ui/properties": "0.1.5",
+    "@animus-ui/properties": "0.1.7",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   },
   "devDependencies": {
-    "@animus-ui/system": "0.1.5",
+    "@animus-ui/system": "0.1.7",
     "@mdx-js/mdx": "3.1.1",
     "@napi-rs/cli": "^3.7.3"
   },