/* NextDocs Foundation — components.css
   One class, one job. Semantic tokens only. Catalog names follow the design
   companion: container, topbar, btn, menu, sidebar + nav-item, breadcrumb,
   page-header, prose, code-block, toc (rail), pagination, alert, state, docs-layout. */

/* ---------- container ---------- */
.container { width: 100%; max-width: var(--container-default); margin-inline: auto; padding-inline: var(--space-4); }

/* ---------- btn ---------- */
.btn {
  display: inline-flex; align-items: center; justify-content: center; gap: var(--space-2);
  min-height: var(--control-md); padding: 0 var(--space-4); border-radius: var(--radius-control);
  border: 1px solid var(--color-border-strong); background: var(--color-bg-canvas);
  color: var(--color-text-primary); font-size: var(--text-sm); font-weight: var(--weight-medium);
  text-decoration: none; cursor: pointer; transition: background var(--motion-fast);
}
.btn:hover { background: var(--color-surface-hover); }
.btn[aria-busy="true"] { opacity: 0.6; pointer-events: none; }
.btn-primary { background: var(--color-brand); border-color: var(--color-brand); color: var(--color-brand-on); }
.btn-primary:hover { background: var(--color-brand-hover); border-color: var(--color-brand-hover); }
.btn-ghost { border-color: transparent; background: transparent; }
.btn-icon { width: var(--control-md); padding: 0; }

/* ---------- topbar ---------- */
.topbar {
  position: sticky; top: 0; z-index: var(--z-sticky); height: var(--topbar-height);
  background: var(--color-bg-canvas); border-bottom: 1px solid var(--color-border);
}
.topbar-inner { display: flex; align-items: center; gap: var(--space-3); height: 100%; }
.topbar-brand {
  display: inline-flex; align-items: center; gap: var(--space-2); min-width: 0;
  color: var(--color-text-primary); font-weight: var(--weight-semibold); text-decoration: none;
}
.topbar-brand img { max-height: 1.75rem; width: auto; }
.topbar-brand span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.topbar-actions { margin-left: auto; display: flex; align-items: center; gap: var(--space-2); }
.topbar .logo-dark { display: none; }
[data-theme="dark"] .topbar .logo-light { display: none; }
[data-theme="dark"] .topbar .logo-dark { display: inline; }

/* ---------- menu (details-based; JS adds Esc / outside click / focus return) ---------- */
.menu { position: relative; }
.menu > summary {
  list-style: none; display: inline-flex; align-items: center; gap: var(--space-1);
  min-height: var(--control-md); padding: 0 var(--space-3); border-radius: var(--radius-control);
  border: 1px solid var(--color-border); font-size: var(--text-sm); cursor: pointer;
}
.menu > summary::-webkit-details-marker { display: none; }
.menu > summary:hover { background: var(--color-surface-hover); }
.menu-list {
  position: absolute; right: 0; top: calc(100% + var(--space-1)); z-index: var(--z-overlay);
  min-width: 10rem; margin: 0; padding: var(--space-1); list-style: none;
  background: var(--color-bg-canvas); border: 1px solid var(--color-border);
  border-radius: var(--radius-control); box-shadow: var(--shadow-overlay);
}
.menu-list a {
  display: flex; justify-content: space-between; gap: var(--space-3); min-height: var(--control-sm);
  align-items: center; padding: 0 var(--space-3); border-radius: var(--radius-1);
  color: var(--color-text-primary); text-decoration: none; font-size: var(--text-sm);
}
.menu-list a:hover { background: var(--color-surface-hover); }
.menu-list a[aria-current="true"] { font-weight: var(--weight-semibold); color: var(--color-brand); }

/* ---------- docs layout ---------- */
.docs-layout {
  display: grid; grid-template-columns: var(--sidebar-width) minmax(0, 1fr) var(--toc-width);
  gap: var(--space-8); align-items: start;
}
.docs-main { min-width: 0; padding-block: var(--space-8) var(--space-12); }
.docs-layout.no-toc { grid-template-columns: var(--sidebar-width) minmax(0, 1fr); }

/* ---------- sidebar + nav-item ---------- */
.sidebar {
  position: sticky; top: var(--topbar-height); max-height: calc(100vh - var(--topbar-height));
  overflow-y: auto; padding-block: var(--space-6); font-size: var(--text-sm);
}
.sidebar ul { list-style: none; margin: 0; padding: 0; }
.sidebar ul ul { padding-left: var(--space-3); margin-left: var(--space-2); border-left: 1px solid var(--color-border); }
.nav-item {
  display: block; padding: var(--space-1) var(--space-2); border-radius: var(--radius-1);
  color: var(--color-text-muted); text-decoration: none; min-height: var(--touch-min);
}
.nav-item:hover { color: var(--color-text-primary); background: var(--color-surface-hover); }
.nav-item[aria-current="page"] { color: var(--color-brand); background: var(--color-brand-subtle); font-weight: var(--weight-semibold); }
.nav-section > summary { list-style: none; display: flex; align-items: center; gap: var(--space-1); cursor: pointer; }
.nav-section > summary::-webkit-details-marker { display: none; }
.nav-section > summary::after {
  content: ""; margin-left: auto; width: 0.45rem; height: 0.45rem; flex: none;
  border-right: 2px solid var(--color-text-muted); border-bottom: 2px solid var(--color-text-muted);
  transform: rotate(-45deg); transition: transform var(--motion-fast);
}
.nav-section[open] > summary::after { transform: rotate(45deg); }
.nav-section > summary .nav-item { flex: 1; }
.sidebar-toggle { display: none; }

/* ---------- breadcrumb ---------- */
.breadcrumb ol { display: flex; flex-wrap: wrap; gap: var(--space-1); list-style: none; margin: 0 0 var(--space-4); padding: 0; font-size: var(--text-sm); color: var(--color-text-muted); }
.breadcrumb li + li::before { content: "/"; margin-right: var(--space-1); color: var(--color-border-strong); }
.breadcrumb a { color: var(--color-text-muted); }
.breadcrumb [aria-current="page"] { color: var(--color-text-primary); }

/* ---------- page-header ---------- */
.page-header { margin-bottom: var(--space-6); }
.page-header h1 { font-size: var(--text-4xl); font-weight: var(--weight-bold); }
.page-header p { margin-top: var(--space-2); font-size: var(--text-lg); color: var(--color-text-muted); max-width: var(--measure); }

/* ---------- prose ---------- */
.prose { max-width: var(--measure); color: var(--color-text-secondary); overflow-wrap: anywhere; }
.prose > * + * { margin-top: var(--space-4); }
.prose h1, .prose h2, .prose h3, .prose h4 { color: var(--color-text-primary); scroll-margin-top: calc(var(--topbar-height) + var(--space-4)); }
.prose h1 { font-size: var(--text-3xl); }
.prose h2 { font-size: var(--text-2xl); margin-top: var(--space-10); padding-bottom: var(--space-2); border-bottom: 1px solid var(--color-border); }
.prose h3 { font-size: var(--text-xl); margin-top: var(--space-8); }
.prose h4 { font-size: var(--text-lg); margin-top: var(--space-6); }
.prose ul, .prose ol { padding-left: var(--space-6); }
.prose li + li { margin-top: var(--space-1); }
.prose li:has(> input[type="checkbox"]) { list-style: none; margin-left: calc(-1 * var(--space-5)); }
.prose input[type="checkbox"] { margin-right: var(--space-2); accent-color: var(--color-brand); }
.prose blockquote { margin-inline: 0; padding: var(--space-2) var(--space-4); border-left: 4px solid var(--color-border-strong); color: var(--color-text-muted); }
.prose hr { border: 0; border-top: 1px solid var(--color-border); margin-block: var(--space-8); }
.prose img { border-radius: var(--radius-control); }
.prose table { display: block; width: max-content; max-width: 100%; overflow-x: auto; border-collapse: collapse; font-size: var(--text-sm); }
.prose th, .prose td { padding: var(--space-2) var(--space-3); border: 1px solid var(--color-border); }
.prose th { background: var(--color-surface); font-weight: var(--weight-semibold); }
.prose :not(pre) > code { padding: 0.1em 0.35em; border-radius: var(--radius-1); background: var(--code-bg); font-family: var(--font-mono); font-size: 0.875em; }
.prose kbd { padding: 0.1em 0.4em; border: 1px solid var(--color-border-strong); border-radius: var(--radius-1); font-family: var(--font-mono); font-size: 0.85em; }

/* ---------- code-block (chroma output: pre.chroma > code > .line) ---------- */
.prose pre, .code-block {
  overflow-x: auto; padding: var(--space-4); border-radius: var(--radius-control);
  border: 1px solid var(--color-border); background: var(--code-bg);
  font-family: var(--font-mono); font-size: var(--text-sm); line-height: 1.5;
}
.prose pre code { font-family: inherit; }

/* ---------- toc (rail) ---------- */
.toc { position: sticky; top: calc(var(--topbar-height) + var(--space-8)); padding-block: var(--space-8); font-size: var(--text-sm); }
.toc-title { margin-bottom: var(--space-2); font-size: var(--text-xs); font-weight: var(--weight-semibold); text-transform: uppercase; letter-spacing: 0.06em; color: var(--color-text-muted); }
.toc ul { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--color-border); }
.toc a { display: block; padding: var(--space-1) var(--space-3); color: var(--color-text-muted); text-decoration: none; }
.toc a:hover { color: var(--color-text-primary); }
.toc .toc-l3 a { padding-left: var(--space-6); }

/* ---------- pagination (prev / next) ---------- */
.pagination { display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-4); margin-top: var(--space-12); max-width: var(--measure); }
.pagination a {
  display: flex; flex-direction: column; gap: var(--space-1); padding: var(--space-4);
  border: 1px solid var(--color-border); border-radius: var(--radius-card); text-decoration: none;
}
.pagination a:hover { border-color: var(--color-brand); }
.pagination .pagination-label { font-size: var(--text-xs); color: var(--color-text-muted); }
.pagination .pagination-title { font-weight: var(--weight-semibold); color: var(--color-text-link); }
.pagination .pagination-next { grid-column: 2; text-align: right; }

/* ---------- meta-row ---------- */
.meta-row { margin-top: var(--space-10); font-size: var(--text-sm); color: var(--color-text-muted); }

/* ---------- alert (5 tones) ---------- */
.alert { display: flex; gap: var(--space-3); padding: var(--space-3) var(--space-4); border: 1px solid; border-radius: var(--radius-control); font-size: var(--text-sm); }
.alert-neutral { color: var(--color-status-neutral-fg); background: var(--color-status-neutral-bg); border-color: var(--color-status-neutral-border); }
.alert-info { color: var(--color-status-info-fg); background: var(--color-status-info-bg); border-color: var(--color-status-info-border); }
.alert-success { color: var(--color-status-success-fg); background: var(--color-status-success-bg); border-color: var(--color-status-success-border); }
.alert-warning { color: var(--color-status-warning-fg); background: var(--color-status-warning-bg); border-color: var(--color-status-warning-border); }
.alert-danger { color: var(--color-status-danger-fg); background: var(--color-status-danger-bg); border-color: var(--color-status-danger-border); }

/* ---------- state (empty / not found — always a next action) ---------- */
.state { max-width: var(--measure); padding-block: var(--space-12); }
.state h1 { font-size: var(--text-3xl); }
.state p { margin-block: var(--space-3) var(--space-6); color: var(--color-text-muted); }

/* ---------- responsive ---------- */
@media (max-width: 1279px) {
  .docs-layout, .docs-layout.no-toc { grid-template-columns: var(--sidebar-width) minmax(0, 1fr); }
  .toc { display: none; }
}
@media (max-width: 767px) {
  .docs-layout, .docs-layout.no-toc { grid-template-columns: minmax(0, 1fr); gap: 0; }
  .page-header h1 { font-size: var(--text-3xl); }
  /* Without JS the sidebar stays in flow above the content. */
  .js .sidebar {
    position: fixed; inset: var(--topbar-height) auto 0 0; z-index: var(--z-drawer);
    width: min(85vw, var(--sidebar-width)); max-height: none; padding-inline: var(--space-4);
    background: var(--color-bg-canvas); border-right: 1px solid var(--color-border);
    box-shadow: var(--shadow-overlay); transform: translateX(-105%); transition: transform var(--motion-base);
  }
  .js .sidebar[data-open="true"] { transform: none; }
  .js .sidebar-toggle { display: inline-flex; }
  .sidebar { position: static; max-height: none; border-bottom: 1px solid var(--color-border); }
  .topbar-brand span { max-width: 40vw; }
  .pagination { grid-template-columns: 1fr; }
  .pagination .pagination-next { grid-column: 1; }
}