/* ============================================================
   docs.css — /docs/* page styles.
   Layout 3 colonnes desktop (sidebar | article | toc) ; sidebar
   en drawer mobile. Tokens uniquement, zéro CDN.
   ============================================================ */

*,
*::before,
*::after {
  box-sizing: border-box;
}

html,
body {
  margin: 0;
  padding: 0;
  background: var(--bg);
  color: var(--tx);
  font-family: var(--font-ui);
  font-size: var(--text-base);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  scroll-behavior: smooth;
  overflow-x: clip;
}

a {
  color: var(--ac);
  text-decoration: none;
}
a:hover {
  text-decoration: underline;
}

.visually-hidden {
  position: absolute !important;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

.docs-skip {
  position: absolute;
  left: -9999px;
  top: 0;
  background: var(--ac);
  color: white;
  padding: var(--space-2) var(--space-3);
  z-index: 100;
}
.docs-skip:focus {
  left: var(--space-3);
  top: var(--space-3);
}

/* ---------- Topbar ---------- */
.docs-topbar {
  position: sticky;
  top: 0;
  z-index: 20;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  padding: var(--space-3) var(--space-6);
  background: var(--bg);
  border-bottom: 1px solid var(--bd);
  backdrop-filter: saturate(180%) blur(8px);
}

.docs-brand {
  display: inline-flex;
  align-items: center;
  gap: var(--space-3);
  color: var(--tx);
  text-decoration: none;
}
.docs-brand:hover {
  text-decoration: none;
}
.docs-brand-text {
  display: flex;
  flex-direction: column;
  line-height: 1.1;
}
.docs-brand-text strong {
  font-weight: 600;
  font-size: var(--text-md);
}
.docs-brand-tagline {
  font-size: var(--text-xs);
  color: var(--tx3);
}

.docs-topbar-right {
  display: flex;
  align-items: center;
  gap: var(--space-3);
}

.docs-lang select {
  appearance: none;
  -webkit-appearance: none;
  background: var(--bg2);
  color: var(--tx);
  border: 1px solid var(--bd);
  border-radius: var(--radius-sm);
  padding: 6px 28px 6px 10px;
  font: inherit;
  font-size: var(--text-sm);
  cursor: pointer;
  background-image:
    linear-gradient(45deg, transparent 50%, var(--tx2) 50%),
    linear-gradient(135deg, var(--tx2) 50%, transparent 50%);
  background-position:
    calc(100% - 14px) 14px,
    calc(100% - 9px) 14px;
  background-size:
    5px 5px,
    5px 5px;
  background-repeat: no-repeat;
}
.docs-lang select:focus {
  outline: none;
  border-color: var(--ac);
  box-shadow: 0 0 0 3px var(--ac2);
}

.docs-theme-toggle {
  width: 34px;
  height: 34px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  background: var(--bg2);
  color: var(--tx2);
  border: 1px solid var(--bd);
  border-radius: 50%;
  cursor: pointer;
  transition:
    color var(--t-fast),
    border-color var(--t-fast);
}
.docs-theme-toggle:hover {
  color: var(--ac);
  border-color: var(--ac);
}
.theme-icon-sun {
  display: block;
}
.theme-icon-moon {
  display: none;
}
.light .theme-icon-sun {
  display: none;
}
.light .theme-icon-moon {
  display: block;
}

.docs-back-link {
  font-size: var(--text-sm);
  color: var(--tx2);
  border: 1px solid var(--bd);
  padding: 6px 12px;
  border-radius: var(--radius-sm);
  text-decoration: none;
}
.docs-back-link:hover {
  color: var(--tx);
  border-color: var(--bd2);
  text-decoration: none;
}

.docs-audit-link {
  font-size: var(--text-sm);
  color: var(--ac);
  border: 1px solid color-mix(in srgb, var(--ac) 35%, transparent);
  background: color-mix(in srgb, var(--ac) 8%, transparent);
  padding: 6px 12px;
  border-radius: var(--radius-sm);
  text-decoration: none;
  font-weight: 500;
}
.docs-audit-link:hover {
  background: color-mix(in srgb, var(--ac) 15%, transparent);
  border-color: var(--ac);
  text-decoration: none;
}

/* ---------- Mobile sidebar toggle ---------- */
.docs-sidebar-toggle {
  display: none;
  align-items: center;
  gap: var(--space-2);
  margin: var(--space-3) var(--space-4) 0;
  padding: var(--space-2) var(--space-3);
  background: var(--bg2);
  border: 1px solid var(--bd);
  border-radius: var(--radius-sm);
  color: var(--tx);
  font: inherit;
  font-size: var(--text-sm);
  cursor: pointer;
}

/* ---------- Shell layout ---------- */
.docs-shell {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr) 240px;
  gap: var(--space-8);
  max-width: 1400px;
  margin: 0 auto;
  padding: var(--space-6) var(--space-8);
  align-items: start;
}

/* ---------- Sidebar ---------- */
.docs-sidebar {
  position: sticky;
  top: 64px;
  max-height: calc(100vh - 80px);
  overflow-y: auto;
  padding-right: var(--space-3);
}
.docs-sidebar-nav {
  display: flex;
  flex-direction: column;
  gap: var(--space-5);
}

.docs-sidebar-group-title {
  margin: 0 0 var(--space-2);
  font-size: var(--text-xs);
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--tx3);
}
.docs-sidebar-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}
.docs-sidebar-link {
  display: block;
  padding: 6px 10px;
  border-radius: var(--radius-sm);
  color: var(--tx2);
  font-size: var(--text-sm);
  text-decoration: none;
  border-left: 2px solid transparent;
}
.docs-sidebar-link:hover {
  color: var(--tx);
  background: var(--bg2);
  text-decoration: none;
}
.docs-sidebar-link.is-active {
  color: var(--ac);
  background: var(--ac2);
  border-left-color: var(--ac);
  font-weight: 500;
}

/* ---------- Main + article ---------- */
.docs-main {
  min-width: 0;
  padding-bottom: var(--space-12);
}
/* @scope (.docs-article) — encapsule la typographie article (h1..h4, p, ul,
   ol, blockquote, code, pre, img, a) à l'intérieur du conteneur, sans
   polluer le reste de la page (sidebar, ToC, footer). Le `to (...)` coupe
   la cascade au cas où on insèrerait plus tard un widget tiers (.no-prose)
   qu'on ne veut pas styliser comme du texte. */
@scope (.docs-article) to (.no-prose) {
  :scope {
    max-width: 760px;
  }

  h1 {
    margin: 0 0 var(--space-5);
    font-size: clamp(1.625rem, 1.2rem + 1.8vw, 2rem);
    line-height: 1.2;
    letter-spacing: -0.01em;
    color: var(--tx);
  }
  h2 {
    margin: var(--space-9) 0 var(--space-3);
    font-size: clamp(1.25rem, 1.1rem + 0.6vw, 1.375rem);
    line-height: 1.3;
    color: var(--tx);
    scroll-margin-top: 90px;
  }
  h3 {
    margin: var(--space-7) 0 var(--space-2);
    font-size: clamp(1rem, 0.95rem + 0.3vw, 1.0625rem);
    color: var(--tx);
    scroll-margin-top: 90px;
  }
  h4 {
    margin: var(--space-5) 0 var(--space-2);
    font-size: var(--text-base);
    text-transform: uppercase;
    letter-spacing: 0.04em;
    color: var(--tx2);
  }
  p {
    margin: 0 0 var(--space-4);
    color: var(--tx);
  }
  ul,
  ol {
    margin: 0 0 var(--space-4);
    padding-left: var(--space-6);
  }
  li {
    margin-bottom: 6px;
  }
  hr {
    border: none;
    border-top: 1px solid var(--bd);
    margin: var(--space-7) 0;
  }
  blockquote {
    margin: var(--space-4) 0;
    padding: var(--space-3) var(--space-4);
    border-left: 3px solid var(--ac);
    background: var(--bg2);
    color: var(--tx2);
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  }
  code {
    font-family: var(--font-mono);
    font-size: 0.92em;
    padding: 2px 6px;
    border-radius: 4px;
    background: var(--bg2);
    border: 1px solid var(--bd);
    color: var(--tx);
  }
  pre {
    margin: var(--space-4) 0;
    padding: var(--space-4);
    background: var(--bg2);
    border: 1px solid var(--bd);
    border-radius: var(--radius-md);
    overflow-x: auto;
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    line-height: 1.6;
  }
  pre code {
    background: transparent;
    border: none;
    padding: 0;
    font-size: inherit;
  }
  img {
    max-width: 100%;
    height: auto;
    border-radius: var(--radius-md);
    border: 1px solid var(--bd);
  }
  a {
    color: var(--ac);
    text-decoration: underline;
    text-underline-offset: 3px;
    text-decoration-color: var(--ac3);
  }
  a:hover {
    text-decoration-color: var(--ac);
  }

  h2:hover .docs-anchor,
  h3:hover .docs-anchor {
    opacity: 1;
    color: var(--ac);
  }
}

.docs-anchor {
  display: inline-block;
  margin-right: 8px;
  margin-left: -22px;
  width: 14px;
  color: var(--tx3);
  opacity: 0;
  text-decoration: none;
  font-weight: 400;
  transition: opacity var(--t-fast);
}

/* ---------- Prev / next ---------- */
.docs-prevnext {
  margin-top: var(--space-10);
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-3);
}
.docs-prev,
.docs-next {
  display: flex;
  flex-direction: column;
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--bd);
  border-radius: var(--radius-md);
  background: var(--bg2);
  color: var(--tx);
  text-decoration: none;
}
.docs-next {
  text-align: right;
}
.docs-prev:hover,
.docs-next:hover {
  border-color: var(--ac);
  color: var(--ac);
  text-decoration: none;
}
.docs-prevnext-label {
  font-size: var(--text-xs);
  color: var(--tx3);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}
.docs-prevnext-title {
  font-weight: 500;
  margin-top: 2px;
}
.docs-prevnext-spacer {
  display: block;
}

/* ---------- ToC right ---------- */
.docs-toc {
  position: sticky;
  top: 64px;
  max-height: calc(100vh - 80px);
  overflow-y: auto;
}
.docs-toc-title {
  font-size: var(--text-xs);
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--tx3);
  margin-bottom: var(--space-2);
}
.docs-toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--bd);
}
.docs-toc-item a {
  display: block;
  padding: 4px 12px;
  font-size: var(--text-sm);
  color: var(--tx3);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -1px;
}
.docs-toc-item a:hover {
  color: var(--tx);
}
.docs-toc-item a.is-active {
  color: var(--ac);
  border-left-color: var(--ac);
}
.docs-toc-h3 a {
  padding-left: var(--space-6);
}

/* ---------- Footer ---------- */
.docs-footer {
  border-top: 1px solid var(--bd);
  padding: var(--space-5) var(--space-8);
  text-align: center;
  color: var(--tx3);
  font-size: var(--text-sm);
}

/* ---------- Responsive ---------- */
@media (max-width: 1100px) {
  .docs-shell {
    grid-template-columns: 240px minmax(0, 1fr);
  }
  .docs-toc {
    display: none;
  }
}

@media (max-width: 900px) {
  .docs-topbar {
    padding: var(--space-3) var(--space-4);
  }
  .docs-back-link {
    display: none;
  }
  .docs-audit-link {
    display: none;
  }
  .docs-sidebar-toggle {
    display: inline-flex;
  }
  .docs-shell {
    grid-template-columns: minmax(0, 1fr);
    padding: var(--space-4);
  }
  .docs-sidebar {
    position: fixed;
    top: 60px;
    left: -300px;
    bottom: 0;
    width: 280px;
    padding: var(--space-4);
    background: var(--bg);
    border-right: 1px solid var(--bd);
    transition: left var(--t-base);
    z-index: 15;
  }
  .docs-sidebar.is-open {
    left: 0;
  }
  .docs-prevnext {
    grid-template-columns: minmax(0, 1fr);
  }
}

/* ============================================================
   Shell unifié front — nav marketing sur /docs
   ----------------------------------------------------------
   docs.css déclare `a { color: var(--ac); }` (vert d'accent) qui
   masque la couleur sombre/blanche du texte sur les boutons primaires
   marketing → bouton "Démarrer" illisible. On restaure ici la
   spécificité de chaque élément mk-* utilisé dans le shell docs.
   On harmonise aussi la hauteur des liens nav avec les boutons pour
   un alignement vertical propre (limité à .docs-body pour ne pas
   modifier le rendu des pages marketing standard).
   ============================================================ */
.docs-body .mk-brand {
  color: var(--tx);
}
.docs-body .mk-brand:hover {
  text-decoration: none;
}
.docs-body .mk-nav-link {
  color: var(--tx2);
  padding: 11px 12px;
}
.docs-body .mk-nav-link:hover {
  color: var(--tx);
  text-decoration: none;
}
.docs-body .mk-nav-link[aria-current='page'] {
  color: var(--ac);
}
.docs-body .mk-btn-primary {
  color: #0b0f14;
  font-weight: 600;
}
.docs-body .mk-btn-primary:hover {
  text-decoration: none;
}
.light .docs-body .mk-btn-primary,
body.docs-body.light .mk-btn-primary {
  color: #ffffff;
}
.docs-body .mk-btn-ghost {
  color: var(--tx);
}
.docs-body .mk-btn-ghost:hover {
  text-decoration: none;
}
.docs-body .mk-btn:hover {
  text-decoration: none;
}