/**
 * UPLINQ — Custom Fonts
 * =====================================================================
 *
 * HOW TO ADD YOUR CUSTOM FONTS
 * ─────────────────────────────────────────────────────────────────────
 *
 * STEP 1 — Prepare your font files
 *   Place your font files in one of these subfolders:
 *
 *   assets/fonts/custom/
 *     └── Your self-hosted fonts (all formats)
 *
 *   assets/fonts/web-fonts/
 *     └── Google Fonts or other CDN downloads
 *
 *   Recommended formats (in order of priority):
 *   ✅ .woff2  — Best compression, all modern browsers
 *   ✅ .woff   — Fallback for older browsers
 *   ⚠️  .ttf   — Only if woff/woff2 not available
 *   ✅ .svg    — Only for very old iOS (rarely needed)
 *
 * STEP 2 — Convert your fonts (if needed)
 *   Use one of these free tools to convert TTF/OTF → WOFF2:
 *   • https://www.fontsquirrel.com/tools/webfont-generator
 *   • https://cloudconvert.com/ttf-to-woff2
 *   • npm: `npx ttf2woff2 MyFont.ttf > MyFont.woff2`
 *
 * STEP 3 — Declare @font-face rules below
 *   Follow the template provided in the EXAMPLES section.
 *   One @font-face block per weight/style combination.
 *
 * STEP 4 — Map fonts to CSS variables in style.css
 *   Update the --uplinq-font-* variables at the top of style.css:
 *
 *   :root {
 *     --uplinq-font-display:  'MyDisplayFont', Georgia, serif;
 *     --uplinq-font-heading:  'MyHeadingFont', Helvetica Neue, sans-serif;
 *     --uplinq-font-body:     'MyBodyFont', system-ui, sans-serif;
 *     --uplinq-font-mono:     'MyMonoFont', Consolas, monospace;
 *   }
 *
 * STEP 5 — Preload critical fonts (performance)
 *   In inc/enqueue.php, add your most important font files to the
 *   uplinq_preload_fonts filter:
 *
 *   add_filter( 'uplinq_preload_fonts', function( $fonts ) {
 *     return array(
 *       array( 'file' => 'MyFont-Regular.woff2', 'type' => 'font/woff2' ),
 *       array( 'file' => 'MyFont-Bold.woff2',    'type' => 'font/woff2' ),
 *     );
 *   } );
 *
 * ─────────────────────────────────────────────────────────────────────
 * FONT WEIGHT REFERENCE
 * ─────────────────────────────────────────────────────────────────────
 *  100 = Thin / Hairline
 *  200 = ExtraLight / UltraLight
 *  300 = Light
 *  400 = Regular / Normal  ← most common body weight
 *  500 = Medium
 *  600 = SemiBold / DemiBold
 *  700 = Bold               ← most common heading weight
 *  800 = ExtraBold / UltraBold
 *  900 = Black / Heavy
 *
 * FONT STYLE REFERENCE
 *  normal  = upright
 *  italic  = true italic (separate file)
 *  oblique = slanted version of normal (use when no italic file exists)
 *
 * ─────────────────────────────────────────────────────────────────────
 * FONT DISPLAY STRATEGY
 * ─────────────────────────────────────────────────────────────────────
 *  swap     — Show fallback immediately, swap when font loads
 *             ✅ Best for body/heading text — avoids invisible text
 *  optional — Use font only if already cached
 *             ✅ Best for decorative/display fonts
 *  block    — Invisible text for up to 3s (avoid unless necessary)
 *  fallback — Short block, then swap (compromise)
 *
 * ─────────────────────────────────────────────────────────────────────
 * UNICODE-RANGE EXAMPLES (optional but improves performance)
 * ─────────────────────────────────────────────────────────────────────
 *  Latin Basic:        U+0000-00FF
 *  Latin Extended:     U+0100-024F
 *  Cyrillic:           U+0400-04FF
 *  Greek:              U+0370-03FF
 *  Vietnamese:         U+0102-0103, U+0110-0111, U+1EA0-1EF9, U+20AB
 *
 * =====================================================================
 */


/* =====================================================================
   EXAMPLES — Copy and customize these blocks for your fonts
   ===================================================================== */

/*
 * ── EXAMPLE 1: Regular weight, upright ───────────────────────────────
 *
@font-face {
  font-family: 'MyFont';
  src: url('../fonts/custom/MyFont-Regular.woff2') format('woff2'),
       url('../fonts/custom/MyFont-Regular.woff')  format('woff');
  font-weight:  400;
  font-style:   normal;
  font-display: swap;
  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6,
                 U+02DA, U+02DC, U+2000-206F, U+2074, U+20AC, U+2122,
                 U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
 */

/*
 * ── EXAMPLE 2: Bold weight, upright ──────────────────────────────────
 *
@font-face {
  font-family: 'MyFont';
  src: url('../fonts/custom/MyFont-Bold.woff2') format('woff2'),
       url('../fonts/custom/MyFont-Bold.woff')  format('woff');
  font-weight:  700;
  font-style:   normal;
  font-display: swap;
}
 */

/*
 * ── EXAMPLE 3: Italic ────────────────────────────────────────────────
 *
@font-face {
  font-family: 'MyFont';
  src: url('../fonts/custom/MyFont-Italic.woff2') format('woff2'),
       url('../fonts/custom/MyFont-Italic.woff')  format('woff');
  font-weight:  400;
  font-style:   italic;
  font-display: swap;
}
 */

/*
 * ── EXAMPLE 4: Variable font (single file, full weight range) ────────
 *
@font-face {
  font-family: 'MyFont';
  src: url('../fonts/custom/MyFont-Variable.woff2') format('woff2 supports variations'),
       url('../fonts/custom/MyFont-Variable.woff2') format('woff2');
  font-weight:  100 900;
  font-style:   normal;
  font-display: swap;
}
 */

/*
 * ── EXAMPLE 5: Display font (decorative, load optional) ──────────────
 *
@font-face {
  font-family: 'MyDisplayFont';
  src: url('../fonts/custom/MyDisplayFont-ExtraBold.woff2') format('woff2');
  font-weight:  800;
  font-style:   normal;
  font-display: optional;
}
 */

/*
 * ── EXAMPLE 6: Monospace / Code font ─────────────────────────────────
 *
@font-face {
  font-family: 'MyMonoFont';
  src: url('../fonts/custom/MyMonoFont-Regular.woff2') format('woff2'),
       url('../fonts/custom/MyMonoFont-Regular.woff')  format('woff');
  font-weight:  400;
  font-style:   normal;
  font-display: swap;
}
 */


/* =====================================================================
   YOUR FONT DECLARATIONS GO HERE
   Add your @font-face rules below this comment.
   ===================================================================== */