/* ================================================
   dynavec docs — layout and components
   Extends ../styles.css design tokens.
   ================================================ */

/* ---- Doc shell layout ---- */
.docshell {
  max-width: 1140px;
  margin: 0 auto;
  padding: 0 24px;
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: 48px;
  align-items: start;
}

/* ================================================
   SIDEBAR
   ================================================ */

.side {
  position: sticky;
  top: calc(var(--nav-h) + 24px);
  align-self: start;
  max-height: calc(100vh - var(--nav-h) - 48px);
  overflow-y: auto;
  padding: 8px 0 64px;
  scrollbar-width: thin;
  scrollbar-color: var(--border) transparent;
}
.side::-webkit-scrollbar { width: 4px; }
.side::-webkit-scrollbar-track { background: transparent; }
.side::-webkit-scrollbar-thumb { background: var(--border); border-radius: 4px; }

.side__group { margin-bottom: 20px; }

.side__title {
  font-family: var(--mono);
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.09em;
  color: var(--fg-4);
  margin: 0 0 6px 8px;
  font-weight: 600;
}

.side__list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 1px;
}

.side__list a {
  display: block;
  text-decoration: none;
  font-size: 14px;
  color: var(--fg-3);
  padding: 6px 10px;
  border-radius: var(--r);
  border-left: 2px solid transparent;
  transition: background var(--t), color var(--t), border-color var(--t);
  font-weight: 450;
}
.side__list a:hover {
  color: var(--fg);
  background: var(--subtle);
}
.side__list a.is-current {
  color: var(--fg);
  background: var(--surface);
  border-left-color: var(--accent);
  font-weight: 600;
}

/* ================================================
   CONTENT AREA
   ================================================ */

.doc {
  min-width: 0;
  padding: 32px 0 96px;
}

/* Breadcrumbs */
.doc__crumbs {
  font-family: var(--mono);
  font-size: 12px;
  color: var(--fg-4);
  margin-bottom: 20px;
  display: flex;
  align-items: center;
  gap: 6px;
}
.doc__crumbs::before {
  content: "";
  display: inline-block;
  width: 16px;
  height: 1.5px;
  background: var(--accent);
}
.doc__crumbs a {
  color: var(--fg-3);
  text-decoration: none;
  transition: color var(--t);
  border: none;
}
.doc__crumbs a:hover { color: var(--fg); }
.doc__crumbs span { color: var(--fg-4); }

/* Page heading */
.doc h1 {
  font-size: clamp(26px, 3.6vw, 38px);
  font-weight: 800;
  letter-spacing: -0.03em;
  line-height: 1.1;
  margin: 0 0 10px;
}

.doc__sub {
  font-size: 17px;
  color: var(--fg-2);
  margin: 0 0 32px;
  line-height: 1.6;
}

/* Section headings */
.doc h2 {
  font-size: 20px;
  font-weight: 700;
  letter-spacing: -0.02em;
  margin: 48px 0 14px;
  padding-top: 0;
}
.doc h2::before {
  content: "";
  display: block;
  width: 24px;
  height: 2px;
  background: var(--accent);
  margin-bottom: 12px;
  border-radius: 2px;
}

.doc h3 {
  font-size: 16px;
  font-weight: 700;
  letter-spacing: -0.01em;
  margin: 28px 0 8px;
  color: var(--fg);
}

/* Body text */
.doc p { font-size: 15.5px; color: var(--fg-2); line-height: 1.72; margin: 0 0 14px; }
.doc ul, .doc ol { padding-left: 22px; margin: 0 0 14px; }
.doc li { font-size: 15.5px; color: var(--fg-2); line-height: 1.65; margin: 5px 0; }

/* Inline code */
.doc code {
  font-family: var(--mono);
  font-size: 13px;
  background: var(--accent-bg);
  color: var(--accent-dk);
  padding: 2px 6px;
  border-radius: 4px;
}

/* Links */
.doc a {
  color: var(--fg);
  text-decoration: none;
  border-bottom: 1px solid var(--border-md);
  transition: color var(--t), border-color var(--t);
}
.doc a:hover { color: var(--accent); border-bottom-color: var(--accent); }

/* ================================================
   CODE BLOCKS
   ================================================ */

.doc .code {
  position: relative;
  background: var(--dark);
  border: 1px solid rgba(255,255,255,.06);
  border-radius: var(--r-lg);
  margin: 18px 0;
  overflow: hidden;
}
.doc .code pre,
.doc .code > code,
.doc pre.code {
  display: block;
  margin: 0;
  padding: 22px 24px;
  overflow-x: auto;
  font-family: var(--mono);
  font-size: 13.5px;
  line-height: 1.78;
  color: #d4d4d4;
  background: transparent;
  tab-size: 2;
}
.doc .code code {
  background: none;
  color: #d4d4d4;
  padding: 0;
  font-size: 13.5px;
  border-radius: 0;
}
.doc .code .c-comment { color: #555; font-style: italic; }
.doc .code .c-str     { color: #89c18a; }
.doc .code .c-kw      { color: #dba96e; font-weight: 600; }

/* ================================================
   COPY BUTTON (docs.js injects this)
   ================================================ */

.code__copy {
  position: absolute;
  top: 10px;
  right: 10px;
  font-family: var(--mono);
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  border: 1px solid rgba(255,255,255,.12);
  background: rgba(255,255,255,.06);
  color: #888;
  padding: 4px 10px;
  border-radius: 5px;
  cursor: pointer;
  transition: background var(--t), color var(--t), border-color var(--t);
}
.code__copy:hover { background: var(--accent); color: #fff; border-color: var(--accent); }

/* ================================================
   CALLOUTS
   ================================================ */

.doc .callout {
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  background: var(--surface);
  padding: 14px 18px;
  border-radius: var(--r);
  margin: 20px 0;
  font-size: 14.5px;
  color: var(--fg-2);
  line-height: 1.65;
}
.doc .callout strong { color: var(--fg); font-weight: 600; }
.doc .callout a { color: var(--accent-dk); border-bottom-color: var(--accent-bg); }
.doc .callout a:hover { color: var(--accent); }

/* ================================================
   PARAMETER TABLES
   ================================================ */

.doc__params {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0;
  font-size: 14px;
  border: 1px solid var(--border);
  border-radius: var(--r);
  overflow: hidden;
}
.doc__params th, .doc__params td {
  text-align: left;
  padding: 10px 16px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
.doc__params tr:last-child td { border-bottom: none; }
.doc__params th {
  font-family: var(--mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--fg-3);
  background: var(--surface);
  font-weight: 600;
}
.doc__params td:first-child { font-family: var(--mono); font-size: 13px; }
.doc__params td:first-child code { background: none; padding: 0; color: var(--fg); }

/* ================================================
   NEXT/PREV NAVIGATION
   ================================================ */

.doc__next {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 56px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
}
.doc__next a {
  border: 1px solid var(--border);
  border-radius: var(--r);
  padding: 14px 20px;
  text-decoration: none;
  color: var(--fg);
  font-weight: 600;
  font-size: 15px;
  transition: box-shadow var(--t), border-color var(--t);
  min-width: 0;
  max-width: 48%;
}
.doc__next a:hover { box-shadow: var(--sh); border-color: var(--border-md); }
.doc__next span {
  display: block;
  font-family: var(--mono);
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--fg-4);
  font-weight: 500;
  margin-bottom: 4px;
}

/* ================================================
   IMAGES
   ================================================ */

.doc__img {
  max-width: 100%;
  height: auto;
  border-radius: var(--r);
  border: 1px solid var(--border);
  margin: 16px 0;
  display: block;
}

/* ================================================
   FEATURE GRID (docs home)
   ================================================ */

.docgrid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 1px;
  background: var(--border);
  border: 1px solid var(--border);
  border-radius: var(--r-lg);
  overflow: hidden;
  margin-top: 28px;
}
.docgrid a {
  background: var(--bg);
  padding: 22px 24px;
  text-decoration: none;
  color: var(--fg);
  border: none;
  transition: background var(--t);
}
.docgrid a:hover { background: var(--surface); border-color: transparent; }
.docgrid h3 { margin: 0 0 5px; font-size: 15.5px; font-weight: 700; letter-spacing: -0.01em; }
.docgrid p { margin: 0; font-size: 13.5px; color: var(--fg-3); line-height: 1.5; }

/* ================================================
   MOBILE SIDEBAR TOGGLE
   ================================================ */

.side__toggle { display: none; }

/* ================================================
   RESPONSIVE
   ================================================ */

@media (max-width: 820px) {
  .docshell { grid-template-columns: 1fr; gap: 0; padding: 0 20px; }

  .side {
    position: static;
    max-height: none;
    border-bottom: 1px solid var(--border);
    padding: 12px 0 20px;
    display: none;
    overflow: visible;
  }
  .side.is-open { display: block; }

  .side__toggle {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    margin: 20px 0 0;
    font-family: var(--mono);
    font-size: 13px;
    font-weight: 600;
    background: var(--surface);
    border: 1px solid var(--border-md);
    border-radius: var(--r);
    padding: 9px 14px;
    cursor: pointer;
    color: var(--fg);
    transition: background var(--t);
  }
  .side__toggle:hover { background: var(--subtle); }

  .docgrid { grid-template-columns: 1fr; }
  .doc { padding: 24px 0 64px; }
}

@media (max-width: 560px) {
  .doc__next { flex-direction: column; }
  .doc__next a { max-width: 100%; }
}