✨ Add support for allowing specific fonts when preloading (#46)

Author: Log1x

README.md

@@ -113,11 +113,15 @@ $fonts = Webfonts::fonts();
 $html = Webfonts::preload()->build();
 ```
 
-Excluding certain fonts from being preloaded can be done inside `register()` of a service provider:
+Allowing/excluding certain fonts from being preloaded can be done inside `register()` of a service provider:
 
 ```php
 use Log1x\LaravelWebfonts\Webfonts;
 
+// Allow specific fonts.
+Webfonts::only(['inter-v13-latin-regular']);
+
+// Exclude specific fonts.
 Webfonts::except(['inter-v13-latin-500']);
 ```
 

src/Webfonts.php

@@ -27,7 +27,12 @@ class Webfonts
     protected bool $wordpress = false;
 
     /**
-     * The exception list.
+     * The fonts to allow.
+     */
+    public static array $only = [];
+
+    /**
+     * The fonts to exclude.
      */
     public static array $except = [];
 
@@ -74,19 +79,29 @@ public static function except(array $except): void
         static::$except = [...static::$except, ...$except];
     }
 
+    /**
+     * Set the fonts to allow.
+     */
+    public static function only(array $only): void
+    {
+        static::$only = [...static::$only, ...$only];
+    }
+
     /**
      * Retrieve the fonts from the manifest.
      */
-    public function fonts(array $except = []): array
+    public function fonts(array $except = [], array $only = []): array
     {
         if ($this->fonts) {
             return $this->fonts;
         }
 
         $except = [...static::$except, ...$except];
+        $only = [...static::$only, ...$only];
 
         return collect($this->manifest())
             ->filter(fn ($value, $key) => Str::endsWith($key, '.woff2'))
+            ->filter(fn ($value, $key) => blank($only) || in_array(basename($key), $only) || in_array(basename($key, '.woff2'), $only))
             ->reject(fn ($value, $key) => in_array(basename($key), $except) || in_array(basename($key, '.woff2'), $except))
             ->all();
     }