feat: return font file priority

src/providers/google.ts

@@ -1,4 +1,4 @@
-import type { ResolveFontOptions } from '../types'
+import type { FontFaceData, ResolveFontOptions } from '../types'
 
 import { hash } from 'ohash'
 import { extractFontFaceData } from '../css/parse'
@@ -65,20 +65,28 @@ export default defineFontProvider<ProviderOption>('google', async (_options = {}
       resolvedAxes.push(axis)
     }
 
-    let css = ''
+    let priority = 0
+    const resolvedFontFaceData: FontFaceData[] = []
 
     for (const extension in userAgents) {
-      css += await $fetch<string>('/css2', {
+      const data = extractFontFaceData(await $fetch<string>('/css2', {
         baseURL: 'https://fonts.googleapis.com',
         headers: { 'user-agent': userAgents[extension as keyof typeof userAgents] },
         query: {
           family: `${family}:${resolvedAxes.join(',')}@${resolvedVariants.join(';')}`,
         },
+      }))
+      data.map((f) => {
+        f.meta ??= {}
+        f.meta.priority = priority
+        return f
       })
+      resolvedFontFaceData.push(...data)
+      priority++
     }
 
     // TODO: support subsets
-    return extractFontFaceData(css)
+    return resolvedFontFaceData
   }
 
   return {

src/types.ts

@@ -51,6 +51,11 @@ export interface FontFaceData {
   featureSettings?: string
   /** Allows low-level control over OpenType or TrueType font variations, by specifying the four letter axis names of the features to vary, along with their variation values. */
   variationSettings?: string
+  /** Metadata for the font face used by unifont */
+  meta?: {
+    /** The priority of the font face, usually used to indicate fallbacks. Smaller is more prioritized. */
+    priority?: number
+  }
 }
 
 export interface ResolveFontResult {

test/providers/google.test.ts

@@ -55,14 +55,18 @@ describe('google', () => {
 
     const resolvedStyles = pickUniqueBy(fonts, fnt => fnt.style)
     const resolvedWeights = pickUniqueBy(fonts, fnt => String(fnt.weight))
+    const resolvedPriorities = pickUniqueBy(fonts, fnt => fnt.meta?.priority)
 
     const styles = ['oblique 0deg 15deg', 'normal'] as ResolveFontOptions['styles']
 
     // Variable wght and separate weights from 300 to 1000
     const weights = ['300,1000', ...([...Array.from({ length: 7 }).keys()].map(i => String(i * 100 + 300)))]
 
+    const priorities = [0, 1]
+
     expect(fonts).toHaveLength(11)
     expect(resolvedStyles).toMatchObject(styles)
     expect(resolvedWeights).toMatchObject(weights)
+    expect(resolvedPriorities).toMatchObject(priorities)
   })
 })