/* ==========================================================================
   layout.css — Sistema de layout global
   Informe Técnico FuXion Perú — Volumen 41
   Depende de: reset.css → variables.css → base.css
   ========================================================================== */


/* ════════════════════════════════════════════════════════════════════════════
   1. CONTENEDORES
   Controlan el ancho máximo y centrado del contenido
   ════════════════════════════════════════════════════════════════════════════ */

.container,
.container-xl,
.container-lg,
.container-md,
.container-sm,
.container-reading,
.container-fluid {
  width: 100%;
  margin-inline: auto;
  padding-inline: var(--container-padding);
}

/* xl — ancho total del sitio: 1280px */
.container,
.container-xl {
  max-width: var(--container-max);
}

/* lg — contenido general: 960px */
.container-lg {
  max-width: var(--container-content);
}

/* md — contenido compacto: 800px */
.container-md {
  max-width: 800px;
}

/* sm — formularios y columnas estrechas: 540px */
.container-sm {
  max-width: var(--container-narrow);
}

/* reading — ancho óptimo de lectura: 680px */
.container-reading {
  max-width: var(--container-reading);
}

/* fluid — sin límite, solo padding lateral */
.container-fluid {
  max-width: none;
}

@media (max-width: 600px) {
  .container,
  .container-xl,
  .container-lg,
  .container-md,
  .container-sm,
  .container-reading,
  .container-fluid {
    padding-inline: var(--container-padding-sm);
  }
}


/* ════════════════════════════════════════════════════════════════════════════
   2. SECCIONES
   Bloques verticales de contenido con padding y variantes de fondo
   ════════════════════════════════════════════════════════════════════════════ */

.section {
  padding-block: var(--space-section);
}

.section-sm {
  padding-block: var(--space-2xl);        /* 48px */
}

.section-lg {
  padding-block: var(--space-4xl);        /* 96px */
}

.section-xl {
  padding-block: calc(var(--space-4xl) * 1.5);   /* 144px */
}

/* Variantes de fondo */
.section-light {
  background-color: var(--color-bg);
}

.section-muted {
  background-color: var(--color-bg-soft);
}

.section-dark {
  background-color: var(--color-bg-dark);
  color: var(--color-text-inverse);
}

.section-dark h1,
.section-dark h2,
.section-dark h3,
.section-dark h4,
.section-dark p {
  color: var(--color-text-inverse);
}

.section-gradient {
  background: linear-gradient(
    160deg,
    var(--color-primary)      0%,
    var(--color-secondary)   60%,
    var(--color-primary-dark) 100%
  );
  color: var(--color-text-inverse);
}

.section-gradient h1,
.section-gradient h2,
.section-gradient h3,
.section-gradient p {
  color: var(--color-text-inverse);
}

/* Separador visual entre secciones alternas */
.section + .section-muted,
.section-muted + .section {
  border-top: 1px solid var(--color-border-soft);
}

@media (max-width: 600px) {
  .section     { padding-block: var(--space-2xl); }
  .section-sm  { padding-block: var(--space-xl); }
  .section-lg  { padding-block: var(--space-3xl); }
  .section-xl  { padding-block: var(--space-3xl); }
}


/* ════════════════════════════════════════════════════════════════════════════
   3. SISTEMA DE GRIDS
   CSS Grid para distribuciones de contenido
   ════════════════════════════════════════════════════════════════════════════ */

/* Base común para todos los grids */
.grid,
.grid-2,
.grid-3,
.grid-4,
.grid-auto,
.grid-products,
.grid-index,
.grid-features {
  display: grid;
  gap: var(--space-xl);
}

/* 2 columnas */
.grid-2 {
  grid-template-columns: repeat(2, 1fr);
}

/* 3 columnas */
.grid-3 {
  grid-template-columns: repeat(3, 1fr);
}

/* 4 columnas */
.grid-4 {
  grid-template-columns: repeat(4, 1fr);
}

/* Auto-fill — se adapta al espacio disponible */
.grid-auto {
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
}

/* Grid de productos — 4 en escritorio, cae a 2 */
.grid-products {
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: var(--space-lg);
}

/* Grid de índice — 2 columnas anchas para navegación documental */
.grid-index {
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-lg);
  align-items: start;
}

/* Grid de características / features — 3 columnas con ícono + texto */
.grid-features {
  grid-template-columns: repeat(3, 1fr);
  gap: var(--space-xl);
}

/* Modificadores de gap */
.grid-gap-sm  { gap: var(--space-sm); }
.grid-gap-md  { gap: var(--space-md); }
.grid-gap-lg  { gap: var(--space-lg); }
.grid-gap-xl  { gap: var(--space-xl); }
.grid-gap-2xl { gap: var(--space-2xl); }

/* Responsive: tablet */
@media (max-width: 900px) {
  .grid-4       { grid-template-columns: repeat(2, 1fr); }
  .grid-3       { grid-template-columns: repeat(2, 1fr); }
  .grid-features { grid-template-columns: repeat(2, 1fr); }
  .grid-index   { grid-template-columns: 1fr; }
}

/* Responsive: móvil */
@media (max-width: 600px) {
  .grid-2,
  .grid-3,
  .grid-4,
  .grid-index,
  .grid-features {
    grid-template-columns: 1fr;
  }

  .grid-products {
    grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
    gap: var(--space-md);
  }
}


/* ════════════════════════════════════════════════════════════════════════════
   4. SISTEMA FLEX — UTILIDADES
   ════════════════════════════════════════════════════════════════════════════ */

.flex          { display: flex; }
.flex-inline   { display: inline-flex; }
.flex-column   { flex-direction: column; }
.flex-row      { flex-direction: row; }
.flex-wrap     { flex-wrap: wrap; }
.flex-nowrap   { flex-wrap: nowrap; }

/* Alineación cruzada (align-items) */
.align-start   { align-items: flex-start; }
.align-center  { align-items: center; }
.align-end     { align-items: flex-end; }
.align-stretch { align-items: stretch; }
.align-baseline{ align-items: baseline; }

/* Alineación principal (justify-content) */
.justify-start   { justify-content: flex-start; }
.justify-center  { justify-content: center; }
.justify-end     { justify-content: flex-end; }
.justify-between { justify-content: space-between; }
.justify-around  { justify-content: space-around; }
.justify-evenly  { justify-content: space-evenly; }

/* Combinaciones frecuentes */
.flex-center  { display: flex; align-items: center; justify-content: center; }
.flex-between { display: flex; align-items: center; justify-content: space-between; }
.flex-start   { display: flex; align-items: center; justify-content: flex-start; }
.flex-end     { display: flex; align-items: center; justify-content: flex-end; }

/* Flex children */
.flex-1    { flex: 1; }
.flex-auto { flex: 0 0 auto; }
.flex-grow { flex-grow: 1; }
.gap-xs    { gap: var(--space-xs); }
.gap-sm    { gap: var(--space-sm); }
.gap-md    { gap: var(--space-md); }
.gap-lg    { gap: var(--space-lg); }
.gap-xl    { gap: var(--space-xl); }


/* ════════════════════════════════════════════════════════════════════════════
   5. LAYOUTS DE PÁGINA
   Estructuras reutilizables para páginas internas
   ════════════════════════════════════════════════════════════════════════════ */

/* Página base: header (sticky) + main + footer */
.page-layout {
  display: flex;
  flex-direction: column;
  min-height: 100vh;
}

.page-layout #site-header {
  flex-shrink: 0;
}

.page-layout #site-footer {
  margin-top: auto;
  flex-shrink: 0;
}

/* Página con sidebar */
.page-layout-sidebar {
  display: grid;
  grid-template-columns: 260px 1fr;
  grid-template-rows: auto 1fr auto;
  grid-template-areas:
    "header  header"
    "sidebar main"
    "footer  footer";
  min-height: 100vh;
  gap: 0;
}

.page-layout-sidebar #site-header { grid-area: header; }
.page-layout-sidebar #site-footer { grid-area: footer; }

.page-main    { grid-area: main; min-width: 0; }
.page-sidebar {
  grid-area: sidebar;
  padding: var(--space-2xl) var(--space-lg);
  border-right: 1px solid var(--color-border);
  background-color: var(--color-bg-soft);
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
}

/* Contenido con aside interno (columna derecha dentro de main) */
.content-with-aside {
  display: grid;
  grid-template-columns: 1fr 300px;
  gap: var(--space-2xl);
  align-items: start;
}

.content-layout {
  min-width: 0;
}

/* Layout general de artículo */
.article-layout {
  max-width: var(--container-reading);
  margin-inline: auto;
}

/* Responsive sidebar */
@media (max-width: 900px) {
  .page-layout-sidebar {
    grid-template-columns: 1fr;
    grid-template-areas:
      "header"
      "main"
      "footer";
  }

  .page-sidebar {
    display: none;   /* ocultada en tablet — toggle por JS en Fase 4 */
  }

  .content-with-aside {
    grid-template-columns: 1fr;
  }
}


/* ════════════════════════════════════════════════════════════════════════════
   6. LAYOUT DOCUMENTAL
   Para páginas basadas en el PDF técnico: capítulos, fichas, glosario
   ════════════════════════════════════════════════════════════════════════════ */

/* Contenedor principal del documento */
.document-container {
  display: grid;
  grid-template-columns: 220px 1fr;
  grid-template-rows: auto 1fr;
  grid-template-areas:
    "doc-nav    doc-header"
    "doc-nav    doc-body";
  gap: 0;
  min-height: 100vh;
  max-width: var(--container-max);
  margin-inline: auto;
}

/* Encabezado del documento (breadcrumb + título de sección) */
.document-header {
  grid-area: doc-header;
  padding: var(--space-xl) var(--space-2xl) var(--space-lg);
  border-bottom: 1px solid var(--color-border);
  background-color: var(--color-bg-card);
}

/* Cuerpo del documento */
.document-body {
  grid-area: doc-body;
  padding: var(--space-2xl);
  min-width: 0;
}

/* Aside/columna lateral dentro del cuerpo */
.document-aside {
  padding: var(--space-xl);
  background-color: var(--color-bg-soft);
  border-left: 1px solid var(--color-border);
  border-radius: 0 var(--radius-lg) var(--radius-lg) 0;
}

/* Navegación lateral del documento (índice de secciones) */
.document-nav {
  grid-area: doc-nav;
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
  padding: var(--space-xl) var(--space-md);
  border-right: 1px solid var(--color-border);
  background-color: var(--color-bg-soft);
  overscroll-behavior: contain;
}

/* Flujo de lectura dentro de un documento largo */
.reading-flow {
  max-width: var(--container-reading);
  line-height: var(--lh-relaxed);
}

.reading-flow > * + * {
  margin-top: var(--space-md);
}

.reading-flow h2,
.reading-flow h3 {
  margin-top: var(--space-2xl);
}

/* Responsive documental */
@media (max-width: 900px) {
  .document-container {
    grid-template-columns: 1fr;
    grid-template-areas:
      "doc-header"
      "doc-body";
  }

  .document-nav {
    display: none;   /* toggle por JS en Fase 4 */
  }

  .document-body {
    padding: var(--space-lg) var(--container-padding-sm);
  }

  .document-header {
    padding: var(--space-lg) var(--container-padding-sm);
  }
}


/* ════════════════════════════════════════════════════════════════════════════
   7. CONTENIDO ESTRUCTURAL — HEADER Y FOOTER (stubs posicionales)
   Los estilos visuales se definen en components.css
   ════════════════════════════════════════════════════════════════════════════ */

#site-header {
  position: sticky;
  top: 0;
  z-index: var(--z-header);
  width: 100%;
}

#hero {
  position: relative;
  width: 100%;
  min-height: 100vh;
  overflow: hidden;
}

#main-content {
  width: 100%;
  flex: 1;
}

#site-footer {
  width: 100%;
}


/* ════════════════════════════════════════════════════════════════════════════
   8. HELPERS RESPONSIVE
   ════════════════════════════════════════════════════════════════════════════ */

/* Ocultar / mostrar por breakpoint */
@media (max-width: 600px) {
  .hide-mobile   { display: none !important; }
  .show-mobile   { display: block !important; }

  .stack-mobile  {
    flex-direction: column !important;
    align-items: stretch !important;
  }

  .center-mobile {
    text-align: center !important;
    margin-inline: auto !important;
  }

  .full-mobile {
    width: 100% !important;
    max-width: none !important;
  }
}

@media (min-width: 601px) {
  .show-mobile { display: none !important; }
}

@media (min-width: 601px) and (max-width: 900px) {
  .hide-tablet { display: none !important; }
}

/* Centrado absoluto de una capa sobre otra */
.overlay-center {
  position: absolute;
  inset: 0;
  display: flex;
  align-items: center;
  justify-content: center;
}

/* Ocupar todo el viewport */
.full-viewport {
  width: 100vw;
  min-height: 100vh;
}

/* Aspecto ratio helpers */
.aspect-video { aspect-ratio: 16 / 9; }
.aspect-square { aspect-ratio: 1 / 1; }
.aspect-portrait { aspect-ratio: 3 / 4; }


/* ════════════════════════════════════════════════════════════════════════════
   9. CONTENIDO ANCHO Y SCROLL HORIZONTAL
   Para tablas técnicas y media sin redimensionar
   ════════════════════════════════════════════════════════════════════════════ */

/* Wrapper de scroll horizontal para tablas (extiende .table-wrapper de base.css) */
.table-scroll {
  width: 100%;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  overscroll-behavior-x: contain;
  /* Indicador sutil de scroll disponible */
  background:
    linear-gradient(to right, var(--color-bg-card) 30%, rgba(255,255,255,0)),
    linear-gradient(to left,  var(--color-bg-card) 30%, rgba(255,255,255,0)) right;
  background-size: 40px 100%;
  background-repeat: no-repeat;
  background-attachment: local;
}

/* Contenido que puede ser más ancho que el contenedor sin romper el layout */
.wide-content {
  width: 100%;
  max-width: none;
  overflow-x: auto;
}

/* Overflow-x simple */
.overflow-x {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
}

/* Media responsive (iframes, videos embebidos) */
.responsive-media {
  position: relative;
  width: 100%;
  height: 0;
  padding-bottom: 56.25%;   /* 16:9 */
  overflow: hidden;
  border-radius: var(--radius-lg);
}

.responsive-media > * {
  position: absolute;
  inset: 0;
  width: 100%;
  height: 100%;
}


/* ════════════════════════════════════════════════════════════════════════════
   10. UTILIDADES DE POSICIÓN Y ESPACIADO
   Complemento mínimo sin generar un framework completo
   ════════════════════════════════════════════════════════════════════════════ */

.relative { position: relative; }
.absolute { position: absolute; }
.sticky   { position: sticky; }

.w-full  { width: 100%; }
.h-full  { height: 100%; }
.min-h-screen { min-height: 100vh; }

.mx-auto { margin-inline: auto; }
.mt-auto { margin-top: auto; }
.mb-auto { margin-bottom: auto; }

.text-center { text-align: center; }
.text-left   { text-align: left; }
.text-right  { text-align: right; }

/* Separación entre secciones hermanas */
.spacer-sm  { height: var(--space-xl); }
.spacer-md  { height: var(--space-2xl); }
.spacer-lg  { height: var(--space-section); }