@animus-ui/extract 0.1.0-next.40 → 0.1.0-next.45

package/dist/assemble-stylesheet.d.ts

@@ -2,16 +2,32 @@
  * The 7 Animus cascade layers in required order.
  */
 export declare const ANIMUS_LAYERS: readonly ["global", "base", "variants", "compounds", "states", "system", "custom"];
+/**
+ * Prefix a layer name with dot-notation sublayer syntax.
+ * Only Animus layer names are prefixed; consumer layer names pass through.
+ */
+export declare function prefixLayerName(name: string, prefix?: string): string;
 /**
  * Validate that a consumer `layers` array contains all 7 Animus layers
  * in the correct relative order. Consumer layers may be interleaved.
  *
+ * When `prefix` is set, the expected Animus layer names are `{prefix}.{name}`
+ * (e.g. `acme.base`). This lets consumers write the actual CSS layer names
+ * in their config — important when composing with other frameworks that have
+ * their own `@layer base` etc.
+ *
  * @throws Error with descriptive message on violation
  */
-export declare function validateLayerOrder(layers: string[]): void;
+export declare function validateLayerOrder(layers: string[], prefix?: 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 layers as a subsequence.
+     * When `prefix` is set, use prefixed names: `['reset', 'acme.global', 'acme.base', ...]`.
+     * Names are emitted as-is — this is the actual `@layer` declaration.
+     */
     layers?: string[];
+    /** Namespace prefix — Animus layer names become `{prefix}.{name}` sublayers. */
+    prefix?: string;
     /** Variable CSS: `:root { --color-*: ... }` + color mode selectors */
     variableCss?: string;
     /** Global CSS: `@layer global { reset + global styles }` */

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;;GAEG;AACH,eAAO,MAAM,aAAa,oFAQhB,CAAC;AAIX;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrE;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CA2BN;AAYD,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,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,CAyB7E"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { AssembleStylesheetOptions } from './assemble-stylesheet';
-export { ANIMUS_LAYERS, assembleStylesheet, validateLayerOrder, } from './assemble-stylesheet';
+export { ANIMUS_LAYERS, assembleStylesheet, prefixLayerName, validateLayerOrder, } from './assemble-stylesheet';
 export { extractSystemFilePackages } from './discover-packages';
 export { applyPrefix } from './prefix';
 export { resolveGlobalStyles, resolveTokenAliases, resolveValue, } from './resolve-global-styles';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../pipeline/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../pipeline/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.mjs

@@ -18,24 +18,48 @@ const ANIMUS_LAYERS = [
 	"system",
 	"custom"
 ];
-const DEFAULT_LAYER_DECLARATION = `@layer ${ANIMUS_LAYERS.join(", ")};\n`;
+const ANIMUS_LAYER_SET = new Set(ANIMUS_LAYERS);
+/**
+* Prefix a layer name with dot-notation sublayer syntax.
+* Only Animus layer names are prefixed; consumer layer names pass through.
+*/
+function prefixLayerName(name, prefix) {
+	if (!prefix || !ANIMUS_LAYER_SET.has(name)) return name;
+	return `${prefix}.${name}`;
+}
+/**
+* Build the `@layer` declaration line.
+*
+* When `isCustom` is false (default layers), applies prefix to Animus names.
+* When `isCustom` is true, passes names through as-is — the consumer already
+* wrote the final names including any `{prefix}.{name}` entries.
+*/
+function buildLayerDeclaration(layers, prefix, isCustom) {
+	return `@layer ${(isCustom ? layers : layers.map((l) => prefixLayerName(l, prefix))).join(", ")};\n`;
+}
 /**
 * Validate that a consumer `layers` array contains all 7 Animus layers
 * in the correct relative order. Consumer layers may be interleaved.
 *
+* When `prefix` is set, the expected Animus layer names are `{prefix}.{name}`
+* (e.g. `acme.base`). This lets consumers write the actual CSS layer names
+* in their config — important when composing with other frameworks that have
+* their own `@layer base` etc.
+*
 * @throws Error with descriptive message on violation
 */
-function validateLayerOrder(layers) {
+function validateLayerOrder(layers, prefix) {
+	const expected = ANIMUS_LAYERS.map((l) => prefixLayerName(l, prefix));
 	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.`);
 	}
 }
 /**
@@ -58,11 +82,10 @@ function stripLeadingLayerDeclaration(css) {
 * 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, options.prefix);
+	const layerDeclaration = buildLayerDeclaration(layers, options.prefix, hasCustomLayers);
 	const componentCss = options.componentCss ? stripLeadingLayerDeclaration(options.componentCss) : "";
 	return [
 		layerDeclaration,
@@ -358,4 +381,4 @@ function applyUnitFallback(css) {
 	});
 }
 //#endregion
-export { ANIMUS_LAYERS, applyPrefix, applyUnitFallback, assembleStylesheet, camelToKebab, detectRuntime, execSubprocess, extractSystemFilePackages, resolveGlobalStyles, resolveTokenAliases, resolveTransformPlaceholders, resolveValue, validateLayerOrder };
+export { ANIMUS_LAYERS, applyPrefix, applyUnitFallback, assembleStylesheet, camelToKebab, detectRuntime, execSubprocess, extractSystemFilePackages, prefixLayerName, resolveGlobalStyles, resolveTokenAliases, resolveTransformPlaceholders, resolveValue, validateLayerOrder };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/extract",
-  "version": "0.1.0-next.40",
+  "version": "0.1.0-next.45",
   "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.40",
-    "@animus-ui/extract-linux-x64-gnu": "0.1.0-next.40",
-    "@animus-ui/extract-linux-arm64-gnu": "0.1.0-next.40"
+    "@animus-ui/extract-darwin-arm64": "0.1.0-next.45",
+    "@animus-ui/extract-linux-x64-gnu": "0.1.0-next.45",
+    "@animus-ui/extract-linux-arm64-gnu": "0.1.0-next.45"
   },
   "dependencies": {
-    "@animus-ui/properties": "0.1.0-next.40"
+    "@animus-ui/properties": "0.1.0-next.45"
   },
   "devDependencies": {
     "@animus-ui/system": "workspace:*",