/*
 * Docs pages — index + article styles
 * Matches design specs: docs-index-page-spec.html, docs-article-page-spec.html
 *
 * @package traffic-exchange-script
 */

/* =============================================
   DOCS INDEX PAGE
   ============================================= */

/* --- Hero --- */
.docs-hero {
  padding: 56px 0 48px;
  border-bottom: 1px solid var(--border-light);
}

.docs-hero-inner {
  display: grid;
  grid-template-columns: 1fr 380px;
  gap: 48px;
  align-items: center;
}

.docs-hero .hero-eyebrow {
  font-family: var(--font-mono);
  font-size: .68rem;
  font-weight: 600;
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--ink-faint);
  margin-bottom: 16px;
}

.docs-hero h1 {
  font-family: var(--font-serif);
  font-size: clamp(2rem, 3.5vw, 2.8rem);
  line-height: 1.12;
  letter-spacing: -.02em;
  margin-bottom: 12px;
}

.docs-hero h1 em { font-style: italic; color: var(--amber-mid); }

.docs-hero .hero-desc {
  font-size: .95rem;
  color: var(--ink-muted);
  line-height: 1.65;
  margin-bottom: 24px;
  max-width: 520px;
}

/* Search box */
.docs-search-box {
  display: flex;
  border: 1.5px solid var(--border);
  border-radius: 10px;
  overflow: hidden;
  background: #fff;
  transition: border-color .15s;
}

.docs-search-box:focus-within { border-color: var(--amber-light); }

.docs-search-box input {
  flex: 1;
  padding: 13px 18px;
  border: none;
  font-family: var(--font-sans);
  font-size: .9rem;
  color: var(--ink);
  outline: none;
  background: transparent;
}

.docs-search-box input::placeholder { color: var(--ink-faint); }

.docs-search-btn {
  padding: 13px 20px;
  background: var(--ink);
  color: var(--bg);
  border: none;
  font-family: var(--font-sans);
  font-size: .85rem;
  font-weight: 600;
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: 7px;
  transition: background .15s;
}

.docs-search-btn:hover { background: var(--ink-mid); }

/* Hero sidebar */
.docs-hero-sidebar {
  display: flex;
  flex-direction: column;
  gap: 20px;
}

.version-badge {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  background: var(--teal-bg);
  border: 1px solid var(--teal-border);
  color: var(--teal);
  font-family: var(--font-mono);
  font-size: .68rem;
  font-weight: 600;
  padding: 8px 14px;
  border-radius: 8px;
  width: fit-content;
}

.quick-links-label {
  font-family: var(--font-mono);
  font-size: .63rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .08em;
  color: var(--ink-faint);
  margin-bottom: 4px;
}

.quick-links {
  display: flex;
  flex-direction: column;
  gap: 6px;
}

.quick-link {
  font-size: .82rem;
  color: var(--amber-mid);
  text-decoration: none;
  display: flex;
  align-items: center;
  gap: 6px;
  font-weight: 500;
  transition: color .15s;
}

.quick-link:hover { color: var(--amber); }

.quick-link::before {
  content: '\2192';
  font-size: .75rem;
  color: var(--ink-faint);
}

/* --- Sidebar + Main Layout --- */
.docs-layout {
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: 48px;
  padding: 48px 0 72px;
}

.docs-sidebar {
  position: sticky;
  top: 80px;
  align-self: start;
}

.docs-sidebar-label {
  font-family: var(--font-mono);
  font-size: .63rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .08em;
  color: var(--ink-faint);
  margin-bottom: 12px;
  padding-left: 12px;
}

.docs-sidebar-nav { list-style: none; }

.docs-sidebar-nav li { margin-bottom: 2px; }

.docs-sidebar-link {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 9px 12px;
  font-size: .85rem;
  font-weight: 500;
  color: var(--ink-muted);
  text-decoration: none;
  border-radius: 8px;
  transition: color .15s, background .15s;
}

.docs-sidebar-link:hover {
  color: var(--ink);
  background: var(--bg-warm);
}

.docs-sidebar-link.active {
  color: var(--ink);
  background: var(--bg-warm);
  font-weight: 600;
}

.docs-sidebar-link .icon {
  width: 20px;
  text-align: center;
  font-size: .85rem;
  flex-shrink: 0;
}

.docs-sidebar-count {
  margin-left: auto;
  font-family: var(--font-mono);
  font-size: .65rem;
  font-weight: 600;
  color: var(--ink-faint);
  background: var(--bg-tinted);
  padding: 2px 8px;
  border-radius: 100px;
}

.docs-sidebar-divider {
  height: 1px;
  background: var(--border-light);
  margin: 12px 0;
}

/* --- Main content --- */
.docs-main { min-width: 0; }

/* Category section */
.docs-section-heading {
  display: flex;
  align-items: baseline;
  gap: 12px;
  margin-bottom: 20px;
  padding-bottom: 12px;
  border-bottom: 1px solid var(--border-light);
}

.docs-section-heading h2 {
  font-family: var(--font-serif);
  font-size: 1.5rem;
  letter-spacing: -.015em;
}

.docs-section-heading h2 em { font-style: italic; color: var(--amber-mid); }

.docs-section-count {
  font-family: var(--font-mono);
  font-size: .68rem;
  font-weight: 600;
  color: var(--ink-faint);
}

.docs-category-section { margin-bottom: 48px; }
.docs-category-section:last-child { margin-bottom: 0; }

.docs-category-desc {
  font-size: .9rem;
  color: var(--ink-muted);
  line-height: 1.6;
  margin-bottom: 20px;
  max-width: 640px;
}

/* Article card list */
.docs-article-list { display: flex; flex-direction: column; gap: 8px; }

.docs-article-card {
  display: grid;
  grid-template-columns: 36px 1fr auto;
  align-items: center;
  gap: 14px;
  padding: 14px 18px;
  background: #fff;
  border: 1px solid var(--border-light);
  border-radius: 10px;
  text-decoration: none;
  transition: border-color .15s, box-shadow .15s;
}

.docs-article-card:hover {
  border-color: var(--border);
  box-shadow: 0 2px 8px rgba(28,25,23,0.04);
}

.docs-article-icon {
  width: 36px; height: 36px;
  background: var(--bg-warm);
  border: 1px solid var(--border-light);
  border-radius: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: .9rem;
  flex-shrink: 0;
}

.docs-article-info { min-width: 0; }

.docs-article-title {
  font-size: .875rem;
  font-weight: 600;
  color: var(--ink);
  margin-bottom: 2px;
}

.docs-article-desc {
  font-size: .78rem;
  color: var(--ink-muted);
  line-height: 1.45;
  display: -webkit-box;
  -webkit-line-clamp: 1;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

.docs-article-meta {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-shrink: 0;
}

.docs-category-tag {
  font-family: var(--font-mono);
  font-size: .6rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .06em;
  padding: 3px 10px;
  border-radius: 100px;
  white-space: nowrap;
}

.tag-installation { background: var(--teal-bg); color: var(--teal); border: 1px solid var(--teal-border); }
.tag-configuration { background: var(--blue-bg); color: var(--blue); }
.tag-licensing { background: var(--amber-bg); color: var(--amber); border: 1px solid var(--amber-border); }
.tag-troubleshooting { background: #FEF2F2; color: #991B1B; }
.tag-advanced { background: var(--bg-warm); color: var(--ink-mid); border: 1px solid var(--border); }

.docs-article-arrow {
  color: var(--ink-faint);
  font-size: .85rem;
  transition: transform .15s;
}

.docs-article-card:hover .docs-article-arrow { transform: translateX(3px); color: var(--amber-mid); }

/* Env reference banner */
.docs-env-banner {
  background: var(--bg-warm);
  border: 1px solid var(--border);
  border-radius: 12px;
  padding: 28px 32px;
  display: grid;
  grid-template-columns: 1fr auto;
  gap: 24px;
  align-items: center;
  margin-top: 32px;
}

.docs-env-banner h3 {
  font-family: var(--font-serif);
  font-size: 1.15rem;
  margin-bottom: 4px;
}

.docs-env-banner h3 em { font-style: italic; color: var(--amber-mid); }

.docs-env-banner p {
  font-size: .85rem;
  color: var(--ink-muted);
  line-height: 1.55;
}

.btn-outline {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 10px 22px;
  border: 1px solid var(--border);
  border-radius: 8px;
  font-size: .85rem;
  font-weight: 500;
  color: var(--ink-mid);
  text-decoration: none;
  white-space: nowrap;
  transition: border-color .15s, background .15s;
}

.btn-outline:hover { background: var(--bg-tinted); border-color: var(--ink-faint); }

/* Support band */
.docs-support-band {
  background: var(--bg-warm);
  border-top: 1px solid var(--border-light);
  padding: 56px 0;
  text-align: center;
}

.docs-support-band h2 {
  font-family: var(--font-serif);
  font-size: clamp(1.5rem, 2.5vw, 2rem);
  margin-bottom: 8px;
  letter-spacing: -.015em;
}

.docs-support-band h2 em { font-style: italic; color: var(--amber-mid); }

.docs-support-band p {
  font-size: .9rem;
  color: var(--ink-muted);
  margin-bottom: 24px;
}

.docs-support-actions {
  display: flex;
  justify-content: center;
  gap: 12px;
  flex-wrap: wrap;
}

.btn-support {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  padding: 11px 22px;
  border-radius: 8px;
  font-size: .875rem;
  font-weight: 500;
  text-decoration: none;
  border: 1px solid var(--border);
  color: var(--ink-mid);
  background: var(--bg);
  transition: border-color .15s, background .15s;
}

.btn-support:hover { background: var(--bg-tinted); border-color: var(--ink-faint); }


/* =============================================
   DOC ARTICLE PAGE
   ============================================= */

/* --- Breadcrumb --- */
.docs-breadcrumb-bar {
  border-bottom: 1px solid var(--border-light);
  padding: 12px 0;
}

.docs-breadcrumb-inner {
  max-width: 1160px;
  margin: 0 auto;
  padding: 0 40px;
  display: flex;
  align-items: center;
  gap: 8px;
  font-size: .8rem;
}

.docs-breadcrumb-inner a {
  color: var(--ink-muted);
  text-decoration: none;
  transition: color .15s;
}

.docs-breadcrumb-inner a:hover { color: var(--ink); }

.docs-breadcrumb-sep {
  color: var(--ink-faint);
  font-size: .7rem;
}

.docs-breadcrumb-current {
  color: var(--ink);
  font-weight: 600;
}

/* --- Article layout --- */
.docs-article-layout {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 48px;
  max-width: 1160px;
  margin: 0 auto;
  padding: 40px 40px 80px;
}

/* --- TOC sidebar --- */
.docs-toc-sidebar {
  position: sticky;
  top: 90px;
  align-self: start;
  max-height: calc(100vh - 110px);
  overflow-y: auto;
}

.docs-toc-label {
  font-family: var(--font-mono);
  font-size: .6rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .1em;
  color: var(--ink-faint);
  margin-bottom: 14px;
  padding-left: 12px;
}

.docs-toc { list-style: none; }

.docs-toc li { margin-bottom: 1px; }

.docs-toc a {
  display: block;
  padding: 6px 12px;
  font-size: .8rem;
  color: var(--ink-muted);
  text-decoration: none;
  border-radius: 6px;
  border-left: 2px solid transparent;
  transition: color .15s, background .15s, border-color .15s;
  line-height: 1.4;
}

.docs-toc a:hover {
  color: var(--ink);
  background: var(--bg-warm);
}

.docs-toc a.active {
  color: var(--ink);
  font-weight: 600;
  border-left-color: var(--amber-light);
  background: var(--amber-bg);
}

.docs-toc .toc-sub {
  padding-left: 24px;
  font-size: .76rem;
}

.docs-toc-divider {
  height: 1px;
  background: var(--border-light);
  margin: 12px 12px;
}

.docs-toc-back {
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 8px 12px;
  font-size: .78rem;
  color: var(--amber-mid);
  text-decoration: none;
  font-weight: 500;
  transition: color .15s;
}

.docs-toc-back:hover { color: var(--amber); }

/* --- Article content --- */
.docs-article-content {
  min-width: 0;
  max-width: 760px;
}

.docs-article-header { margin-bottom: 40px; }

.docs-article-category-tag {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-family: var(--font-mono);
  font-size: .65rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .06em;
  padding: 4px 12px;
  border-radius: 100px;
  margin-bottom: 16px;
}

.docs-article-header h1 {
  font-family: var(--font-serif);
  font-size: clamp(1.8rem, 3vw, 2.4rem);
  line-height: 1.15;
  letter-spacing: -.02em;
  margin-bottom: 12px;
}

.docs-article-header h1 em { font-style: italic; color: var(--amber-mid); }

.docs-article-meta-bar {
  display: flex;
  align-items: center;
  gap: 16px;
  font-size: .8rem;
  color: var(--ink-muted);
  padding-bottom: 20px;
  border-bottom: 1px solid var(--border-light);
}

.docs-meta-sep {
  width: 3px; height: 3px;
  background: var(--border);
  border-radius: 50%;
}

.docs-reading-time {
  font-family: var(--font-mono);
  font-size: .7rem;
  font-weight: 600;
  color: var(--ink-faint);
}

/* --- Article body typography --- */
.docs-article-body h2 {
  font-family: var(--font-serif);
  font-size: 1.55rem;
  line-height: 1.2;
  letter-spacing: -.015em;
  margin: 48px 0 16px;
  padding-top: 16px;
  border-top: 1px solid var(--border-light);
}

.docs-article-body h2 em { font-style: italic; color: var(--amber-mid); }
.docs-article-body h2:first-child { margin-top: 0; border-top: none; padding-top: 0; }

.docs-article-body h3 {
  font-family: var(--font-sans);
  font-size: 1.05rem;
  font-weight: 600;
  margin: 32px 0 12px;
  color: var(--ink);
}

.docs-article-body p {
  font-size: .925rem;
  line-height: 1.72;
  color: var(--ink-mid);
  margin-bottom: 16px;
}

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

.docs-article-body a:hover { color: var(--amber); }

.docs-article-body ul,
.docs-article-body ol {
  padding-left: 24px;
  margin-bottom: 16px;
}

.docs-article-body li {
  font-size: .925rem;
  line-height: 1.72;
  color: var(--ink-mid);
  margin-bottom: 6px;
}

.docs-article-body strong { color: var(--ink); font-weight: 600; }

/* Inline code */
.docs-article-body code {
  font-family: var(--font-mono);
  font-size: .82rem;
  background: var(--bg-warm);
  border: 1px solid var(--border-light);
  padding: 1px 6px;
  border-radius: 4px;
  color: var(--amber);
}

/* Code blocks */
.docs-article-body pre {
  position: relative;
  margin: 20px 0 24px;
  border-radius: 10px;
  overflow: hidden;
  border: 1px solid rgba(28,25,23,0.12);
  background: #1C1917;
  padding: 18px 20px;
  overflow-x: auto;
}

.docs-article-body pre code {
  font-family: var(--font-mono);
  font-size: .82rem;
  line-height: 1.7;
  color: #E7E5E4;
  background: none;
  border: none;
  padding: 0;
  border-radius: 0;
}

/* Styled code block with header */
.code-block {
  position: relative;
  margin: 20px 0 24px;
  border-radius: 10px;
  overflow: hidden;
  border: 1px solid rgba(28,25,23,0.12);
}

.code-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 8px 16px;
  background: #2D2926;
  border-bottom: 1px solid rgba(250,249,246,0.08);
}

.code-lang {
  font-family: var(--font-mono);
  font-size: .65rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .08em;
  color: rgba(250,249,246,0.45);
}

.code-copy {
  font-family: var(--font-mono);
  font-size: .65rem;
  font-weight: 600;
  color: rgba(250,249,246,0.35);
  background: none;
  border: 1px solid rgba(250,249,246,0.12);
  padding: 3px 10px;
  border-radius: 4px;
  cursor: pointer;
  transition: color .15s, border-color .15s;
}

.code-copy:hover {
  color: rgba(250,249,246,0.7);
  border-color: rgba(250,249,246,0.25);
}

.code-block pre {
  background: #1C1917;
  padding: 18px 20px;
  overflow-x: auto;
  margin: 0;
  border: none;
  border-radius: 0;
}

.code-block pre code {
  font-family: var(--font-mono);
  font-size: .82rem;
  line-height: 1.7;
  color: #E7E5E4;
  background: none;
  border: none;
  padding: 0;
  border-radius: 0;
}

/* Syntax highlight tokens */
.code-comment { color: #78716C; }
.code-string { color: #A3E635; }
.code-keyword { color: #F472B6; }
.code-var { color: #67E8F9; }

/* Callouts */
.docs-callout {
  display: flex;
  gap: 14px;
  padding: 16px 20px;
  border-radius: 10px;
  margin: 20px 0 24px;
  font-size: .875rem;
  line-height: 1.6;
}

.docs-callout-info {
  background: var(--blue-bg);
  border: 1px solid #BFDBFE;
  color: var(--ink-mid);
}

.docs-callout-warning {
  background: var(--amber-bg);
  border: 1px solid var(--amber-border);
  color: var(--ink-mid);
}

.docs-callout-success {
  background: var(--green-bg);
  border: 1px solid var(--green-border);
  color: var(--ink-mid);
}

.docs-callout-icon {
  font-size: 1.1rem;
  flex-shrink: 0;
  margin-top: 1px;
}

.docs-callout p { margin-bottom: 0; color: var(--ink-mid); }
.docs-callout strong { color: var(--ink); }

/* Tables */
.docs-article-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 20px 0 24px;
  font-size: .875rem;
}

.docs-article-body th,
.docs-article-body td {
  padding: 10px 14px;
  text-align: left;
  border-bottom: 1px solid var(--border-light);
  color: var(--ink-mid);
}

.docs-article-body th {
  font-weight: 600;
  color: var(--ink);
  background: var(--bg-warm);
  font-size: .8rem;
}

.docs-article-body tr:hover td {
  background: var(--bg-warm);
}

/* Blockquotes (for callout-style notes) */
.docs-article-body blockquote {
  display: flex;
  gap: 14px;
  padding: 16px 20px;
  border-radius: 10px;
  margin: 20px 0 24px;
  font-size: .875rem;
  line-height: 1.6;
  background: var(--blue-bg);
  border: 1px solid #BFDBFE;
  color: var(--ink-mid);
  border-left: 4px solid var(--blue);
}

.docs-article-body blockquote p { margin-bottom: 0; color: var(--ink-mid); font-size: .875rem; }
.docs-article-body blockquote strong { color: var(--ink); }

/* --- Prev/Next navigation --- */
.docs-article-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 16px;
  margin-top: 56px;
  padding-top: 32px;
  border-top: 1px solid var(--border-light);
}

.docs-nav-link {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: 18px 22px;
  background: #fff;
  border: 1px solid var(--border-light);
  border-radius: 10px;
  text-decoration: none;
  transition: border-color .15s, box-shadow .15s;
}

.docs-nav-link:hover {
  border-color: var(--border);
  box-shadow: 0 2px 8px rgba(28,25,23,0.04);
}

.docs-nav-link-label {
  font-family: var(--font-mono);
  font-size: .63rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: .08em;
  color: var(--ink-faint);
}

.docs-nav-link-title {
  font-size: .9rem;
  font-weight: 600;
  color: var(--ink);
}

.docs-nav-link-next { text-align: right; }
.docs-nav-link-next .docs-nav-link-label::after { content: ' \2192'; }
.docs-nav-link-prev .docs-nav-link-label::before { content: '\2190 '; }


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

/* --- Index page --- */
@media (max-width: 960px) {
  .docs-hero-inner { grid-template-columns: 1fr; }
  .docs-hero-sidebar { display: none; }
  .docs-layout { grid-template-columns: 1fr; }
  .docs-sidebar { position: static; }
  .docs-sidebar-nav {
    display: flex; flex-wrap: wrap; gap: 4px;
  }
  .docs-sidebar-nav li { margin-bottom: 0; }
}

/* --- Article page --- */
@media (max-width: 960px) {
  .docs-article-layout {
    grid-template-columns: 1fr;
    padding: 24px 40px 60px;
  }
  .docs-toc-sidebar {
    position: static;
    max-height: none;
    border-bottom: 1px solid var(--border-light);
    padding-bottom: 20px;
    margin-bottom: 8px;
  }
  .docs-toc {
    display: flex;
    flex-wrap: wrap;
    gap: 4px;
  }
  .docs-toc li { margin-bottom: 0; }
  .docs-toc a { border-left: none; padding: 5px 10px; }
  .docs-toc .toc-sub { display: none; }
}

/* --- Mobile --- */
@media (max-width: 600px) {
  .docs-breadcrumb-inner { padding-left: 20px; padding-right: 20px; }
  .docs-article-layout { padding-left: 20px; padding-right: 20px; }
  .docs-article-nav { grid-template-columns: 1fr; }
  .docs-article-header h1 { font-size: 1.6rem; }
  .docs-env-banner { grid-template-columns: 1fr; }
  .docs-article-card { grid-template-columns: 1fr; }
  .docs-article-meta { display: none; }
}