/* ==========================================================================
   fonts.css · 字体加载（自托管优先，零外链）
   --------------------------------------------------------------------------
   【默认状态：本文件不做任何事】

   平台默认使用「操作系统自带中文字体」，因此在绝大多数环境下
   （Windows / macOS / 国产 Linux）打开页面都能正常渲染，无需下载字体。

   为什么不用 Google Fonts / fonts.loli.net 之类的 CDN：
     · 内网部署、离线演示、政务专网环境下外链会静默失败，字体直接掉
     · 外链会在浏览器控制台产生 CORS / 证书告警，验收时不好看
     · 引入第三方域名会让安全审查多一道流程

   --------------------------------------------------------------------------
   【如何启用自托管字体】

   第 1 步：准备字体文件，放入 assets/fonts/
        assets/fonts/NotoSerifSC-Bold.woff2
        assets/fonts/NotoSansSC-Regular.woff2
        assets/fonts/NotoSansSC-Medium.woff2
        assets/fonts/NotoSansSC-Bold.woff2

     建议子集化后再放入（中文全字库单文件 5~10MB，网页用不了）：
        pip install fonttools brotli
        pyftsubset 源字体.ttf --text-file=常用字.txt \
            --flavor=woff2 --output-file=NotoSansSC-Regular.woff2
     或者只保留 GB2312 一级字库（约 3755 字，压完 400KB 左右）。

   第 2 步：取消下面 @font-face 的注释
   第 3 步：确认 tokens.css 里 --ff-display / --ff-ui 的首选族名
           与下面 font-family 的第一个名字一致
           （即 "Noto Serif SC Local" / "Noto Sans SC Local"）

   注：family 名带 " Local" 后缀是刻意的 —— 这样不会和用户系统里
       已安装的 Noto Serif SC 冲突，便于排查到底加载的是哪个文件。
   ========================================================================== */

/* --------------------------------------------------------------------------
   @font-face 模板（取消注释并放置字体文件后即可生效）

@font-face {
  font-family: "Noto Serif SC Local";
  src: url("../fonts/NotoSerifSC-Bold.woff2") format("woff2");
  font-weight: 600 900;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "Noto Sans SC Local";
  src: url("../fonts/NotoSansSC-Regular.woff2") format("woff2");
  font-weight: 300 400;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "Noto Sans SC Local";
  src: url("../fonts/NotoSansSC-Medium.woff2") format("woff2");
  font-weight: 500;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "Noto Sans SC Local";
  src: url("../fonts/NotoSansSC-Bold.woff2") format("woff2");
  font-weight: 600 700;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "JetBrains Mono Local";
  src: url("../fonts/JetBrainsMono-Medium.woff2") format("woff2");
  font-weight: 500 700;
  font-style: normal;
  font-display: swap;
}

-------------------------------------------------------------------------- */