@animus-ui/vite-plugin 0.1.0-next.38 → 0.1.0-next.40

package/README.md

@@ -0,0 +1,44 @@
+# @animus-ui/vite-plugin
+
+Static CSS extraction plugin for Vite. Transforms `@animus-ui/system` builder chains into static CSS at build time — zero runtime style injection.
+
+## Install
+
+```bash
+npm install @animus-ui/vite-plugin @animus-ui/system
+```
+
+## Setup
+
+```tsx
+// vite.config.ts
+import react from '@vitejs/plugin-react';
+import { animusExtract } from '@animus-ui/vite-plugin';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [
+    react(),
+    animusExtract({ system: './src/ds.ts' }),
+  ],
+});
+```
+
+The `system` option points to the file that exports your built system instance. The plugin loads this file in a subprocess to serialize the prop config and theme data for the Rust extraction pipeline.
+
+## What It Does
+
+1. **Build time**: Analyzes all files importing from `@animus-ui/system`, extracts static styles into CSS with `@layer` ordering
+2. **Dev server**: Runs extraction on startup, holds results in memory, serves CSS via virtual module
+3. **Transforms**: Resolves `__TRANSFORM__` placeholders using your system's named transform functions
+4. **Global styles**: Emits global styles (reset, base) from your exported `createGlobalStyles()` configuration
+
+## Important
+
+- Do **not** add React resolve aliases to `vite.config.ts` — they break the extraction transform pipeline
+- After system config changes, restart the dev server (the subprocess runs at `buildStart`)
+- Run `bun run clean:light` if styles seem stale (clears `.vite` cache)
+
+## License
+
+MIT

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAI3C,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;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA6ID,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAo+BnE;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAI3C,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;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA6ID,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA4+BnE;AAED,eAAe,aAAa,CAAC"}

package/dist/index.mjs

@@ -113,6 +113,8 @@ function animusExtract(options) {
 	let contextualVarsJson = "{}";
 	let configJson = "{}";
 	let groupRegistryJson = "{}";
+	let selectorAliasesJson = null;
+	let selectorOrderJson = null;
 	let isProd = false;
 	let rootDir = "";
 	const verbose = options.verbose || process.env.ANIMUS_DEBUG === "1" || process.env.ANIMUS_DEBUG === "true";
@@ -150,7 +152,7 @@ function animusExtract(options) {
 		try {
 			const ts = Date.now();
 			const tmpOut = join(tmpdir(), `animus-system-${ts}.json`);
-			execSubprocess(`const m = require(${JSON.stringify(resolvedSystemPath)});\nconst exportNames = Object.keys(m);\nconst candidates = exportNames.filter(k => m[k] && typeof m[k].toConfig === 'function');\nif (candidates.length === 0) {\n  throw new Error('[animus-extract] No SystemInstance found. Exports: [' + exportNames.join(', ') + ']. None have a .toConfig() method. A SystemInstance is created by: export const ds = createSystem().build()');\n}\nif (candidates.length > 1) {\n  throw new Error('[animus-extract] Multiple SystemInstance candidates found: [' + candidates.join(', ') + ']. Specify which one to use.');\n}\nconst ds = m[candidates[0]];\nconst cfg = ds.toConfig();\nconst tokens = m.tokens || m.theme || null;\nconst serialized = tokens && typeof tokens.serialize === 'function' ? tokens.serialize() : null;\nconst globalStyleBlocks = {};\nfor (const [key, val] of Object.entries(m)) {\n  if (val && typeof val === 'object' && val.__brand === 'GlobalStyleBlock') {\n    globalStyleBlocks[key] = val.styles;\n  }\n}\nrequire('fs').writeFileSync(${JSON.stringify(tmpOut)}, JSON.stringify({\n  propConfig: cfg.propConfig,\n  groupRegistry: cfg.groupRegistry,\n  serialized: serialized,\n  transformNames: Object.keys(cfg.transforms || {}),\n  globalStyleBlocks: Object.keys(globalStyleBlocks).length > 0 ? globalStyleBlocks : null\n}));\n`, rootDir);
+			execSubprocess(`const m = require(${JSON.stringify(resolvedSystemPath)});\nconst exportNames = Object.keys(m);\nconst candidates = exportNames.filter(k => m[k] && typeof m[k].toConfig === 'function');\nif (candidates.length === 0) {\n  throw new Error('[animus-extract] No SystemInstance found. Exports: [' + exportNames.join(', ') + ']. None have a .toConfig() method. A SystemInstance is created by: export const ds = createSystem().build()');\n}\nif (candidates.length > 1) {\n  throw new Error('[animus-extract] Multiple SystemInstance candidates found: [' + candidates.join(', ') + ']. Specify which one to use.');\n}\nconst ds = m[candidates[0]];\nconst cfg = ds.toConfig();\nconst tokens = m.tokens || m.theme || null;\nconst serialized = tokens && typeof tokens.serialize === 'function' ? tokens.serialize() : null;\nconst globalStyleBlocks = {};\nfor (const [key, val] of Object.entries(m)) {\n  if (val && typeof val === 'object' && val.__brand === 'GlobalStyleBlock') {\n    globalStyleBlocks[key] = val.styles;\n  }\n}\nrequire('fs').writeFileSync(${JSON.stringify(tmpOut)}, JSON.stringify({\n  propConfig: cfg.propConfig,\n  groupRegistry: cfg.groupRegistry,\n  serialized: serialized,\n  transformNames: Object.keys(cfg.transforms || {}),\n  selectorAliases: cfg.selectorAliases || null,\n  selectorOrder: cfg.selectorOrder || null,\n  globalStyleBlocks: Object.keys(globalStyleBlocks).length > 0 ? globalStyleBlocks : null\n}));\n`, rootDir);
 			const result = readFileSync(tmpOut, "utf-8");
 			try {
 				unlinkSync(tmpOut);
@@ -158,6 +160,8 @@ function animusExtract(options) {
 			const parsed = JSON.parse(result);
 			configJson = parsed.propConfig;
 			groupRegistryJson = parsed.groupRegistry;
+			selectorAliasesJson = parsed.selectorAliases || null;
+			selectorOrderJson = parsed.selectorOrder || null;
 			if (parsed.serialized) {
 				themeJson = parsed.serialized.scalesJson;
 				variableMapJson = parsed.serialized.variableMapJson;
@@ -233,7 +237,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, options.prefix || null, emitterConfig);
+			const manifestJson = analyzeProject(JSON.stringify(fileEntries), themeJson, variableMapJson, contextualVarsJson || null, configJson, groupRegistryJson, JSON.stringify(packageMap), !isProd, options.prefix || null, emitterConfig, selectorAliasesJson, selectorOrderJson);
 			storedManifest = JSON.parse(manifestJson);
 			storedManifestJson = manifestJson;
 			storedSystemPropMapJson = JSON.stringify(storedManifest?.system_prop_map ?? {});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.0-next.38",
+  "version": "0.1.0-next.40",
   "description": "Animus static CSS extraction Vite plugin",
   "author": "codecaaron <airrobb@gmail.com>",
   "license": "MIT",
@@ -13,10 +13,21 @@
   "publishConfig": {
     "access": "public"
   },
+  "homepage": "https://github.com/codecaaron/animus/tree/main/packages/vite-plugin#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/codecaaron/animus"
+    "url": "git+https://github.com/codecaaron/animus",
+    "directory": "packages/vite-plugin"
   },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "css",
+    "css-in-js",
+    "zero-runtime",
+    "styled",
+    "animus"
+  ],
   "scripts": {
     "build": "bun run build:ts",
     "build:ts": "tsdown && tsc -p tsconfig.build.json",
@@ -26,8 +37,8 @@
     "vite": ">=5.0.0"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.0-next.38",
-    "@animus-ui/system": "0.1.0-next.38",
+    "@animus-ui/extract": "0.1.0-next.40",
+    "@animus-ui/system": "0.1.0-next.40",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   }