/* Estilos de las páginas del manual de usuario (/manual/ y /manual/<capítulo>/).
   Se cargan ADEMÁS de site.css: reutilizan sus tokens (--ink, --accent,
   --paper-soft...) y su carril (.rail). Aquí solo vive lo propio del manual:
   la retícula índice + cuerpo, la tipografía larga, las figuras y los avisos. */

:root {
  /* Medida de lectura del cuerpo del capítulo (~70 caracteres). Las figuras y
     las tablas la ignoran a propósito: ocupan el ancho del panel. */
  --manual-measure: 44rem;
}

/* ---- Retícula: índice lateral + cuerpo ----
   Dos columnas dentro del carril, sobre papel: el índice a la izquierda (fijo
   al hacer scroll) y el capítulo a la derecha, acotado a su medida de lectura.
   Ningún contenedor puede llevar overflow:hidden aquí: convertiría el aside en
   contenedor de scroll y anularía el position:sticky de su hijo. */
.manual-layout {
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: clamp(32px, 5vw, 72px);
  padding-top: clamp(40px, 5vw, 64px);
}

.manual-toc-inner {
  position: sticky;
  top: 24px;
}

.manual-toc h2 {
  font-size: 13px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-soft);
  margin: 0 0 12px;
}

.manual-toc ol {
  list-style: none;
  margin: 0 0 24px;
  padding: 0;
  counter-reset: chapter;
}

.manual-toc li {
  counter-increment: chapter;
  font-size: 14px;
  line-height: 1.45;
  margin-bottom: 9px;
  /* El número de capítulo va en el canalón, colgando de la sangría */
  padding-left: 26px;
  position: relative;
}

.manual-toc li::before {
  content: counter(chapter);
  position: absolute;
  left: 0;
  top: 0;
  width: 18px;
  text-align: right;
  color: #a8adb4;
  font-variant-numeric: tabular-nums;
}

.manual-toc a {
  color: var(--ink-soft);
  text-decoration: none;
}

.manual-toc a:hover {
  color: var(--ink);
}

/* Capítulo actual: sin enlace, resaltado */
.manual-toc li[aria-current="page"] {
  color: var(--ink);
  font-weight: 500;
}

/* ---- Cuerpo del capítulo ---- */

/* El índice del manual (/manual/) no tiene columna lateral: se coloca solo, con
   el mismo aire superior que las demás páginas de contenido. */
.manual-page {
  padding-top: clamp(44px, 6vw, 76px);
}

.manual-eyebrow {
  font-size: 13px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--ink-soft);
  margin: 0 0 10px;
}

.manual h1 {
  font-size: clamp(30px, 3.4vw, 40px);
  letter-spacing: -0.025em;
  line-height: 1.12;
  margin: 0 0 18px;
  max-width: var(--manual-measure);
}

/* Entradilla: un grado por encima del cuerpo, sin llegar a titular */
.manual .lead {
  font-size: 19px;
  line-height: 1.55;
  color: var(--ink);
  max-width: var(--manual-measure);
  margin: 0 0 36px;
}

.manual h2 {
  font-size: 23px;
  letter-spacing: -0.01em;
  margin: 44px 0 14px;
  padding-top: 20px;
  border-top: 1px solid var(--border);
  max-width: var(--manual-measure);
}

.manual h3 {
  font-size: 17px;
  margin: 28px 0 10px;
  max-width: var(--manual-measure);
}

.manual p,
.manual ul,
.manual ol {
  font-size: 16.5px;
  line-height: 1.65;
  color: var(--ink-soft);
  max-width: var(--manual-measure);
}

.manual li {
  margin-bottom: 7px;
}

.manual strong {
  color: var(--ink);
  font-weight: 500;
}

.manual a {
  color: var(--accent-dark);
  text-decoration-color: rgba(18, 117, 169, 0.35);
  text-underline-offset: 2px;
}

.manual a:hover {
  text-decoration-color: var(--accent-dark);
}

/* ---- Convenciones tipográficas del manual ---- */

/* .ui = texto literal que el lector ve en la interfaz (nombres de slots,
   botones, mensajes de error). Se marca para que no se confunda con la prosa. */
.ui {
  font-weight: 500;
  color: var(--ink);
  white-space: nowrap;
}

/* .key = tecla o gesto (Right-click, Ctrl) */
.key {
  font-family: inherit;
  font-size: 0.87em;
  font-weight: 500;
  color: var(--ink);
  background: var(--paper-soft);
  border: 1px solid var(--border);
  border-bottom-width: 2px;
  border-radius: 4px;
  padding: 1px 6px;
  white-space: nowrap;
}

/* Nombre interno de una propiedad, el que aparece en el .gph */
.code {
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.87em;
  color: var(--ink);
  background: var(--paper-soft);
  border: 1px solid var(--border);
  border-radius: 4px;
  padding: 1px 5px;
}

/* Bloque de código: fragmentos de fichero (cabeceras CSV, formato de red).
   Scrollea el bloque, nunca la página. */
.manual-code {
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 13.5px;
  line-height: 1.55;
  color: var(--ink);
  background: var(--paper-soft);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 16px 20px;
  margin: 24px 0 28px;
  max-width: var(--manual-measure);
  overflow-x: auto;
  white-space: pre;
}

/* ---- Tablas de referencia ---- */

.manual-table-wrap {
  /* Las tablas son más anchas que la medida de lectura y en móvil no caben:
     que scrollen ellas, nunca la página. */
  overflow-x: auto;
  margin: 24px 0 28px;
  border: 1px solid var(--border);
  border-radius: 8px;
  background: var(--paper);
}

.manual table {
  border-collapse: collapse;
  width: 100%;
  font-size: 14.5px;
  line-height: 1.45;
}

.manual th,
.manual td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}

.manual thead th {
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--ink-soft);
  font-weight: 500;
  white-space: nowrap;
}

.manual tbody tr:last-child td {
  border-bottom: none;
}

.manual td {
  color: var(--ink-soft);
}

.manual td:first-child {
  color: var(--ink);
  font-weight: 500;
  white-space: nowrap;
}

/* ---- Avisos ---- */

.note {
  margin: 24px 0;
  padding: 16px 20px;
  border-left: 3px solid var(--accent);
  background: var(--paper-soft);
  border-radius: 0 8px 8px 0;
  max-width: var(--manual-measure);
}

.note p {
  margin: 0;
  font-size: 15.5px;
}

.note p + p {
  margin-top: 10px;
}

.note-label {
  display: block;
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--accent-dark);
  font-weight: 500;
  margin-bottom: 5px;
}

.note--warn {
  border-left-color: #d98324;
}

.note--warn .note-label {
  color: #a8611a;
}

/* ---- Figuras ----
   Las capturas las hace el autor. Mientras no existan, cada figura se publica
   como un hueco con su especificación de disparo (.fig--todo): al sustituirla
   basta con meter el <img> y quitar esa clase — el <figcaption> ya es el
   definitivo. */

.fig {
  margin: 30px 0;
  /* A propósito más ancha que la medida de lectura: ocupa el panel */
  max-width: none;
}

.fig img {
  display: block;
  width: 100%;
  height: auto;
  border: 1px solid var(--border);
  border-radius: 6px;
  background: #fff;
}

/* Capturas pequeñas o estrechas (un panel, un menú): a su tamaño real en vez
   de estiradas al ancho de la columna, que las haría enormes. Las capturas son
   a 2x, así que el <img> necesita srcset="… 2x" para que su tamaño intrínseco
   sea el de CSS y no el doble. */
.fig--natural img {
  width: auto;
  max-width: 100%;
}

.fig--natural .fig-zoom {
  display: inline-block;
  width: auto;
  max-width: 100%;
}

/* Rótulo de cada imagen cuando una figura encadena varias (antes / después) */
.fig .fig-step {
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink-soft);
  font-weight: 500;
  margin: 0 0 8px;
}

.fig .fig-step ~ .fig-step {
  margin-top: 22px;
}

.fig figcaption {
  font-size: 14px;
  line-height: 1.5;
  color: var(--ink-soft);
  margin-top: 10px;
  max-width: var(--manual-measure);
}

.fig figcaption b {
  color: var(--ink);
  font-weight: 500;
}

/* Botón que envuelve la imagen (lo inserta site.js): lupa al sobrevolar */
.fig-zoom {
  display: block;
  position: relative;
  width: 100%;
  padding: 0;
  border: 0;
  background: none;
}

.fig-zoom::after {
  content: "";
  position: absolute;
  top: 12px;
  right: 12px;
  width: 36px;
  height: 36px;
  border-radius: 50%;
  background: rgba(28, 30, 33, 0.72) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%23fff' stroke-width='2' stroke-linecap='round'%3E%3Ccircle cx='10.5' cy='10.5' r='6'/%3E%3Cpath d='M15 15l5 5M10.5 8v5M8 10.5h5'/%3E%3C/svg%3E") center / 20px no-repeat;
  opacity: 0;
  transition: opacity 0.15s;
  pointer-events: none;
}

.fig-zoom:hover::after,
.fig-zoom:focus-visible::after {
  opacity: 1;
}

.fig-zoom:focus-visible {
  outline: 2px solid var(--ink);
  outline-offset: 3px;
  border-radius: 6px;
}

/* Imagen ampliada: modal a pantalla completa, la imagen a su tamaño CSS
   natural como máximo y siempre entera dentro de la ventana */
.fig-lightbox {
  width: 100vw;
  height: 100vh;
  max-width: none;
  max-height: none;
  margin: 0;
  /* Margen amplio: el botón de cerrar queda fuera de la imagen */
  padding: 60px;
  box-sizing: border-box;
  border: 0;
  background: transparent;
}

.fig-lightbox[open] {
  display: flex;
  align-items: center;
  justify-content: center;
}

.fig-lightbox::backdrop {
  background: rgba(20, 22, 25, 0.94);
}

.fig-lightbox img {
  max-width: 100%;
  max-height: 100%;
  width: auto;
  height: auto;
  border-radius: 6px;
  box-shadow: 0 10px 40px rgba(0, 0, 0, 0.4);
}

.fig-lightbox-close {
  position: fixed;
  top: 14px;
  right: 18px;
  width: 40px;
  height: 40px;
  border: 0;
  border-radius: 50%;
  background: rgba(255, 255, 255, 0.12);
  color: #fff;
  font-size: 26px;
  line-height: 1;
  cursor: pointer;
}

.fig-lightbox-close:hover {
  background: rgba(255, 255, 255, 0.22);
}

/* Hueco de captura pendiente */
.fig--todo .shot {
  border: 1px dashed #c3c8ce;
  border-radius: 6px;
  background: repeating-linear-gradient(-45deg,
      #fbfcfd, #fbfcfd 10px,
      #f5f7f9 10px, #f5f7f9 20px);
  padding: 22px 24px;
}

.shot-title {
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: #8b9199;
  font-weight: 500;
  margin: 0 0 12px;
}

.shot dl {
  margin: 0;
  display: grid;
  /* Etiqueta estrecha + valor: en móvil colapsa a una columna */
  grid-template-columns: 104px 1fr;
  gap: 7px 16px;
  font-size: 14.5px;
  line-height: 1.5;
}

.shot dt {
  color: #8b9199;
}

.shot dd {
  margin: 0;
  color: var(--ink-soft);
}

/* ---- Navegación entre capítulos ---- */

.manual-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 52px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
}

.manual-pager a {
  text-decoration: none;
  font-size: 15px;
  color: var(--ink-soft);
  max-width: 46%;
}

.manual-pager a:hover {
  color: var(--ink);
}

.manual-pager .dir {
  display: block;
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: #a8adb4;
  margin-bottom: 3px;
}

.manual-pager .next {
  text-align: right;
  margin-left: auto;
}


/* ---- Índice del manual (/manual/) ---- */

.manual-parts {
  margin-top: 8px;
}

.manual-part h2 {
  font-size: 15px;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--ink-soft);
  border-top: 1px solid var(--border);
  padding-top: 18px;
  margin: 36px 0 4px;
}

.manual-part ol {
  list-style: none;
  padding: 0;
  margin: 0;
  counter-reset: item;
}

.manual-part li {
  counter-increment: item;
  position: relative;
  border-bottom: 1px solid var(--border);
  margin: 0;
  font-size: 16.5px;
}

/* El número del capítulo cuelga en el canalón. Va sobre el <li> (no sobre el
   enlace) para que el enlace pueda sangrar más allá y el número quede DENTRO de
   su área: la fila entera, número incluido, es clicable. */
.manual-part li::before {
  content: counter(item);
  position: absolute;
  left: 0;
  top: 13px;
  width: 22px;
  text-align: right;
  color: #a8adb4;
  font-variant-numeric: tabular-nums;
  /* Por encima del fondo de hover del enlace */
  z-index: 1;
}

.manual-part li:last-child {
  border-bottom: none;
}

/* El enlace ocupa la fila completa —título y sumario—, exactamente el ancho de
   la fila: el fondo de hover empieza y acaba donde las líneas que separan los
   capítulos, sin desbordarlas y sin redondear (es una banda de la lista, no una
   tarjeta suelta). */
.manual-part a {
  display: block;
  padding: 13px 0 13px 34px;
  text-decoration: none;
  color: var(--ink);
  transition: background 0.15s ease;
}

.manual-part a:hover {
  background: var(--paper-soft);
}

.manual-part a:hover .chapter-title {
  color: var(--accent-dark);
}

.chapter-title {
  display: block;
}

/* Sumario de una línea bajo el título del capítulo, en el índice */
.chapter-blurb {
  display: block;
  font-size: 14.5px;
  line-height: 1.45;
  color: var(--ink-soft);
  margin-top: 2px;
}

/* ---- Anchos intermedios ----
   A 900px site.css ya apila los bloques a ancho completo; aquí solo hay que
   soltar el sticky del índice y aflojar los paddings del panel. */

@media (max-width: 900px) {
  /* Una sola columna. minmax(0,1fr) —y no 1fr— porque el mínimo automático de
     una pista de grid es su contenido: un título largo del índice o un bloque
     de código ensanchaban la pista por encima del viewport y la página
     scrolleaba en horizontal. */
  .manual-layout {
    grid-template-columns: minmax(0, 1fr);
    gap: 40px;
  }

  /* El índice pasa DEBAJO del capítulo (y pierde el sticky): en vertical, 19
     entradas por delante del texto son un muro entre el lector y lo que ha
     venido a leer. Al final funciona como "todos los capítulos", junto a la
     navegación anterior/siguiente. */
  .manual-toc {
    order: 2;
    padding-top: 32px;
    border-top: 1px solid var(--border);
  }

  .manual-toc-inner {
    position: static;
  }

  .shot dl {
    grid-template-columns: 1fr;
    gap: 2px;
  }

  .shot dt {
    margin-top: 8px;
  }
}