import { createUnifont } from "unifont";
import { Storage } from "unstorage";
import { Plugin } from "vite";

//#region src/types.d.ts
/**
 * Font weight specification - can be a single weight or a range for variable fonts
 */
type FontWeight = number | `${number} ${number}` | "normal" | "bold";
/**
 * Font style specification
 */
type FontStyle = "normal" | "italic" | "oblique";
/**
 * Font subset specification
 */
type FontSubset = "latin" | "latin-ext" | "cyrillic" | "cyrillic-ext" | "greek" | "greek-ext" | "vietnamese" | (string & {});
/**
 * Configuration for a specific font family
 */
interface FontFamilyConfig {
  /** Font weights to include */
  weights?: FontWeight[];
  /** Font styles to include */
  styles?: FontStyle[];
  /** Unicode subsets to include */
  subsets?: FontSubset[];
  /** Specific provider to use for this font */
  provider?: "bunny" | "fontsource" | "local" | "google";
  /** Font display strategy */
  display?: "auto" | "block" | "swap" | "fallback" | "optional";
  /** Fallback fonts for generating metrics */
  fallbacks?: string[];
}
/**
 * Provider-specific configuration
 */
interface ProvidersConfig {
  /** Enable Bunny Fonts provider */
  bunny?: boolean;
  /** Enable Fontsource provider */
  fontsource?: boolean;
  /** Enable Google Fonts provider */
  google?: boolean;
  /** Local fonts configuration */
  local?: boolean | {
    /** Paths to scan for local font files */paths?: string[];
  };
}
/**
 * Default font options applied to all fonts
 */
interface FontDefaults {
  /** Default font weights */
  weights?: FontWeight[];
  /** Default font styles */
  styles?: FontStyle[];
  /** Default unicode subsets */
  subsets?: FontSubset[];
  /** Default font display strategy */
  display?: "auto" | "block" | "swap" | "fallback" | "optional";
}
/**
 * Main plugin options
 */
interface ViteFontsOptions {
  /**
   * Default font options applied when not specified per-font
   * @default { weights: [400, 700], styles: ['normal'], subsets: ['latin'], display: 'swap' }
   */
  defaults?: FontDefaults;
  /**
   * Explicitly declare fonts and their options
   * Key is the font family name, value is config or `true` for defaults
   */
  families?: Record<string, FontFamilyConfig | true>;
  /**
   * Provider configuration
   * @default { bunny: true, fontsource: true, local: true }
   */
  providers?: ProvidersConfig;
  /**
   * Generate font fallback metrics to reduce CLS
   * @default true
   */
  fallbacks?: boolean;
  /**
   * Enable font caching
   * @default true
   */
  cache?: boolean;
  /**
   * Cache directory path
   * @default 'node_modules/.cache/vite-fonts'
   */
  cacheDir?: string;
  /**
   * Assets subfolder for font files in the build output
   * @default 'fonts'
   */
  assetsDir?: string;
  /**
   * Inject fonts as inline <style> tag or external CSS file
   * @default 'inline'
   */
  inject?: "inline" | "external";
  /**
   * Enable debug logging
   * @default false
   */
  debug?: boolean;
}
/**
 * Resolved plugin options with all defaults applied
 */
interface ResolvedOptions {
  defaults: Required<FontDefaults>;
  families: Record<string, FontFamilyConfig>;
  providers: Required<ProvidersConfig>;
  fallbacks: boolean;
  cache: boolean;
  cacheDir: string;
  assetsDir: string;
  inject: "inline" | "external";
  debug: boolean;
}
/**
 * Information about a detected font in CSS
 */
interface DetectedFont {
  /** The font family name as it appears in CSS */
  family: string;
  /** Source file where the font was detected */
  source: string;
  /** Fallback fonts specified after this font */
  fallbacks: string[];
}
/**
 * Resolved font face information
 */
interface ResolvedFontFace {
  /** Font family name */
  family: string;
  /** Font weight */
  weight: number | string;
  /** Font style */
  style: string;
  /** Font display */
  display: string;
  /** Source URLs */
  src: Array<{
    url: string;
    format?: string;
  }>;
  /** Unicode range */
  unicodeRange?: string;
}
//#endregion
//#region src/plugin.d.ts
/**
 * Create the vite-fonts plugin
 */
declare function viteFonts(userOptions?: ViteFontsOptions): Plugin;
//#endregion
//#region src/css-parser.d.ts
/**
 * Extract font-family declarations from CSS using LightningCSS
 */
declare function extractFontsFromCSS(css: string, filename: string): DetectedFont[];
/**
 * Check if a file should be processed for font extraction
 */
declare function shouldProcessFile(id: string): boolean;
//#endregion
//#region src/font-resolver.d.ts
/**
 * Unifont instance type - use any to avoid complex generic issues
 */
type Unifont = Awaited<ReturnType<typeof createUnifont<any>>>;
/**
 * Initialize unifont with configured providers
 */
declare function initializeUnifont(options: ResolvedOptions, storage?: Storage): Promise<Unifont>;
/**
 * Resolve a single font family using unifont
 */
declare function resolveFont(detected: DetectedFont, config: FontFamilyConfig, defaults: ResolvedOptions["defaults"]): Promise<ResolvedFontFace[]>;
/**
 * Resolve multiple fonts
 */
declare function resolveFonts(detected: DetectedFont[], options: ResolvedOptions): Promise<ResolvedFontFace[]>;
/**
 * Generate @font-face CSS from resolved faces
 */
declare function generateFontFaceCSS(faces: ResolvedFontFace[]): string;
//#endregion
//#region src/fallback.d.ts
/**
 * Generate fallback @font-face CSS that adjusts system fonts to match web font metrics
 */
declare function generateFallbackCSS(detectedFonts: DetectedFont[], resolvedFaces: ResolvedFontFace[]): Promise<string>;
//#endregion
//#region src/cache.d.ts
/**
 * Initialize the cache storage
 */
declare function initializeCache(options: ResolvedOptions): Storage;
/**
 * Download a font file with caching
 */
declare function downloadFont(url: string): Promise<Buffer>;
/**
 * Download multiple fonts in parallel
 */
declare function downloadFonts(urls: string[]): Promise<Map<string, Buffer>>;
//#endregion
export { type DetectedFont, type FontDefaults, type FontFamilyConfig, type FontStyle, type FontSubset, type FontWeight, type ProvidersConfig, type ResolvedFontFace, type ViteFontsOptions, viteFonts as default, viteFonts, downloadFont, downloadFonts, extractFontsFromCSS, generateFallbackCSS, generateFontFaceCSS, initializeCache, initializeUnifont, resolveFont, resolveFonts, shouldProcessFile };
//# sourceMappingURL=index.d.mts.map