fontaine 0.8.2 → 1.0.0

package/dist/index.cjs

@@ -21,10 +21,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_metrics = require("./metrics-ChAPPk2j.cjs");
+const require_metrics = require("./metrics-CS5CISMK.cjs");
 let css_tree = require("css-tree");
-let magic_regexp = require("magic-regexp");
-let pathe = require("pathe");
+let node_path = require("node:path");
 let node_url = require("node:url");
 let node_fs_promises = require("node:fs/promises");
 let node_module = require("node:module");
@@ -37,9 +36,9 @@ const supportedExtensions = [
 	"woff",
 	"ttf"
 ];
-const CSS_RE = (0, magic_regexp.createRegExp)((0, magic_regexp.exactly)(".").and((0, magic_regexp.anyOf)("sass", "css", "scss")).and((0, magic_regexp.exactly)("?").and((0, magic_regexp.oneOrMore)(magic_regexp.char)).optionally()).at.lineEnd());
-const RELATIVE_RE = (0, magic_regexp.createRegExp)((0, magic_regexp.exactly)(".").or("..").and((0, magic_regexp.anyOf)("/", "\\")).at.lineStart());
-const SCSS_RE = (0, magic_regexp.createRegExp)((0, magic_regexp.exactly)(".").and((0, magic_regexp.anyOf)("sass", "scss")).and((0, magic_regexp.exactly)("?").and((0, magic_regexp.oneOrMore)(magic_regexp.char)).optionally()).at.lineEnd());
+const CSS_RE = /\.(?:sass|css|scss)(?:\?.+)?$/;
+const RELATIVE_RE = /^(?:\.|\.\.)(?:\/|\\)/;
+const SCSS_RE = /\.(?:sass|scss)(?:\?.+)?$/;
 /**
 * Replaces `//` line comments with spaces, preserving offsets.
 *
@@ -105,7 +104,7 @@ function extractCssImports(ast) {
 }
 function resolveCssImport(specifier, importer) {
 	try {
-		if (RELATIVE_RE.test(specifier) || (0, pathe.isAbsolute)(specifier)) return (0, node_url.fileURLToPath)(new URL(specifier, (0, node_url.pathToFileURL)(importer)));
+		if (RELATIVE_RE.test(specifier) || (0, node_path.isAbsolute)(specifier)) return (0, node_url.fileURLToPath)(new URL(specifier, (0, node_url.pathToFileURL)(importer)));
 		return (0, node_module.createRequire)(importer).resolve(specifier.replace(/^~/, ""));
 	} catch {
 		return;
@@ -120,7 +119,6 @@ function resolveCssImport(specifier, importer) {
 const FontaineTransform = (0, unplugin.createUnplugin)((options) => {
 	const cssContext = options.css = options.css || {};
 	cssContext.value = "";
-	const resolvePath = options.resolvePath || ((id) => id);
 	const fallbackName = options.fallbackName || options.overrideName || require_metrics.generateFallbackName;
 	const skipFontFaceGeneration = options.skipFontFaceGeneration || (() => false);
 	return {
@@ -137,7 +135,7 @@ const FontaineTransform = (0, unplugin.createUnplugin)((options) => {
 					importer: id,
 					prefix: ""
 				}));
-				if ((0, pathe.isAbsolute)(id)) {
+				if ((0, node_path.isAbsolute)(id)) {
 					const imports = extractCssImports(ast);
 					const insertionIndex = imports.length ? Math.max(...imports.map((i) => i.end)) : 0;
 					const seen = /* @__PURE__ */ new Set([id]);
@@ -169,7 +167,7 @@ const FontaineTransform = (0, unplugin.createUnplugin)((options) => {
 					const source = rawSource && require_metrics.withoutQueryOrFragment(rawSource);
 					if (!supportedExtensions.some((e) => source?.endsWith(e))) continue;
 					if (skipFontFaceGeneration(fallbackName(family))) continue;
-					const metrics = await require_metrics.getMetricsForFamily(family) || source && await require_metrics.readMetricsForSource(source, importer, resolvePath).catch(() => null);
+					const metrics = await require_metrics.getMetricsForFamily(family) || source && await require_metrics.readMetricsForSource(source, importer, options.resolvePath).catch(() => null);
 					/* v8 ignore next 2 */
 					if (!metrics) continue;
 					const familyFallbacks = require_metrics.resolveCategoryFallbacks({

package/dist/index.d.cts

@@ -8,7 +8,7 @@ import { createUnplugin } from "unplugin";
  * @param {string} name - The full font family string.
  * @returns {string} - The fallback font name.
  */
-declare function generateFallbackName(name: string): string;
+export declare function generateFallbackName(name: string): string;
 interface FallbackOptions {
   /**
    * The name of the fallback font.
@@ -37,7 +37,7 @@ type FontFaceMetrics = Pick<Font, "ascent" | "descent" | "lineGap" | "unitsPerEm
  * @param {FallbackOptions} fallback - The fallback options, including name, font and optional metrics. See {@link FallbackOptions}.
  * @returns {string} - The full `@font-face` CSS declaration.
  */
-declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOptions): string;
+export declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOptions): string;
 //#endregion
 //#region src/metrics.d.ts
 /**
@@ -46,15 +46,16 @@ declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOp
  * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves with the filtered font metrics or null if not found. See {@link FontFaceMetrics}.
  * @async
  */
-declare function getMetricsForFamily(family: string): Promise<FontFaceMetrics | null>;
+export declare function getMetricsForFamily(family: string): Promise<FontFaceMetrics | null>;
 /**
- * Reads font metrics from a specified source URL or file path. This function supports both local files and remote URLs.
+ * Reads font metrics from a source URL, which may be a `file:` URL or a remote one. A string
+ * that is not a URL, such as a bare path or a root-relative one, resolves to `null`.
  * It caches the results to optimise subsequent requests for the same source.
- * @param {URL | string} _source - The source URL or local file path from which to read the font metrics.
+ * @param {URL | string} _source - The source URL from which to read the font metrics.
  * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves to the filtered font metrics or null if the source cannot be processed.
  * @async
  */
-declare function readMetrics(_source: URL | string): Promise<FontFaceMetrics | null>;
+export declare function readMetrics(_source: URL | string): Promise<FontFaceMetrics | null>;
 //#endregion
 //#region src/transform.d.ts
 interface FontaineTransformOptions {
@@ -83,8 +84,8 @@ interface FontaineTransformOptions {
    */
   categoryFallbacks?: Partial<Record<FontCategory, string[]>>;
   /**
-   * Function to resolve a given path to a valid URL or local path.
-   * This is typically used to resolve font file paths.
+   * Function to resolve a font `src` value declared in a stylesheet to the font file it
+   * refers to, as either a URL or an absolute path on disk.
    * @optional
    */
   resolvePath?: (path: string) => string | URL;
@@ -113,6 +114,6 @@ interface FontaineTransformOptions {
  * @param options - The transformation options. See {@link FontaineTransformOptions}.
  * @returns The unplugin instance.
  */
-declare const FontaineTransform: ReturnType<typeof createUnplugin<FontaineTransformOptions>>;
+export declare const FontaineTransform: ReturnType<typeof createUnplugin<FontaineTransformOptions>>;
 //#endregion
-export { DEFAULT_CATEGORY_FALLBACKS, type FontCategory, FontaineTransform, type FontaineTransformOptions, type ResolveCategoryFallbacksOptions, generateFallbackName, generateFontFace, getMetricsForFamily, readMetrics, resolveCategoryFallbacks };
+export { DEFAULT_CATEGORY_FALLBACKS, type FontCategory, type FontaineTransformOptions, type ResolveCategoryFallbacksOptions, resolveCategoryFallbacks };

package/dist/index.d.mts

@@ -8,7 +8,7 @@ import { createUnplugin } from "unplugin";
  * @param {string} name - The full font family string.
  * @returns {string} - The fallback font name.
  */
-declare function generateFallbackName(name: string): string;
+export declare function generateFallbackName(name: string): string;
 interface FallbackOptions {
   /**
    * The name of the fallback font.
@@ -37,7 +37,7 @@ type FontFaceMetrics = Pick<Font, "ascent" | "descent" | "lineGap" | "unitsPerEm
  * @param {FallbackOptions} fallback - The fallback options, including name, font and optional metrics. See {@link FallbackOptions}.
  * @returns {string} - The full `@font-face` CSS declaration.
  */
-declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOptions): string;
+export declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOptions): string;
 //#endregion
 //#region src/metrics.d.ts
 /**
@@ -46,15 +46,16 @@ declare function generateFontFace(metrics: FontFaceMetrics, fallback: FallbackOp
  * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves with the filtered font metrics or null if not found. See {@link FontFaceMetrics}.
  * @async
  */
-declare function getMetricsForFamily(family: string): Promise<FontFaceMetrics | null>;
+export declare function getMetricsForFamily(family: string): Promise<FontFaceMetrics | null>;
 /**
- * Reads font metrics from a specified source URL or file path. This function supports both local files and remote URLs.
+ * Reads font metrics from a source URL, which may be a `file:` URL or a remote one. A string
+ * that is not a URL, such as a bare path or a root-relative one, resolves to `null`.
  * It caches the results to optimise subsequent requests for the same source.
- * @param {URL | string} _source - The source URL or local file path from which to read the font metrics.
+ * @param {URL | string} _source - The source URL from which to read the font metrics.
  * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves to the filtered font metrics or null if the source cannot be processed.
  * @async
  */
-declare function readMetrics(_source: URL | string): Promise<FontFaceMetrics | null>;
+export declare function readMetrics(_source: URL | string): Promise<FontFaceMetrics | null>;
 //#endregion
 //#region src/transform.d.ts
 interface FontaineTransformOptions {
@@ -83,8 +84,8 @@ interface FontaineTransformOptions {
    */
   categoryFallbacks?: Partial<Record<FontCategory, string[]>>;
   /**
-   * Function to resolve a given path to a valid URL or local path.
-   * This is typically used to resolve font file paths.
+   * Function to resolve a font `src` value declared in a stylesheet to the font file it
+   * refers to, as either a URL or an absolute path on disk.
    * @optional
    */
   resolvePath?: (path: string) => string | URL;
@@ -113,6 +114,6 @@ interface FontaineTransformOptions {
  * @param options - The transformation options. See {@link FontaineTransformOptions}.
  * @returns The unplugin instance.
  */
-declare const FontaineTransform: ReturnType<typeof createUnplugin<FontaineTransformOptions>>;
+export declare const FontaineTransform: ReturnType<typeof createUnplugin<FontaineTransformOptions>>;
 //#endregion
-export { DEFAULT_CATEGORY_FALLBACKS, type FontCategory, FontaineTransform, type FontaineTransformOptions, type ResolveCategoryFallbacksOptions, generateFallbackName, generateFontFace, getMetricsForFamily, readMetrics, resolveCategoryFallbacks };
+export { DEFAULT_CATEGORY_FALLBACKS, type FontCategory, type FontaineTransformOptions, type ResolveCategoryFallbacksOptions, resolveCategoryFallbacks };

package/dist/index.mjs

@@ -1,8 +1,7 @@
-import { a as resolveCategoryFallbacks, c as generateFontFace, d as withoutQueryOrFragment, f as withoutQuotes, i as DEFAULT_CATEGORY_FALLBACKS, l as genericCSSFamilies, n as readMetrics, o as cssWideKeywords, r as readMetricsForSource, s as generateFallbackName, t as getMetricsForFamily, u as parseFontFace } from "./metrics-DgPzfV2U.mjs";
+import { a as resolveCategoryFallbacks, c as generateFontFace, d as withoutQueryOrFragment, f as withoutQuotes, i as DEFAULT_CATEGORY_FALLBACKS, l as genericCSSFamilies, n as readMetrics, o as cssWideKeywords, r as readMetricsForSource, s as generateFallbackName, t as getMetricsForFamily, u as parseFontFace } from "./metrics-BfrxJdKT.mjs";
 import { createRequire } from "node:module";
 import { parse, walk } from "css-tree";
-import { anyOf, char, createRegExp, exactly, oneOrMore } from "magic-regexp";
-import { isAbsolute } from "pathe";
+import { isAbsolute } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { readFile } from "node:fs/promises";
 import MagicString from "magic-string";
@@ -13,9 +12,9 @@ const supportedExtensions = [
 	"woff",
 	"ttf"
 ];
-const CSS_RE = createRegExp(exactly(".").and(anyOf("sass", "css", "scss")).and(exactly("?").and(oneOrMore(char)).optionally()).at.lineEnd());
-const RELATIVE_RE = createRegExp(exactly(".").or("..").and(anyOf("/", "\\")).at.lineStart());
-const SCSS_RE = createRegExp(exactly(".").and(anyOf("sass", "scss")).and(exactly("?").and(oneOrMore(char)).optionally()).at.lineEnd());
+const CSS_RE = /\.(?:sass|css|scss)(?:\?.+)?$/;
+const RELATIVE_RE = /^(?:\.|\.\.)(?:\/|\\)/;
+const SCSS_RE = /\.(?:sass|scss)(?:\?.+)?$/;
 /**
 * Replaces `//` line comments with spaces, preserving offsets.
 *
@@ -96,7 +95,6 @@ function resolveCssImport(specifier, importer) {
 const FontaineTransform = createUnplugin((options) => {
 	const cssContext = options.css = options.css || {};
 	cssContext.value = "";
-	const resolvePath = options.resolvePath || ((id) => id);
 	const fallbackName = options.fallbackName || options.overrideName || generateFallbackName;
 	const skipFontFaceGeneration = options.skipFontFaceGeneration || (() => false);
 	return {
@@ -145,7 +143,7 @@ const FontaineTransform = createUnplugin((options) => {
 					const source = rawSource && withoutQueryOrFragment(rawSource);
 					if (!supportedExtensions.some((e) => source?.endsWith(e))) continue;
 					if (skipFontFaceGeneration(fallbackName(family))) continue;
-					const metrics = await getMetricsForFamily(family) || source && await readMetricsForSource(source, importer, resolvePath).catch(() => null);
+					const metrics = await getMetricsForFamily(family) || source && await readMetricsForSource(source, importer, options.resolvePath).catch(() => null);
 					/* v8 ignore next 2 */
 					if (!metrics) continue;
 					const familyFallbacks = resolveCategoryFallbacks({

package/dist/{metrics-DgPzfV2U.mjs → metrics-BfrxJdKT.mjs}

@@ -1,7 +1,5 @@
 import { generate, parse, walk } from "css-tree";
-import { char, charIn, createRegExp, oneOrMore } from "magic-regexp";
-import { isAbsolute } from "pathe";
-import { hasProtocol, parseURL } from "ufo";
+import { isAbsolute } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { fromUrl } from "@capsizecss/unpack";
 import { fromFile } from "@capsizecss/unpack/fs";
@@ -12,9 +10,9 @@ function toPercentage(value, fractionDigits = 4) {
 function toCSS(properties, indent = 2) {
 	return Object.entries(properties).map(([key, value]) => `${" ".repeat(indent)}${key}: ${value};`).join("\n");
 }
-const QUOTES_RE = createRegExp(charIn("\"'").at.lineStart().or(charIn("\"'").at.lineEnd()), ["g"]);
+const QUOTES_RE = /(?:^["']|["']$)/g;
 const withoutQuotes = (str) => str.trim().replace(QUOTES_RE, "");
-const QUERY_OR_FRAGMENT_RE = createRegExp(charIn("?#").and(oneOrMore(char).optionally()).at.lineEnd());
+const QUERY_OR_FRAGMENT_RE = /[?#](?:.+)?$/;
 /** Removes any `?query` or `#fragment` suffix, which is not part of the file a URL points to. */
 function withoutQueryOrFragment(source) {
 	return source.replace(QUERY_OR_FRAGMENT_RE, "");
@@ -28,7 +26,7 @@ function withoutQueryOrFragment(source) {
 * resolving against the stylesheet finds nothing.
 */
 function isStylesheetRelative(source) {
-	return !hasProtocol(source, { acceptRelative: true }) && !isAbsolute(source);
+	return !source.startsWith("/") && !URL.canParse(source);
 }
 const cssWideKeywords = /* @__PURE__ */ new Set([
 	"inherit",
@@ -310,19 +308,20 @@ async function getMetricsForFamily(family) {
 }
 const urlRequestCache = /* @__PURE__ */ new Map();
 /**
-* Reads font metrics from a specified source URL or file path. This function supports both local files and remote URLs.
+* Reads font metrics from a source URL, which may be a `file:` URL or a remote one. A string
+* that is not a URL, such as a bare path or a root-relative one, resolves to `null`.
 * It caches the results to optimise subsequent requests for the same source.
-* @param {URL | string} _source - The source URL or local file path from which to read the font metrics.
+* @param {URL | string} _source - The source URL from which to read the font metrics.
 * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves to the filtered font metrics or null if the source cannot be processed.
 * @async
 */
 async function readMetrics(_source) {
 	const source = typeof _source !== "string" && "href" in _source ? _source.href : _source;
 	if (source in metricCache) return metricCache[source] ?? null;
-	const { protocol } = parseURL(source);
-	if (!protocol) return null;
+	const url = typeof _source === "string" ? isAbsolute(_source) ? null : URL.parse(_source) : _source;
+	if (!url) return null;
 	let metrics;
-	if (protocol === "file:") metrics = await fromFile(fileURLToPath(source));
+	if (url.protocol === "file:") metrics = await fromFile(fileURLToPath(source));
 	else if (urlRequestCache.has(source)) metrics = await urlRequestCache.get(source);
 	else {
 		const requestPromise = fromUrl(source);
@@ -339,13 +338,19 @@ async function readMetrics(_source) {
 * A scheme-less, non-rooted URL is resolved against the stylesheet first, then handed to
 * `resolvePath` if that yields no metrics: bare package specifiers and webpack's `~` prefix
 * look identical to stylesheet-relative paths, and only the caller's resolver can map them.
+*
+* `resolvePath` returns a location rather than a URL, so an absolute path it returns is a file
+* on disk. Without a resolver `source` is still the URL the stylesheet declared, where a leading
+* slash means the document root.
 */
 async function readMetricsForSource(source, importer, resolvePath) {
 	if (importer && isAbsolute(importer) && isStylesheetRelative(source)) {
 		const metrics = await readMetrics(new URL(source, pathToFileURL(importer))).catch(() => null);
 		if (metrics) return metrics;
 	}
-	return readMetrics(resolvePath(source));
+	if (!resolvePath) return readMetrics(source);
+	const resolved = resolvePath(source);
+	return readMetrics(typeof resolved === "string" && isAbsolute(resolved) ? pathToFileURL(resolved) : resolved);
 }
 function fontFamilyToCamelCase(str) {
 	return str.split(/[\s|-]/).filter(Boolean).map((s, i) => `${s.charAt(0)[i > 0 ? "toUpperCase" : "toLowerCase"]()}${s.slice(1)}`).join("");

package/dist/{metrics-ChAPPk2j.cjs → metrics-CS5CISMK.cjs}

@@ -1,7 +1,5 @@
 let css_tree = require("css-tree");
-let magic_regexp = require("magic-regexp");
-let pathe = require("pathe");
-let ufo = require("ufo");
+let node_path = require("node:path");
 let node_url = require("node:url");
 let _capsizecss_unpack = require("@capsizecss/unpack");
 let _capsizecss_unpack_fs = require("@capsizecss/unpack/fs");
@@ -12,9 +10,9 @@ function toPercentage(value, fractionDigits = 4) {
 function toCSS(properties, indent = 2) {
 	return Object.entries(properties).map(([key, value]) => `${" ".repeat(indent)}${key}: ${value};`).join("\n");
 }
-const QUOTES_RE = (0, magic_regexp.createRegExp)((0, magic_regexp.charIn)("\"'").at.lineStart().or((0, magic_regexp.charIn)("\"'").at.lineEnd()), ["g"]);
+const QUOTES_RE = /(?:^["']|["']$)/g;
 const withoutQuotes = (str) => str.trim().replace(QUOTES_RE, "");
-const QUERY_OR_FRAGMENT_RE = (0, magic_regexp.createRegExp)((0, magic_regexp.charIn)("?#").and((0, magic_regexp.oneOrMore)(magic_regexp.char).optionally()).at.lineEnd());
+const QUERY_OR_FRAGMENT_RE = /[?#](?:.+)?$/;
 /** Removes any `?query` or `#fragment` suffix, which is not part of the file a URL points to. */
 function withoutQueryOrFragment(source) {
 	return source.replace(QUERY_OR_FRAGMENT_RE, "");
@@ -28,7 +26,7 @@ function withoutQueryOrFragment(source) {
 * resolving against the stylesheet finds nothing.
 */
 function isStylesheetRelative(source) {
-	return !(0, ufo.hasProtocol)(source, { acceptRelative: true }) && !(0, pathe.isAbsolute)(source);
+	return !source.startsWith("/") && !URL.canParse(source);
 }
 const cssWideKeywords = /* @__PURE__ */ new Set([
 	"inherit",
@@ -310,19 +308,20 @@ async function getMetricsForFamily(family) {
 }
 const urlRequestCache = /* @__PURE__ */ new Map();
 /**
-* Reads font metrics from a specified source URL or file path. This function supports both local files and remote URLs.
+* Reads font metrics from a source URL, which may be a `file:` URL or a remote one. A string
+* that is not a URL, such as a bare path or a root-relative one, resolves to `null`.
 * It caches the results to optimise subsequent requests for the same source.
-* @param {URL | string} _source - The source URL or local file path from which to read the font metrics.
+* @param {URL | string} _source - The source URL from which to read the font metrics.
 * @returns {Promise<FontFaceMetrics | null>} - A promise that resolves to the filtered font metrics or null if the source cannot be processed.
 * @async
 */
 async function readMetrics(_source) {
 	const source = typeof _source !== "string" && "href" in _source ? _source.href : _source;
 	if (source in metricCache) return metricCache[source] ?? null;
-	const { protocol } = (0, ufo.parseURL)(source);
-	if (!protocol) return null;
+	const url = typeof _source === "string" ? (0, node_path.isAbsolute)(_source) ? null : URL.parse(_source) : _source;
+	if (!url) return null;
 	let metrics;
-	if (protocol === "file:") metrics = await (0, _capsizecss_unpack_fs.fromFile)((0, node_url.fileURLToPath)(source));
+	if (url.protocol === "file:") metrics = await (0, _capsizecss_unpack_fs.fromFile)((0, node_url.fileURLToPath)(source));
 	else if (urlRequestCache.has(source)) metrics = await urlRequestCache.get(source);
 	else {
 		const requestPromise = (0, _capsizecss_unpack.fromUrl)(source);
@@ -339,13 +338,19 @@ async function readMetrics(_source) {
 * A scheme-less, non-rooted URL is resolved against the stylesheet first, then handed to
 * `resolvePath` if that yields no metrics: bare package specifiers and webpack's `~` prefix
 * look identical to stylesheet-relative paths, and only the caller's resolver can map them.
+*
+* `resolvePath` returns a location rather than a URL, so an absolute path it returns is a file
+* on disk. Without a resolver `source` is still the URL the stylesheet declared, where a leading
+* slash means the document root.
 */
 async function readMetricsForSource(source, importer, resolvePath) {
-	if (importer && (0, pathe.isAbsolute)(importer) && isStylesheetRelative(source)) {
+	if (importer && (0, node_path.isAbsolute)(importer) && isStylesheetRelative(source)) {
 		const metrics = await readMetrics(new URL(source, (0, node_url.pathToFileURL)(importer))).catch(() => null);
 		if (metrics) return metrics;
 	}
-	return readMetrics(resolvePath(source));
+	if (!resolvePath) return readMetrics(source);
+	const resolved = resolvePath(source);
+	return readMetrics(typeof resolved === "string" && (0, node_path.isAbsolute)(resolved) ? (0, node_url.pathToFileURL)(resolved) : resolved);
 }
 function fontFamilyToCamelCase(str) {
 	return str.split(/[\s|-]/).filter(Boolean).map((s, i) => `${s.charAt(0)[i > 0 ? "toUpperCase" : "toLowerCase"]()}${s.slice(1)}`).join("");

package/dist/postcss.cjs

@@ -1,4 +1,4 @@
-const require_metrics = require("./metrics-ChAPPk2j.cjs");
+const require_metrics = require("./metrics-CS5CISMK.cjs");
 let css_tree = require("css-tree");
 //#region src/postcss.ts
 const supportedExtensions = [
@@ -23,7 +23,6 @@ function isFontFaceRule(node) {
 	return node?.type === "atrule" && node.name.toLowerCase() === "font-face";
 }
 function fontaine(options) {
-	const resolvePath = options.resolvePath || ((id) => id);
 	const fallbackName = options.fallbackName || require_metrics.generateFallbackName;
 	const skipFontFaceGeneration = options.skipFontFaceGeneration || (() => false);
 	return {
@@ -35,7 +34,7 @@ function fontaine(options) {
 				const source = url && require_metrics.withoutQueryOrFragment(url);
 				if (!source || !supportedExtensions.some((e) => source.endsWith(e))) continue;
 				if (skipFontFaceGeneration(fallbackName(family))) continue;
-				const metrics = await require_metrics.getMetricsForFamily(family) || await require_metrics.readMetricsForSource(source, originatingFile(rule, result), resolvePath).catch(() => null);
+				const metrics = await require_metrics.getMetricsForFamily(family) || await require_metrics.readMetricsForSource(source, originatingFile(rule, result), options.resolvePath).catch(() => null);
 				if (!metrics) continue;
 				const familyFallbacks = require_metrics.resolveCategoryFallbacks({
 					fontFamily: family,

package/dist/postcss.d.cts

@@ -1,7 +1,7 @@
 import { n as FontCategory } from "./fallbacks-Cj4LUWhi.cjs";
 import { Plugin } from "postcss";
 //#region src/postcss.d.ts
-interface FontainePostcssOptions {
+export interface FontainePostcssOptions {
   /**
    * Font family fallbacks to use.
    * Can be an array of fallback font family names to use for all fonts,
@@ -16,8 +16,8 @@ interface FontainePostcssOptions {
    */
   categoryFallbacks?: Partial<Record<FontCategory, string[]>>;
   /**
-   * Function to resolve a given path to a valid URL or local path.
-   * This is typically used to resolve font file paths.
+   * Function to resolve a font `src` value declared in a stylesheet to the font file it
+   * refers to, as either a URL or an absolute path on disk.
    * @optional
    */
   resolvePath?: (path: string) => string | URL;
@@ -49,4 +49,4 @@ interface FontainePlugin {
 }
 declare const plugin: FontainePlugin;
 //#endregion
-export { FontainePostcssOptions, plugin as default };
+export { plugin as default };

package/dist/postcss.d.mts

@@ -1,7 +1,7 @@
 import { n as FontCategory } from "./fallbacks-Cj4LUWhi.mjs";
 import { Plugin } from "postcss";
 //#region src/postcss.d.ts
-interface FontainePostcssOptions {
+export interface FontainePostcssOptions {
   /**
    * Font family fallbacks to use.
    * Can be an array of fallback font family names to use for all fonts,
@@ -16,8 +16,8 @@ interface FontainePostcssOptions {
    */
   categoryFallbacks?: Partial<Record<FontCategory, string[]>>;
   /**
-   * Function to resolve a given path to a valid URL or local path.
-   * This is typically used to resolve font file paths.
+   * Function to resolve a font `src` value declared in a stylesheet to the font file it
+   * refers to, as either a URL or an absolute path on disk.
    * @optional
    */
   resolvePath?: (path: string) => string | URL;
@@ -49,4 +49,4 @@ interface FontainePlugin {
 }
 declare const plugin: FontainePlugin;
 //#endregion
-export { FontainePostcssOptions, plugin as default };
+export { plugin as default };

package/dist/postcss.mjs

@@ -1,4 +1,4 @@
-import { a as resolveCategoryFallbacks, c as generateFontFace, d as withoutQueryOrFragment, f as withoutQuotes, l as genericCSSFamilies, o as cssWideKeywords, r as readMetricsForSource, s as generateFallbackName, t as getMetricsForFamily, u as parseFontFace } from "./metrics-DgPzfV2U.mjs";
+import { a as resolveCategoryFallbacks, c as generateFontFace, d as withoutQueryOrFragment, f as withoutQuotes, l as genericCSSFamilies, o as cssWideKeywords, r as readMetricsForSource, s as generateFallbackName, t as getMetricsForFamily, u as parseFontFace } from "./metrics-BfrxJdKT.mjs";
 import { parse } from "css-tree";
 //#region src/postcss.ts
 const supportedExtensions = [
@@ -23,7 +23,6 @@ function isFontFaceRule(node) {
 	return node?.type === "atrule" && node.name.toLowerCase() === "font-face";
 }
 function fontaine(options) {
-	const resolvePath = options.resolvePath || ((id) => id);
 	const fallbackName = options.fallbackName || generateFallbackName;
 	const skipFontFaceGeneration = options.skipFontFaceGeneration || (() => false);
 	return {
@@ -35,7 +34,7 @@ function fontaine(options) {
 				const source = url && withoutQueryOrFragment(url);
 				if (!source || !supportedExtensions.some((e) => source.endsWith(e))) continue;
 				if (skipFontFaceGeneration(fallbackName(family))) continue;
-				const metrics = await getMetricsForFamily(family) || await readMetricsForSource(source, originatingFile(rule, result), resolvePath).catch(() => null);
+				const metrics = await getMetricsForFamily(family) || await readMetricsForSource(source, originatingFile(rule, result), options.resolvePath).catch(() => null);
 				if (!metrics) continue;
 				const familyFallbacks = resolveCategoryFallbacks({
 					fontFamily: family,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fontaine",
   "type": "module",
-  "version": "0.8.2",
+  "version": "1.0.0",
   "description": "Automatic font fallback based on font metrics",
   "author": {
     "name": "Daniel Roe",
@@ -60,26 +60,24 @@
   "dependencies": {
     "@capsizecss/unpack": "^4.0.0",
     "css-tree": "^3.1.0",
-    "magic-regexp": "^0.11.0",
     "magic-string": "^1.0.0",
-    "pathe": "^2.0.3",
-    "ufo": "^1.6.1",
     "unplugin": "^3.0.0"
   },
   "devDependencies": {
-    "@capsizecss/metrics": "4.2.0",
+    "@capsizecss/metrics": "4.3.0",
     "@types/css-tree": "3.2.0",
-    "@types/node": "24.13.3",
+    "@types/node": "24.13.6",
     "@types/serve-handler": "6.1.4",
-    "@vitest/coverage-v8": "5.0.0",
-    "eslint": "10.10.0",
+    "@vitest/coverage-v8": "5.0.1",
+    "eslint": "10.11.0",
     "get-port-please": "3.2.0",
-    "postcss": "8.5.26",
+    "magic-regexp": "0.11.0",
+    "postcss": "8.5.28",
     "serve-handler": "6.1.7",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "6.0.3",
     "vite": "8.3.0",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "scripts": {
     "build": "tsdown",