@animus-ui/extract 0.1.0-next.44 → 0.1.0-next.48

package/dist/assemble-stylesheet.d.ts

@@ -1,7 +1,8 @@
 /**
- * The 7 Animus cascade layers in required order.
+ * The 7 Animus cascade layers. Always prefixed with `anm-` to avoid
+ * collision with other frameworks' layer names (e.g., Tailwind's `base`).
  */
-export declare const ANIMUS_LAYERS: readonly ["global", "base", "variants", "compounds", "states", "system", "custom"];
+export declare const ANIMUS_LAYERS: readonly ["anm-global", "anm-base", "anm-variants", "anm-compounds", "anm-states", "anm-system", "anm-custom"];
 /**
  * Validate that a consumer `layers` array contains all 7 Animus layers
  * in the correct relative order. Consumer layers may be interleaved.
@@ -10,11 +11,15 @@ export declare const ANIMUS_LAYERS: readonly ["global", "base", "variants", "com
  */
 export declare function validateLayerOrder(layers: string[]): void;
 export interface AssembleStylesheetOptions {
-    /** Custom layer order. Must contain all 7 Animus layers as a subsequence. */
+    /**
+     * Custom layer order. Must contain all 7 Animus `anm-*` layers as a subsequence.
+     * Example: `['reset', 'anm-global', 'anm-base', ..., 'anm-custom', 'overrides']`
+     * Names are emitted as-is — this is the actual `@layer` declaration.
+     */
     layers?: string[];
     /** Variable CSS: `:root { --color-*: ... }` + color mode selectors */
     variableCss?: string;
-    /** Global CSS: `@layer global { reset + global styles }` */
+    /** Global CSS: `@layer anm-global { reset + global styles }` */
     globalCss?: string;
     /** Component CSS from the Rust crate (may contain embedded @layer declaration) */
     componentCss?: string;
@@ -24,8 +29,8 @@ export interface AssembleStylesheetOptions {
  *
  * 1. `@layer` declaration (cascade ordering)
  * 2. Emitted variables (`:root`, color mode selectors)
- * 3. `@layer global { ... }` (reset + global styles)
- * 4. `@layer base/variants/compounds/states/system/custom { ... }` (components)
+ * 3. `@layer anm-global { ... }` (reset + global styles)
+ * 4. `@layer anm-base/variants/compounds/states/system/custom { ... }` (components)
  *
  * This is the single source of truth for stylesheet assembly.
  * Both Vite and Next.js plugins must use this function.

package/dist/assemble-stylesheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble-stylesheet.d.ts","sourceRoot":"","sources":["../pipeline/assemble-stylesheet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,aAAa,oFAQhB,CAAC;AAIX;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAyBzD;AAYD,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAsB7E"}
+{"version":3,"file":"assemble-stylesheet.d.ts","sourceRoot":"","sources":["../pipeline/assemble-stylesheet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa,gHAQhB,CAAC;AAiBX;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BzD;AAYD,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAqB7E"}

package/dist/index.mjs

@@ -7,18 +7,28 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
 //#region pipeline/assemble-stylesheet.ts
 /**
-* The 7 Animus cascade layers in required order.
+* The 7 Animus cascade layers. Always prefixed with `anm-` to avoid
+* collision with other frameworks' layer names (e.g., Tailwind's `base`).
 */
 const ANIMUS_LAYERS = [
-	"global",
-	"base",
-	"variants",
-	"compounds",
-	"states",
-	"system",
-	"custom"
+	"anm-global",
+	"anm-base",
+	"anm-variants",
+	"anm-compounds",
+	"anm-states",
+	"anm-system",
+	"anm-custom"
 ];
-const DEFAULT_LAYER_DECLARATION = `@layer ${ANIMUS_LAYERS.join(", ")};\n`;
+/**
+* Build the `@layer` declaration line.
+*
+* When `isCustom` is false (default layers), uses ANIMUS_LAYERS directly.
+* When `isCustom` is true, passes names through as-is — the consumer already
+* wrote the final names including the `anm-` prefixed entries.
+*/
+function buildLayerDeclaration(layers, isCustom) {
+	return `@layer ${(isCustom ? layers : [...ANIMUS_LAYERS]).join(", ")};\n`;
+}
 /**
 * Validate that a consumer `layers` array contains all 7 Animus layers
 * in the correct relative order. Consumer layers may be interleaved.
@@ -26,16 +36,17 @@ const DEFAULT_LAYER_DECLARATION = `@layer ${ANIMUS_LAYERS.join(", ")};\n`;
 * @throws Error with descriptive message on violation
 */
 function validateLayerOrder(layers) {
+	const expected = [...ANIMUS_LAYERS];
 	let cursor = 0;
-	for (const layer of layers) if (cursor < ANIMUS_LAYERS.length && layer === ANIMUS_LAYERS[cursor]) cursor++;
-	if (cursor < ANIMUS_LAYERS.length) {
-		const missing = ANIMUS_LAYERS.slice(cursor);
-		const found = ANIMUS_LAYERS.slice(0, cursor);
-		if (!ANIMUS_LAYERS.every((l) => layers.includes(l))) {
-			const absent = ANIMUS_LAYERS.filter((l) => !layers.includes(l));
-			throw new Error(`[animus-extract] Custom layers missing required layers: ${absent.join(", ")}. All 7 Animus layers must be present: ${ANIMUS_LAYERS.join(", ")}`);
+	for (const layer of layers) if (cursor < expected.length && layer === expected[cursor]) cursor++;
+	if (cursor < expected.length) {
+		const missing = expected.slice(cursor);
+		const found = expected.slice(0, cursor);
+		if (!expected.every((l) => layers.includes(l))) {
+			const absent = expected.filter((l) => !layers.includes(l));
+			throw new Error(`[animus-extract] Custom layers missing required layers: ${absent.join(", ")}. All 7 Animus layers must be present: ${expected.join(", ")}`);
 		}
-		throw new Error(`[animus-extract] Custom layers have wrong order. Found ${found.join(", ")} but then expected ${missing[0]}. Required order: (${ANIMUS_LAYERS.join(" < ")}). You may interleave custom layers but must preserve this subsequence.`);
+		throw new Error(`[animus-extract] Custom layers have wrong order. Found ${found.join(", ")} but then expected ${missing[0]}. Required order: (${expected.join(" < ")}). You may interleave custom layers but must preserve this subsequence.`);
 	}
 }
 /**
@@ -51,18 +62,17 @@ function stripLeadingLayerDeclaration(css) {
 *
 * 1. `@layer` declaration (cascade ordering)
 * 2. Emitted variables (`:root`, color mode selectors)
-* 3. `@layer global { ... }` (reset + global styles)
-* 4. `@layer base/variants/compounds/states/system/custom { ... }` (components)
+* 3. `@layer anm-global { ... }` (reset + global styles)
+* 4. `@layer anm-base/variants/compounds/states/system/custom { ... }` (components)
 *
 * This is the single source of truth for stylesheet assembly.
 * Both Vite and Next.js plugins must use this function.
 */
 function assembleStylesheet(options) {
-	let layerDeclaration;
-	if (options.layers) {
-		validateLayerOrder(options.layers);
-		layerDeclaration = `@layer ${options.layers.join(", ")};\n`;
-	} else layerDeclaration = DEFAULT_LAYER_DECLARATION;
+	const hasCustomLayers = !!options.layers;
+	const layers = options.layers ?? ANIMUS_LAYERS;
+	if (options.layers) validateLayerOrder(options.layers);
+	const layerDeclaration = buildLayerDeclaration(layers, hasCustomLayers);
 	const componentCss = options.componentCss ? stripLeadingLayerDeclaration(options.componentCss) : "";
 	return [
 		layerDeclaration,

package/index.d.ts

@@ -16,7 +16,7 @@
  *   Overrides hardcoded import paths in generated source. When `None`, defaults to
  *   `@animus-ui/system` and `virtual:animus/styles.css`.
  */
-export declare function analyzeProject(fileEntriesJson: string, themeJson: string, variableMapJson: string, contextualVarsJson: string | undefined | null, configJson: string, groupRegistryJson: string, packageResolutionJson: string, devMode?: boolean | undefined | null, prefix?: string | undefined | null, emitterConfigJson?: string | undefined | null, selectorAliasesJson?: string | undefined | null, selectorOrderJson?: string | undefined | null): string
+export declare function analyzeProject(fileEntriesJson: string, themeJson: string, variableMapJson: string, contextualVarsJson: string | undefined | null, configJson: string, groupRegistryJson: string, packageResolutionJson: string, devMode?: boolean | undefined | null, emitterConfigJson?: string | undefined | null, selectorAliasesJson?: string | undefined | null, selectorOrderJson?: string | undefined | null): string
 
 /**
  * Clear the per-file extraction cache used by `analyze_project()`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/extract",
-  "version": "0.1.0-next.44",
+  "version": "0.1.0-next.48",
   "description": "Animus static CSS extraction pipeline (Rust/NAPI)",
   "author": "codecaaron <airrobb@gmail.com>",
   "license": "MIT",
@@ -58,12 +58,12 @@
     "compile": "tsc -p tsconfig.build.json --noEmit"
   },
   "optionalDependencies": {
-    "@animus-ui/extract-darwin-arm64": "0.1.0-next.44",
-    "@animus-ui/extract-linux-x64-gnu": "0.1.0-next.44",
-    "@animus-ui/extract-linux-arm64-gnu": "0.1.0-next.44"
+    "@animus-ui/extract-darwin-arm64": "0.1.0-next.48",
+    "@animus-ui/extract-linux-x64-gnu": "0.1.0-next.48",
+    "@animus-ui/extract-linux-arm64-gnu": "0.1.0-next.48"
   },
   "dependencies": {
-    "@animus-ui/properties": "0.1.0-next.44"
+    "@animus-ui/properties": "0.1.0-next.48"
   },
   "devDependencies": {
     "@animus-ui/system": "workspace:*",