/* sonik-docs.css
 * Docs site layout and typography for docs.sonik.audio
 * Requires sonik-tokens.css (loaded first via head.html).
 */

/* ============================================================
   Reset
   ============================================================ */

*, *::before, *::after { box-sizing: border-box; }

html {
  font-family: var(--sonik-font-sans);
  font-size: 16px;
  color: var(--sonik-text-primary);
  background: var(--sonik-bg-page);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

body { margin: 0; }

/* ============================================================
   Navigation
   ============================================================ */

.nav {
  position: sticky;
  top: 0;
  z-index: 100;
  height: var(--sonik-nav-height);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 2rem;
  background: var(--sonik-nav-bg);
  border-bottom: var(--sonik-nav-border);
}

.nav-logo {
  display: flex;
  align-items: center;
  gap: 10px;
  text-decoration: none;
  color: var(--sonik-text-primary);
}

.nav-wordmark {
  font-size: 18px;
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-tight);
}

.nav-links {
  display: flex;
  align-items: center;
  gap: 1.5rem;
  list-style: none;
  margin: 0;
  padding: 0;
}

.nav-links a {
  font-size: var(--sonik-text-sm);
  color: var(--sonik-nav-link-color);
  text-decoration: none;
}

.nav-links a:hover { color: var(--sonik-nav-link-hover); }

.nav-cta {
  display: inline-block;
  padding: var(--sonik-btn-padding);
  background: var(--sonik-btn-bg);
  color: var(--sonik-btn-text);
  font-size: var(--sonik-btn-font-size);
  font-weight: var(--sonik-btn-weight);
  border-radius: var(--sonik-btn-radius);
  text-decoration: none;
  transition: background 0.15s;
}

.nav-cta:hover { background: var(--sonik-btn-bg-hover); }

/* ============================================================
   Docs shell — sidebar + content grid
   ============================================================ */

.docs-shell {
  display: grid;
  grid-template-columns: 260px 1fr;
  min-height: calc(100vh - var(--sonik-nav-height) - 72px);
}

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

.docs-sidebar {
  position: sticky;
  top: var(--sonik-nav-height);
  height: calc(100vh - var(--sonik-nav-height));
  overflow-y: auto;
  border-right: var(--sonik-border);
  padding: 2rem 1rem 2rem 1.5rem;
}

.sidebar-nav {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.sidebar-item {
  display: block;
  font-size: var(--sonik-text-sm);
  color: var(--sonik-text-secondary);
  text-decoration: none;
  padding: 0.35rem 0.75rem;
  border-radius: var(--sonik-radius-sm);
  line-height: 1.4;
}

.sidebar-item:hover {
  color: var(--sonik-text-primary);
  background: var(--sonik-bg-surface);
}

.sidebar-item.is-active {
  color: var(--sonik-accent);
  background: var(--sonik-bg-surface);
  font-weight: var(--sonik-weight-medium);
}

.sidebar-group {
  margin-top: 0.5rem;
}

.sidebar-group-title {
  display: block;
  font-size: var(--sonik-text-xs);
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-wider);
  text-transform: uppercase;
  color: var(--sonik-text-secondary);
  padding: 0.5rem 0.75rem 0.25rem;
}

.sidebar-group-title.is-active { color: var(--sonik-accent); }

.sidebar-group ul {
  list-style: none;
  margin: 0;
  padding: 0;
}

/* ============================================================
   Main content
   ============================================================ */

.docs-main {
  min-width: 0;
  padding: 3.5rem 4rem 5rem 3rem;
}

.docs-article {
  max-width: 760px;
}

/* ============================================================
   Typography
   ============================================================ */

.docs-article h1 {
  font-size: 2rem;
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-tight);
  line-height: var(--sonik-leading-tight);
  margin: 0 0 1.75rem;
  color: var(--sonik-text-primary);
}

.docs-article h2 {
  font-size: var(--sonik-text-xl);
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-normal);
  margin: 3rem 0 0.75rem;
  padding-top: 2.5rem;
  border-top: var(--sonik-border);
  color: var(--sonik-text-primary);
}

.docs-article h1 + h2 {
  margin-top: 0;
  padding-top: 0;
  border-top: none;
}

.docs-article h3 {
  font-size: var(--sonik-text-lg);
  font-weight: var(--sonik-weight-medium);
  margin: 2rem 0 0.5rem;
  color: var(--sonik-text-primary);
}

.docs-article h4 {
  font-size: var(--sonik-text-base);
  font-weight: var(--sonik-weight-medium);
  margin: 1.5rem 0 0.4rem;
  color: var(--sonik-text-primary);
}

.docs-article p {
  font-size: var(--sonik-text-base);
  line-height: 1.75;
  margin: 0 0 1rem;
  color: var(--sonik-text-primary);
}

.docs-article a {
  color: var(--sonik-accent);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.docs-article a:hover { color: var(--sonik-accent-dark); }

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

.docs-article li {
  font-size: var(--sonik-text-base);
  line-height: 1.75;
  margin-bottom: 0.2rem;
}

.docs-article hr {
  border: none;
  border-top: var(--sonik-border);
  margin: 2.5rem 0;
}

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

.docs-article code {
  font-family: var(--sonik-font-mono);
  font-size: 0.84em;
  background: var(--sonik-bg-surface);
  color: var(--sonik-text-primary);
  padding: 0.15em 0.4em;
  border-radius: 4px;
  border: var(--sonik-border);
}

.docs-article pre {
  background: var(--sonik-bg-surface);
  border: var(--sonik-border);
  border-radius: var(--sonik-radius-md);
  padding: 1.25rem 1.5rem;
  overflow-x: auto;
  margin: 0 0 1.25rem;
}

.docs-article pre code {
  font-size: var(--sonik-text-sm);
  background: none;
  border: none;
  padding: 0;
}

/* ============================================================
   Tables
   ============================================================ */

.docs-article table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--sonik-text-sm);
  margin: 0 0 1.5rem;
  border: var(--sonik-border);
  border-radius: var(--sonik-radius-md);
  overflow: hidden;
}

.docs-article th {
  text-align: left;
  font-weight: var(--sonik-weight-medium);
  font-size: var(--sonik-text-xs);
  text-transform: uppercase;
  letter-spacing: var(--sonik-tracking-wide);
  color: var(--sonik-text-secondary);
  background: var(--sonik-bg-surface);
  padding: 0.6rem 1rem;
  border-bottom: var(--sonik-border);
}

.docs-article td {
  padding: 0.55rem 1rem;
  border-bottom: var(--sonik-border);
  color: var(--sonik-text-primary);
  line-height: 1.5;
}

.docs-article tr:last-child td { border-bottom: none; }

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

.callout {
  padding: 0.1rem 0 0.1rem 1.1rem;
  margin: 1.25rem 0;
  border-left: 1.5px solid var(--sonik-border-subtle);
}

.callout p {
  font-size: var(--sonik-text-sm);
  line-height: 1.65;
  color: var(--sonik-text-secondary);
  margin-bottom: 0.3rem;
}

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

.callout-label {
  display: flex;
  align-items: center;
  gap: 0.35rem;
  font-size: var(--sonik-text-xs);
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-wide);
  margin: 0 0 0.2rem;
  color: var(--sonik-text-secondary);
}

.callout-icon { flex-shrink: 0; }

.callout-note      { border-left-color: var(--sonik-accent); }
.callout-tip       { border-left-color: var(--sonik-text-secondary); }
.callout-important { border-left-color: var(--sonik-accent); }
.callout-warning   { border-left-color: #B8722E; }

/* ============================================================
   Footnotes
   ============================================================ */

.docs-article .footnotes {
  font-size: var(--sonik-text-sm);
  color: var(--sonik-text-secondary);
  margin-top: 3rem;
  padding-top: 1rem;
  border-top: var(--sonik-border);
}

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

.footer {
  background: var(--sonik-footer-bg);
  border-top: var(--sonik-footer-border);
  padding: 1.5rem 2rem;
  display: flex;
  align-items: center;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: 1rem;
}

.footer-logo {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--sonik-text-secondary);
}

.footer-wordmark {
  font-size: 15px;
  font-weight: var(--sonik-weight-medium);
  letter-spacing: var(--sonik-tracking-tight);
  color: var(--sonik-text-primary);
}

.footer-links { display: flex; gap: 1.5rem; flex-wrap: wrap; }

.footer-links a {
  font-size: var(--sonik-text-sm);
  color: var(--sonik-footer-text);
  text-decoration: none;
}

.footer-links a:hover { color: var(--sonik-text-primary); }

.footer-right { display: flex; flex-direction: column; align-items: flex-end; gap: 0.2rem; }

.footer-domain {
  font-size: 12px;
  font-family: var(--sonik-font-mono);
  color: var(--sonik-footer-domain);
}

.footer-copy { font-size: 12px; color: var(--sonik-footer-text); }

/* ============================================================
   Dark mode
   ============================================================ */


/* ============================================================
   Responsive
   ============================================================ */

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

  .docs-sidebar {
    position: static;
    height: auto;
    border-right: none;
    border-bottom: var(--sonik-border);
    padding: 1rem 1.5rem;
  }

  .docs-main {
    padding: 2rem 1.25rem 3rem;
  }

  .nav-links { display: none; }
}