/* ============================================================
   ZYM Documentation — Shared Styles
   ============================================================ */

*, *::before, *::after {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

:root {
  --bg: #1B1D1F;
  --bg-raised: #1C1F21;
  --bg-subtle: #2A2D30;
  --text: #D4D4D4;
  --text-dim: #8B8F94;
  --text-bright: #E8E8E8;
  --accent: #D19A2A;
  --accent-dim: #A87C22;
  --font-sans: 'IBM Plex Sans', sans-serif;
  --font-mono: 'IBM Plex Mono', monospace;
  --sidebar-width: 240px;
  --toc-width: 220px;
}

html {
  font-size: 16px;
  scroll-behavior: smooth;
  scroll-padding-top: 5rem; /* Offset for fixed header */
}

body {
  background-color: var(--bg);
  color: var(--text);
  font-family: var(--font-sans);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  position: relative;
}

body::before {
  content: "";
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  z-index: 0;
  pointer-events: none;
  background-image:
    linear-gradient(rgba(255, 255, 255, 0.007) 1px, transparent 1px),
    linear-gradient(90deg, rgba(255, 255, 255, 0.007) 1px, transparent 1px);
  background-size: 40px 40px;
}

body > * {
  position: relative;
  z-index: 1;
}

a {
  color: var(--accent);
  text-decoration: none;
}

a:hover {
  color: var(--text-bright);
}

::selection {
  background: var(--accent);
  color: var(--bg);
}

/* ---- Navigation ---- */

nav {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  z-index: 100;
  background-color: var(--bg);
  border-bottom: 1px solid var(--bg-subtle);
}

.nav-inner {
  max-width: 1400px;
  margin: 0 auto;
  padding: 0.75rem 1.5rem;
  display: flex;
  align-items: center;
  justify-content: space-between;
}

.nav-logo {
  font-family: var(--font-mono);
  font-weight: 500;
  font-size: 1rem;
  color: var(--text-bright);
  letter-spacing: 0.15em;
  transition: color 0.3s;
}

.nav-logo:hover {
  color: var(--accent);
}

.nav-links {
  display: flex;
  gap: 1.5rem;
  list-style: none;
}

.nav-links a {
  font-family: var(--font-mono);
  font-size: 0.8rem;
  color: var(--text-dim);
  letter-spacing: 0.05em;
  transition: color 0.25s;
}

.nav-links a:hover,
.nav-links a.active {
  color: var(--accent);
}

/* ---- Docs Layout ---- */

.docs-layout {
  display: flex;
  max-width: 1400px;
  margin: 0 auto;
  padding-top: 4rem;
  min-height: 100vh;
}

/* ---- Sidebar ---- */

.sidebar {
  width: var(--sidebar-width);
  flex-shrink: 0;
  padding: 1.5rem 1rem 2rem 1.5rem;
  position: sticky;
  top: 4rem;
  height: calc(100vh - 4rem);
  overflow-y: auto;
  border-right: 1px solid var(--bg-subtle);
}

.sidebar-section {
  margin-bottom: 1.25rem;
}

.sidebar-heading {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 500;
  color: var(--text-dim);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 0.4rem;
}

.sidebar-list {
  list-style: none;
}

.sidebar-list li {
  margin-bottom: 0.15rem;
}

.sidebar-list a {
  font-family: var(--font-sans);
  font-size: 0.85rem;
  color: var(--text);
  display: block;
  padding: 0.2rem 0.5rem;
  border-left: 2px solid transparent;
  transition: color 0.2s, border-color 0.2s;
}

.sidebar-list a:hover {
  color: var(--accent);
  border-left-color: var(--accent-dim);
}

.sidebar-list a.active {
  color: var(--accent);
  border-left-color: var(--accent);
}

/* ---- Main Content ---- */

.docs-content {
  flex: 1;
  min-width: 0;
  padding: 1.5rem 1.5rem 3rem 2rem;
}

.docs-content h1 {
  font-family: var(--font-mono);
  font-size: 1.75rem;
  font-weight: 500;
  color: var(--text-bright);
  letter-spacing: 0.1em;
  margin-bottom: 0.5rem;
}

.docs-content h2 {
  font-family: var(--font-sans);
  font-size: 1.1rem;
  font-weight: 600;
  color: var(--text-bright);
  margin-top: 2rem;
  margin-bottom: 0.6rem;
  letter-spacing: 0.02em;
  display: inline-block;
  padding-bottom: 0.15rem;
  border-bottom: 1px solid var(--accent-dim);
}

.docs-content h3 {
  font-family: var(--font-mono);
  font-size: 0.9rem;
  font-weight: 500;
  color: var(--accent);
  margin-top: 1.5rem;
  margin-bottom: 0.35rem;
}

.docs-content h4 {
  font-family: var(--font-sans);
  font-size: 0.85rem;
  font-weight: 600;
  color: var(--text-bright);
  margin-top: 1rem;
  margin-bottom: 0.25rem;
}

.docs-content p {
  margin-bottom: 0.75rem;
  color: var(--text);
  font-size: 0.9rem;
  line-height: 1.65;
}

.docs-content .lead {
  font-size: 0.95rem;
  color: var(--text-dim);
  margin-bottom: 1.5rem;
  max-width: 600px;
}

.docs-content ul,
.docs-content ol {
  margin-bottom: 0.75rem;
  padding-left: 1.25rem;
}

.docs-content li {
  font-size: 0.9rem;
  line-height: 1.6;
  margin-bottom: 0.2rem;
}

.docs-content code {
  font-family: var(--font-mono);
  font-size: 0.82rem;
  color: var(--accent);
  background: rgba(209, 154, 42, 0.08);
  padding: 0.1rem 0.3rem;
  border-radius: 2px;
}

.docs-content strong {
  color: var(--text-bright);
  font-weight: 600;
}

.docs-content hr {
  border: none;
  border-top: 1px solid var(--bg-subtle);
  margin: 2rem 0;
}

/* ---- Code Blocks ---- */

.code-block {
  background-color: var(--bg-raised);
  border: 1px solid var(--bg-subtle);
  border-left: 2px solid var(--accent-dim);
  padding: 0.85rem 1rem;
  margin: 0.75rem 0;
  overflow-x: auto;
}

.code-block:hover {
  border-left-color: var(--accent);
}

.code-block pre {
  font-family: var(--font-mono);
  font-size: 0.8rem;
  color: var(--text);
  line-height: 1.45;
  margin: 0;
  white-space: pre;
}

.code-block .code-label {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--text-dim);
  margin-bottom: 0.5rem;
  letter-spacing: 0.05em;
}

.code-comment { color: var(--text-dim); }
.code-keyword { color: var(--accent); }
.code-string  { color: #8FBF7F; }
.code-number  { color: #C0A0D0; }

/* ---- API Function Signatures ---- */

.api-sig {
  font-family: var(--font-mono);
  font-size: 0.85rem;
  color: var(--text-bright);
  background-color: var(--bg-raised);
  border: 1px solid var(--bg-subtle);
  border-left: 2px solid var(--accent);
  padding: 0.5rem 0.85rem;
  margin-top: 1.5rem;
  margin-bottom: 0.5rem;
}

/* ---- API Tables ---- */

.api-table {
  margin: 0.75rem 0;
  overflow-x: auto;
}

.api-table table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.85rem;
}

.api-table th {
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 500;
  color: var(--text-dim);
  text-align: left;
  padding: 0.4rem 0.75rem;
  border-bottom: 1px solid var(--bg-subtle);
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.api-table td {
  padding: 0.35rem 0.75rem;
  border-bottom: 1px solid var(--bg-subtle);
  color: var(--text);
  vertical-align: top;
}

.api-table td code {
  background: none;
  padding: 0;
}

.api-table tr:last-child td {
  border-bottom: none;
}

/* ---- Param Lists ---- */

.param-list {
  list-style: none;
  padding-left: 0;
  margin: 0.5rem 0 0.75rem;
}

.param-list li {
  font-size: 0.85rem;
  padding-left: 1rem;
  position: relative;
  margin-bottom: 0.2rem;
}

.param-list li::before {
  content: "›";
  position: absolute;
  left: 0;
  color: var(--accent);
}

/* ---- Doc Card Grid (overview page) ---- */

.doc-cards {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  margin-top: 1rem;
}

.doc-card {
  padding: 1rem;
  background-color: var(--bg-raised);
  border: 1px solid var(--bg-subtle);
  transition: border-color 0.3s, transform 0.3s;
  display: block;
}

.doc-card:hover {
  border-color: var(--accent-dim);
  transform: translateY(-2px);
  color: var(--text);
}

.doc-card h3 {
  font-family: var(--font-mono);
  font-size: 0.9rem;
  font-weight: 500;
  color: var(--accent);
  margin-top: 0;
  margin-bottom: 0.3rem;
}

.doc-card p {
  font-size: 0.825rem;
  color: var(--text-dim);
  margin-bottom: 0;
  line-height: 1.5;
}

/* ---- Note / Callout Boxes ---- */

.note {
  background-color: var(--bg-raised);
  border: 1px solid var(--bg-subtle);
  border-left: 2px solid var(--accent);
  padding: 0.65rem 1rem;
  margin: 0.75rem 0;
  font-size: 0.85rem;
  color: var(--text-dim);
}

.note strong {
  color: var(--accent);
}

/* ---- Hamburger Button ---- */

.nav-hamburger {
  display: none;
  background: none;
  border: none;
  cursor: pointer;
  padding: 0.5rem;
  margin-right: -0.5rem;
  -webkit-tap-highlight-color: transparent;
}

.nav-hamburger span {
  display: block;
  width: 20px;
  height: 2px;
  background: var(--text);
  margin: 4px 0;
  transition: transform 0.25s, opacity 0.25s;
}

.nav-hamburger.active span:nth-child(1) {
  transform: translateY(6px) rotate(45deg);
}

.nav-hamburger.active span:nth-child(2) {
  opacity: 0;
}

.nav-hamburger.active span:nth-child(3) {
  transform: translateY(-6px) rotate(-45deg);
}

/* ---- Sidebar Toggle (mobile) ---- */

.sidebar-toggle {
  display: none;
  font-family: var(--font-mono);
  font-size: 0.8rem;
  color: var(--accent);
  background: var(--bg-raised);
  border: 1px solid var(--bg-subtle);
  padding: 0.6rem 1rem;
  cursor: pointer;
  width: 100%;
  text-align: left;
  letter-spacing: 0.05em;
  -webkit-tap-highlight-color: transparent;
}

.sidebar-toggle:hover {
  border-color: var(--accent-dim);
}

/* ---- Footer ---- */

footer {
  max-width: 1400px;
  margin: 0 auto;
  padding: 1.25rem 1.5rem;
  border-top: 1px solid var(--bg-subtle);
  text-align: center;
}

footer p {
  font-family: var(--font-mono);
  font-size: 0.75rem;
  color: var(--text-dim);
  margin-bottom: 0;
}

/* ---- Table of Contents (Right Sidebar) ---- */

.toc-sidebar {
  width: var(--toc-width);
  flex-shrink: 0;
  padding: 1.5rem 1.5rem 2rem 1rem;
  position: sticky;
  top: 4rem;
  height: calc(100vh - 4rem);
  overflow-y: auto;
  border-left: 1px solid var(--bg-subtle);
}

.toc-heading {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 500;
  color: var(--text-dim);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 0.6rem;
}

.toc-list {
  list-style: none;
}

.toc-list li {
  margin-bottom: 0.3rem;
}

.toc-list a {
  font-family: var(--font-sans);
  font-size: 0.8rem;
  color: var(--text-dim);
  display: block;
  padding: 0.2rem 0.5rem;
  border-left: 2px solid transparent;
  transition: color 0.2s, border-color 0.2s;
  line-height: 1.4;
}

.toc-list a:hover {
  color: var(--text-bright);
  border-left-color: var(--accent-dim);
}

.toc-list a.active {
  color: var(--accent);
  border-left-color: var(--accent);
}

/* Sub-sections in TOC */
.toc-list .toc-subsection {
  margin-left: 0.75rem;
  font-size: 0.75rem;
  padding: 0.15rem 0.5rem;
}

/* ---- Responsive ---- */

@media (max-width: 1200px) {
  .toc-sidebar {
    display: none;
  }
}

@media (max-width: 768px) {
  .nav-hamburger {
    display: block;
  }

  .nav-links {
    display: none;
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    flex-direction: column;
    background-color: var(--bg);
    border-bottom: 1px solid var(--bg-subtle);
    padding: 0.5rem 0;
  }

  .nav-links.open {
    display: flex;
  }

  .nav-links li {
    width: 100%;
  }

  .nav-links a {
    display: block;
    padding: 0.75rem 1.5rem;
    font-size: 0.9rem;
  }

  .nav-links a:hover {
    background-color: var(--bg-raised);
  }

  .docs-layout {
    flex-direction: column;
  }

  .sidebar {
    width: 100%;
    position: relative;
    top: 0;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--bg-subtle);
    padding: 0;
    overflow: visible;
  }

  .sidebar-toggle {
    display: block;
  }

  .sidebar-inner {
    display: none;
    padding: 0.75rem 1.5rem 1rem;
  }

  .sidebar-inner.open {
    display: block;
  }

  .sidebar-section {
    margin-bottom: 0.75rem;
  }

  .sidebar-list a {
    padding: 0.5rem 0.75rem;
    border-left: 2px solid transparent;
    font-size: 0.9rem;
  }

  .docs-content {
    padding: 1.25rem 1rem 2rem;
  }

  .docs-content h1 {
    font-size: 1.4rem;
  }

  .doc-cards {
    grid-template-columns: 1fr;
  }

  .toc-sidebar {
    display: none;
  }

  .code-block {
    margin-left: -0.25rem;
    margin-right: -0.25rem;
    padding: 0.75rem;
  }

  .code-block pre {
    font-size: 0.75rem;
  }

  .api-sig {
    font-size: 0.8rem;
    padding: 0.5rem 0.75rem;
  }

  .api-table table {
    font-size: 0.8rem;
  }

  .api-table th,
  .api-table td {
    padding: 0.35rem 0.5rem;
  }
}

/* ---- Floating TOC Button & Panel (mobile) ---- */

.toc-fab {
  display: none;
  position: fixed;
  bottom: 1.25rem;
  right: 1.25rem;
  z-index: 90;
  font-family: var(--font-mono);
  font-size: 0.75rem;
  color: var(--bg);
  background: var(--accent);
  border: none;
  padding: 0.5rem 0.85rem;
  cursor: pointer;
  letter-spacing: 0.05em;
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.4);
  transition: background 0.2s, transform 0.15s;
  -webkit-tap-highlight-color: transparent;
}

.toc-fab:hover {
  background: var(--text-bright);
}

.toc-fab:active {
  transform: scale(0.95);
}

.toc-mobile-panel {
  display: none;
  position: fixed;
  bottom: 3.75rem;
  right: 1.25rem;
  z-index: 90;
  width: 220px;
  max-height: 60vh;
  overflow-y: auto;
  background-color: var(--bg);
  border: 1px solid var(--bg-subtle);
  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.5);
  padding: 0.75rem 0;
}

.toc-mobile-panel.open {
  display: block;
}

.toc-mobile-panel a {
  display: block;
  font-family: var(--font-sans);
  font-size: 0.82rem;
  color: var(--text);
  padding: 0.45rem 1rem;
  border-left: 2px solid transparent;
  transition: color 0.2s, border-color 0.2s, background 0.15s;
  text-decoration: none;
}

.toc-mobile-panel a:hover {
  color: var(--accent);
  border-left-color: var(--accent-dim);
  background-color: var(--bg-raised);
}

@media (max-width: 1200px) {
  .toc-fab {
    display: block;
  }
}

@media (max-width: 400px) {
  .docs-content {
    padding: 1rem 0.75rem 2rem;
  }

  .docs-content h1 {
    font-size: 1.25rem;
  }

  .toc-fab {
    bottom: 0.75rem;
    right: 0.75rem;
    font-size: 0.7rem;
    padding: 0.45rem 0.75rem;
  }

  .toc-mobile-panel {
    bottom: 3.25rem;
    right: 0.75rem;
    width: 200px;
  }
}
