@animus-ui/vite-plugin 0.1.49 → 0.1.51

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

@@ -1 +1 @@
-{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAa/D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAY/D;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,WAAW,EAC7B,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAC3D,OAAO,CAAC,IAAI,CAAC,CA4If"}
+{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAa/D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAY/D;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,WAAW,EAC7B,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAC3D,OAAO,CAAC,IAAI,CAAC,CAgJf"}

package/dist/bundle-removal.d.ts

@@ -0,0 +1,27 @@
+import type { PluginContext } from './context';
+import type { Rolldown } from 'vite';
+/** What a build that removes unbundled components does to its slices. */
+export interface BundleRemoval {
+    /** Emits `file` without the removed components' rules, beside it under a
+     *  name its new content hashes, and returns that name; `null` keeps it. */
+    replace(file: Rolldown.OutputAsset): string | null;
+    /** Points Vite's manifests and chunk metadata at each replacement where
+     *  they named the file replaced, then reports. */
+    finish(): void;
+}
+/**
+ * The removal of every component no output file of this client build
+ * includes, or `null` where the build keeps every component: it bundles
+ * another environment beside the client (`otherEnvironments`), whose output
+ * may render what the client's does not; it leaves a module external; it
+ * carries data the scan cannot read as text; or an output file other than
+ * Vite's `manifests` names a stylesheet slice, which a replacement would
+ * leave naming a deleted file. Every output file but the slices
+ * (`sliceIds`) and media is evidence, data URLs decoded.
+ */
+export declare function bundleRemoval(ctx: PluginContext, bundle: Rolldown.OutputBundle, sliceIds: readonly string[], context: {
+    otherEnvironments: readonly string[];
+    manifests: ReadonlySet<string>;
+    emit: (asset: Rolldown.EmittedAsset) => void;
+}): BundleRemoval | null;
+//# sourceMappingURL=bundle-removal.d.ts.map

package/dist/bundle-removal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-removal.d.ts","sourceRoot":"","sources":["../src/bundle-removal.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B;+EAC2E;IAC3E,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD;sDACkD;IAClD,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,QAAQ,CAAC,YAAY,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE;IACP,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC;CAC9C,GACA,aAAa,GAAG,IAAI,CAiJtB"}

package/dist/index-html.d.ts

@@ -21,6 +21,9 @@ export declare function injectHeadTags(html: string, tags: HtmlTagDescriptor[]):
  * the font preloads, then the development bridge.
  */
 export declare function buildIndexHtmlTags(ctx: PluginContext, html?: string): HtmlTagDescriptor[];
+/** The slice `file` holds, by its id, or a path to it from the root, as
+ *  Vite versions spell it. */
+export declare function sliceIdOf(file: Rolldown.OutputAsset | Rolldown.OutputChunk, sliceIds: readonly string[]): string | undefined;
 /**
  * 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
@@ -31,5 +34,7 @@ export declare function buildIndexHtmlTags(ctx: PluginContext, html?: string): H
  * 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;
+export declare function placeStylesheetSlices(ctx: PluginContext, bundle: Rolldown.OutputBundle, sliceIds: readonly string[], emitAsset: (name: string, source: string) => string, 
+/** The file emitted in a slice's place, or `null` to ship Vite's own. */
+replace?: (file: Rolldown.OutputAsset) => string | null): 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":"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"}
+{"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;8BAC8B;AAC9B,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,EACjD,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;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;AACnD,yEAAyE;AACzE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,KAAK,MAAM,GAAG,IAAI,GACtD,IAAI,CA2FN"}

package/dist/index.cjs

@@ -8,6 +8,7 @@ let vite = require("vite");
 let fs = require("fs");
 let _animus_ui_extract_session = require("@animus-ui/extract/session");
 let child_process = require("child_process");
+let node_path = require("node:path");
 let crypto = require("crypto");
 //#region src/asset-copy-dirs.ts
 /**
@@ -170,7 +171,8 @@ async function runBuildStart(ctx, resolveSpecifier, emitAsset) {
 			}).length;
 			const componentSize = ctx.resolvedComponentCss.length;
 			ctx.log(`Delivery: split mode — static ${staticSize} bytes, components ${componentSize} bytes (adopted stylesheet)`);
-		} else ctx.log("Delivery: single file mode (production)");
+		} else if (ctx.splitsStylesheet) ctx.log("Delivery: split mode (production), linking each slice from the page");
+		else ctx.log("Delivery: single file mode (production)");
 	}
 	const { declaration } = (0, _animus_ui_extract_pipeline.assembleStylesheet)({
 		layers: ctx.options.layers,
@@ -182,6 +184,428 @@ async function runBuildStart(ctx, resolveSpecifier, emitAsset) {
 	if (ctx.options.verify) ctx.runSelfVerify();
 }
 //#endregion
+//#region src/constants.ts
+/**
+* The namespace every virtual module here lives under; the `transform` guard
+* matches on this same string so a rename cannot strand it.
+*/
+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`;
+const RESOLVED_BRIDGE_ID = `\0${VIRTUAL_BRIDGE_ID}`;
+/**
+* Vite reserves `/@id/` for module ids that are not file paths and strips the
+* prefix before `resolveId`, so the unprefixed specifier travels here.
+*/
+const BRIDGE_SCRIPT_SRC = `/@id/${VIRTUAL_BRIDGE_ID}`;
+const VIRTUAL_SYSTEM_PROPS_ID = `${VIRTUAL_PREFIX}system-props`;
+const RESOLVED_SYSTEM_PROPS_ID = `\0${VIRTUAL_SYSTEM_PROPS_ID}`;
+/** The faces this build preloads, with the URL each file is preloaded at:
+*  the module every host serves under this id. */
+const VIRTUAL_FONT_PRELOADS_ID = _animus_ui_extract_session.FONT_PRELOADS_MODULE_ID;
+const RESOLVED_FONT_PRELOADS_ID = `\0${VIRTUAL_FONT_PRELOADS_ID}`;
+//#endregion
+//#region src/index-html.ts
+const LINK_TAG_RE = /<link\b[^>]*>/gi;
+/** Marks the preloads Animus writes, so another preload of the same file
+*  can be told from Animus's own. */
+const ANIMUS_PRELOAD_MARKER = "data-animus-preload";
+const MARKER_RE = /\sdata-animus-preload(?=[\s=/>])/i;
+const REL_RE = /\srel\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i;
+const HREF_RE = /\shref\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i;
+function attribute(tag, re) {
+	const match = re.exec(tag);
+	return match ? match[1] ?? match[2] ?? match[3] : void 0;
+}
+/** Each `<link rel="preload">` in `html`, with its href. */
+function* preloadLinks(html) {
+	for (const [tag] of html.matchAll(LINK_TAG_RE)) {
+		const rel = attribute(tag, REL_RE)?.toLowerCase().split(/\s+/) ?? [];
+		const href = attribute(tag, HREF_RE);
+		if (rel.includes("preload") && href !== void 0) yield [tag, href];
+	}
+}
+const ENTITY_RE = /&(?:#x([0-9a-f]+)|#(\d+)|(amp|lt|gt|quot|apos));/gi;
+const NAMED_ENTITIES = /* @__PURE__ */ new Map([
+	["amp", "&"],
+	["lt", "<"],
+	["gt", ">"],
+	["quot", "\""],
+	["apos", "'"]
+]);
+/** An attribute value as the browser reads it: character references decoded. */
+function attributeText(value) {
+	return value.replace(ENTITY_RE, (_, hex, decimal, named) => named === void 0 ? String.fromCodePoint(Number.parseInt(hex ?? decimal, hex ? 16 : 10)) : NAMED_ENTITIES.get(named.toLowerCase()));
+}
+/**
+* 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
+* added: the browser may then fetch the file twice. Each href is compared
+* as the browser resolves it against `pageUrl`, the URL the page is served
+* at, and reported as Animus wrote it.
+*/
+function duplicatedFontPreloads(html, pageUrl) {
+	const resolved = (href) => {
+		try {
+			return new URL(attributeText(href), pageUrl).href;
+		} catch {
+			return href;
+		}
+	};
+	const ours = /* @__PURE__ */ new Map();
+	const others = /* @__PURE__ */ new Set();
+	for (const [tag, href] of preloadLinks(html)) if (MARKER_RE.test(tag)) ours.set(resolved(href), href);
+	else others.add(resolved(href));
+	return [...ours].filter(([url]) => others.has(url)).map(([, href]) => href);
+}
+/** The hrefs the document already preloads. */
+function preloadedHrefs(html) {
+	return new Set([...preloadLinks(html)].map(([, href]) => href));
+}
+/** The head elements Animus's tags go after (the charset and viewport
+*  metas), the stylesheets they go before, and what holds neither. */
+const HEAD_SCAN_RE = /<!--[\s\S]*?-->|<script\b[\s\S]*?<\/script\s*>|<\/head\s*>|<style\b|<(?:meta|link)\b[^>]*>/gi;
+/** Where Animus's head tags go: after the head's charset and viewport
+*  metas, so they cannot push the charset past the 1024 bytes a browser
+*  sniffs for it, and before its first stylesheet; -1 without a `<head>`. */
+function headTagOffset(html) {
+	const open = /<head\b[^>]*>/i.exec(html);
+	if (open === null) return -1;
+	const start = open.index + open[0].length;
+	let offset = start;
+	for (const match of html.slice(start).matchAll(HEAD_SCAN_RE)) {
+		const [element] = match;
+		const lower = element.toLowerCase();
+		if (lower.startsWith("</head") || lower.startsWith("<style")) break;
+		if (lower.startsWith("<link")) {
+			if ((attribute(element, REL_RE)?.toLowerCase().split(/\s+/))?.includes("stylesheet")) break;
+		} else if (lower.startsWith("<meta") && (/\scharset\s*=/i.test(element) || /\shttp-equiv\s*=\s*["']?content-type\b/i.test(element) || /\sname\s*=\s*["']?viewport\b/i.test(element))) offset = start + match.index + element.length;
+	}
+	return offset;
+}
+/** As `escape-html` escapes, which Vite applies to attribute values. */
+function escapeHtml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+/** A tag as Vite serializes it, `children` as written, except that an
+*  undefined attribute is left out rather than written "undefined". */
+function serializeTag({ tag, attrs = {}, children }) {
+	const serialized = Object.entries(attrs).map(([key, value]) => {
+		if (value === true) return ` ${key}`;
+		if (value === false || value === void 0) return "";
+		return ` ${key}="${escapeHtml(value)}"`;
+	}).join("");
+	if (tag === "link" || tag === "meta" || tag === "base") return `<${tag}${serialized}>`;
+	return `<${tag}${serialized}>${Array.isArray(children) ? "" : children ?? ""}</${tag}>`;
+}
+/**
+* The hook's result: the tags written after the charset and viewport metas,
+* each on its own line indented as the element it follows, so the charset
+* stays in the first 1024 bytes however long the tags are; as `head-prepend`
+* tags for a document without a `<head>`.
+*/
+function injectHeadTags(html, tags) {
+	const offset = headTagOffset(html);
+	if (offset === -1) return tags;
+	if (tags.length === 0) return html;
+	const lineStart = html.lastIndexOf("\n", offset - 1) + 1;
+	const indent = /^[ \t]*/.exec(html.slice(lineStart))[0];
+	const inserted = tags.map((tag) => `\n${indent}${serializeTag(tag)}`).join("");
+	return html.slice(0, offset) + inserted + html.slice(offset);
+}
+/** The preloads for the faces that ask for one, each marked as Animus's;
+*  one the document already preloads is left out. */
+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, 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 {
+			tag: "link",
+			attrs,
+			injectTo: "head-prepend"
+		};
+	});
+}
+/**
+* Animus's head tags in document order: the bootstrap script, so it runs
+* before first paint and ahead of every stylesheet, the layer declaration,
+* the font preloads, then the development bridge.
+*/
+function buildIndexHtmlTags(ctx, html = "") {
+	const tags = [];
+	const bootstrap = ctx.options.appearanceBootstrap;
+	if (bootstrap?.code) tags.push({
+		tag: "script",
+		attrs: { "data-animus-bootstrap": "" },
+		children: bootstrap.code,
+		injectTo: "head-prepend"
+	});
+	if (ctx.layerDeclaration) tags.push({
+		tag: "style",
+		attrs: { "data-animus-layers": "" },
+		children: ctx.layerDeclaration,
+		injectTo: "head-prepend"
+	});
+	tags.push(...fontPreloadTags(ctx, html));
+	if (!ctx.isProd) tags.push({
+		tag: "script",
+		attrs: {
+			type: "module",
+			src: BRIDGE_SCRIPT_SRC,
+			"data-animus-bridge": ""
+		},
+		injectTo: "head-prepend"
+	});
+	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}>`);
+}
+/** The slice `file` holds, by its id, or a path to it from the root, as
+*  Vite versions spell it. */
+function sliceIdOf(file, sliceIds) {
+	if (file.type !== "asset") return void 0;
+	return sliceIds.find((slice) => file.originalFileNames.some((name) => name.endsWith(slice)));
+}
+/**
+* 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, replace) {
+	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 = sliceIdOf(file, sliceIds);
+		if (id === void 0) continue;
+		const replacement = replace?.(file);
+		if (replacement === void 0 || replacement === null) {
+			fileOf.set(id, file.fileName);
+			continue;
+		}
+		delete bundle[file.fileName];
+		fileOf.set(id, replacement);
+	}
+	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/bundle-removal.ts
+/**
+* The removal of every component no output file of this client build
+* includes, or `null` where the build keeps every component: it bundles
+* another environment beside the client (`otherEnvironments`), whose output
+* may render what the client's does not; it leaves a module external; it
+* carries data the scan cannot read as text; or an output file other than
+* Vite's `manifests` names a stylesheet slice, which a replacement would
+* leave naming a deleted file. Every output file but the slices
+* (`sliceIds`) and media is evidence, data URLs decoded.
+*/
+function bundleRemoval(ctx, bundle, sliceIds, context) {
+	const manifest = ctx.storedManifest;
+	if (!manifest) return null;
+	const keep = (why) => {
+		ctx.info(`kept every component's CSS: ${why}`);
+		return null;
+	};
+	const blocker = removalBlocker(bundle, context.otherEnvironments);
+	if (blocker !== null) return keep(blocker);
+	const slices = new Set(Object.values(bundle).filter((file) => sliceIdOf(file, sliceIds) !== void 0).map((file) => file.fileName));
+	const { texts, unreadable } = (0, _animus_ui_extract_pipeline.outputEvidence)(Object.values(bundle).map((file) => file.type === "chunk" ? {
+		fileName: file.fileName,
+		code: file.code
+	} : {
+		fileName: file.fileName,
+		bytes: Buffer.from(file.source)
+	}), slices);
+	if (unreadable !== null) return keep(`${unreadable} holds data the scan cannot read as text, which may name a class`);
+	for (const { fileName, text } of texts) for (const slice of slices) if (occurrences(text, node_path.posix.basename(slice)) > (context.manifests.has(fileName) ? occurrences(text, JSON.stringify(slice).slice(1, -1)) : 0)) return keep(`${fileName} names ${slice}, which a replacement would leave it naming`);
+	const components = manifest.components;
+	const removed = (0, _animus_ui_extract_pipeline.unbundledComponents)(components, (0, _animus_ui_extract_pipeline.shippedClasses)(texts.map(({ text }) => text), Object.values(components).map((component) => component.class_name)), new Set(Object.keys(ctx.options.staticCss?.components ?? {})));
+	const classes = new Set(removed.values());
+	let characters = 0;
+	const renamed = /* @__PURE__ */ new Map();
+	const went = /* @__PURE__ */ new Set();
+	const kept = /* @__PURE__ */ new Map();
+	const unread = /* @__PURE__ */ new Set();
+	return {
+		replace(file) {
+			const css = Buffer.from(file.source).toString("utf8");
+			let removal;
+			try {
+				removal = (0, _animus_ui_extract_pipeline.removeComponentRules)(css, classes, {
+					targets: ctx.lcssTargets,
+					keepDirSelector: ctx.options.keepDirSelector
+				});
+			} catch (error) {
+				ctx.warn(`[animus-extract] removeUnbundledComponents kept ${file.fileName} whole: Lightning CSS could not read it (${error instanceof Error ? error.message : String(error)})`);
+				for (const name of classes) if (css.includes(name)) unread.add(name);
+				return null;
+			}
+			for (const name of removal.went) went.add(name);
+			for (const [name, reason] of removal.kept) (0, _animus_ui_extract_pipeline.noteKept)(kept, name, reason);
+			const { css: pruned } = removal;
+			if (pruned === null) return null;
+			characters += css.length - pruned.length;
+			const extension = node_path.posix.extname(file.fileName);
+			const fileName = `${file.fileName.slice(0, -extension.length)}-${(0, _animus_ui_extract_pipeline.contentHash)(pruned).slice(0, 8)}${extension}`;
+			context.emit({
+				type: "asset",
+				fileName,
+				name: file.names[0],
+				originalFileName: file.originalFileNames[0],
+				source: pruned
+			});
+			renamed.set(file.fileName, fileName);
+			return fileName;
+		},
+		finish() {
+			for (const file of Object.values(bundle)) {
+				const imported = file.viteMetadata?.importedCss;
+				for (const [before, after] of renamed) if (imported?.delete(before)) imported.add(after);
+				if (file.type !== "asset" || !context.manifests.has(file.fileName)) continue;
+				let text = Buffer.from(file.source).toString("utf8");
+				for (const [before, after] of renamed) text = text.replaceAll(JSON.stringify(before).slice(1, -1), JSON.stringify(after).slice(1, -1));
+				file.source = text;
+			}
+			let count = 0;
+			let ruleless = 0;
+			const whole = /* @__PURE__ */ new Map();
+			for (const [id, className] of removed) {
+				const reason = kept.get(className) ?? (unread.has(className) ? "unreadable" : void 0);
+				if (went.has(className)) {
+					count += 1;
+					ctx.trace(`removed ${id} (${className}): no output file includes it`);
+				} else if (reason === void 0) {
+					ruleless += 1;
+					ctx.trace(`${id} (${className}): no output file includes it, and no rule names it`);
+				} else {
+					whole.set(reason, (whole.get(reason) ?? 0) + 1);
+					ctx.trace(`kept ${id} (${className}) whole, though no output file includes it: ${KEPT_WHOLE[reason]}`);
+				}
+			}
+			const keptWhole = [...whole].map(([reason, n]) => `${KEPT_WHOLE[reason]}: ${n}`).join(", ");
+			const wholeCount = [...whole.values()].reduce((sum, n) => sum + n, 0);
+			ctx.info(`removed the CSS of ${count} of ${Object.keys(components).length} components no output file includes (${characters} characters of the stylesheet)${wholeCount > 0 ? `; kept ${wholeCount} more whole (${keptWhole})` : ""}${ruleless > 0 ? `; with no rules to remove: ${ruleless}` : ""}`);
+		}
+	};
+}
+/** Each reason, as the trace and the build's report print it. */
+const KEPT_WHOLE = {
+	"shared-list": "shares a selector list with a kept component",
+	nested: "a rule naming it holds nested rules removal cannot prove unused",
+	conditional: "named only where a selector can match without it, or in a pseudo-class argument removal does not read, such as :not(), :has(), :host(), or an :is() or :where() with an alternative that does not need it",
+	unreadable: "in a stylesheet Lightning CSS could not read"
+};
+/** How many times `needle` occurs in `text`. */
+function occurrences(text, needle) {
+	let count = 0;
+	for (let at = text.indexOf(needle); at !== -1; at = text.indexOf(needle, at + 1)) count += 1;
+	return count;
+}
+/** Why a client build keeps every component, or `null`. */
+function removalBlocker(bundle, otherEnvironments) {
+	if (otherEnvironments.length > 0) return `this build also bundles ${otherEnvironments.join(", ")}, whose output may render what the client's does not`;
+	for (const file of Object.values(bundle)) {
+		if (file.type !== "chunk") continue;
+		const external = [...file.imports, ...file.dynamicImports].find((imported) => !(imported in bundle));
+		if (external !== void 0) return `the build leaves ${external} external, which may render components no output file includes`;
+	}
+	return null;
+}
+//#endregion
 //#region src/config.ts
 function applyResolvedConfig(ctx, config) {
 	ctx.isProd = config.command === "build";
@@ -218,51 +642,15 @@ function applyResolvedConfig(ctx, config) {
 			pattern: entry.find,
 			target: entry.replacement,
 			kind: "prefix"
-		});
-	}
-	const built = (0, _animus_ui_extract_pipeline.buildPathAliasesJson)(pairs, ctx.rootDir);
-	if (built) {
-		ctx.pathAliasesJson = built.json;
-		ctx.log(`Path aliases forwarded: ${built.count} entries`);
-	}
-	ctx.createSession();
-}
-//#endregion
-//#region src/constants.ts
-/**
-* The namespace every virtual module here lives under; the `transform` guard
-* matches on this same string so a rename cannot strand it.
-*/
-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`;
-const RESOLVED_BRIDGE_ID = `\0${VIRTUAL_BRIDGE_ID}`;
-/**
-* Vite reserves `/@id/` for module ids that are not file paths and strips the
-* prefix before `resolveId`, so the unprefixed specifier travels here.
-*/
-const BRIDGE_SCRIPT_SRC = `/@id/${VIRTUAL_BRIDGE_ID}`;
-const VIRTUAL_SYSTEM_PROPS_ID = `${VIRTUAL_PREFIX}system-props`;
-const RESOLVED_SYSTEM_PROPS_ID = `\0${VIRTUAL_SYSTEM_PROPS_ID}`;
-/** The faces this build preloads, with the URL each file is preloaded at:
-*  the module every host serves under this id. */
-const VIRTUAL_FONT_PRELOADS_ID = _animus_ui_extract_session.FONT_PRELOADS_MODULE_ID;
-const RESOLVED_FONT_PRELOADS_ID = `\0${VIRTUAL_FONT_PRELOADS_ID}`;
+		});
+	}
+	const built = (0, _animus_ui_extract_pipeline.buildPathAliasesJson)(pairs, ctx.rootDir);
+	if (built) {
+		ctx.pathAliasesJson = built.json;
+		ctx.log(`Path aliases forwarded: ${built.count} entries`);
+	}
+	ctx.createSession();
+}
 //#endregion
 //#region src/hot-update-events.ts
 /**
@@ -1368,255 +1756,6 @@ function invalidateStaleModules(ctx, environment, modules, analyzed) {
 	}
 }
 //#endregion
-//#region src/index-html.ts
-const LINK_TAG_RE = /<link\b[^>]*>/gi;
-/** Marks the preloads Animus writes, so another preload of the same file
-*  can be told from Animus's own. */
-const ANIMUS_PRELOAD_MARKER = "data-animus-preload";
-const MARKER_RE = /\sdata-animus-preload(?=[\s=/>])/i;
-const REL_RE = /\srel\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i;
-const HREF_RE = /\shref\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i;
-function attribute(tag, re) {
-	const match = re.exec(tag);
-	return match ? match[1] ?? match[2] ?? match[3] : void 0;
-}
-/** Each `<link rel="preload">` in `html`, with its href. */
-function* preloadLinks(html) {
-	for (const [tag] of html.matchAll(LINK_TAG_RE)) {
-		const rel = attribute(tag, REL_RE)?.toLowerCase().split(/\s+/) ?? [];
-		const href = attribute(tag, HREF_RE);
-		if (rel.includes("preload") && href !== void 0) yield [tag, href];
-	}
-}
-const ENTITY_RE = /&(?:#x([0-9a-f]+)|#(\d+)|(amp|lt|gt|quot|apos));/gi;
-const NAMED_ENTITIES = /* @__PURE__ */ new Map([
-	["amp", "&"],
-	["lt", "<"],
-	["gt", ">"],
-	["quot", "\""],
-	["apos", "'"]
-]);
-/** An attribute value as the browser reads it: character references decoded. */
-function attributeText(value) {
-	return value.replace(ENTITY_RE, (_, hex, decimal, named) => named === void 0 ? String.fromCodePoint(Number.parseInt(hex ?? decimal, hex ? 16 : 10)) : NAMED_ENTITIES.get(named.toLowerCase()));
-}
-/**
-* 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
-* added: the browser may then fetch the file twice. Each href is compared
-* as the browser resolves it against `pageUrl`, the URL the page is served
-* at, and reported as Animus wrote it.
-*/
-function duplicatedFontPreloads(html, pageUrl) {
-	const resolved = (href) => {
-		try {
-			return new URL(attributeText(href), pageUrl).href;
-		} catch {
-			return href;
-		}
-	};
-	const ours = /* @__PURE__ */ new Map();
-	const others = /* @__PURE__ */ new Set();
-	for (const [tag, href] of preloadLinks(html)) if (MARKER_RE.test(tag)) ours.set(resolved(href), href);
-	else others.add(resolved(href));
-	return [...ours].filter(([url]) => others.has(url)).map(([, href]) => href);
-}
-/** The hrefs the document already preloads. */
-function preloadedHrefs(html) {
-	return new Set([...preloadLinks(html)].map(([, href]) => href));
-}
-/** The head elements Animus's tags go after (the charset and viewport
-*  metas), the stylesheets they go before, and what holds neither. */
-const HEAD_SCAN_RE = /<!--[\s\S]*?-->|<script\b[\s\S]*?<\/script\s*>|<\/head\s*>|<style\b|<(?:meta|link)\b[^>]*>/gi;
-/** Where Animus's head tags go: after the head's charset and viewport
-*  metas, so they cannot push the charset past the 1024 bytes a browser
-*  sniffs for it, and before its first stylesheet; -1 without a `<head>`. */
-function headTagOffset(html) {
-	const open = /<head\b[^>]*>/i.exec(html);
-	if (open === null) return -1;
-	const start = open.index + open[0].length;
-	let offset = start;
-	for (const match of html.slice(start).matchAll(HEAD_SCAN_RE)) {
-		const [element] = match;
-		const lower = element.toLowerCase();
-		if (lower.startsWith("</head") || lower.startsWith("<style")) break;
-		if (lower.startsWith("<link")) {
-			if ((attribute(element, REL_RE)?.toLowerCase().split(/\s+/))?.includes("stylesheet")) break;
-		} else if (lower.startsWith("<meta") && (/\scharset\s*=/i.test(element) || /\shttp-equiv\s*=\s*["']?content-type\b/i.test(element) || /\sname\s*=\s*["']?viewport\b/i.test(element))) offset = start + match.index + element.length;
-	}
-	return offset;
-}
-/** As `escape-html` escapes, which Vite applies to attribute values. */
-function escapeHtml(value) {
-	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-}
-/** A tag as Vite serializes it, `children` as written, except that an
-*  undefined attribute is left out rather than written "undefined". */
-function serializeTag({ tag, attrs = {}, children }) {
-	const serialized = Object.entries(attrs).map(([key, value]) => {
-		if (value === true) return ` ${key}`;
-		if (value === false || value === void 0) return "";
-		return ` ${key}="${escapeHtml(value)}"`;
-	}).join("");
-	if (tag === "link" || tag === "meta" || tag === "base") return `<${tag}${serialized}>`;
-	return `<${tag}${serialized}>${Array.isArray(children) ? "" : children ?? ""}</${tag}>`;
-}
-/**
-* The hook's result: the tags written after the charset and viewport metas,
-* each on its own line indented as the element it follows, so the charset
-* stays in the first 1024 bytes however long the tags are; as `head-prepend`
-* tags for a document without a `<head>`.
-*/
-function injectHeadTags(html, tags) {
-	const offset = headTagOffset(html);
-	if (offset === -1) return tags;
-	if (tags.length === 0) return html;
-	const lineStart = html.lastIndexOf("\n", offset - 1) + 1;
-	const indent = /^[ \t]*/.exec(html.slice(lineStart))[0];
-	const inserted = tags.map((tag) => `\n${indent}${serializeTag(tag)}`).join("");
-	return html.slice(0, offset) + inserted + html.slice(offset);
-}
-/** The preloads for the faces that ask for one, each marked as Animus's;
-*  one the document already preloads is left out. */
-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, 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 {
-			tag: "link",
-			attrs,
-			injectTo: "head-prepend"
-		};
-	});
-}
-/**
-* Animus's head tags in document order: the bootstrap script, so it runs
-* before first paint and ahead of every stylesheet, the layer declaration,
-* the font preloads, then the development bridge.
-*/
-function buildIndexHtmlTags(ctx, html = "") {
-	const tags = [];
-	const bootstrap = ctx.options.appearanceBootstrap;
-	if (bootstrap?.code) tags.push({
-		tag: "script",
-		attrs: { "data-animus-bootstrap": "" },
-		children: bootstrap.code,
-		injectTo: "head-prepend"
-	});
-	if (ctx.layerDeclaration) tags.push({
-		tag: "style",
-		attrs: { "data-animus-layers": "" },
-		children: ctx.layerDeclaration,
-		injectTo: "head-prepend"
-	});
-	tags.push(...fontPreloadTags(ctx, html));
-	if (!ctx.isProd) tags.push({
-		tag: "script",
-		attrs: {
-			type: "module",
-			src: BRIDGE_SCRIPT_SRC,
-			"data-animus-bridge": ""
-		},
-		injectTo: "head-prepend"
-	});
-	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
 /**
 * layergate's Vite plugin for the `quarantine` option, loaded on first use:
@@ -1836,7 +1975,8 @@ function animusExtract(options) {
 	(0, _animus_ui_extract_pipeline.assertKnownOptionKeys)(options, [
 		"verify",
 		"appearanceBootstrap",
-		"quarantine"
+		"quarantine",
+		"removeUnbundledComponents"
 	], [{
 		key: "root",
 		reason: "the Vite driver derives its root from the resolved Vite config"
@@ -1844,6 +1984,8 @@ function animusExtract(options) {
 		onUnknownKey: "warn",
 		warn: (message) => console.warn(`[animus-extract] ${message}`)
 	});
+	const removes = options.removeUnbundledComponents === true;
+	if (removes && options.stylesheets !== "split") throw new _animus_ui_extract_pipeline.AnimusConfigError("removeUnbundledComponents needs stylesheets: 'split': it removes CSS from the stylesheet's own files, which only a split build emits after its scripts.");
 	const vendor = options.quarantine ? quarantinePlugin(options.quarantine, options.layers) : null;
 	const ctx = new PluginContext(vendor ? {
 		...options,
@@ -1855,6 +1997,8 @@ function animusExtract(options) {
 		const layergate = await vendor?.plugin();
 		return layergate ? await layergate.stylesheetHead.call(context, RESOLVED_CSS_ID) + sheet : sheet;
 	}
+	let otherEnvironments = [];
+	let manifests = /* @__PURE__ */ new Set();
 	let slices = /* @__PURE__ */ new Map();
 	let linkedSlices = [];
 	return {
@@ -1888,6 +2032,9 @@ function animusExtract(options) {
 		},
 		async configResolved(config) {
 			applyResolvedConfig(ctx, config);
+			otherEnvironments = config.builder ? Object.keys(config.environments).filter((name) => name !== "client") : [];
+			const { manifest, ssrManifest } = config.build;
+			manifests = /* @__PURE__ */ new Set([...manifest === true ? [".vite/manifest.json"] : manifest ? [manifest] : [], ...ssrManifest === true ? [".vite/ssr-manifest.json"] : ssrManifest ? [ssrManifest] : []]);
 			(await vendor?.plugin())?.configResolved.call(this, config);
 		},
 		async buildEnd() {
@@ -1957,11 +2104,20 @@ 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({
+				const emitAsset = (name, source) => this.getFileName(this.emitFile({
 					type: "asset",
 					name,
 					source
-				})));
+				}));
+				if (linkedSlices.length > 0 && isClient(this)) {
+					const removal = removes ? bundleRemoval(ctx, bundle, linkedSlices, {
+						otherEnvironments,
+						manifests,
+						emit: (asset) => this.emitFile(asset)
+					}) : null;
+					placeStylesheetSlices(ctx, bundle, linkedSlices, emitAsset, removal ? (file) => removal.replace(file) : void 0);
+					removal?.finish();
+				}
 				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("))) {

package/dist/index.d.ts

@@ -44,6 +44,16 @@ export interface AnimusExtractOptions {
      *  hash. Needs a page Vite builds from HTML to link the stylesheet; the
      *  dev server keeps one sheet. */
     stylesheets?: StylesheetDelivery;
+    /** With `stylesheets: 'split'`, removes from the stylesheet's files the
+     *  CSS of every component whose definition no output file includes, so it
+     *  can never render; a component `staticCss` declares, and a parent of
+     *  one kept, stay. A build that bundles another environment beside the
+     *  client, or leaves a module external, keeps every component. Scripts a
+     *  plugin emits after Animus's `generateBundle` are not seen, and a
+     *  stylesheet shared with code outside the build (micro-frontends, module
+     *  federation) is unsupported with this on. Off by default, and in
+     *  development. */
+    removeUnbundledComponents?: boolean;
     /**
      * Substrings, or globs when `*`/`?` present. Replaces the defaults `dist`,
      * `.test.`, `.spec.`; `node_modules`, `.next`, `.animus` always apply.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwCA,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;;;;;;0DAMsD;IACtD,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC;4DACwD;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;;;;0DAKsD;IACtD,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,CA8RnE;eAEc,aAAa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0CA,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;;;;;;;;uBAQmB;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC;;;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;;;;;;0DAMsD;IACtD,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC;4DACwD;IACxD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACpC;;;;;0DAKsD;IACtD,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,CA8UnE;eAEc,aAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/vite-plugin",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "Animus static CSS extraction Vite plugin",
   "keywords": [
     "animus",
@@ -43,16 +43,16 @@
     "compile": "bun check"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.49",
+    "@animus-ui/extract": "0.1.51",
     "browserslist": "^4.28.8",
     "lightningcss": "^1.33.0"
   },
   "devDependencies": {
-    "@animus-ui/assertions": "0.1.49",
-    "@animus-ui/layergate": "0.1.49"
+    "@animus-ui/assertions": "0.1.51",
+    "@animus-ui/layergate": "0.1.51"
   },
   "peerDependencies": {
-    "@animus-ui/layergate": "0.1.49",
+    "@animus-ui/layergate": "0.1.51",
     "vite": ">=8 <9"
   },
   "peerDependenciesMeta": {