/* ============================================================
   UNDINE DOCS — dark dev-tool theme
   Inherits root vars from style.css
   ============================================================ */

:root {
  --docs-sidebar-w: 270px;
  --docs-content-max: 760px;
  --docs-bg-code: #0c1017;
}

body.docs-body {
  background: var(--bg);
  color: var(--text);
}

/* mark active "docs" link in top nav */
.docs-body .menu a[aria-current="page"] {
  color: var(--text);
}

/* ============================================================
   LAYOUT
   ============================================================ */
.docs-main {
  padding: 2.4rem 0 5rem;
  position: relative;
  z-index: 1;
}

.docs-shell {
  display: grid;
  grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
  gap: 3rem;
  align-items: start;
}

/* ============================================================
   SIDEBAR
   ============================================================ */
.docs-sidebar-toggle {
  display: none;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  margin-bottom: 1rem;
  padding: .8rem 1rem;
  background: var(--bg-card);
  color: var(--text);
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  font: inherit;
  font-family: var(--mono);
  font-size: .88rem;
  cursor: pointer;
}
.docs-sidebar-toggle::after {
  content: "//";
  color: var(--accent);
}

.docs-sidebar {
  position: sticky;
  top: 88px;
  max-height: calc(100vh - 100px);
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--line) transparent;
}
.docs-sidebar::-webkit-scrollbar { width: 6px; }
.docs-sidebar::-webkit-scrollbar-thumb {
  background: var(--line);
  border-radius: 3px;
}

.docs-sidebar-inner {
  padding: 0 .25rem 2rem 0;
}

.docs-sidebar-kicker {
  margin: 0 0 1.4rem;
  padding: 0 .75rem;
  font-family: var(--mono);
  font-size: .72rem;
  text-transform: lowercase;
  letter-spacing: .04em;
  color: var(--muted);
}
.docs-sidebar-kicker::before {
  content: "// ";
  color: var(--accent);
}

.docs-nav-tree,
.docs-nav-sublist {
  list-style: none;
  margin: 0;
  padding: 0;
}

.docs-sidebar-section + .docs-sidebar-section {
  margin-top: 1.4rem;
}

.docs-sidebar-section-title {
  margin: 0 0 .5rem;
  padding: 0 .75rem;
  font-family: var(--mono);
  font-size: .72rem;
  text-transform: lowercase;
  letter-spacing: .04em;
  color: var(--muted);
}

.docs-nav-tree {
  display: grid;
  gap: .05rem;
}

.docs-nav-item {
  display: grid;
  gap: .05rem;
}

.docs-nav-link {
  display: block;
  padding: .42rem .75rem;
  border-radius: 6px;
  border-left: 2px solid transparent;
  color: var(--text-dim);
  font-size: .92rem;
  transition: color .12s ease, background .12s ease, border-color .12s ease;
}

.docs-nav-link:hover {
  color: var(--text);
  background: rgba(255, 255, 255, .025);
}

.docs-nav-item.is-active > .docs-nav-link {
  color: var(--accent);
  border-left-color: var(--accent);
  background: rgba(77, 210, 255, .06);
  font-weight: 500;
}

.docs-nav-item.is-ancestor > .docs-nav-link {
  color: var(--text);
}

.docs-nav-sublist {
  display: grid;
  gap: .05rem;
  margin: .15rem 0 .35rem .85rem;
  padding-left: .85rem;
  border-left: 1px solid var(--line);
}

.docs-nav-sublist .docs-nav-link {
  font-size: .87rem;
  padding: .32rem .75rem;
}

.docs-sidebar-note {
  margin: 1.8rem .25rem 0;
  padding: .9rem 1rem;
  border-radius: var(--radius-sm);
  border: 1px solid var(--line);
  background: var(--bg-card);
}

.docs-sidebar-note strong {
  display: block;
  margin-bottom: .35rem;
  font-family: var(--mono);
  font-size: .78rem;
  color: var(--accent);
  font-weight: 500;
}
.docs-sidebar-note strong::before {
  content: "// ";
  color: var(--muted);
}

.docs-sidebar-note p {
  margin: 0;
  color: var(--text-dim);
  font-size: .85rem;
  line-height: 1.5;
}

.docs-overlay { display: none; }

/* ============================================================
   ARTICLE
   ============================================================ */
.docs-content {
  min-width: 0;
}

.docs-breadcrumbs {
  display: flex;
  flex-wrap: wrap;
  gap: .45rem;
  font-family: var(--mono);
  font-size: .8rem;
  color: var(--muted);
  margin-bottom: 1.6rem;
}
.docs-breadcrumbs a {
  color: var(--text-dim);
  transition: color .12s ease;
}
.docs-breadcrumbs a:hover { color: var(--accent); }
.docs-breadcrumbs [aria-current="page"] {
  color: var(--text);
}
.docs-crumb-separator { color: var(--line); }

.docs-article {
  max-width: var(--docs-content-max);
  background: transparent;
  border: 0;
  border-radius: 0;
  box-shadow: none;
  padding: 0;
}

.docs-article > .eyebrow {
  margin-bottom: .8rem;
}

.docs-article-header {
  margin-bottom: 2rem;
  padding-bottom: 1.6rem;
  border-bottom: 1px solid var(--line);
}

.docs-article-header h1 {
  font-size: clamp(1.9rem, 3.4vw, 2.7rem);
  margin: 0 0 1rem;
  text-wrap: balance;
}

.docs-lead {
  font-size: 1.08rem;
  color: var(--text);
  margin: 0 0 .7rem;
  max-width: 60ch;
}

.docs-intro {
  font-size: .98rem;
  color: var(--text-dim);
  margin: .4rem 0 0;
  max-width: 64ch;
}

/* ---------- callout ---------- */
.docs-callout {
  margin: 0 0 2rem;
  padding: 1rem 1.2rem;
  border-radius: var(--radius-sm);
  background: var(--bg-card);
  border: 1px solid var(--line);
  border-left: 3px solid var(--accent);
}

.docs-callout strong {
  display: block;
  margin-bottom: .35rem;
  font-family: var(--mono);
  font-size: .8rem;
  color: var(--accent);
  font-weight: 500;
  text-transform: lowercase;
  letter-spacing: .03em;
}
.docs-callout strong::before { content: "// "; color: var(--muted); }

.docs-callout p {
  margin: 0;
  color: var(--text-dim);
  font-size: .94rem;
}

/* ---------- section blocks ---------- */
.docs-section-block + .docs-section-block {
  margin-top: 3rem;
  padding-top: 2.5rem;
  border-top: 1px solid var(--line-soft);
}

.docs-section-block h2 {
  margin: 0 0 1rem;
  font-size: clamp(1.4rem, 2vw, 1.7rem);
}

.docs-section-block p,
.docs-subsection p {
  color: var(--text-dim);
  max-width: 64ch;
}

.docs-subsection + .docs-subsection {
  margin-top: 1.6rem;
}

.docs-subsection h3 {
  margin: 0 0 .55rem;
  font-size: 1.05rem;
  color: var(--text);
}

/* ---------- bullet lists ---------- */
.docs-bullet-list {
  list-style: none;
  padding: 0;
  margin: 1rem 0 0;
  display: grid;
  gap: .45rem;
  max-width: 64ch;
}
.docs-bullet-list li {
  position: relative;
  padding-left: 1.4rem;
  color: var(--text-dim);
  font-size: .96rem;
}
.docs-bullet-list li::before {
  content: "→";
  position: absolute;
  left: 0;
  color: var(--accent);
  font-family: var(--mono);
  font-size: .9rem;
}

/* ---------- code ---------- */
.docs-code-block {
  margin: 1.4rem 0 0;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  overflow: hidden;
  background: var(--docs-bg-code);
}

.docs-code-label {
  display: block;
  padding: .55rem .9rem;
  font-family: var(--mono);
  font-size: .76rem;
  color: var(--text-dim);
  background: var(--bg-elev);
  border-bottom: 1px solid var(--line);
}
.docs-code-label::before { content: "// "; color: var(--muted); }

.docs-code-block pre {
  margin: 0;
  padding: 1rem 1.2rem;
  overflow-x: auto;
  background: transparent;
}

.docs-code-block code {
  font-family: var(--mono);
  font-size: .88rem;
  line-height: 1.7;
  color: var(--text);
  background: transparent;
  padding: 0;
}

/* ---------- diagrams (mermaid) ---------- */
.docs-diagram-block {
  margin: 1.4rem 0 0;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--bg-card);
  overflow: hidden;
}

.docs-diagram-copy {
  padding: 1rem 1.2rem;
  border-bottom: 1px solid var(--line);
  background: var(--bg-elev);
}
.docs-diagram-copy strong {
  display: block;
  font-family: var(--mono);
  font-size: .82rem;
  color: var(--accent);
  font-weight: 500;
}
.docs-diagram-copy strong::before { content: "// "; color: var(--muted); }

.docs-diagram-copy p {
  margin: .45rem 0 0;
  color: var(--text-dim);
  font-size: .9rem;
}

.docs-mermaid {
  margin: 0;
  padding: 1.2rem;
  overflow-x: auto;
  background: transparent;
  text-align: center;
}
.docs-mermaid svg {
  max-width: 100%;
  height: auto;
}

/* ---------- mini cards ---------- */
.docs-card-grid,
.docs-related-grid,
.docs-pagination {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: .8rem;
}

.docs-card-grid { margin-top: 1.4rem; }

.docs-mini-card,
.docs-related-link,
.docs-pagination-link {
  display: block;
  padding: 1rem 1.1rem;
  border-radius: var(--radius-sm);
  background: var(--bg-card);
  border: 1px solid var(--line);
  transition: border-color .15s ease, transform .15s ease, background .15s ease;
}

.docs-mini-card:hover,
.docs-related-link:hover,
.docs-pagination-link:hover {
  border-color: var(--accent);
  transform: translateY(-1px);
  background: rgba(77, 210, 255, .04);
}

.docs-mini-card strong,
.docs-pagination-link strong {
  display: block;
  margin-bottom: .35rem;
  font-family: var(--display);
  font-size: 1rem;
  color: var(--text);
}

.docs-mini-card span {
  color: var(--text-dim);
  font-size: .9rem;
  line-height: 1.5;
}

/* ---------- tables ---------- */
.docs-table-wrap {
  margin-top: 1.4rem;
  overflow-x: auto;
  border-radius: var(--radius-sm);
  border: 1px solid var(--line);
  background: var(--bg-card);
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  min-width: 580px;
}

.docs-table th,
.docs-table td {
  padding: .85rem 1rem;
  text-align: left;
  border-bottom: 1px solid var(--line);
  font-size: .92rem;
}

.docs-table th {
  font-family: var(--mono);
  font-size: .76rem;
  text-transform: lowercase;
  letter-spacing: .04em;
  color: var(--muted);
  background: var(--bg-elev);
  font-weight: 500;
}

.docs-table td {
  color: var(--text-dim);
  vertical-align: top;
}

.docs-table tr:last-child td { border-bottom: 0; }

.docs-table a {
  color: var(--accent);
  border-bottom: 1px dashed transparent;
  transition: border-color .12s ease;
}
.docs-table a:hover { border-bottom-color: var(--accent); }

/* ---------- pagination ---------- */
.docs-pagination {
  margin-top: 3rem;
  padding-top: 2rem;
  border-top: 1px solid var(--line);
}

.docs-pagination-eyebrow {
  display: block;
  margin-bottom: .3rem;
  font-family: var(--mono);
  font-size: .72rem;
  text-transform: lowercase;
  letter-spacing: .04em;
  color: var(--muted);
}
.docs-pagination-eyebrow::before { content: "// "; color: var(--accent); }

.docs-pagination-link.is-empty {
  visibility: hidden;
}

/* ---------- related ---------- */
.docs-related {
  margin-top: 2.5rem;
}
.docs-related h2 {
  margin: 0 0 1rem;
  font-family: var(--mono);
  font-size: .82rem;
  font-weight: 500;
  color: var(--muted);
  text-transform: lowercase;
  letter-spacing: .04em;
}
.docs-related h2::before { content: "// "; color: var(--accent); }

.docs-related-link {
  font-family: var(--display);
  font-weight: 500;
  color: var(--text);
  font-size: .95rem;
}

/* ---------- inline elements ---------- */
.docs-article a:not(.docs-mini-card):not(.docs-related-link):not(.docs-pagination-link):not(.docs-table a) {
  color: var(--accent);
  border-bottom: 1px solid rgba(77, 210, 255, .25);
  transition: border-color .12s ease;
}
.docs-article a:not(.docs-mini-card):not(.docs-related-link):not(.docs-pagination-link):hover {
  border-bottom-color: var(--accent);
}

.docs-article strong { color: var(--text); }
.docs-article em { color: var(--accent); font-style: normal; }

/* ============================================================
   RESPONSIVE
   ============================================================ */
@media (max-width: 1100px) {
  .docs-shell {
    grid-template-columns: 240px minmax(0, 1fr);
    gap: 2rem;
  }
}

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

  .docs-sidebar-toggle { display: inline-flex; }

  .docs-sidebar {
    position: fixed;
    inset: 64px auto 0 0;
    width: min(86vw, 320px);
    background: var(--bg-elev);
    border-right: 1px solid var(--line);
    padding: 1.2rem 1rem;
    transform: translateX(-115%);
    transition: transform .22s ease;
    z-index: 120;
    max-height: none;
  }

  .docs-body.docs-sidebar-open .docs-sidebar {
    transform: translateX(0);
  }

  .docs-overlay {
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, .65);
    z-index: 110;
  }

  .docs-body.docs-sidebar-open .docs-overlay { display: block; }

  .docs-card-grid,
  .docs-related-grid,
  .docs-pagination {
    grid-template-columns: 1fr;
  }
}

@media (max-width: 600px) {
  .docs-main { padding-top: 1.6rem; }
  .docs-article-header h1 { font-size: 1.7rem; }
  .docs-table { min-width: 480px; }
}