/* Documentation layout. Shares the design tokens from site-*.css. */

/* Shared primitives the docs shell needs (the guide pages carry these in
   learn-*.css, which docs pages do not load). */
.skip-link {
  position: absolute;
  left: -999px;
  top: 0;
  z-index: 100;
  padding: 0.6rem 1rem;
  background: var(--ink);
  color: var(--white);
  border-radius: 0 0 var(--radius-sm) 0;
}

.skip-link:focus {
  left: 0;
}

.breadcrumbs {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  padding: 1.4rem 0 0;
  font-family: var(--mono);
  font-size: var(--step-xs);
  color: var(--ink-faint);
}

.breadcrumbs a {
  color: var(--ink-soft);
  text-decoration: none;
}

.breadcrumbs a:hover {
  color: var(--green);
  text-decoration: underline;
}

.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0 0 0 0);
  white-space: nowrap;
  border: 0;
}

.docs-layout {
  display: grid;
  grid-template-columns: minmax(0, 15rem) minmax(0, 1fr) minmax(0, 13rem);
  gap: clamp(1.5rem, 4vw, 3.5rem);
  align-items: start;
  padding-block: clamp(1.5rem, 3vw, 2.5rem) clamp(3rem, 6vw, 5rem);
}

/* ---------- Sidebar ---------- */

.docs-sidebar {
  position: sticky;
  top: 1.5rem;
  font-size: var(--step-sm);
}

.docs-nav-group + .docs-nav-group {
  margin-top: 1.4rem;
}

.docs-nav-title {
  margin: 0 0 0.5rem;
  font-family: var(--mono);
  font-size: var(--step-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-faint);
}

.docs-sidebar ul {
  margin: 0;
  padding: 0;
  list-style: none;
}

.docs-sidebar li a {
  display: block;
  padding: 0.32rem 0.55rem;
  border-radius: var(--radius-sm);
  color: var(--ink-soft);
  text-decoration: none;
  line-height: 1.35;
}

.docs-sidebar li a:hover {
  color: var(--green);
  background: var(--paper-light);
}

.docs-sidebar li a[aria-current='page'] {
  color: var(--ink);
  background: var(--green-pale);
  font-weight: 600;
}

.docs-md-link {
  display: inline-block;
  margin-top: 1.5rem;
  font-family: var(--mono);
  font-size: var(--step-xs);
  color: var(--ink-faint);
  text-decoration: none;
  border-bottom: 1px dashed var(--line);
}

.docs-md-link:hover {
  color: var(--green);
}

/* ---------- Search ---------- */

.docs-search input {
  width: 100%;
  padding: 0.5rem 0.65rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--white);
  color: var(--ink);
  font: inherit;
  font-size: var(--step-sm);
}

.docs-search input:focus-visible {
  outline: 2px solid var(--green);
  outline-offset: 1px;
}

.docs-search-results {
  margin: 0.4rem 0 0;
  padding: 0;
  list-style: none;
  max-height: 18rem;
  overflow-y: auto;
}

.docs-search-results a {
  display: block;
  padding: 0.4rem 0.55rem;
  border-radius: var(--radius-sm);
  color: var(--ink);
  text-decoration: none;
  font-size: var(--step-sm);
}

.docs-search-results a:hover {
  background: var(--paper-light);
}

.docs-search-results small {
  display: block;
  color: var(--ink-faint);
  font-size: var(--step-xs);
}

.docs-search-empty {
  padding: 0.4rem 0.55rem;
  color: var(--ink-faint);
  font-size: var(--step-xs);
}

/* ---------- Article ---------- */

.docs-main {
  min-width: 0;
}

.docs-eyebrow {
  margin: 1.2rem 0 0;
  font-family: var(--mono);
  font-size: var(--step-xs);
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--green);
}

.docs-article h1 {
  margin: 0.5rem 0 0;
  font-size: clamp(2rem, 4.5vw, 3rem);
  font-weight: 700;
  letter-spacing: -0.04em;
  line-height: 1.05;
}

.docs-lede {
  margin-top: 0.9rem;
  font-size: var(--step-lg);
  line-height: 1.55;
  color: var(--ink-soft);
}

.docs-article h2 {
  margin: 2.6rem 0 0.8rem;
  font-size: clamp(1.35rem, 2.4vw, 1.7rem);
  letter-spacing: -0.02em;
  scroll-margin-top: 1.5rem;
}

.docs-article h3 {
  margin: 1.8rem 0 0.5rem;
  font-size: var(--step-lg);
  scroll-margin-top: 1.5rem;
}

.docs-article p,
.docs-article li {
  line-height: 1.68;
  color: var(--ink-soft);
}

.docs-article p {
  margin: 0.85rem 0;
}

.docs-article ul,
.docs-article ol {
  margin: 0.85rem 0;
  padding-left: 1.35rem;
}

.docs-article li + li {
  margin-top: 0.3rem;
}

.docs-article a {
  color: var(--green);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.docs-article strong {
  color: var(--ink);
}

.docs-article code {
  padding: 0.12em 0.34em;
  border-radius: 4px;
  background: var(--paper-deep);
  font-family: var(--mono);
  font-size: 0.9em;
  color: var(--ink);
}

.docs-article pre {
  margin: 1.1rem 0;
  padding: 1rem 1.1rem;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--radius-md);
  background: var(--white);
  box-shadow: var(--shadow-soft);
}

.docs-article pre code {
  padding: 0;
  background: none;
  font-size: var(--step-sm);
  line-height: 1.6;
}

.docs-article table {
  width: 100%;
  margin: 1.2rem 0;
  border-collapse: collapse;
  font-size: var(--step-sm);
}

.docs-article th,
.docs-article td {
  padding: 0.55rem 0.7rem;
  border-bottom: 1px solid var(--line);
  text-align: left;
  vertical-align: top;
}

.docs-article th {
  font-family: var(--mono);
  font-size: var(--step-xs);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--ink-faint);
}

.docs-article blockquote {
  margin: 1.1rem 0;
  padding: 0.2rem 1rem;
  border-left: 3px solid var(--green-pale);
  color: var(--ink-soft);
}

/* ---------- On this page ---------- */

.docs-toc {
  position: sticky;
  top: 1.5rem;
  font-size: var(--step-xs);
}

.docs-toc ul {
  margin: 0;
  padding: 0;
  list-style: none;
  border-left: 1px solid var(--line);
}

.docs-toc li a {
  display: block;
  padding: 0.24rem 0 0.24rem 0.7rem;
  color: var(--ink-faint);
  text-decoration: none;
}

.docs-toc li a:hover {
  color: var(--green);
}

/* ---------- Pager ---------- */

.docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--line);
}

.docs-pager-link {
  display: block;
  padding: 0.85rem 1rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-md);
  text-decoration: none;
  color: var(--ink);
  background: var(--white);
}

.docs-pager-link:hover {
  border-color: var(--green);
}

.docs-pager-link span {
  display: block;
  font-family: var(--mono);
  font-size: var(--step-xs);
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--ink-faint);
}

.docs-pager-next {
  text-align: right;
}

/* ---------- Responsive ---------- */

@media (max-width: 1100px) {
  .docs-layout {
    grid-template-columns: minmax(0, 14rem) minmax(0, 1fr);
  }

  .docs-toc {
    display: none;
  }
}

@media (max-width: 820px) {
  .docs-layout {
    grid-template-columns: minmax(0, 1fr);
  }

  .docs-sidebar {
    position: static;
    border-bottom: 1px solid var(--line);
    padding-bottom: 1rem;
  }

  .docs-pager {
    grid-template-columns: 1fr;
  }

  .docs-pager-next {
    text-align: left;
  }
}
