/* ===== Reset & Base ===== */
*,
*::before,
*::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

:root {
  --color-bg: #ffffff;
  --color-surface: #f8f9fa;
  --color-border: #e2e4e9;
  --color-border-light: #eef0f3;
  --color-text: #1a1d23;
  --color-text-secondary: #5f6570;
  --color-text-tertiary: #8b919e;
  --color-primary: #0969da;
  --color-primary-hover: #0559b9;
  --color-code-bg: #f6f8fa;
  --color-code-border: #d8dee4;
  --color-table-stripe: #f8f9fa;
  --color-table-header: #f0f2f5;
  --color-warning-bg: #fff8e6;
  --color-warning-border: #f0c060;
  --color-info-bg: #e8f4fd;
  --color-info-border: #8bb8e8;
  --color-mermaid-bg: #fafbfc;
  --color-ascii-bg: #f6f8fa;
  --color-ascii-border: #d8dee4;
  --color-link: #0969da;
  --color-file-ref: #8250df;
  --color-file-ref-bg: #f4f0fd;
  --color-hr: #e2e4e9;

  --sidebar-width: 280px;
  --header-height: 56px;
  --font-mono: "SF Mono", "Cascadia Code", "Fira Code", "JetBrains Mono", "IBM Plex Mono", ui-monospace, Consolas, "Liberation Mono", Menlo, monospace;
  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", Arial, sans-serif;
  --radius: 6px;
}

html {
  scroll-behavior: smooth;
  scroll-padding-top: 24px;
}

body {
  font-family: var(--font-sans);
  font-size: 15px;
  line-height: 1.65;
  color: var(--color-text);
  background: var(--color-bg);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* ===== Sidebar ===== */
.sidebar {
  position: fixed;
  top: 0;
  left: 0;
  width: var(--sidebar-width);
  height: 100vh;
  background: var(--color-surface);
  border-right: 1px solid var(--color-border);
  overflow-y: auto;
  overflow-x: hidden;
  z-index: 100;
  padding: 24px 20px 80px 20px;
}

.sidebar-header {
  margin-bottom: 24px;
  padding-bottom: 16px;
  border-bottom: 1px solid var(--color-border);
}

.sidebar-header h1 {
  font-size: 16px;
  font-weight: 700;
  color: var(--color-text);
  line-height: 1.3;
}

.sidebar-header .version {
  font-size: 12px;
  color: var(--color-text-tertiary);
  margin-top: 4px;
}

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

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

.sidebar-nav a {
  display: block;
  padding: 5px 10px;
  font-size: 13px;
  color: var(--color-text-secondary);
  text-decoration: none;
  border-radius: var(--radius);
  transition: background 0.12s, color 0.12s;
  line-height: 1.5;
}

.sidebar-nav a:hover {
  background: var(--color-border-light);
  color: var(--color-text);
}

.sidebar-nav a.active {
  background: var(--color-primary);
  color: #ffffff;
}

.sidebar-nav a.toc-h2 {
  padding-left: 10px;
  font-weight: 500;
}

.sidebar-nav a.toc-h3 {
  padding-left: 22px;
  font-size: 12px;
}

/* ===== Main Content ===== */
.main {
  margin-left: var(--sidebar-width);
  padding: 48px 56px 120px 56px;
}

.content {
  max-width: 100%;
}

/* Text readability: constrain paragraphs and headings to comfortable reading width */
.content > p,
.content > h1,
.content > h2,
.content > h3,
.content > h4,
.content > ul,
.content > ol,
.content > blockquote,
.content > .callout {
  max-width: 820px;
}

/* Mobile menu button */
.mobile-menu-btn {
  display: none;
  position: fixed;
  top: 12px;
  left: 12px;
  z-index: 200;
  width: 40px;
  height: 40px;
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  background: var(--color-bg);
  cursor: pointer;
  align-items: center;
  justify-content: center;
  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
}

.mobile-menu-btn svg {
  width: 20px;
  height: 20px;
  stroke: var(--color-text);
}

.sidebar-overlay {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.35);
  z-index: 99;
}

/* ===== Typography ===== */
h1 {
  font-size: 32px;
  font-weight: 700;
  letter-spacing: -0.02em;
  margin-bottom: 8px;
  line-height: 1.2;
}

h2 {
  font-size: 22px;
  font-weight: 600;
  letter-spacing: -0.01em;
  margin-top: 48px;
  margin-bottom: 16px;
  padding-bottom: 8px;
  border-bottom: 1px solid var(--color-border-light);
  line-height: 1.3;
}

h3 {
  font-size: 17px;
  font-weight: 600;
  margin-top: 32px;
  margin-bottom: 12px;
  line-height: 1.35;
}

h4 {
  font-size: 15px;
  font-weight: 600;
  margin-top: 24px;
  margin-bottom: 8px;
  line-height: 1.4;
}

p {
  margin-bottom: 14px;
}

a {
  color: var(--color-link);
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

strong {
  font-weight: 600;
}

/* ===== Horizontal Rule ===== */
hr {
  border: none;
  border-top: 1px solid var(--color-hr);
  margin: 40px 0;
}

/* ===== Blockquote ===== */
blockquote {
  margin: 16px 0;
  padding: 14px 18px;
  border-left: 4px solid var(--color-primary);
  background: var(--color-info-bg);
  border-radius: 0 var(--radius) var(--radius) 0;
  font-size: 14px;
  color: var(--color-text-secondary);
}

blockquote p {
  margin-bottom: 6px;
}

blockquote p:last-child {
  margin-bottom: 0;
}

blockquote strong,
blockquote b {
  font-weight: 600;
}

/* ===== Tables ===== */
.table-wrapper {
  overflow-x: auto;
  margin: 18px 0;
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
}

table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
  line-height: 1.5;
}

thead {
  background: var(--color-table-header);
}

th {
  text-align: left;
  padding: 10px 14px;
  font-weight: 600;
  color: var(--color-text);
  border-bottom: 2px solid var(--color-border);
  white-space: nowrap;
}

td {
  padding: 9px 14px;
  border-bottom: 1px solid var(--color-border-light);
  vertical-align: top;
}

tbody tr:nth-child(even) {
  background: var(--color-table-stripe);
}

tbody tr:last-child td {
  border-bottom: none;
}

/* ===== Code ===== */
code {
  font-family: var(--font-mono);
  font-size: 13px;
  background: var(--color-code-bg);
  padding: 2px 6px;
  border-radius: 3px;
  border: 1px solid var(--color-code-border);
  white-space: nowrap;
}

pre {
  margin: 16px 0;
  padding: 16px 18px;
  background: var(--color-code-bg);
  border: 1px solid var(--color-code-border);
  border-radius: var(--radius);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.55;
}

pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: inherit;
  white-space: pre;
}

/* File path reference highlight */
.file-ref {
  display: inline;
  font-family: var(--font-mono);
  font-size: 12.5px;
  color: var(--color-file-ref);
  background: var(--color-file-ref-bg);
  padding: 1px 5px;
  border-radius: 3px;
}

/* ===== ASCII Art Diagrams ===== */
pre.ascii-diagram {
  background: var(--color-ascii-bg);
  border: 1px dashed var(--color-ascii-border);
  padding: 20px 22px;
  line-height: 1.35;
  font-size: 10.5px;
  color: var(--color-text-secondary);
}

/* ===== Mermaid Diagrams ===== */
.mermaid-wrapper {
  margin: 24px 0;
  padding: 24px 20px;
  background: var(--color-mermaid-bg);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  overflow-x: auto;
  display: flex;
  justify-content: center;
}

.mermaid-wrapper pre.mermaid {
  margin: 0;
  padding: 0;
  background: none;
  border: none;
  font-size: 12px;
  line-height: 1.5;
}

.mermaid-wrapper svg {
  max-width: 100%;
  height: auto;
}

/* ===== Callout / Info Boxes ===== */
.callout {
  margin: 18px 0;
  padding: 14px 18px;
  border-radius: var(--radius);
  font-size: 14px;
  line-height: 1.55;
}

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

.callout-info {
  background: var(--color-info-bg);
  border: 1px solid var(--color-info-border);
}

.callout p {
  margin-bottom: 6px;
}

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

/* ===== Summary / Badge boxes ===== */
.metric-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 12px;
  margin: 16px 0;
}

.metric-card {
  padding: 14px 16px;
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  background: var(--color-surface);
}

.metric-card .metric-value {
  font-size: 24px;
  font-weight: 700;
  color: var(--color-text);
  line-height: 1.1;
}

.metric-card .metric-label {
  font-size: 12px;
  color: var(--color-text-tertiary);
  margin-top: 4px;
}

/* ===== Document banner ===== */
.doc-banner {
  margin-bottom: 32px;
  padding: 20px 24px;
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
}

.doc-banner .doc-title {
  font-size: 20px;
  font-weight: 700;
  margin-bottom: 6px;
}

.doc-banner .doc-meta {
  font-size: 13px;
  color: var(--color-text-secondary);
}

.doc-banner .doc-meta span {
  margin-right: 16px;
}

.doc-badge {
  display: inline-block;
  padding: 2px 8px;
  font-size: 11px;
  font-weight: 600;
  border-radius: 10px;
  background: var(--color-info-bg);
  color: var(--color-primary);
}

/* ===== Section anchor ===== */
.section-anchor {
  color: var(--color-text-tertiary);
  font-size: 18px;
  margin-left: 6px;
  opacity: 0;
  transition: opacity 0.15s;
}

h2:hover .section-anchor,
h3:hover .section-anchor,
h4:hover .section-anchor {
  opacity: 1;
}

.section-anchor:hover {
  color: var(--color-primary);
}

/* ===== Footer ===== */
.doc-footer {
  margin-top: 64px;
  padding-top: 24px;
  border-top: 1px solid var(--color-border);
  font-size: 13px;
  color: var(--color-text-tertiary);
}

/* ===== Print ===== */
@media print {
  .sidebar,
  .mobile-menu-btn,
  .sidebar-overlay {
    display: none !important;
  }

  .main {
    margin-left: 0;
    padding: 0;
    max-width: 100%;
  }

  pre {
    break-inside: avoid;
    font-size: 10px;
  }

  table {
    font-size: 10px;
  }

  .mermaid-wrapper {
    break-inside: avoid;
  }
}

/* ===== Responsive ===== */
@media (max-width: 1024px) {
  .sidebar {
    transform: translateX(-100%);
    transition: transform 0.25s cubic-bezier(0.4, 0, 0.2, 1);
  }

  .sidebar.open {
    transform: translateX(0);
  }

  .sidebar-overlay.visible {
    display: block;
  }

  .main {
    margin-left: 0;
    padding: 24px 20px 80px 20px;
  }

  .mobile-menu-btn {
    display: flex;
  }

  .metric-grid {
    grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
  }

  h1 {
    font-size: 26px;
  }

  h2 {
    font-size: 20px;
  }
}

@media (max-width: 640px) {
  .main {
    padding: 16px 14px 60px 14px;
  }

  table {
    font-size: 12px;
  }

  th,
  td {
    padding: 6px 8px;
  }
}