astro-font-loader 0.2.3 → 0.3.2

package/README.md

@@ -5,6 +5,14 @@
 
 `astro-font-loader` hooks into the astro build process to copy selected fonts from installed font packages into the local build artifacts.
 
+> [!NOTE]
+> **Why use this instead of the built-in Astro Fonts API?** <br><br>
+> `astro-font-loader` was originally designed as a package based font solution, but continues due to two limitations.
+>
+> The first is that there are *no controls over output file paths.* Astro's built-in font handling places font files in hashed, opaque paths. This makes it difficult to configure [Early Hints](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Link) (`103` responses) or `Link` headers since you can't predict the final font URLs ahead of time. You end up writing a custom build script anyways to create predictable paths in this case.
+>
+> The second is that there is *no media query support for font loading.* There is no way to conditionally load fonts based on viewport size (e.g., `min-width` media queries). This means all font weights and variants are downloaded on every device, even if they're only used on larger screens.
+
 ## Installation
 
 ```bash
@@ -22,165 +30,159 @@ pnpm add astro-font-loader
 
 1. **Setup Phase**: During Astro's config setup, the integration:
    - Locates the specified font packages in your `node_modules`
-   - Applies the filter function (if provided) to select fonts
-   - Prepares the list of fonts to be copied
+   - Matches `@font-face` rules from the package CSS by `font-family`, `font-weight`, and `font-style`
+   - Prepares the list of font files to be copied
 
 2. **Build Phase**: After Astro completes the build:
-   - Copies the filtered font files to the output directory
-   - Transforms CSS imports to reference the copied fonts
+   - Copies the matched font files to the output directory
    - Ensures fonts are available in your production build
 
 ## Usage
 
 ### Basic Setup
 
-Add the integration to your `astro.config.mjs` or `astro.config.ts` file:
-
-```typescript
-import { defineConfig } from 'astro/config';
-import { fontsIntegration } from 'astro-font-loader';
-
-export default defineConfig({
-  site: 'https://example.com',
-  integrations: [
-    fontsIntegration({
-      packages: ["@company/design-system-fonts"],
-    }),
-  ],
-});
-```
-
-### Filtering Fonts
-
-Use the `filter` option to selectively include only specific fonts from your font packages. This is useful when you have a large font library but only need certain fonts for your project:
+Add the integration to your `astro.config.mjs` or `astro.config.ts` file. The variant `name` should match the `font-family` value in the package's CSS `@font-face` rules:
 
 ```typescript
 import { defineConfig } from 'astro/config';
 import { fontsIntegration } from 'astro-font-loader';
 
-// Define a filter function to select specific fonts
-const fontFilter = (filename: string) => {
-  const name = filename.toLowerCase();
-  return name.includes("hatton") || 
-         name.includes("berkeleymono");
-};
-
 export default defineConfig({
-  site: 'https://example.com',
   integrations: [
     fontsIntegration({
-      packages: ["@company/design-system-fonts"],
-      filter: fontFilter,
+      outputDirectory: "fonts",
+      fonts: [
+        {
+          family: "Roboto",
+          source: { type: "package", package: "@company/design-system-fonts" },
+          variants: [
+            { name: "Roboto", weight: 400, styles: ["normal"] },
+            { name: "Roboto", weight: 700, styles: ["normal"] },
+          ],
+        },
+      ],
     }),
   ],
 });
 ```
 
-### Custom Output Directory
+### Multiple Font Families
 
-By default, fonts are copied to a `fonts` directory in your build output. You can customize this:
+A single package can provide multiple font families. Each family gets its own entry in the `fonts` array:
 
 ```typescript
 fontsIntegration({
-  packages: ["@company/design-system-fonts"],
-  filter: fontFilter,
-  outputDir: "assets/fonts", // Custom output directory
+  outputDirectory: "fonts",
+  fonts: [
+    {
+      family: "Berkeley Mono",
+      source: { type: "package", package: "@company/design-system-fonts" },
+      variants: [
+        { name: "Berkeley Mono v2 Variable", weight: [100, 900], styles: ["normal", "oblique"] },
+      ],
+    },
+    {
+      family: "EB Garamond",
+      source: { type: "package", package: "@company/design-system-fonts" },
+      variants: [
+        { name: "EB Garamond", weight: 600, styles: ["normal"] },
+        { name: "EB Garamond", weight: 700, styles: ["normal"] },
+      ],
+    },
+  ],
 })
 ```
 
-### Multiple Font Packages
+### Custom Style File
 
-You can load fonts from multiple packages:
+By default, the integration looks for CSS at `src/index.css` within the package. You can override this with `styleFile`:
 
 ```typescript
-fontsIntegration({
-  packages: [
-    "@company/design-system-fonts",
-    "@fontsource/roboto",
-    "@custom/typefaces"
-  ],
-  filter: (filename) => {
-    // Only include specific fonts from all packages
-    const name = filename.toLowerCase();
-    return name.includes("hatton") ||
-           name.includes("berkeleymono") ||
-           name.includes("roboto-400");
+{
+  family: "Custom Font",
+  source: {
+    type: "package",
+    package: "@company/fonts",
+    styleFile: "dist/fonts.css",
   },
-})
+  variants: [
+    { name: "Custom Font", weight: 400, styles: ["normal"] },
+  ],
+}
 ```
 
 ### FontLoader Component
 
-The library provides a `FontLoader` Astro component that generates `<link rel="preload">` tags and inline `@font-face` CSS for your fonts. Use it alongside the integration — the integration copies font files to the build output, while the component injects the HTML needed to load them.
+The `FontLoader` component generates `<link rel="preload">` tags and inline `@font-face` CSS. Use it alongside the integration — the integration copies font files to the build output, while the component injects the HTML needed to load them.
 
 ```astro
 ---
-// src/layouts/Layout.astro
 import FontLoader from 'astro-font-loader/FontLoader.astro';
+
+const source = { type: "package" as const, package: "@company/design-system-fonts" };
 ---
 <html>
   <head>
-    <FontLoader packages={['@company/design-system-fonts']} />
+    <FontLoader
+      fonts={[
+        {
+          family: "Berkeley Mono",
+          source,
+          variants: [
+            { name: "Berkeley Mono v2 Variable", weight: [100, 900], styles: ["normal", "oblique"] },
+          ],
+        },
+        {
+          family: "EB Garamond",
+          source,
+          variants: [
+            { name: "EB Garamond", weight: 600, styles: ["normal"] },
+            { name: "EB Garamond", weight: 700, styles: ["normal"] },
+          ],
+        },
+      ]}
+      outputDirectory="fonts"
+      preload={[
+        { variant: "Berkeley Mono v2 Variable" },
+        { variant: "EB Garamond", weight: 600 },
+        { variant: "EB Garamond", weight: 700, media: "(min-width: 641px)" },
+      ]}
+    />
   </head>
   <body><slot /></body>
 </html>
 ```
 
-The component accepts the same `filter` and `outputDir` options as the integration:
+#### Selective Preloading with Media Queries
 
-```astro
----
-import FontLoader from 'astro-font-loader/FontLoader.astro';
+The `preload` prop accepts an array of entries that match variants by their CSS `font-family` name, and optionally by `weight` and `styles` for per-variant granularity. Each entry can include an optional `media` query to conditionally preload fonts based on viewport size:
 
-const fontFilter = (filename: string) =>
-  filename.toLowerCase().includes('roboto');
----
-<FontLoader
-  packages={['@company/design-system-fonts']}
-  filter={fontFilter}
-  outputDir="assets/fonts"
-/>
+```typescript
+preload={[
+  { variant: "Berkeley Mono v2 Variable" },                    // always preload
+  { variant: "EB Garamond", weight: 600 },                     // always preload semibold
+  { variant: "EB Garamond", weight: 700, media: "(min-width: 641px)" },  // bold on desktop only
+]}
 ```
 
-#### Selective Preloading with Media Queries
-
-The `preload` prop accepts an array of configurations for fine-grained control over which fonts are preloaded and with what media queries. This is useful for responsive font loading — for example, preloading a bold weight only on desktop:
-
-```astro
----
-import FontLoader from 'astro-font-loader/FontLoader.astro';
+Fonts matched by an entry in `preload` get a `<link rel="preload">` tag. Fonts not listed in `preload` still get their `@font-face` CSS injected — they load normally without being preloaded.
 
-const fontFilter = (filename: string) =>
-  filename.toLowerCase().includes('roboto');
----
-<FontLoader
-  packages={['@company/design-system-fonts']}
-  filter={fontFilter}
-  preload={[
-    {
-      filter: (f) => f.includes('roboto-regular'),
-    },
-    {
-      filter: (f) => f.includes('roboto-bold'),
-      media: '(min-width: 641px)',
-    },
-  ]}
-/>
-```
+#### Props
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `packages` | `string[]` | (required) | Font package names to load |
-| `filter` | `(filename: string) => boolean` | `undefined` | Filter function to select font files |
-| `outputDir` | `string` | `"fonts"` | Output directory name in generated URLs |
-| `preload` | `boolean \| PreloadConfig[]` | `true` | Whether/how to generate preload link tags |
+| `fonts` | `FontConfig[]` | (required) | Font configurations to load |
+| `outputDirectory` | `string` | (required) | Output directory name in generated URLs |
+| `preload` | `PreloadEntry[]` | `[]` | Variants to preload, with optional weight/style narrowing |
 | `root` | `string` | `process.cwd()` | Root directory for resolving font packages |
 
-**`PreloadConfig`**
+**`PreloadEntry`**
 
 | Property | Type | Required | Description |
 |----------|------|----------|-------------|
-| `filter` | `(filename: string) => boolean` | Yes | Filter to select which fonts to preload |
+| `variant` | `string` | Yes | CSS font-family name to match for preloading |
+| `weight` | `number \| [number, number]` | No | Narrow to a specific weight. Omit to match all weights |
+| `styles` | `string[]` | No | Narrow to specific styles. Omit to match all styles |
 | `media` | `string` | No | Media query for the preload link |
 
 ## Additional Documentation

package/components/FontLoader.astro

@@ -1,27 +1,14 @@
 ---
-import { getFontsPackageInfo, getAvailableFonts, getFontsCss } from 'astro-font-loader';
-
-interface PreloadConfig {
-	/** Filter function to select which fonts to preload. */
-	filter: (filename: string) => boolean;
-	/** Optional media query for the preload link (e.g., "(min-width: 641px)"). */
-	media?: string;
-}
+import { getFontsPackageInfo, getFontsCss } from 'astro-font-loader';
+import type { FontConfig, PreloadEntry } from 'astro-font-loader';
 
 interface Props {
-	/** Array of font package names to load. */
-	packages: string[];
-	/** Optional filter function to select which font files to include in CSS. */
-	filter?: (filename: string) => boolean;
-	/** Output directory name used in generated font URLs. Defaults to "fonts". */
-	outputDir?: string;
-	/**
-	 * Controls preload link generation.
-	 * - `true`: Preload all filtered fonts (default).
-	 * - `false`: No preload links.
-	 * - `PreloadConfig[]`: Selective preloading with optional media queries.
-	 */
-	preload?: boolean | PreloadConfig[];
+	/** Font configurations to load. */
+	fonts: FontConfig[];
+	/** Output directory name used in generated font URLs. */
+	outputDirectory: string;
+	/** Variants to preload, with optional weight/style narrowing and media queries. */
+	preload?: PreloadEntry[];
 	/** Root directory to resolve font packages from. Defaults to process.cwd(). */
 	root?: string;
 }
@@ -39,45 +26,65 @@ function getMimeType(filename: string): string {
 	return MIME_TYPES[ext] ?? 'font/woff2';
 }
 
+function weightEquals(
+	a: number | [number, number],
+	b: number | [number, number],
+): boolean {
+	if (Array.isArray(a) && Array.isArray(b)) {
+		return a[0] === b[0] && a[1] === b[1];
+	}
+	return a === b;
+}
+
 const {
-	packages,
-	filter,
-	outputDir = 'fonts',
-	preload = true,
+	fonts,
+	outputDirectory,
+	preload = [],
 	root = process.cwd(),
 } = Astro.props;
 
-let css = '';
-const seen = new Set<string>();
 const preloadHrefs: Array<{ href: string; type: string; media?: string }> = [];
+const seenHrefs = new Set<string>();
+let allCss = '';
 
-for (const packageName of packages) {
-	const packageInfo = getFontsPackageInfo(packageName, root);
+for (const fontConfig of fonts) {
+	const { source } = fontConfig;
+	const packageInfo = getFontsPackageInfo(source.package, root, source.styleFile);
 	if (!packageInfo) continue;
 
-	css += getFontsCss({ filter, outputDir }, packageInfo);
+	for (const variant of fontConfig.variants) {
+		const result = getFontsCss(
+			{ name: variant.name, variants: [variant], outputDirectory },
+			packageInfo,
+		);
+		allCss += result.css;
 
-	if (preload === true) {
-		let fonts = getAvailableFonts(packageInfo.fontsDir);
-		if (filter) {
-			fonts = fonts.filter((font) => filter(font.filename));
-		}
-		for (const font of fonts) {
-			const href = `/${outputDir}/${font.filename}`;
-			if (!seen.has(href)) {
-				seen.add(href);
-				preloadHrefs.push({ href, type: getMimeType(font.filename) });
+		const entry = preload.find((p) => {
+			if (p.variant.toLowerCase() !== variant.name.toLowerCase()) {
+				return false;
 			}
-		}
-	} else if (Array.isArray(preload)) {
-		const fonts = getAvailableFonts(packageInfo.fontsDir);
-		for (const config of preload) {
-			const matched = fonts.filter((font) => config.filter(font.filename));
-			for (const font of matched) {
-				const href = `/${outputDir}/${font.filename}`;
-				if (!seen.has(href)) {
-					seen.add(href);
-					preloadHrefs.push({ href, type: getMimeType(font.filename), media: config.media });
+
+			if (p.weight !== undefined && !weightEquals(p.weight, variant.weight)) {
+				return false;
+			}
+
+			if (p.styles && !p.styles.every((s) => variant.styles.includes(s))) {
+				return false;
+			}
+
+			return true;
+		});
+
+		if (entry) {
+			for (const filename of result.filenames) {
+				const href = `/${outputDirectory}/${filename}`;
+				if (!seenHrefs.has(href)) {
+					seenHrefs.add(href);
+					preloadHrefs.push({
+						href,
+						type: getMimeType(filename),
+						media: entry.media,
+					});
 				}
 			}
 		}
@@ -88,4 +95,4 @@ for (const packageName of packages) {
 {preloadHrefs.map(({ href, type, media }) => (
 	<link rel="preload" as="font" crossorigin href={href} type={type} media={media} />
 ))}
-{css && <style set:html={css} is:inline />}
+{allCss && <style set:html={allCss} is:inline />}

package/dist/astroBuild.d.ts

@@ -4,11 +4,6 @@ import type { FontInfo } from "./fonts/fontInfo.ts";
  * Handles the build completion phase for font loading.
  *
  * Copies all available font files to the output directory.
- *
- * @param {URL} dir - The build output directory URL.
- * @param {AstroIntegrationLogger} logger - The Astro integration logger for outputting messages.
- * @param {string} outputDir - The output directory name for font files.
- * @param {FontInfo[]} availableFonts - Array of font files to copy.
  */
-export declare function astroBuildDone(dir: URL, logger: AstroIntegrationLogger, outputDir: string, availableFonts: FontInfo[]): void;
+export declare function astroBuildDone(dir: URL, logger: AstroIntegrationLogger, outputDirectory: string, availableFonts: FontInfo[]): void;
 //# sourceMappingURL=astroBuild.d.ts.map

package/dist/astroBuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astroBuild.d.ts","sourceRoot":"","sources":["../src/astroBuild.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,sBAAsB,EAC9B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,QAAQ,EAAE,GACxB,IAAI,CAuBN"}
+{"version":3,"file":"astroBuild.d.ts","sourceRoot":"","sources":["../src/astroBuild.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,IAAI,CAqBlI"}

package/dist/astroBuild.js

@@ -5,17 +5,12 @@ import { fileURLToPath } from "url";
  * Handles the build completion phase for font loading.
  *
  * Copies all available font files to the output directory.
- *
- * @param {URL} dir - The build output directory URL.
- * @param {AstroIntegrationLogger} logger - The Astro integration logger for outputting messages.
- * @param {string} outputDir - The output directory name for font files.
- * @param {FontInfo[]} availableFonts - Array of font files to copy.
  */
-export function astroBuildDone(dir, logger, outputDir, availableFonts) {
+export function astroBuildDone(dir, logger, outputDirectory, availableFonts) {
     if (availableFonts.length === 0) {
         return;
     }
-    const outputPath = fileURLToPath(new URL(outputDir, dir));
+    const outputPath = fileURLToPath(new URL(outputDirectory, dir));
     if (!existsSync(outputPath)) {
         mkdirSync(outputPath, { recursive: true });
     }
@@ -29,6 +24,6 @@ export function astroBuildDone(dir, logger, outputDir, availableFonts) {
             logger.error(`Failed to copy ${font.filename}: ${error}`);
         }
     }
-    logger.info(`Copied ${availableFonts.length} font file(s) to ${outputDir}/`);
+    logger.info(`Copied ${availableFonts.length} font file(s) to ${outputDirectory}/`);
 }
 //# sourceMappingURL=astroBuild.js.map

package/dist/astroBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"astroBuild.js","sourceRoot":"","sources":["../src/astroBuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAMpC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAQ,EACR,MAA8B,EAC9B,SAAiB,EACjB,cAA0B;IAE1B,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;IACR,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC;YACJ,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,MAAM,CAAC,IAAI,CACV,UAAU,cAAc,CAAC,MAAM,oBAAoB,SAAS,GAAG,CAC/D,CAAC;AACH,CAAC"}
+{"version":3,"file":"astroBuild.js","sourceRoot":"","sources":["../src/astroBuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAMpC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,MAA8B,EAAE,eAAuB,EAAE,cAA0B;IAC3H,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;IACR,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC;YACJ,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,MAAM,oBAAoB,eAAe,GAAG,CAAC,CAAC;AACpF,CAAC"}

package/dist/astroConfig.d.ts

@@ -1,28 +1,17 @@
 import type { AstroIntegrationLogger } from "astro";
 import type { FontInfo, FontsPackageInfo } from "./fonts/fontInfo.ts";
+import type { FontConfig } from "./types.ts";
 /**
  * Result of the configuration setup for font loading.
- *
- * @property {Array<FontsPackageInfo>} fontsInfoList - List of font package information objects.
- * @property {FontInfo[]} availableFonts - Array of available font files from all packages.
- * @property {string} transformedCss - The combined and transformed CSS from all packages.
  */
 export type ConfigSetupResult = {
     fontsInfoList: FontsPackageInfo[];
     availableFonts: FontInfo[];
-    transformedCss: string;
 };
 /**
  * Sets up font configuration for the Astro integration.
  *
- * Resolves font packages, collects available fonts, applies optional filtering, and transforms CSS.
- *
- * @param {AstroIntegrationLogger} logger - The Astro integration logger for outputting messages.
- * @param {string[]} packages - Array of font package names to load.
- * @param {string} outputDir - The output directory for font files.
- * @param {(filename: string) => boolean} [filter] - Optional filter function to select font files.
- * @param {URL} [root] - Optional root directory to resolve packages from.
- * @returns {ConfigSetupResult} The result containing font info, available fonts, and transformed CSS.
+ * Resolves font packages, collects available fonts by matching CSS metadata.
  */
-export declare function astroConfigSetup(logger: AstroIntegrationLogger, packages: string[], outputDir: string, filter?: (filename: string) => boolean, root?: URL): ConfigSetupResult;
+export declare function astroConfigSetup(logger: AstroIntegrationLogger, fonts: FontConfig[], outputDirectory: string, root?: URL): ConfigSetupResult;
 //# sourceMappingURL=astroConfig.d.ts.map

package/dist/astroConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astroConfig.d.ts","sourceRoot":"","sources":["../src/astroConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAKpD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,EACtC,IAAI,CAAC,EAAE,GAAG,GACR,iBAAiB,CAsCnB"}
+{"version":3,"file":"astroConfig.d.ts","sourceRoot":"","sources":["../src/astroConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAIpD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,cAAc,EAAE,QAAQ,EAAE,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,eAAe,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,GAAG,GACR,iBAAiB,CAiCnB"}

package/dist/astroConfig.js

@@ -1,48 +1,35 @@
-import { existsSync, readFileSync } from "node:fs";
-import { filterCssFontFaces } from "./css/filter.js";
-import { transformCss } from "./css/transform.js";
+import { getFontsCss } from "./css/get.js";
 import { getAvailableFonts } from "./fonts/available.js";
 import { getFontsPackageInfo } from "./fonts/index.js";
 /**
  * Sets up font configuration for the Astro integration.
  *
- * Resolves font packages, collects available fonts, applies optional filtering, and transforms CSS.
- *
- * @param {AstroIntegrationLogger} logger - The Astro integration logger for outputting messages.
- * @param {string[]} packages - Array of font package names to load.
- * @param {string} outputDir - The output directory for font files.
- * @param {(filename: string) => boolean} [filter] - Optional filter function to select font files.
- * @param {URL} [root] - Optional root directory to resolve packages from.
- * @returns {ConfigSetupResult} The result containing font info, available fonts, and transformed CSS.
+ * Resolves font packages, collects available fonts by matching CSS metadata.
  */
-export function astroConfigSetup(logger, packages, outputDir, filter, root) {
+export function astroConfigSetup(logger, fonts, outputDirectory, root) {
     const fontsInfoList = [];
     let availableFonts = [];
-    let transformedCss = "";
-    if (!packages || packages.length === 0) {
-        logger.warn("No font packages specified. Fonts will not be copied.");
-        return { fontsInfoList: [], availableFonts, transformedCss };
+    if (!fonts || fonts.length === 0) {
+        logger.warn("No fonts specified. Fonts will not be copied.");
+        return { fontsInfoList: [], availableFonts };
     }
-    for (const packageName of packages) {
-        const fontsInfo = getFontsPackageInfo(packageName, root);
+    for (const fontConfig of fonts) {
+        const { source } = fontConfig;
+        const fontsInfo = getFontsPackageInfo(source.package, root, source.styleFile);
         if (!fontsInfo) {
-            logger.warn(`${packageName} package not found. Skipping.`);
+            logger.warn(`${source.package} package not found. Skipping ${fontConfig.family}.`);
             continue;
         }
         fontsInfoList.push(fontsInfo);
-        let packageFonts = getAvailableFonts(fontsInfo.fontsDir);
-        if (filter) {
-            packageFonts = packageFonts.filter((font) => filter(font.filename));
-        }
-        availableFonts = availableFonts.concat(packageFonts);
-        if (existsSync(fontsInfo.cssPath)) {
-            let rawCss = readFileSync(fontsInfo.cssPath, "utf-8");
-            rawCss = filterCssFontFaces(rawCss, filter);
-            transformedCss += transformCss(rawCss, outputDir, filter);
+        for (const variant of fontConfig.variants) {
+            const result = getFontsCss({ name: variant.name, variants: [variant], outputDirectory }, fontsInfo);
+            const allPackageFonts = getAvailableFonts(fontsInfo.fontsDir);
+            const matchedFonts = allPackageFonts.filter((f) => result.filenames.includes(f.filename));
+            availableFonts = availableFonts.concat(matchedFonts);
+            logger.info(`Loaded ${matchedFonts.length} font file(s) for ${fontConfig.family} (${variant.name}) from ${source.package}`);
         }
-        logger.info(`Loaded ${packageFonts.length} font file(s) from ${packageName}`);
     }
     logger.info(`Found ${availableFonts.length} total font file(s) to copy`);
-    return { fontsInfoList, availableFonts, transformedCss };
+    return { fontsInfoList, availableFonts };
 }
 //# sourceMappingURL=astroConfig.js.map

package/dist/astroConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"astroConfig.js","sourceRoot":"","sources":["../src/astroConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAInD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAevD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC/B,MAA8B,EAC9B,QAAkB,EAClB,SAAiB,EACjB,MAAsC,EACtC,IAAU;IAEV,MAAM,aAAa,GAAuB,EAAE,CAAC;IAC7C,IAAI,cAAc,GAAe,EAAE,CAAC;IACpC,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACrE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;IAC9D,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,+BAA+B,CAAC,CAAC;YAC3D,SAAS;QACV,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,YAAY,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,MAAM,EAAE,CAAC;YACZ,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,IAAI,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5C,cAAc,IAAI,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,CAAC,IAAI,CACV,UAAU,YAAY,CAAC,MAAM,sBAAsB,WAAW,EAAE,CAChE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,6BAA6B,CAAC,CAAC;IAEzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"astroConfig.js","sourceRoot":"","sources":["../src/astroConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAWvD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,MAA8B,EAC9B,KAAmB,EACnB,eAAuB,EACvB,IAAU;IAEV,MAAM,aAAa,GAAuB,EAAE,CAAC;IAC7C,IAAI,cAAc,GAAe,EAAE,CAAC;IAEpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;QAC9B,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,gCAAgC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YACnF,SAAS;QACV,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE9B,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,EAAE,SAAS,CAAC,CAAC;YAEpG,MAAM,eAAe,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1F,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAErD,MAAM,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,MAAM,qBAAqB,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7H,CAAC;IACF,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,6BAA6B,CAAC,CAAC;IAEzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAC1C,CAAC"}

package/dist/css/filter.d.ts

@@ -1,12 +1,16 @@
+import type { FontVariant } from "../types.ts";
 /**
- * Filters @font-face rules in a CSS string based on a filename filter function.
- *
- * Iterates over all @font-face blocks and removes those for which the filter function returns false
- * for any font file referenced in the block. If no filter is provided, returns the original CSS.
+ * Result of matching @font-face blocks against font variants.
+ */
+export type CssMatchResult = {
+    css: string;
+    filenames: string[];
+};
+/**
+ * Filters @font-face blocks by matching their font-family, font-weight, and font-style
+ * against the provided variant definitions.
  *
- * @param {string} css - The CSS string containing @font-face rules.
- * @param {(filename: string) => boolean} [filter] - Optional filter function that receives a font filename and returns true to keep the rule, false to remove it.
- * @returns {string} The filtered CSS string with only the allowed @font-face rules.
+ * Returns the matched CSS blocks and the font filenames they reference.
  */
-export declare function filterCssFontFaces(css: string, filter?: (filename: string) => boolean): string;
+export declare function matchCssFontFaces(css: string, name: string, variants: FontVariant[]): CssMatchResult;
 //# sourceMappingURL=filter.d.ts.map

package/dist/css/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/css/filter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GACpC,MAAM,CAgBR"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/css/filter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoC/C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,cAAc,CA4BpG"}

package/dist/css/filter.js

@@ -1,28 +1,58 @@
 import { basename } from "node:path";
 /**
- * Filters @font-face rules in a CSS string based on a filename filter function.
+ * Parses a @font-face block and extracts its metadata.
+ */
+function parseFontFace(block) {
+    const familyMatch = block.match(/font-family:\s*["']([^"']+)["']/);
+    const weightMatch = block.match(/font-weight:\s*(\d+(?:\s+\d+)?)/);
+    const styleMatch = block.match(/font-style:\s*(\w+)/);
+    const urlMatches = [...block.matchAll(/url\(["']?\.\/([^"')]+)["']?\)/g)];
+    const family = familyMatch?.[1] ?? "";
+    const style = styleMatch?.[1] ?? "normal";
+    let weight = 400;
+    if (weightMatch) {
+        const parts = weightMatch[1].split(/\s+/).map(Number);
+        weight = parts.length === 2 ? [parts[0], parts[1]] : parts[0];
+    }
+    const filenames = urlMatches.map((m) => basename(m[1]));
+    return { family, weight, style, filenames };
+}
+/**
+ * Checks if a CSS font-weight matches a variant weight.
  *
- * Iterates over all @font-face blocks and removes those for which the filter function returns false
- * for any font file referenced in the block. If no filter is provided, returns the original CSS.
+ * A single weight matches if equal. A range matches if any overlap exists.
+ */
+function weightMatches(cssWeight, variantWeight) {
+    const [cssMin, cssMax] = Array.isArray(cssWeight) ? cssWeight : [cssWeight, cssWeight];
+    const [varMin, varMax] = Array.isArray(variantWeight) ? variantWeight : [variantWeight, variantWeight];
+    return cssMin <= varMax && varMin <= cssMax;
+}
+/**
+ * Filters @font-face blocks by matching their font-family, font-weight, and font-style
+ * against the provided variant definitions.
  *
- * @param {string} css - The CSS string containing @font-face rules.
- * @param {(filename: string) => boolean} [filter] - Optional filter function that receives a font filename and returns true to keep the rule, false to remove it.
- * @returns {string} The filtered CSS string with only the allowed @font-face rules.
+ * Returns the matched CSS blocks and the font filenames they reference.
  */
-export function filterCssFontFaces(css, filter) {
-    if (!filter) {
-        return css;
-    }
-    return css.replace(/@font-face\s*\{[^}]*\}/g, (match) => {
-        const urlMatches = match.matchAll(/url\(["']?\.\/([^"')]+)["']?\)/g);
-        for (const urlMatch of urlMatches) {
-            const relativePath = urlMatch[1];
-            const filename = basename(relativePath);
-            if (filter(filename)) {
-                return match;
+export function matchCssFontFaces(css, name, variants) {
+    const filenameSet = new Set();
+    const formats = new Set(variants.flatMap((v) => v.formats ?? ["woff2"]));
+    const filtered = css.replace(/@font-face\s*\{[^}]*\}/g, (block) => {
+        const parsed = parseFontFace(block);
+        if (parsed.family.toLowerCase() !== name.toLowerCase()) {
+            return "";
+        }
+        const matches = variants.some((v) => weightMatches(parsed.weight, v.weight) && v.styles.includes(parsed.style));
+        if (!matches) {
+            return "";
+        }
+        for (const filename of parsed.filenames) {
+            const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+            if (formats.has(ext)) {
+                filenameSet.add(filename);
             }
         }
-        return "";
+        return block;
     });
+    return { css: filtered, filenames: [...filenameSet] };
 }
 //# sourceMappingURL=filter.js.map

package/dist/css/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/css/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CACjC,GAAW,EACX,MAAsC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,EAAE;QACvD,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QACrE,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YACxC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtB,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QACD,OAAO,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/css/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC;;GAEG;AACH,SAAS,aAAa,CAAC,KAAa;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAE1E,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAE1C,IAAI,MAAM,GAA8B,GAAG,CAAC;IAC5C,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,SAAoC,EAAE,aAAwC;IACpG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACvG,OAAO,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC;AAC7C,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAY,EAAE,QAAuB;IACnF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,KAAK,EAAE,EAAE;QACjE,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxD,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhH,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACX,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/css/get.d.ts

@@ -1,22 +1,28 @@
 import type { FontsPackageInfo } from "../fonts/index.ts";
+import type { FontVariant } from "../types.ts";
 /**
  * Options for getting CSS for @font-face
  */
 export type GetFontsCssOptions = {
-    /** Optional filter function to select font files by filename. */
-    filter?: (filename: string) => boolean;
-    /** Optional output directory name. Defaults to "fonts". */
-    outputDir?: string;
+    /** The CSS font-family name to match. */
+    name: string;
+    /** Variants to match by weight and style. */
+    variants: FontVariant[];
+    /** Output directory name. */
+    outputDirectory: string;
 };
 /**
- * Loads, filters, and transforms the CSS for font-face rules from a font package.
- *
- * Reads the CSS file specified in the font package information, applies an optional filter to @font-face rules,
- * and transforms the CSS for output. Returns an empty string if no font package information is provided or the CSS file does not exist.
+ * Result of CSS processing, including matched CSS and font filenames.
+ */
+export type GetFontsCssResult = {
+    css: string;
+    filenames: string[];
+};
+/**
+ * Loads, matches, and transforms the CSS for @font-face rules from a font package.
  *
- * @param {GetFontsCssOptions} [options={}] - Options including filter and output directory.
- * @param {FontsPackageInfo | null} fontPackageInformation - Information about the font package, including the CSS file path.
- * @returns {string} The processed and minified CSS string, or an empty string if the CSS file is missing or no package info is provided.
+ * Matches @font-face blocks by font-family name, weight, and style against the provided variants.
+ * Returns the processed CSS and the list of matched font filenames.
  */
-export declare function getFontsCss(options: GetFontsCssOptions | undefined, fontPackageInformation: FontsPackageInfo | null): string;
+export declare function getFontsCss(options: GetFontsCssOptions, fontPackageInformation: FontsPackageInfo | null): GetFontsCssResult;
 //# sourceMappingURL=get.d.ts.map

package/dist/css/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/css/get.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAiBF;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,kBAAkB,YAAK,EAChC,sBAAsB,EAAE,gBAAgB,GAAG,IAAI,GAC7C,MAAM,CAaR"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/css/get.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,GAAG,IAAI,GAAG,iBAAiB,CAU3H"}

package/dist/css/get.js

@@ -1,11 +1,8 @@
 import { existsSync, readFileSync } from "node:fs";
-import { filterCssFontFaces } from "./filter.js";
+import { matchCssFontFaces } from "./filter.js";
 import { transformCss } from "./transform.js";
 /**
  * Minifies a CSS string by removing comments, extra whitespace, and newlines.
- *
- * @param css - The CSS string to minify.
- * @returns The minified CSS string.
  */
 function minifyCss(css) {
     return css
@@ -16,24 +13,19 @@ function minifyCss(css) {
         .trim();
 }
 /**
- * Loads, filters, and transforms the CSS for font-face rules from a font package.
- *
- * Reads the CSS file specified in the font package information, applies an optional filter to @font-face rules,
- * and transforms the CSS for output. Returns an empty string if no font package information is provided or the CSS file does not exist.
+ * Loads, matches, and transforms the CSS for @font-face rules from a font package.
  *
- * @param {GetFontsCssOptions} [options={}] - Options including filter and output directory.
- * @param {FontsPackageInfo | null} fontPackageInformation - Information about the font package, including the CSS file path.
- * @returns {string} The processed and minified CSS string, or an empty string if the CSS file is missing or no package info is provided.
+ * Matches @font-face blocks by font-family name, weight, and style against the provided variants.
+ * Returns the processed CSS and the list of matched font filenames.
  */
-export function getFontsCss(options = {}, fontPackageInformation) {
-    const { filter, outputDir = "fonts" } = options;
-    if (!fontPackageInformation ||
-        !existsSync(fontPackageInformation.cssPath)) {
-        return "";
+export function getFontsCss(options, fontPackageInformation) {
+    const { name, variants, outputDirectory } = options;
+    if (!fontPackageInformation || !existsSync(fontPackageInformation.cssPath)) {
+        return { css: "", filenames: [] };
     }
-    let rawCss = readFileSync(fontPackageInformation.cssPath, "utf-8");
-    rawCss = filterCssFontFaces(rawCss, filter);
-    const transformedCss = transformCss(rawCss, outputDir, filter);
-    return minifyCss(transformedCss);
+    const rawCss = readFileSync(fontPackageInformation.cssPath, "utf-8");
+    const matched = matchCssFontFaces(rawCss, name, variants);
+    const transformedCss = transformCss(matched.css, outputDirectory);
+    return { css: minifyCss(transformedCss), filenames: matched.filenames };
 }
 //# sourceMappingURL=get.js.map

package/dist/css/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/css/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAY9C;;;;;GAKG;AACH,SAAS,SAAS,CAAC,GAAW;IAC7B,OAAO,GAAG;SACR,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC;SACjC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,IAAI,EAAE,CAAC;AACV,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAC1B,UAA8B,EAAE,EAChC,sBAA+C;IAE/C,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAChD,IACC,CAAC,sBAAsB;QACvB,CAAC,UAAU,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAC1C,CAAC;QACF,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,MAAM,GAAG,YAAY,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,SAAS,CAAC,cAAc,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/css/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAInD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsB9C;;GAEG;AACH,SAAS,SAAS,CAAC,GAAW;IAC7B,OAAO,GAAG;SACR,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC;SACjC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,IAAI,EAAE,CAAC;AACV,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE,sBAA+C;IACvG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IACpD,IAAI,CAAC,sBAAsB,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAClE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;AACzE,CAAC"}

package/dist/css/transform.d.ts

@@ -1,12 +1,7 @@
 /**
  * Transforms font-face URLs in a CSS string to point to a specified output directory.
  *
- * Replaces relative font URLs with absolute URLs based on the output directory. Optionally filters font files by filename.
- *
- * @param {string} rawCss - The raw CSS string containing font-face rules.
- * @param {string} outputDir - The output directory to use in the transformed URLs.
- * @param {(filename: string) => boolean} [filter] - Optional filter function to determine which font files to transform.
- * @returns {string} The CSS string with transformed font-face URLs.
+ * Replaces relative font URLs with absolute URLs based on the output directory.
  */
-export declare function transformCss(rawCss: string, outputDir: string, filter?: (filename: string) => boolean): string;
+export declare function transformCss(rawCss: string, outputDir: string): string;
 //# sourceMappingURL=transform.d.ts.map

package/dist/css/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/css/transform.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GACpC,MAAM,CAWR"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/css/transform.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/dist/css/transform.js

@@ -2,19 +2,11 @@ import { basename } from "node:path";
 /**
  * Transforms font-face URLs in a CSS string to point to a specified output directory.
  *
- * Replaces relative font URLs with absolute URLs based on the output directory. Optionally filters font files by filename.
- *
- * @param {string} rawCss - The raw CSS string containing font-face rules.
- * @param {string} outputDir - The output directory to use in the transformed URLs.
- * @param {(filename: string) => boolean} [filter] - Optional filter function to determine which font files to transform.
- * @returns {string} The CSS string with transformed font-face URLs.
+ * Replaces relative font URLs with absolute URLs based on the output directory.
  */
-export function transformCss(rawCss, outputDir, filter) {
-    return rawCss.replace(/url\(["']?\.\/([^"')]+)["']?\)/g, (match, relativePath) => {
+export function transformCss(rawCss, outputDir) {
+    return rawCss.replace(/url\(["']?\.\/([^"')]+)["']?\)/g, (_match, relativePath) => {
         const filename = basename(relativePath);
-        if (filter && !filter(filename)) {
-            return match;
-        }
         return `url("/${outputDir}/${filename}")`;
     });
 }

package/dist/css/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/css/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC3B,MAAc,EACd,SAAiB,EACjB,MAAsC;IAEtC,OAAO,MAAM,CAAC,OAAO,CACpB,iCAAiC,EACjC,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,SAAS,SAAS,IAAI,QAAQ,IAAI,CAAC;IAC3C,CAAC,CACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/css/transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAiB;IAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE;QACjF,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,SAAS,SAAS,IAAI,QAAQ,IAAI,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/fonts/package.d.ts

@@ -7,7 +7,8 @@ import type { FontsPackageInfo } from "./fontInfo.ts";
  *
  * @param {string} fontsPackage - The name of the font package to resolve.
  * @param {URL | string} [root] - Optional root directory to resolve packages from. Can be a URL or file path.
+ * @param {string} [styleFile] - Optional path to the CSS file relative to the package root. Defaults to "src/index.css".
  * @returns {FontsPackageInfo | null} An object containing the fonts directory and CSS file path, or null if not found.
  */
-export declare function getFontsPackageInfo(fontsPackage: string, root?: URL | string): FontsPackageInfo | null;
+export declare function getFontsPackageInfo(fontsPackage: string, root?: URL | string, styleFile?: string): FontsPackageInfo | null;
 //# sourceMappingURL=package.d.ts.map

package/dist/fonts/package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/fonts/package.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,GAAG,GAAG,MAAM,GACjB,gBAAgB,GAAG,IAAI,CAqBzB"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/fonts/package.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAmB1H"}

package/dist/fonts/package.js

@@ -9,9 +9,10 @@ import { fileURLToPath } from "node:url";
  *
  * @param {string} fontsPackage - The name of the font package to resolve.
  * @param {URL | string} [root] - Optional root directory to resolve packages from. Can be a URL or file path.
+ * @param {string} [styleFile] - Optional path to the CSS file relative to the package root. Defaults to "src/index.css".
  * @returns {FontsPackageInfo | null} An object containing the fonts directory and CSS file path, or null if not found.
  */
-export function getFontsPackageInfo(fontsPackage, root) {
+export function getFontsPackageInfo(fontsPackage, root, styleFile) {
     try {
         let requireBase;
         if (root) {
@@ -24,7 +25,7 @@ export function getFontsPackageInfo(fontsPackage, root) {
         const require = createRequire(requireBase);
         const fontsPackagePath = require.resolve(`${fontsPackage}/package.json`);
         const fontsDir = dirname(fontsPackagePath);
-        const cssPath = join(fontsDir, "src", "index.css");
+        const cssPath = styleFile ? join(fontsDir, styleFile) : join(fontsDir, "src", "index.css");
         return { fontsDir, cssPath };
     }
     catch {

package/dist/fonts/package.js.map

@@ -1 +1 @@
-{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/fonts/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAAoB,EACpB,IAAmB;IAEnB,IAAI,CAAC;QACJ,IAAI,WAAmB,CAAC;QACxB,IAAI,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAElE,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACP,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CACvC,GAAG,YAAY,eAAe,CAC9B,CAAC;QACF,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/fonts/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB,EAAE,IAAmB,EAAE,SAAkB;IAChG,IAAI,CAAC;QACJ,IAAI,WAAmB,CAAC;QACxB,IAAI,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAElE,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACP,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,YAAY,eAAe,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC3F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,5 @@
 export { fontsIntegration } from "./integration.ts";
-export type { FontsIntegrationOptions } from "./integration.ts";
 export { getFontsCss } from "./css/index.ts";
-export type { GetFontsCssOptions } from "./css/get.ts";
-export { getFontsPackageInfo, getAvailableFonts } from "./fonts/index.ts";
-export type { FontInfo, FontsPackageInfo } from "./fonts/index.ts";
-export type { PreloadConfig } from "./components/types.ts";
+export { getFontsPackageInfo } from "./fonts/index.ts";
+export type { FontLoaderConfig, FontConfig, FontSource, PackageProvider, FontVariant, PreloadEntry } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEnE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export { fontsIntegration } from "./integration.js";
 export { getFontsCss } from "./css/index.js";
-export { getFontsPackageInfo, getAvailableFonts } from "./fonts/index.js";
+export { getFontsPackageInfo } from "./fonts/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/integration.d.ts

@@ -1,41 +1,9 @@
 import type { AstroIntegration } from "astro";
-/**
- * Options for integrating fonts into a build process.
- *
- * Allows specifying font packages to load, a filter function to select which font files to include,
- * and the output directory name for copied fonts.
- * If no filter is provided, all fonts are included. The output directory defaults to "fonts".
- *
- * @property {string[]} [packages] - Array of font package names to load. Required.
- * @property {(filename: string) => boolean} [filter] - Optional filter function to select font files by filename.
- * @property {string} [outputDir] - Optional output directory name within the build folder. Defaults to "fonts".
- */
-export type FontsIntegrationOptions = {
-    /**
-     * Array of font package names to load.
-     * Each package should export fonts in a standard structure with a src/index.css file.
-     * @example ['@iveelsm/fonts', '@fontsource/roboto']
-     */
-    packages: string[];
-    /**
-     * Filter function to select which font files to copy.
-     * Receives the font filename and should return true to include the font.
-     * If not provided, all fonts are copied.
-     */
-    filter?: (filename: string) => boolean;
-    /**
-     * Output directory name within the build folder.
-     * Defaults to "fonts"
-     */
-    outputDir?: string;
-};
+import type { FontLoaderConfig } from "./types.ts";
 /**
  * Creates an Astro integration for font loading and transformation.
  *
- * Sets up hooks for Astro's config and build phases to process font files and CSS, using provided options for filtering and output directory.
- *
- * @param {FontsIntegrationOptions} [options={}] - Options for filtering font files and specifying the output directory.
- * @returns {AstroIntegration} The Astro integration object for font loading.
+ * Sets up hooks for Astro's config and build phases to process font files and CSS.
  */
-export declare function fontsIntegration(options: FontsIntegrationOptions): AstroIntegration;
+export declare function fontsIntegration(config: FontLoaderConfig): AstroIntegration;
 //# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAM9C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,uBAAuB,GAC9B,gBAAgB,CAuBlB"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAK9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAiB3E"}

package/dist/integration.js

@@ -3,23 +3,20 @@ import { astroConfigSetup } from "./astroConfig.js";
 /**
  * Creates an Astro integration for font loading and transformation.
  *
- * Sets up hooks for Astro's config and build phases to process font files and CSS, using provided options for filtering and output directory.
- *
- * @param {FontsIntegrationOptions} [options={}] - Options for filtering font files and specifying the output directory.
- * @returns {AstroIntegration} The Astro integration object for font loading.
+ * Sets up hooks for Astro's config and build phases to process font files and CSS.
  */
-export function fontsIntegration(options) {
-    const { packages, filter, outputDir = "fonts" } = options;
+export function fontsIntegration(config) {
+    const { fonts, outputDirectory } = config;
     let availableFonts = [];
     return {
         name: "astro-font-loader",
         hooks: {
-            "astro:config:setup": ({ config, logger }) => {
-                const result = astroConfigSetup(logger, packages, outputDir, filter, config.root);
+            "astro:config:setup": ({ config: astroConfig, logger }) => {
+                const result = astroConfigSetup(logger, fonts, outputDirectory, astroConfig.root);
                 availableFonts = result.availableFonts;
             },
             "astro:build:done": ({ dir, logger }) => {
-                astroBuildDone(dir, logger, outputDir, availableFonts);
+                astroBuildDone(dir, logger, outputDirectory, availableFonts);
             },
         },
     };

package/dist/integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAkCpD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAgC;IAEhC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1D,IAAI,cAAc,GAAe,EAAE,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE;YACN,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC5C,MAAM,MAAM,GAAG,gBAAgB,CAC9B,MAAM,EACN,QAAQ,EACR,SAAS,EACT,MAAM,EACN,MAAM,CAAC,IAAI,CACX,CAAC;gBACF,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YACxC,CAAC;YACD,kBAAkB,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACvC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YACxD,CAAC;SACD;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACxD,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAE1C,IAAI,cAAc,GAAe,EAAE,CAAC;IAEpC,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE;YACN,oBAAoB,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;gBAClF,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YACxC,CAAC;YACD,kBAAkB,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBACvC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;YAC9D,CAAC;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Top-level configuration for the font loader integration.
+ */
+export type FontLoaderConfig = {
+    outputDirectory: string;
+    fonts: FontConfig[];
+};
+/**
+ * Configuration for a single font family.
+ */
+export type FontConfig = {
+    family: string;
+    source: FontSource;
+    variants: FontVariant[];
+};
+/**
+ * Font source provider. Currently only supports package providers,
+ * but will be extended with local and network providers.
+ */
+export type FontSource = PackageProvider;
+/**
+ * Resolves font files from an installed npm package.
+ */
+export type PackageProvider = {
+    type: "package";
+    package: string;
+    /** Path to the CSS file relative to the package root. Defaults to "src/index.css". */
+    styleFile?: string;
+};
+/**
+ * A specific font variant to load.
+ */
+export type FontVariant = {
+    /** The CSS font-family name to match in @font-face rules (case-insensitive). */
+    name: string;
+    /** Font weight as a single value or a [min, max] range for variable fonts. */
+    weight: number | [number, number];
+    /** Font styles to match, e.g. ["normal", "italic"]. */
+    styles: string[];
+    /** File formats to include. Defaults to ["woff2"]. */
+    formats?: string[];
+};
+/**
+ * Configuration for selectively preloading a font variant.
+ *
+ * Matches against FontVariant by name, and optionally by weight and styles
+ * for per-variant granularity. Omitting weight/styles matches all variants
+ * with that name.
+ */
+export type PreloadEntry = {
+    /** CSS font-family name to match. */
+    variant: string;
+    /** Narrow to a specific weight. If omitted, matches all weights for this variant. */
+    weight?: number | [number, number];
+    /** Narrow to specific styles. If omitted, matches all styles for this variant. */
+    styles?: string[];
+    /** Optional media query for the preload link. */
+    media?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "astro-font-loader",
-	"description": "Loads fonts into astro build artifacts from custom fonts packages",
+	"description": "Astro integration for loading fonts into build artifacts with configurable output paths and media query-based conditional preloading.",
 	"author": "Mikey Sleevi <development@frogman.simplelogin.com>",
 	"license": "MIT",
 	"type": "module",
-	"version": "0.2.3",
+	"version": "0.3.2",
 	"engines": {
 		"node": ">=18.0.0"
 	},
@@ -28,7 +28,11 @@
 		"astro-component",
 		"astro-loader",
 		"astro",
+		"font",
 		"fonts",
+		"optimization",
+		"perf",
+		"performance",
 		"plugin"
 	],
 	"homepage": "https://github.com/iveelsm/astro-font-loader#readme",

package/dist/components/types.d.ts

@@ -1,7 +0,0 @@
-export interface PreloadConfig {
-    /** Filter function to select which fonts to preload. */
-    filter: (filename: string) => boolean;
-    /** Optional media query for the preload link (e.g., "(min-width: 641px)"). */
-    media?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/components/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/components/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":""}