/*
 * Mise en page de la documentation.
 *
 * Aucune couleur en dur : tout passe par les variables de /style.css. Changer
 * la charte change cette page sans y toucher — c'est la seule raison pour
 * laquelle ce fichier peut exister séparément.
 */

/*
 * La documentation est une surface de lecture : elle inverse le sol Nuit par
 * défaut. Sans cette bascule explicite, le corps hériterait des couleurs de
 * texte prévues pour fond sombre et deviendrait illisible.
 */
.docs {
  background: var(--fond);
  color: var(--ink);
}

.docs h1,
.docs h2,
.docs h3 {
  color: var(--ink);
}

.docs a {
  color: var(--bleu-clair);
}
.docs a:hover {
  color: #114fa8;
}

.docs code {
  color: var(--or-texte);
}

.docs .faint {
  color: var(--ink-faint);
}

/* L'en-tête, lui, reste sur Nuit : il rattache la doc à la marque. */
.doc-top {
  background: var(--nuit);
  color: var(--sur-nuit);
}

.doc-top .brand,
.doc-top .brand span {
  color: var(--sur-nuit);
}

.doc-top a {
  color: var(--sur-nuit-dim);
}
.doc-top a:hover {
  color: var(--sur-nuit);
}

/* --- En-tête --------------------------------------------------------------- */

.doc-top {
  border-bottom: 1px solid var(--nuit-filet);
}

.doc-top-inner {
  max-width: 1240px;
  margin: 0 auto;
  padding: 16px 24px;
  display: flex;
  align-items: center;
  gap: 16px;
}

.doc-label {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--or);
  padding-left: 16px;
  border-left: 1px solid var(--nuit-filet);
}

.doc-top nav {
  margin-left: auto;
  display: flex;
  gap: 20px;
  font-size: 14px;
}

.doc-top nav a {
  color: var(--sur-nuit-dim);
}
.doc-top nav a:hover {
  color: var(--sur-nuit);
  text-decoration: none;
}

/* --- Structure ------------------------------------------------------------- */

.doc-shell {
  max-width: 1240px;
  margin: 0 auto;
  padding: 0 24px;
  display: grid;
  grid-template-columns: 210px minmax(0, 1fr);
  gap: 48px;
  align-items: start;
}

.toc {
  position: sticky;
  top: 0;
  padding: 36px 0 40px;
  max-height: 100vh;
  overflow-y: auto;
}

.toc nav {
  display: flex;
  flex-direction: column;
}

.toc-title {
  margin: 18px 0 6px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.13em;
  text-transform: uppercase;
  color: var(--ink-faint);
}
.toc-title:first-child {
  margin-top: 0;
}

.toc a {
  font-size: 13px;
  color: var(--ink-dim);
  padding: 3px 0 3px 10px;
  border-left: 1px solid var(--filet);
}

.toc a:hover {
  color: var(--bleu-clair);
  border-left-color: var(--bleu-clair);
  text-decoration: none;
}

.doc-main {
  padding: 36px 0 80px;
  min-width: 0;
}

.doc-main h1 {
  font-family: var(--display);
  font-size: clamp(26px, 3vw, 34px);
  margin-bottom: 14px;
}

.doc-main .lede {
  color: var(--ink-dim);
  max-width: 62ch;
  margin-bottom: 8px;
}

.doc-main section {
  padding-top: 40px;
  /* Compense le sommaire collant lors d'un saut d'ancre. */
  scroll-margin-top: 20px;
}

.doc-main section + section {
  border-top: 1px solid var(--filet);
  margin-top: 40px;
}

.doc-main h2 {
  font-family: var(--display);
  font-size: 22px;
  margin: 0 0 14px;
  max-width: none;
}

.doc-main h3 {
  font-size: 13px;
  font-family: var(--mono);
  font-weight: 400;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-faint);
  margin: 26px 0 10px;
}

.doc-main p {
  max-width: 68ch;
  color: var(--ink-dim);
  margin: 0 0 14px;
}

.doc-main strong {
  color: var(--ink);
}

/* --- Repère d'endpoint ------------------------------------------------------ */

.endpoint {
  display: flex;
  align-items: center;
  gap: 10px;
  margin-bottom: 10px;
}

.verb {
  font-family: var(--mono);
  font-size: 11px;
  font-weight: 500;
  letter-spacing: 0.08em;
  padding: 3px 8px;
  color: var(--papier);
}

.verb.post {
  background: var(--bleu-clair);
}
.verb.get {
  background: var(--ink-dim);
}

.path {
  font-family: var(--mono);
  font-size: 14px;
  color: var(--ink);
}

.status-code {
  font-family: var(--mono);
  font-size: 11px;
  padding: 2px 6px;
  background: #e2f4ec;
  color: var(--encaisse-sombre);
}

.status-code.err {
  background: var(--fond);
  color: var(--alerte-sombre);
}

/* --- Tables ---------------------------------------------------------------- */

.params {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
  margin: 0 0 16px;
}

.params thead th {
  text-align: left;
  font-weight: 500;
  font-size: 10.5px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-faint);
  padding: 7px 10px;
  border-bottom: 1px solid var(--filet-fort);
  white-space: nowrap;
}

.params td {
  padding: 8px 10px;
  border-bottom: 1px solid var(--filet);
  vertical-align: top;
  color: var(--ink-dim);
}

.params td:first-child {
  color: var(--ink);
  white-space: nowrap;
}

.params.errors td:nth-child(2) {
  color: var(--ink);
  white-space: nowrap;
}

/* --- Statuts ---------------------------------------------------------------- */

.st {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-family: var(--mono);
  font-size: 12px;
}

.st::before {
  content: '';
  width: 6px;
  height: 6px;
  background: currentColor;
  flex: none;
}

.st-ok {
  color: var(--encaisse-sombre);
}
.st-sent {
  color: #3c5f86;
}
.st-queued {
  color: var(--ink-dim);
}
.st-err {
  color: var(--alerte-sombre);
}

/* --- Encarts ---------------------------------------------------------------- */

.callout {
  padding: 11px 14px;
  background: var(--papier);
  border: 1px solid var(--filet);
  border-left: 3px solid var(--bleu-clair);
  font-size: 13.5px;
  max-width: 68ch;
}

.callout.warn {
  border-left-color: var(--or-texte);
}

.limits {
  max-width: 68ch;
  color: var(--ink-dim);
  font-size: 14px;
  padding-left: 18px;
  margin: 0 0 16px;
}

.limits li {
  margin-bottom: 8px;
}

/* Bloc de code : sol Nuit, texte clair — l'inverse du reste de la page. */
.doc-main .code {
  background: var(--nuit);
  border-color: var(--nuit);
}

.doc-main .code code {
  color: var(--sur-nuit);
}

.doc-main .code .c,
.doc-main .code .k {
  color: #6fb6ff;
}
.doc-main .code .s {
  color: #9fd39f;
}
.doc-main .code .n,
.doc-main .code .a {
  color: var(--or);
}
.doc-main .code .cm {
  color: var(--sur-nuit-faint);
}

.doc-main .code {
  margin: 0 0 16px;
  padding: 14px 16px;
  overflow-x: auto;
}

.doc-main .code code {
  font-size: 12.5px;
  line-height: 1.7;
}

/* --- Réactif ---------------------------------------------------------------- */

@media (max-width: 900px) {
  .doc-shell {
    grid-template-columns: 1fr;
    gap: 0;
  }

  .toc {
    position: static;
    max-height: none;
    padding: 20px 0 0;
    border-bottom: 1px solid var(--filet);
  }

  .toc nav {
    flex-flow: row wrap;
    gap: 4px 14px;
    padding-bottom: 16px;
  }

  .toc-title {
    width: 100%;
    margin: 8px 0 0;
  }

  .toc a {
    border-left: none;
    padding-left: 0;
  }

  .doc-top-inner {
    flex-wrap: wrap;
    gap: 10px;
  }

  .doc-label {
    padding-left: 0;
    border-left: none;
  }
}