@animus-ui/vite-plugin 0.1.0-next.60 → 0.1.0-next.62

package/dist/index.d.ts

@@ -13,6 +13,14 @@ export interface AnimusExtractOptions {
     exclude?: string[];
     /** When true, extraction failures throw instead of warning. Use in CI to enforce full extraction. */
     strict?: boolean;
+    /**
+     * When true, run structural self-verification at the end of `buildStart`:
+     * component CSS non-empty, assembled layer ordering correct, `:root` block
+     * present in variable CSS, no unresolved `__TRANSFORM__` placeholders. Prefix
+     * output with `[animus:verify]`. Failures throw when `strict: true`,
+     * otherwise warn.
+     */
+    verify?: boolean;
     /** Enable verbose logging. Also activatable via ANIMUS_DEBUG=1 env var. */
     verbose?: boolean;
     /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA6ID,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA8+BnE;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA6ID,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAylCnE;AAED,eAAe,aAAa,CAAC"}

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 import { createHash } from "crypto";
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { dirname, extname, join, relative, resolve } from "path";
-import { applyUnitFallback, assembleStylesheet, extractSystemFilePackages, validateLayerOrder } from "@animus-ui/extract/pipeline";
+import { applyUnitFallback, assembleStylesheet, extractSystemFilePackages, stripLeadingLayerDeclaration, validateLayerOrder } from "@animus-ui/extract/pipeline";
 import browserslist from "browserslist";
 import { browserslistToTargets, transform } from "lightningcss";
 //#region \0rolldown/runtime.js
@@ -146,11 +146,13 @@ function animusExtract(options) {
 	let variableCss = "";
 	let globalCss = "";
 	let globalStyleBlocksJson = null;
+	let keyframesBlocksJson = null;
 	let pathAliasesJson = null;
 	let storedManifest = null;
 	let storedManifestJson = "";
 	let resolvedComponentCss = "";
 	let storedSheets = null;
+	let layerDeclaration = "";
 	let fragmentCache = /* @__PURE__ */ new Map();
 	let reverseProvenance = {};
 	let storedSystemPropMapJson = "{}";
@@ -183,6 +185,7 @@ function animusExtract(options) {
 			variableCss = config.variableCss;
 			contextualVarsJson = config.contextualVarsJson;
 			globalStyleBlocksJson = config.globalStyleBlocks || null;
+			keyframesBlocksJson = config.keyframesBlocks || null;
 		} catch (e) {
 			if (options.strict) throw new Error(`[animus-extract] Failed to load system from ${resolvedSystemPath}: ${e}`);
 			console.warn(`[animus-extract] Failed to load system from ${resolvedSystemPath}:`, e);
@@ -202,7 +205,7 @@ function animusExtract(options) {
 				runtime_import: "@animus-ui/system",
 				css_module_id: "virtual:animus/styles.css"
 			});
-			const manifestJson = analyzeProject(JSON.stringify(fileEntries), themeJson, variableMapJson, contextualVarsJson || null, configJson, groupRegistryJson, JSON.stringify(packageMap), !isProd, emitterConfig, selectorAliasesJson, selectorOrderJson, globalStyleBlocksJson, pathAliasesJson);
+			const manifestJson = analyzeProject(JSON.stringify(fileEntries), themeJson, variableMapJson, contextualVarsJson || null, configJson, groupRegistryJson, JSON.stringify(packageMap), !isProd, emitterConfig, selectorAliasesJson, selectorOrderJson, globalStyleBlocksJson, pathAliasesJson, keyframesBlocksJson);
 			storedManifest = JSON.parse(manifestJson);
 			storedManifestJson = manifestJson;
 			storedSystemPropMapJson = JSON.stringify(storedManifest?.system_prop_map ?? {});
@@ -236,6 +239,30 @@ function animusExtract(options) {
 			console.warn("[animus-extract] analyzeProject failed:", e);
 		}
 	}
+	function runSelfVerify() {
+		const failures = [];
+		if (resolvedComponentCss.trim().length === 0) failures.push("No component CSS produced — check system file and include patterns");
+		if (!variableCss.includes(":root")) failures.push("No :root variable block found in variable CSS");
+		if (`${variableCss}\n${globalCss}\n${resolvedComponentCss}`.includes("__TRANSFORM__")) failures.push("Unresolved __TRANSFORM__ placeholders found in CSS output");
+		if (storedManifest && resolvedComponentCss.length > 0) {
+			const assembled = assembleStylesheet({
+				layers: options.layers,
+				variableCss,
+				globalCss,
+				componentCss: resolvedComponentCss
+			});
+			const baseIdx = assembled.search(/@layer\s+anm-base\s*\{/);
+			const variantsIdx = assembled.search(/@layer\s+anm-variants\s*\{/);
+			if (baseIdx !== -1 && variantsIdx !== -1 && baseIdx >= variantsIdx) failures.push(`CSS layer ordering violated — @layer anm-base (offset ${baseIdx}) must precede @layer anm-variants (offset ${variantsIdx})`);
+		}
+		for (const message of failures) {
+			const line = `[animus:verify] ${message}`;
+			if (options.strict) throw new Error(line);
+			if (logger) logger.warn(line, { timestamp: true });
+			else console.warn(line);
+		}
+		if (failures.length === 0) log("[animus:verify] structural self-check passed");
+	}
 	return {
 		name: "animus-extract",
 		enforce: "pre",
@@ -402,6 +429,14 @@ function animusExtract(options) {
 					log(`Delivery: split mode — static ${staticSize} bytes, components ${componentSize} bytes (adopted stylesheet)`);
 				} else log("Delivery: single file mode (production)");
 			}
+			const { declaration } = assembleStylesheet({
+				layers: options.layers,
+				variableCss: "",
+				globalCss: "",
+				split: true
+			});
+			layerDeclaration = declaration;
+			if (options.verify) runSelfVerify();
 		},
 		resolveId(id) {
 			if (id === VIRTUAL_CSS_ID) return RESOLVED_CSS_ID;
@@ -419,22 +454,28 @@ function animusExtract(options) {
 				warnFn: warn
 			};
 			if (id === RESOLVED_CSS_ID) {
-				if (!isProd && storedSheets) return postProcessCss(assembleStylesheet({
-					layers: options.layers,
-					variableCss,
-					globalCss
-				}), {
-					...lcssOpts,
-					minify: false
-				});
-				return postProcessCss(assembleStylesheet({
+				if (!isProd && storedSheets) {
+					const { variables, body } = assembleStylesheet({
+						layers: options.layers,
+						variableCss,
+						globalCss,
+						split: true
+					});
+					return [variables, postProcessCss(body, {
+						...lcssOpts,
+						minify: false
+					})].filter(Boolean).join("\n");
+				}
+				const { variables, body } = assembleStylesheet({
 					layers: options.layers,
 					variableCss,
 					globalCss,
-					componentCss: resolvedComponentCss
-				}), lcssOpts);
+					componentCss: resolvedComponentCss,
+					split: true
+				});
+				return [variables, postProcessCss(body, lcssOpts)].filter(Boolean).join("\n");
 			}
-			if (id === RESOLVED_COMPONENTS_ID) return `export default \`${postProcessCss(resolvedComponentCss || "", {
+			if (id === RESOLVED_COMPONENTS_ID) return `export default \`${postProcessCss(stripLeadingLayerDeclaration(resolvedComponentCss || ""), {
 				...lcssOpts,
 				minify: false
 			}).replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$")}\`;`;
@@ -541,6 +582,18 @@ if (import.meta.hot) {
 				return null;
 			}
 		},
+		transformIndexHtml: {
+			order: "pre",
+			handler() {
+				if (!layerDeclaration) return [];
+				return [{
+					tag: "style",
+					attrs: { "data-animus-layers": "" },
+					children: layerDeclaration,
+					injectTo: "head-prepend"
+				}];
+			}
+		},
 		handleHotUpdate({ file, server: hmrServer, modules }) {
 			if (isProd) return;
 			const ext = extname(file);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.0-next.60",
+  "version": "0.1.0-next.62",
   "description": "Animus static CSS extraction Vite plugin",
   "author": "codecaaron <airrobb@gmail.com>",
   "license": "MIT",
@@ -37,8 +37,8 @@
     "vite": ">=5.0.0"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.0-next.60",
-    "@animus-ui/system": "0.1.0-next.60",
+    "@animus-ui/extract": "0.1.0-next.62",
+    "@animus-ui/system": "0.1.0-next.62",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   }