@animus-ui/vite-plugin 0.1.0-next.v7 → 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @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

@@ -1,60 +1,61 @@
 import type { Plugin } from 'vite';
 export interface AnimusExtractOptions {
-    /**
-     * Theme data for the extraction pipeline.
-     *
-     * Two forms are accepted:
-     *   - `string` — pre-serialized flat JSON (legacy; no CSS variable emission)
-     *   - `{ scales: string; variables: string }` — pre-evaluated scales JSON
-     *     plus fully-formed CSS variable declarations to prepend to the virtual
-     *     stylesheet.  The caller is responsible for evaluating the theme module
-     *     (e.g. via `evaluateTheme` or a Bun subprocess) before passing it here.
-     *
-     * When omitted, the plugin auto-detects `src/theme.ts`, `src/theme.js`,
-     * `theme.ts`, or `theme.js` relative to the project root.
-     */
-    theme?: string | {
-        scales: string;
-        variables: string;
-    };
-    /**
-     * Explicit path to the theme module (relative to project root or absolute).
-     * Takes precedence over auto-detection, but lower priority than `theme`.
-     */
-    themePath?: string;
     /**
      * Path to a module exporting a SystemInstance from `@animus-ui/system`.
-     * The module is loaded via a single bun subprocess at build start.
-     * Replaces configPath + themePath when using the system package.
+     * The module is loaded via Rust NAPI (OXC + rquickjs) at build start.
+     * It provides prop config, group registry, theme tokens, selector aliases,
+     * and global styles — everything the extraction pipeline needs.
      */
-    system?: string;
-    /**
-     * Path to a module exporting `getExtractConfig()`. The module is loaded via
-     * bun subprocess at build start. Use this for custom Animus instances created
-     * with `createAnimus().addGroup(...).build()`.
-     *
-     * When omitted, automatically imported from `@animus-ui/core`.
-     */
-    configPath?: string;
-    /**
-     * Pre-serialized prop config JSON. When omitted, automatically imported from
-     * `@animus-ui/core` via `getExtractConfig()`.
-     */
-    config?: string;
-    /** Pre-serialized group registry JSON. Maps group names to prop name arrays. */
-    groupRegistry?: string;
+    system: string;
     /** Glob patterns to include. Defaults to .ts/.tsx/.js/.jsx files. */
     include?: string[];
     /** Glob patterns to exclude. */
     exclude?: string[];
-    /** Package name patterns to resolve and include in analysis. Defaults to ['@animus-ui/*']. */
-    packagePatterns?: string[];
+    /**
+     * File extensions to scan for component definitions and JSX usages.
+     * Replaces the default list entirely (not additive). Include `.mdx` to
+     * extract components rendered from MDX files — `@mdx-js/mdx` must be
+     * installed as a peer for MDX files to be preprocessed; otherwise the
+     * plugin warns once at buildStart and skips them.
+     *
+     * @default ['.ts', '.tsx', '.js', '.jsx', '.mdx']
+     */
+    extensions?: 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;
+    /**
+     * Browser targets for CSS autoprefixing and syntax lowering.
+     * Accepts a browserslist query string or array of queries.
+     * Falls back to project's browserslist config, then to `defaults`.
+     */
+    targets?: string | string[];
+    /**
+     * Control CSS minification.
+     * - `true`: always minify (dev + prod)
+     * - `false`: never minify (autoprefixing still applies)
+     * - `undefined` (default): minify in prod only
+     */
+    minify?: boolean;
+    /**
+     * Full `@layer` declaration order. Must include all 7 Animus `anm-*` layers
+     * as a subsequence in their required order. Consumer layers may be
+     * interleaved around them. Names are emitted as-is.
+     *
+     * Example: `['reset', 'anm-global', 'anm-base', ..., 'anm-custom', 'overrides']`
+     */
+    layers?: string[];
 }
-export declare function animusExtract(options?: AnimusExtractOptions): Plugin;
-export { evaluateTheme, evaluateThemeObject } from './theme-evaluator';
+export declare function discoverFiles(dir: string, rootDir: string, excludePatterns: string[], extensionsSet: ReadonlySet<string>): string[];
+export declare function animusExtract(options: AnimusExtractOptions): Plugin;
 export default animusExtract;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAM3C,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA0RD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAq5BxE;AAED,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,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;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,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;AAgBD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,GACjC,MAAM,EAAE,CAqCV;AAqFD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA2rCnE;eAEc,aAAa"}