/* ═══════════════════════════════════════════════════════════════════════
   Documentation de l'API — feuille propre a la page /api-docs.

   Elle ne redefinit aucun jeton : elle consomme ceux de app.css (--acid,
   --ink, --panel, --line, --font-mono…) pour rester dans le meme systeme
   visuel que la page d'accueil.

   Deux regles de prudence apprises sur ce projet :
   - l'en-tete du site est `position:fixed` : toute bande en haut de page doit
     reserver sa hauteur, sinon elle passe dessous ;
   - dans une zone sombre, les couleurs sont ecrites en clair, jamais via
     --muted / --muted-2 qui sont calibres pour le fond bone.
   ═══════════════════════════════════════════════════════════════════════ */

/* ── bandeau d'ouverture ───────────────────────────────────────────────
   La bande sombre, l'image de fond et les pastilles sont le composant
   partage `.page-hero` (app.css) : la doc n'ajoute que sa barre d'URL. */
.docs-base{
  display:flex;align-items:center;gap:12px;flex-wrap:wrap;
  margin-top:22px;padding:13px 15px;border-radius:12px;
  background:rgba(0,0,0,.34);border:1px solid rgba(255,255,255,.13);
}
.db-k{
  font-family:var(--font-mono);font-size:10.5px;letter-spacing:.12em;
  text-transform:uppercase;color:rgba(255,255,255,.5);flex:0 0 auto;
}
.docs-base code{
  flex:1;min-width:0;font-family:var(--font-mono);font-size:14px;
  color:var(--acid);word-break:break-all;
}
.db-copy{
  flex:0 0 auto;width:36px;height:36px;border-radius:9px;display:grid;place-items:center;
  background:rgba(255,255,255,.07);border:1px solid rgba(255,255,255,.14);
  color:rgba(255,255,255,.7);transition:background .15s,color .15s;
}
.db-copy:hover{background:rgba(255,255,255,.14);color:#fff}
.db-copy svg{width:16px;height:16px}
.db-copy.is-copied{background:var(--acid);border-color:var(--acid);color:#141608}

/* ── ossature : rail de sommaire + corps ──────────────────────────────── */
.docs-shell{
  display:grid;grid-template-columns:232px minmax(0,1fr);
  gap:56px;align-items:start;padding-top:44px;padding-bottom:80px;
}
.dtoc-side{position:sticky;top:96px;max-height:calc(100vh - 120px);overflow-y:auto;padding-right:6px}
.dtoc-h{
  display:block;font-family:var(--font-mono);font-size:10.5px;letter-spacing:.12em;
  text-transform:uppercase;color:var(--muted);margin-bottom:12px;
}
.dtoc-nav{display:flex;flex-direction:column;gap:1px}
.dtoc-nav a{
  display:block;padding:7px 12px;border-radius:8px;font-size:14px;
  color:var(--ink-2);border-left:2px solid transparent;
  transition:background .14s,color .14s,border-color .14s;
}
.dtoc-nav a:hover{background:var(--bg-2);color:var(--ink)}
.dtoc-nav a.on{border-left-color:var(--acid);background:var(--acid-soft);color:var(--ink);font-weight:600}
.dtoc-sep{
  margin:14px 0 5px;padding-left:12px;font-family:var(--font-mono);font-size:10px;
  letter-spacing:.12em;text-transform:uppercase;color:var(--muted-2);
}
.dtoc-m{display:none}

/* ── sections ─────────────────────────────────────────────────────────── */
.docs-body{min-width:0}
.dsec{scroll-margin-top:96px;padding-bottom:56px}
.dsec + .dsec{border-top:1px solid var(--line);padding-top:48px}
.dsec h2{
  display:flex;align-items:center;gap:12px;
  font-size:clamp(24px,3vw,34px);margin-bottom:14px;
}
.dsec-ic{
  width:36px;height:36px;flex:0 0 auto;border-radius:10px;display:grid;place-items:center;
  background:var(--acid-soft);border:1px solid rgba(201,242,78,.34);color:var(--green-ink);
}
.dsec-ic svg{width:19px;height:19px}
.dsec h3{font-size:19px;margin:32px 0 12px}
.dsec h4{
  font-family:var(--font-mono);font-size:11px;letter-spacing:.1em;text-transform:uppercase;
  color:var(--muted);margin:22px 0 9px;
}
.dsec p{color:var(--ink-2);margin:0 0 14px}
.dsec p:last-child{margin-bottom:0}
.dsec a:not(.btn):not(.gd-card):not(.lg-card):not(.gx-card):not(.chip){color:var(--green-ink);text-decoration:underline;text-underline-offset:2px}
.dsec a:not(.btn):hover{color:var(--ink)}
.dsec code{
  font-family:var(--font-mono);font-size:.88em;padding:2px 6px;border-radius:5px;
  background:var(--bg-2);border:1px solid var(--line);color:#2f3a12;
  word-break:break-word;
}
/* `.dsec code` vise le code EN LIGNE dans la prose. Le meme selecteur attrape
   aussi le <code> a l'interieur des fenetres sombres, qui se retrouvait avec
   un fond bone et de l'encre verte sur fond noir. On le remet a plat. */
.dsec .code-body code{
  background:none;border:none;padding:0;border-radius:0;
  color:inherit;font-size:inherit;word-break:normal;
}
.dsec .code-body code span{background:none;border:none;padding:0}

/* etapes du quickstart */
.dsteps{counter-reset:d;display:flex;flex-direction:column;gap:12px;margin:0 0 22px}
.dsteps li{
  position:relative;counter-increment:d;list-style:none;
  padding:16px 18px 16px 54px;border-radius:13px;
  background:var(--panel);border:1px solid var(--line);color:var(--ink-2);
}
.dsteps li::before{
  content:counter(d);position:absolute;left:16px;top:16px;
  width:26px;height:26px;border-radius:50%;display:grid;place-items:center;
  background:var(--ink);color:var(--acid);
  font-family:var(--font-mono);font-size:12px;font-weight:700;
}
.dsteps b{color:var(--ink)}
.dpath{
  font-family:var(--font-mono);font-size:.9em;padding:2px 7px;border-radius:5px;
  background:var(--ink);color:var(--acid);white-space:nowrap;
}

/* encart d'avertissement */
.dnote{
  display:flex;gap:12px;align-items:flex-start;
  padding:15px 17px;border-radius:13px;margin:20px 0 0;
  background:var(--acid-soft);border:1px solid rgba(201,242,78,.4);
  color:var(--ink-2);font-size:14.5px;line-height:1.55;max-width:none;
}
.dnote svg{width:19px;height:19px;flex:0 0 auto;margin-top:2px;color:var(--green-ink)}
.dnote.warn{background:#fdf3e3;border-color:#eccf9a}
.dnote.warn svg{color:#8a5a12}
.dnote b{color:var(--ink)}

/* ── tableaux ─────────────────────────────────────────────────────────── */
.dtable{
  width:100%;border-collapse:collapse;margin:6px 0 8px;
  font-size:14.5px;color:var(--ink-2);
}
.dtable th{
  text-align:left;font-family:var(--font-mono);font-size:10.5px;letter-spacing:.1em;
  text-transform:uppercase;color:var(--muted);font-weight:700;
  padding:0 12px 9px;border-bottom:1px solid var(--line-2);
}
.dtable td{padding:11px 12px;border-bottom:1px solid var(--line);vertical-align:top}
.dtable tr:last-child td{border-bottom:none}
.dtable td:first-child,.dtable th:first-child{padding-left:0}
.dtable td:last-child,.dtable th:last-child{padding-right:0}
.dtable-fields td:first-child{white-space:nowrap}
.dtable .dt{
  font-family:var(--font-mono);font-size:12px;color:var(--muted);white-space:nowrap;
}
.dtable tr.risky td:first-child code{background:#fdf3e3;border-color:#eccf9a;color:#7a4f0d}

/* pastilles */
.dstat{
  display:inline-block;min-width:44px;text-align:center;
  font-family:var(--font-mono);font-size:12px;font-weight:700;
  padding:3px 8px;border-radius:6px;
}
.dstat.s2{background:rgba(74,106,18,.14);color:#3d5a0e}
.dstat.s4{background:#fdf0e3;color:#8a5a12}
.dstat.s5{background:#fbe7e7;color:#8f2f2f}
.dtag{
  display:inline-block;font-family:var(--font-mono);font-size:10px;font-weight:700;
  letter-spacing:.06em;text-transform:uppercase;padding:3px 7px;border-radius:5px;
}
.dtag.on{background:rgba(74,106,18,.15);color:#3d5a0e}
.dtag.off{background:var(--bg-2);color:var(--muted);border:1px solid var(--line-2)}
.dtag.req{background:var(--ink);color:var(--acid)}
.dtag.risk{background:#fdf0e3;color:#8a5a12;border:1px solid #eccf9a}

/* ── bloc endpoint ────────────────────────────────────────────────────── */
.dep{
  border:1px solid var(--line);border-radius:16px;background:var(--panel);
  padding:22px 24px;margin-top:22px;
}
.dep-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-bottom:12px}
.dm{
  font-family:var(--font-mono);font-size:11.5px;font-weight:700;letter-spacing:.06em;
  padding:5px 10px;border-radius:7px;flex:0 0 auto;color:#fff;
}
.m-get{background:#2c5aa0}
.m-post{background:#3d6b1f}
.m-patch{background:#8a5a12}
.m-delete{background:#8f2f2f}
.dep-path{
  font-family:var(--font-mono);font-size:15px;font-weight:700;color:var(--ink);
  background:none;border:none;padding:0;word-break:break-all;
}
.dep-scope{
  display:inline-flex;align-items:center;gap:6px;margin-left:auto;
  font-family:var(--font-mono);font-size:11px;padding:5px 9px;border-radius:7px;
  background:var(--bg-2);border:1px solid var(--line-2);color:var(--muted);
}
.dep-scope svg{width:12px;height:12px}
.dep-scope.risk{background:#fdf0e3;border-color:#eccf9a;color:#8a5a12}
.dep-sum{font-family:var(--font-display);font-weight:600;font-size:16.5px;color:var(--ink);margin:0 0 6px;letter-spacing:-.01em;line-height:1.3}
.dep-desc{margin:0}
.dep .dnote{margin-top:16px}

/* ── fenetre de code ──────────────────────────────────────────────────── */
.code-win{
  border-radius:13px;overflow:hidden;background:#0b0c0e;
  border:1px solid #1c1f26;box-shadow:var(--shadow);margin:0 0 16px;
}
.code-win:last-child{margin-bottom:0}
.code-win .code-body{max-height:none}

/* ── appel a l'action final ───────────────────────────────────────────── */
.docs-cta{
  border-top:1px solid var(--line);padding-top:48px;text-align:center;
}
.docs-cta h2{justify-content:center}
.docs-cta p{margin-inline:auto}
.docs-cta-row{display:flex;gap:12px;justify-content:center;flex-wrap:wrap;margin-top:22px}

/* ═════════════════ TELEPHONE ═════════════════════════════════════════ */
@media (max-width:960px){
  .docs-shell{grid-template-columns:1fr;gap:0;padding-top:18px}
  .dtoc-side{display:none}

  /* Le sommaire devient un panneau depliable, ferme par defaut : sur un
     telephone, quinze liens avant le premier paragraphe repoussent le
     contenu hors de l'ecran. */
  .dtoc-m{
    display:block;margin:0 0 26px;border:1px solid var(--line);
    border-radius:13px;background:var(--panel);overflow:hidden;
  }
  .dtoc-m > summary{
    list-style:none;cursor:pointer;
    display:flex;align-items:center;justify-content:space-between;
    min-height:52px;padding:0 16px;
    font-family:var(--font-display);font-weight:600;font-size:15px;color:var(--ink);
  }
  .dtoc-m > summary::-webkit-details-marker{display:none}
  .dtoc-m > summary span{display:flex;align-items:center;gap:10px}
  .dtoc-m > summary svg{
    width:16px;height:16px;color:var(--muted);
    transform:rotate(90deg);transition:transform .2s var(--ease);
  }
  .dtoc-m[open] > summary svg{transform:rotate(-90deg)}
  .dtoc-m[open] > summary{border-bottom:1px solid var(--line)}
  .dtoc-m .dtoc-nav{padding:8px}
  .dtoc-m .dtoc-nav a{min-height:44px;display:flex;align-items:center;font-size:15px}
}

@media (max-width:640px){
  .docs-base{gap:9px;padding:12px 13px}
  .docs-base code{font-size:12.5px;flex-basis:100%;order:3}
  .db-copy{margin-left:auto}

  .dsec{padding-bottom:40px}
  .dsec + .dsec{padding-top:36px}
  .dsec h3{font-size:17px;margin-top:26px}
  .dsec p{font-size:15px}
  .dep{padding:18px 16px;border-radius:14px}

  /* La portee passait sous le chemin en poussant la ligne : sur telephone
     elle prend sa propre ligne au lieu d'etre collee a droite. */
  .dep-scope{margin-left:0;width:100%;justify-content:center}
  .dep-path{font-size:14px}

  /* Tableaux : en dessous de 640px une grille a trois colonnes force un
     defilement lateral. Chaque ligne devient un bloc, l'intitule au-dessus
     de la valeur. */
  .dtable,.dtable tbody,.dtable tr,.dtable td{display:block;width:100%}
  .dtable thead{display:none}
  .dtable tr{
    padding:13px 0;border-bottom:1px solid var(--line);
  }
  .dtable tr:last-child{border-bottom:none}
  .dtable td{border:none;padding:0}
  .dtable td + td{margin-top:5px}
  .dtable-fields td:first-child{white-space:normal;margin-bottom:3px}
  .dtable .dt{font-size:11.5px}
  .dstat{min-width:0}

  .dsteps li{padding:14px 15px 14px 50px}
  .dnote{font-size:14px;padding:13px 15px}
  .docs-cta-row .btn{width:100%}
}