/*
 * La referencia de la API (/docs). Lo que solo es suyo: el índice lateral, la
 * ficha de un endpoint y las tablas de parámetros y errores.
 *
 * Se carga la cuarta, detrás de style.css, pagina.css e inicio.css, y da por
 * hechas sus variables. De inicio.css reusa lo que ya existía y aquí se repite
 * igual: .codigo, .metodo, .nota, .rejilla-2 y .credencial. Si algo de eso
 * cambia allí, cambia aquí solo.
 *
 * La página es larga a propósito —treinta y tres endpoints con ejemplos— así
 * que casi todo el trabajo es de orientación: saber dónde estás (el índice),
 * qué pide cada ruta (los sellos) y qué cambia al mandar la clave (las dos
 * columnas del ejemplo).
 *
 * Cuidado al bautizar clases aquí: estas cuatro hojas comparten espacio de
 * nombres. Las tablas se llamaron .campos un rato y salían descuadradas, porque
 * style.css ya usa ese nombre para la ficha del portador del terminal y le pone
 * display: grid. Si una clase nueva suena genérica, hay que buscarla antes en
 * las otras tres.
 */

.pagina--docs {
  /*
   * Lo que mide la cabecera pegajosa. Lo usan el índice y los saltos de ancla:
   * sin esto, pinchar una ruta deja su título debajo de la barra.
   */
  --tope: 4.25rem;

  /*
   * El sello del token necesita un color propio. La paleta tiene tres —acento,
   * verde y rojo— y aquí hacen falta cuatro credenciales distinguibles de un
   * vistazo; el rojo está descartado porque en esta página significa DELETE.
   * Es el único color escrito a mano fuera de style.css, junto con los de las
   * dos líneas del metro en inicio.css.
   */
  --sello-token: light-dark(#7a3fb8, #c08cff);

  /*
   * Los colores de los ejemplos. Cada uno se escribe una vez con light-dark(),
   * así que el tema claro y el oscuro salen del mismo sitio y no hay forma de
   * arreglar uno y dejar el otro roto.
   *
   * Son cuatro y no ocho a propósito: el objetivo es distinguir clave de valor
   * y comentario de código, no pintar un árbol de sintaxis. Los tonos claros
   * están oscurecidos respecto a los de noche porque el mismo azul que brilla
   * sobre negro se lava sobre el gris de .codigo.
   */
  --t-azul: light-dark(#0a5fd0, #7fb6ff); /* claves, cabeceras, rutas */
  --t-verde: light-dark(#0f6b4a, #5fd0a0); /* textos y valores */
  --t-ambar: light-dark(#8a4b00, #e0a45c); /* números, opciones, anotaciones */
  --t-violeta: light-dark(#7a3fb8, #c08cff); /* palabras del lenguaje */

  /*
   * Las dos sombras del índice de un móvil. --sombra de style.css no vale aquí:
   * allí en oscuro la elevación se ve sola por el contraste, y estas dos piezas
   * flotan sobre el texto de la página en los dos temas. Van escritas con
   * light-dark() por lo mismo que los colores de arriba.
   */
  --sombra-hoja: light-dark(0 -10px 34px rgba(20, 23, 26, 0.16), 0 -10px 34px rgba(0, 0, 0, 0.5));
  --sombra-flotante: light-dark(0 6px 20px rgba(20, 23, 26, 0.18), 0 6px 20px rgba(0, 0, 0, 0.45));

  /* El velo de detrás de la hoja: oscurece en los dos temas, que es lo que aparta */
  --velo: light-dark(rgba(20, 23, 26, 0.32), rgba(0, 0, 0, 0.55));
}

/* ── El armazón ──────────────────────────────────── */
.doc {
  max-width: 1180px;
  margin: 0 auto;
  padding-inline: clamp(1.25rem, 5vw, 2.5rem);
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: clamp(1rem, 3vw, 2.5rem);
  align-items: start;
}

@media (min-width: 940px) {
  /*
   * La columna del índice mide lo que mide la ruta más larga
   * —POST /users/:id/wallet/topup— escrita de una pieza. Es al revés de lo
   * normal: aquí el ancho lo dicta el contenido porque partir una ruta en dos
   * líneas la vuelve ilegible.
   */
  .doc {
    grid-template-columns: 16rem minmax(0, 1fr);
  }
}

/* ── El índice ───────────────────────────────────── */
/*
 * En pantalla ancha se queda pegado y hace de mapa: treinta y tres rutas caben
 * en una columna y se lee de un vistazo dónde está una.
 */
.indice {
  position: sticky;
  top: var(--tope);
  max-height: calc(100dvh - var(--tope) - 1rem);
  overflow-y: auto;
  padding: clamp(1.25rem, 3vw, 2rem) 0 1.5rem;
  /* La barra de desplazamiento propia, cuando aparece, no debe pegarse al texto */
  scrollbar-width: thin;
}

.indice__grupo + .indice__grupo { margin-top: 1.1rem; }

.indice__titulo {
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--tenue);
  margin-bottom: 0.35rem;
}
.indice__titulo a { color: inherit; text-decoration: none; }
.indice__titulo a:hover { color: var(--tinta); }

.indice__rutas {
  list-style: none;
  margin: 0;
  padding: 0;
}

.indice__rutas a {
  display: flex;
  gap: 0.45rem;
  padding: 0.22rem 0.5rem;
  border-left: 2px solid transparent;
  border-radius: 0 4px 4px 0;
  font-family: var(--mono);
  font-size: 0.74rem;
  color: var(--tenue);
  text-decoration: none;
  /* Una ruta partida en dos líneas no es una ruta: la columna se ensancha antes */
  white-space: nowrap;
  transition: color 0.15s, background 0.15s, border-color 0.15s;
}
.indice__rutas--texto a { font-family: var(--display); font-size: 0.85rem; }

.indice__rutas a:hover {
  color: var(--tinta);
  background: var(--hueco);
}

/* El método, en su columna, para que las rutas empiecen todas donde mismo */
.indice__rutas b {
  flex: none;
  width: 2.3rem;
  font-weight: 500;
  font-size: 0.62rem;
  letter-spacing: 0.04em;
  color: var(--fantasma);
  align-self: center;
}

/* Dónde estoy. Lo pone docs.js mirando qué ficha se ve. */
.indice__rutas a[aria-current="true"] {
  color: var(--acento);
  border-left-color: var(--acento);
  background: var(--hueco);
}
.indice__rutas a[aria-current="true"] b { color: var(--acento); }

/*
 * En estrecho no hay sitio para una columna al lado, y una lista de treinta y
 * tres rutas antes del texto sería una pantalla entera de índice.
 *
 * Con JavaScript el índice entero se va a una hoja que sube desde abajo (más
 * abajo); sin él se queda esto: solo lo grueso —los grupos y las páginas
 * sueltas— en una fila de fichas. Por eso cuelga de que el <body> no lleve la
 * marca que pone docs.js: las dos formas no pueden convivir.
 */
@media (max-width: 939px) {
  body:not([data-indice-flotante]) .indice {
    position: static;
    max-height: none;
    overflow: visible;
    display: flex;
    flex-wrap: wrap;
    gap: 0.4rem;
    padding: 1.25rem 0 1rem;
    border-bottom: 1px solid var(--linea);
  }

  body:not([data-indice-flotante]) .indice__grupo,
  body:not([data-indice-flotante]) .indice__rutas--texto,
  body:not([data-indice-flotante]) .indice__rutas--texto li {
    display: contents;
  }
  body:not([data-indice-flotante]) .indice__grupo + .indice__grupo { margin-top: 0; }

  /* Las listas de rutas y los títulos que no llevan enlace no pintan nada aquí */
  body:not([data-indice-flotante]) .indice__rutas:not(.indice__rutas--texto),
  body:not([data-indice-flotante]) .indice__titulo--suelto {
    display: none;
  }

  body:not([data-indice-flotante]) .indice__titulo,
  body:not([data-indice-flotante]) .indice__rutas--texto a {
    margin: 0;
    padding: 0.35rem 0.7rem;
    border: 1px solid var(--linea);
    border-radius: 999px;
    background: var(--panel);
    font-family: var(--display);
    font-size: 0.8rem;
    letter-spacing: 0;
    text-transform: none;
    white-space: nowrap;
  }
}

/* ── El índice de un móvil ───────────────────────── */
/*
 * Una hoja que sube desde abajo con las treinta y tres rutas dentro, y un botón
 * flotante que la abre. Es lo mismo que la columna de ancho —las mismas rutas,
 * los mismos grupos, la misma marca de dónde estás—, solo que guardada hasta
 * que se pide: en un móvil el índice estorba mientras se lee y hace falta
 * entero cuando se quiere saltar a otra ficha.
 *
 * Va abajo porque es donde llega el pulgar. Las piezas —el botón y el velo— las
 * crea docs.js, que también pone la marca en el <body>; sin JavaScript no hay
 * nada de esto y manda la fila de fichas de arriba.
 */
.indice-boton,
.indice-velo {
  display: none;
}

@media (max-width: 939px) {
  body[data-indice-flotante] .indice {
    position: fixed;
    inset: auto 0 0;
    z-index: 40;
    max-height: min(72dvh, 34rem);
    overflow-y: auto;
    overscroll-behavior: contain;
    padding: 0.6rem 1.1rem calc(1.5rem + env(safe-area-inset-bottom));
    border-top: 1px solid var(--linea);
    border-radius: 16px 16px 0 0;
    background: var(--panel);
    box-shadow: var(--sombra-hoja);
    /* Cerrada no se ve y tampoco se tabula: está fuera de la pantalla */
    translate: 0 100%;
    visibility: hidden;
  }

  /*
   * La transición cuelga del atributo, que no existe hasta el primer toque. En
   * la regla de arriba se veía bajar la hoja sola al cargar la página: el
   * momento en que docs.js marca el <body> es un cambio de estilo como otro
   * cualquiera y el navegador lo anima igual de contento.
   */
  body[data-indice-flotante] .indice[data-abierto] {
    transition: translate 0.22s ease-out, visibility 0.22s;
  }

  /* Abierta, el hueco de abajo es el del botón: si no, tapa la última ruta */
  body[data-indice-flotante] .indice[data-abierto="si"] {
    translate: 0 0;
    visibility: visible;
    padding-bottom: calc(4.25rem + env(safe-area-inset-bottom));
  }

  /* El asidero de arriba: dice que esto se puede cerrar */
  body[data-indice-flotante] .indice::before {
    content: "";
    display: block;
    position: sticky;
    top: 0;
    z-index: 1;
    width: 2.75rem;
    height: 0.25rem;
    margin: 0 auto 0.9rem;
    border-radius: 999px;
    background: var(--linea);
  }

  /* Sitio para el dedo: en la columna de ancho estas filas son de ratón */
  body[data-indice-flotante] .indice__rutas a {
    padding: 0.45rem 0.5rem;
    font-size: 0.8rem;
  }
  body[data-indice-flotante] .indice__rutas--texto a { font-size: 0.92rem; }
  body[data-indice-flotante] .indice__grupo + .indice__grupo { margin-top: 1.35rem; }

  body[data-indice-flotante] .indice-velo {
    display: block;
    position: fixed;
    inset: 0;
    z-index: 35;
    background: var(--velo);
    backdrop-filter: blur(2px);
  }

  body[data-indice-flotante] .indice-boton {
    position: fixed;
    right: clamp(0.9rem, 4vw, 1.5rem);
    bottom: calc(clamp(0.9rem, 4vw, 1.5rem) + env(safe-area-inset-bottom));
    z-index: 45;
    display: inline-flex;
    align-items: center;
    gap: 0.55rem;
    padding: 0.7rem 1.15rem;
    border: 1px solid var(--linea);
    border-radius: 999px;
    background: var(--panel);
    color: var(--tinta);
    font-family: var(--display);
    font-size: 0.9rem;
    font-weight: 500;
    white-space: nowrap;
    box-shadow: var(--sombra-flotante);
    cursor: pointer;
  }
  body[data-indice-flotante] .indice-boton:hover { border-color: var(--tenue); }

  /* Con la hoja abierta el fondo no se mueve: el dedo está desplazando la lista */
  body[data-indice-flotante]:has(.indice[data-abierto="si"]) { overflow: hidden; }
}

/*
 * Las tres barras. Abierto se cruzan: el botón deja de decir "abrir el índice"
 * y pasa a decir "cerrar esto", que es lo único que se quiere entonces.
 */
.indice-boton__barras {
  position: relative;
  flex: none;
  width: 1rem;
  height: 2px;
  border-radius: 2px;
  background: currentColor;
  transition: background 0.18s;
}
.indice-boton__barras::before,
.indice-boton__barras::after {
  content: "";
  position: absolute;
  left: 0;
  width: 100%;
  height: 2px;
  border-radius: 2px;
  background: currentColor;
  transition: translate 0.18s, rotate 0.18s;
}
.indice-boton__barras::before { translate: 0 -0.32rem; }
.indice-boton__barras::after { translate: 0 0.32rem; }

.indice-boton[aria-expanded="true"] .indice-boton__barras { background: transparent; }
.indice-boton[aria-expanded="true"] .indice-boton__barras::before { translate: 0; rotate: 45deg; }
.indice-boton[aria-expanded="true"] .indice-boton__barras::after { translate: 0; rotate: -45deg; }

@media (prefers-reduced-motion: reduce) {
  body[data-indice-flotante] .indice[data-abierto],
  .indice-boton__barras,
  .indice-boton__barras::before,
  .indice-boton__barras::after {
    transition: none;
  }
}

/* ── La columna de texto ─────────────────────────── */
.referencia { min-width: 0; }

.doc__seccion {
  padding: clamp(2.5rem, 6vw, 4.5rem) 0;
  scroll-margin-top: calc(var(--tope) + 0.5rem);
}
.doc__seccion + .doc__seccion { border-top: 1px solid var(--linea); }

.referencia h1 {
  margin: 0.5rem 0 0.9rem;
  font-size: clamp(1.9rem, 5vw, 2.8rem);
  font-weight: 700;
  line-height: 1.1;
  letter-spacing: -0.035em;
}

.doc__titulo {
  margin: 0.5rem 0 0.9rem;
  font-size: clamp(1.5rem, 4vw, 2.1rem);
  font-weight: 700;
  line-height: 1.15;
  letter-spacing: -0.03em;
}

/* Los h2 sueltos dentro de una sección: no abren tema, lo ordenan */
.referencia h2:not(.doc__titulo) {
  margin: clamp(2rem, 4vw, 2.75rem) 0 0.75rem;
  font-size: 1.35rem;
  font-weight: 700;
  letter-spacing: -0.02em;
}

.doc__subtitulo {
  margin: clamp(2rem, 4vw, 2.75rem) 0 0.75rem;
  font-size: 1.15rem;
  font-weight: 700;
  letter-spacing: -0.02em;
  scroll-margin-top: calc(var(--tope) + 0.5rem);
}

.doc__intro {
  max-width: 52rem;
  color: var(--tenue);
  font-size: clamp(0.98rem, 1.6vw, 1.05rem);
}
.doc__intro + .doc__intro { margin-top: 0.75rem; }
.doc__intro strong { color: var(--tinta); font-weight: 500; }

.referencia p { max-width: 52rem; }
.referencia p + p { margin-top: 0.75rem; }
.referencia > * + *,
.doc__seccion > * + * { margin-top: 0.75rem; }

.referencia code {
  font-family: var(--mono);
  font-size: 0.88em;
  color: var(--acento);
  overflow-wrap: anywhere;
}
.referencia a { color: var(--acento); }

/*
 * El apunte al margen: por qué es así, qué se rompe si lo haces de otra manera.
 * Más apagado que el texto normal, porque se puede saltar sin perderse nada.
 */
.doc__nota {
  max-width: 52rem;
  margin-top: 0.9rem;
  padding-left: 0.9rem;
  border-left: 2px solid var(--linea);
  color: var(--tenue);
  font-size: 0.9rem;
}
.doc__nota strong { color: var(--tinta); font-weight: 500; }

/* ── Los cuatro hechos de arriba ─────────────────── */
.hechos {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(170px, 100%), 1fr));
  gap: 0.75rem;
  margin: clamp(1.5rem, 4vw, 2.25rem) 0;
}

.hecho {
  padding: 0.85rem 1rem;
  border: 1px solid var(--linea);
  border-radius: 10px;
  background: var(--panel);
}
.hecho dt {
  font-family: var(--mono);
  font-size: 0.65rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--tenue);
}
.hecho dd {
  margin: 0.3rem 0 0;
  font-size: 0.95rem;
  font-weight: 500;
}

/* ── Los sellos ──────────────────────────────────── */
/*
 * Qué credencial pide una ruta. Es lo primero que se mira de una ficha, así
 * que va arriba y con color: sin él, "abierto" y "clave dueña" se leen igual.
 */
.sello {
  flex: none;
  padding: 0.16rem 0.55rem;
  border: 1px solid currentColor;
  border-radius: 999px;
  font-family: var(--mono);
  font-size: 0.66rem;
  letter-spacing: 0.04em;
  white-space: nowrap;
}

.sello--abierto { color: var(--tenue); }
.sello--mas { color: var(--verde); }
.sello--clave { color: var(--acento); }
.sello--token { color: var(--sello-token); }
.sello--admin { color: var(--rojo); }

/* La leyenda: el sello a la izquierda y qué significa al lado */
.sellos {
  list-style: none;
  margin: 1rem 0 0;
  padding: 0;
  display: grid;
  gap: 0.6rem;
  max-width: 52rem;
}
.sellos li {
  display: grid;
  grid-template-columns: 11rem 1fr;
  gap: 0.75rem;
  align-items: baseline;
  font-size: 0.92rem;
  color: var(--tenue);
}
.sellos .sello { justify-self: start; }

@media (max-width: 560px) {
  .sellos li { grid-template-columns: 1fr; gap: 0.3rem; }
}

/* ── La ficha de un endpoint ─────────────────────── */
.ep {
  margin-top: clamp(1.75rem, 4vw, 2.75rem);
  padding: clamp(1.1rem, 3vw, 1.75rem);
  border: 1px solid var(--linea);
  border-radius: 12px;
  background: var(--panel);
  scroll-margin-top: calc(var(--tope) + 0.5rem);
}

.ep__cabecera {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.5rem;
  padding-bottom: 0.9rem;
  border-bottom: 1px solid var(--linea);
}

/*
 * La ruta es el encabezado de la ficha, no un trozo de código suelto: así el
 * documento tiene una jerarquía real —sección, endpoint, bloque— y se puede
 * recorrer saltando de título en título con un lector de pantalla.
 */
.ep__ruta {
  flex: 1 1 auto;
  min-width: 0;
  font-size: 0.98rem;
  font-weight: 500;
  overflow-wrap: anywhere;
}
.ep__ruta code {
  font-size: 1em;
  color: var(--tinta);
}

.ep__resumen {
  margin-top: 0.9rem;
  font-size: 1rem;
  color: var(--tinta);
}
.ep p { color: var(--tenue); font-size: 0.94rem; }
.ep .ep__resumen { color: var(--tinta); }
.ep strong { color: var(--tinta); font-weight: 500; }

/* El rótulo de cada bloque de la ficha: Cuerpo, Consulta, Cuando falla */
.ep__titulo {
  margin: clamp(1.25rem, 3vw, 1.75rem) 0 0.6rem;
  font-family: var(--mono);
  font-size: 0.7rem;
  font-weight: 500;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--tenue);
}

.ep .nota { margin-top: 1.5rem; }

/* ── Petición y respuesta, lado a lado ───────────── */
/*
 * Dos columnas cuando caben, porque la mitad de esta página es "esto mandas,
 * esto te devuelve" — y en las rutas abiertas, "sin clave" contra "con clave",
 * que es la comparación que hay que ver de una vez y no desplazándose.
 */
.ejemplo {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(300px, 100%), 1fr));
  gap: 0.85rem;
  margin-top: 1rem;
}

.ejemplo__mitad { min-width: 0; }

.ejemplo__titulo {
  margin-bottom: 0.4rem;
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--tenue);
}

.ejemplo .codigo { font-size: 0.76rem; }

/* ── Tablas ──────────────────────────────────────── */
/*
 * Con su propio desplazamiento horizontal: una tabla de tres columnas en un
 * móvil no cabe, y lo que no puede pasar es que arrastre a la página entera.
 */
.tabla-caja {
  margin-top: 0.5rem;
  overflow-x: auto;
  border: 1px solid var(--linea);
  border-radius: 10px;
}

.tabla,
.errores {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.86rem;
}

.tabla th,
.tabla td,
.errores th,
.errores td {
  padding: 0.6rem 0.8rem;
  text-align: left;
  vertical-align: top;
  border-bottom: 1px solid var(--linea);
}

.tabla thead th,
.errores thead th {
  background: var(--hueco);
  font-family: var(--mono);
  font-size: 0.68rem;
  font-weight: 500;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--tenue);
  white-space: nowrap;
}

.tabla tbody tr:last-child th,
.tabla tbody tr:last-child td,
.errores tbody tr:last-child td { border-bottom: 0; }

.tabla tbody th {
  font-weight: 400;
  white-space: nowrap;
}
.tabla td,
.errores td { color: var(--tenue); }

/* La primera columna de los errores es el código HTTP: corta y en su sitio */
.errores td:first-child {
  font-family: var(--mono);
  font-size: 0.8rem;
  color: var(--tinta);
  white-space: nowrap;
}
.errores td:nth-child(2) { white-space: nowrap; }

/* La matriz de con y sin clave: columnas estrechas y respuestas centradas */
.tabla--matriz td { text-align: center; white-space: nowrap; }
.tabla--matriz th[scope="row"] { white-space: normal; min-width: 14rem; }
.tabla--matriz .si { color: var(--verde); }
.tabla--matriz .no { color: var(--fantasma); }

.obligatorio {
  margin-left: 0.35rem;
  font-family: var(--mono);
  font-size: 0.6rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--rojo);
}

/* ── Los colores del código ──────────────────────── */
/*
 * Las clases las pone resaltar.js, que solo sabe de nombres; qué color es cada
 * nombre se decide aquí. Sin JavaScript el bloque se queda en texto plano, que
 * es legible igual: esto añade, no sostiene.
 */
.t-clave,
.t-ruta,
.t-funcion,
.t-variable { color: var(--t-azul); }

.t-cadena { color: var(--t-verde); }

.t-numero,
.t-opcion { color: var(--t-ambar); }

.t-constante,
.t-palabra,
.t-comando { color: var(--t-violeta); }

.t-metodo { color: var(--tinta); font-weight: 500; }

/* Lo que no es código: se lee si se busca, y no compite si no */
.t-comentario { color: var(--tenue); font-style: italic; }

/* Las flechas que señalan lo que aparece al mandar la clave */
.t-anotacion { color: var(--t-ambar); font-style: italic; }

/* ── Copiar un bloque ────────────────────────────── */
/*
 * La envoltura la pone docs.js: aquí solo se dice dónde va el botón. Aparece
 * al pasar por encima para no ensuciar treinta bloques de código a la vez, y
 * se queda puesto donde no hay ratón.
 */
.copiable { position: relative; }

.copiar {
  position: absolute;
  top: 0.4rem;
  right: 0.4rem;
  padding: 0.2rem 0.55rem;
  border: 1px solid var(--linea);
  border-radius: 6px;
  background: var(--panel);
  font-family: var(--mono);
  font-size: 0.65rem;
  color: var(--tenue);
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s, color 0.15s, border-color 0.15s;
}
.copiable:hover .copiar,
.copiar:focus-visible { opacity: 1; }
.copiar:hover { color: var(--tinta); border-color: var(--tenue); }
.copiar[data-hecho="si"] { opacity: 1; color: var(--verde); border-color: var(--verde); }

@media (hover: none) {
  .copiar { opacity: 0.65; }
}