@import url("https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap");

/*
  Sanctuary Docs UI
  Color tokens mirrored from src/constants/colors.ts (LIGHT_COLORS)
*/

:root {
  /* Brand — Deep Navy (app primary) */
  --primary: #002045;
  --primary-container: #1a365d;
  --primary-deep: #0a2540;
  --primary-deepest: #001b3c;
  --primary-fixed: #d6e3ff;
  --primary-fixed-dim: #adc7f7;
  --primary-pale: #eef4ff;
  --primary-surface: #f4f7fb;
  --on-primary: #ffffff;
  --on-primary-container: #86a0cd;
  --link: #2d476f;
  --link-hover: #002045;
  --primary-shadow: rgba(0, 32, 69, 0.12);
  --primary-tint: rgba(0, 32, 69, 0.06);
  --primary-ring: rgba(0, 32, 69, 0.12);

  /* Secondary / text */
  --secondary: #545f72;
  --secondary-container: #d5e0f7;
  --on-surface: #181c1e;
  --on-surface-variant: #43474e;
  --outline: #74777f;
  --outline-variant: #c4c6cf;

  /* Surfaces */
  --bg: #f7fafc;
  --bg-elevated: #ffffff;
  --surface-low: #f1f4f6;
  --surface-container: #ebeef0;

  /* Status */
  --warn-bg: #fff3e0;
  --warn-border: #ffddba;
  --warn-ink: #633f0f;
  --amber: #d97706;
  --error: #ba1a1a;
  --emerald: #059669;

  /* Nav accents from app */
  --nav-active-bg: #dbeafe;
  --nav-active-text: #1e3a8a;

  /* Layout */
  --sidebar-w: 272px;
  --toc-w: 220px;
  --top-h: 60px;
  --content-max: 720px;
  --radius: 12px;
  --radius-sm: 8px;
  --font: "Plus Jakarta Sans", system-ui, -apple-system, sans-serif;
  --mono: "SF Mono", "Cascadia Code", ui-monospace, Consolas, monospace;
  --shadow-sm: 0 1px 1px rgba(0, 32, 69, 0.03);
  --shadow: 0 1px 2px rgba(0, 32, 69, 0.04), 0 4px 12px rgba(0, 32, 69, 0.04);
  --shadow-lg: 0 6px 20px rgba(0, 32, 69, 0.08);

  /* Motion */
  --ease: cubic-bezier(0.22, 1, 0.36, 1);
  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);
  --dur: 220ms;
  --dur-slow: 380ms;
}

*, *::before, *::after { box-sizing: border-box; }
html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

body {
  margin: 0;
  font-family: var(--font);
  color: var(--on-surface);
  background:
    radial-gradient(1100px 520px at 8% -8%, rgba(214, 227, 255, 0.75), transparent 55%),
    radial-gradient(900px 480px at 100% 0%, rgba(26, 54, 93, 0.06), transparent 50%),
    var(--bg);
  line-height: 1.65;
  font-size: 15.5px;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
  opacity: 1;
  transition: opacity 200ms var(--ease);
}

a {
  color: var(--link);
  text-decoration: none;
  transition: color var(--dur) var(--ease), opacity var(--dur) var(--ease);
}
a:hover { color: var(--link-hover); text-decoration: underline; text-underline-offset: 3px; }
::selection { background: var(--primary-fixed); color: var(--primary); }

/* Page enter */
@keyframes fade-up {
  from { opacity: 0; transform: translateY(6px); }
  to { opacity: 1; transform: translateY(0); }
}
@keyframes fade-in {
  from { opacity: 0; }
  to { opacity: 1; }
}
@keyframes slide-in-left {
  from { opacity: 0; transform: translateX(-12px); }
  to { opacity: 1; transform: translateX(0); }
}
@keyframes pop {
  from { opacity: 0; transform: translateY(3px) scale(0.995); }
  to { opacity: 1; transform: translateY(0) scale(1); }
}

.content > .hero-docs,
.content > .article {
  animation: fade-up var(--dur-slow) var(--ease-out) both;
}
.sidebar { animation: slide-in-left var(--dur-slow) var(--ease-out) both; }
.toc { animation: fade-in calc(var(--dur-slow) + 80ms) var(--ease-out) both; }

/* ── Top bar ── */
.topbar {
  position: sticky;
  top: 0;
  z-index: 50;
  height: var(--top-h);
  display: flex;
  align-items: center;
  gap: 1rem;
  padding: 0 1.25rem;
  background: rgba(247, 250, 252, 0.78);
  backdrop-filter: saturate(1.25) blur(16px);
  -webkit-backdrop-filter: saturate(1.25) blur(16px);
  border-bottom: 1px solid rgba(196, 198, 207, 0.55);
  transition: background var(--dur) var(--ease), box-shadow var(--dur) var(--ease);
}
.topbar.scrolled {
  background: rgba(255, 255, 255, 0.9);
  box-shadow: 0 2px 8px rgba(0, 32, 69, 0.04);
}

.brand {
  display: flex;
  align-items: center;
  gap: 0.65rem;
  color: var(--primary);
  text-decoration: none !important;
  font-weight: 700;
  letter-spacing: -0.03em;
  white-space: nowrap;
  font-size: 0.95rem;
  transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.brand:hover { opacity: 0.88; transform: none; text-decoration: none !important; }
.brand-mark {
  width: 32px;
  height: 32px;
  border-radius: 8px;
  overflow: hidden;
  display: grid;
  place-items: center;
  background: #ffffff;
  border: 1px solid var(--outline-variant);
  flex-shrink: 0;
  padding: 2px;
  box-shadow: none;
  transition: transform var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.brand-mark img {
  width: 100%;
  height: 100%;
  object-fit: contain;
  display: block;
}
.brand:hover .brand-mark {
  transform: scale(1.03);
  border-color: var(--primary-fixed-dim);
  box-shadow: none;
}
.brand .sep { color: var(--outline-variant); font-weight: 400; margin: 0 0.1rem; }
.brand .product { color: var(--secondary); font-weight: 500; }

.search-wrap {
  flex: 1;
  max-width: 440px;
  margin-left: auto;
  position: relative;
}
.search-wrap input {
  width: 100%;
  height: 38px;
  border: 1px solid var(--outline-variant);
  border-radius: 10px;
  padding: 0 4.2rem 0 2.35rem;
  background: var(--surface-low);
  color: var(--on-surface);
  outline: none;
  font: inherit;
  font-size: 0.9rem;
  transition:
    border-color var(--dur) var(--ease),
    background var(--dur) var(--ease),
    box-shadow var(--dur) var(--ease),
    transform var(--dur) var(--ease);
}
.search-wrap input::placeholder { color: var(--outline); }
.search-wrap input:hover { border-color: #a8b4c8; }
.search-wrap input:focus {
  background: #fff;
  border-color: var(--primary-container);
  box-shadow: 0 0 0 4px var(--primary-ring);
}
.search-wrap > svg {
  position: absolute;
  left: 0.8rem;
  top: 50%;
  transform: translateY(-50%);
  color: var(--outline);
  pointer-events: none;
  transition: color var(--dur) var(--ease);
}
.search-wrap:focus-within > svg { color: var(--primary); }
.search-kbd {
  position: absolute;
  right: 0.55rem;
  top: 50%;
  transform: translateY(-50%);
  display: inline-flex;
  gap: 0.2rem;
  pointer-events: none;
  transition: opacity var(--dur) var(--ease);
}
.search-wrap:focus-within .search-kbd { opacity: 0; }
.search-kbd span {
  font-family: var(--mono);
  font-size: 0.68rem;
  color: var(--outline);
  border: 1px solid var(--outline-variant);
  background: #fff;
  border-radius: 5px;
  padding: 0.12rem 0.35rem;
  line-height: 1.2;
}

.top-links {
  display: flex;
  align-items: center;
  gap: 0.35rem;
  font-size: 0.875rem;
  font-weight: 500;
}
.top-links a {
  color: var(--on-surface-variant);
  text-decoration: none !important;
  padding: 0.4rem 0.7rem;
  border-radius: 8px;
  transition: background var(--dur) var(--ease), color var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.top-links a:hover {
  background: var(--primary-fixed);
  color: var(--primary);
  transform: none;
}
.top-links a.btn-support {
  background: var(--primary);
  color: var(--on-primary) !important;
  margin-left: 0.25rem;
  box-shadow: 0 1px 3px var(--primary-shadow);
}
.top-links a.btn-support:hover {
  background: var(--primary-container);
  color: var(--on-primary) !important;
  transform: none;
}

.menu-btn {
  display: none;
  border: 1px solid var(--outline-variant);
  background: #fff;
  border-radius: 9px;
  width: 38px;
  height: 38px;
  cursor: pointer;
  place-items: center;
  color: var(--on-surface-variant);
  padding: 0;
  transition: background var(--dur) var(--ease), border-color var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.menu-btn:hover {
  background: var(--primary-pale);
  border-color: var(--primary-fixed-dim);
  transform: scale(1.03);
}
.menu-btn svg { display: block; }

.search-toggle,
.search-close {
  display: none;
  border: 1px solid var(--outline-variant);
  background: #fff;
  border-radius: 9px;
  width: 38px;
  height: 38px;
  cursor: pointer;
  place-items: center;
  color: var(--on-surface-variant);
  padding: 0;
  flex-shrink: 0;
  transition: background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.search-toggle:hover,
.search-close:hover {
  background: var(--primary-pale);
  border-color: var(--primary-fixed-dim);
}
.search-toggle svg,
.search-close svg { display: block; }

/* ── Layout ── */
.shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  min-height: calc(100vh - var(--top-h));
  max-width: 1440px;
  margin: 0 auto;
}
.shell.no-toc { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }

.sidebar {
  position: sticky;
  top: var(--top-h);
  height: calc(100vh - var(--top-h));
  overflow: auto;
  border-right: 1px solid rgba(196, 198, 207, 0.7);
  background: rgba(255, 255, 255, 0.55);
  padding: 1.15rem 0.9rem 2.5rem;
  scrollbar-width: thin;
  scrollbar-color: var(--outline-variant) transparent;
}
.side-home {
  display: block;
  padding: 0.5rem 0.75rem;
  margin-bottom: 0.85rem;
  border-radius: 9px;
  color: var(--on-surface-variant);
  text-decoration: none !important;
  font-size: 0.9rem;
  font-weight: 600;
  transition: background var(--dur) var(--ease), color var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.side-home:hover {
  background: var(--surface-low);
  color: var(--primary);
  transform: translateX(2px);
}
.side-home.active {
  background: var(--nav-active-bg);
  color: var(--nav-active-text);
}
.side-group { margin: 0 0 1.25rem; }
.side-label {
  font-size: 0.68rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--outline);
  padding: 0.3rem 0.75rem 0.45rem;
}
.side-link {
  display: block;
  position: relative;
  padding: 0.45rem 0.75rem;
  border-radius: 8px;
  color: var(--on-surface-variant);
  text-decoration: none !important;
  font-size: 0.875rem;
  font-weight: 500;
  line-height: 1.35;
  transition:
    background var(--dur) var(--ease),
    color var(--dur) var(--ease),
    transform var(--dur) var(--ease),
    padding-left var(--dur) var(--ease);
}
.side-link:hover {
  background: var(--primary-surface);
  color: var(--primary);
  transform: translateX(2px);
}
.side-link.active {
  background: var(--nav-active-bg);
  color: var(--nav-active-text);
  font-weight: 600;
}
.side-link.active::before {
  content: "";
  position: absolute;
  left: 0;
  top: 6px;
  bottom: 6px;
  width: 3px;
  border-radius: 0 3px 3px 0;
  background: var(--primary);
  transition: height var(--dur) var(--ease);
}

.content {
  min-width: 0;
  padding: 2rem 2rem 4rem;
}
.article { max-width: var(--content-max); margin: 0 auto; }

.toc {
  position: sticky;
  top: var(--top-h);
  height: calc(100vh - var(--top-h));
  overflow: auto;
  padding: 1.5rem 1rem 2rem 0.25rem;
}
.toc-inner { padding-left: 1rem; border-left: 1px solid var(--outline-variant); }
.toc-label {
  font-size: 0.68rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--outline);
  margin-bottom: 0.65rem;
}
.toc a {
  display: block;
  color: var(--secondary);
  text-decoration: none !important;
  font-size: 0.8rem;
  font-weight: 500;
  padding: 0.28rem 0;
  line-height: 1.35;
  border-left: 2px solid transparent;
  margin-left: -1px;
  padding-left: 0.75rem;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease), padding-left var(--dur) var(--ease);
}
.toc a:hover { color: var(--primary); padding-left: 0.9rem; }
.toc a.active {
  color: var(--primary);
  border-left-color: var(--primary);
  font-weight: 600;
}

.breadcrumb {
  display: flex;
  flex-wrap: wrap;
  gap: 0.4rem;
  align-items: center;
  font-size: 0.8rem;
  color: var(--secondary);
  margin-bottom: 1.15rem;
  font-weight: 500;
}
.breadcrumb a { color: var(--secondary); text-decoration: none !important; transition: color var(--dur) var(--ease); }
.breadcrumb a:hover { color: var(--primary); }
.breadcrumb .cr-sep { opacity: 0.45; font-size: 0.75rem; }

.article h1 {
  margin: 0 0 0.75rem;
  font-size: clamp(1.85rem, 3.2vw, 2.35rem);
  letter-spacing: -0.035em;
  line-height: 1.15;
  font-weight: 800;
  color: var(--primary);
}
.lead {
  font-size: 1.08rem;
  color: var(--on-surface-variant);
  margin: 0 0 1.35rem;
  line-height: 1.6;
}
.meta-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin: -0.35rem 0 1.75rem;
  padding-bottom: 1.25rem;
  border-bottom: 1px solid var(--outline-variant);
}
.meta-row span {
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--secondary);
  background: var(--secondary-container);
  border: 1px solid transparent;
  border-radius: 999px;
  padding: 0.28rem 0.65rem;
  transition: transform var(--dur) var(--ease);
}

.article h2 {
  margin: 2.35rem 0 0.75rem;
  font-size: 1.28rem;
  letter-spacing: -0.025em;
  font-weight: 700;
  scroll-margin-top: 5.5rem;
  color: var(--primary);
}
.article h2::before {
  content: "";
  display: block;
  height: 1px;
  background: linear-gradient(90deg, var(--outline-variant), transparent);
  margin: 0 0 1.5rem;
}
.article > h2:first-of-type::before { display: none; }
.article h3 {
  margin: 1.5rem 0 0.55rem;
  font-size: 1.05rem;
  font-weight: 600;
  letter-spacing: -0.015em;
  color: var(--primary-deep);
}
.article p { margin: 0.7rem 0; color: var(--on-surface-variant); }
.article ul, .article ol {
  margin: 0.55rem 0 1.1rem;
  padding-left: 1.2rem;
  color: var(--on-surface-variant);
}
.article li { margin: 0.4rem 0; padding-left: 0.15rem; }
.article li::marker { color: var(--primary-fixed-dim); }
.article strong { color: var(--on-surface); font-weight: 600; }

/* ── Landing ── */
.hero-docs {
  max-width: 960px;
  margin: 0 auto;
  padding: 0.5rem 0 1rem;
}
.hero-docs h1 {
  font-size: clamp(2.2rem, 4.5vw, 3rem);
  letter-spacing: -0.04em;
  margin: 0 0 0.75rem;
  font-weight: 800;
  line-height: 1.1;
  color: var(--primary);
}
.hero-docs .lead {
  max-width: 36rem;
  font-size: 1.12rem;
  margin-bottom: 1.75rem;
}
.cards {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 1rem;
  margin: 0 0 2.25rem;
}
.card {
  position: relative;
  background: var(--bg-elevated);
  border: 1px solid var(--outline-variant);
  border-radius: 14px;
  padding: 1.25rem 1.3rem 1.35rem;
  text-decoration: none !important;
  color: inherit;
  box-shadow: var(--shadow-sm);
  transition:
    border-color var(--dur) var(--ease),
    box-shadow var(--dur-slow) var(--ease),
    transform var(--dur-slow) var(--ease),
    background var(--dur) var(--ease);
  overflow: hidden;
  animation: pop var(--dur-slow) var(--ease-out) both;
}
.card:nth-child(1) { animation-delay: 40ms; }
.card:nth-child(2) { animation-delay: 90ms; }
.card:nth-child(3) { animation-delay: 140ms; }
.card:nth-child(4) { animation-delay: 190ms; }
.card::after {
  content: "→";
  position: absolute;
  top: 1.2rem;
  right: 1.2rem;
  color: var(--outline);
  font-size: 1rem;
  transition: transform var(--dur) var(--ease), color var(--dur) var(--ease);
}
.card:hover {
  border-color: var(--primary-fixed-dim);
  box-shadow: var(--shadow);
  transform: translateY(-1px);
  background: linear-gradient(180deg, #fff 0%, var(--primary-pale) 100%);
  text-decoration: none !important;
}
.card:hover::after {
  color: var(--primary);
  transform: translateX(4px);
}
.card:active { transform: none; }
.card .icon {
  width: 42px;
  height: 42px;
  border-radius: 11px;
  background: linear-gradient(160deg, var(--primary-fixed), #fff);
  border: 1px solid var(--primary-fixed-dim);
  color: var(--primary);
  display: grid;
  place-items: center;
  margin-bottom: 0.95rem;
  transition: transform var(--dur) var(--ease), box-shadow var(--dur) var(--ease);
}
.card:hover .icon {
  transform: scale(1.03);
  box-shadow: 0 2px 6px var(--primary-tint);
}
.card .icon svg { width: 20px; height: 20px; }
.card h3 {
  margin: 0 0 0.4rem;
  font-size: 1.05rem;
  letter-spacing: -0.02em;
  font-weight: 700;
  padding-right: 1.5rem;
  color: var(--primary);
}
.card p {
  margin: 0;
  color: var(--secondary);
  font-size: 0.9rem;
  line-height: 1.5;
}

.section-title {
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: var(--outline);
  margin: 2.25rem 0 0.85rem;
}
.popular { display: grid; gap: 0.45rem; }
.popular a {
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 1rem;
  padding: 0.85rem 1rem;
  border: 1px solid var(--outline-variant);
  border-radius: 11px;
  background: var(--bg-elevated);
  color: var(--primary);
  text-decoration: none !important;
  font-weight: 600;
  font-size: 0.92rem;
  box-shadow: var(--shadow-sm);
  transition:
    border-color var(--dur) var(--ease),
    box-shadow var(--dur) var(--ease),
    transform var(--dur) var(--ease),
    background var(--dur) var(--ease);
}
.popular a:hover {
  border-color: var(--primary-fixed-dim);
  box-shadow: var(--shadow-sm);
  transform: none;
  background: var(--primary-pale);
}
.popular a span {
  color: var(--secondary);
  font-size: 0.72rem;
  font-weight: 600;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  background: var(--secondary-container);
  border-radius: 999px;
  padding: 0.2rem 0.55rem;
}

/* ── Components ── */
.callout {
  border: 1px solid var(--primary-fixed-dim);
  background: linear-gradient(135deg, var(--primary-pale), #fff);
  border-radius: 12px;
  padding: 1rem 1.1rem;
  margin: 1.15rem 0;
  color: var(--on-surface-variant);
  box-shadow: var(--shadow-sm);
  transition: box-shadow var(--dur) var(--ease);
  font-size: 0.98rem;
  line-height: 1.55;
}
.callout:hover { box-shadow: var(--shadow-sm); }
.callout.warn {
  background: linear-gradient(135deg, var(--warn-bg), #fff);
  border-color: var(--warn-border);
  color: var(--warn-ink);
}
.callout p { margin: 0.35rem 0 0; }
.callout p:first-child { margin-top: 0; }
.callout strong.title {
  display: block;
  font-size: 1.02rem;
  font-weight: 700;
  color: var(--primary);
  margin: 0 0 0.35rem;
  letter-spacing: -0.01em;
}
.callout.warn strong.title { color: var(--warn-ink); }

.steps {
  counter-reset: step;
  list-style: none;
  padding: 0.25rem 0 0;
  margin: 0.85rem 0 1.35rem;
}
.steps li {
  counter-increment: step;
  position: relative;
  padding: 0.1rem 0 1rem 2.65rem;
  border-left: 1px solid var(--outline-variant);
  margin-left: 0.85rem;
  color: var(--on-surface-variant);
  transition: color var(--dur) var(--ease);
}
.steps li:last-child {
  border-left-color: transparent;
  padding-bottom: 0.15rem;
}
.steps li::before {
  content: counter(step);
  position: absolute;
  left: -0.85rem;
  top: 0;
  width: 1.7rem;
  height: 1.7rem;
  border-radius: 50%;
  background: linear-gradient(145deg, var(--primary), var(--primary-container));
  color: var(--on-primary);
  font-size: 0.75rem;
  font-weight: 700;
  display: grid;
  place-items: center;
  box-shadow: 0 0 0 3px var(--bg), 0 1px 4px var(--primary-shadow);
  transition: transform var(--dur) var(--ease), box-shadow var(--dur) var(--ease);
}
.steps li:hover::before {
  transform: scale(1.04);
  box-shadow: 0 0 0 3px var(--bg), 0 2px 6px var(--primary-shadow);
}

.table-wrap {
  margin: 1rem 0 1.4rem;
  border: 1px solid var(--outline-variant);
  border-radius: 12px;
  overflow: hidden;
  background: var(--bg-elevated);
  box-shadow: var(--shadow-sm);
  transition: box-shadow var(--dur) var(--ease);
}
.table-wrap:hover { box-shadow: var(--shadow-sm); }
table {
  width: 100%;
  border-collapse: collapse;
  margin: 0;
  font-size: 0.9rem;
}
th, td {
  border-bottom: 1px solid var(--outline-variant);
  padding: 0.75rem 0.9rem;
  text-align: left;
  vertical-align: top;
}
tr { transition: background var(--dur) var(--ease); }
tr:hover td { background: rgba(238, 244, 255, 0.55); }
tr:last-child td { border-bottom: 0; }
th {
  background: var(--primary-surface);
  font-weight: 600;
  color: var(--primary);
  font-size: 0.8rem;
  letter-spacing: 0.01em;
}
td { color: var(--on-surface-variant); }

kbd, .path {
  font-family: var(--mono);
  font-size: 0.82em;
  background: var(--surface-low);
  border: 1px solid var(--outline-variant);
  border-radius: 6px;
  padding: 0.1rem 0.4rem;
  color: var(--primary);
}

.related {
  margin-top: 2.75rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--outline-variant);
}
.related h2 {
  margin: 0 0 0.85rem !important;
  font-size: 0.95rem !important;
}
.related h2::before { display: none !important; }
.related-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: 0.7rem;
}
.related-grid a {
  border: 1px solid var(--outline-variant);
  border-radius: 11px;
  padding: 0.9rem 1rem;
  color: var(--primary);
  text-decoration: none !important;
  background: var(--bg-elevated);
  font-weight: 600;
  font-size: 0.9rem;
  box-shadow: var(--shadow-sm);
  transition:
    border-color var(--dur) var(--ease),
    box-shadow var(--dur) var(--ease),
    transform var(--dur) var(--ease),
    background var(--dur) var(--ease);
}
.related-grid a:hover {
  border-color: var(--primary-fixed-dim);
  box-shadow: var(--shadow-sm);
  transform: none;
  background: var(--primary-pale);
}
.related-grid small {
  display: block;
  color: var(--secondary);
  margin-top: 0.25rem;
  font-weight: 500;
  font-size: 0.8rem;
}

.pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 0.75rem;
  margin-top: 2.5rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--outline-variant);
}
.pager a {
  display: block;
  border: 1px solid var(--outline-variant);
  border-radius: 12px;
  padding: 0.95rem 1.05rem;
  text-decoration: none !important;
  background: var(--bg-elevated);
  color: var(--primary);
  box-shadow: var(--shadow-sm);
  transition:
    border-color var(--dur) var(--ease),
    box-shadow var(--dur) var(--ease),
    transform var(--dur) var(--ease),
    background var(--dur) var(--ease);
}
.pager a:hover {
  border-color: var(--primary-fixed-dim);
  box-shadow: var(--shadow-sm);
  transform: none;
  background: var(--primary-pale);
}
.pager a span {
  display: block;
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--outline);
  margin-bottom: 0.25rem;
}
.pager a strong { font-size: 0.92rem; font-weight: 600; }
.pager a.next { text-align: right; }
.pager a.disabled { opacity: 0.35; pointer-events: none; }

.footer-note {
  max-width: var(--content-max);
  margin: 2.5rem auto 0;
  color: var(--outline);
  font-size: 0.82rem;
  text-align: center;
  font-weight: 500;
}
.site-footer {
  max-width: 960px;
  margin: 3rem auto 0;
  padding-top: 1.5rem;
  border-top: 1px solid var(--outline-variant);
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  gap: 0.75rem;
  color: var(--outline);
  font-size: 0.8rem;
  font-weight: 500;
}
.site-footer a { color: var(--secondary); text-decoration: none !important; transition: color var(--dur) var(--ease); }
.site-footer a:hover { color: var(--primary); }

/* FAQ */
details.faq {
  border: 1px solid var(--outline-variant);
  border-radius: 11px;
  background: var(--bg-elevated);
  padding: 0.9rem 1.05rem;
  margin: 0.55rem 0;
  box-shadow: var(--shadow-sm);
  transition:
    border-color var(--dur) var(--ease),
    box-shadow var(--dur) var(--ease),
    transform var(--dur) var(--ease);
}
details.faq:hover { transform: none; box-shadow: var(--shadow-sm); }
details.faq[open] {
  border-color: var(--primary-fixed-dim);
  background: linear-gradient(180deg, #fff, var(--primary-pale));
}
details.faq summary {
  cursor: pointer;
  font-weight: 600;
  color: var(--primary);
  list-style: none;
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  align-items: center;
}
details.faq summary::-webkit-details-marker { display: none; }
details.faq summary::after {
  content: "+";
  color: var(--outline);
  font-weight: 500;
  font-size: 1.1rem;
  line-height: 1;
  transition: transform var(--dur) var(--ease), color var(--dur) var(--ease);
}
details.faq[open] summary::after {
  content: "–";
  color: var(--primary);
  transform: rotate(180deg);
}
details.faq p {
  margin: 0.65rem 0 0.1rem;
  color: var(--secondary);
  font-size: 0.95rem;
  animation: fade-up 240ms var(--ease-out) both;
}

/* Search dropdown */
.search-results {
  display: none;
  position: absolute;
  top: calc(100% + 8px);
  left: 0;
  right: 0;
  background: #fff;
  border: 1px solid var(--outline-variant);
  border-radius: 12px;
  box-shadow: var(--shadow);
  max-height: 360px;
  overflow: auto;
  z-index: 60;
  padding: 0.35rem;
  opacity: 0;
  transform: translateY(4px);
  transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.search-results.open {
  display: block;
  opacity: 1;
  transform: translateY(0);
  animation: pop var(--dur) var(--ease-out) both;
}
.search-results a {
  display: block;
  padding: 0.7rem 0.8rem;
  color: var(--on-surface);
  text-decoration: none !important;
  border-radius: 8px;
  font-size: 0.9rem;
  transition: background var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.search-results a:hover {
  background: var(--nav-active-bg);
  transform: translateX(2px);
}
.search-results a strong { font-weight: 600; color: var(--primary); }
.search-results a small {
  display: block;
  color: var(--outline);
  font-size: 0.75rem;
  margin-top: 0.15rem;
  font-weight: 600;
  letter-spacing: 0.03em;
  text-transform: uppercase;
}

.sidebar-backdrop {
  display: none;
  position: fixed;
  inset: var(--top-h) 0 0 0;
  background: rgba(13, 27, 42, 0.45);
  backdrop-filter: blur(3px);
  z-index: 35;
  opacity: 0;
  transition: opacity var(--dur-slow) var(--ease);
}
body.nav-open .sidebar-backdrop {
  display: block;
  opacity: 1;
  animation: fade-in var(--dur) var(--ease) both;
}

@media (max-width: 1100px) {
  .shell { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }
  .toc { display: none; }
}

/* Tablet + phone: single-row topbar with search icon */
@media (max-width: 900px) {
  :root { --top-h: 54px; }

  .menu-btn { display: inline-grid; }

  .topbar {
    display: flex;
    flex-wrap: nowrap;
    align-items: center;
    gap: 0.45rem;
    height: var(--top-h);
    min-height: var(--top-h);
    padding: 0 0.75rem;
    position: sticky;
  }

  .brand {
    min-width: 0;
    flex: 1 1 auto;
  }

  .search-toggle {
    display: inline-grid;
    margin-left: auto;
  }

  .search-wrap {
    display: none;
    position: absolute;
    inset: 0;
    z-index: 6;
    margin: 0;
    max-width: none;
    width: 100%;
    padding: 0 0.65rem;
    align-items: center;
    gap: 0.45rem;
    background: rgba(247, 250, 252, 0.98);
    backdrop-filter: blur(12px);
    -webkit-backdrop-filter: blur(12px);
  }

  .topbar.is-search-open .search-wrap {
    display: flex;
  }

  .topbar.scrolled.is-search-open .search-wrap {
    background: rgba(255, 255, 255, 0.96);
  }

  .search-wrap > svg {
    position: static;
    transform: none;
    flex-shrink: 0;
  }

  .search-wrap input {
    flex: 1 1 auto;
    min-width: 0;
    height: 38px;
    padding: 0 0.75rem;
    font-size: 0.9rem;
  }

  .search-close {
    display: inline-grid;
  }

  .search-kbd { display: none; }

  .search-results {
    left: 0.65rem;
    right: 0.65rem;
    width: auto;
  }

  .top-links {
    gap: 0;
    flex-shrink: 0;
  }
  .top-links .hide-sm { display: none; }
  .top-links a.btn-support {
    margin-left: 0;
    padding: 0.4rem 0.7rem;
    font-size: 0.8rem;
    white-space: nowrap;
  }

  .shell, .shell.no-toc { grid-template-columns: 1fr; }
  .sidebar {
    position: fixed;
    left: 0;
    top: var(--top-h);
    width: min(88vw, 310px);
    z-index: 40;
    transform: translateX(-105%);
    transition: transform var(--dur-slow) var(--ease);
    background: #fff;
    box-shadow: var(--shadow-lg);
    animation: none;
  }
  body.nav-open .sidebar { transform: translateX(0); }
  .content { padding: 1.35rem 1.1rem 3rem; }
  .cards { grid-template-columns: 1fr; }
  .pager {
    grid-template-columns: 1fr 1fr;
    gap: 0.55rem;
  }
  .pager a {
    padding: 0.75rem 0.7rem;
    border-radius: 10px;
    min-width: 0;
  }
  .pager a span {
    font-size: 0.65rem;
    margin-bottom: 0.2rem;
  }
  .pager a strong {
    font-size: 0.82rem;
    line-height: 1.25;
    display: -webkit-box;
    -webkit-line-clamp: 2;
    -webkit-box-orient: vertical;
    overflow: hidden;
  }
  .pager a.next { text-align: right; }
}

@media (max-width: 640px) {
  :root { --top-h: 52px; }

  .topbar {
    gap: 0.4rem;
    padding: 0 0.7rem;
    height: var(--top-h);
    min-height: var(--top-h);
  }

  .menu-btn,
  .search-toggle,
  .search-close {
    width: 36px;
    height: 36px;
    border-radius: 8px;
  }

  .brand {
    gap: 0.4rem;
    font-size: 0.86rem;
  }

  .brand-mark {
    width: 28px;
    height: 28px;
    border-radius: 7px;
  }

  .search-wrap input {
    height: 36px;
    font-size: 0.88rem;
    padding: 0 0.7rem;
    border-radius: 9px;
  }

  .top-links a.btn-support {
    padding: 0.38rem 0.6rem;
    font-size: 0.76rem;
    border-radius: 8px;
  }

  .content {
    padding: 1.1rem 0.9rem 2.5rem;
  }

  .hero-docs {
    padding-top: 0.15rem;
  }

  .hero-docs h1 {
    font-size: clamp(1.55rem, 7.2vw, 1.95rem);
    line-height: 1.15;
    margin-bottom: 0.55rem;
  }

  .hero-docs .lead {
    font-size: 0.95rem;
    line-height: 1.5;
    margin-bottom: 1.25rem;
  }

  .cards {
    gap: 0.75rem;
    margin-bottom: 1.75rem;
  }

  .card {
    padding: 1.05rem 1rem 1.15rem;
    border-radius: 12px;
  }

  .card::after {
    top: 1.05rem;
    right: 0.95rem;
  }

  .card .icon {
    width: 38px;
    height: 38px;
    border-radius: 10px;
    margin-bottom: 0.75rem;
  }

  .card .icon svg {
    width: 18px;
    height: 18px;
  }

  .card h3 {
    font-size: 1rem;
    padding-right: 1.35rem;
  }

  .card p {
    font-size: 0.88rem;
    line-height: 1.45;
  }

  .section-title {
    margin: 1.75rem 0 0.7rem;
  }

  .popular a {
    flex-direction: column;
    align-items: flex-start;
    gap: 0.35rem;
    padding: 0.8rem 0.9rem;
    font-size: 0.9rem;
  }

  .popular a span {
    align-self: flex-start;
  }

  .callout {
    padding: 0.95rem 1rem;
    font-size: 0.9rem;
  }

  .site-footer {
    flex-direction: column;
    align-items: flex-start;
    gap: 0.45rem;
    font-size: 0.82rem;
  }

  .article h1 {
    font-size: clamp(1.45rem, 6.5vw, 1.85rem);
  }

  .article h2 {
    font-size: 1.2rem;
  }
}

@media (max-width: 420px) {
  :root { --top-h: 50px; }

  .topbar {
    gap: 0.35rem;
    padding: 0 0.6rem;
  }

  .brand .sep,
  .brand .product {
    display: none;
  }

  .brand {
    font-size: 0.84rem;
  }

  .menu-btn,
  .search-toggle,
  .search-close {
    width: 34px;
    height: 34px;
  }

  .top-links a.btn-support {
    padding: 0.34rem 0.5rem;
    font-size: 0.72rem;
  }

  .content {
    padding: 1rem 0.75rem 2.25rem;
  }

  .hero-docs h1 {
    font-size: 1.45rem;
  }

  .card h3 {
    font-size: 0.95rem;
  }
}

@media print {
  .topbar, .sidebar, .toc, .sidebar-backdrop, .menu-btn, .pager, .search-wrap { display: none !important; }
  .shell { display: block; }
  .content { padding: 0; }
  .content > .hero-docs,
  .content > .article { animation: none; }
}