/* ============================================================
   docs.css - shared documentation layout
   ============================================================ */

.docs-page {
  min-height: 100dvh;
  padding-top: var(--nav-h);
  background:
    linear-gradient(180deg, rgba(96, 165, 250, 0.07), transparent 360px),
    var(--bg0);
}

.docs-hero {
  border-bottom: 1px solid var(--border);
}

.docs-hero__inner {
  width: min(1120px, 100%);
  margin: 0 auto;
  padding: clamp(3rem, 7vw, 5.5rem) clamp(1rem, 5vw, 2rem) clamp(2.5rem, 5vw, 4rem);
}

.docs-hero__eyebrow,
.docs-section__kicker,
.docs-sidebar__title {
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
}

.docs-hero__eyebrow {
  color: var(--accent-hi);
  margin-bottom: 0.8rem;
}

.docs-hero__title {
  max-width: 760px;
  font-size: clamp(2rem, 5vw, 3.45rem);
  font-weight: 700;
  letter-spacing: -0.03em;
  line-height: 1.05;
}

.docs-hero__lead {
  max-width: 660px;
  margin-top: 1rem;
  color: var(--muted);
  font-size: clamp(0.95rem, 1.5vw, 1.08rem);
  line-height: 1.75;
}

.docs-hero__meta {
  display: inline-flex;
  align-items: center;
  gap: 0.55rem;
  margin-top: 1.35rem;
  color: var(--muted2);
  font-size: 0.82rem;
}

.docs-hero__status {
  display: inline-grid;
  place-items: center;
  width: 1.4rem;
  height: 1.4rem;
  border: 1px solid rgba(45, 212, 191, 0.32);
  border-radius: 999px;
  color: #5eead4;
  background: rgba(20, 184, 166, 0.1);
}

.docs-hero__status svg {
  width: 0.8rem;
  height: 0.8rem;
}

.docs-shell {
  width: min(1120px, 100%);
  margin: 0 auto;
  display: grid;
  grid-template-columns: 280px minmax(0, 1fr);
  gap: clamp(2rem, 5vw, 4rem);
  padding: 2rem clamp(1rem, 5vw, 2rem) 6rem;
}

.docs-mobile-toc,
.docs-toc-overlay,
.docs-sidebar__close {
  display: none;
}

.docs-sidebar {
  display: none;
}

.docs-sidebar__head {
  display: block;
}

.docs-sidebar__panel {
  grid-column: 1;
  grid-row: 1;
  position: sticky;
  top: calc(var(--nav-h) + 1.25rem);
  max-height: calc(100dvh - var(--nav-h) - 2.5rem);
  overflow: auto;
  padding: 1rem;
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  background: rgba(13, 17, 23, 0.72);
  backdrop-filter: blur(16px);
}

.docs-sidebar__title {
  color: var(--muted2);
  margin-bottom: 0.85rem;
}

.docs-toc,
.docs-toc__group,
.docs-toc__children {
  display: flex;
  flex-direction: column;
}

.docs-toc {
  gap: 0.25rem;
}

.docs-toc__children {
  margin-top: 0.18rem;
  padding-left: 0.75rem;
  border-left: 1px solid var(--border);
}

.docs-toc__row {
  display: grid;
  grid-template-columns: minmax(0, 1fr) 1.85rem;
  align-items: center;
  gap: 0.25rem;
  border-radius: 7px;
}

.docs-toc__row:hover {
  background: rgba(255, 255, 255, 0.035);
}

.docs-toc__link {
  min-width: 0;
  padding: 0.48rem 0.35rem;
  color: var(--muted);
  font-size: 0.82rem;
  line-height: 1.35;
  transition: color var(--fast);
}

.docs-toc__link--section {
  color: var(--text);
  font-weight: 650;
}

.docs-toc__link:hover,
.docs-toc__link.active {
  color: var(--accent-hi);
}

.docs-main {
  grid-column: 2;
  grid-row: 1;
  min-width: 0;
}

.docs-section {
  scroll-margin-top: calc(var(--nav-h) + 1.25rem);
  padding: 2.2rem 0 3.5rem;
  border-bottom: 1px solid var(--border);
}

.docs-section:first-child {
  padding-top: 0.4rem;
}

.docs-section:last-child {
  border-bottom: 0;
}

.docs-heading {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  scroll-margin-top: calc(var(--nav-h) + 1.25rem);
}

.docs-heading h2,
.docs-heading h3 {
  letter-spacing: -0.025em;
  line-height: 1.15;
}

.docs-heading h2 {
  font-size: clamp(1.65rem, 3vw, 2.2rem);
}

.docs-heading h3 {
  font-size: clamp(1.25rem, 2vw, 1.5rem);
}

.docs-section__kicker {
  color: var(--accent-hi);
  margin-bottom: 0.45rem;
}

.docs-section__summary {
  max-width: 680px;
  margin-top: 0.85rem;
  color: var(--muted);
  line-height: 1.75;
  font-size: 0.95rem;
}

.docs-subsection {
  scroll-margin-top: calc(var(--nav-h) + 1.25rem);
  margin-top: 2rem;
  padding: clamp(1rem, 3vw, 1.35rem);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  background:
    linear-gradient(145deg, rgba(255, 255, 255, 0.04), rgba(255, 255, 255, 0.01)),
    var(--bg1);
}

.docs-prose {
  margin-top: 1rem;
  color: var(--muted);
  font-size: 0.92rem;
}

.docs-prose p {
  margin: 0 0 1rem;
  line-height: 1.8;
}

.docs-prose p:last-child {
  margin-bottom: 0;
}

.docs-prose strong {
  color: var(--text);
}

.docs-prose a {
  color: var(--accent-hi);
  text-decoration: underline;
  text-decoration-color: rgba(96, 165, 250, 0.35);
  text-underline-offset: 3px;
}

.docs-prose ul,
.docs-prose ol {
  margin: 1rem 0;
  padding-left: 1.25rem;
}

.docs-prose ul {
  list-style: disc;
}

.docs-prose ol {
  list-style: decimal;
}

.docs-prose li {
  margin: 0.35rem 0;
  line-height: 1.7;
}

.docs-prose blockquote {
  margin: 1rem 0;
  padding: 0.85rem 1rem;
  border-left: 3px solid var(--accent-hi);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  background: rgba(59, 130, 246, 0.075);
  color: var(--text);
}

.docs-prose blockquote p {
  margin: 0;
  font-size: 0.9rem;
  line-height: 1.7;
}

.docs-prose img {
  display: block;
  width: 100%;
  max-height: 360px;
  object-fit: cover;
  margin: 1.25rem 0;
  border: 1px solid var(--border-hi);
  border-radius: var(--radius-sm);
  background: var(--bg2);
}

.docs-copy {
  display: inline-grid;
  place-items: center;
  flex-shrink: 0;
  width: 2rem;
  height: 2rem;
  border: 1px solid var(--border);
  border-radius: 8px;
  color: var(--muted2);
  background: rgba(255, 255, 255, 0.025);
  opacity: 0;
  transform: translateY(2px);
  transition:
    opacity var(--fast),
    transform var(--fast),
    color var(--fast),
    border-color var(--fast),
    background var(--fast);
}

.docs-heading:hover .docs-copy,
.docs-heading:focus-within .docs-copy,
.docs-copy:focus-visible,
.docs-toc__row:hover .docs-copy--toc,
.docs-toc__row:focus-within .docs-copy--toc {
  opacity: 1;
  transform: translateY(0);
}

.docs-copy:hover,
.docs-copy.copied {
  color: var(--accent-hi);
  border-color: rgba(96, 165, 250, 0.35);
  background: rgba(59, 130, 246, 0.09);
}

.docs-copy svg {
  width: 1rem;
  height: 1rem;
}

.docs-copy--toc {
  width: 1.75rem;
  height: 1.75rem;
}

.docs-copy--toc svg {
  width: 0.86rem;
  height: 0.86rem;
}

.docs-steps {
  display: grid;
  gap: 0.9rem;
  margin: 1.35rem 0 0;
  padding: 0;
  list-style: none;
  counter-reset: none;
}

.docs-step {
  display: grid;
  grid-template-columns: 2.25rem minmax(0, 1fr);
  gap: 0.9rem;
}

.docs-step__marker {
  display: grid;
  place-items: center;
  width: 2.25rem;
  height: 2.25rem;
  border: 1px solid rgba(96, 165, 250, 0.28);
  border-radius: 8px;
  color: var(--accent-hi);
  background: rgba(59, 130, 246, 0.08);
  font-family: var(--font-mono);
  font-size: 0.72rem;
  font-weight: 700;
}

.docs-step__body {
  min-width: 0;
  padding-bottom: 0.9rem;
  border-bottom: 1px solid var(--border);
}

.docs-step:last-child .docs-step__body {
  padding-bottom: 0;
  border-bottom: 0;
}

.docs-step h4 {
  font-size: 0.96rem;
  letter-spacing: -0.015em;
  line-height: 1.35;
}

.docs-step p {
  margin-top: 0.28rem;
  color: var(--muted);
  font-size: 0.86rem;
  line-height: 1.7;
}

.docs-callout {
  display: grid;
  grid-template-columns: 2.25rem minmax(0, 1fr);
  gap: 0.9rem;
  margin-top: 1.35rem;
  padding: 1rem;
  border: 1px solid rgba(45, 212, 191, 0.18);
  border-radius: var(--radius-sm);
  background: rgba(20, 184, 166, 0.07);
}

.docs-callout__icon {
  display: grid;
  place-items: center;
  width: 2.25rem;
  height: 2.25rem;
  border-radius: 8px;
  color: #5eead4;
  background: rgba(20, 184, 166, 0.12);
}

.docs-callout__icon svg {
  width: 1rem;
  height: 1rem;
}

.docs-callout h4 {
  font-size: 0.95rem;
  letter-spacing: -0.015em;
}

.docs-callout p {
  margin-top: 0.25rem;
  color: var(--muted);
  font-size: 0.86rem;
  line-height: 1.7;
}

.docs-actions {
  display: flex;
  flex-wrap: wrap;
  gap: 0.65rem;
  margin-top: 1.35rem;
}

.docs-action {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  min-height: 2.65rem;
  padding: 0.72rem 1rem;
  border-radius: var(--radius-sm);
  font-size: 0.86rem;
  font-weight: 650;
  transition: transform var(--fast), background var(--fast), border-color var(--fast), color var(--fast);
}

.docs-action svg {
  width: 1rem;
  height: 1rem;
}

.docs-action--primary {
  color: #fff;
  background: var(--accent);
}

.docs-action--primary:hover {
  background: var(--accent-hi);
  transform: translateY(-1px);
}

.docs-action--secondary {
  color: var(--text);
  border: 1px solid var(--border-hi);
  background: rgba(255, 255, 255, 0.035);
}

.docs-action--secondary:hover {
  border-color: rgba(96, 165, 250, 0.35);
  color: var(--accent-hi);
}

.docs-media-list {
  display: grid;
  gap: 1rem;
  margin-top: 1.5rem;
}

.docs-media {
  overflow: hidden;
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  background: var(--bg2);
}

.docs-media img {
  width: 100%;
  height: auto;
}

.docs-media figcaption {
  padding: 0.75rem 0.9rem;
  color: var(--muted);
  font-size: 0.8rem;
  border-top: 1px solid var(--border);
}

@media (max-width: 900px) {
  .docs-shell {
    grid-template-columns: 1fr;
    gap: 1.5rem;
    padding-top: 0;
  }

  .docs-sidebar {
    display: block;
    position: sticky;
    top: var(--nav-h);
    z-index: 80;
    margin: 0 calc(clamp(1rem, 5vw, 2rem) * -1);
    padding: 0.7rem clamp(1rem, 5vw, 2rem);
    border-bottom: 1px solid var(--border);
    background: rgba(8, 12, 18, 0.86);
    backdrop-filter: blur(16px);
  }

  .docs-mobile-toc {
    display: grid;
    grid-template-columns: minmax(0, 1fr) auto;
    grid-template-areas:
      "meta icon"
      "current icon";
    align-items: center;
    gap: 0.1rem 0.75rem;
    width: 100%;
    min-height: 3.55rem;
    padding: 0.65rem 0.85rem;
    border: 1px solid var(--border);
    border-radius: var(--radius-sm);
    background: rgba(22, 27, 34, 0.92);
    color: var(--text);
    text-align: left;
    user-select: none;
    -webkit-user-select: none;
    box-shadow: 0 14px 34px rgba(0, 0, 0, 0.22);
  }

  .docs-mobile-toc__meta {
    grid-area: meta;
    color: var(--muted2);
    font-size: 0.68rem;
    font-weight: 700;
    letter-spacing: 0.1em;
    line-height: 1.2;
    text-transform: uppercase;
  }

  .docs-mobile-toc__current {
    grid-area: current;
    min-width: 0;
    overflow: hidden;
    color: var(--text);
    font-size: 0.9rem;
    font-weight: 650;
    line-height: 1.35;
    text-overflow: ellipsis;
    white-space: nowrap;
  }

  .docs-mobile-toc__chevron {
    grid-area: icon;
    width: 1.15rem;
    height: 1.15rem;
    color: var(--muted);
    transition: transform var(--fast), color var(--fast);
  }

  .docs-sidebar.open .docs-mobile-toc__chevron {
    color: var(--accent-hi);
    transform: rotate(180deg);
  }

  .docs-toc-overlay {
    position: fixed;
    inset: 0;
    z-index: 180;
    display: block;
    background: rgba(0, 0, 0, 0.58);
    opacity: 0;
    pointer-events: none;
    user-select: none;
    -webkit-user-select: none;
    visibility: hidden;
    transition:
      opacity 220ms var(--ease),
      visibility 0s linear 220ms;
  }

  body.docs-toc-open .docs-toc-overlay {
    opacity: 1;
    pointer-events: auto;
    visibility: visible;
    transition-delay: 0s;
  }

  .docs-sidebar__panel {
    grid-column: auto;
    grid-row: auto;
    position: fixed;
    inset: auto 0 0 0;
    z-index: 190;
    width: 100vw;
    height: min(82dvh, 38rem);
    max-height: calc(100dvh - var(--nav-h) - 0.75rem);
    overflow: auto;
    overscroll-behavior: contain;
    padding: 1rem clamp(1rem, 5vw, 1.25rem) max(1rem, env(safe-area-inset-bottom));
    border: 1px solid var(--border-hi);
    border-bottom: 0;
    border-radius: var(--radius-sm) var(--radius-sm) 0 0;
    background:
      linear-gradient(180deg, rgba(255, 255, 255, 0.045), rgba(255, 255, 255, 0.012)),
      var(--bg1);
    box-shadow: 0 -24px 60px rgba(0, 0, 0, 0.5);
    opacity: 0;
    pointer-events: none;
    user-select: none;
    -webkit-user-select: none;
    visibility: hidden;
    transform: translate3d(0, calc(100% + 1.5rem), 0);
    transition:
      transform 360ms cubic-bezier(0.22, 1, 0.36, 1),
      opacity 240ms ease,
      visibility 0s linear 360ms;
    will-change: transform;
  }

  .docs-sidebar__panel *,
  .docs-mobile-toc * {
    user-select: none;
    -webkit-user-select: none;
  }

  .docs-sidebar__panel.dragging {
    transition: none;
  }

  body.docs-toc-open .docs-sidebar__panel {
    opacity: 1;
    pointer-events: auto;
    visibility: visible;
    transform: translate3d(0, 0, 0);
    transition-delay: 0s;
  }

  .docs-sidebar__panel::before {
    content: "";
    display: block;
    width: 2.35rem;
    height: 0.25rem;
    margin: 0 auto 0.95rem;
    border-radius: 999px;
    background: rgba(255, 255, 255, 0.16);
    cursor: grab;
    touch-action: none;
  }

  .docs-sidebar__panel.dragging::before {
    cursor: grabbing;
  }

  @media (prefers-reduced-motion: reduce) {
    .docs-toc-overlay,
    .docs-sidebar__panel,
    .docs-mobile-toc__chevron {
      transition-duration: 1ms;
    }
  }

  .docs-main {
    grid-column: auto;
    grid-row: auto;
  }

  .docs-sidebar__head {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    margin-bottom: 0.85rem;
  }

  .docs-sidebar__title {
    margin-bottom: 0;
  }

  .docs-sidebar__close {
    display: inline-grid;
    place-items: center;
    flex-shrink: 0;
    width: 2.25rem;
    height: 2.25rem;
    border: 1px solid transparent;
    border-radius: var(--radius-sm);
    color: var(--muted);
    background: transparent;
    transition: color var(--fast), border-color var(--fast), background var(--fast);
  }

  .docs-sidebar__close:hover {
    color: var(--text);
    background: rgba(255, 255, 255, 0.045);
  }

  .docs-sidebar__close svg {
    width: 1rem;
    height: 1rem;
  }

  .docs-toc {
    gap: 0.35rem;
    padding-bottom: 0.25rem;
  }

  .docs-toc__row {
    display: grid;
    grid-template-columns: minmax(0, 1fr);
    background: rgba(255, 255, 255, 0.035);
    border: 1px solid var(--border);
  }

  .docs-toc__children {
    gap: 0.35rem;
    margin-top: 0.35rem;
    margin-bottom: 0.25rem;
  }

  .docs-toc__link {
    padding: 0.75rem 0.85rem;
    font-size: 0.92rem;
  }

  .docs-toc__link--section {
    font-size: 0.95rem;
  }

  .docs-toc__link.active {
    color: var(--text);
    background: rgba(59, 130, 246, 0.11);
    border-radius: 7px;
  }

  .docs-copy--toc {
    display: none;
  }

  .docs-section,
  .docs-subsection,
  .docs-heading {
    scroll-margin-top: calc(var(--nav-h) + 5.25rem);
  }

  body.docs-toc-open {
    overflow: hidden;
  }
}

@media (max-width: 560px) {
  .docs-hero__inner {
    padding-top: 2.5rem;
  }

  .docs-shell {
    padding-bottom: 4rem;
  }

  .docs-section {
    padding-bottom: 2.5rem;
  }

  .docs-subsection {
    margin-top: 1.4rem;
  }

  .docs-copy {
    opacity: 1;
    transform: none;
  }

  .docs-step,
  .docs-callout {
    grid-template-columns: 1fr;
  }

  .docs-step__marker {
    width: 2rem;
    height: 2rem;
  }

  .docs-actions {
    flex-direction: column;
  }

  .docs-action {
    justify-content: center;
    width: 100%;
  }
}