error('GOOGLE_FONTS_API_KEY is missing in the environment.'); return self::FAILURE; } $count = max(1, (int) $this->option('count')); $weights = $this->prepareWeights($this->option('weights')); $includeItalic = (bool) $this->option('italic'); $force = (bool) $this->option('force'); $dryRun = (bool) $this->option('dry-run'); $familyOption = $this->normalizeFamilyOption($this->option('family')); $categories = $this->prepareCategories($this->option('category')); $pathOption = $this->option('path'); $basePath = $pathOption ? (Str::startsWith($pathOption, DIRECTORY_SEPARATOR) ? $pathOption : base_path($pathOption)) : public_path('fonts/google'); if ($familyOption) { $this->info(sprintf('Fetching Google Font family "%s" (weights: %s, italic: %s)...', $familyOption, implode(', ', $weights), $includeItalic ? 'yes' : 'no')); } else { $this->info(sprintf('Fetching top %d Google Fonts (weights: %s, italic: %s)...', $count, implode(', ', $weights), $includeItalic ? 'yes' : 'no')); } if (count($categories)) { $this->line('Category filter: '.implode(', ', $categories)); } if ($dryRun) { $this->warn('Dry run enabled: no files will be written.'); } $response = Http::retry(2, 200) ->timeout(30) ->get(self::API_ENDPOINT, [ 'key' => $apiKey, 'sort' => 'popularity', ]); if (! $response->ok()) { $this->error(sprintf('Google Fonts API failed: %s', $response->body())); return self::FAILURE; } $items = Arr::get($response->json(), 'items', []); if (! is_array($items) || ! count($items)) { $this->warn('Google Fonts API returned no items.'); return self::SUCCESS; } $items = $this->filterFonts($items, $familyOption, $categories); if ($familyOption && ! count($items)) { $this->error(sprintf('Font family "%s" was not found.', $familyOption)); return self::FAILURE; } if (! count($items)) { $this->warn('No fonts matched the provided filters.'); return self::SUCCESS; } $selected = $familyOption ? $items : array_slice($items, 0, $count); $manifestFonts = []; $filesystem = new Filesystem; if (! $dryRun) { File::ensureDirectoryExists($basePath); } foreach ($selected as $index => $font) { if (! is_array($font) || ! isset($font['family'])) { continue; } $family = (string) $font['family']; $slug = Str::slug($family); $familyDir = $basePath.DIRECTORY_SEPARATOR.$slug; if (! $dryRun) { File::ensureDirectoryExists($familyDir); } $variantMap = $this->buildVariantMap($font, $weights, $includeItalic); if (! count($variantMap)) { $this->warn("Skipping {$family} (no matching variants)"); continue; } $variants = []; foreach ($variantMap as $variantKey => $fileUrl) { $style = str_contains($variantKey, 'italic') ? 'italic' : 'normal'; $weight = (int) preg_replace('/[^0-9]/', '', $variantKey) ?: 400; $extension = pathinfo(parse_url($fileUrl, PHP_URL_PATH) ?? '', PATHINFO_EXTENSION) ?: 'woff2'; $filename = sprintf('%s-%s-%s.%s', Str::studly($slug), $weight, $style, $extension); $targetPath = $familyDir.DIRECTORY_SEPARATOR.$filename; $alreadyExists = $filesystem->exists($targetPath); if ($dryRun) { $this->line(sprintf('◦ DRY RUN: %s %s would %s (%s)', $family, $variantKey, $alreadyExists && ! $force ? 'reuse existing file' : 'download', $targetPath)); } elseif (! $force && $alreadyExists) { $this->line("✔ {$family} {$variantKey} already exists"); } else { $this->line("↓ Downloading {$family} {$variantKey}"); $fileResponse = Http::retry(2, 200)->timeout(30)->get($fileUrl); if (! $fileResponse->ok()) { $this->warn(" Skipped {$family} {$variantKey} (download failed)"); continue; } $filesystem->put($targetPath, $fileResponse->body()); } $relativePath = sprintf('/fonts/google/%s/%s', $slug, $filename); $variants[] = [ 'variant' => $variantKey, 'weight' => $weight, 'style' => $style, 'url' => $relativePath, ]; } if (! count($variants)) { continue; } $manifestFonts[] = [ 'family' => $family, 'slug' => $slug, 'category' => $font['category'] ?? null, 'variants' => $variants, ]; } if ($dryRun) { $this->info(sprintf('Dry run complete: %d font families would be synced to %s', count($manifestFonts), $basePath)); return self::SUCCESS; } $this->pruneStaleFamilies($basePath, $manifestFonts); $this->writeManifest($basePath, $manifestFonts); $this->writeCss($basePath, $manifestFonts); Cache::forget('fonts:manifest'); $this->info(sprintf('Synced %d font families to %s', count($manifestFonts), $basePath)); return self::SUCCESS; } private function normalizeFamilyOption(?string $family): ?string { $family = trim((string) $family); return $family !== '' ? $family : null; } /** * @return array */ private function prepareCategories(?string $categories): array { $parts = array_filter(array_map('trim', explode(',', (string) $categories))); return array_values(array_unique(array_map(static function ($category) { $normalized = Str::of($category)->lower()->replace(' ', '-')->toString(); return (string) $normalized; }, $parts))); } /** * @param array $items * @return array */ private function filterFonts(array $items, ?string $family, array $categories): array { $filtered = collect($items) ->filter(fn ($font) => is_array($font) && isset($font['family'])) ->filter(function ($font) use ($categories) { if (! count($categories)) { return true; } $category = strtolower((string) ($font['category'] ?? '')); return in_array($category, $categories, true); }); if ($family) { $filtered = $filtered->filter(function ($font) use ($family) { return strcasecmp((string) $font['family'], $family) === 0; }); } return $filtered->values()->all(); } /** * @return array */ private function prepareWeights(string $weights): array { $parts = array_filter(array_map('trim', explode(',', $weights))); $numeric = array_map(fn ($weight) => (int) $weight, $parts); $numeric = array_filter($numeric, fn ($weight) => $weight >= 100 && $weight <= 900); return $numeric ? array_values(array_unique($numeric)) : [400, 700]; } /** * @param array $font * @return array */ private function buildVariantMap(array $font, array $weights, bool $includeItalic): array { $files = $font['files'] ?? []; if (! is_array($files)) { return []; } $variants = []; foreach ($weights as $weight) { $normalKey = $weight === 400 ? 'regular' : (string) $weight; $italicKey = $weight === 400 ? 'italic' : $weight.'italic'; if (isset($files[$normalKey])) { $variants[$normalKey] = (string) $files[$normalKey]; } if ($includeItalic && isset($files[$italicKey])) { $variants[$italicKey] = (string) $files[$italicKey]; } } // Fallback: if no requested weights present, try any provided if (! count($variants)) { foreach ($files as $key => $url) { if (is_string($key) && is_string($url)) { $variants[$key] = $url; } } } return $variants; } private function pruneStaleFamilies(string $basePath, array $manifestFonts): void { $keep = collect($manifestFonts)->pluck('slug')->filter()->all(); $directories = File::directories($basePath); foreach ($directories as $dir) { $name = basename($dir); if (! in_array($name, $keep, true)) { File::deleteDirectory($dir); $this->line("🗑 Removed stale font directory {$name}"); } } } private function writeManifest(string $basePath, array $fonts): void { $manifest = [ 'generated_at' => now()->toIso8601String(), 'source' => 'google-webfonts', 'count' => count($fonts), 'fonts' => $fonts, ]; File::put($basePath.'/manifest.json', json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)); } private function writeCss(string $basePath, array $fonts): void { $lines = [ '/* Auto-generated by fonts:sync-google */', ]; foreach ($fonts as $font) { $family = $font['family'] ?? null; $variants = $font['variants'] ?? []; if (! $family || ! is_array($variants)) { continue; } foreach ($variants as $variant) { if (! isset($variant['url'])) { continue; } $lines[] = sprintf( "@font-face {\n font-family: '%s';\n font-style: %s;\n font-weight: %s;\n font-display: swap;\n src: url('%s') format('%s');\n}\n", $family, $variant['style'] ?? 'normal', $variant['weight'] ?? 400, $variant['url'], $this->guessFormat((string) ($variant['url'] ?? '')) ); } } File::put($basePath.'/fonts.css', implode("\n", $lines)); } private function guessFormat(string $url): string { $extension = strtolower(pathinfo(parse_url($url, PHP_URL_PATH) ?? '', PATHINFO_EXTENSION)); return match ($extension) { 'ttf' => 'truetype', 'otf' => 'opentype', 'woff' => 'woff', default => 'woff2', }; } }