@animus-ui/vite-plugin 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,4 +1,6 @@
+import type { StaticCssConfig } from '@animus-ui/extract/pipeline';
 import type { Plugin } from 'vite';
+export { discoverFiles } from '@animus-ui/extract/pipeline';
 export interface AnimusExtractOptions {
     /**
      * Path to a module exporting a SystemInstance from `@animus-ui/system`.
@@ -7,8 +9,6 @@ export interface AnimusExtractOptions {
      * and global styles — everything the extraction pipeline needs.
      */
     system: string;
-    /** Glob patterns to include. Defaults to .ts/.tsx/.js/.jsx files. */
-    include?: string[];
     /** Glob patterns to exclude. */
     exclude?: string[];
     /**
@@ -46,6 +46,19 @@ export interface AnimusExtractOptions {
      * - `undefined` (default): minify in prod only
      */
     minify?: boolean;
+    /**
+     * Namespace prefix for CSS variables and class names, applied to the
+     * variable map/css (and theme + contextual vars) at system load.
+     */
+    prefix?: string;
+    /**
+     * Forced-emission declarations for usage the scanner cannot observe
+     * (CMS-driven variants, spread-hidden props, dynamically selected
+     * components). Declared variants/states/system-prop values and custom
+     * dynamic slots are emitted as if used; entries are labeled as forced
+     * in the extraction report. Empty/absent is a no-op.
+     */
+    staticCss?: StaticCssConfig;
     /**
      * Full `@layer` declaration order. Must include all 7 Animus `anm-*` layers
      * as a subsequence in their required order. Consumer layers may be
@@ -55,16 +68,50 @@ export interface AnimusExtractOptions {
      */
     layers?: string[];
     /**
-     * Extraction engine selection. `'v2'` (default) is the production
-     * engine — parity-proven against v1 with 8× fewer parses and no cache
-     * machinery. `'v1'` remains selectable and functional as the escape
-     * hatch until v1 retires.
+     * Extraction engine selection. `'v2'` is the only engine and the default.
+     * The v1 engine was retired (openspec: retire-extract-v1); configuring
+     * `engine: 'v1'` (or setting `ANIMUS_ENGINE=v1`) throws — the selection is
+     * never silently upgraded.
      *
      * @default 'v2'
      */
-    engine?: 'v1' | 'v2';
+    engine?: 'v2';
+    /**
+     * Pre-generated appearance bootstrap artifact — DELIVERY ONLY.
+     *
+     * When set, the plugin injects `code` verbatim as an inline
+     * `<script data-animus-bootstrap>` at the start of `<head>` in built HTML
+     * (in dev, Vite's own client script precedes it); always ahead of every
+     * stylesheet reference. When absent — or when `code` is empty — no
+     * bootstrap script is emitted and the built HTML is unchanged.
+     *
+     * The plugin performs NO generation and interprets NO appearance semantics:
+     * produce the artifact in your Vite config with `createAppearanceBootstrap`
+     * from `@animus-ui/system/bootstrap` (a build-time-only subpath) and pass the
+     * result through. The shape is declared structurally here so the plugin never
+     * imports the generator.
+     *
+     * `cspHash` is carried for the application's own `script-src` policy — the
+     * plugin does not read it. Serve it single-quoted, exactly as returned.
+     *
+     * @example
+     * ```ts
+     * import { createAppearanceBootstrap } from '@animus-ui/system/bootstrap';
+     * import { theme } from './src/ds';
+     *
+     * animusExtract({ system: './src/ds.ts', appearanceBootstrap: createAppearanceBootstrap(theme) })
+     * ```
+     */
+    appearanceBootstrap?: {
+        code: string;
+        cspHash: string;
+    };
 }
-export declare function discoverFiles(dir: string, rootDir: string, excludePatterns: string[], extensionsSet: ReadonlySet<string>): string[];
+/**
+ * Vite adapter for the extraction pipeline. State and pipeline operations
+ * live in PluginContext; hook bodies live in their own modules — this
+ * factory only validates options and wires Vite hooks to those functions.
+ */
 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":"AAsBA,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;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB;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,CAgzCnE;eAEc,aAAa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,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;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA0DnE;eAEc,aAAa"}

package/dist/reset-coalescer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Coalesces bursts of system-dependency events into single geological
+ * resets: a quiescence window before starting, at most one reset in
+ * flight, and exactly one follow-up when requests arrive mid-reset. A
+ * package build regenerating its dist fires one reset, not one per file.
+ *
+ * Timer functions are injected seams — `vi.mock` on node builtins silently
+ * no-ops under vite-plus-test, so tests drive a manual scheduler instead.
+ */
+export declare class ResetCoalescer {
+    private readonly run;
+    private readonly quietMs;
+    private readonly schedule;
+    private readonly cancel;
+    private timer;
+    private running;
+    private dirty;
+    constructor(run: () => void, quietMs?: number, schedule?: (fn: () => void, ms: number) => unknown, cancel?: (timer: unknown) => void);
+    /** Ask for a reset; bursts within the quiescence window collapse. */
+    request(): void;
+}
+//# sourceMappingURL=reset-coalescer.d.ts.map

package/dist/reset-coalescer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-coalescer.d.ts","sourceRoot":"","sources":["../src/reset-coalescer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAIzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IAEtB,YACmB,GAAG,EAAE,MAAM,IAAI,EACf,OAAO,SAAK,EACZ,QAAQ,GAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAGpC,EACN,MAAM,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IACS,EACpD;IAEJ,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAmBd;CACF"}

package/dist/transform.d.ts

@@ -0,0 +1,11 @@
+import type { PluginContext } from './context';
+/**
+ * transform: replace builder chains with `createComponent()` calls using
+ * the pre-built manifest; inject the HMR bridge import once in dev; detect
+ * files created after buildStart and fold them into the analysis.
+ */
+export declare function transformSource(ctx: PluginContext, code: string, id: string): {
+    code: string;
+    map: null;
+} | null;
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CA4EpC"}

package/dist/virtual-modules.d.ts

@@ -0,0 +1,7 @@
+import type { PluginContext } from './context';
+/** resolveId: map virtual ids and redirect external DS package imports. */
+export declare function resolveVirtualId(ctx: PluginContext, id: string): string | null;
+/** load: serve the virtual stylesheet, components CSS, HMR bridge, and
+ *  system-props modules from manifest-derived state. */
+export declare function loadVirtualModule(ctx: PluginContext, id: string): string | null;
+//# sourceMappingURL=virtual-modules.d.ts.map

package/dist/virtual-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAYf;AAED;wDACwD;AACxD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAyGf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Animus static CSS extraction Vite plugin",
   "keywords": [
     "animus",
@@ -35,11 +35,11 @@
   },
   "scripts": {
     "build": "bun run build:ts",
-    "build:ts": "tsdown && tsgo -p tsconfig.build.json",
-    "compile": "tsgo --noEmit"
+    "build:ts": "tsdown && tsc -p tsconfig.build.json",
+    "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.1",
+    "@animus-ui/extract": "0.1.2",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   },

package/dist/analyze-project-args.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=analyze-project-args.d.ts.map

package/dist/analyze-project-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analyze-project-args.d.ts","sourceRoot":"","sources":["../src/analyze-project-args.ts"],"names":[],"mappings":""}

package/dist/manifest-diagnostics.d.ts

@@ -1,10 +0,0 @@
-export type ManifestDiagnostic = {
-    file: string;
-    component: string;
-    kind: string;
-    message: string;
-};
-export declare function surfaceManifestDiagnostics(manifest: {
-    diagnostics?: ManifestDiagnostic[];
-}, warn: (message: string) => void): void;
-//# sourceMappingURL=manifest-diagnostics.d.ts.map

package/dist/manifest-diagnostics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"manifest-diagnostics.d.ts","sourceRoot":"","sources":["../src/manifest-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE;IAAE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAE,EAChD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC9B,IAAI,CAYN"}