/* ==========================================================================
   style.css — UNA sola hoja de estilos para las 5 páginas
   --------------------------------------------------------------------------
   Todas las páginas la cargan con:
       <link rel="stylesheet" href="style.css">

   Está organizada en capas, de lo más general a lo más concreto:
     1. VARIABLES   → colores, espacios y tamaños reutilizables (el "tema")
     2. BASE        → estilos para etiquetas HTML sueltas (body, h1, p, a…)
     3. LAYOUT      → la estructura de la página (contenedor, rejillas)
     4. COMPONENTES → piezas reutilizables (.btn, .card, .alert…)
     5. UTILIDADES  → pequeñas clases de ayuda (.text-center, .mt-2…)
     6. DOCUMENTACIÓN → estilos propios de este tutorial (código, demos)

   Regla de oro: cuanto más abajo, más específico. Si dos reglas chocan
   con la misma especificidad, gana la que aparece DESPUÉS (la cascada).
   ========================================================================== */


/* ==========================================================================
   1. VARIABLES (Custom Properties)
   Se declaran en :root (el elemento <html>) y se usan con var(--nombre).
   Cambiar un valor aquí cambia TODA la web. Pruébalo con --color-primary.
   ========================================================================== */
:root {
  /* Colores */
  --color-primary: #4f46e5;       /* índigo: botones, enlaces, acentos */
  --color-primary-dark: #3730a3;
  --color-secondary: #0ea5e9;
  --color-text: #1f2937;
  --color-muted: #6b7280;
  --color-bg: #f8fafc;
  --color-surface: #ffffff;       /* fondo de tarjetas */
  --color-border: #e5e7eb;

  --color-info: #0ea5e9;
  --color-success: #16a34a;
  --color-warning: #d97706;
  --color-danger: #dc2626;

  /* Espaciado: una escala fija evita "números mágicos" */
  --space-1: 0.25rem;  /*  4px */
  --space-2: 0.5rem;   /*  8px */
  --space-3: 1rem;     /* 16px */
  --space-4: 1.5rem;   /* 24px */
  --space-5: 2.5rem;   /* 40px */

  /* Tipografía */
  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  --font-mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;

  /* Otros */
  --radius: 10px;
  --shadow: 0 1px 3px rgba(0, 0, 0, 0.08), 0 4px 12px rgba(0, 0, 0, 0.05);
  --max-width: 1000px;
}


/* ==========================================================================
   2. BASE — selectores de ETIQUETA
   Afectan a todas las etiquetas de ese tipo en cualquier página.
   ========================================================================== */

/* box-sizing: border-box hace que width incluya padding y borde.
   Es casi universal en proyectos modernos. */
*,
*::before,
*::after {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: var(--font-sans);
  font-size: 1rem;
  line-height: 1.6;
  color: var(--color-text);
  background: var(--color-bg);
}

h1, h2, h3 {
  line-height: 1.25;
  margin: 0 0 var(--space-3);
}
h1 { font-size: 2.2rem; }
h2 { font-size: 1.5rem; margin-top: var(--space-5); }
h3 { font-size: 1.15rem; }

p { margin: 0 0 var(--space-3); }

a { color: var(--color-primary); }
a:hover { color: var(--color-primary-dark); } /* :hover = pseudo-clase */

code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  background: #eef2ff;
  color: var(--color-primary-dark);
  padding: 0.1em 0.35em;
  border-radius: 4px;
}

img { max-width: 100%; display: block; }


/* ==========================================================================
   3. LAYOUT — la "estructura" de la página
   ========================================================================== */

/* .container centra el contenido y limita su ancho */
.container {
  max-width: var(--max-width);
  margin: 0 auto;              /* auto a izquierda y derecha = centrado */
  padding: 0 var(--space-3);
}

main.container {
  padding-top: var(--space-5);
  padding-bottom: var(--space-5);
}

/* .grid: rejilla que se adapta sola al ancho disponible.
   repeat(auto-fit, minmax(240px, 1fr)) = "mete tantas columnas de al menos
   240px como quepan, y reparte el sobrante". Sin media queries. */
.grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  gap: var(--space-4);
}

/* .stack: apila hijos en vertical con separación uniforme */
.stack {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
}

/* .cluster: fila de elementos que salta de línea si no caben */
.cluster {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  align-items: center;
}


/* ==========================================================================
   4. COMPONENTES
   Cada componente es un bloque con nombre propio. Usamos la convención BEM:
     .bloque              → el componente         (.card)
     .bloque__elemento    → una parte interna     (.card__title)
     .bloque--modificador → una variante          (.card--featured)
   Así, leyendo solo la clase, sabes a qué componente pertenece.
   ========================================================================== */

/* ---------- 4.1 Cabecera del sitio (.site-header) ---------- */
.site-header {
  background: var(--color-surface);
  border-bottom: 1px solid var(--color-border);
  position: sticky;            /* se queda pegada arriba al hacer scroll */
  top: 0;
  z-index: 10;
}
.site-header__inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-2);
  padding-top: var(--space-2);
  padding-bottom: var(--space-2);
}
.site-header__logo {
  font-weight: 700;
  font-size: 1.1rem;
  color: var(--color-text);
  text-decoration: none;
}
.site-header__logo span { color: var(--color-primary); }

/* ---------- 4.2 Navegación (.nav) ---------- */
.nav {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-1);
  list-style: none;            /* quita los puntos de la lista <ul> */
  margin: 0;
  padding: 0;
}
.nav__link {
  display: block;
  padding: var(--space-1) var(--space-2);
  border-radius: 6px;
  color: var(--color-muted);
  text-decoration: none;
  font-size: 0.92rem;
}
.nav__link:hover {
  background: #eef2ff;
  color: var(--color-primary);
}
.nav__link--active {           /* modificador: la página actual */
  background: var(--color-primary);
  color: #fff;
}
.nav__link--active:hover {
  background: var(--color-primary-dark);
  color: #fff;
}

/* ---------- 4.3 Hero (.hero) — bloque de presentación ---------- */
.hero {
  background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
  color: #fff;
  padding: var(--space-5) 0;
}
.hero__title { font-size: 2.4rem; margin: 0 0 var(--space-2); }
.hero__subtitle { font-size: 1.15rem; opacity: 0.9; margin: 0 0 var(--space-4); max-width: 60ch; }

/* ---------- 4.4 Botón (.btn) ---------- */
.btn {
  display: inline-block;
  padding: var(--space-2) var(--space-4);
  border: 2px solid transparent;
  border-radius: var(--radius);
  font: inherit;
  font-weight: 600;
  text-decoration: none;
  cursor: pointer;
  transition: transform 0.15s, background 0.15s;
}
.btn:hover { transform: translateY(-2px); }

.btn--primary   { background: var(--color-primary); color: #fff; }
.btn--primary:hover { background: var(--color-primary-dark); color: #fff; }
.btn--secondary { background: transparent; color: var(--color-primary); border-color: var(--color-primary); }
.btn--light     { background: #fff; color: var(--color-primary); }
.btn--small     { padding: var(--space-1) var(--space-3); font-size: 0.85rem; }

/* ---------- 4.5 Tarjeta (.card) ---------- */
.card {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  box-shadow: var(--shadow);
  overflow: hidden;            /* recorta la imagen a las esquinas redondas */
  display: flex;
  flex-direction: column;
}
.card__image {
  height: 120px;
  background: linear-gradient(135deg, #c7d2fe, #bae6fd);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 2.5rem;
}
.card__body {
  padding: var(--space-4);
  flex: 1;                     /* ocupa el espacio sobrante: pies alineados */
}
.card__title { margin: 0 0 var(--space-2); font-size: 1.15rem; }
.card__text  { color: var(--color-muted); margin: 0; }
.card__footer {
  padding: var(--space-3) var(--space-4);
  border-top: 1px solid var(--color-border);
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: var(--space-2);
}
.card--featured {              /* variante destacada */
  border: 2px solid var(--color-primary);
}

/* ---------- 4.6 Alerta (.alert) ---------- */
.alert {
  padding: var(--space-3) var(--space-4);
  border-left: 5px solid var(--color-info);
  border-radius: 6px;
  background: #e0f2fe;
  margin: var(--space-3) 0;
}
.alert__title { font-weight: 700; display: block; margin-bottom: var(--space-1); }
.alert--success { border-color: var(--color-success); background: #dcfce7; }
.alert--warning { border-color: var(--color-warning); background: #fef3c7; }
.alert--danger  { border-color: var(--color-danger);  background: #fee2e2; }

/* ---------- 4.7 Etiqueta / chapa (.badge) ---------- */
.badge {
  display: inline-block;
  padding: 0.1em 0.6em;
  border-radius: 999px;        /* píldora */
  font-size: 0.78rem;
  font-weight: 600;
  background: #eef2ff;
  color: var(--color-primary-dark);
}
.badge--success { background: #dcfce7; color: #166534; }
.badge--warning { background: #fef3c7; color: #92400e; }

/* ---------- 4.8 Pie de página (.site-footer) ---------- */
.site-footer {
  background: #111827;
  color: #9ca3af;
  padding: var(--space-4) 0;
  font-size: 0.9rem;
}
.site-footer a { color: #c7d2fe; }
.site-footer__inner {
  display: flex;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-2);
}

/* ---------- 4.9 Paginación entre lecciones (.pager) ---------- */
.pager {
  display: flex;
  justify-content: space-between;
  gap: var(--space-3);
  margin-top: var(--space-5);
  padding-top: var(--space-4);
  border-top: 1px solid var(--color-border);
}


/* ==========================================================================
   5. UTILIDADES — clases pequeñas de un solo propósito
   ========================================================================== */
.text-center { text-align: center; }
.text-muted  { color: var(--color-muted); }
.mt-0 { margin-top: 0; }
.mt-4 { margin-top: var(--space-4); }


/* ==========================================================================
   6. DOCUMENTACIÓN — estilos exclusivos de este tutorial
   ========================================================================== */

/* .lesson: cada "apartado" explicativo */
.lesson {
  margin-bottom: var(--space-5);
}

/* .example: código a la izquierda, resultado a la derecha */
.example {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  overflow: hidden;
  margin: var(--space-3) 0 var(--space-4);
  background: var(--color-surface);
}
.example__code,
.example__result {
  padding: var(--space-3);
  min-width: 0;                /* permite que el <pre> haga scroll */
}
.example__code {
  background: #0f172a;
  color: #e2e8f0;
}
.example__label {
  display: block;
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-weight: 700;
  margin-bottom: var(--space-2);
  color: var(--color-muted);
}
.example__code .example__label { color: #94a3b8; }

pre {
  margin: 0;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.85rem;
  line-height: 1.55;
}
pre code {                     /* anula el estilo de <code> suelto */
  background: none;
  color: inherit;
  padding: 0;
}
/* colores de "resaltado" hechos a mano con <span> */
.tk-tag   { color: #f472b6; }
.tk-attr  { color: #fbbf24; }
.tk-val   { color: #86efac; }
.tk-prop  { color: #7dd3fc; }
.tk-com   { color: #64748b; font-style: italic; }

/* Tabla simple para resúmenes */
.table {
  width: 100%;
  border-collapse: collapse;
  background: var(--color-surface);
  border-radius: var(--radius);
  overflow: hidden;
  font-size: 0.95rem;
  margin: var(--space-3) 0;
}
.table th,
.table td {
  text-align: left;
  padding: var(--space-2) var(--space-3);
  border-bottom: 1px solid var(--color-border);
  vertical-align: top;
}
.table th { background: #eef2ff; }

/* ---- Demos del modelo de caja ---- */
.box-model {
  display: inline-block;
  background: #fde68a;         /* margin (amarillo) */
  padding: 20px;
  font-size: 0.8rem;
  font-family: var(--font-mono);
  position: relative;
}
.box-model__border {
  background: #1f2937;         /* border (oscuro) */
  padding: 6px;
}
.box-model__padding {
  background: #86efac;         /* padding (verde) */
  padding: 20px;
}
.box-model__content {
  background: #93c5fd;         /* content (azul) */
  padding: 12px 24px;
  text-align: center;
}
.box-model__tag {
  position: absolute;
  top: 2px;
  left: 6px;
}

/* ---- Demos de flex/grid: cajitas de colores ---- */
.demo-row {
  display: flex;
  gap: var(--space-2);
  padding: var(--space-2);
  background: #f1f5f9;
  border: 1px dashed #94a3b8;
  border-radius: 6px;
  min-height: 90px;
}
.demo-row--center  { justify-content: center; align-items: center; }
.demo-row--between { justify-content: space-between; align-items: flex-end; }
.demo-grid {
  display: grid;
  grid-template-columns: 1fr 2fr 1fr;
  gap: var(--space-2);
  padding: var(--space-2);
  background: #f1f5f9;
  border: 1px dashed #94a3b8;
  border-radius: 6px;
}
.demo-item {
  background: var(--color-primary);
  color: #fff;
  padding: var(--space-2) var(--space-3);
  border-radius: 6px;
  font-family: var(--font-mono);
  font-size: 0.85rem;
  text-align: center;
}
.demo-item--wide { grid-column: span 3; background: var(--color-secondary); }

/* Block vs inline */
.demo-outline > * {
  outline: 2px dashed var(--color-danger);
  outline-offset: 2px;
}

/* Especificidad: demo con colores */
.demo-specificity p           { color: #16a34a; }   /* etiqueta: verde */
.demo-specificity .azul       { color: #2563eb; }   /* clase: azul */
.demo-specificity #rojo       { color: #dc2626; }   /* id: rojo */


/* ==========================================================================
   7. MODO RAYOS X (página 5)
   Un <input type="checkbox"> + el selector :checked + el combinador ~
   permiten "encender" estilos SIN JavaScript.
   Todo elemento con atributo data-component="Nombre" se resalta y muestra
   su nombre gracias a ::before y attr().
   ========================================================================== */
.xray-toggle {
  position: absolute;
  opacity: 0;                  /* oculto, pero accesible con su <label> */
}
.xray-bar {
  background: #fef3c7;
  border-bottom: 1px solid #fcd34d;
  padding: var(--space-2) 0;
  font-size: 0.9rem;
}
.xray-bar label { cursor: pointer; font-weight: 600; }
.xray-bar__switch {
  display: inline-block;
  width: 2.4em;
  height: 1.3em;
  background: #cbd5e1;
  border-radius: 999px;
  vertical-align: middle;
  margin-right: var(--space-2);
  position: relative;
  transition: background 0.2s;
}
.xray-bar__switch::after {
  content: "";
  position: absolute;
  top: 0.15em;
  left: 0.15em;
  width: 1em;
  height: 1em;
  background: #fff;
  border-radius: 50%;
  transition: transform 0.2s;
}
.xray-toggle:focus-visible ~ .xray-bar .xray-bar__switch {
  outline: 2px solid var(--color-primary);
  outline-offset: 2px;
}
.xray-toggle:checked ~ .xray-bar .xray-bar__switch { background: var(--color-danger); }
.xray-toggle:checked ~ .xray-bar .xray-bar__switch::after { transform: translateX(1.1em); }

/* Lo importante: "si el checkbox está marcado, a los hermanos que vienen
   después (~) y a sus descendientes con data-component, píntales un borde" */
.xray-toggle:checked ~ * [data-component],
.xray-toggle:checked ~ [data-component] {
  outline: 2px dashed var(--color-danger);
  outline-offset: -2px;
  position: relative;
}
.xray-toggle:checked ~ * [data-component]::before,
.xray-toggle:checked ~ [data-component]::before {
  content: attr(data-component);   /* lee el texto del atributo HTML */
  position: absolute;
  top: 0;
  right: 0;
  z-index: 5;
  background: var(--color-danger);
  color: #fff;
  font: 600 0.7rem/1.4 var(--font-mono);
  padding: 1px 6px;
  border-bottom-left-radius: 6px;
  pointer-events: none;
}
/* La cabecera ya tiene position: sticky (que también sirve de referencia
   para ::before). Misma especificidad que la regla anterior pero va
   DESPUÉS, así que gana: ejemplo real de la cascada. */
.xray-toggle:checked ~ .site-header { position: sticky; }

/* Los layouts (.grid) muestran su etiqueta a la izquierda para no taparse
   con la del primer componente que contienen. [atributo^="texto"] =
   "el atributo EMPIEZA por ese texto". */
.xray-toggle:checked ~ * [data-component^="Grid"]::before {
  right: auto;
  left: 0;
  top: -1.4em;
  border-radius: 6px 6px 0 0;
}
