/* ============================================================
   Knowladex — docs page
   Reuses /styles.css for fonts, colors, and base reset.
   ============================================================ */

/* ===== Layout ===== */

.docs-shell {
  display: grid;
  grid-template-columns: 280px 1fr;
  max-width: 1240px;
  margin: 0 auto;
  gap: 64px;
  padding: 0 var(--gutter);
  position: relative;
  z-index: 1;
}
@media (max-width: 960px) {
  .docs-shell {
    grid-template-columns: 1fr;
    gap: 24px;
  }
}

/* ===== Top bar (mirrors marketing nav) ===== */

.docs-nav {
  position: sticky; top: 0; z-index: 10;
  background: rgba(10, 10, 11, 0.85);
  backdrop-filter: blur(12px); -webkit-backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--border);
}
.docs-nav__inner {
  max-width: 1240px; margin: 0 auto;
  padding: 18px var(--gutter);
  display: flex; align-items: center; justify-content: space-between;
  gap: 32px;
}
.docs-nav__brand {
  display: flex; align-items: center; gap: 10px;
  font-family: var(--font-display); font-size: 22px; letter-spacing: -0.01em;
}
.docs-nav__brand svg { width: 22px; height: 22px; fill: var(--accent); }
.docs-nav__brand-sub {
  font-family: var(--font-mono);
  font-size: 10px; text-transform: uppercase; letter-spacing: 0.12em;
  color: var(--ink-muted); padding: 2px 8px;
  border: 1px solid var(--border-strong); border-radius: 3px;
  margin-left: 4px;
}
.docs-nav__links {
  display: flex; gap: 28px; align-items: center;
  font-family: var(--font-mono); font-size: 12px;
  text-transform: uppercase; letter-spacing: 0.06em;
  color: var(--ink-dim);
}
.docs-nav__links a { transition: color 0.15s; }
.docs-nav__links a:hover { color: var(--ink); }
.docs-nav__cta {
  color: var(--accent) !important;
  border: 1px solid var(--accent-line);
  padding: 8px 14px; background: var(--accent-soft);
}
.docs-nav__cta:hover { background: var(--accent); color: var(--bg) !important; }
@media (max-width: 720px) {
  .docs-nav__links { gap: 16px; font-size: 11px; }
  .docs-nav__brand-sub { display: none; }
}

/* ===== Sidebar TOC ===== */

.docs-sidebar {
  padding: 56px 0 96px;
}
@media (min-width: 961px) {
  .docs-sidebar {
    position: sticky; top: 73px; align-self: start;
    max-height: calc(100vh - 73px);
    overflow-y: auto;
    scrollbar-width: thin;
  }
  .docs-sidebar::-webkit-scrollbar { width: 4px; }
  .docs-sidebar::-webkit-scrollbar-thumb { background: var(--border-strong); }
}
.docs-sidebar__intro {
  font-family: var(--font-mono); font-size: 10px;
  text-transform: uppercase; letter-spacing: 0.12em;
  color: var(--ink-muted);
  padding-bottom: 16px; border-bottom: 1px solid var(--border);
  margin-bottom: 20px;
}
.docs-toc {
  font-size: 13px; line-height: 1.7;
}
.docs-toc__group {
  margin-bottom: 24px;
}
.docs-toc__group-title {
  font-family: var(--font-mono); font-size: 9px;
  text-transform: uppercase; letter-spacing: 0.14em;
  color: var(--ink-muted);
  margin-bottom: 8px;
}
.docs-toc a {
  display: block; padding: 4px 0 4px 12px;
  color: var(--ink-dim);
  border-left: 1px solid var(--border);
  transition: color 0.15s, border-color 0.15s;
}
.docs-toc a:hover {
  color: var(--ink);
  border-left-color: var(--ink-muted);
}
.docs-toc a.active {
  color: var(--accent);
  border-left-color: var(--accent);
}

/* ===== Content ===== */

.docs-content {
  padding: 56px 0 160px;
  max-width: 760px;
  min-width: 0;
}
.docs-content > section {
  margin-bottom: 64px;
  scroll-margin-top: 100px;
}
.docs-content > section:target h2 {
  position: relative;
}
.docs-content > section:target h2::before {
  content: ''; position: absolute; left: -16px; top: 50%;
  width: 4px; height: 70%; transform: translateY(-50%);
  background: var(--accent);
}
.docs-content h1 {
  font-family: var(--font-display); font-size: clamp(40px, 6vw, 56px);
  letter-spacing: -0.02em; line-height: 1.05;
  margin: 0 0 8px;
}
.docs-content h1 em { font-style: italic; color: var(--accent); }
.docs-content > .docs-lede {
  font-size: 17px; color: var(--ink-dim); line-height: 1.65;
  max-width: 60ch; margin: 0 0 48px;
}
.docs-content h2 {
  font-family: var(--font-display); font-weight: 400;
  font-size: 32px; letter-spacing: -0.015em;
  margin: 0 0 8px;
  scroll-margin-top: 100px;
}
.docs-content h2 .num {
  font-family: var(--font-mono); font-size: 11px;
  color: var(--ink-muted); letter-spacing: 0.1em;
  text-transform: uppercase;
  display: block; margin-bottom: 6px;
  font-weight: 400;
}
.docs-content h3 {
  font-family: var(--font-sans); font-weight: 500;
  font-size: 18px; letter-spacing: -0.005em;
  margin: 32px 0 8px;
  scroll-margin-top: 100px;
}
.docs-content h4 {
  font-family: var(--font-sans); font-weight: 500;
  font-size: 14px; text-transform: uppercase; letter-spacing: 0.06em;
  color: var(--ink-dim);
  margin: 24px 0 8px;
}
.docs-content p {
  font-size: 15px; line-height: 1.7;
  color: var(--ink-dim);
  margin: 0 0 16px;
  max-width: 65ch;
}
.docs-content p strong { color: var(--ink); font-weight: 500; }
.docs-content p em { color: var(--accent); font-style: italic; }
.docs-content a:not(.docs-button) {
  color: var(--accent);
  border-bottom: 1px solid var(--accent-line);
  transition: border-color 0.15s;
}
.docs-content a:not(.docs-button):hover { border-bottom-color: var(--accent); }
.docs-content code {
  font-family: var(--font-mono); font-size: 0.88em;
  background: var(--bg-elev); color: var(--ink);
  padding: 1px 6px; border: 1px solid var(--border);
  border-radius: 3px;
}
.docs-content ul, .docs-content ol {
  margin: 0 0 16px; padding-left: 0;
  list-style: none;
}
.docs-content ul li, .docs-content ol li {
  font-size: 15px; line-height: 1.7;
  color: var(--ink-dim);
  position: relative;
  padding-left: 22px;
  margin-bottom: 6px;
}
.docs-content ul li::before {
  content: '·'; position: absolute; left: 8px;
  color: var(--accent); font-weight: 700;
}
.docs-content ol { counter-reset: docs-list; }
.docs-content ol li { counter-increment: docs-list; }
.docs-content ol li::before {
  content: counter(docs-list) '.';
  position: absolute; left: 0;
  font-family: var(--font-mono); font-size: 12px;
  color: var(--accent);
}

/* ===== Code blocks ===== */

.docs-content pre {
  background: var(--bg-elev); border: 1px solid var(--border);
  padding: 16px 20px; margin: 16px 0 24px;
  overflow-x: auto;
  font-family: var(--font-mono); font-size: 13px;
  line-height: 1.6; color: var(--ink);
}
.docs-content pre code {
  background: none; border: none; padding: 0;
  font-size: inherit; color: inherit;
}
.docs-content pre .kw   { color: var(--accent); }
.docs-content pre .ok   { color: var(--ok); }
.docs-content pre .com  { color: var(--ink-muted); font-style: italic; }
.docs-content pre .str  { color: #d8b48a; }

/* ===== Callouts ===== */

.callout {
  border-left: 2px solid var(--accent);
  background: var(--accent-soft);
  padding: 14px 18px;
  margin: 16px 0 24px;
  font-size: 14px;
  color: var(--ink-dim);
}
.callout strong { color: var(--ink); font-weight: 500; }
.callout--warn {
  border-left-color: #d8b48a;
  background: rgba(216, 180, 138, 0.06);
}

/* ===== Step list ===== */

.steps-list {
  display: grid;
  grid-template-columns: 1fr;
  gap: 12px;
  margin: 16px 0 24px;
}
.steps-list__item {
  display: grid;
  grid-template-columns: 36px 1fr;
  gap: 14px;
  padding: 14px 16px;
  background: var(--bg-elev);
  border: 1px solid var(--border);
}
.steps-list__num {
  font-family: var(--font-mono); font-size: 12px;
  color: var(--accent); padding-top: 2px;
}
.steps-list__body { font-size: 14px; line-height: 1.6; }
.steps-list__body strong { display: block; color: var(--ink); margin-bottom: 4px; font-weight: 500; }
.steps-list__body p { margin: 0; color: var(--ink-dim); font-size: 14px; }

/* ===== Tool reference cards ===== */

.tool {
  border: 1px solid var(--border);
  background: var(--bg-elev);
  margin: 16px 0;
  padding: 20px 22px;
  scroll-margin-top: 100px;
}
.tool__head {
  display: flex; align-items: center; flex-wrap: wrap;
  gap: 8px 12px; margin-bottom: 8px;
  padding-bottom: 12px; border-bottom: 1px solid var(--border);
}
.tool__name {
  font-family: var(--font-mono); font-size: 15px;
  color: var(--ink); font-weight: 500;
  margin: 0;
}
.tool__name a {
  color: inherit !important; border-bottom: none !important;
}
.tool__role {
  font-family: var(--font-mono); font-size: 9px;
  text-transform: uppercase; letter-spacing: 0.12em;
  padding: 3px 8px; border-radius: 100px;
  background: var(--accent-soft); color: var(--accent);
  border: 1px solid var(--accent-line);
}
.tool__role--reader { background: rgba(123, 216, 143, 0.06); color: var(--ok); border-color: rgba(123, 216, 143, 0.32); }
.tool__role--writer { background: var(--accent-soft); color: var(--accent); border-color: var(--accent-line); }
.tool__role--admin  { background: rgba(216, 180, 138, 0.06); color: #e8c89a; border-color: rgba(216, 180, 138, 0.32); }
.tool__desc {
  font-size: 14px; color: var(--ink-dim); line-height: 1.6;
  margin: 0 0 12px;
}
.tool__params {
  font-size: 13px;
}
.tool__param {
  display: grid;
  grid-template-columns: minmax(120px, max-content) 80px 1fr;
  gap: 12px;
  padding: 6px 0;
  border-bottom: 1px dashed var(--border);
}
.tool__param:last-child { border-bottom: none; }
.tool__param-name {
  font-family: var(--font-mono); color: var(--ink); font-size: 12px;
}
.tool__param-name .req {
  color: var(--accent); margin-left: 2px;
}
.tool__param-type {
  font-family: var(--font-mono); font-size: 11px;
  color: var(--ink-muted);
}
.tool__param-desc {
  color: var(--ink-dim); font-size: 13px; line-height: 1.5;
}
.tool__none {
  font-style: italic; color: var(--ink-muted); font-size: 13px;
}

/* ===== Permissions matrix ===== */

.matrix {
  width: 100%; border-collapse: collapse;
  font-size: 13px; margin: 16px 0;
}
.matrix th, .matrix td {
  text-align: left; padding: 8px 12px;
  border-bottom: 1px solid var(--border);
}
.matrix th {
  font-family: var(--font-mono); font-size: 10px;
  text-transform: uppercase; letter-spacing: 0.08em;
  color: var(--ink-muted); font-weight: 400;
}
.matrix td { color: var(--ink-dim); }
.matrix td:first-child {
  font-family: var(--font-mono); color: var(--ink); font-size: 12px;
}
.matrix .yes { color: var(--ok); }
.matrix .no  { color: var(--ink-muted); }

/* ===== FAQ ===== */

.faq details {
  border-bottom: 1px solid var(--border);
  padding: 16px 0;
}
.faq summary {
  list-style: none; cursor: pointer;
  font-size: 16px; color: var(--ink); font-weight: 500;
  display: flex; justify-content: space-between; align-items: center;
}
.faq summary::-webkit-details-marker { display: none; }
.faq summary::after {
  content: '+'; font-family: var(--font-mono); color: var(--accent);
  font-size: 18px;
}
.faq details[open] summary::after { content: '−'; }
.faq details > p {
  margin: 12px 0 0;
  font-size: 14px; color: var(--ink-dim); line-height: 1.65;
}

/* ===== Footer ===== */

.docs-foot {
  border-top: 1px solid var(--border);
  margin-top: 80px; padding-top: 32px;
  font-size: 12px; color: var(--ink-muted);
  display: flex; justify-content: space-between; flex-wrap: wrap;
  gap: 16px;
  font-family: var(--font-mono);
  text-transform: uppercase; letter-spacing: 0.06em;
}
.docs-foot a { color: var(--ink-dim); }
.docs-foot a:hover { color: var(--accent); }