@import url("fonts.css");

/*
  La documentación pública de la API.

  Hoja aparte y no la del panel: aquí no hay tarjetas, ni pestañas, ni nada de lo que ocupa las
  mil líneas de styles.css, y la lee gente que no ha entrado nunca al panel. Lo único que se
  comparte son los colores de la marca, copiados a mano para que la página no dependa de una
  hoja que puede cambiar por otro motivo.

  La medida que manda es el ancho del texto: 74 caracteres. Una documentación que ocupa toda la
  pantalla de un monitor grande no se lee, se barre con los ojos.
*/
:root {
  color-scheme: light;
  --bg: #f6f7fb;
  --surface: #ffffff;
  --surface-2: #eef1f7;
  --border: #dfe3ec;
  --text: #0f1626;
  --text-2: #55607a;
  --text-3: #8a93a8;
  --accent: #92590a;
  --accent-wash: rgba(27, 79, 216, .08);
  --grad-a: #141210;
  --grad-b: #92590a;
  --grad: linear-gradient(135deg, var(--grad-a) 0%, var(--grad-b) 100%);
  --brand-amber: #f5a524;
  --code-bg: #10172a;
  --code-text: #e6ecff;
  --radius: 14px;
  --shadow-sm: 0 1px 2px rgba(15, 22, 38, .07);
  --font-display: 'Sora', system-ui, sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, "SF Mono", Menlo, Consolas, monospace;
}
/*
  Claro siempre, aunque el sistema esté en oscuro, igual que el panel y por el mismo motivo:
  es la cara de Tilín, y esta página es la más pública de todas —la abre el programador de un
  cliente, muchas veces antes de haber visto el producto—. Los bloques de código sí van
  oscuros, pero eso es otra cosa: separa el ejemplo del texto y es la convención en todas
  partes.
*/

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
/* Los títulos quedan por debajo de la cabecera fija al llegar por un ancla */
:target, h1, h2, h3, h4 { scroll-margin-top: 84px; }
body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font: 400 16px/1.68 'Public Sans', system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  -webkit-text-size-adjust: 100%;
}

.saltar {
  position: absolute;
  left: -9999px;
}
.saltar:focus {
  left: 12px;
  top: 12px;
  z-index: 10;
  background: var(--surface);
  color: var(--text);
  padding: 10px 14px;
  border-radius: 10px;
  box-shadow: var(--shadow-sm);
}

/* ---------- cabecera ---------- */
.cabecera {
  position: sticky;
  top: 0;
  z-index: 5;
  background: var(--grad);
  color: #fff;
}
.cabecera .dentro {
  max-width: 1180px;
  margin: 0 auto;
  padding: 12px 20px;
  display: flex;
  align-items: center;
  gap: 14px;
}
.marca {
  display: flex;
  align-items: center;
  gap: 10px;
  color: #fff;
  text-decoration: none;
  min-width: 0;
}
.marca b {
  display: block;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 19px;
  line-height: 1.1;
  letter-spacing: -.01em;
}
.marca small {
  display: block;
  font-size: 12.5px;
  color: #cbd6ff;
  /* Sin esto, en un teléfono "Documentación de la API" se parte en dos y la cabecera crece */
  white-space: nowrap;
}
/* La campana de la marca: un círculo con el badajo ámbar */
.campana {
  width: 30px;
  height: 30px;
  flex: none;
  border-radius: 50%;
  background: rgba(255, 255, 255, .16);
  position: relative;
}
.campana::after {
  content: "";
  position: absolute;
  left: 50%;
  top: 52%;
  width: 8px;
  height: 8px;
  margin: -4px 0 0 -4px;
  border-radius: 50%;
  background: var(--brand-amber);
}
.servidor {
  margin-left: auto;
  font-family: var(--font-mono);
  font-size: 12.5px;
  background: rgba(255, 255, 255, .14);
  border: 1px solid rgba(255, 255, 255, .18);
  padding: 5px 10px;
  border-radius: 999px;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
  max-width: 48vw;
}

/* ---------- las dos columnas ---------- */
.columnas {
  max-width: 1180px;
  margin: 0 auto;
  padding: 0 20px 64px;
  display: grid;
  grid-template-columns: 252px minmax(0, 1fr);
  gap: 40px;
  align-items: start;
}
.lateral {
  position: sticky;
  top: 70px;
  padding-top: 28px;
  max-height: calc(100vh - 90px);
  overflow: auto;
}
.plegable > summary { display: none; }
.enlaces { display: grid; }
/*
  Los títulos del menú se parten en dos líneas en vez de cortarse con puntos suspensivos.
  "3. El flujo normal: cobrar con li…" no dice a dónde lleva, que es justo para lo que está.
*/
.enlaces a {
  color: var(--text-2);
  text-decoration: none;
  font-size: 13.5px;
  line-height: 1.38;
  padding: 7px 12px;
  border-left: 2px solid var(--border);
}
.enlaces a.n3 {
  padding-left: 26px;
  font-size: 13.5px;
  color: var(--text-3);
}
.enlaces a:hover { color: var(--text); background: var(--accent-wash); }
.enlaces a.aqui {
  color: var(--accent);
  border-left-color: var(--accent);
  font-weight: 600;
  background: var(--accent-wash);
}

/* ---------- el documento ---------- */
.doc {
  padding-top: 28px;
  max-width: 74ch;
}
.doc h1 {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: clamp(30px, 5vw, 40px);
  line-height: 1.12;
  letter-spacing: -.02em;
  margin: 0 0 18px;
}
.doc h2 {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 25px;
  letter-spacing: -.01em;
  margin: 52px 0 14px;
  padding-top: 20px;
  border-top: 1px solid var(--border);
}
.doc h3 {
  font-family: var(--font-display);
  font-weight: 600;
  font-size: 19px;
  margin: 34px 0 10px;
}
.doc h2 + h3 { margin-top: 18px; }
/*
  El título entero es el enlace a su ancla, pero no se pinta como tal. Lleva .doc delante a
  propósito: sin eso ".doc a" pesa más y los títulos salían del azul de los enlaces.
*/
.doc .ancla { color: inherit; text-decoration: none; }
.doc .ancla:hover { color: var(--accent); }

.doc p { margin: 0 0 16px; }
.doc a { color: var(--accent); text-decoration-thickness: 1px; text-underline-offset: 2px; }
.doc strong { font-weight: 600; }
.doc ul, .doc ol { margin: 0 0 16px; padding-left: 22px; }
.doc li { margin: 0 0 7px; }
.doc blockquote {
  margin: 0 0 18px;
  padding: 12px 16px;
  background: var(--accent-wash);
  border-left: 3px solid var(--accent);
  border-radius: 0 10px 10px 0;
  color: var(--text-2);
}

/* Código en línea: el mismo cuerpo que el texto, en cápsula */
.doc :not(pre) > code {
  font-family: var(--font-mono);
  font-size: .875em;
  background: var(--surface-2);
  border: 1px solid var(--border);
  padding: 1px 5px;
  border-radius: 6px;
  white-space: nowrap;
}
/*
  Dentro de una tabla el código sí se parte. Va "td > code" y no "td :not(pre) > code": lo
  segundo pide un elemento entre medias que aquí no existe —el <code> cuelga directo del
  <td>—, así que no llegaba a aplicarse nunca y un ejemplo largo en una celda estiraba la
  tabla hasta salirse de la pantalla del teléfono.
*/
.doc td > code { white-space: normal; }

/* Bloques de código. Oscuros siempre: es la convención y separa el ejemplo del texto. */
.doc pre {
  position: relative;
  margin: 0 0 20px;
  padding: 16px 18px;
  background: var(--code-bg);
  color: var(--code-text);
  border-radius: var(--radius);
  overflow: auto;
  font-family: var(--font-mono);
  font-size: 13.5px;
  line-height: 1.6;
  tab-size: 2;
}
.doc pre code { font: inherit; color: inherit; background: none; border: 0; padding: 0; }
/*
  El diagrama de flujo del documento es arte ASCII: necesita las líneas sin partir y un cuerpo
  algo menor para que quepa el ancho entero en un móvil sin desplazarlo.
*/
.doc pre.lang-texto { font-size: 12.5px; }
.copiar {
  position: absolute;
  top: 8px;
  right: 8px;
  background: rgba(255, 255, 255, .1);
  color: #cbd6ff;
  border: 1px solid rgba(255, 255, 255, .18);
  border-radius: 8px;
  padding: 4px 9px;
  font: 600 11.5px/1 'Public Sans', system-ui, sans-serif;
  cursor: pointer;
  opacity: 0;
  transition: opacity .12s;
}
.doc pre:hover .copiar, .copiar:focus-visible { opacity: 1; }
.copiar:hover { background: rgba(255, 255, 255, .2); color: #fff; }
/* En táctil no hay "pasar por encima": el botón se queda puesto */
@media (hover: none) {
  .copiar { opacity: 1; }
}

/* Tablas. El envoltorio se desplaza solo, para que una tabla ancha no estire la página. */
.tabla {
  margin: 0 0 22px;
  overflow-x: auto;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  background: var(--surface);
}
.doc table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14.5px;
}
.doc th, .doc td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
.doc thead th {
  background: var(--surface-2);
  font-weight: 600;
  font-size: 13px;
  letter-spacing: .02em;
  text-transform: uppercase;
  color: var(--text-2);
  white-space: nowrap;
}
.doc tbody tr:last-child td { border-bottom: 0; }
/* La primera columna suele ser el método o el nombre del campo: no se parte */
.doc tbody td:first-child { white-space: nowrap; }
.doc tbody td:first-child code { white-space: nowrap; }

.pie {
  margin-top: 56px;
  padding-top: 20px;
  border-top: 1px solid var(--border);
  color: var(--text-3);
  font-size: 13.5px;
}
.pie p { margin: 0 0 6px; }

/* ---------- pantallas chicas ---------- */
@media (max-width: 900px) {
  .columnas {
    /*
      minmax(0, 1fr) y no 1fr a secas: una columna de rejilla no se encoge por debajo de su
      contenido, y el ejemplo en PHP y el diagrama de líneas son más anchos que un teléfono.
      Con "1fr" la columna se quedaba en 1048px y la página entera se iba hacia la derecha,
      con el texto cortado. Pasa igual con flex (min-width: 0) y es de lo que más cuesta ver
      leyendo, porque la regla que falla no está donde está el contenido que se desborda.
    */
    grid-template-columns: minmax(0, 1fr);
    gap: 0;
    padding: 0 16px 48px;
  }
  .lateral {
    position: static;
    padding-top: 16px;
    max-height: none;
    overflow: visible;
  }
  .plegable {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: 12px;
    box-shadow: var(--shadow-sm);
  }
  .plegable > summary {
    display: block;
    padding: 12px 16px;
    font-weight: 600;
    font-size: 14.5px;
    cursor: pointer;
  }
  .plegable[open] > summary { border-bottom: 1px solid var(--border); }
  .enlaces { padding: 8px 6px 10px; max-height: 60vh; overflow: auto; }
  .enlaces a { border-left: 0; border-radius: 8px; }
  .enlaces a.aqui { border-left: 0; }
  .doc { padding-top: 22px; max-width: none; }
  .doc h2 { margin-top: 40px; font-size: 22px; }
  /*
    Las tablas de rutas tienen tres columnas y en un teléfono no sobra ni un píxel: con los
    espacios y el cuerpo del escritorio, la de "Qué hace" se quedaba en un hilo y se salía.
    Apretando el relleno y bajando medio punto el cuerpo entran enteras, que es lo que hace
    falta: una tabla de referencia que haya que arrastrar de lado no se consulta.
  */
  .doc table { font-size: 13.5px; }
  .doc th, .doc td { padding: 8px 10px; }
  /* La primera columna sí se parte en el móvil: si no, la tabla se va de ancho */
  .doc tbody td:first-child { white-space: normal; }
}
