@animus-ui/vite-plugin 0.1.2 → 0.1.4

package/README.md

@@ -50,9 +50,9 @@ import { createAppearanceBootstrap } from '@animus-ui/system/bootstrap';
 import { animusExtract } from '@animus-ui/vite-plugin';
 import { defineConfig } from 'vite';
 
-import { tokens } from './src/ds';
+import { theme } from './src/ds';
 
-const appearanceBootstrap = createAppearanceBootstrap(tokens);
+const appearanceBootstrap = createAppearanceBootstrap(theme);
 
 export default defineConfig({
   plugins: [animusExtract({ system: './src/ds.ts', appearanceBootstrap })],

package/dist/build-start.d.ts

@@ -3,7 +3,9 @@ import type { PluginContext } from './context';
  * buildStart: load the system, discover and ingest sources (local +
  * external packages), run whole-project analysis, and log the report.
  * `resolveSpecifier` is the bundler seam — Vite's `this.resolve` mapped to
- * an absolute id.
+ * an absolute id. `emitAsset` (build mode only) is Rollup's `this.emitFile`
+ * for `asset()` placeholder substitution; absent in dev, where resolved
+ * files are served via base + `/@fs/` instead.
  */
-export declare function runBuildStart(ctx: PluginContext, resolveSpecifier: (specifier: string) => Promise<string | null>): Promise<void>;
+export declare function runBuildStart(ctx: PluginContext, resolveSpecifier: (specifier: string) => Promise<string | null>, emitAsset?: (fileName: string, source: Uint8Array) => string): Promise<void>;
 //# sourceMappingURL=build-start.d.ts.map

package/dist/build-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC9D,OAAO,CAAC,IAAI,CAAC,CAiNf"}
+{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAC/D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAC3D,OAAO,CAAC,IAAI,CAAC,CAkRf"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,GACrB,IAAI,CAqDN"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,GACrB,IAAI,CAwDN"}

package/dist/context.d.ts

@@ -90,7 +90,13 @@ export declare class PluginContext {
     }>;
     readonly hotUpdateEvents: HotUpdateEvents;
     packageMap: Record<string, string>;
+    base: string;
+    assetUrlBySpecifier: Map<string, string>;
+    assetResolutionFailures: Set<string>;
+    assetPassComplete: boolean;
     externalPackageDirs: string[];
+    externalDirOwners: Record<string, string>;
+    externalFileOwners: Record<string, string>;
     externalSourceEntries: Map<string, string>;
     externalPackageOutcomes: ExternalPackageOutcome[];
     devServer: any;
@@ -103,7 +109,7 @@ export declare class PluginContext {
     private v2DriftWarned;
     /** Single engine choke-point for every native extraction call. */
     readonly engineApi: () => any;
-    constructor(options: AnimusExtractOptions);
+    constructor(options: AnimusExtractOptions, engineApiOverride?: () => any);
     log(msg: string): void;
     warn(msg: string): void;
     logTimingWaterfall(timing: Record<string, number>): void;
@@ -122,6 +128,24 @@ export declare class PluginContext {
         source: string;
         hash?: string;
     }>): void;
+    /** Base-prefixed dev URL for an absolute file (Vite mounts /@fs under base). */
+    devFsUrl(absPath: string): string;
+    /**
+     * The shared unresolvable-asset policy: fail the build under `strict`,
+     * else warn and record the identity mapping so the specifier emits
+     * literally.
+     */
+    assetFallback(specifier: string, message: string, cause?: unknown): void;
+    /**
+     * The one asset-substitution pass per analysis. In dev, a specifier not
+     * already mapped by buildStart's bundler-resolved pass (a geological
+     * reset regenerates globalCss from an edited system, which may reference
+     * NEW assets) is resolved Node-side first — host aliases, then Node,
+     * then package root; bundler-only resolutions can differ, since the
+     * plugin hook context is unavailable on this path. Strict semantics
+     * match buildStart.
+     */
+    private applyAssetSubstitutions;
     private resetCoalescer;
     /**
      * Schedule a geological reset through the burst coalescer. N dependency
@@ -129,6 +153,15 @@ export declare class PluginContext {
      * running reset produce exactly one follow-up.
      */
     requestGeologicalReset(trigger: string): void;
+    /**
+     * A failed reset must surface without killing the server: the coalescer
+     * fires from a bare timer, OUTSIDE Vite's handleHMRUpdate catch, so a
+     * strict-mode throw (asset resolution, token contracts, system load)
+     * would otherwise be an unhandled exception that exits the process.
+     * Strict-in-dev means the error overlay, matching the transform/HMR
+     * strict paths that Vite itself catches.
+     */
+    private geologicalResetFailed;
     /**
      * The geological reset: reload the system (refreshing the dependency
      * set), clear the Rust per-file cache, re-analyze everything with full
@@ -166,6 +199,26 @@ export declare class PluginContext {
      * which is exactly the reach this path wants. It stays the seam here.
      */
     invalidateExtractedModules(): void;
+    /**
+     * The buildStart gate over include resolution
+     * (external-package-file-discovery: silence is never an outcome). An
+     * unresolvable `.includes()` specifier warns in non-strict mode and FAILS
+     * the build under `strict: true`, naming every offending specifier —
+     * a typo'd include must not ship a build missing its component CSS. A
+     * stale dist entry under an extended package (first-class-extension D13)
+     * rides the same seam: a merge against it would silently skew registry
+     * content the discovered sources no longer match.
+     */
+    enforceIncludeResolution(): void;
+    /**
+     * The post-analysis gate over cross-source token contracts
+     * (extraction-diagnostics): a discovered component referencing a token its
+     * OWN package defines but the consumer theme does not gets the teaching
+     * error naming the token, component, source package, and the missing
+     * `createTheme().extend(...)`. Wiring and severity routing live in the
+     * shared pipeline gate (next-plugin parity by construction).
+     */
+    enforceExternalTokenContracts(): void;
     runSelfVerify(): void;
 }
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -26,10 +26,15 @@ const DEFAULT_EXCLUDE = [
 * buildStart: load the system, discover and ingest sources (local +
 * external packages), run whole-project analysis, and log the report.
 * `resolveSpecifier` is the bundler seam — Vite's `this.resolve` mapped to
-* an absolute id.
+* an absolute id. `emitAsset` (build mode only) is Rollup's `this.emitFile`
+* for `asset()` placeholder substitution; absent in dev, where resolved
+* files are served via base + `/@fs/` instead.
 */
-async function runBuildStart(ctx, resolveSpecifier) {
+async function runBuildStart(ctx, resolveSpecifier, emitAsset) {
 	(0, _animus_ui_extract_pipeline.clearEngineCache)(ctx.engineApi);
+	ctx.assetPassComplete = false;
+	ctx.assetUrlBySpecifier.clear();
+	ctx.assetResolutionFailures.clear();
 	let t0 = performance.now();
 	ctx.loadSystem();
 	if (ctx.options.layers) {
@@ -106,6 +111,9 @@ async function runBuildStart(ctx, resolveSpecifier) {
 	});
 	ctx.packageMap = collected.packageMap;
 	ctx.externalPackageOutcomes = collected.outcomes;
+	ctx.externalDirOwners = collected.dirOwners;
+	ctx.externalFileOwners = collected.fileOwners;
+	ctx.enforceIncludeResolution();
 	for (const [specifier, srcEntry] of collected.sourceEntries) ctx.externalSourceEntries.set(specifier, srcEntry);
 	for (const entry of collected.entries) {
 		const hash = !ctx.isProd ? (0, _animus_ui_extract_pipeline.contentHash)(entry.source) : void 0;
@@ -120,10 +128,28 @@ async function runBuildStart(ctx, resolveSpecifier) {
 		});
 	}
 	ctx.externalPackageDirs = collected.packageDirs;
+	ctx.registerSystemWatchPaths();
 	const packageFileCount = fileEntries.length - localFileCount;
 	ctx.log(`Discovered ${fileEntries.length} files (${packageFileCount} from packages) (${Math.round(performance.now() - t0)}ms)`);
 	t0 = performance.now();
 	ctx.runAnalysis(fileEntries);
+	const assetSpecifiers = (0, _animus_ui_extract_pipeline.findAssetSpecifiers)(ctx.globalCss);
+	for (const specifier of assetSpecifiers) {
+		const resolvedPath = await resolveSpecifier(specifier);
+		if (!resolvedPath) {
+			ctx.assetFallback(specifier, `[animus-extract] unresolvable asset() specifier: ${specifier}`);
+			continue;
+		}
+		if (emitAsset) try {
+			const referenceId = emitAsset((0, path.basename)(resolvedPath), (0, fs.readFileSync)(resolvedPath));
+			ctx.assetUrlBySpecifier.set(specifier, `__VITE_ASSET__${referenceId}__`);
+		} catch (err) {
+			ctx.assetFallback(specifier, `[animus-extract] failed to emit asset() specifier ${specifier}: ${String(err)}`, err);
+		}
+		else ctx.assetUrlBySpecifier.set(specifier, ctx.devFsUrl(resolvedPath));
+	}
+	ctx.globalCss = (0, _animus_ui_extract_pipeline.substituteAssetPlaceholders)(ctx.globalCss, ctx.assetUrlBySpecifier);
+	ctx.assetPassComplete = true;
 	if (ctx.storedManifest) {
 		const report = ctx.storedManifest.report;
 		if (report) {
@@ -167,6 +193,7 @@ function applyResolvedConfig(ctx, config) {
 	ctx.isProd = config.command === "build";
 	ctx.rootDir = config.root;
 	ctx.logger = config.logger;
+	ctx.base = config.base ?? "/";
 	ctx.lcssTargets = (0, _animus_ui_extract_pipeline.resolveLightningTargets)(ctx.options.targets, ctx.rootDir);
 	ctx.log(`Lightning CSS targets resolved (${Object.keys(ctx.lcssTargets).length} browsers)`);
 	const rawAlias = config.resolve?.alias;
@@ -259,8 +286,9 @@ var ResetCoalescer = class {
 	timer = null;
 	running = false;
 	dirty = false;
-	constructor(run, quietMs = 60, schedule = (fn, ms) => setTimeout(fn, ms), cancel = (timer) => clearTimeout(timer)) {
+	constructor(run, onError, quietMs = 60, schedule = (fn, ms) => setTimeout(fn, ms), cancel = (timer) => clearTimeout(timer)) {
 		this.run = run;
+		this.onError = onError;
 		this.quietMs = quietMs;
 		this.schedule = schedule;
 		this.cancel = cancel;
@@ -277,6 +305,8 @@ var ResetCoalescer = class {
 			this.running = true;
 			try {
 				this.run();
+			} catch (err) {
+				this.onError(err);
 			} finally {
 				this.running = false;
 				if (this.dirty) {
@@ -368,7 +398,13 @@ var PluginContext = class {
 	fileCache = /* @__PURE__ */ new Map();
 	hotUpdateEvents = new HotUpdateEvents();
 	packageMap = {};
+	base = "/";
+	assetUrlBySpecifier = /* @__PURE__ */ new Map();
+	assetResolutionFailures = /* @__PURE__ */ new Set();
+	assetPassComplete = false;
 	externalPackageDirs = [];
+	externalDirOwners = {};
+	externalFileOwners = {};
 	externalSourceEntries = /* @__PURE__ */ new Map();
 	externalPackageOutcomes = [];
 	devServer;
@@ -381,11 +417,15 @@ var PluginContext = class {
 	v2DriftWarned = false;
 	/** Single engine choke-point for every native extraction call. */
 	engineApi;
-	constructor(options) {
+	constructor(options, engineApiOverride) {
 		this.options = options;
 		this.staticCssJson = (0, _animus_ui_extract_pipeline.serializeStaticCss)(options.staticCss);
 		this.verbose = options.verbose || process.env.ANIMUS_DEBUG === "1" || process.env.ANIMUS_DEBUG === "true";
 		this.extensionsSet = new Set(options.extensions ?? _animus_ui_extract_pipeline.DEFAULT_EXTENSIONS);
+		if (engineApiOverride) {
+			this.engineApi = engineApiOverride;
+			return;
+		}
 		const engineModuleId = "@animus-ui/extract";
 		this.engineApi = (0, _animus_ui_extract_pipeline.createV2EngineApi)({
 			label: "animus-extract",
@@ -468,6 +508,7 @@ var PluginContext = class {
 				},
 				pathAliasesJson: this.pathAliasesJson,
 				staticCssJson: this.staticCssJson,
+				externalDirs: this.externalPackageDirs.map((dir) => (0, path.relative)(this.rootDir, dir)),
 				devMode: !this.isProd,
 				warn: (m) => this.warn(m)
 			});
@@ -488,7 +529,44 @@ var PluginContext = class {
 		} catch (e) {
 			if (this.options.strict) throw new Error(`[animus-extract] analyzeProject failed: ${e}`, { cause: e });
 			console.warn("[animus-extract] analyzeProject failed:", e);
+			return;
 		}
+		this.applyAssetSubstitutions();
+		this.enforceExternalTokenContracts();
+	}
+	/** Base-prefixed dev URL for an absolute file (Vite mounts /@fs under base). */
+	devFsUrl(absPath) {
+		return `${this.base.endsWith("/") ? this.base.slice(0, -1) : this.base}/@fs${absPath}`;
+	}
+	/**
+	* The shared unresolvable-asset policy: fail the build under `strict`,
+	* else warn and record the identity mapping so the specifier emits
+	* literally.
+	*/
+	assetFallback(specifier, message, cause) {
+		if (this.options.strict) throw new Error(message, cause === void 0 ? void 0 : { cause });
+		this.warn(message);
+		this.assetUrlBySpecifier.set(specifier, specifier);
+		this.assetResolutionFailures.add(specifier);
+	}
+	/**
+	* The one asset-substitution pass per analysis. In dev, a specifier not
+	* already mapped by buildStart's bundler-resolved pass (a geological
+	* reset regenerates globalCss from an edited system, which may reference
+	* NEW assets) is resolved Node-side first — host aliases, then Node,
+	* then package root; bundler-only resolutions can differ, since the
+	* plugin hook context is unavailable on this path. Strict semantics
+	* match buildStart.
+	*/
+	applyAssetSubstitutions() {
+		if (!this.isProd && this.assetPassComplete) for (const specifier of (0, _animus_ui_extract_pipeline.findAssetSpecifiers)(this.globalCss)) {
+			if (this.assetResolutionFailures.delete(specifier)) this.assetUrlBySpecifier.delete(specifier);
+			if (this.assetUrlBySpecifier.has(specifier)) continue;
+			const resolved = (0, _animus_ui_extract_pipeline.resolveAssetFile)(specifier, this.rootDir, this.pathAliasesJson);
+			if (resolved) this.assetUrlBySpecifier.set(specifier, this.devFsUrl(resolved));
+			else this.assetFallback(specifier, `[animus-extract] unresolvable asset() specifier: ${specifier}`);
+		}
+		this.globalCss = (0, _animus_ui_extract_pipeline.substituteAssetPlaceholders)(this.globalCss, this.assetUrlBySpecifier);
 	}
 	resetCoalescer = null;
 	/**
@@ -498,10 +576,31 @@ var PluginContext = class {
 	*/
 	requestGeologicalReset(trigger) {
 		this.log(`HMR geological reset scheduled: ${trigger}`);
-		this.resetCoalescer ??= new ResetCoalescer(() => this.performGeologicalReset());
+		this.resetCoalescer ??= new ResetCoalescer(() => this.performGeologicalReset(), (err) => this.geologicalResetFailed(err));
 		this.resetCoalescer.request();
 	}
 	/**
+	* A failed reset must surface without killing the server: the coalescer
+	* fires from a bare timer, OUTSIDE Vite's handleHMRUpdate catch, so a
+	* strict-mode throw (asset resolution, token contracts, system load)
+	* would otherwise be an unhandled exception that exits the process.
+	* Strict-in-dev means the error overlay, matching the transform/HMR
+	* strict paths that Vite itself catches.
+	*/
+	geologicalResetFailed(err) {
+		this.warn(`[animus-extract] geological reset failed: ${err}`);
+		const message = err instanceof Error ? err.message : String(err);
+		const stack = err instanceof Error ? err.stack ?? "" : "";
+		this.devServer?.hot?.send({
+			type: "error",
+			err: {
+				message,
+				stack,
+				plugin: "animus-extract"
+			}
+		});
+	}
+	/**
 	* The geological reset: reload the system (refreshing the dependency
 	* set), clear the Rust per-file cache, re-analyze everything with full
 	* sources, then invalidate the static/component/system-prop virtual
@@ -550,8 +649,9 @@ var PluginContext = class {
 	*/
 	registerSystemWatchPaths() {
 		const watcher = this.devServer?.watcher;
-		if (!watcher || this.systemDependencyPaths.length === 0) return;
-		watcher.add(this.systemDependencyPaths);
+		if (!watcher) return;
+		if (this.systemDependencyPaths.length > 0) watcher.add(this.systemDependencyPaths);
+		if (this.externalPackageDirs.length > 0) watcher.add(this.externalPackageDirs);
 	}
 	/**
 	* Invalidate the component CSS and system-props virtual modules, then
@@ -577,10 +677,47 @@ var PluginContext = class {
 			this.devServer?.hot?.send({ type: "full-reload" });
 		}, 100);
 	}
+	/**
+	* The buildStart gate over include resolution
+	* (external-package-file-discovery: silence is never an outcome). An
+	* unresolvable `.includes()` specifier warns in non-strict mode and FAILS
+	* the build under `strict: true`, naming every offending specifier —
+	* a typo'd include must not ship a build missing its component CSS. A
+	* stale dist entry under an extended package (first-class-extension D13)
+	* rides the same seam: a merge against it would silently skew registry
+	* content the discovered sources no longer match.
+	*/
+	enforceIncludeResolution() {
+		for (const message of [(0, _animus_ui_extract_pipeline.unresolvableIncludesMessage)(this.externalPackageOutcomes), (0, _animus_ui_extract_pipeline.staleDistIncludesMessage)(this.externalPackageOutcomes)]) {
+			if (message === null) continue;
+			if (this.options.strict) throw new Error(message);
+			this.warn(message);
+		}
+	}
+	/**
+	* The post-analysis gate over cross-source token contracts
+	* (extraction-diagnostics): a discovered component referencing a token its
+	* OWN package defines but the consumer theme does not gets the teaching
+	* error naming the token, component, source package, and the missing
+	* `createTheme().extend(...)`. Wiring and severity routing live in the
+	* shared pipeline gate (next-plugin parity by construction).
+	*/
+	enforceExternalTokenContracts() {
+		(0, _animus_ui_extract_pipeline.enforceExternalTokenContracts)({
+			diagnostics: this.storedManifest?.diagnostics,
+			fileOwners: this.externalFileOwners,
+			dirOwners: this.externalDirOwners,
+			sourceThemeManifestsJson: this.system.sourceThemeManifestsJson,
+			strict: this.options.strict,
+			prefix: "[animus-extract]",
+			warn: (message) => this.warn(message)
+		});
+	}
 	runSelfVerify() {
 		const failures = [];
 		if (Object.keys(this.storedManifest?.components ?? {}).length === 0) failures.push("No component CSS produced — check the system file and its includes list");
 		for (const { specifier, outcome } of this.externalPackageOutcomes) if (outcome === "empty") failures.push(`include '${specifier}' resolved but discovered no component sources`);
+		else if (outcome === "unresolvable") failures.push(`include '${specifier}' could not be resolved`);
 		if (!this.system.variableCss.includes(":root")) failures.push("No :root variable block found in variable CSS");
 		if (`${this.system.variableCss}\n${this.globalCss}\n${this.resolvedComponentCss}`.includes("__TRANSFORM__")) failures.push("Unresolved __TRANSFORM__ placeholders found in CSS output");
 		if (this.storedManifest && this.resolvedComponentCss.length > 0) {
@@ -819,13 +956,18 @@ function buildIndexHtmlTags(ctx) {
 */
 function transformSource(ctx, code, id) {
 	if (!ctx.storedManifest) return null;
-	if (!ctx.externalPackageDirs.some((dir) => id.startsWith(dir + path.sep) || id === dir)) {
+	const isExternalPkg = ctx.externalPackageDirs.some((dir) => id.startsWith(dir + path.sep) || id === dir);
+	if (!isExternalPkg) {
 		if (!/\.[jt]sx?$/.test(id)) return null;
 		if (id.includes("node_modules")) return null;
 	}
 	const relativePath = (0, path.relative)(ctx.rootDir, id);
 	if (!ctx.storedManifest.files?.[relativePath]?.length) {
 		if (!ctx.isProd && !ctx.fileCache.has(relativePath)) {
+			if (isExternalPkg) {
+				const owner = Object.entries(ctx.externalDirOwners).find(([dir]) => id === dir || id.startsWith(dir + path.sep));
+				if (owner) ctx.externalFileOwners[relativePath] = owner[1];
+			}
 			const hash = (0, _animus_ui_extract_pipeline.contentHash)(code);
 			ctx.fileCache.set(relativePath, {
 				hash,
@@ -975,7 +1117,11 @@ function animusExtract(options) {
 		async buildStart() {
 			await runBuildStart(ctx, async (specifier) => {
 				return (await this.resolve(specifier))?.id ?? null;
-			});
+			}, ctx.isProd ? (fileName, source) => this.emitFile({
+				type: "asset",
+				name: fileName,
+				source
+			}) : void 0);
 		},
 		resolveId(id) {
 			return resolveVirtualId(ctx, id);

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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,CAmEnE;eAEc,aAAa"}

package/dist/reset-coalescer.d.ts

@@ -9,13 +9,14 @@
  */
 export declare class ResetCoalescer {
     private readonly run;
+    private readonly onError;
     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);
+    constructor(run: () => void, onError: (err: unknown) => 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;
 }

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

@@ -1 +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"}
+{"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;IAKpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAIzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IAEtB,YACmB,GAAG,EAAE,MAAM,IAAI,EAKf,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,EAC/B,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,CAqBd;CACF"}

package/dist/transform.d.ts.map

@@ -1 +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"}
+{"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,CAuFpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Animus static CSS extraction Vite plugin",
   "keywords": [
     "animus",
@@ -39,7 +39,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.2",
+    "@animus-ui/extract": "0.1.4",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   },