/* ==========================================================================
   PayPress — docs.css
   Documentation system: header/search, sidebar layout, category index,
   article template, breadcrumb, prev/next, related articles.
   Loaded only on documentation pages, after main.css + components.css.
   ========================================================================== */

/* ---------- DOCS HEADER + SEARCH ---------- */
.docs-head { border-bottom: 1px solid var(--color-line); padding: 48px 0 40px; position: relative; overflow: hidden; }
.docs-head::before {
  content: ""; position: absolute; top: -260px; right: -120px; width: 640px; height: 560px;
  background: radial-gradient(circle, rgba(99,102,241,.10), transparent 64%);
}
.docs-head__inner { position: relative; max-width: 680px; }
.docs-head__title { margin: 14px 0 22px; }
.docs-search {
  display: flex; align-items: center; gap: 12px; background: var(--color-paper); border: 1px solid var(--color-line);
  border-radius: var(--radius); padding: 14px 18px; box-shadow: var(--shadow-sm); max-width: 520px;
}
.docs-search svg { width: 20px; height: 20px; color: var(--color-muted-2); flex-shrink: 0; }
.docs-search input { border: 0; outline: 0; font-family: var(--font-sans); font-size: 16px; color: var(--color-ink); width: 100%; background: none; }
.docs-search kbd { font-family: var(--font-mono); font-size: 12px; color: var(--color-muted-2); border: 1px solid var(--color-line); border-radius: 6px; padding: 3px 7px; background: var(--color-canvas); }

/* ---------- DOCS LAYOUT (sidebar + main) ---------- */
.docs-layout { display: grid; grid-template-columns: 248px 1fr; gap: 48px; align-items: start; padding: 48px 0 0; }
.docs-side { position: sticky; top: 90px; }
.docs-side h4 { font-family: var(--font-mono); font-size: 12px; letter-spacing: .07em; text-transform: uppercase; color: var(--color-muted-2); margin: 0 0 12px; }
.docs-side nav { display: flex; flex-direction: column; gap: 2px; margin-bottom: 26px; }
.docs-side nav a { font-size: 14.5px; color: var(--color-muted); padding: 7px 12px; border-radius: 8px; transition: .12s; }
.docs-side nav a:hover { color: var(--color-ink); background: var(--color-canvas); }
.docs-side nav a.is-active, .docs-side nav a[aria-current="page"] { color: var(--color-primary-dark); background: var(--color-primary-tint); font-weight: 600; }

.docs-main { padding-bottom: 80px; min-width: 0; }
.docs-toggle { display: none; margin-bottom: 16px; }

/* ---------- DOCS HOMEPAGE: category groups ---------- */
.doc-group { margin-bottom: 44px; scroll-margin-top: 90px; }
.doc-group__head { display: flex; align-items: center; gap: 12px; margin-bottom: 18px; }
.doc-group__icon { width: 38px; height: 38px; border-radius: 10px; background: var(--color-primary-tint); color: var(--color-primary); display: grid; place-items: center; flex-shrink: 0; }
.doc-group__icon svg { width: 20px; height: 20px; }
.doc-group__head h2 { font-size: 21px; font-weight: 800; letter-spacing: -0.02em; }
.doc-group__head p { font-size: 14px; color: var(--color-muted); margin-top: 2px; }
.doc-items { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
.doc-item {
  display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 16px 18px;
  background: var(--color-paper); border: 1px solid var(--color-line); border-radius: var(--radius);
  box-shadow: var(--shadow-sm); transition: .15s;
}
.doc-item:hover { border-color: var(--color-primary-200); transform: translateY(-1px); box-shadow: var(--shadow); }
.doc-item span { font-size: 15px; font-weight: 600; color: var(--color-ink); }
.doc-item svg { width: 17px; height: 17px; color: var(--color-muted-2); flex-shrink: 0; }
.docs-empty { display: none; color: var(--color-muted); font-size: 16px; padding: 24px 0; }
.docs-empty.is-visible { display: block; }
.docs-not-ready { color: var(--color-muted); padding: 48px 0 0; }

/* ---------- BREADCRUMB ---------- */
.breadcrumb { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; font-size: 13.5px; color: var(--color-muted-2); margin-bottom: 18px; font-family: var(--font-mono); }
.breadcrumb a { color: var(--color-muted); }
.breadcrumb a:hover { color: var(--color-primary); }
.breadcrumb__sep { color: var(--color-line); }
.breadcrumb [aria-current="page"] { color: var(--color-ink-soft); }

/* ---------- CATEGORY PAGE ---------- */
.cat-head { margin-bottom: 32px; }
.cat-head .eyebrow { margin-bottom: 14px; }
.cat-head h1 { font-size: clamp(28px, 3vw, 38px); margin-bottom: 12px; }
.cat-head p { font-size: 17px; color: var(--color-muted); line-height: 1.6; max-width: 640px; }
.article-list { display: flex; flex-direction: column; gap: 12px; }
.article-link {
  display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; padding: 20px 22px;
  background: var(--color-paper); border: 1px solid var(--color-line); border-radius: var(--radius);
  box-shadow: var(--shadow-sm); transition: .15s;
}
.article-link:hover { border-color: var(--color-primary-200); transform: translateY(-1px); box-shadow: var(--shadow); }
.article-link__title { font-size: 16.5px; font-weight: 700; color: var(--color-ink); letter-spacing: -0.01em; }
.article-link__desc { font-size: 14px; color: var(--color-muted); margin-top: 4px; line-height: 1.5; }
.article-link__arrow { width: 18px; height: 18px; color: var(--color-muted-2); flex-shrink: 0; margin-top: 3px; }

/* ---------- ARTICLE TEMPLATE ---------- */
.article { max-width: 760px; }
.article__meta { display: flex; align-items: center; gap: 14px; font-family: var(--font-mono); font-size: 12.5px; color: var(--color-muted-2); margin-bottom: 16px; }
.article__meta .badge { font-size: 11px; }
.article h1 { font-size: clamp(30px, 3.4vw, 40px); margin-bottom: 16px; }
.article__intro { font-size: 19px; line-height: 1.6; color: var(--color-muted); margin-bottom: 32px; }
.article__body > * + * { margin-top: 18px; }
.article__body h2 { font-size: 24px; margin-top: 40px; letter-spacing: -0.02em; }
.article__body h3 { font-size: 19px; margin-top: 28px; letter-spacing: -0.01em; }
.article__body p { font-size: 16.5px; line-height: 1.7; color: var(--color-ink-soft); }
.article__body a { color: var(--color-primary); font-weight: 600; }
.article__body a:hover { text-decoration: underline; }
.article__body ul, .article__body ol { padding-left: 22px; color: var(--color-ink-soft); font-size: 16.5px; line-height: 1.7; }
.article__body li + li { margin-top: 8px; }
.article__body img { border-radius: var(--radius); border: 1px solid var(--color-line); box-shadow: var(--shadow); margin: 24px 0; }

.callout { display: flex; gap: 14px; padding: 18px 20px; border-radius: var(--radius); background: var(--color-primary-tint); border: 1px solid var(--color-primary-200); }
.callout__icon { width: 22px; height: 22px; flex-shrink: 0; color: var(--color-primary); margin-top: 1px; }
.callout p { font-size: 15px; line-height: 1.6; color: var(--color-ink-soft); margin: 0; }
.callout strong { color: var(--color-primary-dark); }

.code-block {
  background: var(--color-ink); color: #E7E9F1; border-radius: var(--radius); padding: 18px 20px; overflow-x: auto;
  font-family: var(--font-mono); font-size: 13.5px; line-height: 1.6; margin: 8px 0;
}
.code-block .tok-fn { color: var(--color-primary-200); }
.code-block .tok-str { color: #34D399; }

/* feedback row */
.article__feedback { margin-top: 40px; padding: 20px 24px; background: var(--color-canvas); border: 1px solid var(--color-line); border-radius: var(--radius); display: flex; align-items: center; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
.article__feedback span { font-size: 15px; font-weight: 600; color: var(--color-ink); }
.article__feedback .btn-group { display: flex; gap: 10px; }

/* ---------- PREV / NEXT ---------- */
.prevnext { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-top: 40px; }
.prevnext a {
  display: block; padding: 20px 22px; border: 1px solid var(--color-line); border-radius: var(--radius);
  background: var(--color-paper); box-shadow: var(--shadow-sm); transition: .15s;
}
.prevnext a:hover { border-color: var(--color-primary-200); box-shadow: var(--shadow); }
.prevnext__label { font-family: var(--font-mono); font-size: 12px; letter-spacing: .05em; text-transform: uppercase; color: var(--color-muted-2); margin-bottom: 6px; }
.prevnext__title { font-size: 16px; font-weight: 700; color: var(--color-ink); letter-spacing: -0.01em; }
.prevnext a.prevnext--next { text-align: right; }

/* ---------- RELATED ARTICLES ---------- */
.related { margin-top: 48px; }
.related h3 { font-size: 18px; margin-bottom: 16px; letter-spacing: -0.01em; }
.related__grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; }
.related__card { padding: 18px 20px; border: 1px solid var(--color-line); border-radius: var(--radius); background: var(--color-paper); box-shadow: var(--shadow-sm); transition: .15s; }
.related__card:hover { border-color: var(--color-primary-200); transform: translateY(-1px); box-shadow: var(--shadow); }
.related__cat { font-family: var(--font-mono); font-size: 11px; text-transform: uppercase; letter-spacing: .05em; color: var(--color-primary); margin-bottom: 6px; }
.related__title { font-size: 15px; font-weight: 700; color: var(--color-ink); line-height: 1.35; }

/* ---------- RESPONSIVE ---------- */
@media (max-width: 880px) {
  .docs-layout { grid-template-columns: 1fr; gap: 0; }
  .docs-side { position: static; display: none; margin-bottom: 24px; }
  .docs-layout.is-nav-open .docs-side { display: block; }
  .doc-items { grid-template-columns: 1fr; }
  .docs-toggle { display: inline-flex; }
  .prevnext { grid-template-columns: 1fr; }
  .related__grid { grid-template-columns: 1fr; }
}