/* ── Global Styles — address-normalization.com ───────────────────────────── */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap');

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

html {
  scroll-behavior: smooth;
  scroll-padding-top: calc(var(--header-height) + 1.5rem);
  font-size: 16px;
  -webkit-text-size-adjust: 100%;
}

body {
  font-family: var(--font-sans);
  font-size: var(--font-size-base);
  line-height: 1.7;
  color: var(--color-text);
  background: var(--color-bg);
  min-height: 100dvh;
  display: flex;
  flex-direction: column;
}

img, video, svg { max-width: 100%; display: block; }
button { font-family: inherit; cursor: pointer; }

/* ── Layout wrapper ─────────────────────────────────────────────────────────── */
.site-wrap {
  width: 100%;
  max-width: var(--content-max);
  margin-inline: auto;
  padding-inline: var(--space-lg);
}

@media (min-width: 768px)  { .site-wrap { padding-inline: var(--space-xl); } }
@media (min-width: 1024px) { .site-wrap { padding-inline: var(--space-2xl); } }
@media (min-width: 1440px) { .site-wrap { padding-inline: var(--space-3xl); } }

main { flex: 1; }

/* ── Typography ─────────────────────────────────────────────────────────────── */
h1,h2,h3,h4,h5,h6 {
  font-family: var(--font-sans);
  color: var(--color-heading);
  line-height: 1.25;
  font-weight: 700;
}
h1 { font-size: clamp(1.875rem, 4vw, 3rem); margin-bottom: var(--space-lg); }
h2 { font-size: clamp(1.375rem, 2.5vw, 2rem); margin-top: var(--space-2xl); margin-bottom: var(--space-md); border-bottom: 2px solid var(--color-border); padding-bottom: var(--space-sm); }
h3 { font-size: clamp(1.125rem, 2vw, 1.5rem); margin-top: var(--space-xl); margin-bottom: var(--space-sm); color: var(--color-slate-800); }
h4 { font-size: var(--font-size-lg); margin-top: var(--space-lg); margin-bottom: var(--space-xs); color: var(--color-slate-700); }
h5,h6 { font-size: var(--font-size-base); margin-top: var(--space-md); }

p { margin-bottom: var(--space-md); max-width: none; }

/* ── Links ──────────────────────────────────────────────────────────────────── */
a {
  color: var(--color-link);
  text-decoration: underline;
  text-decoration-color: transparent;
  text-underline-offset: 3px;
  transition: color var(--transition-fast), text-decoration-color var(--transition-fast);
}
a:hover {
  color: var(--color-link-hover);
  text-decoration-color: var(--color-link-hover);
}

/* ── Lists (global baseline — overridden in .content-body) ──────────────────── */
ul, ol { margin-bottom: var(--space-md); padding-left: var(--space-xl); }
li { margin-bottom: var(--space-xs); line-height: 1.7; }
ul ul, ol ol, ul ol, ol ul { margin-top: var(--space-xs); margin-bottom: 0; }

/* ── Inline code ─────────────────────────────────────────────────────────────── */
:not(pre) > code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--color-code-bg);
  color: var(--color-slate-700);
  padding: 0.1em 0.35em;
  border-radius: var(--radius-sm);
  border: none;
}

/* ── Code blocks ─────────────────────────────────────────────────────────────── */
pre {
  position: relative;
  background: var(--color-pre-bg) !important;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-lg) var(--space-xl) var(--space-lg) var(--space-lg);
  overflow-x: auto;
  margin-bottom: var(--space-lg);
  box-shadow: var(--shadow-sm);
  font-size: var(--font-size-sm);
  line-height: 1.6;
}
pre code {
  background: none !important;
  border: none;
  padding: 0;
  font-family: var(--font-mono);
  font-size: inherit;
}

/* ── Tables ─────────────────────────────────────────────────────────────────── */
.table-scroll { overflow-x: auto; -webkit-overflow-scrolling: touch; margin-bottom: var(--space-lg); border-radius: var(--radius-md); box-shadow: var(--shadow-sm); }
table { width: 100%; border-collapse: collapse; font-size: var(--font-size-sm); background: var(--color-surface); }
thead { background: var(--color-slate-800); color: #fff; }
thead th { padding: var(--space-sm) var(--space-md); text-align: left; font-weight: 600; white-space: nowrap; }
tbody tr { border-bottom: 1px solid var(--color-border); transition: background var(--transition-fast); }
tbody tr:hover { background: var(--color-slate-50); }
tbody td { padding: var(--space-sm) var(--space-md); vertical-align: top; }
tbody tr:nth-child(even) { background: var(--color-slate-50); }
tbody tr:nth-child(even):hover { background: var(--color-slate-100); }

/* ── Blockquote ──────────────────────────────────────────────────────────────── */
blockquote {
  border-left: 4px solid var(--color-orange-400);
  background: var(--color-surface-2);
  padding: var(--space-md) var(--space-lg);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  margin-bottom: var(--space-lg);
  color: var(--color-slate-600);
}

/* ── Horizontal rule ─────────────────────────────────────────────────────────── */
hr { border: none; border-top: 2px solid var(--color-border); margin: var(--space-2xl) 0; }

/* ── Interactive checkboxes ─────────────────────────────────────────────────── */
.content-body li:has(> input[type="checkbox"]) {
  list-style: none;
  margin-left: calc(-1 * var(--space-xl));
  padding-left: var(--space-xl);
  position: relative;
}
/* Suppress custom bullet for checkbox list items */
.content-body ul > li:has(> input[type="checkbox"])::before {
  display: none;
}
.content-body input[type="checkbox"] {
  appearance: none;
  -webkit-appearance: none;
  width: 1.1em;
  height: 1.1em;
  border: 2px solid var(--color-slate-400);
  border-radius: var(--radius-sm);
  vertical-align: middle;
  cursor: pointer;
  position: relative;
  transition: background var(--transition-fast), border-color var(--transition-fast);
  flex-shrink: 0;
  margin-right: 0.4em;
}
.content-body input[type="checkbox"]:checked {
  background: var(--color-orange-500);
  border-color: var(--color-orange-500);
}
.content-body input[type="checkbox"]:checked::after {
  content: '✓';
  position: absolute;
  inset: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 0.7em;
  color: #fff;
  line-height: 1;
  top: -1px;
  left: 1px;
}
.content-body input[type="checkbox"]:checked ~ * {
  text-decoration: line-through;
  color: var(--color-slate-400);
}

/* ── Mermaid Diagrams ────────────────────────────────────────────────────────── */
.mermaid {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-lg);
  overflow-x: auto;
  margin-bottom: var(--space-lg);
  text-align: center;
}

/* ── Copy button ─────────────────────────────────────────────────────────────── */
.copy-btn {
  position: absolute;
  top: var(--space-sm);
  right: var(--space-sm);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  color: var(--color-slate-500);
  font-size: var(--font-size-xs);
  font-family: var(--font-sans);
  padding: 0.2em 0.6em;
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--transition-fast), background var(--transition-fast), color var(--transition-fast);
  white-space: nowrap;
  z-index: 2;
}
pre:hover .copy-btn { opacity: 1; }
.copy-btn:hover { background: var(--color-orange-500); border-color: var(--color-orange-500); color: #fff; }
.copy-btn.copied { background: #22c55e; border-color: #22c55e; color: #fff; opacity: 1; }

/* ── Accordions / FAQ ────────────────────────────────────────────────────────── */
details.faq {
  border: 1px solid var(--color-border);
  border-left: 4px solid var(--color-orange-500);
  border-radius: var(--radius-md);
  background: var(--color-surface);
  margin-bottom: var(--space-sm);
  overflow: hidden;
}
details.faq summary {
  padding: var(--space-md) var(--space-lg);
  font-weight: 600;
  color: var(--color-slate-800);
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: var(--space-sm);
  list-style: none;
  user-select: none;
  transition: background var(--transition-fast);
}
details.faq summary::-webkit-details-marker { display: none; }
details.faq summary::before {
  content: '▶';
  font-size: 0.65em;
  color: var(--color-orange-500);
  transition: transform var(--transition-base);
  flex-shrink: 0;
}
details.faq[open] summary::before { transform: rotate(90deg); }
details.faq summary:hover { background: var(--color-slate-50); }
details.faq .faq-body {
  padding: var(--space-sm) var(--space-lg) var(--space-lg);
  border-top: 1px solid var(--color-border);
  color: var(--color-text);
}

/* ── Breadcrumbs ─────────────────────────────────────────────────────────────── */
.breadcrumbs {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-xs);
  align-items: center;
  font-size: var(--font-size-sm);
  color: var(--color-text-muted);
  margin-bottom: var(--space-xl);
  padding: var(--space-sm) 0;
}
.breadcrumbs a { color: var(--color-text-muted); text-decoration: none; }
.breadcrumbs a:hover { color: var(--color-link-hover); }
.breadcrumbs .sep { color: var(--color-slate-300); }
.breadcrumbs .current { color: var(--color-slate-600); font-weight: 500; }

/* ── Header ──────────────────────────────────────────────────────────────────── */
.site-header {
  position: sticky;
  top: 0;
  z-index: 100;
  height: var(--header-height);
  background: var(--color-surface);
  border-bottom: 1px solid var(--color-border);
  box-shadow: var(--shadow-sm);
}
.header-inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 100%;
}
.header-logo {
  display: flex;
  align-items: center;
  gap: var(--space-sm);
  text-decoration: none;
  color: var(--color-heading);
  font-weight: 700;
  font-size: var(--font-size-lg);
  white-space: nowrap;
  transition: opacity var(--transition-fast);
}
.header-logo:hover { opacity: 0.85; color: var(--color-heading); text-decoration: none; }
.header-logo svg { width: 36px; height: 36px; flex-shrink: 0; }
.header-logo-text { display: none; }
@media (min-width: 640px) { .header-logo-text { display: block; } }

.site-nav {
  display: flex;
  align-items: center;
  gap: var(--space-xs);
}
.nav-link {
  display: flex;
  align-items: center;
  gap: var(--space-xs);
  padding: var(--space-xs) var(--space-md);
  border-radius: var(--radius-md);
  font-size: var(--font-size-sm);
  font-weight: 500;
  color: var(--color-text);
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast);
  white-space: nowrap;
}
.nav-link:hover { background: var(--color-slate-100); color: var(--color-link-hover); text-decoration: none; }
.nav-link.active { background: var(--color-orange-500); color: #fff; }
.nav-link.active:hover { background: var(--color-orange-600); color: #fff; }
.nav-link svg { width: 16px; height: 16px; }

/* Hamburger */
.hamburger {
  display: none;
  flex-direction: column;
  gap: 5px;
  background: none;
  border: none;
  padding: var(--space-sm);
  cursor: pointer;
  border-radius: var(--radius-sm);
}
.hamburger span {
  display: block;
  width: 22px;
  height: 2px;
  background: var(--color-slate-600);
  border-radius: 2px;
  transition: all var(--transition-fast);
}
.hamburger.open span:nth-child(1) { transform: rotate(45deg) translate(5px, 5px); }
.hamburger.open span:nth-child(2) { opacity: 0; }
.hamburger.open span:nth-child(3) { transform: rotate(-45deg) translate(5px, -5px); }

@media (max-width: 767px) {
  .hamburger { display: flex; }
  .site-nav {
    display: none;
    position: absolute;
    top: var(--header-height);
    left: 0; right: 0;
    background: var(--color-surface);
    border-bottom: 1px solid var(--color-border);
    flex-direction: column;
    align-items: flex-start;
    padding: var(--space-md);
    gap: var(--space-xs);
    box-shadow: var(--shadow-md);
  }
  .site-nav.open { display: flex; }
  .nav-link { width: 100%; padding: var(--space-sm) var(--space-md); }
}

/* ── Footer ──────────────────────────────────────────────────────────────────── */
.site-footer {
  background: var(--footer-bg);
  color: var(--footer-text);
  padding: var(--space-2xl) 0 var(--space-xl);
  margin-top: auto;
}
.footer-inner {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-xl);
}
@media (min-width: 768px) { .footer-inner { grid-template-columns: repeat(3, 1fr); } }

.footer-section h3 {
  color: #fff;
  font-size: var(--font-size-sm);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  margin-bottom: var(--space-md);
  margin-top: 0;
  border: none;
  padding: 0;
}
.footer-section ul { list-style: none; padding: 0; margin: 0; }
.footer-section li { margin-bottom: var(--space-sm); }
.footer-section a { color: var(--color-slate-400); text-decoration: none; font-size: var(--font-size-sm); transition: color var(--transition-fast); }
.footer-section a:hover { color: var(--color-orange-400); }
.footer-bottom {
  margin-top: var(--space-xl);
  padding-top: var(--space-lg);
  border-top: 1px solid var(--color-slate-700);
  text-align: center;
  font-size: var(--font-size-sm);
  color: var(--color-slate-500);
}

/* ── Page layout ─────────────────────────────────────────────────────────────── */
.page-container {
  padding-top: var(--space-2xl);
  padding-bottom: var(--space-3xl);
}
/* Full container width — no narrow column constraint */
.page-prose {
  width: 100%;
}
.content-body h1 { color: var(--color-orange-500); }
.content-body h2 { color: var(--color-slate-800); }
.content-body h3 { color: var(--color-blue-700); }

/* ── Styled lists ────────────────────────────────────────────────────────────── */
.content-body ul,
.content-body ol {
  margin-bottom: var(--space-lg);
  padding-left: var(--space-xl);
  display: flex;
  flex-direction: column;
  gap: var(--space-xs);
}
/* Unordered — custom orange square bullet */
.content-body ul {
  list-style: none;
  padding-left: var(--space-lg);
}
.content-body ul > li {
  position: relative;
  padding-left: var(--space-lg);
  line-height: 1.7;
  color: var(--color-text);
  margin-bottom: 0;
}
.content-body ul > li::before {
  content: '';
  position: absolute;
  left: 0;
  top: 0.55em;
  width: 7px;
  height: 7px;
  background: var(--color-orange-500);
  border-radius: 2px;
  flex-shrink: 0;
}
/* Nested unordered — smaller blue bullet */
.content-body ul ul > li::before {
  background: var(--color-blue-600);
  width: 5px;
  height: 5px;
  border-radius: 50%;
  top: 0.6em;
}
/* Ordered — styled counter */
.content-body ol {
  list-style: none;
  counter-reset: ol-counter;
  padding-left: var(--space-lg);
}
.content-body ol > li {
  position: relative;
  padding-left: var(--space-xl);
  counter-increment: ol-counter;
  line-height: 1.7;
  color: var(--color-text);
  margin-bottom: 0;
}
.content-body ol > li::before {
  content: counter(ol-counter);
  position: absolute;
  left: 0;
  top: 0.1em;
  width: 1.5em;
  height: 1.5em;
  background: var(--color-blue-700);
  color: #fff;
  font-size: var(--font-size-xs);
  font-weight: 700;
  border-radius: var(--radius-sm);
  display: flex;
  align-items: center;
  justify-content: center;
  line-height: 1;
  flex-shrink: 0;
}
/* Nested ordered resets */
.content-body ol ol {
  counter-reset: ol-counter;
}
.content-body ol ol > li::before {
  background: var(--color-slate-500);
}
/* li spacing within nested lists */
.content-body ul ul,
.content-body ol ol,
.content-body ul ol,
.content-body ol ul {
  margin-top: var(--space-xs);
  margin-bottom: 0;
  gap: 0;
}

/* ── Section layout ─────────────────────────────────────────────────────────── */
.section-hero {
  background: linear-gradient(135deg, var(--color-slate-800) 0%, var(--color-blue-900) 100%);
  color: #fff;
  padding: var(--space-3xl) 0;
  margin-bottom: var(--space-2xl);
}
.section-hero h1 { color: #fff; margin-bottom: var(--space-md); }
.section-hero p { color: var(--color-slate-300); max-width: 70ch; font-size: var(--font-size-lg); }

.card-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-lg);
  margin-bottom: var(--space-2xl);
}
@media (min-width: 640px) { .card-grid { grid-template-columns: repeat(2, 1fr); } }
@media (min-width: 1024px) { .card-grid { grid-template-columns: repeat(3, 1fr); } }

.card {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--space-xl);
  text-decoration: none;
  color: inherit;
  display: block;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.card:hover {
  transform: translateY(-3px);
  box-shadow: var(--shadow-lg);
  border-color: var(--color-orange-400);
  text-decoration: none;
  color: inherit;
}
.card-icon { font-size: 2rem; margin-bottom: var(--space-sm); }
.card-title { font-size: var(--font-size-lg); font-weight: 700; color: var(--color-heading); margin-bottom: var(--space-sm); }
.card-desc { font-size: var(--font-size-sm); color: var(--color-text-muted); line-height: 1.6; max-width: none; }
.card-arrow { margin-top: var(--space-md); font-size: var(--font-size-sm); color: var(--color-orange-500); font-weight: 600; }

/* ── Home hero ───────────────────────────────────────────────────────────────── */
.home-hero {
  background: linear-gradient(135deg, var(--color-slate-900) 0%, var(--color-blue-900) 60%, var(--color-slate-800) 100%);
  padding: calc(var(--space-3xl) * 1.5) 0;
  position: relative;
  overflow: hidden;
}
.home-hero::before {
  content: '';
  position: absolute;
  inset: 0;
  background: radial-gradient(ellipse at 80% 50%, rgba(249,115,22,.15) 0%, transparent 60%);
  pointer-events: none;
}
.home-hero-inner { position: relative; }
.home-hero h1 {
  color: #fff;
  font-size: clamp(2rem, 5vw, 3.5rem);
  margin-bottom: var(--space-lg);
  line-height: 1.15;
}
.home-hero h1 span { color: var(--color-orange-400); }
.home-hero-desc {
  color: var(--color-slate-300);
  font-size: clamp(1rem, 2vw, 1.25rem);
  max-width: 65ch;
  margin-bottom: var(--space-2xl);
}
.hero-cta {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-md);
}
.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-sm);
  padding: var(--space-md) var(--space-xl);
  border-radius: var(--radius-md);
  font-size: var(--font-size-base);
  font-weight: 600;
  text-decoration: none;
  transition: transform var(--transition-fast), box-shadow var(--transition-fast), background var(--transition-fast);
  cursor: pointer;
  border: none;
}
.btn:hover { transform: translateY(-2px); box-shadow: var(--shadow-md); text-decoration: none; }
.btn-primary { background: var(--color-orange-500); color: #fff; }
.btn-primary:hover { background: var(--color-orange-600); color: #fff; }
.btn-secondary { background: rgba(255,255,255,.1); color: #fff; border: 1px solid rgba(255,255,255,.25); }
.btn-secondary:hover { background: rgba(255,255,255,.2); color: #fff; }
.btn svg { width: 20px; height: 20px; flex-shrink: 0; }

/* ── Home content ─────────────────────────────────────────────────────────────── */
.home-sections { padding: var(--space-3xl) 0; }
.home-sections-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-2xl);
}
@media (min-width: 1024px) { .home-sections-grid { grid-template-columns: repeat(2, 1fr); } }

.section-block { }
.section-block-header {
  display: flex;
  align-items: center;
  gap: var(--space-md);
  margin-bottom: var(--space-lg);
}
.section-block-icon {
  width: 48px; height: 48px;
  background: linear-gradient(135deg, var(--color-orange-400), var(--color-orange-600));
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
}
.section-block-icon svg { width: 24px; height: 24px; color: #fff; }
.section-block h2 {
  font-size: var(--font-size-xl);
  margin: 0;
  padding: 0;
  border: none;
  color: var(--color-heading);
}
.section-block p { color: var(--color-text); margin-bottom: var(--space-lg); }

.topic-list { list-style: none; padding: 0; margin: 0 0 var(--space-lg); }
.topic-list li { border-bottom: 1px solid var(--color-border); }
.topic-list a {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-sm) 0;
  color: var(--color-link);
  text-decoration: none;
  font-size: var(--font-size-sm);
  font-weight: 500;
  transition: color var(--transition-fast);
}
.topic-list a:hover { color: var(--color-link-hover); }
.topic-list a::after { content: '→'; opacity: 0.5; transition: opacity var(--transition-fast), transform var(--transition-fast); }
.topic-list a:hover::after { opacity: 1; transform: translateX(4px); }

/* ── Related nav ─────────────────────────────────────────────────────────────── */
.related-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-md);
  margin-top: var(--space-3xl);
  padding-top: var(--space-xl);
  border-top: 2px solid var(--color-border);
}
.related-nav-item {
  display: block;
  padding: var(--space-md) var(--space-lg);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  text-decoration: none;
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}
.related-nav-item:hover { border-color: var(--color-orange-400); box-shadow: var(--shadow-sm); text-decoration: none; }
.related-nav-item.next { text-align: right; }
.related-nav-label { font-size: var(--font-size-xs); text-transform: uppercase; letter-spacing: 0.08em; color: var(--color-text-muted); margin-bottom: var(--space-xs); }
.related-nav-title { font-size: var(--font-size-sm); font-weight: 600; color: var(--color-link); }
.related-nav-item:hover .related-nav-title { color: var(--color-link-hover); }
@media (max-width: 640px) { .related-nav { grid-template-columns: 1fr; } }

/* ── Utility ─────────────────────────────────────────────────────────────────── */
.sr-only { position:absolute; width:1px; height:1px; padding:0; margin:-1px; overflow:hidden; clip:rect(0,0,0,0); white-space:nowrap; border-width:0; }
.text-orange { color: var(--color-orange-500); }
.text-blue { color: var(--color-blue-600); }