@animus-ui/vite-plugin 0.1.38 → 0.1.41

package/README.md

@@ -23,6 +23,8 @@ export default defineConfig({
 
 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.
 
+TypeScript apps get the plugin's virtual modules (`virtual:animus/styles.css`, `virtual:animus/font-preloads`) typed with `/// <reference types="@animus-ui/vite-plugin/client" />` or `"types": ["@animus-ui/vite-plugin/client"]` in `tsconfig.json`.
+
 ## What It Does
 
 1. **Build time**: Analyzes all files importing from `@animus-ui/system`, extracts static styles into CSS with `@layer` ordering
@@ -127,6 +129,16 @@ animusExtract({
 });
 ```
 
+An entry's `fetchpriority` (`'high'`, `'low'` or `'auto'`) is written on the
+preloads of the faces it selects, in `index.html` and in
+`virtual:animus/font-preloads`; a file several entries select carries the
+strongest one given. A preload competes with the critical CSS and
+JavaScript, so give `'high'` only to the face the first screen paints with:
+
+```ts
+fontPreloads: [{ family: 'Apercu', weight: 400, fetchpriority: 'high' }],
+```
+
 `[]` preloads none. An entry no face matches reports
 `animus.style.font-preload-unmatched`; a malformed one, such as a weight
 range, reports `animus.style.font-preload-invalid`.
@@ -137,6 +149,38 @@ file can delay first paint by seconds on a slow link. A preloaded file that
 is not WOFF2 or WOFF, or an `asset()` file over 150 KB, reports
 `animus.style.font-face-preload-costly`.
 
+## Split stylesheets
+
+`stylesheets: 'split'` builds the stylesheet as three files instead of one,
+each a consecutive slice of the single sheet, in its order:
+
+1. foundation: theme variables and color modes, `@property` registrations,
+   and `anm-global` (resets, `@font-face`, keyframes), with any
+   `quarantine` sheets;
+2. components: `anm-base`, `anm-variants`, `anm-compounds`, `anm-states`;
+3. utilities: `anm-system`, `anm-custom`.
+
+Each page links them in that order exactly where Vite places the single sheet
+among the app's own CSS, as ordinary render-blocking stylesheets: app CSS
+bundled with it keeps its place before or after the three files. They hold
+the single sheet's rules in its order, so the cascade is unchanged; Vite
+minifies each file on its own, which leaves its bytes the same apart from
+the newline ending each file. Their URLs are the ones Vite gives its own
+links, through `base` and `experimental.renderBuiltUrl`.
+Each file is named by its content, so a browser keeps its cached copy of a
+file an edit leaves alone: an edit to a component's styles changes only the
+components file. The three files compress slightly worse than one (about
+0.1% more gzip on a large app).
+
+```ts
+animusExtract({ system: './src/ds.ts', stylesheets: 'split' });
+```
+
+A split build needs a page Vite builds from HTML that links the stylesheet,
+which is where the links go: one with no page, or whose stylesheet only a lazy
+chunk loads, fails. The dev server keeps one sheet. `'single'` (the default)
+is one sheet the bundle imports.
+
 ## Third-party stylesheets
 
 A library's plain CSS outside any `@layer` beats every Animus layer. With

package/client.d.ts

@@ -0,0 +1,31 @@
+// The modules @animus-ui/vite-plugin serves to app code. Reference them with
+// `/// <reference types="@animus-ui/vite-plugin/client" />`, or with
+// `"types": ["@animus-ui/vite-plugin/client"]` in tsconfig.json. Free of the
+// plugin's own (Node) types, so a browser tsconfig needs nothing more.
+
+/** Animus's stylesheet: import it once, from the app's entry. */
+declare module 'virtual:animus/styles.css' {}
+
+/** Each font file this build preloads, at the URL index.html preloads it,
+ *  with the faces that preload it. */
+declare module 'virtual:animus/font-preloads' {
+  /** A face that preloads a file: its family, as `fontPreloads` matches
+   *  it, and the descriptors it declares. */
+  interface PreloadedFontFace {
+    family: string;
+    weight?: string;
+    style?: string;
+    unicodeRange?: string;
+  }
+  /** A preloaded font file: the plugin's `FontPreload`. */
+  interface FontPreload {
+    href: string;
+    /** The file's MIME type, where its format names a known one. */
+    type?: string;
+    faces?: PreloadedFontFace[];
+    /** The `fetchpriority` the `fontPreloads` option gives it. */
+    fetchpriority?: 'high' | 'low' | 'auto';
+  }
+  const preloads: ReadonlyArray<FontPreload>;
+  export default preloads;
+}

package/dist/config.d.ts.map

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

package/dist/constants.d.ts

@@ -1,3 +1,4 @@
+import type { StylesheetSlice } from '@animus-ui/extract/pipeline';
 /**
  * The namespace every virtual module here lives under; the `transform` guard
  * matches on this same string so a rename cannot strand it.
@@ -5,6 +6,18 @@
 export declare const VIRTUAL_PREFIX = "virtual:animus/";
 export declare const VIRTUAL_CSS_ID = "virtual:animus/styles.css";
 export declare const RESOLVED_CSS_ID = "\0virtual:animus/styles.css";
+/** A slice of the stylesheet, which `stylesheets: 'split'` builds emit as
+ *  a file of its own. */
+export declare const sliceStylesheetId: (slice: StylesheetSlice) => string;
+export declare const RESOLVED_SLICE_IDS: ReadonlyMap<string, StylesheetSlice>;
+/**
+ * What the stylesheet module holds in a split build: one rule that keeps
+ * the stylesheet's place in Vite's CSS, where the page's links to the
+ * slices then go. Its own property, so no minifier merges or drops it.
+ */
+export declare const SPLIT_STYLESHEET_MARKER = ".animus-split-stylesheet{--animus-split-stylesheet:1}";
+/** The marker as a built stylesheet spells it, minified or not. */
+export declare const SPLIT_STYLESHEET_MARKER_RE: RegExp;
 export declare const VIRTUAL_COMPONENTS_ID = "virtual:animus/components.js";
 export declare const RESOLVED_COMPONENTS_ID = "\0virtual:animus/components.js";
 export declare const VIRTUAL_BRIDGE_ID = "virtual:animus/hmr-bridge.js";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,cAAc,8BAAgC,CAAC;AAC5D,eAAO,MAAM,eAAe,gCAAwB,CAAC;AAErD,eAAO,MAAM,qBAAqB,iCAAmC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mCAA+B,CAAC;AAEnE,eAAO,MAAM,iBAAiB,iCAAmC,CAAC;AAClE,eAAO,MAAM,kBAAkB,mCAA2B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sCAA8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,gCAAkC,CAAC;AACvE,eAAO,MAAM,wBAAwB,kCAAiC,CAAC;AAEvE;kDACkD;AAClD,eAAO,MAAM,wBAAwB,iCAA0B,CAAC;AAChE,eAAO,MAAM,yBAAyB,mCAAkC,CAAC;AAIzE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,cAAc,8BAAgC,CAAC;AAC5D,eAAO,MAAM,eAAe,gCAAwB,CAAC;AAErD;yBACyB;AACzB,eAAO,MAAM,iBAAiB,UAAW,eAAe,KAAG,MACnB,CAAC;AACzC,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAEnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,0DACqB,CAAC;AAC1D,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,QAC4C,CAAC;AAEpF,eAAO,MAAM,qBAAqB,iCAAmC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mCAA+B,CAAC;AAEnE,eAAO,MAAM,iBAAiB,iCAAmC,CAAC;AAClE,eAAO,MAAM,kBAAkB,mCAA2B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sCAA8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,gCAAkC,CAAC;AACvE,eAAO,MAAM,wBAAwB,kCAAiC,CAAC;AAEvE;kDACkD;AAClD,eAAO,MAAM,wBAAwB,iCAA0B,CAAC;AAChE,eAAO,MAAM,yBAAyB,mCAAkC,CAAC;AAIzE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/context.d.ts

@@ -4,7 +4,7 @@ import type { LightningTargets } from './css';
 import type { AnimusExtractOptions } from './index';
 import type { ExcludeMatcher, ExternalPackageOutcome, FontPreload, HostAssetClassification, HostExtensionPolicy, HostLoadExpander, ProjectManifest, SystemConfig } from '@animus-ui/extract/pipeline';
 import type { SessionOutcome, SessionPublication, WatchChanges } from '@animus-ui/extract/session';
-import type { Logger } from 'vite';
+import type { Logger, ResolvedConfig } from 'vite';
 /** A Session outcome, and whether its publication changed the served
  *  system-props module. */
 export interface ObservedOutcome {
@@ -23,9 +23,17 @@ export declare class PluginContext {
     /** Emission mode (the explicit `mode` option wins over the command); feeds
      *  engine devMode and the minify default. Lifecycle stays on `isProd`. */
     emissionProd: boolean;
+    /** A build that links the stylesheet's slices from each page, in place of
+     *  the one sheet the CSS module carries; the dev server keeps one sheet. */
+    get splitsStylesheet(): boolean;
     rootDir: string;
     logger: Logger | null;
     lcssTargets: LightningTargets;
+    /** Whether the stylesheet this client build served kept an authored
+     *  `:dir()`, which Vite's own CSS minification may still lower. */
+    servedDirSelector: boolean;
+    /** Whether this client build warned that its minification lowered one. */
+    warnedLoweredDir: boolean;
     pathAliasesJson: string | null;
     /** Vite's export conditions, so the loader reads the files Vite serves. */
     resolveConditions: string[];
@@ -91,6 +99,7 @@ export declare class PluginContext {
     /** Coalesces a burst of invalidations into one full reload. */
     private readonly reloadWindow;
     base: string;
+    renderBuiltUrl: ResolvedConfig['experimental']['renderBuiltUrl'];
     /** Vite's root and `server.origin`, which a dev asset URL is served
      *  under. */
     viteRoot: string;

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-html.d.ts

@@ -1,5 +1,5 @@
 import type { PluginContext } from './context';
-import type { HtmlTagDescriptor } from 'vite';
+import type { HtmlTagDescriptor, Rolldown } from 'vite';
 /**
  * The hrefs a finished document preloads both through Animus's tag and
  * through another, which the page wrote or a hook running after Animus's
@@ -21,4 +21,15 @@ export declare function injectHeadTags(html: string, tags: HtmlTagDescriptor[]):
  * the font preloads, then the development bridge.
  */
 export declare function buildIndexHtmlTags(ctx: PluginContext, html?: string): HtmlTagDescriptor[];
+/**
+ * Puts a split build's slices where the single stylesheet would have been.
+ * The stylesheet module held only a marker rule, so it kept its place in
+ * Vite's CSS: the file holding the marker is cut there, and each page's
+ * link to it becomes the file's CSS before the marker, the slices in
+ * order, then its CSS after the marker, in a file of its own when CSS
+ * precedes the marker too. A carrier left empty is kept, unlinked, for a
+ * lazy chunk that names it. The build fails when no page links the
+ * carrier: its stylesheet loads with a lazy chunk, or no page is built.
+ */
+export declare function placeStylesheetSlices(ctx: PluginContext, bundle: Rolldown.OutputBundle, sliceIds: readonly string[], emitAsset: (name: string, source: string) => string): void;
 //# sourceMappingURL=index-html.d.ts.map

package/dist/index-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-html.d.ts","sourceRoot":"","sources":["../src/index-html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AA0C9C;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAeV;AAsED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,EAAE,GACxB,MAAM,GAAG,iBAAiB,EAAE,CAU9B;AA0BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,IAAI,SAAK,GACR,iBAAiB,EAAE,CAuCrB"}
+{"version":3,"file":"index-html.d.ts","sourceRoot":"","sources":["../src/index-html.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AA0CxD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAeV;AAsED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,EAAE,GACxB,MAAM,GAAG,iBAAiB,EAAE,CAU9B;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,IAAI,SAAK,GACR,iBAAiB,EAAE,CAuCrB;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,QAAQ,CAAC,YAAY,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAClD,IAAI,CAuFN"}

package/dist/index.cjs

@@ -204,6 +204,7 @@ function applyResolvedConfig(ctx, config) {
 	ctx.log(`extension order: ${ctx.extensionPolicy.resolverVersion}`);
 	ctx.logger = config.logger;
 	ctx.base = config.base ?? "/";
+	ctx.renderBuiltUrl = config.experimental.renderBuiltUrl;
 	ctx.viteRoot = config.root;
 	ctx.serverOrigin = config.server.origin ?? "";
 	ctx.publicDir = config.publicDir;
@@ -235,6 +236,18 @@ function applyResolvedConfig(ctx, config) {
 const VIRTUAL_PREFIX = "virtual:animus/";
 const VIRTUAL_CSS_ID = `${VIRTUAL_PREFIX}styles.css`;
 const RESOLVED_CSS_ID = `\0${VIRTUAL_CSS_ID}`;
+/** A slice of the stylesheet, which `stylesheets: 'split'` builds emit as
+*  a file of its own. */
+const sliceStylesheetId = (slice) => `${VIRTUAL_PREFIX}styles.${slice}.css`;
+const RESOLVED_SLICE_IDS = new Map(_animus_ui_extract_pipeline.STYLESHEET_SLICES.map((slice) => [`\0${sliceStylesheetId(slice)}`, slice]));
+/**
+* What the stylesheet module holds in a split build: one rule that keeps
+* the stylesheet's place in Vite's CSS, where the page's links to the
+* slices then go. Its own property, so no minifier merges or drops it.
+*/
+const SPLIT_STYLESHEET_MARKER = ".animus-split-stylesheet{--animus-split-stylesheet:1}";
+/** The marker as a built stylesheet spells it, minified or not. */
+const SPLIT_STYLESHEET_MARKER_RE = /\.animus-split-stylesheet\s*\{\s*--animus-split-stylesheet\s*:\s*1\s*;?\s*\}\n?/;
 const VIRTUAL_COMPONENTS_ID = `${VIRTUAL_PREFIX}components.js`;
 const RESOLVED_COMPONENTS_ID = `\0${VIRTUAL_COMPONENTS_ID}`;
 const VIRTUAL_BRIDGE_ID = `${VIRTUAL_PREFIX}hmr-bridge.js`;
@@ -349,9 +362,19 @@ var PluginContext = class {
 	/** Emission mode (the explicit `mode` option wins over the command); feeds
 	*  engine devMode and the minify default. Lifecycle stays on `isProd`. */
 	emissionProd = false;
+	/** A build that links the stylesheet's slices from each page, in place of
+	*  the one sheet the CSS module carries; the dev server keeps one sheet. */
+	get splitsStylesheet() {
+		return this.isProd && this.options.stylesheets === "split";
+	}
 	rootDir = "";
 	logger = null;
 	lcssTargets = {};
+	/** Whether the stylesheet this client build served kept an authored
+	*  `:dir()`, which Vite's own CSS minification may still lower. */
+	servedDirSelector = false;
+	/** Whether this client build warned that its minification lowered one. */
+	warnedLoweredDir = false;
 	pathAliasesJson = null;
 	/** Vite's export conditions, so the loader reads the files Vite serves. */
 	resolveConditions = [];
@@ -458,6 +481,7 @@ var PluginContext = class {
 		this.devServer?.hot?.send({ type: "full-reload" });
 	});
 	base = "/";
+	renderBuiltUrl;
 	/** Vite's root and `server.origin`, which a dev asset URL is served
 	*  under. */
 	viteRoot = "";
@@ -542,6 +566,7 @@ var PluginContext = class {
 			prefix: options.prefix,
 			prefixContextualVars: options.prefixContextualVars,
 			targets: options.targets,
+			keepDirSelector: options.keepDirSelector,
 			minify: options.minify,
 			staticCss: options.staticCss,
 			layers: options.layers,
@@ -1453,13 +1478,14 @@ function injectHeadTags(html, tags) {
 function fontPreloadTags(ctx, html) {
 	if (!ctx.served?.fontPreloads.length) return [];
 	const existing = preloadedHrefs(html);
-	return ctx.fontPreloads.filter(({ href }) => !existing.has(href)).map(({ href, type }) => {
+	return ctx.fontPreloads.filter(({ href }) => !existing.has(href)).map(({ href, type, fetchpriority }) => {
 		const attrs = {
 			rel: "preload",
 			href,
 			as: "font"
 		};
 		if (type !== void 0) attrs.type = type;
+		if (fetchpriority !== void 0) attrs.fetchpriority = fetchpriority;
 		attrs.crossorigin = true;
 		attrs[ANIMUS_PRELOAD_MARKER] = true;
 		return {
@@ -1501,6 +1527,92 @@ function buildIndexHtmlTags(ctx, html = "") {
 	});
 	return tags;
 }
+/**
+* A built file's URL in a page, as Vite writes its own links: the host's
+* `renderBuiltUrl` first, then relative to the page under a relative base,
+* else under the base.
+*/
+function builtUrl(ctx, page, fileName) {
+	let relative = ctx.base === "" || ctx.base === "./";
+	const rendered = ctx.renderBuiltUrl?.(fileName, {
+		hostId: page,
+		hostType: "html",
+		type: "asset",
+		ssr: false
+	});
+	if (rendered instanceof Object) {
+		if (rendered.runtime !== void 0) throw new Error(`[animus-extract] renderBuiltUrl returned { runtime } for ${fileName}, which a page's <link> cannot load`);
+		if (rendered.relative !== void 0) relative = rendered.relative;
+	} else if (rendered) return rendered;
+	if (relative) return `${path.posix.join(path.posix.relative(page, "").slice(0, -2), "./")}${fileName}`;
+	return `${decodeURI(ctx.base).replace(/\/$/, "")}/${fileName}`;
+}
+/** `tag`, a stylesheet link, linking `href` instead, with `attributes`. */
+function linkingInstead(tag, href, attributes = "") {
+	return tag.replace(HREF_RE, ` href="${escapeHtml(href)}"`).replace(/\s*\/?>$/, `${attributes}>`);
+}
+/**
+* Puts a split build's slices where the single stylesheet would have been.
+* The stylesheet module held only a marker rule, so it kept its place in
+* Vite's CSS: the file holding the marker is cut there, and each page's
+* link to it becomes the file's CSS before the marker, the slices in
+* order, then its CSS after the marker, in a file of its own when CSS
+* precedes the marker too. A carrier left empty is kept, unlinked, for a
+* lazy chunk that names it. The build fails when no page links the
+* carrier: its stylesheet loads with a lazy chunk, or no page is built.
+*/
+function placeStylesheetSlices(ctx, bundle, sliceIds, emitAsset) {
+	const fileOf = /* @__PURE__ */ new Map();
+	const pages = [];
+	const carriers = [];
+	for (const file of Object.values(bundle)) {
+		if (file.type !== "asset") continue;
+		if (file.fileName.endsWith(".html")) pages.push(file);
+		if (file.fileName.endsWith(".css") && SPLIT_STYLESHEET_MARKER_RE.test(String(file.source))) carriers.push(file);
+		const id = sliceIds.find((slice) => file.originalFileNames.some((name) => name.endsWith(slice)));
+		if (id !== void 0) fileOf.set(id, file.fileName);
+	}
+	const slices = sliceIds.map((id) => {
+		const fileName = fileOf.get(id);
+		if (fileName === void 0) throw new Error(`[animus-extract] stylesheets: 'split' emitted ${id}, and the bundle holds no file for it, so the stylesheet would load without it.`);
+		return fileName;
+	});
+	if (carriers.length === 0) {
+		for (const fileName of slices) delete bundle[fileName];
+		return;
+	}
+	if (carriers.length > 1) throw new Error(`[animus-extract] stylesheets: 'split' found Animus's stylesheet in ${carriers.map((file) => file.fileName).join(" and ")}, and places it once.`);
+	const carrier = carriers[0];
+	const text = String(carrier.source);
+	const marker = SPLIT_STYLESHEET_MARKER_RE.exec(text);
+	const before = text.slice(0, marker.index);
+	const after = text.slice(marker.index + marker[0].length);
+	const precedes = before.trim() !== "";
+	const follows = after.trim() !== "";
+	carrier.source = precedes ? before : after;
+	const rest = precedes && follows ? emitAsset(carrier.names[0] ?? "index.css", after) : null;
+	const sequence = [
+		...precedes ? [null] : [],
+		...slices,
+		...follows ? [rest] : []
+	];
+	let linked = false;
+	for (const page of pages) {
+		const html = Buffer.from(page.source).toString("utf8");
+		const carrierUrl = builtUrl(ctx, page.fileName, carrier.fileName);
+		page.source = html.replace(LINK_TAG_RE, (tag, offset) => {
+			const rel = attribute(tag, REL_RE)?.toLowerCase().split(/\s+/) ?? [];
+			const href = attribute(tag, HREF_RE);
+			if (!rel.includes("stylesheet") || href === void 0) return tag;
+			if (attributeText(href) !== carrierUrl) return tag;
+			linked = true;
+			const lineStart = html.lastIndexOf("\n", offset - 1) + 1;
+			const indent = /^[ \t]*/.exec(html.slice(lineStart))[0];
+			return sequence.map((fileName) => fileName === null ? tag : linkingInstead(tag, builtUrl(ctx, page.fileName, fileName), fileName === rest ? "" : " data-animus-stylesheet")).join(`\n${indent}`);
+		});
+	}
+	if (!linked) throw new Error(`[animus-extract] stylesheets: 'split' links the stylesheet's files where a page links ${carrier.fileName}, which holds Animus's stylesheet, and no page links it: it loads with a lazy chunk, or the build has no HTML page. Import Animus's components from the page's entry, or leave \`stylesheets\` unset for one sheet.`);
+}
 //#endregion
 //#region src/quarantine-plugin.ts
 /**
@@ -1538,6 +1650,7 @@ function sheetRegistryHash(ctx) {
 }
 function resolveVirtualId(ctx, id) {
 	if (id === VIRTUAL_CSS_ID) return RESOLVED_CSS_ID;
+	if (id.startsWith("virtual:animus/") && RESOLVED_SLICE_IDS.has(`\0${id}`)) return `\0${id}`;
 	if (id === VIRTUAL_COMPONENTS_ID) return RESOLVED_COMPONENTS_ID;
 	if (id === VIRTUAL_BRIDGE_ID) return RESOLVED_BRIDGE_ID;
 	if (id === VIRTUAL_SYSTEM_PROPS_ID) return RESOLVED_SYSTEM_PROPS_ID;
@@ -1552,47 +1665,49 @@ function resolveVirtualId(ctx, id) {
 	}
 	return null;
 }
-function loadVirtualModule(ctx, id) {
-	const lcssOpts = {
+function lightningOptions(ctx) {
+	return {
 		minify: ctx.options.minify ?? ctx.emissionProd,
 		targets: ctx.lcssTargets,
+		keepDirSelector: ctx.options.keepDirSelector,
 		warnFn: (msg) => ctx.warn(msg)
 	};
-	const checked = (css) => {
-		(0, _animus_ui_extract_pipeline.reportSurvivingAssetPlaceholders)(css, {
-			strict: ctx.options.strict,
-			warn: (message) => ctx.warn(message),
-			reportErrors: ctx.reportErrors(),
-			prefix: "[animus-extract]"
-		});
-		return css;
-	};
-	if (id === RESOLVED_CSS_ID) {
-		if (!ctx.isProd && ctx.storedManifest) {
-			const { variables, body } = (0, _animus_ui_extract_pipeline.assembleStylesheet)({
-				layers: ctx.options.layers,
-				variableCss: ctx.variableCss,
-				globalCss: ctx.globalCss,
-				split: true
-			});
-			return checked([variables, (0, _animus_ui_extract_pipeline.postProcessCss)(body, {
-				...lcssOpts,
-				minify: false
-			})].filter(Boolean).join("\n"));
-		}
-		const { variables, body } = (0, _animus_ui_extract_pipeline.assembleStylesheet)({
-			layers: ctx.options.layers,
-			variableCss: ctx.variableCss,
-			globalCss: ctx.globalCss,
-			componentCss: ctx.resolvedComponentCss,
-			split: true
-		});
-		return checked([variables, (0, _animus_ui_extract_pipeline.postProcessCss)(body, lcssOpts)].filter(Boolean).join("\n"));
-	}
+}
+function checked(ctx, css) {
+	(0, _animus_ui_extract_pipeline.reportSurvivingAssetPlaceholders)(css, {
+		strict: ctx.options.strict,
+		warn: (message) => ctx.warn(message),
+		reportErrors: ctx.reportErrors(),
+		prefix: "[animus-extract]"
+	});
+	return css;
+}
+/**
+* The stylesheet `virtual:animus/styles.css` serves: the variables, then
+* the post-processed body. In development the component layers arrive
+* through the bridge's sheet instead, unminified.
+*/
+function stylesheetSource(ctx) {
+	const bridged = !ctx.isProd && Boolean(ctx.storedManifest);
+	const { variables, body } = (0, _animus_ui_extract_pipeline.assembleStylesheet)({
+		layers: ctx.options.layers,
+		variableCss: ctx.variableCss,
+		globalCss: ctx.globalCss,
+		componentCss: bridged ? void 0 : ctx.resolvedComponentCss,
+		split: true
+	});
+	const lcssOpts = lightningOptions(ctx);
+	if (bridged) lcssOpts.minify = false;
+	const processedBody = (0, _animus_ui_extract_pipeline.postProcessCss)(body, lcssOpts);
+	if (ctx.isProd && !ctx.servedDirSelector) ctx.servedDirSelector = processedBody.includes(":dir(");
+	return checked(ctx, [variables, processedBody].filter(Boolean).join("\n"));
+}
+function loadVirtualModule(ctx, id) {
+	if (id === RESOLVED_CSS_ID) return ctx.splitsStylesheet ? SPLIT_STYLESHEET_MARKER : stylesheetSource(ctx);
 	if (id === RESOLVED_COMPONENTS_ID) {
 		const strippedCss = (0, _animus_ui_extract_pipeline.stripLeadingLayerDeclaration)(ctx.resolvedComponentCss || "");
-		return `export default \`${checked((0, _animus_ui_extract_pipeline.postProcessCss)(strippedCss, {
-			...lcssOpts,
+		return `export default \`${checked(ctx, (0, _animus_ui_extract_pipeline.postProcessCss)(strippedCss, {
+			...lightningOptions(ctx),
 			minify: false
 		})).replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$")}\`;`;
 	}
@@ -1702,6 +1817,11 @@ async function sourceKitConfig(rootDir, systemPath, engine) {
 /** The URL a build's root is served at, for resolving a page's hrefs: an
 *  absolute `base`, a root-relative one on a stand-in origin, or the root
 *  for a relative one, which every page resolves from its own location. */
+/** Whether a hook runs for the browser's environment; a host without
+*  environments builds only that one. */
+function isClient(context) {
+	return (context.environment?.config.consumer ?? "client") === "client";
+}
 function servedBase(base) {
 	const origin = "https://animus.invalid/";
 	if (/^[a-z][a-z\d+.-]*:/i.test(base)) return new URL(base.replace(/\/?$/, "/"));
@@ -1726,6 +1846,14 @@ function animusExtract(options) {
 		...options,
 		layers: vendor.order
 	} : options);
+	/** The stylesheet with the declared vendor sheets at its head, so they
+	*  arrive wherever it does, whatever imports it. */
+	async function withVendorHead(context, sheet) {
+		const layergate = await vendor?.plugin();
+		return layergate ? await layergate.stylesheetHead.call(context, RESOLVED_CSS_ID) + sheet : sheet;
+	}
+	let slices = /* @__PURE__ */ new Map();
+	let linkedSlices = [];
 	return {
 		name: "animus-extract",
 		enforce: "pre",
@@ -1734,15 +1862,20 @@ function animusExtract(options) {
 			const withVendor = (own) => vendorConfig ? (0, vite.mergeConfig)(own, vendorConfig) : own;
 			const { mode } = (0, _animus_ui_extract_pipeline.resolveMode)(options.mode, () => env.command === "build" ? "production" : "development");
 			const define = { __ANIMUS_DEV__: mode === "development" };
+			const keptDir = options.keepDirSelector ? { css: { lightningcss: { exclude: (userConfig.css?.lightningcss?.exclude ?? 0) | _animus_ui_extract_pipeline.DIR_SELECTOR_FEATURE } } } : {};
 			const root = (0, path.resolve)(userConfig.root ?? process.cwd());
 			const kits = await sourceKitConfig(root, (0, path.resolve)(root, options.system), ctx.kitEngine());
-			if (!kits) return withVendor({ define });
+			if (!kits) return withVendor({
+				define,
+				...keptDir
+			});
 			const { roots, ...config } = kits;
 			const watched = env.command === "serve" && userConfig.server?.watch !== null ? { server: { watch: { ignored: kitWatchNegations(roots) } } } : {};
 			return withVendor({
 				define,
 				...config,
-				...watched
+				...watched,
+				...keptDir
 			});
 		},
 		async configureServer(server) {
@@ -1761,6 +1894,10 @@ function animusExtract(options) {
 			ctx.close();
 		},
 		async buildStart() {
+			if (isClient(this)) {
+				ctx.servedDirSelector = false;
+				ctx.warnedLoweredDir = false;
+			}
 			await (await vendor?.plugin())?.buildStart.call(this);
 			await ctx.builds.open(this.environment ?? ctx.builds.single);
 			await runBuildStart(ctx, async (specifier, importer) => {
@@ -1770,6 +1907,22 @@ function animusExtract(options) {
 				name: fileName,
 				source
 			}) : void 0);
+			if (ctx.splitsStylesheet && isClient(this)) {
+				const sheet = await withVendorHead(this, stylesheetSource(ctx));
+				const cut = (0, _animus_ui_extract_pipeline.splitStylesheet)(sheet);
+				slices = new Map(cut.map(({ slice, css }) => [slice, css]));
+				linkedSlices = [];
+				for (const { slice, css } of cut) {
+					if (css === "") continue;
+					const id = sliceStylesheetId(slice);
+					this.emitFile({
+						type: "chunk",
+						id,
+						name: `animus-${slice}`
+					});
+					linkedSlices.push(id);
+				}
+			}
 		},
 		async resolveId(id, importer, resolveOptions) {
 			const owned = await (await vendor?.plugin())?.resolveId.call(this, id, importer, resolveOptions);
@@ -1786,11 +1939,12 @@ function animusExtract(options) {
 			};
 		},
 		async load(id) {
-			const layergate = await vendor?.plugin();
-			const loaded = await layergate?.load.call(this, id);
+			const loaded = await (await vendor?.plugin())?.load.call(this, id);
 			if (loaded) return loaded;
+			const slice = RESOLVED_SLICE_IDS.get(id);
+			if (slice !== void 0) return slices.get(slice) ?? "";
 			const own = loadVirtualModule(ctx, id);
-			if (layergate && id === RESOLVED_CSS_ID && own !== null) return await layergate.stylesheetHead.call(this, id) + own;
+			if (id === RESOLVED_CSS_ID && own !== null && !ctx.splitsStylesheet) return withVendorHead(this, own);
 			return own;
 		},
 		async transform(code, id) {
@@ -1800,6 +1954,18 @@ function animusExtract(options) {
 		generateBundle: {
 			order: "post",
 			handler(_output, bundle) {
+				if (linkedSlices.length > 0 && isClient(this)) placeStylesheetSlices(ctx, bundle, linkedSlices, (name, source) => this.getFileName(this.emitFile({
+					type: "asset",
+					name,
+					source
+				})));
+				if (ctx.servedDirSelector && !ctx.warnedLoweredDir && isClient(this)) {
+					const sheets = Object.values(bundle).flatMap((file) => file.type === "asset" && file.fileName.endsWith(".css") ? [file.source] : []);
+					if (sheets.length > 0 && sheets.every((source) => !Buffer.from(source).toString("utf8").includes(":dir("))) {
+						ctx.warnedLoweredDir = true;
+						ctx.warn((0, _animus_ui_extract_pipeline.loweredDirMessage)("Vite's CSS minification", "build.cssTarget"));
+					}
+				}
 				if (!ctx.served?.fontPreloads.length) return;
 				for (const file of Object.values(bundle)) {
 					if (file.type !== "asset" || !file.fileName.endsWith(".html")) continue;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import type { AnimusQuarantineOptions, ClosedDynamicImport, FontPreloadEntry, DiagnosticLevels, StaticCssConfig } from '@animus-ui/extract/pipeline';
+import type { AnimusQuarantineOptions, ClosedDynamicImport, FontPreloadEntry, DiagnosticLevels, StaticCssConfig, StylesheetDelivery } from '@animus-ui/extract/pipeline';
 import type { Plugin } from 'vite';
 export { discoverFiles } from '@animus-ui/extract/pipeline';
-export type { AnimusQuarantineOptions } from '@animus-ui/extract/pipeline';
+export type { AnimusQuarantineOptions, StylesheetDelivery, } from '@animus-ui/extract/pipeline';
 /** The entries `virtual:animus/font-preloads` exports by default: each file
  *  this build preloads, the URL it is preloaded at, and its faces. */
 export type { FontPreload, PreloadedFontFace, } from '@animus-ui/extract/pipeline';
@@ -31,9 +31,19 @@ export interface AnimusExtractOptions {
     closedDynamicImports?: ClosedDynamicImport[];
     /** The font faces this app preloads, in place of each typed face's own
      *  `preload` flag, so a face declared once for every product preloads only
-     *  where the app renders it: family names, or `{ family, weight?, style? }`
-     *  (see `FontPreloadEntry`). `[]` preloads none. */
+     *  where the app renders it: family names, or `{ family, weight?, style?,
+     *  unicodeRange?, fetchpriority? }` (see `FontPreloadEntry`). `[]`
+     *  preloads none. */
     fontPreloads?: FontPreloadEntry[];
+    /** `'split'` builds the stylesheet as three consecutive files, each page
+     *  linking them in order where it would link the one sheet `'single'`
+     *  (the default) builds: foundation (variables, `@property`,
+     *  `anm-global`), components (base through states), then utilities
+     *  (`anm-system`, `anm-custom`). In order they hold that sheet's rules,
+     *  so the cascade is unchanged, and a file an edit leaves alone keeps its
+     *  hash. Needs a page Vite builds from HTML to link the stylesheet; the
+     *  dev server keeps one sheet. */
+    stylesheets?: StylesheetDelivery;
     /**
      * Substrings, or globs when `*`/`?` present. Replaces the defaults `dist`,
      * `.test.`, `.spec.`; `node_modules`, `.next`, `.animus` always apply.
@@ -78,6 +88,12 @@ export interface AnimusExtractOptions {
      * to the project's browserslist config, then to `defaults`.
      */
     targets?: string | string[];
+    /** Keeps `:dir()` as written where the targets would lower it to
+     *  `:lang()` over right-to-left language codes, which an element that sets
+     *  only `dir` does not match. A build also excludes it from Vite's own
+     *  Lightning CSS minification (`css.lightningcss.exclude`), which lowers
+     *  for `build.cssTarget` across the bundle's CSS. */
+    keepDirSelector?: boolean;
     /** Absent minifies in production only; `false` still autoprefixes. */
     minify?: boolean;
     /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E;sEACsE;AACtE,YAAY,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AA+CrC,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf;;;0DAGsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C;;;wDAGoD;IACpD,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;+CAE2C;IAC3C,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;sDAEkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;gBAEY;IACZ,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAiBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA4MnE;eAEc,aAAa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAEhB,eAAe,EACf,kBAAkB,EAEnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAe,MAAM,EAAwB,MAAM,MAAM,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EACV,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC;sEACsE;AACtE,YAAY,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AA+CrC,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf;;;0DAGsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C;;;;yBAIqB;IACrB,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC;;;;;;;sCAOkC;IAClC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;+CAE2C;IAC3C,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;yDAIqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;sDAEkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;gBAEY;IACZ,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAuBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAqRnE;eAEc,aAAa"}

package/dist/virtual-modules.d.ts

@@ -3,5 +3,11 @@ export declare function resolveVirtualId(ctx: PluginContext, id: string): string
     id: string;
     moduleSideEffects: boolean;
 } | null;
+/**
+ * The stylesheet `virtual:animus/styles.css` serves: the variables, then
+ * the post-processed body. In development the component layers arrive
+ * through the bridge's sheet instead, unminified.
+ */
+export declare function stylesheetSource(ctx: PluginContext): string;
 export declare function loadVirtualModule(ctx: PluginContext, id: string): string | null;
 //# sourceMappingURL=virtual-modules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAa/C,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAoB5D;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAkHf"}
+{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAa/C,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAuB5D;AAqBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiB3D;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAgFf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.38",
+  "version": "0.1.41",
   "description": "Animus static CSS extraction Vite plugin",
   "keywords": [
     "animus",
@@ -20,6 +20,7 @@
     "directory": "packages/vite-plugin"
   },
   "files": [
+    "client.d.ts",
     "dist"
   ],
   "main": "./dist/index.cjs",
@@ -28,6 +29,9 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./client.d.ts"
     }
   },
   "publishConfig": {
@@ -39,16 +43,16 @@
     "compile": "bun check"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.38",
+    "@animus-ui/extract": "0.1.41",
     "browserslist": "^4.28.8",
     "lightningcss": "^1.33.0"
   },
   "devDependencies": {
-    "@animus-ui/assertions": "0.1.38",
-    "@animus-ui/layergate": "0.1.38"
+    "@animus-ui/assertions": "0.1.41",
+    "@animus-ui/layergate": "0.1.41"
   },
   "peerDependencies": {
-    "@animus-ui/layergate": "0.1.38",
+    "@animus-ui/layergate": "0.1.41",
     "vite": ">=8 <9"
   },
   "peerDependenciesMeta": {