/* Docs home, docs articles and FAQ (B4). Layout specifics only — tokens from app.css. */

/* ---------------------------------------------------------------- docs home hero + search */
.docs-hero__grid { display: grid; gap: var(--s-8); align-items: center; }
@media (min-width: 1024px) {
  .docs-hero__grid { grid-template-columns: minmax(0, 1.15fr) minmax(0, 1fr); gap: var(--s-12); }
}
.docs-hero .page-hero__meta .badge { font-size: var(--fs-xs); }
.docs-search { position: relative; display: flex; flex-direction: column; gap: var(--s-2); min-width: 0; }
.docs-search__label { font-weight: 600; font-size: var(--fs-sm); }
.docs-search .input--lg { width: 100%; }
.docs-search__results {
  margin-top: var(--s-2);
  border-top: 1px solid var(--border);
  padding-top: var(--s-3);
  max-height: 420px;
  overflow-y: auto;
}
.docs-search__results--compact { max-height: 60vh; font-size: var(--fs-sm); }
.docs-search__count { font-size: var(--fs-xs); color: var(--text-muted); margin-bottom: var(--s-2); }
.docs-search__list { display: flex; flex-direction: column; gap: 2px; }
.docs-search__item {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--s-2) var(--s-3);
  border-radius: var(--radius);
  color: var(--text);
  min-width: 0;
}
.docs-search__item:hover, .docs-search__item:focus-visible { background: var(--brand-soft); text-decoration: none; outline: none; }
.docs-search__item:focus-visible { box-shadow: var(--focus-ring); }
.docs-search__title { font-weight: 600; overflow-wrap: anywhere; }
.docs-search__meta { font-size: var(--fs-xs); color: var(--text-muted); }
.docs-search__heading { font-size: var(--fs-xs); color: var(--brand-text); overflow-wrap: anywhere; }

/* ---------------------------------------------------------------- docs home sections */
.docs-sections { display: grid; gap: var(--s-4); grid-template-columns: repeat(auto-fill, minmax(min(100%, 300px), 1fr)); }
.docs-section { display: flex; flex-direction: column; gap: var(--s-3); scroll-margin-top: calc(var(--header-h) + 16px); }
.docs-section__head { display: flex; align-items: center; gap: var(--s-3); }
.docs-section__title { font-size: var(--fs-md); font-weight: 650; letter-spacing: -0.01em; }
.docs-section__desc { font-size: var(--fs-sm); color: var(--text-muted); }
.docs-section__list { display: flex; flex-direction: column; gap: 2px; margin-top: auto; padding-top: var(--s-2); border-top: 1px solid var(--border); }
.docs-section__list a { display: flex; align-items: flex-start; gap: 8px; padding: 5px 0; font-size: var(--fs-sm); color: var(--text); }
.docs-section__list a .icon { flex-shrink: 0; margin-top: 3px; color: var(--text-subtle); transition: transform var(--dur) var(--ease), color var(--dur) var(--ease); }
.docs-section__list a:hover { color: var(--brand-text); text-decoration: none; }
.docs-section__list a:hover .icon { color: var(--brand-text); transform: translateX(2px); }

.docs-guide, .docs-help { display: flex; flex-direction: column; gap: var(--s-2); min-width: 0; }
.docs-guide__title { font-weight: 650; font-size: var(--fs-md); color: var(--text); }
.docs-guide__desc { font-size: var(--fs-sm); color: var(--text-muted); }
.docs-guide__more { margin-top: auto; padding-top: var(--s-2); display: inline-flex; align-items: center; gap: 6px; font-size: var(--fs-sm); font-weight: 600; color: var(--brand-text); }

.docs-api { align-items: center; }
.docs-api__code { min-width: 0; }

/* ---------------------------------------------------------------- docs article */
.docs-sidebar__search { margin-bottom: var(--s-5); }
.docs-sidebar__search .input { width: 100%; }
@media (max-width: 899px) {
  .docs-mobile-nav > .docs-sidebar__search { padding: var(--s-4) var(--s-4) 0; margin-bottom: 0; }
}
.docs-content__title { font-size: var(--fs-4xl); letter-spacing: -0.03em; line-height: 1.12; overflow-wrap: anywhere; }
@media (max-width: 640px) { .docs-content__title { font-size: var(--fs-3xl); } }
.docs-content__lead { font-size: var(--fs-lg); color: var(--text-muted); line-height: 1.55; max-width: 68ch; }

.docs-toc-inline {
  margin-bottom: var(--s-8);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  background: var(--surface);
  font-size: var(--fs-sm);
}
.docs-toc-inline > summary {
  display: flex;
  align-items: center;
  gap: var(--s-2);
  padding: 10px 14px;
  font-weight: 600;
  cursor: pointer;
  list-style: none;
}
.docs-toc-inline > summary::-webkit-details-marker { display: none; }
.docs-toc-inline > summary .icon:last-child { margin-left: auto; color: var(--text-muted); transition: transform var(--dur) var(--ease); }
.docs-toc-inline[open] > summary .icon:last-child { transform: rotate(180deg); }
.docs-toc-inline ul { padding: 0 14px 12px; display: flex; flex-direction: column; gap: 4px; border-top: 1px solid var(--border); padding-top: 10px; }
.docs-toc-inline li.is-sub { padding-left: var(--s-4); }
.docs-toc-inline a { color: var(--text-muted); }
.docs-toc-inline a:hover { color: var(--brand-text); }
@media (min-width: 1240px) { .docs-toc-inline { display: none; } }

.docs-prose { max-width: 76ch; }
.docs-prose .code-block, .docs-prose .code-tabs { margin-top: 1.1em; }
.docs-prose .code-block pre, .docs-prose .code-tabs pre {
  border: 0;
  border-radius: 0;
  margin: 0;
  background: transparent;
}
.docs-prose .code-block pre { background: var(--code-bg); }
.docs-prose h2 > a.anchor, .docs-prose h3 > a.anchor { font-weight: 500; }
.docs-prose h2 > a.anchor:focus-visible, .docs-prose h3 > a.anchor:focus-visible { opacity: 1; }
.docs-prose table { font-size: var(--fs-sm); }
.docs-prose th, .docs-prose td { vertical-align: top; }
.docs-prose td code { white-space: nowrap; }
.docs-prose blockquote p { color: var(--text-muted); }
.docs-prose blockquote strong { color: var(--text); }

.docs-feedback {
  margin-top: var(--s-12);
  padding: var(--s-4) var(--s-5);
  border: 1px dashed var(--border-strong);
  border-radius: var(--radius-lg);
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  justify-content: space-between;
  gap: var(--s-3);
}
.docs-feedback p { flex: 1 1 280px; }
.docs-content__footer { margin-top: var(--s-8); }
.docs-pager small { display: inline-flex; align-items: center; gap: 4px; }
.docs-pager--next small { justify-content: flex-end; }

.docs-toc__aside {
  margin-top: var(--s-6);
  padding-top: var(--s-4);
  border-top: 1px solid var(--border);
  display: flex;
  flex-direction: column;
  gap: var(--s-2);
  font-size: var(--fs-xs);
}
.docs-toc__aside a { display: inline-flex; align-items: center; gap: 6px; color: var(--text-muted); }
.docs-toc__aside a:hover { color: var(--brand-text); text-decoration: none; }

/* ---------------------------------------------------------------- FAQ */
.faq-layout { display: grid; gap: var(--s-8); grid-template-columns: minmax(0, 1fr); }
@media (min-width: 960px) {
  .faq-layout { grid-template-columns: 260px minmax(0, 1fr); gap: var(--s-12); }
  .faq-aside__inner { position: sticky; top: calc(var(--header-h) + 24px); }
}
.faq-aside__inner { display: flex; flex-direction: column; gap: var(--s-6); }
.faq-aside .input { width: 100%; }
.faq-topics__link { display: flex; justify-content: space-between; gap: var(--s-2); }
.faq-topics__count { font-size: var(--fs-xs); color: var(--text-muted); font-variant-numeric: tabular-nums; }
.faq-topics__link.is-empty { opacity: 0.45; }
@media (max-width: 959px) {
  .faq-topics .docs-nav__list { flex-direction: row; flex-wrap: wrap; gap: var(--s-2); }
  .faq-topics .docs-nav__link { border: 1px solid var(--border); background: var(--surface); }
}
.faq-group { scroll-margin-top: calc(var(--header-h) + 16px); }
.faq-group[hidden] { display: none; }
.faq-group__title { margin-bottom: var(--s-2); }
.faq-group__intro { margin-bottom: var(--s-4); max-width: 70ch; }
.faq-group .accordion__item { scroll-margin-top: calc(var(--header-h) + 16px); }
.faq-group .accordion__item[hidden] { display: none; }
.faq-group .accordion__summary { text-align: left; }
.faq-answer { max-width: 72ch; color: var(--text); }
.faq-answer > * + * { margin-top: 0.75em; }
.faq-permalink { display: inline-flex; align-items: center; gap: 5px; font-size: var(--fs-xs); color: var(--text-muted); margin-top: var(--s-3); }
.faq-permalink:hover { color: var(--brand-text); }