/**
 * ============================================================================
 * BUTTONS.CSS
 * Componente de Botones - Sistema De Gestión Estudiantes
 * ============================================================================
 * 
 * Componente reutilizable para todos los botones del sistema.
 * Requiere: sistema-design.css
 * 
 * @author Sistema Académico MINERD
 * @version 2.0.0
 * @date 11 de Enero de 2026
 * ============================================================================
 */

/* ============================================================================
   BOTÓN BASE
   ============================================================================ */

.btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: var(--spacing-2);
    
    padding: var(--spacing-3) var(--spacing-6);
    
    font-family: var(--font-family-sans);
    font-size: var(--text-base);
    font-weight: var(--font-semibold);
    line-height: var(--leading-tight);
    text-align: center;
    text-decoration: none;
    white-space: nowrap;
    
    border: none;
    border-radius: var(--radius-lg);
    
    cursor: pointer;
    user-select: none;
    
    transition: var(--transition-base);
    
    /* Eliminar outline por defecto, agregar focus-visible personalizado */
    outline: none;
}

.btn:focus-visible {
    outline: 2px solid var(--primary-500);
    outline-offset: 2px;
}

.btn:disabled,
.btn.disabled {
    opacity: 0.6;
    cursor: not-allowed;
    pointer-events: none;
}

/* ============================================================================
   VARIANTES DE COLORES
   ============================================================================ */

/* Botón Primario */
.btn-primary {
    background: linear-gradient(135deg, var(--primary-500), var(--primary-600));
    color: var(--white);
    box-shadow: var(--shadow-primary);
}

.btn-primary:hover:not(:disabled) {
    background: linear-gradient(135deg, var(--primary-600), var(--primary-700));
    transform: translateY(-2px);
    box-shadow: 0 10px 20px -5px rgba(59, 130, 246, 0.5);
}

.btn-primary:active:not(:disabled) {
    transform: translateY(0);
}

/* Botón Success */
.btn-success {
    background: linear-gradient(135deg, var(--success-500), var(--success-600));
    color: var(--white);
    box-shadow: var(--shadow-success);
}

.btn-success:hover:not(:disabled) {
    background: linear-gradient(135deg, var(--success-600), var(--success-700));
    transform: translateY(-2px);
    box-shadow: 0 10px 20px -5px rgba(16, 185, 129, 0.5);
}

/* Botón Danger */
.btn-danger {
    background: linear-gradient(135deg, var(--danger-500), var(--danger-600));
    color: var(--white);
    box-shadow: var(--shadow-danger);
}

.btn-danger:hover:not(:disabled) {
    background: linear-gradient(135deg, var(--danger-600), var(--danger-700));
    transform: translateY(-2px);
    box-shadow: 0 10px 20px -5px rgba(239, 68, 68, 0.5);
}

/* Botón Warning */
.btn-warning {
    background: linear-gradient(135deg, var(--warning-500), var(--warning-600));
    color: var(--white);
    box-shadow: var(--shadow-warning);
}

.btn-warning:hover:not(:disabled) {
    background: linear-gradient(135deg, var(--warning-600), var(--warning-700));
    transform: translateY(-2px);
    box-shadow: 0 10px 20px -5px rgba(245, 158, 11, 0.5);
}

/* Botón Info */
.btn-info {
    background: linear-gradient(135deg, var(--info-500), var(--info-600));
    color: var(--white);
    box-shadow: 0 4px 14px 0 rgba(6, 182, 212, 0.39);
}

.btn-info:hover:not(:disabled) {
    background: linear-gradient(135deg, var(--info-600), var(--info-700));
    transform: translateY(-2px);
    box-shadow: 0 10px 20px -5px rgba(6, 182, 212, 0.5);
}

/* Botón Secondary */
.btn-secondary {
    background: var(--gray-200);
    color: var(--gray-800);
    box-shadow: var(--shadow-sm);
}

.btn-secondary:hover:not(:disabled) {
    background: var(--gray-300);
    transform: translateY(-1px);
    box-shadow: var(--shadow-md);
}

/* ============================================================================
   BOTONES OUTLINE (sin fondo)
   ============================================================================ */

.btn-outline-primary {
    background: transparent;
    color: var(--primary-600);
    border: 2px solid var(--primary-500);
}

.btn-outline-primary:hover:not(:disabled) {
    background: var(--primary-50);
    border-color: var(--primary-600);
}

.btn-outline-secondary {
    background: transparent;
    color: var(--gray-700);
    border: 2px solid var(--gray-300);
}

.btn-outline-secondary:hover:not(:disabled) {
    background: var(--gray-100);
    border-color: var(--gray-400);
}

/* ============================================================================
   BOTONES GHOST (aún más sutiles)
   ============================================================================ */

.btn-ghost {
    background: transparent;
    color: var(--gray-700);
    box-shadow: none;
}

.btn-ghost:hover:not(:disabled) {
    background: var(--gray-100);
}

.btn-ghost-primary {
    background: transparent;
    color: var(--primary-600);
    box-shadow: none;
}

.btn-ghost-primary:hover:not(:disabled) {
    background: var(--primary-50);
}

/* ============================================================================
   TAMAÑOS DE BOTONES
   ============================================================================ */

/* Extra Small */
.btn-xs {
    padding: var(--spacing-1) var(--spacing-3);
    font-size: var(--text-xs);
    border-radius: var(--radius-md);
}

/* Small */
.btn-sm {
    padding: var(--spacing-2) var(--spacing-4);
    font-size: var(--text-sm);
    border-radius: var(--radius-md);
}

/* Medium (default - no class needed) */

/* Large */
.btn-lg {
    padding: var(--spacing-4) var(--spacing-8);
    font-size: var(--text-lg);
    border-radius: var(--radius-xl);
}

/* Extra Large */
.btn-xl {
    padding: var(--spacing-5) var(--spacing-10);
    font-size: var(--text-xl);
    border-radius: var(--radius-2xl);
}

/* ============================================================================
   BOTONES ESPECIALES
   ============================================================================ */

/* Botón de ancho completo */
.btn-block {
    display: flex;
    width: 100%;
}

/* Botón circular/icono */
.btn-circle {
    padding: var(--spacing-3);
    border-radius: var(--radius-full);
    aspect-ratio: 1;
}

.btn-circle.btn-sm {
    padding: var(--spacing-2);
}

.btn-circle.btn-lg {
    padding: var(--spacing-4);
}

/* Botón con ícono a la izquierda */
.btn-icon-left {
    flex-direction: row;
}

/* Botón con ícono a la derecha */
.btn-icon-right {
    flex-direction: row-reverse;
}

/* ============================================================================
   GRUPOS DE BOTONES
   ============================================================================ */

.btn-group {
    display: inline-flex;
    gap: var(--spacing-2);
}

.btn-group-vertical {
    display: inline-flex;
    flex-direction: column;
    gap: var(--spacing-2);
}

/* Botones conectados (sin gap) */
.btn-group-connected {
    display: inline-flex;
    gap: 0;
}

.btn-group-connected .btn {
    border-radius: 0;
}

.btn-group-connected .btn:first-child {
    border-top-left-radius: var(--radius-lg);
    border-bottom-left-radius: var(--radius-lg);
}

.btn-group-connected .btn:last-child {
    border-top-right-radius: var(--radius-lg);
    border-bottom-right-radius: var(--radius-lg);
}

/* ============================================================================
   BOTONES CON LOADING (spinner)
   ============================================================================ */

.btn-loading {
    position: relative;
    color: transparent !important;
    pointer-events: none;
}

.btn-loading::after {
    content: "";
    position: absolute;
    width: 16px;
    height: 16px;
    top: 50%;
    left: 50%;
    margin-left: -8px;
    margin-top: -8px;
    border: 2px solid var(--white);
    border-radius: 50%;
    border-top-color: transparent;
    animation: btn-loading-spinner 0.6s linear infinite;
}

@keyframes btn-loading-spinner {
    0% {
        transform: rotate(0deg);
    }
    100% {
        transform: rotate(360deg);
    }
}

/* ============================================================================
   RESPONSIVE
   ============================================================================ */

@media (max-width: 640px) {
    .btn {
        font-size: var(--text-sm);
        padding: var(--spacing-2-5) var(--spacing-4);
    }
    
    .btn-lg {
        font-size: var(--text-base);
        padding: var(--spacing-3) var(--spacing-6);
    }
    
    /* En móvil, los botones de acciones principales ocupan todo el ancho */
    .btn-primary:not(.btn-sm):not(.btn-xs) {
        width: 100%;
    }
}

/* ============================================================================
   EJEMPLOS DE USO (comentados)
   ============================================================================

<!-- Botón primario básico -->
<button class="btn btn-primary">Guardar</button>

<!-- Botón con ícono -->
<button class="btn btn-success btn-icon-left">
    <svg>...</svg>
    Agregar Estudiante
</button>

<!-- Botón outline small -->
<button class="btn btn-outline-secondary btn-sm">Cancelar</button>

<!-- Botón circular con ícono -->
<button class="btn btn-circle btn-primary">
    <svg>...</svg>
</button>

<!-- Grupo de botones -->
<div class="btn-group">
    <button class="btn btn-primary">Guardar</button>
    <button class="btn btn-secondary">Cancelar</button>
</div>

<!-- Botón con loading -->
<button class="btn btn-primary btn-loading">Guardando...</button>

   ============================================================================ */