/* ========================================================================
   # 基础设计系统 | Modern CSS Foundation v1.2
   # 功能：重置样式 + 响应式布局 + 暗色模式 + 实用工具类
   # 兼容：Chrome 100+ / Firefox 90+ / Safari 15.4+ (支持CSS变量)
   # 用法：直接引入HTML，无需额外配置
   # 配套JS：与之前提供的 dark-mode-toggle.js 完美协同
   ======================================================================== */

/* ========================================================================
   ## 1. CSS 变量定义 (Design Tokens)
   ## 集中管理设计系统，支持动态主题切换
   ======================================================================== */
:root {
  /* 颜色系统 */
  --color-primary: 28, 100, 81;      /* 主色 (HSL: 青绿色) */
  --color-secondary: 210, 20%, 96%;   /* 次色 (浅灰蓝) */
  --color-success: 140, 71%, 45%;     /* 成功 (绿色) */
  --color-danger: 0, 71%, 55%;        /* 错误 (红色) */
  
  /* 暗色模式覆盖值 */
  &[data-theme="dark"] {
    --color-secondary: 210, 15%, 20%;  /* 深灰蓝 */
  }

  /* 通用样式 */
  --bg: 255, 255, 255;                 /* 背景色 (HSL三元组) */
  --text: 30, 8%, 20%;                 /* 文字色 */
  --border: 220, 10%, 92%;             /* 边框色 */
  --shadow: 0, 0, 0, 0.08;             /* 阴影 (rgba 通道) */
  
  /* 暗色模式覆盖 */
  &[data-theme="dark"] {
    --bg: 18, 18, 18;
    --text: 220, 15%, 95%;
    --border: 220, 10%, 20%;
    --shadow: 0, 0, 0, 0.3;
  }

  /* 布局系统 */
  --container-max: 1280px;             /* 最大容器宽度 */
  --spacing-unit: 1rem;                /* 基础间距单位 (4px倍数) */
  --radius-sm: 4px;                    /* 小圆角 */
  --radius-md: 8px;                    /* 中圆角 */
  --radius-lg: 16px;                   /* 大圆角 */

  /* 字体系统 */
  --font-sans: -apple-system, BlinkMacSystemFont, 
               'Segoe UI', Roboto, sans-serif;
  --font-mono: SFMono-Regular, Menlo, monospace;
  --font-size-base: 100%;               /* 基础字号 (16px) */
  --line-height: 1.5;                  /* 行高 */
}

/* ========================================================================
   ## 2. 基础重置 (Modern Reset)
   ## 比normalize更轻量，保留有用默认值
   ======================================================================== */
*,
*::before,
*::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth; /* 平滑滚动 */
  font-size: var(--font-size-base);
  color: hsl(var(--text));
  background: hsl(var(--bg));
}

body {
  font-family: var(--font-sans);
  line-height: var(--line-height);
  text-rendering: optimizeLegibility;
  -webkit-font-smoothing: antialiased;
}

img, picture, video {
  max-width: 100%;
  display: block;
}

a {
  color: hsl(var(--color-primary));
  text-decoration: none;
  transition: opacity 0.2s;
}
a:hover {
  opacity: 0.8;
}

/* ========================================================================
   ## 3. 布局系统 (Responsive Grid)
   ## 移动优先 + 容器约束
   ======================================================================== */
.container {
  width: 100%;
  max-width: var(--container-max);
  margin: 0 auto;
  padding: 0 calc(var(--spacing-unit) * 1.5);
}

/* 简易网格 (12列) */
.grid {
  display: grid;
  gap: calc(var(--spacing-unit) * 2);
  grid-template-columns: repeat(12, 1fr);
}

/* 列间距工具类 */
.gap-sm { gap: var(--spacing-unit); }
.gap-md { gap: calc(var(--spacing-unit) * 2); }
.gap-lg { gap: calc(var(--spacing-unit) * 3); }

/* 响应式列定义 */
[class^="col-"] {
  grid-column: span 12; /* 默认占满 */
}

@media (min-width: 768px) {
  .col-md-6 { grid-column: span 6; }
  .col-md-4 { grid-column: span 4; }
  .col-md-8 { grid-column: span 8; }
}

@media (min-width: 1024px) {
  .col-lg-3 { grid-column: span 3; }
  .col-lg-9 { grid-column: span 9; }
}

/* ========================================================================
   ## 4. 组件样式 (Reusable Components)
   ## 按钮/卡片/表单等基础组件
   ======================================================================== */

/* 按钮系统 */
.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.75rem 1.5rem;
  border-radius: var(--radius-md);
  font-weight: 500;
  cursor: pointer;
  border: none;
  transition: all 0.2s;
  background: hsl(var(--color-primary));
  color: white;
}
.btn:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 12px hsla(var(--color-primary), 0.25);
}
.btn:active {
  transform: translateY(0);
}

/* 按钮变体 */
.btn-secondary {
  background: hsl(var(--color-secondary));
  color: hsl(0, 0%, 20%);
}
.btn-danger {
  background: hsl(var(--color-danger));
}

/* 卡片组件 */
.card {
  background: hsl(var(--bg));
  border-radius: var(--radius-lg);
  overflow: hidden;
  box-shadow: 0 4px 16px hsla(var(--shadow));
  transition: transform 0.3s;
}
.card:hover {
  transform: translateY(-5px);
}

.card-header {
  padding: calc(var(--spacing-unit) * 1.5);
  border-bottom: 1px solid hsl(var(--border));
}
.card-body {
  padding: calc(var(--spacing-unit) * 1.5);
}
.card-footer {
  padding: calc(var(--spacing-unit) * 1.5);
  border-top: 1px solid hsl(var(--border));
  background: hsl(var(--color-secondary), 5%);
}

/* 表单控件 */
.input, .textarea {
  width: 100%;
  padding: 0.75rem;
  border: 1px solid hsl(var(--border));
  border-radius: var(--radius-sm);
  background: hsl(var(--bg));
  color: hsl(var(--text));
  font-family: var(--font-sans);
}
.textarea {
  min-height: 100px;
  resize: vertical;
}
.input:focus, .textarea:focus {
  outline: none;
  border-color: hsl(var(--color-primary), 70%);
  box-shadow: 0 0 0 3px hsla(var(--color-primary), 0.15);
}

/* ========================================================================
   ## 5. 实用工具类 (Utility Classes)
   ## 原子化设计，提升开发效率
   ======================================================================== */

/* 间距系统 */
.mt-sm { margin-top: var(--spacing-unit); }
.mt-md { margin-top: calc(var(--spacing-unit) * 2); }
.mt-lg { margin-top: calc(var(--spacing-unit) * 3); }
.mb-sm { margin-bottom: var(--spacing-unit); }

.p-sm { padding: var(--spacing-unit); }
.p-md { padding: calc(var(--spacing-unit) * 2); }

/* 文本对齐 */
.text-center { text-align: center; }
.text-right { text-align: right; }

/* Flex 布局 */
.d-flex { display: flex; }
.items-center { align-items: center; }
.justify-between { justify-content: space-between; }
.flex-wrap { flex-wrap: wrap; }

/* 可见性 */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  border: 0;
}