/* ============================================================
   Docs site styling — Sprint D
   ============================================================
   /docs                           → 首页（hero + popular grid + category grid）
   /docs/{category}                → 类目页（cat hero + article list）
   /docs/{category}/{slug}         → 文章详情页（article hero + markdown body + nav + related）

   注意：通用 .docs-categories / .docs-cat 已在 site.css 925-969 行定义，
   这里只补 Sprint D 新增的样式。
   ============================================================ */

/* ===== 公共：section 标题块 ===== */
.docs-section-head {
    text-align: center;
    margin-bottom: var(--space-6);
}
.docs-section-head h2 {
    font-size: 1.6rem;
    color: var(--text);
    margin-bottom: var(--space-2);
}
.docs-section-head p {
    font-size: 1rem;
    max-width: 640px;
    margin: 0 auto;
}

/* ===== 类目卡补充：文章数 + 箭头 ===== */
.docs-cat-count {
    margin-top: auto;
    padding-top: var(--space-3);
    font-size: .82rem;
    font-weight: 600;
    letter-spacing: .02em;
}
.docs-cat {
    display: flex;
    flex-direction: column;
}
.docs-cat:hover .docs-cat-count i { transform: translateX(4px); }
.docs-cat-count i { transition: transform .15s var(--ease); }

/* ============================================================
   /docs 首页 — 热门文章网格
   ============================================================ */
.docs-popular-grid {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: var(--space-4);
}
@media (max-width: 1024px) { .docs-popular-grid { grid-template-columns: repeat(2, 1fr); } }
@media (max-width: 600px)  { .docs-popular-grid { grid-template-columns: 1fr; } }

.docs-popular {
    position: relative;
    display: flex;
    flex-direction: column;
    gap: 8px;
    padding: var(--space-5);
    background: var(--bg-elev-1);
    border: 1px solid var(--border-glass);
    border-radius: var(--radius-lg);
    text-decoration: none;
    transition: transform .15s var(--ease), border-color .15s var(--ease), box-shadow .15s var(--ease);
}
.docs-popular:hover {
    transform: translateY(-3px);
    border-color: var(--accent);
    box-shadow: 0 6px 24px rgba(255,107,107,.15);
}
.docs-popular-cat {
    font-size: .72rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: .08em;
    color: var(--accent);
    margin-bottom: 4px;
}
.docs-popular h3 {
    font-size: 1.05rem;
    color: var(--text);
    margin: 0;
    line-height: 1.4;
}
.docs-popular p {
    color: var(--text-muted);
    font-size: .88rem;
    line-height: 1.55;
    margin: 0;
    flex: 1;
}
.docs-popular-meta {
    margin-top: var(--space-2);
    color: var(--text-faint);
    font-size: .78rem;
    display: inline-flex;
    align-items: center;
    gap: 6px;
}

/* "Popular" 角标 ===== */
.docs-popular-badge {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    background: rgba(251,191,36,.14);
    color: #fbbf24;
    border: 1px solid rgba(251,191,36,.32);
    border-radius: 999px;
    padding: 1px 8px;
    font-size: .68rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: .06em;
}

/* ============================================================
   /docs/{category} 类目页 — Hero + 文章列表
   ============================================================ */
.docs-cat-hero {
    padding-bottom: var(--space-5);
}
.docs-cat-hero-head {
    display: flex;
    align-items: center;
    gap: var(--space-4);
    flex-wrap: wrap;
    margin-top: var(--space-3);
}
.docs-cat-hero-icon {
    font-size: 2.6rem;
    color: var(--accent);
    flex-shrink: 0;
}

/* 面包屑 */
.docs-breadcrumb {
    display: flex;
    align-items: center;
    gap: 8px;
    font-size: .85rem;
    margin-bottom: var(--space-4);
    flex-wrap: wrap;
}
.docs-breadcrumb a {
    color: var(--text-muted);
    text-decoration: none;
    transition: color .12s var(--ease);
}
.docs-breadcrumb a:hover { color: var(--text); }
.docs-breadcrumb i {
    color: var(--text-faint);
    font-size: .68rem;
}
.docs-breadcrumb span {
    color: var(--text);
    font-weight: 500;
}

/* 文章列表项（类目页用）===== */
.docs-article-list {
    display: flex;
    flex-direction: column;
    gap: 4px;
}
.docs-article-item {
    display: flex;
    align-items: center;
    gap: var(--space-4);
    padding: var(--space-4);
    background: var(--bg-elev-1);
    border: 1px solid var(--border-glass);
    border-radius: var(--radius-md);
    text-decoration: none;
    transition: all .15s var(--ease);
}
.docs-article-item:hover {
    background: var(--bg-elev-2);
    border-color: var(--accent);
    transform: translateX(4px);
}
.docs-article-content { flex: 1; min-width: 0; }
.docs-article-content h3 {
    font-size: 1.05rem;
    color: var(--text);
    margin: 0 0 6px 0;
    display: flex;
    align-items: center;
    gap: 8px;
    flex-wrap: wrap;
}
.docs-article-content p {
    color: var(--text-muted);
    font-size: .88rem;
    line-height: 1.55;
    margin: 0 0 8px 0;
}
.docs-article-meta {
    color: var(--text-faint);
    font-size: .78rem;
    display: flex;
    align-items: center;
    gap: 6px;
}
.docs-article-meta-sep {
    color: var(--text-faint);
}
.docs-article-chevron {
    color: var(--text-faint);
    transition: transform .15s var(--ease), color .15s var(--ease);
    flex-shrink: 0;
}
.docs-article-item:hover .docs-article-chevron {
    color: var(--accent);
    transform: translateX(4px);
}

/* 空状态 ===== */
.docs-empty {
    text-align: center;
    padding: var(--space-8) var(--space-4);
    background: var(--bg-elev-1);
    border: 1px dashed var(--border-glass-strong);
    border-radius: var(--radius-lg);
}
.docs-empty i {
    font-size: 2.4rem;
    color: var(--text-faint);
    margin-bottom: var(--space-3);
}
.docs-empty h3 {
    color: var(--text);
    margin-bottom: var(--space-2);
}
.docs-empty p {
    color: var(--text-muted);
    max-width: 520px;
    margin: 0 auto;
}

/* ============================================================
   /docs/{category}/{slug} 文章详情页
   ============================================================ */
.docs-article-hero {
    padding: var(--space-6) 0 var(--space-4);
    background: linear-gradient(180deg, var(--bg-elev-1) 0%, transparent 100%);
    border-bottom: 1px solid var(--border-glass);
}
.docs-article-title {
    font-size: 2.2rem;
    color: var(--text);
    line-height: 1.2;
    margin-bottom: var(--space-3);
    max-width: 800px;
}
.docs-article-meta-row {
    color: var(--text-muted);
    font-size: .9rem;
    display: flex;
    align-items: center;
    gap: 8px;
    flex-wrap: wrap;
}

/* ===== Markdown 渲染区 ===== */
.docs-article-body {
    max-width: 760px;
    margin: 0 auto;
    color: var(--text);
    font-size: 1rem;
    line-height: 1.8;
}
.docs-article-body h1 {
    font-size: 1.8rem;
    margin: var(--space-7) 0 var(--space-4);
    font-weight: 700;
    color: var(--text);
}
.docs-article-body h2 {
    font-size: 1.4rem;
    margin: var(--space-6) 0 var(--space-3);
    padding-top: var(--space-4);
    border-top: 1px solid var(--border-glass);
    font-weight: 700;
    color: var(--text);
}
.docs-article-body h2:first-child {
    border-top: none;
    padding-top: 0;
    margin-top: 0;
}
.docs-article-body h3 {
    font-size: 1.15rem;
    margin: var(--space-5) 0 var(--space-3);
    font-weight: 700;
    color: var(--text);
}
.docs-article-body p {
    margin: var(--space-3) 0;
    color: var(--text-muted);
}
.docs-article-body ul, .docs-article-body ol {
    padding-left: var(--space-5);
    margin: var(--space-3) 0;
    color: var(--text-muted);
}
.docs-article-body li { margin: 6px 0; }
.docs-article-body a {
    color: var(--accent);
    text-decoration: underline;
    text-decoration-thickness: 1px;
    text-underline-offset: 2px;
}
.docs-article-body a:hover {
    color: var(--accent-hover);
}
.docs-article-body code {
    background: var(--bg-elev-2);
    border: 1px solid var(--border-glass);
    border-radius: 4px;
    padding: 2px 6px;
    font-family: var(--font-mono, ui-monospace, "SF Mono", "Cascadia Code", "Roboto Mono", monospace);
    font-size: .88em;
    color: var(--text);
}
.docs-article-body pre {
    background: var(--bg-elev-2);
    border: 1px solid var(--border-glass);
    border-radius: var(--radius-md);
    padding: var(--space-4);
    overflow-x: auto;
    margin: var(--space-4) 0;
}
.docs-article-body pre code {
    background: transparent;
    border: none;
    padding: 0;
    font-size: .88em;
}
.docs-article-body blockquote {
    border-left: 3px solid var(--accent);
    background: rgba(255,107,107,.05);
    padding: var(--space-3) var(--space-4);
    margin: var(--space-4) 0;
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
}
.docs-article-body blockquote p {
    margin: 0;
    color: var(--text-muted);
}
.docs-article-body table {
    border-collapse: collapse;
    margin: var(--space-4) 0;
    width: 100%;
    font-size: .92em;
}
.docs-article-body th, .docs-article-body td {
    border: 1px solid var(--border-glass-strong);
    padding: 10px 14px;
    text-align: left;
}
.docs-article-body th {
    background: var(--bg-elev-2);
    color: var(--text);
    font-weight: 600;
}
.docs-article-body td { color: var(--text-muted); }
.docs-article-body img {
    max-width: 100%;
    border-radius: var(--radius-sm);
    margin: var(--space-3) 0;
    border: 1px solid var(--border-glass);
}
.docs-article-body hr {
    border: none;
    border-top: 1px solid var(--border-glass);
    margin: var(--space-6) 0;
}

/* ===== 上一篇 / 下一篇 ===== */
.docs-article-nav {
    max-width: 760px;
    margin: var(--space-7) auto 0;
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--space-3);
}
@media (max-width: 600px) {
    .docs-article-nav { grid-template-columns: 1fr; }
}
.docs-article-nav-item {
    display: flex;
    flex-direction: column;
    gap: 6px;
    padding: var(--space-4);
    background: var(--bg-elev-1);
    border: 1px solid var(--border-glass);
    border-radius: var(--radius-md);
    text-decoration: none;
    transition: all .15s var(--ease);
}
.docs-article-nav-item:hover {
    background: var(--bg-elev-2);
    border-color: var(--accent);
}
.docs-article-nav-item.is-next {
    text-align: right;
}
.docs-article-nav-label {
    font-size: .78rem;
    color: var(--text-faint);
    text-transform: uppercase;
    letter-spacing: .08em;
    font-weight: 700;
}
.docs-article-nav-title {
    color: var(--text);
    font-weight: 600;
    font-size: .95rem;
    line-height: 1.4;
}

/* ===== Related grid ===== */
.docs-related {
    max-width: 760px;
    margin-left: auto;
    margin-right: auto;
}
.docs-related-head {
    display: flex;
    align-items: center;
    justify-content: space-between;
    flex-wrap: wrap;
    gap: var(--space-2);
    color: var(--text);
    font-size: 1.1rem;
    margin-bottom: var(--space-4);
    padding-bottom: var(--space-3);
    border-bottom: 1px solid var(--border-glass);
}
.docs-related-link {
    color: var(--accent);
    text-decoration: none;
    font-size: .88rem;
    font-weight: 600;
    display: inline-flex;
    align-items: center;
    gap: 4px;
}
.docs-related-link:hover { color: var(--accent-hover); }
.docs-related-grid {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
    gap: var(--space-3);
}
@media (max-width: 600px) {
    .docs-related-grid { grid-template-columns: 1fr; }
}
.docs-related-item {
    padding: var(--space-3) var(--space-4);
    background: var(--bg-elev-1);
    border: 1px solid var(--border-glass);
    border-radius: var(--radius-md);
    text-decoration: none;
    transition: all .15s var(--ease);
}
.docs-related-item:hover {
    background: var(--bg-elev-2);
    border-color: var(--accent);
}
.docs-related-item h4 {
    color: var(--text);
    margin: 0 0 4px 0;
    font-size: .95rem;
    font-weight: 600;
}
.docs-related-item p {
    color: var(--text-muted);
    margin: 0;
    font-size: .82rem;
    line-height: 1.5;
}

/* ===== CTA block ===== */
.docs-cta {
    max-width: 760px;
    margin-left: auto;
    margin-right: auto;
    padding: var(--space-5) var(--space-5);
    background: linear-gradient(135deg, rgba(255,107,107,.08) 0%, rgba(255,107,107,.02) 100%);
    border: 1px solid rgba(255,107,107,.25);
    border-radius: var(--radius-lg);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-4);
    flex-wrap: wrap;
}
.docs-cta-text h3 {
    color: var(--text);
    margin-bottom: 4px;
    font-size: 1.1rem;
}
.docs-cta-text p {
    color: var(--text-muted);
    margin: 0;
    font-size: .9rem;
}
.docs-cta-actions {
    display: flex;
    gap: var(--space-2);
    flex-wrap: wrap;
}