/* ============================================================================
   BYRO — Documentación de la API

   La leen perfiles distintos: el dueño que quiere entender qué se puede hacer,
   y el desarrollador que va a integrarla. Por eso texto ancho y legible, código
   en bloques que se copian, y navegación lateral para saltar a lo que se busca.
   ========================================================================== */

.doc-layout { display: flex; gap: 28px; align-items: flex-start; }

/* Navegación lateral. Se queda fija al desplazar: en una referencia larga,
   perder el índice obliga a subir cada vez. */
.doc-nav {
  flex: none; width: 200px; position: sticky; top: 20px;
  align-self: flex-start;
}
.doc-nav-h {
  font-size: 11px; text-transform: uppercase; letter-spacing: .05em;
  color: var(--byro-text-3); padding: 6px 10px; margin-top: 10px;
}
.doc-nav-h:first-child { margin-top: 0; }
.doc-nav a {
  display: block; padding: 6px 10px; border-radius: var(--byro-r-sm, 8px);
  font-size: var(--byro-fs-sm); color: var(--byro-text-2); text-decoration: none;
}
.doc-nav a:hover { background: var(--byro-surface-2); color: var(--byro-text); }

.doc-cuerpo { flex: 1; min-width: 0; }

/* Cada sección. */
.doc-sec {
  background: var(--byro-surface);
  border: 1px solid var(--byro-border);
  border-radius: var(--byro-r-lg, 12px);
  padding: 20px 22px; margin-bottom: 18px;
  scroll-margin-top: 20px;
}
.doc-sec h2 {
  font-size: var(--byro-fs-md); font-weight: var(--byro-fw-semibold);
  color: var(--byro-text); margin: 0 0 10px;
}
.doc-sec h3 {
  font-size: var(--byro-fs-sm); font-weight: var(--byro-fw-semibold);
  color: var(--byro-text); margin: 18px 0 8px;
}
.doc-sec p {
  font-size: var(--byro-fs-sm); color: var(--byro-text-2);
  line-height: 1.6; margin: 0 0 12px;
}
.doc-sec p:last-child { margin-bottom: 0; }
.doc-sec a { color: var(--byro-accent-2, #6366f1); }
.doc-sec ul { margin: 0 0 12px; padding-left: 20px; }
.doc-sec li { font-size: var(--byro-fs-sm); color: var(--byro-text-2); line-height: 1.6; margin-bottom: 7px; }

.doc-sec code {
  font-family: ui-monospace, Menlo, monospace; font-size: .92em;
  background: var(--byro-surface-2); padding: 1px 5px;
  border-radius: 4px; color: var(--byro-text);
}

/* Bloques de código. Con desplazamiento propio: una línea larga no debe
   ensanchar la página entera. */
.doc-code, .doc-resultado {
  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
  font-size: 12.5px; line-height: 1.55;
  background: var(--byro-surface-2);
  border: 1px solid var(--byro-border);
  border-radius: var(--byro-r-sm, 8px);
  padding: 12px 14px; margin: 0 0 12px;
  overflow-x: auto; white-space: pre;
  color: var(--byro-text);
}

/* La dirección base, destacada: es el primer dato que todos buscan. */
.doc-base {
  font-family: ui-monospace, Menlo, monospace; font-size: var(--byro-fs-sm);
  background: var(--byro-surface-2); border: 1px solid var(--byro-border);
  border-radius: var(--byro-r-sm, 8px); padding: 11px 14px; margin: 0 0 12px;
  word-break: break-all; color: var(--byro-text); user-select: all;
}

/* Pestañas por lenguaje. */
.doc-tabs { display: flex; gap: 4px; margin: 12px 0 10px; flex-wrap: wrap; }
.doc-tab {
  border: 0; background: var(--byro-surface-2); cursor: pointer;
  font-family: inherit; font-size: var(--byro-fs-xs);
  color: var(--byro-text-2); padding: 6px 12px;
  border-radius: var(--byro-r-sm, 8px);
}
.doc-tab:hover { color: var(--byro-text); }
.doc-tab.is-on { background: var(--byro-accent, #6366f1); color: #fff; }

/* Encabezado de cada ruta: método, dirección y permiso. */
.doc-ruta { display: flex; align-items: center; gap: 9px; flex-wrap: wrap; margin-bottom: 10px; }
.doc-ruta code { font-size: var(--byro-fs-sm); background: none; padding: 0; }

.doc-metodo {
  font-size: 11px; font-weight: var(--byro-fw-semibold);
  padding: 3px 8px; border-radius: 5px; letter-spacing: .03em;
  background: rgba(34, 197, 94, .14); color: #16a34a;
}
.doc-metodo[data-m="POST"] { background: rgba(99, 102, 241, .14); color: #4f46e5; }

.doc-resumen { font-size: var(--byro-fs-sm); color: var(--byro-text-2); line-height: 1.6; margin: 0 0 12px; }
.doc-nota { font-size: var(--byro-fs-xs); color: var(--byro-text-3); line-height: 1.55; }

/* El probador: ver una respuesta real convence más que leer la referencia. */
.doc-probar {
  background: var(--byro-surface-2); border-radius: var(--byro-r-sm, 8px);
  padding: 12px 14px; margin-top: 12px;
}
.doc-probar-nota { font-size: var(--byro-fs-xs); color: var(--byro-text-3); margin-left: 10px; }
.doc-resultado { max-height: 320px; overflow: auto; margin: 10px 0 0; }

/* Tablas de parámetros. */
.doc-tabla { width: 100%; border-collapse: collapse; margin: 0 0 12px; font-size: var(--byro-fs-xs); }
.doc-tabla th {
  text-align: left; font-weight: var(--byro-fw-medium);
  color: var(--byro-text-3); padding: 6px 10px 6px 0;
  border-bottom: 1px solid var(--byro-border);
}
.doc-tabla td {
  padding: 7px 10px 7px 0; color: var(--byro-text-2);
  border-bottom: 1px solid var(--byro-border); vertical-align: top;
}
.doc-tabla tr:last-child td { border-bottom: 0; }
.doc-tabla code { font-size: 11.5px; }

/* En pantallas angostas la navegación pasa arriba: una columna de 200 px al
   lado deja el contenido sin espacio. */
@media (max-width: 820px) {
  .doc-layout { flex-direction: column; gap: 16px; }
  .doc-nav { width: 100%; position: static; display: flex; flex-wrap: wrap; gap: 4px; }
  .doc-nav-h { display: none; }
  .doc-nav a { background: var(--byro-surface-2); font-size: var(--byro-fs-xs); }
}

/* ============================================================================
   Envoltorio de la documentación pública (byro.mx/api)

   Tema oscuro fijo, como la landing comercial: el dominio raíz es la cara de
   venta de BYRO y tiene su propia identidad (ADR-0022).
   ========================================================================== */

.doc-publica {
  margin: 0; background: #0a0a0e; color: #ececf0;
  font-family: var(--byro-font, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
}

.doc-cab {
  display: flex; align-items: center; gap: 10px;
  padding: 18px 28px; border-bottom: 1px solid #1f1f28;
  position: sticky; top: 0; background: #0a0a0e; z-index: 10;
}
.doc-cab img { display: block; }
.doc-cab span { font-size: 14px; color: #8a8a9e; }

.doc-main { max-width: 1080px; margin: 0 auto; padding: 28px; }

.doc-pie {
  max-width: 1080px; margin: 0 auto; padding: 28px;
  border-top: 1px solid #1f1f28;
}
.doc-pie p { font-size: 14px; color: #8a8a9e; margin: 0; }
.doc-pie a { color: var(--byro-accent-2, #818cf8); }

/* En la pública el encabezado de página sobra: ya lo dice la cabecera. */
.doc-publica .page-head { margin-bottom: 20px; }
.doc-publica .page-title { font-size: 26px; font-weight: 700; letter-spacing: -.5px; }
.doc-publica .page-sub { font-size: 15px; color: #8a8a9e; margin-top: 4px; }

/* El campo de la llave para probar. Uno solo arriba, en vez de un diálogo del
   navegador en cada intento. */
.doc-llave-caja { background: var(--byro-surface-2); }
.doc-llave {
  width: 100%; max-width: 520px; padding: 9px 12px;
  font-family: ui-monospace, Menlo, monospace; font-size: var(--byro-fs-sm);
  border: 1px solid var(--byro-border); border-radius: var(--byro-r-sm, 8px);
  background: var(--byro-surface); color: var(--byro-text);
}
.doc-llave:focus { outline: 0; border-color: var(--byro-accent, #6366f1); }

/* Se marca cuando alguien intenta probar sin haberla pegado. */
.doc-llave.is-error { border-color: var(--byro-danger, #ef4444); }
