@animus-ui/vite-plugin 0.1.35 → 0.1.37

package/README.md

@@ -60,7 +60,8 @@ export default defineConfig({
 ```
 
 The plugin is **delivery-only**: it injects `artifact.code` verbatim as an inline
-`<script data-animus-bootstrap>` at the start of `<head>`, ahead of every
+`<script data-animus-bootstrap>` in `<head>`, after the charset and viewport
+metas (so the charset stays within the first 1024 bytes) and ahead of every
 stylesheet reference, and interprets no appearance semantics. Omit the option and
 the built HTML is byte-for-byte what it was before.
 
@@ -99,12 +100,42 @@ Router examples live in the
 ## Font preloads
 
 A font face declared with `preload: true` gets a
-`<link rel="preload" as="font" crossorigin>` at the start of `<head>`, ahead
-of every stylesheet reference, with a `preconnect` for a file on another
-origin. Its href is the URL the stylesheet's `url()` loads: the hashed asset
-in a build, the dev server's URL in development. A root-relative or
-absolute URL that `index.html` already preloads gets no second preload; an
-`asset()` file's preload is not compared with one written in the HTML.
+`<link rel="preload" as="font" crossorigin data-animus-preload>` in `<head>`,
+after the charset and viewport metas and ahead of every stylesheet link. Its
+href is the URL the stylesheet's `url()` loads: the hashed asset in a build,
+the dev server's URL in development. A root-relative or absolute URL that
+`index.html` already preloads gets no second preload. A build warns, naming
+the HTML page, when the finished page preloads the same file through another
+tag: one written in the page for an `asset()` file, or one a plugin adds from
+an `index.html` hook that runs after Animus's.
+
+`fontPreloads` selects the faces that preload in place of their `preload`
+flags, for an app that renders only some of a system's faces. A family name
+selects every face of the family; `{ family, weight?, style? }` selects the
+faces whose declared weight contains `weight` (a variable face's range
+`'100 900'` contains 600) and whose style is `style` (`'normal'` when
+omitted):
+
+```ts
+animusExtract({
+  system: './src/ds.ts',
+  fontPreloads: [
+    { family: 'Apercu', weight: 400 },
+    { family: 'Apercu', weight: 'bold' },
+    { family: 'Suisse', weight: 700 },
+  ],
+});
+```
+
+`[]` 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`.
+
+A preload competes with the critical CSS and JavaScript for first paint, so
+preload WOFF2 and only the faces the first screen needs: a large TrueType
+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`.
 
 ## Third-party stylesheets
 

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,iBAAiB,EAGjB,iBAAiB,EAGlB,MAAM,4BAA4B,CAAC;AAWpC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAEV,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAgBnC;2BAC2B;AAC3B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAiBD,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,MAAM,UAAS;IACf;uCACmC;IACnC,WAAW,UAAS;IACpB;8EAC0E;IAC1E,YAAY,UAAS;IACrB,OAAO,SAAM;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,WAAW,EAAE,gBAAgB,CAAM;IAEnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,EAAE,CAAM;IACjC,OAAO,CAAC,mBAAmB,CAAkC;IAC7D;4BACwB;IACxB,IAAI,eAAe,IAAI,mBAAmB,CAEzC;IACD,IAAI,eAAe,CAAC,MAAM,EAAE,mBAAmB,EAE9C;IACD,iEAAiE;IACjE,mBAAmB,EAAE,uBAAuB,CACL;IACvC;wEACoE;IACpE,YAAY,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAE3C,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC;iDAC6C;IAC7C,cAAc,EAAG,cAAc,CAAC;IAEhC;;4BAEwB;IACxB,cAAc,EAAE,MAAM,EAAE,CAAM;IAC9B,kEAAkE;IAClE,WAAW,EAAE,MAAM,EAAE,CAAM;IAE3B;;qEAEiE;IACjE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IACzC,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuB;IAEzD,IAAI,cAAc,IAAI,eAAe,GAAG,IAAI,CAE3C;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAEhD;IAED;;mBAEe;IACf,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAElC;IAED;4EACwE;IACxE,IAAI,yBAAyB,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5D;IAED,IAAI,qBAAqB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD;IAED;;+BAE2B;IAC3B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAOzB,gBAAgB,SAAM;IAEtB,qBAAqB,sBAA6B;IAElD,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9D;IAED;;;oDAGgD;IAChD,QAAQ,CAAC,kBAAkB,sBAA6B;IAExD,QAAQ,CAAC,eAAe,kBAAyB;IAEjD,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE1B;IAEH,IAAI,SAAO;IACX;iBACa;IACb,QAAQ,SAAM;IACd,YAAY,SAAM;IAClB,mEAAmE;IACnE,SAAS,SAAM;IAIf,mBAAmB,sBAA6B;IAEhD;;kEAE8D;IAC9D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnC,8DAA8D;IAC9D,sBAAsB,sBAA6B;IACnD,uEAAuE;IACvE,OAAO,CAAC,gBAAgB,CAA+B;IACvD,wEAAwE;IACxE,OAAO,CAAC,mBAAmB,CAAqB;IAChD;mCAC+B;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAc;IAEnD,uBAAuB,cAAqB;IAE5C,iBAAiB,UAAS;IAE1B,yEAAyE;IACzE,uBAAuB,EAAE,sBAAsB,EAAE,CAAM;IAEvD,SAAS,EAAE,GAAG,CAAC;IAEf;8EAC0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IAKnE,mEAAmE;IAEnE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC;IAC9B;qDACiD;IAEjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,CAAiB;IAC9C,OAAO,CAAC,SAAS,CAA2B;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,KAAK,SAAmB;IACjC,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IACzC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAElE,YACE,OAAO,EAAE,oBAAoB,EAI7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,EA4C9B;IAED;mDAC+C;IAC/C,aAAa,IAAI,iBAAiB,CAwDjC;IAED;uCACmC;IACnC,OAAO,CAAC,cAAc;IAsBtB;6EACyE;IACzE,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAM/D;IAED;;;4DAGwD;IAClD,UAAU,CACd,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACrD,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB5B;IAED;wCACoC;IACpC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAKjD;IAED;;2CAEuC;IACvC,QAAQ,CAAC,MAAM,oBAA2B;IAE1C;;6EAEyE;IACzE,KAAK,IAAI,IAAI,CAGZ;IAED;gEAC4D;IAC5D,aAAa,IAAI,IAAI,CAIpB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIrB;IAED;qDACiD;IACjD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvB;IAED;6BACyB;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED;yEACqE;IACrE,YAAY,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAUtD;IAED;+EAC2E;IAC3E,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAMpD;IAED;;;;8EAI0E;IAC1E,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUpC;IAED;;yDAEqD;IACrD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAevC;IAED;6EACyE;IACzE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBtD;IAED;;uDAEmD;IACnD,OAAO,CAAC,eAAe;IAevB,2DAA2D;IAC3D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKtC;IAED;oCACgC;IAChC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBxC;IAED,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAKvE;IAED,8DAA8D;IAC9D,oBAAoB,IAAI,MAAM,EAAE,CAM/B;IAED;;;gDAG4C;IAC5C,IAAI,WAAW,IAAI,MAAM,CAKxB;IAED;8EAC0E;IAC1E,OAAO,CAAC,uBAAuB;IA2B/B,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAYzD;IAED,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3C;IAED;;;;;;0DAMsD;IACtD,wBAAwB,IAAI,IAAI,CAsB/B;IAED;;;yEAGqE;IACrE,0BAA0B,IAAI,IAAI,CAcjC;IAED,aAAa,IAAI,IAAI,CA2BpB;CACF"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/index-html.d.ts

@@ -1,9 +1,24 @@
 import type { PluginContext } from './context';
 import type { HtmlTagDescriptor } from 'vite';
 /**
- * Vite serializes one `head-prepend` bucket in array order, so the bootstrap
- * script precedes the font preloads, the layer declaration and every
- * stylesheet reference.
+ * 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.
+ */
+export declare function duplicatedFontPreloads(html: string, pageUrl: string): string[];
+/**
+ * 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>`.
+ */
+export declare function injectHeadTags(html: string, tags: HtmlTagDescriptor[]): string | HtmlTagDescriptor[];
+/**
+ * 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.
  */
 export declare function buildIndexHtmlTags(ctx: PluginContext, html?: string): HtmlTagDescriptor[];
 //# 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":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAuD9C;;;;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,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;AAkCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,IAAI,SAAK,GACR,iBAAiB,EAAE,CAuCrB"}

package/dist/index.cjs

@@ -535,6 +535,7 @@ var PluginContext = class {
 			engine: options.engine,
 			runtimeImport: options.runtimeImport,
 			closedDynamicImports: options.closedDynamicImports,
+			fontPreloads: options.fontPreloads,
 			mode: this.emissionProd ? "production" : "development"
 		}, {
 			build: this.build,
@@ -1322,57 +1323,142 @@ 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;
 }
-/** The hrefs the document already preloads. */
-function preloadedHrefs(html) {
-	const hrefs = /* @__PURE__ */ new Set();
+/** 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) hrefs.add(href);
+		if (rel.includes("preload") && href !== void 0) yield [tag, href];
 	}
-	return hrefs;
 }
-/** The preconnects and preloads for the faces that ask for one, by the
-*  URL the stylesheet's own `url()` gets; one the document already
+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, by the URL the stylesheet's
+*  own `url()` gets, each marked as Animus's; one the document already
 *  preloads is left out. */
 function fontPreloadTags(ctx, html) {
 	const published = ctx.served?.fontPreloads ?? [];
 	if (published.length === 0) return [];
 	const existing = preloadedHrefs(html);
-	const preloads = (0, _animus_ui_extract_pipeline.substituteFontPreloads)(published, ctx.assetUrlBySpecifier).map((preload) => ctx.isProd ? preload : {
+	return (0, _animus_ui_extract_pipeline.substituteFontPreloads)(published, ctx.assetUrlBySpecifier).map((preload) => ctx.isProd ? preload : {
 		...preload,
 		href: ctx.devRootRelativeUrl(preload.href)
-	}).filter(({ href }) => !existing.has(href));
-	return [...(0, _animus_ui_extract_pipeline.fontPreloadOrigins)(preloads.map(({ href }) => href)).map((origin) => ({
-		tag: "link",
-		attrs: {
-			rel: "preconnect",
-			href: origin,
-			crossorigin: true
-		},
-		injectTo: "head-prepend"
-	})), ...preloads.map(({ href, type }) => ({
-		tag: "link",
-		attrs: {
+	}).filter(({ href }) => !existing.has(href)).map(({ href, type }) => {
+		const attrs = {
 			rel: "preload",
 			href,
-			as: "font",
-			type,
-			crossorigin: true
-		},
-		injectTo: "head-prepend"
-	}))];
+			as: "font"
+		};
+		if (type !== void 0) attrs.type = type;
+		attrs.crossorigin = true;
+		attrs[ANIMUS_PRELOAD_MARKER] = true;
+		return {
+			tag: "link",
+			attrs,
+			injectTo: "head-prepend"
+		};
+	});
 }
 /**
-* Vite serializes one `head-prepend` bucket in array order, so the bootstrap
-* script precedes the font preloads, the layer declaration and every
-* stylesheet reference.
+* 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 = [];
@@ -1383,13 +1469,13 @@ function buildIndexHtmlTags(ctx, html = "") {
 		children: bootstrap.code,
 		injectTo: "head-prepend"
 	});
-	tags.push(...fontPreloadTags(ctx, html));
 	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: {
@@ -1577,6 +1663,15 @@ async function sourceKitConfig(rootDir, systemPath, engine) {
 		roots: [...kits.values()].map((kit) => kit.root)
 	};
 }
+/** 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. */
+function servedBase(base) {
+	const origin = "https://animus.invalid/";
+	if (/^[a-z][a-z\d+.-]*:/i.test(base)) return new URL(base.replace(/\/?$/, "/"));
+	if (base.startsWith("/")) return new URL(base.replace(/\/?$/, "/"), origin);
+	return new URL(origin);
+}
 function animusExtract(options) {
 	(0, _animus_ui_extract_pipeline.assertSupportedEngine)(options.engine);
 	(0, _animus_ui_extract_pipeline.assertKnownOptionKeys)(options, [
@@ -1666,10 +1761,22 @@ function animusExtract(options) {
 			if (vendor && /\.css(?:$|\?)/.test(id)) return (await vendor.plugin()).transform.call(this, code, id);
 			return transformSource(ctx, code, id);
 		},
+		generateBundle: {
+			order: "post",
+			handler(_output, bundle) {
+				if (!ctx.served?.fontPreloads.length) return;
+				for (const file of Object.values(bundle)) {
+					if (file.type !== "asset" || !file.fileName.endsWith(".html")) continue;
+					const html = Buffer.from(file.source).toString("utf8");
+					if (!html.includes("data-animus-preload")) continue;
+					for (const href of duplicatedFontPreloads(html, new URL(file.fileName, servedBase(ctx.base)).href)) ctx.warn(`[animus-extract] ${file.fileName} preloads ${href} twice: Animus's font preload and another preload tag, written in the page or added by a plugin whose index.html hook runs after Animus's, so the browser may fetch it twice. Remove the other preload; Animus's names the URL the stylesheet's url() loads.`);
+				}
+			}
+		},
 		transformIndexHtml: {
 			order: "pre",
 			handler(html) {
-				return buildIndexHtmlTags(ctx, html);
+				return injectHeadTags(html, buildIndexHtmlTags(ctx, html));
 			}
 		},
 		async hotUpdate(hmr) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { AnimusQuarantineOptions, ClosedDynamicImport, DiagnosticLevels, StaticCssConfig } from '@animus-ui/extract/pipeline';
+import type { AnimusQuarantineOptions, ClosedDynamicImport, FontPreloadEntry, DiagnosticLevels, StaticCssConfig } 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';
@@ -26,6 +26,11 @@ export interface AnimusExtractOptions {
      * still load any module.
      */
     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. */
+    fontPreloads?: FontPreloadEntry[];
     /**
      * 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":"AAuBA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,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;AA+C3E,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;;;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;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAoLnE;eAEc,aAAa"}
+{"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;AA+C3E,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"}

package/package.json

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